@codex-app-sdk/backend 0.13.0

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

@@ -0,0 +1,60 @@
+import type { CodexAppServerClient, v2 } from '../codex/index';
+import type { CodexSurfaceAuthentication, CodexSurfaceChatGptDeviceCodeLogin, CodexSurfaceChatGptLogin, CodexSurfaceEventOrigin, CodexSurfaceSnapshot } from '@codex-app-sdk/core/surface';
+import { CodexSurfaceApprovalsController } from './codex-surface-approvals-controller';
+import { CodexSurfaceAuthenticationController } from './codex-surface-authentication-controller';
+import { CodexSurfaceCatalogController } from './codex-surface-catalog-controller';
+import { CodexSurfaceClientRequestsController } from './codex-surface-client-requests-controller';
+import { CodexSurfaceConversationsController } from './codex-surface-conversations-controller';
+import type { CodexSurfaceConfigRequirements, CodexSurfaceOptions, CodexSurfaceRemoteControlClientPage, CodexSurfaceRemoteControlPairing, CodexSurfaceRemoteControlPairingStatus, CodexSurfaceRemoteControlStatus } from './codex-surface-contracts';
+import { CodexSurfaceItemsController } from './codex-surface-items-controller';
+import { CodexSurfaceLifecycleController } from './codex-surface-lifecycle-controller';
+import { CodexSurfaceRuntimeController } from './codex-surface-runtime-controller';
+export interface CodexSurfaceConnectionHost {
+    clearConversationHandles(): void;
+    clearPendingForThread(threadId: string, reason: string, eventReason: 'surface_disconnected'): void;
+    closed(): boolean;
+    emitAuthenticationChanged(authentication: CodexSurfaceAuthentication, origin: CodexSurfaceEventOrigin): void;
+    emitSurfaceStatus(origin: CodexSurfaceEventOrigin): void;
+    getSnapshot(): CodexSurfaceSnapshot;
+    getState(): CodexSurfaceSnapshot;
+    patch(patch: Partial<CodexSurfaceSnapshot>): void;
+}
+export declare class CodexSurfaceConnectionController {
+    private readonly client;
+    private readonly options;
+    private readonly authentication;
+    private readonly approvals;
+    private readonly catalog;
+    private readonly clientRequests;
+    private readonly conversations;
+    private readonly items;
+    private readonly lifecycle;
+    private readonly runtimeState;
+    private readonly host;
+    private connectPromise;
+    private surfaceBootstrapPromise;
+    private bootstrappedAuthenticationKey;
+    constructor(client: CodexAppServerClient, options: Pick<CodexSurfaceOptions, 'autoSelectFirstConversation' | 'clientInfo'>, authentication: CodexSurfaceAuthenticationController, approvals: CodexSurfaceApprovalsController, catalog: CodexSurfaceCatalogController, clientRequests: CodexSurfaceClientRequestsController, conversations: CodexSurfaceConversationsController, items: CodexSurfaceItemsController, lifecycle: CodexSurfaceLifecycleController, runtimeState: CodexSurfaceRuntimeController, host: CodexSurfaceConnectionHost);
+    connect(): Promise<CodexSurfaceSnapshot>;
+    private enableSupportedRuntimeFeatures;
+    ensureConnected(): Promise<void>;
+    bootstrapSurfaceData(force?: boolean): Promise<void>;
+    refreshAccount(): Promise<CodexSurfaceSnapshot>;
+    startChatGptLogin(): Promise<CodexSurfaceChatGptLogin>;
+    startChatGptDeviceCodeLogin(): Promise<CodexSurfaceChatGptDeviceCodeLogin>;
+    cancelLogin(loginId: string): Promise<CodexSurfaceSnapshot>;
+    logout(): Promise<CodexSurfaceSnapshot>;
+    readRemoteControlStatus(): Promise<CodexSurfaceRemoteControlStatus>;
+    enableRemoteControl(options?: v2.RemoteControlEnableParams): Promise<CodexSurfaceRemoteControlStatus>;
+    disableRemoteControl(options?: v2.RemoteControlDisableParams): Promise<CodexSurfaceRemoteControlStatus>;
+    startRemoteControlPairing(options?: v2.RemoteControlPairingStartParams): Promise<CodexSurfaceRemoteControlPairing>;
+    readRemoteControlPairingStatus(options?: v2.RemoteControlPairingStatusParams): Promise<CodexSurfaceRemoteControlPairingStatus>;
+    listRemoteControlClients(options: v2.RemoteControlClientsListParams): Promise<CodexSurfaceRemoteControlClientPage>;
+    revokeRemoteControlClient(options: v2.RemoteControlClientsRevokeParams): Promise<v2.RemoteControlClientsRevokeResponse>;
+    readConfigRequirements(): Promise<CodexSurfaceConfigRequirements | null>;
+    patchAuthentication(patch: Partial<CodexSurfaceAuthentication>, origin: CodexSurfaceEventOrigin): void;
+    handleDisconnect(error: Error): void;
+    private resetAppServerSessionState;
+    clearAuthenticatedSurfaceData(): Promise<void>;
+}
+//# sourceMappingURL=codex-surface-connection-controller.d.ts.map

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

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

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

@@ -0,0 +1,168 @@
+import type { CodexAppServerClient, v2 } from '../codex/index';
+import type { CodexConversationEvent, CodexConversationHistory, CodexConversationHistoryPage, CodexConversationPromptHistory, CodexConversationLoadingStrategy, CodexConversationSnapshot, CodexRealtimeEvent, CodexRealtimeInputAudioChunk, CodexSurfaceApprovalDecision, CodexSurfaceApprovalMode, CodexSurfaceApprovalPreset, CodexSurfaceApprovalScope, CodexSurfaceClientRequestResponse, CodexSurfaceJsonValue, CodexSurfacePermissionMode, CreateCodexConversationOptions, SendCodexMessageOptions, StartCodexRealtimeOptions, StartCodexReviewOptions, UpdateCodexConversationSettings } from '@codex-app-sdk/core/surface';
+import type { CodexMcpServerDefinition } from './codex-surface-mcp';
+import type { CodexAppServerStdioTransportOptions } from './codex-stdio-transport';
+import type { CodexAppServerUnixSocketTransportOptions } from './codex-unix-socket-transport';
+export type GenerateCodexTextOptions = {
+    baseInstructions?: string;
+    cwd?: string;
+    developerInstructions?: string;
+    model?: string;
+    outputSchema?: CodexSurfaceJsonValue;
+    reasoningEffort?: string;
+    serviceTier?: string | null;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+};
+export type CodexGeneratedText = {
+    text: string;
+};
+export type CodexDynamicToolContent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    imageUrl: string;
+};
+export type CodexDynamicToolResult = string | {
+    content: readonly CodexDynamicToolContent[];
+    success?: boolean;
+};
+export type CodexDynamicToolCall = {
+    callId: string;
+    conversationId: string;
+    turnId: string;
+    arguments: CodexSurfaceJsonValue;
+    extensionContext?: unknown;
+};
+export type CodexDynamicTool = {
+    name: string;
+    description: string;
+    inputSchema: CodexSurfaceJsonValue;
+    deferLoading?: boolean;
+    execute(call: CodexDynamicToolCall): CodexDynamicToolResult | Promise<CodexDynamicToolResult>;
+};
+export type CodexThreadStartExtension = {
+    baseInstructions?: string;
+    config?: Readonly<Record<string, CodexSurfaceJsonValue>>;
+    developerInstructions?: string;
+};
+export type CodexConversationHostOptions = {
+    extensionContext?: unknown;
+    /** Replaces the surface MCP definitions for this conversation. Main-process only. */
+    mcpServers?: readonly CodexMcpServerDefinition[];
+};
+export type CodexConversationDefaults = Pick<CreateCodexConversationOptions, 'model' | 'reasoningEffort' | 'serviceTier'>;
+export type CodexConversationLoadOptions = CodexConversationHostOptions & {
+    cwd?: string;
+    loadingStrategy?: CodexConversationLoadingStrategy;
+};
+/** Trusted thread-start overrides applied to a fork. Omitted values inherit from the source thread. */
+export type ForkCodexConversationOptions = CreateCodexConversationOptions;
+export type CodexConversationForkResult = {
+    readonly conversationId: string;
+    readonly conversation: CodexConversation;
+    readonly snapshot: CodexConversationSnapshot;
+};
+export type ListCodexSkillsOptions = {
+    cwd?: string;
+    forceReload?: boolean;
+};
+/** State returned by the app-server remote-control connection. */
+export type CodexSurfaceRemoteControlStatus = v2.RemoteControlStatusReadResponse;
+/** One-time remote-control pairing details returned by the app-server. */
+export type CodexSurfaceRemoteControlPairing = v2.RemoteControlPairingStartResponse;
+/** Result of checking whether a remote-control pairing code was claimed. */
+export type CodexSurfaceRemoteControlPairingStatus = v2.RemoteControlPairingStatusResponse;
+/** A device currently paired with a remote-control environment. */
+export type CodexSurfaceRemoteControlClient = v2.RemoteControlClient;
+/** A page of devices paired with a remote-control environment. */
+export type CodexSurfaceRemoteControlClientPage = v2.RemoteControlClientsListResponse;
+/** Managed configuration requirements relevant to the host surface. */
+export type CodexSurfaceConfigRequirements = v2.ConfigRequirements;
+export type CodexSurfaceExtension = {
+    dynamicTools?: readonly CodexDynamicTool[];
+    configureConversation?: (context: {
+        operation: 'start' | 'resume';
+        conversationId: string | null;
+        cwd?: string;
+        createOptions?: Readonly<CreateCodexConversationOptions>;
+        extensionContext?: unknown;
+    }) => CodexThreadStartExtension | Promise<CodexThreadStartExtension>;
+};
+export type CodexConversation = {
+    readonly id: string;
+    fork(options?: ForkCodexConversationOptions, hostOptions?: CodexConversationHostOptions): Promise<CodexConversationForkResult>;
+    forkTurn(turnId: string, options?: ForkCodexConversationOptions, hostOptions?: CodexConversationHostOptions): Promise<CodexConversationForkResult>;
+    load(options?: CodexConversationLoadOptions): Promise<CodexConversationSnapshot>;
+    select(): Promise<CodexConversationSnapshot>;
+    readHistory(): Promise<CodexConversationHistory>;
+    readPromptHistory(): Promise<CodexConversationPromptHistory>;
+    loadOlderHistory(): Promise<CodexConversationHistoryPage>;
+    rename(title: string): Promise<CodexConversationSnapshot>;
+    updateSettings(settings: UpdateCodexConversationSettings): Promise<CodexConversationSnapshot>;
+    sendMessage(prompt: string, options?: SendCodexMessageOptions): Promise<CodexConversationSnapshot>;
+    continueInterruptedTurn(): Promise<CodexConversationSnapshot>;
+    /** Starts an experimental app-server realtime voice session without exposing JSON-RPC. */
+    startRealtime(options: StartCodexRealtimeOptions): Promise<CodexRealtimeSession>;
+    compact(): Promise<CodexConversationSnapshot>;
+    startReview(options?: StartCodexReviewOptions): Promise<CodexConversationSnapshot>;
+    steerMessage(prompt: string, options?: SendCodexMessageOptions): Promise<CodexConversationSnapshot>;
+    interrupt(): Promise<CodexConversationSnapshot>;
+    deleteTurn(turnId: string): Promise<CodexConversationSnapshot>;
+    editTurn(turnId: string, content: string): Promise<CodexConversationSnapshot>;
+    retryTurn(turnId: string): Promise<CodexConversationSnapshot>;
+    deleteQueuedPrompt(promptId: string): Promise<CodexConversationSnapshot>;
+    updateQueuedPrompt(promptId: string, prompt: string): Promise<CodexConversationSnapshot>;
+    steerQueuedPrompt(promptId: string, prompt?: string): Promise<CodexConversationSnapshot>;
+    respondToClientRequest(response: CodexSurfaceClientRequestResponse): Promise<CodexConversationSnapshot>;
+    resolveApproval(approvalId: string, decision: CodexSurfaceApprovalDecision, scope?: CodexSurfaceApprovalScope): Promise<CodexConversationSnapshot>;
+    setGoal(objective: string, tokenBudget?: number | null): Promise<CodexConversationSnapshot>;
+    clearGoal(): Promise<CodexConversationSnapshot>;
+    getSnapshot(): CodexConversationSnapshot;
+    onStateChange(listener: (snapshot: CodexConversationSnapshot) => void): () => void;
+    onEvent(listener: (event: CodexConversationEvent) => void): () => void;
+};
+export type CodexRealtimeSession = {
+    readonly conversationId: string;
+    readonly transport: 'websocket' | 'webrtc';
+    readonly remoteSdp: string | null;
+    appendAudio(audio: CodexRealtimeInputAudioChunk): Promise<void>;
+    appendText(text: string, role?: 'user' | 'developer' | 'assistant'): Promise<void>;
+    appendSpeech(text: string): Promise<void>;
+    stop(): Promise<void>;
+    onEvent(listener: (event: CodexRealtimeEvent) => void): () => void;
+};
+export type CodexAppServerTransportOptions = CodexAppServerStdioTransportOptions | CodexAppServerUnixSocketTransportOptions;
+export type CodexSurfaceOptions = {
+    approvalPreset?: CodexSurfaceApprovalPreset;
+    approvalMode?: CodexSurfaceApprovalMode;
+    clientInfo?: {
+        name: string;
+        title?: string;
+        version: string;
+    };
+    /** Host-owned defaults used by explicit and implicit conversation creation. */
+    conversationDefaults?: Readonly<CodexConversationDefaults>;
+    conversationLimit?: number;
+    /** Default history loading strategy for resumed conversations. */
+    loadingStrategy?: CodexConversationLoadingStrategy;
+    /** Trusted main-process CODEX_HOME for the app-server. Never expose this through renderer IPC. */
+    codexHome?: string;
+    cwd?: string;
+    autoSelectFirstConversation?: boolean;
+    extensions?: readonly CodexSurfaceExtension[];
+    /** App-owned MCP servers applied to every started or resumed conversation. Main-process only. */
+    mcpServers?: readonly CodexMcpServerDefinition[];
+    /** Receives notifications added by a newer app-server than this SDK schema. */
+    onUnknownNotification?: (notification: {
+        method: string;
+        params?: unknown;
+    }) => void;
+    permissionMode?: CodexSurfacePermissionMode;
+    /** Defaults to a spawned stdio child; use `{ type: 'unixSocket' }` to reuse an existing local daemon. */
+    transport?: CodexAppServerTransportOptions;
+    /** Test and advanced embedding seam. Most apps should let the SDK create the client. */
+    client?: CodexAppServerClient;
+};
+//# sourceMappingURL=codex-surface-contracts.d.ts.map

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

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

package/dist/node/codex-surface-conversation-settings-controller.d.ts

@@ -0,0 +1,42 @@
+import type { CodexAppServerClient, v2 } from '../codex/index';
+import type { CodexConversationSummary, CodexSurfaceApprovalMode, CodexSurfaceApprovalPreset, CodexSurfacePermissionMode, CodexSurfaceSnapshot, CreateCodexConversationOptions, UpdateCodexConversationSettings } from '@codex-app-sdk/core/surface';
+import type { SurfaceEventInput } from './codex-surface-events';
+import type { ThreadRuntimePatch, ThreadRuntimeState } from './codex-surface-runtime';
+export type CodexSurfaceConversationSettingsHost = {
+    createConversation(): Promise<void>;
+    emitConversationSettings(threadId: string, origin: 'action'): void;
+    emitEvent(origin: 'action', input: SurfaceEventInput): void;
+    emitSummaryUpserted(summary: CodexConversationSummary, reason: 'updated', origin: 'action'): void;
+    ensureConnected(): Promise<void>;
+    ensureThreadReady(threadId: string): Promise<ThreadRuntimeState>;
+    getSnapshot(): CodexSurfaceSnapshot;
+    getState(): CodexSurfaceSnapshot;
+    patch(patch: Partial<CodexSurfaceSnapshot>): void;
+    patchRuntime(threadId: string, patch: ThreadRuntimePatch): void;
+    snapshotForRuntime(runtime: ThreadRuntimeState): CodexSurfaceSnapshot;
+};
+export declare class CodexSurfaceConversationSettingsController {
+    private readonly client;
+    private readonly defaults;
+    private readonly host;
+    constructor(client: CodexAppServerClient, defaults: {
+        approvalMode?: CodexSurfaceApprovalMode;
+        approvalPreset?: CodexSurfaceApprovalPreset;
+        permissionMode?: CodexSurfacePermissionMode;
+    }, host: CodexSurfaceConversationSettingsHost);
+    preferredApprovalPreset(): CodexSurfaceApprovalPreset | null;
+    threadStartSettings(options: CreateCodexConversationOptions, availablePresets: readonly CodexSurfaceApprovalPreset[]): {
+        approvalPolicy: v2.AskForApproval;
+        approvalsReviewer?: v2.ApprovalsReviewer;
+        permissions?: string;
+        sandbox?: v2.SandboxMode;
+    };
+    rename(threadId: string, title: string): Promise<void>;
+    update(settings: UpdateCodexConversationSettings): Promise<CodexSurfaceSnapshot>;
+    updateForThread(threadId: string, settings: UpdateCodexConversationSettings): Promise<void>;
+    setGoal(objective: string, tokenBudget?: number | null): Promise<CodexSurfaceSnapshot>;
+    setGoalForThread(threadId: string, objective: string, tokenBudget?: number | null): Promise<void>;
+    clearGoal(): Promise<CodexSurfaceSnapshot>;
+    clearGoalForThread(threadId: string): Promise<void>;
+}
+//# sourceMappingURL=codex-surface-conversation-settings-controller.d.ts.map

package/dist/node/codex-surface-conversation-settings-controller.d.ts.map

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

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

@@ -0,0 +1,52 @@
+import type { CodexAppServerClient } from '../codex/index';
+import type { CodexConversationSummary, CodexSurfaceSnapshot, ListCodexConversationsOptions, SurfaceMessage } from '@codex-app-sdk/core/surface';
+import type { ThreadRuntimePatch, ThreadRuntimeState } from './codex-surface-runtime';
+type HistoryHydrationOptions = {
+    initialPageLoaded?: boolean;
+    cursor?: string | null;
+    restart?: boolean;
+};
+export type CodexSurfaceConversationsHost = {
+    emitHistoryPrepended(threadId: string, messages: readonly SurfaceMessage[], origin: 'lifecycle'): void;
+    emitSummaryUpserted(summary: CodexConversationSummary, reason: 'listed' | 'updated', origin: 'action'): void;
+    ensureConnected(): Promise<void>;
+    getSnapshot(): CodexSurfaceSnapshot;
+    getState(): CodexSurfaceSnapshot;
+    patch(patch: Partial<CodexSurfaceSnapshot>): void;
+    patchRuntime(threadId: string, patch: ThreadRuntimePatch): void;
+    removeThread(threadId: string, reason: 'archived' | 'deleted', origin: 'action'): void;
+    requireRuntime(threadId: string): ThreadRuntimeState;
+    runtime(threadId: string): ThreadRuntimeState | undefined;
+    schedulePluginRefresh(force: boolean): void;
+};
+export declare class CodexSurfaceConversationsController {
+    private readonly client;
+    private readonly conversationLimit;
+    private readonly host;
+    private readonly historyHydrations;
+    private readonly historyLoads;
+    constructor(client: CodexAppServerClient, conversationLimit: number | undefined, host: CodexSurfaceConversationsHost);
+    reset(): void;
+    forget(threadId: string): void;
+    refresh(): Promise<CodexSurfaceSnapshot>;
+    load(): Promise<CodexSurfaceSnapshot>;
+    list(options?: ListCodexConversationsOptions): Promise<CodexConversationSummary[]>;
+    readSummary(conversationId: string): Promise<CodexConversationSummary>;
+    archive(conversationId: string): Promise<CodexSurfaceSnapshot>;
+    delete(conversationId: string): Promise<CodexSurfaceSnapshot>;
+    unarchive(conversationId: string): Promise<CodexSurfaceSnapshot>;
+    hydrateCompleteHistory(threadId: string, options?: HistoryHydrationOptions): Promise<void>;
+    loadOlderHistory(threadId: string): Promise<{
+        conversationId: string;
+        messages: SurfaceMessage[];
+        hasOlder: boolean;
+    }>;
+    waitForHistoryEmission(threadId: string): Promise<void>;
+    private emitHistoryChunks;
+    refreshCompleteHistory(threadId: string): Promise<void>;
+    private requestConversations;
+    private mergeHistoryPage;
+    private summaryWithKnownTurnCount;
+}
+export {};
+//# sourceMappingURL=codex-surface-conversations-controller.d.ts.map

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

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

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

@@ -0,0 +1,20 @@
+import type { v2 } from '../codex/index';
+import type { CodexConversationSummary, CodexSurfaceAttachment, CodexSurfaceContextUsage, CodexSurfaceRateLimitSnapshot, CodexSurfaceRateLimits, CodexSurfaceSnapshot, CodexSurfaceThreadStatus, SendCodexMessageOptions, SurfaceMessage, SurfaceMessageAttachmentPart } from '@codex-app-sdk/core/surface';
+export declare function threadToSummary(thread: v2.Thread): CodexConversationSummary;
+export declare function upsertConversation(conversations: CodexConversationSummary[], next: CodexConversationSummary): CodexConversationSummary[];
+export declare function validatedSendOptions(state: CodexSurfaceSnapshot, options: SendCodexMessageOptions): SendCodexMessageOptions;
+export declare function validateAttachments(attachments: readonly CodexSurfaceAttachment[]): CodexSurfaceAttachment[];
+export declare function attachmentInput(attachment: CodexSurfaceAttachment): v2.UserInput;
+export declare function surfaceAttachmentPart(attachment: CodexSurfaceAttachment): SurfaceMessageAttachmentPart;
+export declare function messageTurnIdOrNull(message: SurfaceMessage): string | null;
+export declare function messageTurnId(message: SurfaceMessage): string;
+export declare function surfaceMessageText(message: SurfaceMessage): string;
+export declare function surfaceMessageAttachments(message: SurfaceMessage): CodexSurfaceAttachment[];
+export declare function surfaceContextUsage(tokenUsage: v2.ThreadTokenUsage): CodexSurfaceContextUsage;
+export declare function surfaceThreadStatus(status: v2.ThreadStatus): CodexSurfaceThreadStatus;
+export declare function conversationStatus(status: v2.ThreadStatus): CodexConversationSummary['status'];
+export declare function surfaceRateLimits(response: v2.GetAccountRateLimitsResponse): CodexSurfaceRateLimits;
+export declare function surfaceRateLimitSnapshot(snapshot: v2.RateLimitSnapshot): CodexSurfaceRateLimitSnapshot;
+export declare function mergeSurfaceRateLimits(current: CodexSurfaceRateLimits | null, update: v2.RateLimitSnapshot): CodexSurfaceRateLimits;
+export declare function mergeRateLimitSnapshot(current: CodexSurfaceRateLimitSnapshot, update: CodexSurfaceRateLimitSnapshot): CodexSurfaceRateLimitSnapshot;
+//# sourceMappingURL=codex-surface-data.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-data.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-data.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAQrC,wBAAgB,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,GAAG,wBAAwB,CAiB3E;AAED,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,wBAAwB,EAAE,EACzC,IAAI,EAAE,wBAAwB,GAC7B,wBAAwB,EAAE,CAG5B;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,uBAAuB,GAC/B,uBAAuB,CAWzB;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,GAAG,sBAAsB,EAAE,CAS5G;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,sBAAsB,GAAG,EAAE,CAAC,SAAS,CAahF;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,sBAAsB,GAAG,4BAA4B,CAuBtG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAG1E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAI7D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAMlE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,EAAE,CAsB3F;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,EAAE,CAAC,gBAAgB,GAAG,wBAAwB,CAgB7F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,GAAG,wBAAwB,CAIrF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAI9F;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,EAAE,CAAC,4BAA4B,GAAG,sBAAsB,CAcnG;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,EAAE,CAAC,iBAAiB,GAAG,6BAA6B,CAWtG;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,sBAAsB,GAAG,IAAI,EACtC,MAAM,EAAE,EAAE,CAAC,iBAAiB,GAC3B,sBAAsB,CAsBxB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,EACtC,MAAM,EAAE,6BAA6B,GACpC,6BAA6B,CAa/B"}

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

@@ -0,0 +1,13 @@
+import type { v2 } from '../codex/index';
+import type { CodexSurfaceEvent, CodexSurfaceTurn, CodexSurfaceTurnError } from '@codex-app-sdk/core/surface';
+export type SurfaceEventInput = CodexSurfaceEvent extends infer Event ? Event extends CodexSurfaceEvent ? Omit<Event, 'seq' | 'occurredAt' | 'origin'> : never : never;
+export declare function threadItemKey(threadId: string, itemId: string): string;
+export declare function timestampToIso(timestamp: number | null | undefined): string;
+export declare function timestampToIsoOrNull(timestamp: number | null | undefined): string | null;
+export declare function surfaceTurnError(error: v2.TurnError | null): CodexSurfaceTurnError | null;
+export declare function surfaceTurn(turn: v2.Turn, willRetry?: boolean): CodexSurfaceTurn;
+export declare function upsertSurfaceTurn(turns: readonly CodexSurfaceTurn[], turn: CodexSurfaceTurn): CodexSurfaceTurn[];
+export declare function sameValue(left: unknown, right: unknown): boolean;
+export declare function createMessageId(): string;
+export declare function createQueuedPromptId(): string;
+//# sourceMappingURL=codex-surface-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-events.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EACV,iBAAiB,EAEjB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,SAAS,MAAM,KAAK,GACjE,KAAK,SAAS,iBAAiB,GAC7B,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,QAAQ,CAAC,GAC5C,KAAK,GACP,KAAK,CAAC;AAEV,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAI3E;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIxF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,GAAG,IAAI,GAAG,qBAAqB,GAAG,IAAI,CAOzF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,UAAQ,GAAG,gBAAgB,CAU9E;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,IAAI,EAAE,gBAAgB,GACrB,gBAAgB,EAAE,CAMpB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhE;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

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

@@ -0,0 +1,20 @@
+import type { CodexServerRequestResponder, ServerRequest, v2 } from '../codex/index';
+import type { CreateCodexConversationOptions } from '@codex-app-sdk/core/surface';
+import { type CodexMcpServerDefinition } from './codex-surface-mcp';
+import type { CodexConversationLoadOptions, CodexSurfaceExtension, CodexThreadStartExtension } from './codex-surface-contracts';
+type DynamicToolRequest = Extract<ServerRequest, {
+    method: 'item/tool/call';
+}>;
+export declare class CodexSurfaceExtensionsController {
+    private readonly extensions;
+    private readonly hostOptionsForThread;
+    private readonly dynamicTools;
+    readonly defaultMcpServers: readonly CodexMcpServerDefinition[];
+    constructor(extensions: readonly CodexSurfaceExtension[], mcpServers: readonly CodexMcpServerDefinition[], hostOptionsForThread: (threadId: string) => CodexConversationLoadOptions | undefined);
+    hasDynamicTools(): boolean;
+    dynamicToolSpecs(): v2.DynamicToolSpec[];
+    conversationExtension(context: Parameters<NonNullable<CodexSurfaceExtension['configureConversation']>>[0], createOptions?: CreateCodexConversationOptions, mcpServers?: readonly CodexMcpServerDefinition[]): Promise<CodexThreadStartExtension>;
+    handleDynamicToolCall(request: DynamicToolRequest, responder: CodexServerRequestResponder<'item/tool/call'>): Promise<void>;
+}
+export {};
+//# sourceMappingURL=codex-surface-extensions-controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-extensions-controller.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-extensions-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAyB,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AACzG,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EACV,4BAA4B,EAE5B,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAEnC,KAAK,kBAAkB,GAAG,OAAO,CAAC,aAAa,EAAE;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAAC;AAE/E,qBAAa,gCAAgC;IAKzC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IANvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,wBAAwB,EAAE,CAAC;gBAG7C,UAAU,EAAE,SAAS,qBAAqB,EAAE,EAC7D,UAAU,EAAE,SAAS,wBAAwB,EAAE,EAC9B,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,4BAA4B,GAAG,SAAS;IAavG,eAAe,IAAI,OAAO;IAI1B,gBAAgB,IAAI,EAAE,CAAC,eAAe,EAAE;IAUlC,qBAAqB,CACzB,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,qBAAqB,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACnF,aAAa,GAAE,8BAAmC,EAClD,UAAU,GAAE,SAAS,wBAAwB,EAA2B,GACvE,OAAO,CAAC,yBAAyB,CAAC;IAiC/B,qBAAqB,CACzB,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,GACvD,OAAO,CAAC,IAAI,CAAC;CAqCjB"}

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

@@ -0,0 +1,37 @@
+import type { CodexAppServerClient } from '../codex/index';
+import type { CodexConversationSummary, CodexSurfaceSnapshot } from '@codex-app-sdk/core/surface';
+import { CodexSurfaceCatalogController } from './codex-surface-catalog-controller';
+import { CodexSurfaceExtensionsController } from './codex-surface-extensions-controller';
+import type { CodexConversationLoadOptions, ForkCodexConversationOptions } from './codex-surface-contracts';
+import type { ThreadRuntimePatch, ThreadRuntimeState } from './codex-surface-runtime';
+export type CodexSurfaceForkHost = {
+    createRuntime(threadId: string, patch?: ThreadRuntimePatch): ThreadRuntimeState;
+    emitConversationActivity(threadId: string): void;
+    emitConversationPermissions(threadId: string): void;
+    emitConversationSettings(threadId: string): void;
+    emitConversationSkills(threadId: string): void;
+    emitHistoryReplaced(threadId: string): void;
+    emitSummaryUpserted(summary: CodexConversationSummary): void;
+    getState(): CodexSurfaceSnapshot;
+    hydrateCompleteHistory(threadId: string): Promise<void>;
+    patch(patch: Partial<CodexSurfaceSnapshot>): void;
+    rememberHostOptions(threadId: string, options: CodexConversationLoadOptions): void;
+    requireRuntime(threadId: string): ThreadRuntimeState;
+    snapshotForRuntime(runtime: ThreadRuntimeState): CodexSurfaceSnapshot;
+};
+type CodexForkBoundary = {
+    beforeTurnId?: string;
+    lastTurnId?: string;
+};
+export declare class CodexSurfaceForkController {
+    private readonly client;
+    private readonly loadingStrategy;
+    private readonly catalog;
+    private readonly extensions;
+    private readonly host;
+    constructor(client: CodexAppServerClient, loadingStrategy: 'eager' | 'lazy' | undefined, catalog: CodexSurfaceCatalogController, extensions: CodexSurfaceExtensionsController, host: CodexSurfaceForkHost);
+    fork(sourceThreadId: string, options?: ForkCodexConversationOptions, hostOptions?: CodexConversationLoadOptions, boundary?: CodexForkBoundary): Promise<string>;
+    forkTurn(sourceThreadId: string, turnId: string, options?: ForkCodexConversationOptions, hostOptions?: CodexConversationLoadOptions): Promise<string>;
+}
+export {};
+//# sourceMappingURL=codex-surface-fork-controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-fork-controller.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-fork-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAM,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAiBzF,OAAO,KAAK,EACV,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAKtF,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;IAChF,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,mBAAmB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC7D,QAAQ,IAAI,oBAAoB,CAAC;IACjC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IAClD,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACnF,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAAC;IACrD,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;CACvE,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAJJ,MAAM,EAAE,oBAAoB,EAC5B,eAAe,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,EAC7C,OAAO,EAAE,6BAA6B,EACtC,UAAU,EAAE,gCAAgC,EAC5C,IAAI,EAAE,oBAAoB;IAGvC,IAAI,CACR,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,4BAAiC,EAC1C,WAAW,GAAE,4BAAiC,EAC9C,QAAQ,GAAE,iBAAsB,GAC/B,OAAO,CAAC,MAAM,CAAC;IA8HZ,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,4BAAiC,EAC1C,WAAW,GAAE,4BAAiC,GAC7C,OAAO,CAAC,MAAM,CAAC;CAOnB"}

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

@@ -0,0 +1,37 @@
+import type { v2 } from '../codex/index';
+import type { CodexConversationSummary, CodexSurfaceEventOrigin, CodexSurfaceSnapshot, SurfaceMessage, SurfaceMessageToolPartUpdate } from '@codex-app-sdk/core/surface';
+import type { SurfaceEventInput } from './codex-surface-events';
+import type { ThreadRuntimePatch, ThreadRuntimeState } from './codex-surface-runtime';
+export type CodexSurfaceItemsHost = {
+    assistantMessageForTurn(threadId: string, turnId: string): SurfaceMessage | null;
+    emitConversationActivity(threadId: string, origin: CodexSurfaceEventOrigin): void;
+    emitEvent(origin: CodexSurfaceEventOrigin, input: SurfaceEventInput): void;
+    emitSummaryUpserted(summary: CodexConversationSummary, reason: 'started' | 'listed' | 'resumed' | 'created' | 'updated', origin: CodexSurfaceEventOrigin): void;
+    getState(): CodexSurfaceSnapshot;
+    markRuntimeTurnActive(runtime: ThreadRuntimeState, turnId: string): void;
+    messageContainingTool(threadId: string, turnId: string, itemId: string): SurfaceMessage | null;
+    patch(patch: Partial<CodexSurfaceSnapshot>): void;
+    patchRuntime(threadId: string, patch: ThreadRuntimePatch): void;
+    requireRuntime(threadId: string): ThreadRuntimeState;
+    sendNextQueuedPrompt(threadId: string): void;
+};
+export declare class CodexSurfaceItemsController {
+    private readonly host;
+    private readonly commandOutputForwardItemIds;
+    private readonly fileActivityKeys;
+    private readonly reviewOutputByTurn;
+    constructor(host: CodexSurfaceItemsHost);
+    reset(): void;
+    forget(threadId: string): void;
+    isForwardingCommandOutput(threadId: string, itemId: string): boolean;
+    applyAgentDelta(params: v2.AgentMessageDeltaNotification): void;
+    applyPlanDelta(params: v2.PlanDeltaNotification): void;
+    applyPlanUpdated(params: v2.TurnPlanUpdatedNotification): void;
+    applyRawResponseItem(params: v2.RawResponseItemCompletedNotification): void;
+    applyItem(params: v2.ItemStartedNotification | v2.ItemCompletedNotification, completed: boolean): void;
+    shouldForwardCommandOutput(threadId: string, completed: boolean, item: v2.ThreadItem): boolean;
+    applyToolUpdate(threadId: string, turnId: string, update: SurfaceMessageToolPartUpdate): void;
+    private emitFileActivities;
+    applyTurnCompleted(params: v2.TurnCompletedNotification): void;
+}
+//# sourceMappingURL=codex-surface-items-controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-items-controller.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-items-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,cAAc,EAGd,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAQrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAyBhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAOtF,MAAM,MAAM,qBAAqB,GAAG;IAClC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACjF,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAClF,SAAS,CAAC,MAAM,EAAE,uBAAuB,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3E,mBAAmB,CACjB,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,EAChE,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAAC;IACR,QAAQ,IAAI,oBAAoB,CAAC;IACjC,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACzE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAC/F,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;IAClD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAChE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAAC;IACrD,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C,CAAC;AAEF,qBAAa,2BAA2B;IAQ1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAqB;IACjE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IAItD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;gBAEnC,IAAI,EAAE,qBAAqB;IAExD,KAAK,IAAI,IAAI;IAMb,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAa9B,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAIpE,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,6BAA6B,GAAG,IAAI;IA0B/D,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,qBAAqB,GAAG,IAAI;IAiBtD,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC,2BAA2B,GAAG,IAAI;IA8B9D,oBAAoB,CAAC,MAAM,EAAE,EAAE,CAAC,oCAAoC,GAAG,IAAI;IAmC3E,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,GAAG,EAAE,CAAC,yBAAyB,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAyTtG,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,OAAO;IAgB9F,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B,GAAG,IAAI;IAsB7F,OAAO,CAAC,kBAAkB;IA2B1B,kBAAkB,CAAC,MAAM,EAAE,EAAE,CAAC,yBAAyB,GAAG,IAAI;CA8C/D"}

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

@@ -0,0 +1,58 @@
+import type { CodexAppServerClient } from '../codex/index';
+import type { CodexConversationHistory, CodexConversationSummary, CodexSurfaceEvent, CodexSurfaceEventOrigin, CodexSurfaceSnapshot, CreateCodexConversationOptions } from '@codex-app-sdk/core/surface';
+import type { CodexConversationHostOptions, CodexConversationLoadOptions, CodexSurfaceOptions } from './codex-surface-contracts';
+import { CodexSurfaceCatalogController } from './codex-surface-catalog-controller';
+import { CodexSurfaceConversationSettingsController } from './codex-surface-conversation-settings-controller';
+import { CodexSurfaceConversationsController } from './codex-surface-conversations-controller';
+import { CodexSurfaceExtensionsController } from './codex-surface-extensions-controller';
+import type { ThreadRuntimePatch, ThreadRuntimeState } from './codex-surface-runtime';
+type HistoryReason = Extract<CodexSurfaceEvent, {
+    type: 'conversation.historyReplaced';
+}>['payload']['reason'];
+export interface CodexSurfaceLifecycleHost {
+    activateRuntime(runtime: ThreadRuntimeState): void;
+    createRuntime(threadId: string, patch?: ThreadRuntimePatch): ThreadRuntimeState;
+    emitConversationActivity(threadId: string, origin: CodexSurfaceEventOrigin): void;
+    emitConversationPermissions(threadId: string, origin: CodexSurfaceEventOrigin): void;
+    emitConversationSettings(threadId: string, origin: CodexSurfaceEventOrigin): void;
+    emitConversationSkills(threadId: string, origin: CodexSurfaceEventOrigin): void;
+    emitHistoryReplaced(threadId: string, reason: HistoryReason, origin: CodexSurfaceEventOrigin): void;
+    emitSelected(conversationId: string): void;
+    emitSummaryUpserted(summary: CodexConversationSummary, reason: 'created' | 'resumed' | 'updated', origin: CodexSurfaceEventOrigin): void;
+    ensureConnected(): Promise<void>;
+    getSnapshot(): CodexSurfaceSnapshot;
+    getState(): CodexSurfaceSnapshot;
+    patch(patch: Partial<CodexSurfaceSnapshot>): void;
+    patchRuntime(threadId: string, patch: ThreadRuntimePatch): void;
+    requireRuntime(threadId: string): ThreadRuntimeState;
+    runtime(threadId: string): ThreadRuntimeState | undefined;
+    runtimeProjection(runtime: ThreadRuntimeState): Partial<CodexSurfaceSnapshot>;
+    snapshotForRuntime(runtime: ThreadRuntimeState): CodexSurfaceSnapshot;
+}
+export declare class CodexSurfaceLifecycleController {
+    private readonly client;
+    private readonly options;
+    private readonly catalog;
+    private readonly extensions;
+    private readonly settings;
+    private readonly conversations;
+    private readonly host;
+    private readonly hydrationPromises;
+    private readonly hostOptionsByThread;
+    constructor(client: CodexAppServerClient, options: Pick<CodexSurfaceOptions, 'conversationDefaults' | 'cwd' | 'loadingStrategy'>, catalog: CodexSurfaceCatalogController, extensions: CodexSurfaceExtensionsController, settings: CodexSurfaceConversationSettingsController, conversations: CodexSurfaceConversationsController, host: CodexSurfaceLifecycleHost);
+    hostOptions(threadId: string): CodexConversationLoadOptions | undefined;
+    rememberHostOptions(threadId: string, options: CodexConversationLoadOptions): void;
+    forget(threadId: string): void;
+    clear(): void;
+    resetHydrations(): void;
+    create(options?: CreateCodexConversationOptions, hostOptions?: CodexConversationHostOptions): Promise<CodexSurfaceSnapshot>;
+    select(conversationId: string): Promise<CodexSurfaceSnapshot>;
+    resumeDuringBootstrap(conversationId: string): Promise<CodexSurfaceSnapshot>;
+    ensureReady(threadId: string, loadOptions?: CodexConversationLoadOptions): Promise<ThreadRuntimeState>;
+    readHistory(conversationId: string): Promise<CodexConversationHistory>;
+    private resume;
+    private emitConversationState;
+    private historySnapshot;
+}
+export {};
+//# sourceMappingURL=codex-surface-lifecycle-controller.d.ts.map

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

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