Apple Integration

// window.electronAPI is the only bridge preload.js exposes.
// window.electron does not exist, and these examples used to call it.
// All four commands refuse off macOS with
// { success: false, error: 'Apple Intelligence is only available on macOS.' }

// What this machine can do. Each command has its own OS floor, so check
// before calling: summaryAvailable is separate from imageAvailable and
// genmojiAvailable.
const status = await window.electronAPI.getAppleIntelligenceStatus();
// {
//   success: true,
//   osVersion: 'Version 26.0 (Build 25A354)',
//   available: true,                 // Foundation Models, i.e. summaries
//   supportsSummaries: true,
//   summaryAvailable: true,
//   imageAvailable: true,
//   genmojiAvailable: true,
//   availableStyles: ['illustration', 'line-art', ...]
// }
// Each unavailable command also carries a *_Reason string, e.g.
// summaryReason: 'Summaries require macOS 26 with Foundation Models.'

// Summarize. Takes a bare string, not an object, and returns summary.
const summary = await window.electronAPI.summarizeWithAppleIntelligence(
  'Long article content here...'
);
console.log(summary.summary);        // summaryAvailable requires macOS 26.0+

// Generate an image. Returns a file path, not base64.
const image = await window.electronAPI.generateAppleIntelligenceImage({
  prompt: 'A futuristic city at sunset',
  style: 'illustration'             // optional; defaults to illustration
});
console.log(image.imagePath);        // imageAvailable requires macOS 15.1+

// Generate a custom emoji. Same payload shape.
const emoji = await window.electronAPI.generateGenmoji({
  prompt: 'a robot chef'
});
console.log(emoji.genmojiPath);      // genmojiAvailable requires macOS 15.4+

// Siri phrases registered in src/lib/native-panels/AppIntents.swift
//
// Reaches a bridge route the app actually serves:
//   "Ask Aartiq [prompt]"                            // "Tell", "Query" too
//   "Refine Aartiq response"                         // "Make ... [instruction]"
//   "Regenerate Aartiq response"                     // "Try again in Aartiq"
//   "What did Aartiq say?"
//   "List my conversations in Aartiq"
//   "Open my [conversation] in Aartiq"
//   "New chat in Aartiq"
//   "Reset Aartiq chat"
//   "Search web with Aartiq for [query]"
//   "Switch Aartiq model to [model]"
//   "What can you do with Aartiq"
//
// Reaches a route, but only queues a prompt rather than doing the thing:
//   "Run [command] in Aartiq"          -> sendPrompt("Run this shell command: ...")
//   "Create a [format] about [topic]"  -> sendPrompt("Generate a ... document about: ...")
//   "Schedule [task] [time]"           -> sendPrompt("Schedule this task: ...")
//
// Resolves to an intent that calls a route the bridge does not serve,
// so Siri reports failure:
//   "Summarize this page with Aartiq"   -> /native-mac-ui/summarize-page
//   "Take screenshot with Aartiq"       -> /native-mac-ui/screenshot
//   "Set volume to [level] in Aartiq"   -> /native-mac-ui/volume
//   "Open [app] with Aartiq"            -> /native-mac-ui/open-app
//   "Read clipboard in Aartiq"          -> /native-mac-ui/clipboard
//
// There is no wake word. Dictation hands the transcript to Aartiq, which
// matches it against its own prefixes and otherwise sends it to the model.