Native API

// window.electronAPI is the only bridge preload.js exposes.
// Earlier examples on this page called a different global and threw.

const platform = await window.electronAPI.getPlatform();
// 'darwin' | 'win32' | 'linux'

const isOnline = await window.electronAPI.getIsOnline();
console.log(platform, isOnline);

// Response shapes, transcribed from the code.
//
// Every field of ResponsePayload in src/lib/apple-intelligence.swift. The
// optional fields are omitted when the matching command is unavailable, so
// read the availability flag before the value.
interface AppleIntelligenceResponse {
  success: boolean;
  error?: string;

  // Every command
  available?: boolean;
  osVersion?: string;

  // Summaries, via Foundation Models. macOS 26.0+
  supportsSummaries?: boolean;
  summaryAvailable?: boolean;
  summaryReason?: string;   // present when it is unavailable
  summary?: string;

  // Image Playground. macOS 15.1+
  supportsImageGeneration?: boolean;
  imageAvailable?: boolean;
  imageReason?: string;
  imagePath?: string;        // a filesystem path, not base64
  availableStyles?: string[];

  // Genmoji. macOS 15.4+
  supportsGenmoji?: boolean;
  genmojiAvailable?: boolean;
  genmojiReason?: string;
  genmojiPath?: string;      // a filesystem path, not base64
}

// Off macOS, every one of these resolves to exactly:
//   { success: false, error: APPLE_INTELLIGENCE_UNAVAILABLE }
// where the message is "Apple Intelligence is only available on macOS."

// Approval ticket, from src/lib/approval-gate.js: bound to a hash of the
// exact action and its arguments, five minute TTL, single use.
interface ApprovalTicket {
  id: string;
  action: string;
  params: Record<string, unknown>;
  riskTier: string;
  expiresAt: number;         // epoch milliseconds
}