afm-bridge 0.1.0

package/dist/errors.d.ts

@@ -0,0 +1,111 @@
+import type { UnavailableReason } from './types.js';
+export interface RpcErrorPayload {
+    code: number;
+    message: string;
+    data?: Record<string, unknown> & {
+        type?: string;
+    };
+}
+/** Base class of every error thrown by afm-bridge. `type` matches PROTOCOL.md section 7. */
+export declare class AfmError extends Error {
+    name: string;
+    readonly type: string;
+    readonly code: number | undefined;
+    readonly data: Record<string, unknown>;
+    constructor(message: string, init?: {
+        type?: string;
+        code?: number;
+        data?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/** Framing, version or JSON-RPC level problem between client and sidecar. */
+export declare class ProtocolError extends AfmError {
+    name: string;
+}
+export declare class InvalidParamsError extends AfmError {
+    name: string;
+}
+/** The request was cancelled through an `AbortSignal`. Has `name === 'AbortError'` like DOM aborts. */
+export declare class AbortError extends AfmError {
+    name: string;
+    constructor(message?: string, init?: ConstructorParameters<typeof AfmError>[1]);
+}
+export declare class ModelUnavailableError extends AfmError {
+    name: string;
+    get reason(): UnavailableReason;
+}
+export declare class UnsupportedOSError extends AfmError {
+    name: string;
+}
+export declare class SessionNotFoundError extends AfmError {
+    name: string;
+}
+/** Another `respond`/`stream` is already running in this session. */
+export declare class SessionBusyError extends AfmError {
+    name: string;
+}
+export declare class ContextWindowExceededError extends AfmError {
+    name: string;
+    get contextSize(): number | undefined;
+    get tokenCount(): number | undefined;
+}
+export declare class GuardrailViolationError extends AfmError {
+    name: string;
+}
+export declare class RefusalError extends AfmError {
+    name: string;
+}
+export declare class UnsupportedLanguageError extends AfmError {
+    name: string;
+    get languageCode(): string | undefined;
+}
+export declare class UnsupportedCapabilityError extends AfmError {
+    name: string;
+}
+export declare class UnsupportedSchemaError extends AfmError {
+    name: string;
+}
+export declare class DecodingError extends AfmError {
+    name: string;
+}
+export declare class RateLimitedError extends AfmError {
+    name: string;
+}
+export declare class GenerationTimeoutError extends AfmError {
+    name: string;
+}
+export declare class ToolExecutionError extends AfmError {
+    name: string;
+}
+export declare class QuotaExceededError extends AfmError {
+    name: string;
+}
+export declare class NetworkError extends AfmError {
+    name: string;
+}
+export declare class ServiceUnavailableError extends AfmError {
+    name: string;
+}
+/** The sidecar process died and could not be (re)started. */
+export declare class SidecarCrashedError extends AfmError {
+    name: string;
+}
+/** The session lived in a sidecar process that has since crashed or been closed. Create a new one. */
+export declare class SessionLostError extends AfmError {
+    name: string;
+}
+/** Spawning the sidecar failed (binary missing, not executable, ...). */
+export declare class TransportError extends AfmError {
+    name: string;
+}
+/** The client-side `timeoutMs` elapsed. */
+export declare class RequestTimeoutError extends AfmError {
+    name: string;
+}
+/** `close()` was called on the client. */
+export declare class ClientClosedError extends AfmError {
+    name: string;
+}
+/** Builds the typed error for a JSON-RPC error object. Unknown types become a plain `AfmError`. */
+export declare function errorFromRpc(payload: RpcErrorPayload): AfmError;

package/dist/errors.js

@@ -0,0 +1,152 @@
+/** Base class of every error thrown by afm-bridge. `type` matches PROTOCOL.md section 7. */
+export class AfmError extends Error {
+    name = 'AfmError';
+    type;
+    code;
+    data;
+    constructor(message, init = {}) {
+        super(message, init.cause === undefined ? undefined : { cause: init.cause });
+        this.type = init.type ?? 'generationFailed';
+        this.code = init.code;
+        this.data = init.data ?? {};
+    }
+}
+/** Framing, version or JSON-RPC level problem between client and sidecar. */
+export class ProtocolError extends AfmError {
+    name = 'ProtocolError';
+}
+export class InvalidParamsError extends AfmError {
+    name = 'InvalidParamsError';
+}
+/** The request was cancelled through an `AbortSignal`. Has `name === 'AbortError'` like DOM aborts. */
+export class AbortError extends AfmError {
+    name = 'AbortError';
+    constructor(message = 'The operation was aborted', init = {}) {
+        super(message, { type: 'cancelled', code: -32800, ...init });
+    }
+}
+export class ModelUnavailableError extends AfmError {
+    name = 'ModelUnavailableError';
+    get reason() {
+        return this.data.reason ?? 'unknown';
+    }
+}
+export class UnsupportedOSError extends AfmError {
+    name = 'UnsupportedOSError';
+}
+export class SessionNotFoundError extends AfmError {
+    name = 'SessionNotFoundError';
+}
+/** Another `respond`/`stream` is already running in this session. */
+export class SessionBusyError extends AfmError {
+    name = 'SessionBusyError';
+}
+export class ContextWindowExceededError extends AfmError {
+    name = 'ContextWindowExceededError';
+    get contextSize() {
+        return this.data.contextSize;
+    }
+    get tokenCount() {
+        return this.data.tokenCount;
+    }
+}
+export class GuardrailViolationError extends AfmError {
+    name = 'GuardrailViolationError';
+}
+export class RefusalError extends AfmError {
+    name = 'RefusalError';
+}
+export class UnsupportedLanguageError extends AfmError {
+    name = 'UnsupportedLanguageError';
+    get languageCode() {
+        return this.data.languageCode;
+    }
+}
+export class UnsupportedCapabilityError extends AfmError {
+    name = 'UnsupportedCapabilityError';
+}
+export class UnsupportedSchemaError extends AfmError {
+    name = 'UnsupportedSchemaError';
+}
+export class DecodingError extends AfmError {
+    name = 'DecodingError';
+}
+export class RateLimitedError extends AfmError {
+    name = 'RateLimitedError';
+}
+export class GenerationTimeoutError extends AfmError {
+    name = 'GenerationTimeoutError';
+}
+export class ToolExecutionError extends AfmError {
+    name = 'ToolExecutionError';
+}
+export class QuotaExceededError extends AfmError {
+    name = 'QuotaExceededError';
+}
+export class NetworkError extends AfmError {
+    name = 'NetworkError';
+}
+export class ServiceUnavailableError extends AfmError {
+    name = 'ServiceUnavailableError';
+}
+// Client-only errors (never sent over the wire).
+/** The sidecar process died and could not be (re)started. */
+export class SidecarCrashedError extends AfmError {
+    name = 'SidecarCrashedError';
+}
+/** The session lived in a sidecar process that has since crashed or been closed. Create a new one. */
+export class SessionLostError extends AfmError {
+    name = 'SessionLostError';
+}
+/** Spawning the sidecar failed (binary missing, not executable, ...). */
+export class TransportError extends AfmError {
+    name = 'TransportError';
+}
+/** The client-side `timeoutMs` elapsed. */
+export class RequestTimeoutError extends AfmError {
+    name = 'RequestTimeoutError';
+}
+/** `close()` was called on the client. */
+export class ClientClosedError extends AfmError {
+    name = 'ClientClosedError';
+}
+const byType = {
+    parseError: ProtocolError,
+    invalidRequest: ProtocolError,
+    methodNotFound: ProtocolError,
+    protocolVersionMismatch: ProtocolError,
+    notInitialized: ProtocolError,
+    invalidParams: InvalidParamsError,
+    cancelled: AbortError,
+    modelUnavailable: ModelUnavailableError,
+    unsupportedOS: UnsupportedOSError,
+    sessionNotFound: SessionNotFoundError,
+    sessionBusy: SessionBusyError,
+    contextWindowExceeded: ContextWindowExceededError,
+    guardrailViolation: GuardrailViolationError,
+    refusal: RefusalError,
+    unsupportedLanguage: UnsupportedLanguageError,
+    unsupportedCapability: UnsupportedCapabilityError,
+    unsupportedSchema: UnsupportedSchemaError,
+    decodingFailure: DecodingError,
+    rateLimited: RateLimitedError,
+    timeout: GenerationTimeoutError,
+    toolExecution: ToolExecutionError,
+    quotaExceeded: QuotaExceededError,
+    networkFailure: NetworkError,
+    serviceUnavailable: ServiceUnavailableError,
+};
+/** Builds the typed error for a JSON-RPC error object. Unknown types become a plain `AfmError`. */
+export function errorFromRpc(payload) {
+    const { type = 'unknown', ...data } = payload.data ?? {};
+    if (type === 'assetsUnavailable') {
+        return new ModelUnavailableError(payload.message, {
+            type,
+            code: payload.code,
+            data: { ...data, reason: 'modelNotReady' },
+        });
+    }
+    const Class = byType[type] ?? AfmError;
+    return new Class(payload.message, { type, code: payload.code, data });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { AppleFoundationModels, type AppleFoundationModelsOptions, CLIENT_VERSION, PROTOCOL_VERSION, } from './client.js';
+export * from './errors.js';
+export { type DeepPartial, isStructuredSchema, type JSONSchema, jsonSchema, type SchemaInput, type StructuredSchema, validate, } from './schema.js';
+export { Session } from './session.js';
+export { type Tool, type ToolContext, tool } from './tool.js';
+export type { CloseInfo, Connection, Transport, TransportHandlers } from './transport.js';
+export { createLineSplitter } from './transport.js';
+export type * from './types.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+// Core entry point: no Node APIs, safe to import in a browser or webview.
+export { AppleFoundationModels, CLIENT_VERSION, PROTOCOL_VERSION, } from './client.js';
+export * from './errors.js';
+export { isStructuredSchema, jsonSchema, validate, } from './schema.js';
+export { Session } from './session.js';
+export { tool } from './tool.js';
+export { createLineSplitter } from './transport.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EACL,qBAAqB,EAErB,cAAc,EACd,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,cAAc,aAAa,CAAA;AAC3B,OAAO,EAEL,kBAAkB,EAElB,UAAU,EAGV,QAAQ,GACT,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAA+B,IAAI,EAAE,MAAM,WAAW,CAAA;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/node/index.d.ts

@@ -0,0 +1,28 @@
+import { type Connection, type Transport, type TransportHandlers } from '../transport.js';
+export interface NodeStdioTransportOptions {
+    /** Path to `afm-bridge-server`. Default: `resolveSidecarPath()`. */
+    binaryPath?: string;
+    args?: string[];
+    /** Extra environment variables for the sidecar. */
+    env?: Record<string, string | undefined>;
+    /** Sidecar log level (stderr). Default `warn`. */
+    logLevel?: 'error' | 'warn' | 'info' | 'debug';
+    /** How long `close()` waits for a graceful exit before killing. Default 2000 ms. */
+    shutdownTimeoutMs?: number;
+}
+/**
+ * Runs the sidecar as a child process and talks over stdin/stdout.
+ * Works in Electron's main process, plain Node and CLI tools.
+ */
+export declare class NodeStdioTransport implements Transport {
+    private readonly options;
+    constructor(options?: NodeStdioTransportOptions);
+    connect(handlers: TransportHandlers): Promise<Connection>;
+}
+/**
+ * Finds the `afm-bridge-server` binary. Order:
+ * 1. `AFM_BRIDGE_BINARY` environment variable
+ * 2. Packaged Electron app: `<app>/Contents/Resources/afm-bridge-server` (`process.resourcesPath`)
+ * 3. The `afm-bridge-darwin-arm64` package (with `app.asar` rewritten to `app.asar.unpacked`)
+ */
+export declare function resolveSidecarPath(): string;

package/dist/node/index.js

@@ -0,0 +1,177 @@
+import { spawn } from 'node:child_process';
+import { accessSync, chmodSync, constants, existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { ModelUnavailableError, TransportError } from '../errors.js';
+import { createLineSplitter } from '../transport.js';
+/**
+ * Runs the sidecar as a child process and talks over stdin/stdout.
+ * Works in Electron's main process, plain Node and CLI tools.
+ */
+export class NodeStdioTransport {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async connect(handlers) {
+        assertSupportedPlatform();
+        const binary = this.options.binaryPath ?? resolveSidecarPath();
+        const child = spawn(binary, this.options.args ?? [], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, AFM_BRIDGE_LOG: this.options.logLevel ?? 'warn', ...this.options.env },
+        });
+        await new Promise((resolve, reject) => {
+            child.once('spawn', resolve);
+            child.once('error', (error) => reject(new TransportError(`Could not start afm-bridge-server at ${binary}: ${error.message}`, {
+                type: 'transportError',
+                cause: error,
+            })));
+        });
+        let exited = false;
+        const exit = new Promise((resolve) => {
+            child.once('close', (code, signal) => {
+                exited = true;
+                stdout.flush();
+                stderr.flush();
+                handlers.onClose({ code, signal });
+                resolve();
+            });
+        });
+        // Errors after spawn (e.g. EPIPE on a dead process) surface through 'close'.
+        child.on('error', () => { });
+        child.stdin?.on('error', () => { });
+        const stdout = createLineSplitter((line) => handlers.onMessage(line));
+        const stderr = createLineSplitter((line) => handlers.onLog?.(line));
+        child.stdout?.setEncoding('utf8').on('data', (chunk) => stdout.push(chunk));
+        child.stderr?.setEncoding('utf8').on('data', (chunk) => stderr.push(chunk));
+        const shutdownTimeoutMs = this.options.shutdownTimeoutMs ?? 2000;
+        return {
+            send(line) {
+                if (!exited && child.stdin?.writable)
+                    child.stdin.write(`${line}\n`);
+            },
+            async close() {
+                if (exited)
+                    return;
+                setActive(child, true);
+                child.stdin?.end();
+                if (await settlesWithin(exit, shutdownTimeoutMs))
+                    return;
+                child.kill('SIGTERM');
+                if (await settlesWithin(exit, 1000))
+                    return;
+                child.kill('SIGKILL');
+                await exit;
+            },
+            setActive(active) {
+                if (!exited)
+                    setActive(child, active);
+            },
+        };
+    }
+}
+/**
+ * Finds the `afm-bridge-server` binary. Order:
+ * 1. `AFM_BRIDGE_BINARY` environment variable
+ * 2. Packaged Electron app: `<app>/Contents/Resources/afm-bridge-server` (`process.resourcesPath`)
+ * 3. The `afm-bridge-darwin-arm64` package (with `app.asar` rewritten to `app.asar.unpacked`)
+ */
+export function resolveSidecarPath() {
+    const tried = [];
+    const usable = (candidate) => {
+        tried.push(candidate);
+        try {
+            accessSync(candidate, constants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const fromEnv = process.env.AFM_BRIDGE_BINARY;
+    if (fromEnv) {
+        if (usable(fromEnv))
+            return fromEnv;
+        throw notFound(tried, 'AFM_BRIDGE_BINARY points to a file that does not exist or is not executable.');
+    }
+    const resourcesPath = process.resourcesPath;
+    if (resourcesPath) {
+        const packaged = join(resourcesPath, 'afm-bridge-server');
+        if (usable(packaged))
+            return packaged;
+    }
+    try {
+        const fromPackage = createRequire(import.meta.url).resolve('afm-bridge-darwin-arm64/bin/afm-bridge-server');
+        const unpacked = fromPackage.replace(/app\.asar([\\/])/, 'app.asar.unpacked$1');
+        if (unpacked !== fromPackage && usable(unpacked))
+            return unpacked;
+        if (usable(fromPackage))
+            return fromPackage;
+        // Some package managers drop the executable bit when installing; restore it.
+        if (unpacked === fromPackage && existsSync(fromPackage)) {
+            try {
+                chmodSync(fromPackage, 0o755);
+                if (usable(fromPackage))
+                    return fromPackage;
+            }
+            catch {
+                // Read-only location; fall through to the error below.
+            }
+        }
+    }
+    catch {
+        // Package not installed (not on macOS arm64, or optional dependencies were skipped).
+    }
+    throw notFound(tried);
+}
+function notFound(tried, hint) {
+    return new TransportError([
+        'afm-bridge-server binary not found.',
+        hint,
+        tried.length > 0 ? `Tried: ${tried.join(', ')}.` : undefined,
+        'Fix: install afm-bridge-darwin-arm64 (npm adds it automatically on Apple silicon), build it with `swift build -c release` and pass `binaryPath`, or set AFM_BRIDGE_BINARY.',
+    ]
+        .filter(Boolean)
+        .join(' '), { type: 'transportError' });
+}
+/** Throws `ModelUnavailableError` on platforms where the sidecar cannot run. */
+function assertSupportedPlatform() {
+    if (process.platform !== 'darwin' || process.arch !== 'arm64') {
+        throw new ModelUnavailableError(`Apple Foundation Models need macOS on Apple silicon (this is ${process.platform}/${process.arch})`, { type: 'modelUnavailable', data: { model: 'on-device', reason: 'unsupportedPlatform' } });
+    }
+    const version = macOSVersion();
+    if (version !== undefined && version < 26) {
+        throw new ModelUnavailableError(`Apple Foundation Models need macOS 26 or newer (this is macOS ${version})`, {
+            type: 'modelUnavailable',
+            data: { model: 'on-device', reason: 'unsupportedOS' },
+        });
+    }
+}
+function macOSVersion() {
+    try {
+        const plist = readFileSync('/System/Library/CoreServices/SystemVersion.plist', 'utf8');
+        const match = /<key>ProductVersion<\/key>\s*<string>(\d+)/.exec(plist);
+        return match?.[1] ? Number(match[1]) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function setActive(child, active) {
+    for (const handle of [child, child.stdin, child.stdout, child.stderr]) {
+        if (active)
+            handle?.ref?.();
+        else
+            handle?.unref?.();
+    }
+}
+async function settlesWithin(promise, ms) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(false), ms);
+    });
+    const result = await Promise.race([promise.then(() => true), timeout]);
+    clearTimeout(timer);
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

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

package/dist/rpc.d.ts

@@ -0,0 +1,37 @@
+import type { Connection } from './transport.js';
+export interface RequestOptions {
+    signal?: AbortSignal | undefined;
+    timeoutMs?: number | undefined;
+    /** Called with the request id right before the request is written. */
+    onStart?: (id: number) => void;
+    /** How long to wait for the peer to confirm a cancel before rejecting anyway. Default 5000 ms. */
+    cancelGraceMs?: number;
+}
+type IncomingRequestHandler = (method: string, params: unknown, signal: AbortSignal) => Promise<unknown>;
+/** JSON-RPC 2.0 peer over one connection. Both sides can send requests. */
+export declare class RpcPeer {
+    private readonly connection;
+    private readonly handlers;
+    private nextId;
+    private readonly pending;
+    private readonly incoming;
+    private closedError;
+    constructor(connection: Connection, handlers: {
+        onNotification(method: string, params: unknown): void;
+        onRequest?: IncomingRequestHandler;
+        onPendingChange?(count: number): void;
+        onProtocolError?(error: Error): void;
+    });
+    get pendingCount(): number;
+    request<T>(method: string, params: unknown, options?: RequestOptions): Promise<T>;
+    notify(method: string, params: unknown): void;
+    /** Feeds one line received from the connection. */
+    handleLine(line: string): void;
+    /** Rejects everything in flight; later calls reject with the same error. */
+    close(error: Error): void;
+    private handleNotification;
+    private handleIncomingRequest;
+    private settle;
+    private write;
+}
+export {};