@stoneforge/smithy 0.1.0

package/dist/providers/codex/index.js

@@ -0,0 +1,55 @@
+/**
+ * Codex Agent Provider
+ *
+ * Combines the Codex headless and interactive providers
+ * into a single AgentProvider implementation.
+ *
+ * @module
+ */
+import { CodexHeadlessProvider } from './headless.js';
+import { CodexInteractiveProvider } from './interactive.js';
+import { serverManager } from './server-manager.js';
+export { CodexHeadlessProvider } from './headless.js';
+export { CodexInteractiveProvider } from './interactive.js';
+export { CodexEventMapper } from './event-mapper.js';
+export { serverManager as codexServerManager } from './server-manager.js';
+/**
+ * Codex Agent Provider - provider using OpenAI Codex CLI and app-server.
+ */
+export class CodexAgentProvider {
+    name = 'codex';
+    headless;
+    interactive;
+    constructor(config) {
+        this.headless = new CodexHeadlessProvider();
+        this.interactive = new CodexInteractiveProvider(config?.executablePath);
+    }
+    async isAvailable() {
+        const headlessAvailable = await this.headless.isAvailable();
+        const interactiveAvailable = await this.interactive.isAvailable();
+        return headlessAvailable || interactiveAvailable;
+    }
+    getInstallInstructions() {
+        return 'Install Codex CLI: npm install -g @openai/codex';
+    }
+    async listModels() {
+        // Acquire a temporary server client
+        const client = await serverManager.acquire();
+        try {
+            const response = await client.model.list({ limit: 50 });
+            // Handle both { models: [...] } and { data: [...] } response formats
+            const rawModels = response.models ?? response.data ?? [];
+            // Map Codex model info to our ModelInfo type; mark the first model as default
+            return rawModels.map((model, index) => ({
+                id: model.id,
+                displayName: model.name ?? model.id,
+                description: model.description,
+                ...(index === 0 ? { isDefault: true } : {}),
+            }));
+        }
+        finally {
+            serverManager.release();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/codex/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM1E;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,OAAO,CAAC;IACf,QAAQ,CAAmB;IAC3B,WAAW,CAAsB;IAE1C,YAAY,MAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,IAAI,wBAAwB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC5D,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAClE,OAAO,iBAAiB,IAAI,oBAAoB,CAAC;IACnD,CAAC;IAED,sBAAsB;QACpB,OAAO,iDAAiD,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,UAAU;QACd,oCAAoC;QACpC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACxD,qEAAqE;YACrE,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,IAAK,QAA8C,CAAC,IAAI,IAAI,EAAE,CAAC;YAChG,8EAA8E;YAC9E,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBACtC,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,WAAW,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;gBACnC,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5C,CAAC,CAAC,CAAC;QACN,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;CACF"}

package/dist/providers/codex/interactive.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Codex Interactive Provider
+ *
+ * Implements the InteractiveProvider interface by spawning the `codex` CLI
+ * in a PTY. Mirrors the OpenCode interactive provider pattern.
+ *
+ * @module
+ */
+import type { InteractiveProvider, InteractiveSession, InteractiveSpawnOptions } from '../types.js';
+/**
+ * Codex interactive provider that spawns the `codex` CLI in a PTY.
+ */
+export declare class CodexInteractiveProvider implements InteractiveProvider {
+    readonly name = "codex-interactive";
+    private readonly executablePath;
+    constructor(executablePath?: string);
+    spawn(options: InteractiveSpawnOptions): Promise<InteractiveSession>;
+    isAvailable(): Promise<boolean>;
+    private buildArgs;
+}
+//# sourceMappingURL=interactive.d.ts.map

package/dist/providers/codex/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EAExB,MAAM,aAAa,CAAC;AAwErB;;GAEG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAClE,QAAQ,CAAC,IAAI,uBAAuB;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,cAAc,SAAU;IAI9B,KAAK,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoDpE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAUrC,OAAO,CAAC,SAAS;CAgBlB"}

package/dist/providers/codex/interactive.js

@@ -0,0 +1,141 @@
+/**
+ * Codex Interactive Provider
+ *
+ * Implements the InteractiveProvider interface by spawning the `codex` CLI
+ * in a PTY. Mirrors the OpenCode interactive provider pattern.
+ *
+ * @module
+ */
+import * as pty from 'node-pty';
+// ============================================================================
+// Helpers
+// ============================================================================
+function shellQuote(s) {
+    return "'" + s.replace(/'/g, "'\\''") + "'";
+}
+// ============================================================================
+// Codex Interactive Session
+// ============================================================================
+class CodexInteractiveSession {
+    ptyProcess;
+    sessionId;
+    pid;
+    constructor(ptyProcess) {
+        this.ptyProcess = ptyProcess;
+        this.pid = ptyProcess.pid;
+        // Listen for thread/session ID in output and auto-respond to terminal queries.
+        // Codex sends DSR (Device Status Report) \x1b[6n on startup to query cursor
+        // position. When no terminal emulator (e.g. xterm.js) is connected to respond,
+        // codex times out and exits. We auto-respond with a default cursor position
+        // so codex can start regardless of whether a terminal client is attached.
+        this.ptyProcess.onData((data) => {
+            if (data.includes('\x1b[6n')) {
+                this.ptyProcess.write('\x1b[1;1R');
+            }
+            if (!this.sessionId) {
+                const match = data.match(/(?:Thread|Session|thr_)[:=\s]*([a-z0-9_-]+)/i);
+                if (match) {
+                    this.sessionId = match[1];
+                }
+            }
+        });
+    }
+    write(data) {
+        this.ptyProcess.write(data);
+    }
+    resize(cols, rows) {
+        this.ptyProcess.resize(cols, rows);
+    }
+    kill() {
+        this.ptyProcess.kill();
+    }
+    onData(callback) {
+        this.ptyProcess.onData(callback);
+    }
+    onExit(callback) {
+        this.ptyProcess.onExit((e) => callback(e.exitCode, e.signal));
+    }
+    getSessionId() {
+        return this.sessionId;
+    }
+}
+// ============================================================================
+// Codex Interactive Provider
+// ============================================================================
+/**
+ * Codex interactive provider that spawns the `codex` CLI in a PTY.
+ */
+export class CodexInteractiveProvider {
+    name = 'codex-interactive';
+    executablePath;
+    constructor(executablePath = 'codex') {
+        this.executablePath = executablePath;
+    }
+    async spawn(options) {
+        const args = this.buildArgs(options);
+        const env = {
+            ...process.env,
+            ...options.environmentVariables,
+        };
+        if (options.stoneforgeRoot) {
+            env.STONEFORGE_ROOT = options.stoneforgeRoot;
+        }
+        const cols = options.cols ?? 120;
+        const rows = options.rows ?? 30;
+        const shell = process.platform === 'win32' ? 'cmd.exe' : '/bin/bash';
+        // Build the CLI command string (simple args only — not the prompt).
+        // Use `exec` so the CLI replaces the shell process.
+        const codexCommand = 'exec ' + [shellQuote(this.executablePath), ...args].join(' ');
+        // Spawn PTY using bash -l -c to run the command in a login shell.
+        // When an initial prompt is provided, it's passed as a bash positional
+        // parameter ($1) via the process argv — bypasses shell parsing entirely.
+        const shellArgs = process.platform === 'win32'
+            ? []
+            : options.initialPrompt
+                ? ['-l', '-c', codexCommand + ' "$1"', '_', options.initialPrompt]
+                : ['-l', '-c', codexCommand];
+        const ptyProcess = pty.spawn(shell, shellArgs, {
+            name: 'xterm-256color',
+            cols,
+            rows,
+            cwd: options.workingDirectory,
+            env,
+        });
+        const session = new CodexInteractiveSession(ptyProcess);
+        // On Windows, write the command to cmd.exe stdin (bash -c handles this on Unix)
+        if (process.platform === 'win32') {
+            await new Promise((resolve) => {
+                setTimeout(() => {
+                    ptyProcess.write(codexCommand + '\r');
+                    resolve();
+                }, 100);
+            });
+        }
+        return session;
+    }
+    async isAvailable() {
+        try {
+            const { execSync } = await import('node:child_process');
+            execSync(`${this.executablePath} --version`, { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    buildArgs(options) {
+        const args = [];
+        if (options.resumeSessionId) {
+            args.push('resume', shellQuote(options.resumeSessionId), '--full-auto');
+        }
+        else {
+            args.push('--full-auto', '--cd', shellQuote(options.workingDirectory));
+        }
+        // Add model flag if provided
+        if (options.model) {
+            args.push('--model', shellQuote(options.model));
+        }
+        return args;
+    }
+}
+//# sourceMappingURL=interactive.js.map

package/dist/providers/codex/interactive.js.map

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

package/dist/providers/codex/jsonrpc-client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Codex JSON-RPC Client
+ *
+ * JSON-RPC 2.0 over JSONL stdio protocol layer for communicating
+ * with the Codex app-server. Handles request/response multiplexing,
+ * server-initiated requests, and notification dispatch.
+ *
+ * Note: Codex app-server omits the "jsonrpc":"2.0" header —
+ * we do not require or emit it.
+ *
+ * @module
+ */
+import type { Writable, Readable } from 'node:stream';
+/** Handler for server-initiated notifications (no id, has method) */
+export type NotificationHandler = (method: string, params: unknown) => void;
+/** Handler for server-initiated requests (has both id and method) */
+export type ServerRequestHandler = (id: number, method: string, params: unknown) => void;
+/**
+ * JSON-RPC 2.0 client over JSONL stdio.
+ *
+ * Multiplexes incoming messages by inspecting `id` and `method` fields:
+ * - Has `id` + no `method` → response → resolve/reject pending promise
+ * - Has `method` + no `id` → notification → dispatch to notification handler
+ * - Has both `method` + `id` → server-initiated request → dispatch to request handler
+ */
+export declare class CodexJsonRpcClient {
+    private stdin;
+    private nextId;
+    private pending;
+    private notificationHandler;
+    private serverRequestHandler;
+    private lineBuffer;
+    private closed;
+    constructor(stdin: Writable, stdout: Readable);
+    /** Send a request and await the response */
+    request(method: string, params?: unknown): Promise<unknown>;
+    /** Send a notification (no response expected) */
+    notify(method: string, params?: unknown): void;
+    /** Reply to a server-initiated request */
+    respond(id: number, result: unknown): void;
+    /** Register a handler for server notifications */
+    onNotification(handler: NotificationHandler): void;
+    /** Register a handler for server-initiated requests */
+    onServerRequest(handler: ServerRequestHandler): void;
+    /** Close the client, rejecting all pending requests */
+    close(): void;
+    /** Feed stdout data for JSONL line-buffered parsing */
+    private onData;
+    private dispatch;
+    private writeLine;
+}
+//# sourceMappingURL=jsonrpc-client.d.ts.map

package/dist/providers/codex/jsonrpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc-client.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/jsonrpc-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAqBtD,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAE5E,qEAAqE;AACrE,MAAM,MAAM,oBAAoB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAMzF;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,oBAAoB,CAAqC;IACjE,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ;IAO7C,4CAA4C;IAC5C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB3D,iDAAiD;IACjD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAU9C,0CAA0C;IAC1C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAK1C,kDAAkD;IAClD,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAIlD,uDAAuD;IACvD,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAIpD,uDAAuD;IACvD,KAAK,IAAI,IAAI;IAgBb,uDAAuD;IACvD,OAAO,CAAC,MAAM;IAsBd,OAAO,CAAC,QAAQ;IAwBhB,OAAO,CAAC,SAAS;CAGlB"}

package/dist/providers/codex/jsonrpc-client.js

@@ -0,0 +1,141 @@
+/**
+ * Codex JSON-RPC Client
+ *
+ * JSON-RPC 2.0 over JSONL stdio protocol layer for communicating
+ * with the Codex app-server. Handles request/response multiplexing,
+ * server-initiated requests, and notification dispatch.
+ *
+ * Note: Codex app-server omits the "jsonrpc":"2.0" header —
+ * we do not require or emit it.
+ *
+ * @module
+ */
+// ============================================================================
+// JSON-RPC Client
+// ============================================================================
+/**
+ * JSON-RPC 2.0 client over JSONL stdio.
+ *
+ * Multiplexes incoming messages by inspecting `id` and `method` fields:
+ * - Has `id` + no `method` → response → resolve/reject pending promise
+ * - Has `method` + no `id` → notification → dispatch to notification handler
+ * - Has both `method` + `id` → server-initiated request → dispatch to request handler
+ */
+export class CodexJsonRpcClient {
+    stdin;
+    nextId = 1;
+    pending = new Map();
+    notificationHandler = null;
+    serverRequestHandler = null;
+    lineBuffer = '';
+    closed = false;
+    constructor(stdin, stdout) {
+        this.stdin = stdin;
+        stdout.on('data', (chunk) => {
+            this.onData(chunk.toString());
+        });
+    }
+    /** Send a request and await the response */
+    request(method, params) {
+        if (this.closed) {
+            return Promise.reject(new Error('Client is closed'));
+        }
+        const id = this.nextId++;
+        const message = { method, id };
+        if (params !== undefined) {
+            message.params = params;
+        }
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            this.writeLine(message);
+        });
+    }
+    /** Send a notification (no response expected) */
+    notify(method, params) {
+        if (this.closed)
+            return;
+        const message = { method };
+        if (params !== undefined) {
+            message.params = params;
+        }
+        this.writeLine(message);
+    }
+    /** Reply to a server-initiated request */
+    respond(id, result) {
+        if (this.closed)
+            return;
+        this.writeLine({ id, result });
+    }
+    /** Register a handler for server notifications */
+    onNotification(handler) {
+        this.notificationHandler = handler;
+    }
+    /** Register a handler for server-initiated requests */
+    onServerRequest(handler) {
+        this.serverRequestHandler = handler;
+    }
+    /** Close the client, rejecting all pending requests */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const [, pending] of this.pending) {
+            pending.reject(new Error('Client closed'));
+        }
+        this.pending.clear();
+        this.notificationHandler = null;
+        this.serverRequestHandler = null;
+    }
+    // ----------------------------------------
+    // Private
+    // ----------------------------------------
+    /** Feed stdout data for JSONL line-buffered parsing */
+    onData(chunk) {
+        this.lineBuffer += chunk;
+        let newlineIndex;
+        while ((newlineIndex = this.lineBuffer.indexOf('\n')) !== -1) {
+            const line = this.lineBuffer.slice(0, newlineIndex).trim();
+            this.lineBuffer = this.lineBuffer.slice(newlineIndex + 1);
+            if (line.length === 0)
+                continue;
+            let message;
+            try {
+                message = JSON.parse(line);
+            }
+            catch {
+                // Skip malformed lines
+                continue;
+            }
+            this.dispatch(message);
+        }
+    }
+    dispatch(message) {
+        const hasId = message.id !== undefined;
+        const hasMethod = message.method !== undefined;
+        if (hasId && hasMethod) {
+            // Server-initiated request — has both id and method
+            this.serverRequestHandler?.(message.id, message.method, message.params);
+        }
+        else if (hasId && !hasMethod) {
+            // Response to our request
+            const pending = this.pending.get(message.id);
+            if (pending) {
+                this.pending.delete(message.id);
+                if (message.error) {
+                    pending.reject(new Error(message.error.message ?? 'RPC error'));
+                }
+                else {
+                    pending.resolve(message.result);
+                }
+            }
+        }
+        else if (hasMethod && !hasId) {
+            // Server notification
+            this.notificationHandler?.(message.method, message.params);
+        }
+    }
+    writeLine(message) {
+        this.stdin.write(JSON.stringify(message) + '\n');
+    }
+}
+//# sourceMappingURL=jsonrpc-client.js.map

package/dist/providers/codex/jsonrpc-client.js.map

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

package/dist/providers/codex/server-manager.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Codex Server Manager (Singleton)
+ *
+ * Manages the lifecycle of a single shared Codex app-server process.
+ * Multiple sessions share one server; ref counting shuts it down
+ * when the last session releases.
+ *
+ * Communicates via JSON-RPC 2.0 over JSONL stdio.
+ *
+ * @module
+ */
+import type { NotificationHandler } from './jsonrpc-client.js';
+/** Model information returned by the Codex app-server */
+export interface CodexModelInfo {
+    id: string;
+    name?: string;
+    description?: string;
+}
+/** Typed facade over the JSON-RPC client for Codex app-server operations */
+export interface CodexClient {
+    model: {
+        list(params?: {
+            limit?: number;
+        }): Promise<{
+            models?: CodexModelInfo[];
+            data?: CodexModelInfo[];
+        }>;
+    };
+    thread: {
+        start(params: {
+            model?: string;
+            cwd?: string;
+            approvalPolicy?: string;
+            sandbox?: string;
+        }): Promise<{
+            thread: {
+                id: string;
+            };
+        }>;
+        resume(params: {
+            threadId: string;
+            model?: string;
+            cwd?: string;
+            approvalPolicy?: string;
+            sandbox?: string;
+        }): Promise<{
+            thread: {
+                id: string;
+            };
+        }>;
+        read(params: {
+            threadId: string;
+        }): Promise<{
+            thread: {
+                id: string;
+            };
+        }>;
+    };
+    turn: {
+        start(params: {
+            threadId: string;
+            input: Array<{
+                type: 'text';
+                text: string;
+            }>;
+        }): Promise<void>;
+        interrupt(params: {
+            threadId: string;
+        }): Promise<void>;
+    };
+    onNotification(handler: NotificationHandler): () => void;
+    respondToServer(id: number, result: unknown): void;
+    close(): void;
+}
+export interface ServerManagerConfig {
+    cwd?: string;
+    stoneforgeRoot?: string;
+}
+/**
+ * Manages a single shared Codex app-server instance.
+ *
+ * - `acquire()` starts or reuses the server, increments ref count
+ * - `release()` decrements ref count, stops server at zero
+ * - Concurrent acquire() calls are coalesced into a single startup
+ */
+declare class CodexServerManager {
+    private client;
+    private process;
+    private rpcClient;
+    private refCount;
+    private startPromise;
+    acquire(config?: ServerManagerConfig): Promise<CodexClient>;
+    release(): void;
+    shutdown(): void;
+    private startServer;
+}
+/** Singleton instance */
+export declare const serverManager: CodexServerManager;
+export {};
+//# sourceMappingURL=server-manager.d.ts.map

package/dist/providers/codex/server-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-manager.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/server-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAM/D,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE;QACL,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;YAAC,IAAI,CAAC,EAAE,cAAc,EAAE,CAAA;SAAE,CAAC,CAAC;KACpG,CAAC;IACF,MAAM,EAAE;QACN,KAAK,CAAC,MAAM,EAAE;YACZ,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,cAAc,CAAC,EAAE,MAAM,CAAC;YACxB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,GAAG,OAAO,CAAC;YAAE,MAAM,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,EAAE;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,cAAc,CAAC,EAAE,MAAM,CAAC;YACxB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,GAAG,OAAO,CAAC;YAAE,MAAM,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,MAAM,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;KACzE,CAAC;IACF,IAAI,EAAE;QACJ,KAAK,CAAC,MAAM,EAAE;YACZ,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAC9C,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClB,SAAS,CAAC,MAAM,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACxD,CAAC;IACF,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAAC;IACzD,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAMD,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAqC;IAEnD,OAAO,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwBjE,OAAO,IAAI,IAAI;IAOf,QAAQ,IAAI,IAAI;YAcF,WAAW;CAmG1B;AAED,yBAAyB;AACzB,eAAO,MAAM,aAAa,oBAA2B,CAAC"}