@codex-app-sdk/electron 0.0.0-stage → 0.14.1

package/dist/codex-native-ipc.d.ts

@@ -0,0 +1,41 @@
+import { type AppleSpeechTranscriptionOptions, type AppleSpeechTranscriptionResult } from '@codex-app-sdk/backend';
+import { type IpcMainPort, type IpcSenderPolicy } from './typed-ipc';
+import { CodexElectronAttachmentRegistry } from './codex-attachment-registry';
+export type CodexNativeDialog = {
+    showOpenDialog(options: {
+        filters?: {
+            name: string;
+            extensions: string[];
+        }[];
+        properties: Array<'multiSelections' | 'openFile'>;
+        title: string;
+    }): Promise<{
+        canceled: boolean;
+        filePaths: string[];
+    }>;
+};
+export type CodexNativeClipboard = {
+    write(content: {
+        html?: string;
+        text: string;
+    }): void;
+};
+export type CodexNativeShell = {
+    openExternal(href: string): Promise<void>;
+};
+export type CodexNativeMainOptions = IpcSenderPolicy & {
+    appleSpeechAssetsPath?: string;
+    maxAttachmentBytes?: number;
+    maxTotalAttachmentBytes?: number;
+    maxAudioBytes?: number;
+    maxImagePreviewBytes?: number;
+    transcribeAudio?: (audioData: Buffer, options?: AppleSpeechTranscriptionOptions) => Promise<AppleSpeechTranscriptionResult>;
+};
+export type CodexNativeMainDependencies = {
+    clipboard: CodexNativeClipboard;
+    dialog: CodexNativeDialog;
+    ipcMain: IpcMainPort;
+    shell: CodexNativeShell;
+};
+export declare function registerCodexNativeIpc(dependencies: CodexNativeMainDependencies, options?: CodexNativeMainOptions, attachments?: CodexElectronAttachmentRegistry): () => void;
+//# sourceMappingURL=codex-native-ipc.d.ts.map

package/dist/codex-native-ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-native-ipc.d.ts","sourceRoot":"","sources":["../src/codex-native-ipc.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACpC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,CAAC,OAAO,EAAE;QACtB,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,EAAE,CAAA;SAAE,EAAE,CAAC;QACnD,UAAU,EAAE,KAAK,CAAC,iBAAiB,GAAG,UAAU,CAAC,CAAC;QAClD,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG;IACrD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,+BAA+B,KACtC,OAAO,CAAC,8BAA8B,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,EAAE,oBAAoB,CAAC;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAQF,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,2BAA2B,EACzC,OAAO,GAAE,sBAA2B,EACpC,WAAW,kCAAwC,GAClD,MAAM,IAAI,CA2HZ"}

package/dist/codex-native-renderer.d.ts

@@ -0,0 +1,36 @@
+import type { CodexNativeAttachment, CodexNativeAttachmentInput, CodexNativeClipboardContent, CodexNativeRendererApi, CodexSpeechTranscriptionResult } from '@codex-app-sdk/core/native';
+import { type IpcRendererPort, type IpcRequest } from './typed-ipc';
+export declare const codexNativeChannels: {
+    readonly copyToClipboard: "codex-native:copy-to-clipboard";
+    readonly ingestAttachments: "codex-native:ingest-attachments";
+    readonly openExternal: "codex-native:open-external";
+    readonly pickAttachments: "codex-native:pick-attachments";
+    readonly readImagePreview: "codex-native:read-image-preview";
+    readonly transcribeAudio: "codex-native:transcribe-audio";
+};
+export type CodexNativeRequests = {
+    [codexNativeChannels.copyToClipboard]: IpcRequest<[content: CodexNativeClipboardContent], void>;
+    [codexNativeChannels.ingestAttachments]: IpcRequest<[
+        files: readonly CodexNativeAttachmentInput[]
+    ], CodexNativeAttachment[]>;
+    [codexNativeChannels.openExternal]: IpcRequest<[href: string], void>;
+    [codexNativeChannels.pickAttachments]: IpcRequest<[], CodexNativeAttachment[]>;
+    [codexNativeChannels.readImagePreview]: IpcRequest<[path: string], string | null>;
+    [codexNativeChannels.transcribeAudio]: IpcRequest<[
+        audioData: ArrayBuffer,
+        options?: {
+            locale?: string;
+            live?: boolean;
+        }
+    ], CodexSpeechTranscriptionResult>;
+};
+export type CodexContextBridge = {
+    exposeInMainWorld(key: string, api: unknown): void;
+};
+export declare function createCodexNativeRendererApi(port: IpcRendererPort, options?: {
+    transcription?: boolean;
+}): CodexNativeRendererApi;
+export declare function exposeCodexNativeRendererApi(contextBridge: CodexContextBridge, port: IpcRendererPort, options?: {
+    transcription?: boolean;
+}): CodexNativeRendererApi;
+//# sourceMappingURL=codex-native-renderer.d.ts.map

package/dist/codex-native-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-native-renderer.d.ts","sourceRoot":"","sources":["../src/codex-native-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,8BAA8B,EAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,mBAAmB;;;;;;;CAOtB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG;IAChC,CAAC,mBAAmB,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,CAAC,OAAO,EAAE,2BAA2B,CAAC,EAAE,IAAI,CAAC,CAAC;IAChG,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC;QAClD,KAAK,EAAE,SAAS,0BAA0B,EAAE;KAC7C,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC5B,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IACrE,CAAC,mBAAmB,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC/E,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAClF,CAAC,mBAAmB,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;QAChD,SAAS,EAAE,WAAW;QACtB,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE;KAC9C,EAAE,8BAA8B,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;CACpD,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,sBAAsB,CAkBxB;AAED,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,kBAAkB,EACjC,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC,sBAAsB,CAIxB"}

package/dist/codex-surface-ipc.d.ts

@@ -0,0 +1,12 @@
+import { type CodexSurfaceBridgeTarget } from '@codex-app-sdk/core/surface-bridge';
+import type { CodexSurfaceRendererApi } from '@codex-app-sdk/core/surface';
+import { type CodexSurfaceStatePatchSource } from '@codex-app-sdk/core/surface-bridge';
+import { type IpcEventSender, type IpcMainPort, type IpcRendererPort, type IpcSenderPolicy } from './typed-ipc';
+export type CodexSurfaceIpcOptions = IpcSenderPolicy & {
+    resolveAttachment?: import('@codex-app-sdk/core/surface-bridge').CodexSurfaceBridgeAttachmentResolver;
+};
+export type { CodexSurfaceRendererApi } from '@codex-app-sdk/core/surface';
+type OptionalSurfaceOperation = 'loadOlderConversationHistory' | 'startLiveChat' | 'stopLiveChat';
+export declare function registerCodexSurfaceIpc(port: IpcMainPort, sender: IpcEventSender, surface: Omit<CodexSurfaceBridgeTarget, OptionalSurfaceOperation> & Partial<Pick<CodexSurfaceBridgeTarget, OptionalSurfaceOperation>> & Partial<CodexSurfaceStatePatchSource>, options?: CodexSurfaceIpcOptions): () => void;
+export declare function createCodexSurfaceRendererApi(port: IpcRendererPort): CodexSurfaceRendererApi;
+//# sourceMappingURL=codex-surface-ipc.d.ts.map

package/dist/codex-surface-ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-ipc.d.ts","sourceRoot":"","sources":["../src/codex-surface-ipc.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAWV,uBAAuB,EAWxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG;IACrD,iBAAiB,CAAC,EAAE,OAAO,oCAAoC,EAAE,oCAAoC,CAAC;CACvG,CAAC;AA4GF,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E,KAAK,wBAAwB,GAAG,8BAA8B,GAAG,eAAe,GAAG,cAAc,CAAC;AAElG,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,IAAI,CAAC,wBAAwB,EAAE,wBAAwB,CAAC,GAC7D,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,wBAAwB,CAAC,CAAC,GACjE,OAAO,CAAC,4BAA4B,CAAC,EACzC,OAAO,GAAE,sBAA2B,GACnC,MAAM,IAAI,CAuFZ;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,eAAe,GAAG,uBAAuB,CA+D5F"}

package/dist/codex-window-policy.d.ts

@@ -0,0 +1,40 @@
+type CodexNavigationEvent = {
+    url: string;
+    preventDefault(): void;
+};
+/** The `WebContents` subset used by `installCodexWindowPolicy`. */
+export type CodexWindowPolicyTarget = {
+    on(event: 'will-navigate', listener: (event: CodexNavigationEvent) => void): unknown;
+    setWindowOpenHandler(handler: (details: {
+        url: string;
+    }) => {
+        action: 'deny';
+    }): void;
+};
+export type CodexWindowPolicyOptions = {
+    /** The URL loaded into the window: the dev server URL or the packaged renderer's `file:` URL. */
+    rendererUrl: string;
+    /** Usually Electron's `shell.openExternal`. Receives only http(s), mailto, and tel URLs. */
+    openExternal(url: string): Promise<void> | void;
+};
+/** Returns a normalized http(s), mailto, or tel URL that is safe to hand to the OS, otherwise null. */
+export declare function codexExternalUrl(value: string): string | null;
+/**
+ * True when `url` is the app's own renderer: the same origin as an http(s)
+ * dev server, or the same document as a packaged `file:` renderer.
+ */
+export declare function isCodexRendererUrl(url: string | null | undefined, rendererUrl: string): boolean;
+/**
+ * Keeps a window on the app renderer. Electron re-runs the preload script on
+ * every navigation, so any other page the window reached would receive the
+ * full Codex bridge. New windows and foreign navigations are denied; safe
+ * external URLs open in the system browser instead.
+ */
+export declare function installCodexWindowPolicy(webContents: CodexWindowPolicyTarget, options: CodexWindowPolicyOptions): void;
+/**
+ * IPC sender predicate for `registerCodexElectronMain`: accepts only the main
+ * frame of a window that is currently showing the app renderer.
+ */
+export declare function isCodexRendererSender(event: unknown, rendererUrl: string): boolean;
+export {};
+//# sourceMappingURL=codex-window-policy.d.ts.map

package/dist/codex-window-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-window-policy.d.ts","sourceRoot":"","sources":["../src/codex-window-policy.ts"],"names":[],"mappings":"AAAA,KAAK,oBAAoB,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,IAAI,IAAI,CAAC;CACxB,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,OAAO,CAAC;IACrF,oBAAoB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACvF,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,iGAAiG;IACjG,WAAW,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjD,CAAC;AAIF,uGAAuG;AACvG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAY/F;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,uBAAuB,EACpC,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAcN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAGlF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { connectIpcEventsToBus, registerIpcMainHandlers, sendIpcEvent, TypedIpcMain, TypedIpcRenderer, type IpcEventSender, type IpcMainHandlers, type IpcMainPort, type IpcRendererPort, type IpcRequest, type IpcRequestArguments, type IpcRequestResult, type IpcSenderPolicy, } from './typed-ipc';
+export { codexExternalUrl, installCodexWindowPolicy, isCodexRendererSender, isCodexRendererUrl, type CodexWindowPolicyOptions, type CodexWindowPolicyTarget, } from './codex-window-policy';
+export { createCodexSurfaceRendererApi, registerCodexSurfaceIpc, type CodexSurfaceRendererApi, } from './codex-surface-ipc';
+export { createCodexNativeRendererApi, exposeCodexNativeRendererApi, type CodexContextBridge, } from './codex-native-renderer';
+export { registerCodexNativeIpc, type CodexNativeClipboard, type CodexNativeDialog, type CodexNativeMainDependencies, type CodexNativeMainOptions, type CodexNativeShell, } from './codex-native-ipc';
+export { CodexElectronAttachmentRegistry, type CodexElectronAttachmentRegistration, } from './codex-attachment-registry';
+export type { CodexHostAttachment, CodexHostAttachmentInput, CodexNativeAttachment, CodexNativeAttachmentInput, CodexNativeClipboardContent, CodexNativeRendererApi, CodexSpeechTranscriptionResult, } from '@codex-app-sdk/core/native';
+export { exposeCodexElectronPreload, type CodexElectronRendererApis, } from './codex-electron-preload';
+export { registerCodexElectronMain, type CodexElectronMainOptions, } from './codex-electron-integration';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,KAAK,kBAAkB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,+BAA+B,EAC/B,KAAK,mCAAmC,GACzC,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,0BAA0B,EAC1B,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,yBAAyB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,282 @@
+import { a as e, c as t, d as n, i as r, l as i, n as a, o, r as s, s as c, t as l, u } from "./chunks/codex-electron-preload-z_8XhSEC.js";
+import { promises as d } from "node:fs";
+import f from "node:os";
+import p from "node:path";
+import { transcribeWithAppleSpeechAnalyzer as m } from "@codex-app-sdk/backend";
+import { randomUUID as h } from "node:crypto";
+//#region src/codex-window-policy.ts
+var g = /* @__PURE__ */ new Set([
+	"http:",
+	"https:",
+	"mailto:",
+	"tel:"
+]);
+function _(e) {
+	try {
+		let t = new URL(e);
+		return g.has(t.protocol) ? t.href : null;
+	} catch {
+		return null;
+	}
+}
+function v(e, t) {
+	if (!e) return !1;
+	try {
+		let n = new URL(e), r = new URL(t);
+		return r.protocol === "file:" ? n.protocol === "file:" && n.pathname === r.pathname : n.origin === r.origin;
+	} catch {
+		return !1;
+	}
+}
+function y(e, t) {
+	let n = (e) => {
+		let n = _(e);
+		n && Promise.resolve(t.openExternal(n)).catch(() => void 0);
+	};
+	e.setWindowOpenHandler(({ url: e }) => (n(e), { action: "deny" })), e.on("will-navigate", (e) => {
+		v(e.url, t.rendererUrl) || (e.preventDefault(), n(e.url));
+	});
+}
+function b(e, t) {
+	let n = e?.senderFrame;
+	return !!n && n.parent === null && v(n.url, t);
+}
+//#endregion
+//#region src/codex-attachment-registry.ts
+var x = class {
+	#e = /* @__PURE__ */ new Map();
+	register(e) {
+		let t = `electron-attachment:${h()}`;
+		return this.#e.set(t, {
+			type: e.type,
+			path: e.path,
+			name: e.name,
+			mimeType: e.mimeType,
+			...e.previewUrl === void 0 ? {} : { previewUrl: e.previewUrl }
+		}), {
+			id: t,
+			reference: t,
+			type: e.type,
+			name: e.name,
+			mimeType: e.mimeType,
+			size: e.size,
+			...e.previewUrl === void 0 ? {} : { previewUrl: e.previewUrl }
+		};
+	}
+	resolve(e) {
+		let t = this.#t(e.reference);
+		if (t.type !== e.type) throw TypeError("Attachment reference type does not match");
+		return {
+			type: t.type,
+			path: t.path,
+			name: t.name,
+			mimeType: t.mimeType,
+			...t.type === "image" && t.previewUrl ? { previewUrl: t.previewUrl } : {}
+		};
+	}
+	path(e) {
+		return this.#t(e).path;
+	}
+	clear() {
+		this.#e.clear();
+	}
+	#t(e) {
+		let t = this.#e.get(e);
+		if (!t) throw TypeError("Attachment reference is invalid or expired");
+		return t;
+	}
+}, S = 25 * 1024 * 1024, C = 100 * 1024 * 1024, w = 25 * 1024 * 1024, T = 8 * 1024 * 1024, E = 16 * 1024 * 1024;
+function D(e, t = {}, n = new x()) {
+	let r = z(t.maxAttachmentBytes, S, "Attachment byte limit"), i = z(t.maxAudioBytes, w, "Audio byte limit"), o = z(t.maxTotalAttachmentBytes, C, "Total attachment byte limit"), s = z(t.maxImagePreviewBytes, T, "Image preview byte limit"), c = u(e.ipcMain, {
+		[a.copyToClipboard]: (t, n) => {
+			let r = A(n);
+			e.clipboard.write(r);
+		},
+		[a.ingestAttachments]: async (e, t) => {
+			let i = O(t, r, o);
+			if (i.length === 0) return [];
+			let a = await d.mkdtemp(p.join(f.tmpdir(), "codex-app-sdk-attachments-"));
+			return Promise.all(i.map(async (e, t) => {
+				let r = p.join(a, `${t}-${L(e.name)}`), i = Buffer.from(e.data);
+				return await d.writeFile(r, i, { mode: 384 }), k(n, r, {
+					mimeType: e.mimeType ?? B(e.name),
+					name: L(e.name),
+					previewData: i
+				});
+			}));
+		},
+		[a.openExternal]: async (t, n) => {
+			await e.shell.openExternal(j(n));
+		},
+		[a.pickAttachments]: async () => {
+			let t = await e.dialog.showOpenDialog({
+				title: "Add Files & Photos",
+				properties: ["openFile", "multiSelections"],
+				filters: [{
+					name: "Files and photos",
+					extensions: ["*"]
+				}]
+			});
+			if (t.canceled) return [];
+			let i = [], a = 0, s = 0;
+			for (let e of t.filePaths) {
+				let t = await d.stat(e);
+				if (!t.isFile()) throw TypeError(`Attachment is not a file: ${e}`);
+				if (t.size > r) throw RangeError(`Attachment exceeds the ${r} byte limit: ${e}`);
+				if (a += t.size, a > o) throw RangeError(`Attachments exceed the ${o} total byte limit`);
+				let c = B(e), l = c.startsWith("image/") && c !== "image/svg+xml" && t.size <= T && s + t.size <= E ? await d.readFile(e) : void 0;
+				l && (s += l.byteLength), i.push(k(n, e, {
+					mimeType: c,
+					name: p.basename(e),
+					previewData: l,
+					size: t.size
+				}));
+			}
+			return i;
+		},
+		[a.readImagePreview]: async (e, t) => {
+			let r = F(t, "Image preview attachment reference"), i = R(r) ?? n.path(r), a = B(i);
+			if (!a.startsWith("image/") || a === "image/svg+xml") return null;
+			let o;
+			try {
+				o = await d.lstat(i);
+			} catch (e) {
+				if (I(e)) return null;
+				throw e;
+			}
+			if (!o.isFile() || o.size > s) return null;
+			let c = await d.readFile(i);
+			return c.byteLength > s ? null : `data:${a};base64,${c.toString("base64")}`;
+		},
+		[a.transcribeAudio]: async (e, n, r) => {
+			let a = N(n, "Audio data");
+			if (a.byteLength > i) throw RangeError(`Audio data exceeds the ${i} byte limit`);
+			let o = M(r);
+			return (t.transcribeAudio ?? ((e, n) => m(e, n, { ...t.appleSpeechAssetsPath ? { assetsPath: t.appleSpeechAssetsPath } : {} })))(Buffer.from(a), o);
+		}
+	}, t);
+	return () => {
+		c(), n.clear();
+	};
+}
+function O(e, t, n) {
+	if (!Array.isArray(e)) throw TypeError("Attachments must be an array");
+	if (e.length > 20) throw RangeError("At most 20 attachments can be added at once");
+	let r = 0;
+	return e.map((e) => {
+		let i = P(e, "Attachment"), a = F(i.name, "Attachment name"), o = N(i.data, "Attachment data");
+		if (o.byteLength > t) throw RangeError(`Attachment '${a}' exceeds the ${t} byte limit`);
+		if (r += o.byteLength, r > n) throw RangeError(`Attachments exceed the ${n} total byte limit`);
+		return {
+			name: a,
+			data: o,
+			...i.mimeType === void 0 ? {} : { mimeType: F(i.mimeType, "Attachment MIME type") }
+		};
+	});
+}
+function k(e, t, n) {
+	let r = n.size ?? n.previewData?.byteLength ?? 0;
+	return e.register({
+		type: n.mimeType.startsWith("image/") ? "image" : "file",
+		path: t,
+		name: n.name,
+		mimeType: n.mimeType,
+		size: r,
+		...n.previewData && n.mimeType !== "image/svg+xml" && n.previewData.byteLength <= T ? { previewUrl: `data:${n.mimeType};base64,${Buffer.from(n.previewData).toString("base64")}` } : {}
+	});
+}
+function A(e) {
+	let t = P(e, "Clipboard content"), n = typeof t.text == "string" ? t.text : V("Clipboard text must be a string"), r = t.html === void 0 ? void 0 : typeof t.html == "string" ? t.html : V("Clipboard HTML must be a string");
+	if (n.length > 5e6 || (r?.length ?? 0) > 1e7) throw RangeError("Clipboard content is too large");
+	return {
+		text: n,
+		...r ? { html: r } : {}
+	};
+}
+function j(e) {
+	let t = F(e, "External URL"), n = new URL(t);
+	if (![
+		"http:",
+		"https:",
+		"mailto:",
+		"tel:"
+	].includes(n.protocol.toLowerCase())) throw TypeError(`Unsupported external URL protocol: ${n.protocol}`);
+	return n.href;
+}
+function M(e) {
+	if (e === void 0) return;
+	let t = P(e, "Speech transcription options");
+	if (t.live !== void 0 && typeof t.live != "boolean") throw TypeError("Speech transcription live mode must be a boolean");
+	return {
+		...t.locale === void 0 ? {} : { locale: F(t.locale, "Speech transcription locale") },
+		...t.live === void 0 ? {} : { live: t.live }
+	};
+}
+function N(e, t) {
+	if (!(e instanceof ArrayBuffer)) throw TypeError(`${t} must be an ArrayBuffer`);
+	return e;
+}
+function P(e, t) {
+	if (!e || typeof e != "object" || Array.isArray(e)) throw TypeError(`${t} must be an object`);
+	return e;
+}
+function F(e, t) {
+	if (typeof e != "string" || !e.trim()) throw TypeError(`${t} must be a non-empty string`);
+	return e.trim();
+}
+function I(e) {
+	return !!(e && typeof e == "object" && "code" in e && e.code === "ENOENT");
+}
+function L(e) {
+	return p.basename(e).replace(/[\u0000-\u001f\u007f]/g, "").trim() || "attachment";
+}
+function R(e) {
+	if (!p.isAbsolute(e)) return null;
+	let t = p.resolve(e), n = p.dirname(t);
+	return p.dirname(n) === p.resolve(f.tmpdir()) && /^codex-app-sdk-attachments-[a-z\d_-]+$/i.test(p.basename(n)) ? t : null;
+}
+function z(e, t, n) {
+	if (e === void 0) return t;
+	if (!Number.isSafeInteger(e) || e <= 0) throw TypeError(`${n} must be a positive integer`);
+	return e;
+}
+function B(e) {
+	return {
+		avif: "image/avif",
+		bmp: "image/bmp",
+		gif: "image/gif",
+		heic: "image/heic",
+		heif: "image/heif",
+		jpeg: "image/jpeg",
+		jpg: "image/jpeg",
+		png: "image/png",
+		svg: "image/svg+xml",
+		webp: "image/webp"
+	}[p.extname(e).slice(1).toLowerCase()] ?? "application/octet-stream";
+}
+function V(e) {
+	throw TypeError(e);
+}
+//#endregion
+//#region src/codex-electron-integration.ts
+function H(e) {
+	let t = new x(), n = e.isTrustedSender ? { isTrustedSender: e.isTrustedSender } : {}, r = o(e.ipcMain, e.sender, e.surface, {
+		...n,
+		resolveAttachment: (e) => t.resolve(e)
+	});
+	try {
+		let i = D(e, {
+			...e.native,
+			...n
+		}, t);
+		return () => {
+			i(), r();
+		};
+	} catch (e) {
+		throw r(), e;
+	}
+}
+//#endregion
+export { x as CodexElectronAttachmentRegistry, c as TypedIpcMain, t as TypedIpcRenderer, _ as codexExternalUrl, i as connectIpcEventsToBus, s as createCodexNativeRendererApi, e as createCodexSurfaceRendererApi, l as exposeCodexElectronPreload, r as exposeCodexNativeRendererApi, y as installCodexWindowPolicy, b as isCodexRendererSender, v as isCodexRendererUrl, H as registerCodexElectronMain, D as registerCodexNativeIpc, o as registerCodexSurfaceIpc, u as registerIpcMainHandlers, n as sendIpcEvent };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["#attachments","#registered"],"sources":["../src/codex-window-policy.ts","../src/codex-attachment-registry.ts","../src/codex-native-ipc.ts","../src/codex-electron-integration.ts"],"sourcesContent":["type CodexNavigationEvent = {\n  url: string;\n  preventDefault(): void;\n};\n\n/** The `WebContents` subset used by `installCodexWindowPolicy`. */\nexport type CodexWindowPolicyTarget = {\n  on(event: 'will-navigate', listener: (event: CodexNavigationEvent) => void): unknown;\n  setWindowOpenHandler(handler: (details: { url: string }) => { action: 'deny' }): void;\n};\n\nexport type CodexWindowPolicyOptions = {\n  /** The URL loaded into the window: the dev server URL or the packaged renderer's `file:` URL. */\n  rendererUrl: string;\n  /** Usually Electron's `shell.openExternal`. Receives only http(s), mailto, and tel URLs. */\n  openExternal(url: string): Promise<void> | void;\n};\n\nconst externalProtocols = new Set(['http:', 'https:', 'mailto:', 'tel:']);\n\n/** Returns a normalized http(s), mailto, or tel URL that is safe to hand to the OS, otherwise null. */\nexport function codexExternalUrl(value: string): string | null {\n  try {\n    const url = new URL(value);\n    return externalProtocols.has(url.protocol) ? url.href : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * True when `url` is the app's own renderer: the same origin as an http(s)\n * dev server, or the same document as a packaged `file:` renderer.\n */\nexport function isCodexRendererUrl(url: string | null | undefined, rendererUrl: string): boolean {\n  if (!url) return false;\n  try {\n    const target = new URL(url);\n    const renderer = new URL(rendererUrl);\n    if (renderer.protocol === 'file:') {\n      return target.protocol === 'file:' && target.pathname === renderer.pathname;\n    }\n    return target.origin === renderer.origin;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Keeps a window on the app renderer. Electron re-runs the preload script on\n * every navigation, so any other page the window reached would receive the\n * full Codex bridge. New windows and foreign navigations are denied; safe\n * external URLs open in the system browser instead.\n */\nexport function installCodexWindowPolicy(\n  webContents: CodexWindowPolicyTarget,\n  options: CodexWindowPolicyOptions,\n): void {\n  const openExternal = (value: string) => {\n    const url = codexExternalUrl(value);\n    if (url) void Promise.resolve(options.openExternal(url)).catch(() => undefined);\n  };\n  webContents.setWindowOpenHandler(({ url }) => {\n    openExternal(url);\n    return { action: 'deny' };\n  });\n  webContents.on('will-navigate', (event) => {\n    if (isCodexRendererUrl(event.url, options.rendererUrl)) return;\n    event.preventDefault();\n    openExternal(event.url);\n  });\n}\n\n/**\n * IPC sender predicate for `registerCodexElectronMain`: accepts only the main\n * frame of a window that is currently showing the app renderer.\n */\nexport function isCodexRendererSender(event: unknown, rendererUrl: string): boolean {\n  const frame = (event as { senderFrame?: { parent: unknown; url: string } | null } | null)?.senderFrame;\n  return Boolean(frame) && frame!.parent === null && isCodexRendererUrl(frame!.url, rendererUrl);\n}\n","import { randomUUID } from 'node:crypto';\nimport type { CodexHostAttachment } from '@codex-app-sdk/core/native';\nimport type {\n  CodexRendererAttachment,\n  CodexSurfaceAttachment,\n} from '@codex-app-sdk/core/surface';\n\nexport type CodexElectronAttachmentRegistration = {\n  type: CodexHostAttachment['type'];\n  path: string;\n  name: string;\n  mimeType: string;\n  size: number;\n  previewUrl?: string;\n};\n\ntype RegisteredAttachment = Omit<CodexElectronAttachmentRegistration, 'size'>;\n\n/** Keeps trusted local paths out of the renderer and scopes references to one Electron integration. */\nexport class CodexElectronAttachmentRegistry {\n  readonly #attachments = new Map<string, RegisteredAttachment>();\n\n  register(input: CodexElectronAttachmentRegistration): CodexHostAttachment {\n    const reference = `electron-attachment:${randomUUID()}`;\n    this.#attachments.set(reference, {\n      type: input.type,\n      path: input.path,\n      name: input.name,\n      mimeType: input.mimeType,\n      ...(input.previewUrl === undefined ? {} : { previewUrl: input.previewUrl }),\n    });\n    return {\n      id: reference,\n      reference,\n      type: input.type,\n      name: input.name,\n      mimeType: input.mimeType,\n      size: input.size,\n      ...(input.previewUrl === undefined ? {} : { previewUrl: input.previewUrl }),\n    };\n  }\n\n  resolve(attachment: CodexRendererAttachment): CodexSurfaceAttachment {\n    const registered = this.#registered(attachment.reference);\n    if (registered.type !== attachment.type) {\n      throw new TypeError('Attachment reference type does not match');\n    }\n    return {\n      type: registered.type,\n      path: registered.path,\n      name: registered.name,\n      mimeType: registered.mimeType,\n      ...(registered.type === 'image' && registered.previewUrl\n        ? { previewUrl: registered.previewUrl }\n        : {}),\n    };\n  }\n\n  path(reference: string): string {\n    return this.#registered(reference).path;\n  }\n\n  clear(): void {\n    this.#attachments.clear();\n  }\n\n  #registered(reference: string): RegisteredAttachment {\n    const attachment = this.#attachments.get(reference);\n    if (!attachment) throw new TypeError('Attachment reference is invalid or expired');\n    return attachment;\n  }\n}\n","import { promises as fs } from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport type {\n  CodexHostAttachment,\n  CodexNativeAttachmentInput,\n  CodexNativeClipboardContent,\n} from '@codex-app-sdk/core/native';\nimport {\n  transcribeWithAppleSpeechAnalyzer,\n  type AppleSpeechTranscriptionOptions,\n  type AppleSpeechTranscriptionResult,\n} from '@codex-app-sdk/backend';\nimport {\n  registerIpcMainHandlers,\n  type IpcMainPort,\n  type IpcSenderPolicy,\n} from './typed-ipc';\nimport {\n  codexNativeChannels as channels,\n  type CodexNativeRequests as NativeRequests,\n} from './codex-native-renderer';\nimport { CodexElectronAttachmentRegistry } from './codex-attachment-registry';\n\nexport type CodexNativeDialog = {\n  showOpenDialog(options: {\n    filters?: { name: string; extensions: string[] }[];\n    properties: Array<'multiSelections' | 'openFile'>;\n    title: string;\n  }): Promise<{ canceled: boolean; filePaths: string[] }>;\n};\n\nexport type CodexNativeClipboard = {\n  write(content: { html?: string; text: string }): void;\n};\n\nexport type CodexNativeShell = {\n  openExternal(href: string): Promise<void>;\n};\n\nexport type CodexNativeMainOptions = IpcSenderPolicy & {\n  appleSpeechAssetsPath?: string;\n  maxAttachmentBytes?: number;\n  maxTotalAttachmentBytes?: number;\n  maxAudioBytes?: number;\n  maxImagePreviewBytes?: number;\n  transcribeAudio?: (\n    audioData: Buffer,\n    options?: AppleSpeechTranscriptionOptions,\n  ) => Promise<AppleSpeechTranscriptionResult>;\n};\n\nexport type CodexNativeMainDependencies = {\n  clipboard: CodexNativeClipboard;\n  dialog: CodexNativeDialog;\n  ipcMain: IpcMainPort;\n  shell: CodexNativeShell;\n};\n\nconst defaultMaxAttachmentBytes = 25 * 1024 * 1024;\nconst defaultMaxTotalAttachmentBytes = 100 * 1024 * 1024;\nconst defaultMaxAudioBytes = 25 * 1024 * 1024;\nconst maxPreviewBytes = 8 * 1024 * 1024;\nconst maxTotalPreviewBytes = 16 * 1024 * 1024;\n\nexport function registerCodexNativeIpc(\n  dependencies: CodexNativeMainDependencies,\n  options: CodexNativeMainOptions = {},\n  attachments = new CodexElectronAttachmentRegistry(),\n): () => void {\n  const maxAttachmentBytes = positiveByteLimit(\n    options.maxAttachmentBytes,\n    defaultMaxAttachmentBytes,\n    'Attachment byte limit',\n  );\n  const maxAudioBytes = positiveByteLimit(\n    options.maxAudioBytes,\n    defaultMaxAudioBytes,\n    'Audio byte limit',\n  );\n  const maxTotalAttachmentBytes = positiveByteLimit(\n    options.maxTotalAttachmentBytes,\n    defaultMaxTotalAttachmentBytes,\n    'Total attachment byte limit',\n  );\n  const maxImagePreviewBytes = positiveByteLimit(\n    options.maxImagePreviewBytes,\n    maxPreviewBytes,\n    'Image preview byte limit',\n  );\n\n  const unregister = registerIpcMainHandlers<NativeRequests>(dependencies.ipcMain, {\n    [channels.copyToClipboard]: (_event, value) => {\n      const content = clipboardContent(value);\n      dependencies.clipboard.write(content);\n    },\n    [channels.ingestAttachments]: async (_event, value) => {\n      const inputs = attachmentInputs(value, maxAttachmentBytes, maxTotalAttachmentBytes);\n      if (inputs.length === 0) return [];\n      const temporaryDirectory = await fs.mkdtemp(path.join(os.tmpdir(), 'codex-app-sdk-attachments-'));\n      return Promise.all(inputs.map(async (input, index) => {\n        const filePath = path.join(temporaryDirectory, `${index}-${safeFileName(input.name)}`);\n        const data = Buffer.from(input.data);\n        await fs.writeFile(filePath, data, { mode: 0o600 });\n        return attachmentFromPath(attachments, filePath, {\n          mimeType: input.mimeType ?? mimeTypeForPath(input.name),\n          name: safeFileName(input.name),\n          previewData: data,\n        });\n      }));\n    },\n    [channels.openExternal]: async (_event, value) => {\n      await dependencies.shell.openExternal(externalHref(value));\n    },\n    [channels.pickAttachments]: async () => {\n      const result = await dependencies.dialog.showOpenDialog({\n        title: 'Add Files & Photos',\n        properties: ['openFile', 'multiSelections'],\n        filters: [\n          { name: 'Files and photos', extensions: ['*'] },\n        ],\n      });\n      if (result.canceled) return [];\n      const pickedAttachments: CodexHostAttachment[] = [];\n      let totalBytes = 0;\n      let previewBytes = 0;\n      for (const filePath of result.filePaths) {\n        const metadata = await fs.stat(filePath);\n        if (!metadata.isFile()) throw new TypeError(`Attachment is not a file: ${filePath}`);\n        if (metadata.size > maxAttachmentBytes) {\n          throw new RangeError(`Attachment exceeds the ${maxAttachmentBytes} byte limit: ${filePath}`);\n        }\n        totalBytes += metadata.size;\n        if (totalBytes > maxTotalAttachmentBytes) {\n          throw new RangeError(`Attachments exceed the ${maxTotalAttachmentBytes} total byte limit`);\n        }\n        const mimeType = mimeTypeForPath(filePath);\n        const previewData = mimeType.startsWith('image/')\n          && mimeType !== 'image/svg+xml'\n          && metadata.size <= maxPreviewBytes\n          && previewBytes + metadata.size <= maxTotalPreviewBytes\n          ? await fs.readFile(filePath)\n          : undefined;\n        if (previewData) previewBytes += previewData.byteLength;\n        pickedAttachments.push(attachmentFromPath(attachments, filePath, {\n          mimeType,\n          name: path.basename(filePath),\n          previewData,\n          size: metadata.size,\n        }));\n      }\n      return pickedAttachments;\n    },\n    [channels.readImagePreview]: async (_event, value) => {\n      const reference = nonEmptyString(value, 'Image preview attachment reference');\n      const filePath = managedTemporaryAttachmentPath(reference) ?? attachments.path(reference);\n      const mimeType = mimeTypeForPath(filePath);\n      if (!mimeType.startsWith('image/') || mimeType === 'image/svg+xml') return null;\n      let metadata;\n      try {\n        metadata = await fs.lstat(filePath);\n      } catch (error) {\n        if (isMissingFileError(error)) return null;\n        throw error;\n      }\n      if (!metadata.isFile() || metadata.size > maxImagePreviewBytes) return null;\n      const data = await fs.readFile(filePath);\n      if (data.byteLength > maxImagePreviewBytes) return null;\n      return `data:${mimeType};base64,${data.toString('base64')}`;\n    },\n    [channels.transcribeAudio]: async (_event, value, rawOptions) => {\n      const audioData = arrayBuffer(value, 'Audio data');\n      if (audioData.byteLength > maxAudioBytes) {\n        throw new RangeError(`Audio data exceeds the ${maxAudioBytes} byte limit`);\n      }\n      const transcriptionOptions = appleSpeechOptions(rawOptions);\n      const transcribe = options.transcribeAudio\n        ?? ((data: Buffer, inputOptions?: AppleSpeechTranscriptionOptions) => (\n          transcribeWithAppleSpeechAnalyzer(data, inputOptions, {\n            ...(options.appleSpeechAssetsPath\n              ? { assetsPath: options.appleSpeechAssetsPath }\n              : {}),\n          })\n        ));\n      return transcribe(Buffer.from(audioData), transcriptionOptions);\n    },\n  }, options);\n\n  return () => {\n    unregister();\n    attachments.clear();\n  };\n}\n\nfunction attachmentInputs(\n  value: unknown,\n  maxBytes: number,\n  maxTotalBytes: number,\n): CodexNativeAttachmentInput[] {\n  if (!Array.isArray(value)) throw new TypeError('Attachments must be an array');\n  if (value.length > 20) throw new RangeError('At most 20 attachments can be added at once');\n  let totalBytes = 0;\n  return value.map((entry) => {\n    const record = objectRecord(entry, 'Attachment');\n    const name = nonEmptyString(record.name, 'Attachment name');\n    const data = arrayBuffer(record.data, 'Attachment data');\n    if (data.byteLength > maxBytes) {\n      throw new RangeError(`Attachment '${name}' exceeds the ${maxBytes} byte limit`);\n    }\n    totalBytes += data.byteLength;\n    if (totalBytes > maxTotalBytes) {\n      throw new RangeError(`Attachments exceed the ${maxTotalBytes} total byte limit`);\n    }\n    return {\n      name,\n      data,\n      ...(record.mimeType === undefined\n        ? {}\n        : { mimeType: nonEmptyString(record.mimeType, 'Attachment MIME type') }),\n    };\n  });\n}\n\nfunction attachmentFromPath(\n  attachments: CodexElectronAttachmentRegistry,\n  filePath: string,\n  metadata: {\n    mimeType: string;\n    name: string;\n    previewData?: Uint8Array;\n    size?: number;\n  },\n): CodexHostAttachment {\n  const size = metadata.size ?? metadata.previewData?.byteLength ?? 0;\n  return attachments.register({\n    type: metadata.mimeType.startsWith('image/') ? 'image' : 'file',\n    path: filePath,\n    name: metadata.name,\n    mimeType: metadata.mimeType,\n    size,\n    ...(metadata.previewData\n      && metadata.mimeType !== 'image/svg+xml'\n      && metadata.previewData.byteLength <= maxPreviewBytes\n      ? { previewUrl: `data:${metadata.mimeType};base64,${Buffer.from(metadata.previewData).toString('base64')}` }\n      : {}),\n  });\n}\n\nfunction clipboardContent(value: unknown): CodexNativeClipboardContent {\n  const record = objectRecord(value, 'Clipboard content');\n  const text = typeof record.text === 'string' ? record.text : invalid('Clipboard text must be a string');\n  const html = record.html === undefined\n    ? undefined\n    : typeof record.html === 'string'\n      ? record.html\n      : invalid('Clipboard HTML must be a string');\n  if (text.length > 5_000_000 || (html?.length ?? 0) > 10_000_000) {\n    throw new RangeError('Clipboard content is too large');\n  }\n  return { text, ...(html ? { html } : {}) };\n}\n\nfunction externalHref(value: unknown): string {\n  const href = nonEmptyString(value, 'External URL');\n  const url = new URL(href);\n  if (!['http:', 'https:', 'mailto:', 'tel:'].includes(url.protocol.toLowerCase())) {\n    throw new TypeError(`Unsupported external URL protocol: ${url.protocol}`);\n  }\n  return url.href;\n}\n\nfunction appleSpeechOptions(value: unknown): AppleSpeechTranscriptionOptions | undefined {\n  if (value === undefined) return undefined;\n  const record = objectRecord(value, 'Speech transcription options');\n  if (record.live !== undefined && typeof record.live !== 'boolean') {\n    throw new TypeError('Speech transcription live mode must be a boolean');\n  }\n  return {\n    ...(record.locale === undefined\n      ? {}\n      : { locale: nonEmptyString(record.locale, 'Speech transcription locale') }),\n    ...(record.live === undefined ? {} : { live: record.live }),\n  };\n}\n\nfunction arrayBuffer(value: unknown, label: string): ArrayBuffer {\n  if (!(value instanceof ArrayBuffer)) throw new TypeError(`${label} must be an ArrayBuffer`);\n  return value;\n}\n\nfunction objectRecord(value: unknown, label: string): Record<string, unknown> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    throw new TypeError(`${label} must be an object`);\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction nonEmptyString(value: unknown, label: string): string {\n  if (typeof value !== 'string' || !value.trim()) throw new TypeError(`${label} must be a non-empty string`);\n  return value.trim();\n}\n\nfunction isMissingFileError(error: unknown): boolean {\n  return Boolean(error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT');\n}\n\nfunction safeFileName(value: string): string {\n  const name = path.basename(value).replace(/[\\u0000-\\u001f\\u007f]/g, '').trim();\n  return name || 'attachment';\n}\n\nfunction managedTemporaryAttachmentPath(value: string): string | null {\n  if (!path.isAbsolute(value)) return null;\n  const resolved = path.resolve(value);\n  const directory = path.dirname(resolved);\n  if (path.dirname(directory) !== path.resolve(os.tmpdir())) return null;\n  return /^codex-app-sdk-attachments-[a-z\\d_-]+$/i.test(path.basename(directory))\n    ? resolved\n    : null;\n}\n\nfunction positiveByteLimit(value: number | undefined, fallback: number, label: string): number {\n  if (value === undefined) return fallback;\n  if (!Number.isSafeInteger(value) || value <= 0) throw new TypeError(`${label} must be a positive integer`);\n  return value;\n}\n\nfunction mimeTypeForPath(filePath: string): string {\n  const extension = path.extname(filePath).slice(1).toLowerCase();\n  return ({\n    avif: 'image/avif',\n    bmp: 'image/bmp',\n    gif: 'image/gif',\n    heic: 'image/heic',\n    heif: 'image/heif',\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    svg: 'image/svg+xml',\n    webp: 'image/webp',\n  } as Record<string, string>)[extension] ?? 'application/octet-stream';\n}\n\nfunction invalid(message: string): never {\n  throw new TypeError(message);\n}\n","import type { CodexSurface } from '@codex-app-sdk/backend';\nimport {\n  registerCodexNativeIpc,\n  type CodexNativeMainDependencies,\n  type CodexNativeMainOptions,\n} from './codex-native-ipc';\nimport { registerCodexSurfaceIpc } from './codex-surface-ipc';\nimport type { IpcEventSender, IpcSenderPolicy } from './typed-ipc';\nimport { CodexElectronAttachmentRegistry } from './codex-attachment-registry';\n\nexport type CodexElectronMainOptions = CodexNativeMainDependencies & IpcSenderPolicy & {\n  native?: CodexNativeMainOptions;\n  sender: IpcEventSender;\n  surface: CodexSurface;\n};\n\n/** Installs the complete SDK-owned surface and native capability bridge. */\nexport function registerCodexElectronMain(options: CodexElectronMainOptions): () => void {\n  const attachments = new CodexElectronAttachmentRegistry();\n  const senderPolicy = options.isTrustedSender ? { isTrustedSender: options.isTrustedSender } : {};\n  const unregisterSurface = registerCodexSurfaceIpc(\n    options.ipcMain,\n    options.sender,\n    options.surface,\n    { ...senderPolicy, resolveAttachment: (attachment) => attachments.resolve(attachment) },\n  );\n  try {\n    const unregisterNative = registerCodexNativeIpc(options, { ...options.native, ...senderPolicy }, attachments);\n    return () => {\n      unregisterNative();\n      unregisterSurface();\n    };\n  } catch (error) {\n    unregisterSurface();\n    throw error;\n  }\n}\n"],"mappings":"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"}

package/dist/preload.d.ts

@@ -0,0 +1,7 @@
+export { exposeCodexElectronPreload, type CodexElectronRendererApis, } from './codex-electron-preload';
+export { createCodexNativeRendererApi, exposeCodexNativeRendererApi, type CodexContextBridge, } from './codex-native-renderer';
+export { createCodexSurfaceRendererApi, } from './codex-surface-ipc';
+export { TypedIpcRenderer, type IpcRendererPort, type IpcRequest, type IpcRequestArguments, type IpcRequestResult, } from './typed-ipc';
+export type { CodexNativeRendererApi, } from '@codex-app-sdk/core/native';
+export type { CodexSurfaceRendererApi, } from '@codex-app-sdk/core/surface';
+//# sourceMappingURL=preload.d.ts.map

package/dist/preload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../src/preload.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,KAAK,kBAAkB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,uBAAuB,GACxB,MAAM,6BAA6B,CAAC"}

package/dist/preload.js

@@ -0,0 +1,2 @@
+import { a as e, c as t, i as n, r, t as i } from "./chunks/codex-electron-preload-z_8XhSEC.js";
+export { t as TypedIpcRenderer, r as createCodexNativeRendererApi, e as createCodexSurfaceRendererApi, i as exposeCodexElectronPreload, n as exposeCodexNativeRendererApi };

package/dist/typed-ipc.d.ts

@@ -0,0 +1,47 @@
+import type { TypedEventBus } from '@codex-app-sdk/core/events';
+export type IpcRequest<Arguments extends unknown[] = unknown[], Result = unknown> = {
+    args: Arguments;
+    result: Result;
+};
+export type IpcRequestArguments<Request> = Request extends IpcRequest<infer Arguments, unknown> ? Arguments : never;
+export type IpcRequestResult<Request> = Request extends IpcRequest<unknown[], infer Result> ? Result : never;
+export type IpcRendererPort = {
+    invoke(channel: string, ...args: unknown[]): Promise<unknown>;
+    on(channel: string, listener: (event: unknown, payload: unknown) => void): void;
+    off(channel: string, listener: (event: unknown, payload: unknown) => void): void;
+};
+export type IpcMainPort = {
+    handle(channel: string, handler: (event: unknown, ...args: unknown[]) => unknown): void;
+    removeHandler(channel: string): void;
+};
+export type IpcEventSender = {
+    send(channel: string, payload: unknown): void;
+};
+type RequestName<Requests> = keyof Requests & string;
+type EventName<Events> = keyof Events & string;
+export declare class TypedIpcRenderer<Requests extends object, Events extends object> {
+    private readonly port;
+    constructor(port: IpcRendererPort);
+    invoke<Name extends RequestName<Requests>>(channel: Name, ...args: IpcRequestArguments<Requests[Name]>): Promise<IpcRequestResult<Requests[Name]>>;
+    on<Name extends EventName<Events>>(channel: Name, listener: (payload: Events[Name]) => void): () => void;
+}
+export type IpcMainHandlers<Requests extends object> = {
+    [Name in keyof Requests]: (event: unknown, ...args: IpcRequestArguments<Requests[Name]>) => IpcRequestResult<Requests[Name]> | Promise<IpcRequestResult<Requests[Name]>>;
+};
+export declare class TypedIpcMain<Requests extends object> {
+    private readonly port;
+    private readonly registeredChannels;
+    constructor(port: IpcMainPort);
+    handle<Name extends RequestName<Requests>>(channel: Name, handler: IpcMainHandlers<Pick<Requests, Name>>[Name]): void;
+    removeHandler<Name extends RequestName<Requests>>(channel: Name): void;
+    dispose(): void;
+}
+export type IpcSenderPolicy = {
+    /** Rejects an invocation before its handler runs when this returns false. */
+    isTrustedSender?: (event: unknown) => boolean;
+};
+export declare function registerIpcMainHandlers<Requests extends object>(port: IpcMainPort, handlers: IpcMainHandlers<Requests>, policy?: IpcSenderPolicy): () => void;
+export declare function sendIpcEvent<Events extends object, Name extends EventName<Events>>(sender: IpcEventSender, channel: Name, payload: Events[Name]): void;
+export declare function connectIpcEventsToBus<Events extends object>(renderer: Pick<TypedIpcRenderer<object, Events>, 'on'>, bus: TypedEventBus<Events>, channels: ReadonlyArray<EventName<Events>>): () => void;
+export {};
+//# sourceMappingURL=typed-ipc.d.ts.map

package/dist/typed-ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-ipc.d.ts","sourceRoot":"","sources":["../src/typed-ipc.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@codex-app-sdk/electron",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.14.1",
+  "description": "Electron main, preload, IPC, and native capability adapter for Codex applications.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codex-app-sdk/codex-app-sdk.git",
+    "directory": "packages/electron"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./preload": {
+      "types": "./dist/preload.d.ts",
+      "import": "./dist/preload.js"
+    }
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json --declaration --emitDeclarationOnly",
+    "check": "npm run lint && npm run test:coverage && npm run build",
+    "lint": "tsc -p tsconfig.test.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:mutation": "cd ../.. && stryker run packages/electron/stryker.config.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@codex-app-sdk/backend": "0.14.1",
+    "@codex-app-sdk/core": "0.14.1"
+  },
+  "peerDependencies": {
+    "electron": ">=30"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}