@codex-app-sdk/backend 0.13.0

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

@@ -0,0 +1,157 @@
+import { type v2 } from '../codex/index';
+import type { CodexConversationSummary, CodexConversationEvent, CodexConversationHistory, CodexConversationHistoryPage, CodexConversationSnapshot, CodexSurfaceApprovalDecision, CodexSurfaceApprovalScope, CodexSurfaceChatGptDeviceCodeLogin, CodexSurfaceChatGptLogin, CodexSurfaceClientRequestResponse, CodexSurfaceEvent, CodexSurfaceModel, CodexSurfaceSnapshot, CodexSurfaceSkill, CreateCodexConversationOptions, ListCodexConversationsOptions, ListCodexModelsOptions, SendCodexMessageOptions, StartCodexLiveChatOptions, StartCodexReviewOptions, UpdateCodexConversationSettings } from '@codex-app-sdk/core/surface';
+import type { CodexConversation, CodexConversationForkResult, CodexConversationHostOptions, CodexSurfaceConfigRequirements, CodexSurfaceOptions, CodexSurfaceRemoteControlClientPage, CodexSurfaceRemoteControlPairing, CodexSurfaceRemoteControlPairingStatus, CodexSurfaceRemoteControlStatus, CodexGeneratedText, ForkCodexConversationOptions, GenerateCodexTextOptions, ListCodexSkillsOptions } from './codex-surface-contracts';
+export type { CodexAppServerTransportOptions, CodexConversation, CodexConversationDefaults, CodexConversationForkResult, CodexConversationHostOptions, CodexConversationLoadOptions, CodexDynamicTool, CodexDynamicToolCall, CodexDynamicToolContent, CodexDynamicToolResult, CodexRealtimeSession, CodexSurfaceConfigRequirements, CodexSurfaceExtension, CodexSurfaceOptions, CodexSurfaceRemoteControlClient, CodexSurfaceRemoteControlClientPage, CodexSurfaceRemoteControlPairing, CodexSurfaceRemoteControlPairingStatus, CodexSurfaceRemoteControlStatus, CodexThreadStartExtension, CodexGeneratedText, ForkCodexConversationOptions, GenerateCodexTextOptions, ListCodexSkillsOptions, } from './codex-surface-contracts';
+export type { CodexMcpServerDefinition, CodexMcpServerTransport, CodexMcpServerToolApprovalMode, } from './codex-surface-mcp';
+type StateListener = (snapshot: CodexSurfaceSnapshot) => void;
+type ConversationStateListener = (snapshot: CodexConversationSnapshot) => void;
+type SurfaceEventListener = (event: CodexSurfaceEvent) => void;
+type ConversationEventListener = (event: CodexConversationEvent) => void;
+export declare class CodexSurface {
+    private readonly options;
+    private readonly client;
+    private readonly listeners;
+    private readonly eventListeners;
+    private readonly conversationListeners;
+    private readonly conversationHandles;
+    private readonly extensions;
+    private readonly authentication;
+    private readonly items;
+    private readonly clientRequests;
+    private readonly catalog;
+    private readonly approvals;
+    private readonly conversations;
+    private readonly conversationSettings;
+    private readonly turnActions;
+    private readonly messagesController;
+    private readonly lifecycle;
+    private readonly forks;
+    private readonly notifications;
+    private readonly runtimeState;
+    private readonly markdownImages;
+    private readonly connection;
+    private readonly textGeneration;
+    private readonly unsubscribeDisconnect;
+    private readonly unsubscribeNotification;
+    private readonly unsubscribeToolInputRequests;
+    private readonly unsubscribeMcpElicitationRequests;
+    private eventSequence;
+    private readonly pendingMarkdownImageHydrations;
+    private closed;
+    private state;
+    constructor(options?: CodexSurfaceOptions);
+    connect(): Promise<CodexSurfaceSnapshot>;
+    /** Runs one non-persisted Codex turn without changing visible surface state. */
+    generateText(prompt: string, options?: GenerateCodexTextOptions): Promise<CodexGeneratedText>;
+    refreshAccount(): Promise<CodexSurfaceSnapshot>;
+    startChatGptLogin(): Promise<CodexSurfaceChatGptLogin>;
+    startChatGptDeviceCodeLogin(): Promise<CodexSurfaceChatGptDeviceCodeLogin>;
+    /** Reads the app-server's current remote-control connection state. */
+    readRemoteControlStatus(): Promise<CodexSurfaceRemoteControlStatus>;
+    /** Enables the app-server's official remote-control connection. */
+    enableRemoteControl(options?: v2.RemoteControlEnableParams): Promise<CodexSurfaceRemoteControlStatus>;
+    /** Disables the app-server's official remote-control connection. */
+    disableRemoteControl(options?: v2.RemoteControlDisableParams): Promise<CodexSurfaceRemoteControlStatus>;
+    /** Starts a one-time remote-control pairing flow. Treat the returned code as opaque. */
+    startRemoteControlPairing(options?: v2.RemoteControlPairingStartParams): Promise<CodexSurfaceRemoteControlPairing>;
+    /** Checks whether a remote-control pairing code has been claimed. */
+    readRemoteControlPairingStatus(options?: v2.RemoteControlPairingStatusParams): Promise<CodexSurfaceRemoteControlPairingStatus>;
+    /** Lists devices paired with a remote-control environment. */
+    listRemoteControlClients(options: v2.RemoteControlClientsListParams): Promise<CodexSurfaceRemoteControlClientPage>;
+    /** Revokes one device from a remote-control environment. */
+    revokeRemoteControlClient(options: v2.RemoteControlClientsRevokeParams): Promise<v2.RemoteControlClientsRevokeResponse>;
+    /** Reads managed app-server requirements, including allowRemoteControl. */
+    readConfigRequirements(): Promise<CodexSurfaceConfigRequirements | null>;
+    cancelLogin(loginId?: string): Promise<CodexSurfaceSnapshot>;
+    logout(): Promise<CodexSurfaceSnapshot>;
+    refreshConversations(): Promise<CodexSurfaceSnapshot>;
+    listConversations(options?: ListCodexConversationsOptions): Promise<CodexConversationSummary[]>;
+    /** Reads one conversation's metadata without loading its turns or runtime. */
+    readConversationSummary(conversationId: string): Promise<CodexConversationSummary>;
+    archiveConversation(conversationId: string): Promise<CodexSurfaceSnapshot>;
+    deleteConversation(conversationId: string): Promise<CodexSurfaceSnapshot>;
+    unarchiveConversation(conversationId: string): Promise<CodexSurfaceSnapshot>;
+    listModels(options?: ListCodexModelsOptions): Promise<CodexSurfaceModel[]>;
+    listSkills(options?: ListCodexSkillsOptions): Promise<CodexSurfaceSkill[]>;
+    createConversation(options?: CreateCodexConversationOptions, hostOptions?: CodexConversationHostOptions): Promise<CodexSurfaceSnapshot>;
+    /** Forks the latest completed source conversation without selecting the new conversation. */
+    forkConversation(sourceConversationId: string, options?: ForkCodexConversationOptions, hostOptions?: CodexConversationHostOptions): Promise<CodexConversationForkResult>;
+    /** Forks after a completed turn without selecting the new conversation. */
+    forkConversationAtTurn(sourceConversationId: string, turnId: string, options?: ForkCodexConversationOptions, hostOptions?: CodexConversationHostOptions): Promise<CodexConversationForkResult>;
+    selectConversation(conversationId: string): Promise<CodexSurfaceSnapshot>;
+    /**
+     * Releases one conversation from this surface's in-memory state without
+     * changing the corresponding app-server thread. The summary remains in the
+     * conversation catalog; `conversation(id).load()` or `readHistory()` can
+     * hydrate it again later.
+     */
+    forgetConversation(conversationId: string): void;
+    readConversationHistory(conversationId?: string): Promise<CodexConversationHistory>;
+    /** Reads a bounded user-only prompt list without hydrating conversation history. */
+    readConversationPromptHistory(conversationId?: string): Promise<import("@codex-app-sdk/core/surface").CodexConversationPromptHistory>;
+    loadOlderConversationHistory(conversationId?: string): Promise<CodexConversationHistoryPage>;
+    renameConversation(title: string): Promise<CodexSurfaceSnapshot>;
+    updateConversationSettings(settings: UpdateCodexConversationSettings): Promise<CodexSurfaceSnapshot>;
+    setGoal(objective: string, tokenBudget?: number | null): Promise<CodexSurfaceSnapshot>;
+    clearGoal(): Promise<CodexSurfaceSnapshot>;
+    sendMessage(prompt: string, options?: SendCodexMessageOptions): Promise<CodexSurfaceSnapshot>;
+    continueInterruptedTurn(): Promise<CodexSurfaceSnapshot>;
+    compactConversation(): Promise<CodexSurfaceSnapshot>;
+    startReview(options?: StartCodexReviewOptions): Promise<CodexSurfaceSnapshot>;
+    steerMessage(prompt: string, options?: SendCodexMessageOptions): Promise<CodexSurfaceSnapshot>;
+    interrupt(): Promise<CodexSurfaceSnapshot>;
+    deleteTurn(turnId: string): Promise<CodexSurfaceSnapshot>;
+    editTurn(turnId: string, content: string): Promise<CodexSurfaceSnapshot>;
+    retryTurn(turnId: string): Promise<CodexSurfaceSnapshot>;
+    /** Forks after an active-conversation turn and selects the new conversation. */
+    forkTurn(turnId: string): Promise<CodexSurfaceSnapshot>;
+    deleteQueuedPrompt(promptId: string): Promise<CodexSurfaceSnapshot>;
+    updateQueuedPrompt(promptId: string, prompt: string): Promise<CodexSurfaceSnapshot>;
+    steerQueuedPrompt(promptId: string, prompt?: string): Promise<CodexSurfaceSnapshot>;
+    respondToClientRequest(response: CodexSurfaceClientRequestResponse): Promise<CodexSurfaceSnapshot>;
+    resolveApproval(approvalId: string, decision: CodexSurfaceApprovalDecision, scope?: CodexSurfaceApprovalScope): Promise<CodexSurfaceSnapshot>;
+    conversation(conversationId: string): CodexConversation;
+    startLiveChat(conversationId: string, options: StartCodexLiveChatOptions): Promise<{
+        sdp: string;
+    }>;
+    stopLiveChat(conversationId: string): Promise<void>;
+    private startRealtimeForThread;
+    private conversationForkResult;
+    getConversationSnapshot(conversationId: string): CodexConversationSnapshot;
+    onConversationStateChange(conversationId: string, listener: ConversationStateListener): () => void;
+    onConversationEvent(conversationId: string, listener: ConversationEventListener): () => void;
+    getSnapshot(): CodexSurfaceSnapshot;
+    onStateChange(listener: StateListener): () => void;
+    onEvent(listener: SurfaceEventListener): () => void;
+    close(): Promise<void>;
+    private ensureConnected;
+    private ensureThreadReady;
+    private createRuntime;
+    private requireRuntime;
+    private runtimeProjection;
+    private snapshotForRuntime;
+    private activateRuntime;
+    private patchRuntime;
+    private scheduleMarkdownImageHydration;
+    private emitSurfaceStatus;
+    private emitSummaryUpserted;
+    private emitConversationActivity;
+    private emitConversationSettings;
+    private emitConversationSkills;
+    private emitConversationPermissions;
+    private emitHistoryReplaced;
+    private emitHistoryPrepended;
+    private messageContainingTool;
+    private assistantMessageForTurn;
+    private notifyConversationListeners;
+    private markRuntimeTurnActive;
+    private patchConversationStatus;
+    private patchConversationTurnCount;
+    private clearPendingForThread;
+    private removeThread;
+    private handleUnknownNotification;
+    private emitEvent;
+    private patch;
+}
+export declare function createCodexSurface(options?: CodexSurfaceOptions): CodexSurface;
+//# sourceMappingURL=codex-surface.d.ts.map

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

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

package/dist/node/codex-tool-part-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { CodexSurfaceFileActivityAction, CodexSurfaceFileActivityStatus, SurfaceMessageToolPart as RendererToolPart, SurfaceMessageToolPartUpdate as RendererToolPartUpdate } from '@codex-app-sdk/core/surface';
+export type CodexToolPartAdapterOptions = {
+    includeCommandOutput?: boolean;
+    cwd?: string | null;
+};
+export type CodexFileActivity = {
+    action: CodexSurfaceFileActivityAction;
+    path: string;
+    status: CodexSurfaceFileActivityStatus;
+};
+export declare function codexToolPartFileActivities(toolPart: RendererToolPart, cwd?: string | null): CodexFileActivity[];
+export declare function codexThreadItemToToolPart(item: unknown, options?: CodexToolPartAdapterOptions): RendererToolPart | null;
+export declare function shouldForwardCommandExecutionOutput(item: unknown): boolean;
+export declare function commandOutputDeltaToToolPartUpdate(itemId: string, delta: string): RendererToolPartUpdate;
+export declare function fileChangePatchToToolPartUpdate(itemId: string, changes: unknown[]): RendererToolPartUpdate;
+export declare function mcpProgressToToolPartUpdate(itemId: string, message: string): RendererToolPartUpdate;
+export declare function rawOutputToToolPartUpdate(itemId: string, output: unknown, title?: string, status?: unknown): RendererToolPartUpdate;
+export declare function lineDiffFromUnifiedDiff(diff: string | undefined): {
+    addedLines: number;
+    removedLines: number;
+};
+//# sourceMappingURL=codex-tool-part-adapter.d.ts.map

package/dist/node/codex-tool-part-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-tool-part-adapter.d.ts","sourceRoot":"","sources":["../../src/node/codex-tool-part-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,8BAA8B,EAC9B,8BAA8B,EAC9B,sBAAsB,IAAI,gBAAgB,EAC1C,4BAA4B,IAAI,sBAAsB,EACvD,MAAM,6BAA6B,CAAC;AAMrC,MAAM,MAAM,2BAA2B,GAAG;IACxC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,8BAA8B,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,8BAA8B,CAAC;CACxC,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAClB,iBAAiB,EAAE,CA0BrB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,2BAAgC,GAAG,gBAAgB,GAAG,IAAI,CA0I3H;AAED,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAO1E;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAYxG;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAoB1G;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAYnG;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,OAAqB,GAAG,sBAAsB,CAmBhJ;AA+OD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAoB9G"}

package/dist/node/codex-unix-socket-transport.d.ts

@@ -0,0 +1,40 @@
+import { type RpcMessage, type RpcTransport } from '../codex/wire';
+export type CodexAppServerUnixSocketTransportOptions = {
+    /** Discriminates this opt-in transport from the default spawned stdio transport. */
+    type: 'unixSocket';
+    /** Absolute path to an app-server control socket. */
+    socketPath?: string;
+    /** Used to derive the default control socket when socketPath is omitted. */
+    codexHome?: string;
+    maxFrameBytes?: number;
+};
+/**
+ * Connects to an already-running Codex app-server listening on a Unix socket.
+ * It never owns, starts, or stops the remote server.
+ */
+export declare class CodexAppServerUnixSocketTransport implements RpcTransport {
+    private readonly options;
+    private socket;
+    private readonly messageListeners;
+    private readonly errorListeners;
+    private handshakeBuffer;
+    private frameBuffer;
+    private fragments;
+    private fragmentOpcode;
+    private started;
+    private closed;
+    constructor(options: CodexAppServerUnixSocketTransportOptions);
+    start(): Promise<void>;
+    send(message: RpcMessage): void;
+    close(): Promise<void>;
+    onMessage(listener: (message: unknown) => void): () => void;
+    onError(listener: (error: Error) => void): () => void;
+    private socketPath;
+    private handleFrameData;
+    private handleFrame;
+    private writeFrame;
+    private handleSocketError;
+    private handleSocketClose;
+    private emitError;
+}
+//# sourceMappingURL=codex-unix-socket-transport.d.ts.map

package/dist/node/codex-unix-socket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-unix-socket-transport.d.ts","sourceRoot":"","sources":["../../src/node/codex-unix-socket-transport.ts"],"names":[],"mappings":"AAIA,OAAO,EAA6B,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAI9F,MAAM,MAAM,wCAAwC,GAAG;IACrD,oFAAoF;IACpF,IAAI,EAAE,YAAY,CAAC;IACnB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,qBAAa,iCAAkC,YAAW,YAAY;IAWxD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAVpC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyC;IAC1E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqC;IACpE,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEM,OAAO,EAAE,wCAAwC;IAExE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgD5B,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAKzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAK3D,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;IAKrD,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,WAAW;IAoCnB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,SAAS;CAGlB"}

package/dist/node/index.d.ts

@@ -0,0 +1,10 @@
+export { CodexAppServerStdioTransport, type CodexAppServerExit, type CodexAppServerStdioTransportOptions, } from './codex-stdio-transport';
+export { CodexAppServerUnixSocketTransport, type CodexAppServerUnixSocketTransportOptions, } from './codex-unix-socket-transport';
+export { codexRuntimePathEntries, discoverCodexExecutable, withCodexRuntimePath, type CodexExecutableDiscoveryDependencies, } from './codex-executable';
+export { CodexSurface, createCodexSurface, type CodexConversation, type CodexConversationDefaults, type CodexConversationForkResult, type CodexConversationHostOptions, type CodexConversationLoadOptions, type CodexRealtimeSession, type CodexDynamicTool, type CodexDynamicToolCall, type CodexDynamicToolContent, type CodexDynamicToolResult, type CodexMcpServerDefinition, type CodexMcpServerToolApprovalMode, type CodexMcpServerTransport, type CodexSurfaceExtension, type CodexSurfaceConfigRequirements, type CodexSurfaceOptions, type CodexAppServerTransportOptions, type CodexSurfaceRemoteControlClient, type CodexSurfaceRemoteControlClientPage, type CodexSurfaceRemoteControlPairing, type CodexSurfaceRemoteControlPairingStatus, type CodexSurfaceRemoteControlStatus, type CodexThreadStartExtension, type CodexGeneratedText, type ForkCodexConversationOptions, type GenerateCodexTextOptions, type ListCodexSkillsOptions, } from './codex-surface';
+export type { CodexConversationHistoryPage, CodexConversationLoadingStrategy, CodexConversationRenderStrategy, } from '@codex-app-sdk/core/surface';
+export { CodexAppBackend, createCodexAppBackend, type CodexAppBackendModule, type CodexAppBackendModuleContext, type CodexAppBackendOptions, } from './codex-app-backend';
+export { CodexAppBackendTtlCache, type CodexAppBackendTtlCacheEvictionContext, type CodexAppBackendTtlCacheOptions, type CodexAppBackendTtlCacheRecord, type CodexAppBackendTtlCacheScheduler, type CodexAppBackendTtlTimer, } from './codex-app-backend-cache';
+export { codexItemToMediaPart, codexItemToSurfaceMessage, codexItemToToolPart, codexThreadToSurfaceMessages, codexTurnToSurfaceMessages, preserveHistoricalAttachmentPreviews, } from './codex-conversation-history';
+export { resolveAppleSpeechAnalyzerPath, transcribeWithAppleSpeechAnalyzer, type AppleSpeechAssetDiscoveryDependencies, type AppleSpeechTranscriptionOptions, type AppleSpeechTranscriptionResult, } from './apple-speech-transcription';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,mCAAmC,GACzC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iCAAiC,EACjC,KAAK,wCAAwC,GAC9C,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,KAAK,oCAAoC,GAC1C,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,EACnC,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,8BAA8B,EACnC,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,mCAAmC,EACxC,KAAK,gCAAgC,EACrC,KAAK,sCAAsC,EAC3C,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,4BAA4B,EAC5B,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EACvB,KAAK,sCAAsC,EAC3C,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EACrC,KAAK,uBAAuB,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,4BAA4B,EAC5B,0BAA0B,EAC1B,oCAAoC,GACrC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,8BAA8B,EAC9B,iCAAiC,EACjC,KAAK,qCAAqC,EAC1C,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,GACpC,MAAM,8BAA8B,CAAC"}

package/dist/node/tool-output.d.ts

@@ -0,0 +1,2 @@
+export declare function toolOutputText(output: unknown): string | undefined;
+//# sourceMappingURL=tool-output.d.ts.map

package/dist/node/tool-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output.d.ts","sourceRoot":"","sources":["../../src/node/tool-output.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CA2BlE"}

package/dist/protocol.js

@@ -0,0 +1,2 @@
+import { a as e, i as t, n, o as r, r as i, t as a } from "./chunks/codex-BT2Vtjs1.js";
+export { n as CodexAppServerClient, i as RpcRemoteError, t as RpcTransportProtocolError, a as codexSchemaCliVersion, e as isRecord, r as isRpcError };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@codex-app-sdk/backend",
+  "version": "0.13.0",
+  "description": "Node.js app-server runtime and backend composition 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/backend"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "assets",
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/codex/index.d.ts",
+      "import": "./dist/protocol.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/backend/stryker.config.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@codex-app-sdk/core": "0.13.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}