@codex-app-sdk/backend 0.13.0

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

@@ -0,0 +1,28 @@
+import type { CodexSurfaceJsonValue } from '@codex-app-sdk/core/surface';
+export type CodexMcpServerToolApprovalMode = 'auto' | 'prompt' | 'writes' | 'approve';
+export type CodexMcpServerTransport = {
+    type: 'stdio';
+    command: string;
+    args?: readonly string[];
+    cwd?: string;
+    env?: Readonly<Record<string, string>>;
+    /** Environment variable names inherited by the app-server-launched process. */
+    envVars?: readonly string[];
+} | {
+    type: 'http';
+    url: string;
+};
+/** Trusted main-process configuration for an app-owned MCP server. */
+export type CodexMcpServerDefinition = {
+    name: string;
+    transport: CodexMcpServerTransport;
+    toolApprovalMode?: CodexMcpServerToolApprovalMode;
+    required?: boolean;
+    enabledTools?: readonly string[];
+    startupTimeoutMs?: number;
+    toolTimeoutMs?: number;
+};
+export declare function normalizeMcpServers(definitions: readonly CodexMcpServerDefinition[]): readonly CodexMcpServerDefinition[];
+export declare function mcpServerConfig(definitions: readonly CodexMcpServerDefinition[]): Record<string, CodexSurfaceJsonValue>;
+export declare function assertNoMcpConfigCollision(config: Readonly<Record<string, CodexSurfaceJsonValue>>, definitions: readonly CodexMcpServerDefinition[]): void;
+//# sourceMappingURL=codex-surface-mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-mcp.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-mcp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,MAAM,MAAM,8BAA8B,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,MAAM,MAAM,uBAAuB,GAC/B;IACA,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,GACC;IACA,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEJ,sEAAsE;AACtE,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,uBAAuB,CAAC;IACnC,gBAAgB,CAAC,EAAE,8BAA8B,CAAC;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,SAAS,wBAAwB,EAAE,GAC/C,SAAS,wBAAwB,EAAE,CAgDrC;AAqFD,wBAAgB,eAAe,CAC7B,WAAW,EAAE,SAAS,wBAAwB,EAAE,GAC/C,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAsBvC;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,EACvD,WAAW,EAAE,SAAS,wBAAwB,EAAE,GAC/C,IAAI,CAaN"}

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

@@ -0,0 +1,30 @@
+import type { v2 } from '../codex/index';
+import type { SurfaceMessage, SurfaceMessageMediaPart, SurfaceMessageQuestionPart, SurfaceMessageTextPart, SurfaceMessageToolPart, SurfaceMessageToolPartUpdate } from '@codex-app-sdk/core/surface';
+export declare function activeTurnId(turns: v2.Turn[]): string | null;
+export declare function ensureAssistantTurnMessage(messages: readonly SurfaceMessage[], threadId: string, turnId: string, options?: {
+    createdAt?: string;
+    forceSegment?: boolean;
+}): SurfaceMessage[];
+export declare function appendAssistantTextDelta(messages: readonly SurfaceMessage[], threadId: string, turnId: string, itemId: string, delta: string, phase?: SurfaceMessageTextPart['phase']): SurfaceMessage[];
+export declare function upsertAssistantReasoningSummaries(messages: readonly SurfaceMessage[], threadId: string, turnId: string, itemId: string, summaries: readonly string[]): SurfaceMessage[];
+export declare function upsertAssistantText(messages: readonly SurfaceMessage[], threadId: string, turnId: string, itemId: string, text: string, phase?: SurfaceMessageTextPart['phase']): SurfaceMessage[];
+export declare function removeAssistantText(messages: readonly SurfaceMessage[], threadId: string, turnId: string, itemId: string): SurfaceMessage[];
+export declare function extractProposedPlanDocument(text: string): {
+    markdown: string;
+    visibleText: string;
+} | null;
+export declare function upsertAssistantToolPart(messages: readonly SurfaceMessage[], threadId: string, turnId: string, toolPart: SurfaceMessageToolPart): SurfaceMessage[];
+export declare function upsertAssistantMediaPart(messages: readonly SurfaceMessage[], threadId: string, turnId: string, mediaPart: SurfaceMessageMediaPart): SurfaceMessage[];
+export declare function upsertAssistantQuestionPart(messages: readonly SurfaceMessage[], threadId: string, turnId: string, questionPart: SurfaceMessageQuestionPart): SurfaceMessage[];
+export declare function surfaceMediaPartsEqual(left: SurfaceMessageMediaPart, right: SurfaceMessageMediaPart): boolean;
+export declare function updateAssistantToolPart(messages: readonly SurfaceMessage[], threadId: string, turnId: string, update: SurfaceMessageToolPartUpdate): SurfaceMessage[];
+export declare function appendCompactionMarker(messages: readonly SurfaceMessage[], threadId: string, turnId: string, status?: 'streaming' | 'complete'): SurfaceMessage[];
+export declare function finalizeTurnToolParts(messages: SurfaceMessage[], turnId: string, turnStatus: v2.TurnStatus): SurfaceMessage[];
+export declare function pruneEmptyAssistantPlaceholders(messages: SurfaceMessage[], threadId: string): SurfaceMessage[];
+export declare function addUnique<T>(values: readonly T[], value: T): T[];
+export declare function formatPlanMarkdown(explanation: string | null, plan: readonly {
+    step: string;
+    status: string;
+}[]): string;
+export declare function planProgressToolPart(turnId: string, markdown: string, status: SurfaceMessageToolPart['status']): SurfaceMessageToolPart;
+//# sourceMappingURL=codex-surface-message-state.d.ts.map

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

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

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

@@ -0,0 +1,49 @@
+import type { CodexAppServerClient } from '../codex/index';
+import type { CodexConversationSummary, CodexSurfaceEventOrigin, CodexSurfaceSnapshot, SendCodexMessageOptions, StartCodexReviewOptions, UpdateCodexConversationSettings } from '@codex-app-sdk/core/surface';
+import type { SurfaceEventInput } from './codex-surface-events';
+import type { ThreadRuntimePatch, ThreadRuntimeState } from './codex-surface-runtime';
+export type CodexSurfaceMessagesHost = {
+    clearGoalForThread(threadId: string): Promise<void>;
+    compactForThread(threadId: string): Promise<void>;
+    createConversation(): Promise<void>;
+    emitConversationActivity(threadId: string, origin: 'action'): void;
+    emitEvent(origin: CodexSurfaceEventOrigin, input: SurfaceEventInput): void;
+    ensureConnected(): Promise<void>;
+    ensureThreadReady(threadId: string): Promise<ThreadRuntimeState>;
+    getSnapshot(): CodexSurfaceSnapshot;
+    getState(): CodexSurfaceSnapshot;
+    patchConversationStatus(threadId: string, status: CodexConversationSummary['status'], origin: 'action'): void;
+    patchConversationTurnCount(threadId: string, turnCount: number, origin: 'action'): void;
+    patchRuntime(threadId: string, patch: ThreadRuntimePatch): void;
+    requireRuntime(threadId: string): ThreadRuntimeState;
+    setGoal(objective: string): Promise<CodexSurfaceSnapshot>;
+    setGoalForThread(threadId: string, objective: string): Promise<void>;
+    snapshotForRuntime(runtime: ThreadRuntimeState): CodexSurfaceSnapshot;
+    startReview(options: StartCodexReviewOptions): Promise<CodexSurfaceSnapshot>;
+    startReviewForThread(threadId: string, options: StartCodexReviewOptions): Promise<void>;
+    updateSettings(settings: UpdateCodexConversationSettings): Promise<CodexSurfaceSnapshot>;
+    updateSettingsForThread(threadId: string, settings: UpdateCodexConversationSettings): Promise<void>;
+};
+export declare class CodexSurfaceMessagesController {
+    private readonly client;
+    private readonly host;
+    constructor(client: CodexAppServerClient, host: CodexSurfaceMessagesHost);
+    send(prompt: string, options?: SendCodexMessageOptions): Promise<CodexSurfaceSnapshot>;
+    sendToThread(threadId: string, prompt: string, options?: SendCodexMessageOptions): Promise<void>;
+    continueInterruptedTurn(): Promise<CodexSurfaceSnapshot>;
+    continueInterruptedTurnForThread(threadId: string): Promise<void>;
+    sendPromptToThread(threadId: string, text: string, options?: SendCodexMessageOptions, displayText?: string): Promise<void>;
+    steer(prompt: string, options?: SendCodexMessageOptions): Promise<CodexSurfaceSnapshot>;
+    steerForThread(threadId: string, prompt: string, options?: SendCodexMessageOptions, displayText?: string): Promise<void>;
+    answerAsyncQuestion(threadId: string, prompt: string, displayText: string): Promise<void>;
+    deleteQueuedPrompt(promptId: string): Promise<CodexSurfaceSnapshot>;
+    deleteQueuedPromptForThread(threadId: string, promptId: string): Promise<void>;
+    updateQueuedPrompt(promptId: string, prompt: string): Promise<CodexSurfaceSnapshot>;
+    updateQueuedPromptForThread(threadId: string, promptId: string, prompt: string): Promise<void>;
+    steerQueuedPrompt(promptId: string, prompt?: string): Promise<CodexSurfaceSnapshot>;
+    steerQueuedPromptForThread(threadId: string, promptId: string, replacement?: string): Promise<void>;
+    sendNextQueuedPrompt(threadId: string): Promise<void>;
+    private emitQueuedPrompts;
+    private requiredActiveConversation;
+}
+//# sourceMappingURL=codex-surface-messages-controller.d.ts.map

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

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

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

@@ -0,0 +1,47 @@
+import type { ServerNotification } from '../codex/index';
+import type { CodexConversationSummary, CodexSurfaceEvent, 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 { CodexSurfaceItemsController } from './codex-surface-items-controller';
+import type { ThreadRuntimePatch, ThreadRuntimeState } from './codex-surface-runtime';
+type SurfaceEventInput = CodexSurfaceEvent extends infer Event ? Event extends CodexSurfaceEvent ? Omit<Event, 'seq' | 'occurredAt' | 'origin'> : never : never;
+export interface CodexSurfaceNotificationsHost {
+    clearPendingForThread(threadId: string, reason: string, eventReason: 'conversation_closed' | 'conversation_removed' | 'surface_disconnected'): 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;
+    emitEvent(origin: CodexSurfaceEventOrigin, input: SurfaceEventInput): void;
+    emitSummaryUpserted(summary: CodexConversationSummary, reason: Extract<CodexSurfaceEvent, {
+        type: 'conversation.summaryUpserted';
+    }>['payload']['reason'], origin: CodexSurfaceEventOrigin): void;
+    getState(): CodexSurfaceSnapshot;
+    markRuntimeTurnActive(runtime: ThreadRuntimeState, turnId: string): void;
+    patch(patch: Partial<CodexSurfaceSnapshot>): void;
+    patchConversationStatus(threadId: string, status: CodexConversationSummary['status'], origin?: CodexSurfaceEventOrigin): void;
+    patchConversationTurnCount(threadId: string, turnCount: number): void;
+    patchRuntime(threadId: string, patch: ThreadRuntimePatch): void;
+    removeThread(threadId: string, reason: 'archived' | 'deleted'): void;
+    requireRuntime(threadId: string): ThreadRuntimeState;
+    runtime(threadId: string): ThreadRuntimeState | undefined;
+    runtimes(): Iterable<ThreadRuntimeState>;
+    snapshotForRuntime(runtime: ThreadRuntimeState): CodexSurfaceSnapshot;
+    unknownNotification(notification: ServerNotification): void;
+}
+export declare class CodexSurfaceNotificationsController {
+    private readonly authentication;
+    private readonly approvals;
+    private readonly catalog;
+    private readonly clientRequests;
+    private readonly conversations;
+    private readonly items;
+    private readonly host;
+    constructor(authentication: CodexSurfaceAuthenticationController, approvals: CodexSurfaceApprovalsController, catalog: CodexSurfaceCatalogController, clientRequests: CodexSurfaceClientRequestsController, conversations: CodexSurfaceConversationsController, items: CodexSurfaceItemsController, host: CodexSurfaceNotificationsHost);
+    handle(notification: ServerNotification): void;
+}
+export {};
+//# sourceMappingURL=codex-surface-notifications-controller.d.ts.map

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

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

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

@@ -0,0 +1,7 @@
+import type { CodexAppServerClient, v2 } from '../codex/index';
+import type { CodexConversationPromptHistory } from '@codex-app-sdk/core/surface';
+export declare const CODEX_PROMPT_HISTORY_TURN_LIMIT = 100;
+export declare function readPromptHistory(client: CodexAppServerClient, conversationId: string): Promise<CodexConversationPromptHistory>;
+/** Extracts only visible user-authored text without retaining the turn payload. */
+export declare function promptsFromSummaryTurns(turns: readonly v2.Turn[]): string[];
+//# sourceMappingURL=codex-surface-prompt-history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-prompt-history.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-prompt-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAGlF,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAMnD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,8BAA8B,CAAC,CAazC;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,EAAE,CAS3E"}

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

@@ -0,0 +1,32 @@
+import type { v2 } from '../codex/index';
+import type { CodexSurfaceReviewTarget, CodexSurfaceSkill, CodexSurfaceSkillInput, SurfaceMessage, SurfaceMessageToolPart } from '@codex-app-sdk/core/surface';
+export type GoalSlashCommand = {
+    action: 'clear';
+} | {
+    action: 'edit';
+} | {
+    action: 'set';
+    objective: string;
+} | {
+    action: 'show';
+} | {
+    action: 'unsupported';
+};
+export declare function mcpElicitationResponse(decision: 'allow' | 'allow_conversation' | 'always_allow' | 'deny'): v2.McpServerElicitationRequestResponse;
+export declare function parsePlanSlashCommand(prompt: string): {
+    prompt: string | null;
+} | null;
+export declare function parseGoalSlashCommand(prompt: string): GoalSlashCommand | null;
+export declare function parseReviewSlashCommand(prompt: string): CodexSurfaceReviewTarget | null;
+export declare function normalizeReviewTarget(target: CodexSurfaceReviewTarget): v2.ReviewTarget;
+export declare function promptSkillInputsFromText(text: string, skills: readonly CodexSurfaceSkill[]): CodexSurfaceSkillInput[];
+export declare function validateSkillInputs(inputs: readonly CodexSurfaceSkillInput[], catalog: readonly CodexSurfaceSkill[]): CodexSurfaceSkillInput[];
+export declare function mergeSkillInputs(...groups: readonly (readonly CodexSurfaceSkillInput[])[]): CodexSurfaceSkillInput[];
+export declare function findPendingMcpToolPart(messages: readonly SurfaceMessage[], turnId: string, server: string, tool: string): SurfaceMessageToolPart | null;
+export declare function argumentsPreview(meta: Record<string, unknown>): string;
+export declare function persistSupports(value: unknown, mode: 'always' | 'session'): boolean;
+export declare function stringValue(value: unknown): string | null;
+export declare function normalizedConversationId(value: string): string;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=codex-surface-prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-prompts.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAE9B,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,GAAG,oBAAoB,GAAG,cAAc,GAAG,MAAM,GACjE,EAAE,CAAC,mCAAmC,CAWxC;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAKtF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAS7E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI,CAKvF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,EAAE,CAAC,YAAY,CAGvF;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,iBAAiB,EAAE,GACnC,sBAAsB,EAAE,CAU1B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,sBAAsB,EAAE,EACzC,OAAO,EAAE,SAAS,iBAAiB,EAAE,GACpC,sBAAsB,EAAE,CAY1B;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,MAAM,EAAE,SAAS,CAAC,SAAS,sBAAsB,EAAE,CAAC,EAAE,GACxD,sBAAsB,EAAE,CAQ1B;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,sBAAsB,GAAG,IAAI,CAgB/B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAWtE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAEnF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEzD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD"}

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

@@ -0,0 +1,12 @@
+import type { CodexAppServerClient } from '../codex/index';
+import type { CodexConversationEvent, StartCodexRealtimeOptions } from '@codex-app-sdk/core/surface';
+import type { CodexRealtimeSession } from './codex-surface-contracts';
+export type StartCodexRealtimeSessionContext = {
+    client: CodexAppServerClient;
+    ensureThreadReady(): Promise<void>;
+    onConversationEvent(listener: (event: CodexConversationEvent) => void): () => void;
+    options: StartCodexRealtimeOptions;
+    threadId: string;
+};
+export declare function startCodexRealtimeSession(context: StartCodexRealtimeSessionContext): Promise<CodexRealtimeSession>;
+//# sourceMappingURL=codex-surface-realtime-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-realtime-session.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-realtime-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAiB,MAAM,gBAAgB,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAsB,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACzH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAOtE,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,oBAAoB,CAAC;IAC7B,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnF,OAAO,EAAE,yBAAyB,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAwF/B"}

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

@@ -0,0 +1,13 @@
+import type { v2 } from '../codex/index';
+import type { CodexRealtimeInputAudioChunk } from '@codex-app-sdk/core/surface';
+export declare function normalizedOptionalRealtimeString(value: string | undefined, field: string): string | undefined;
+export declare function normalizedRealtimeText(value: string, field: string): string;
+export declare function realtimeAudioChunkParams(audio: CodexRealtimeInputAudioChunk): v2.ThreadRealtimeAudioChunk;
+export declare function realtimeAudioChunk(audio: v2.ThreadRealtimeAudioChunk): {
+    data: Uint8Array;
+    sampleRate: number;
+    numChannels: number;
+    samplesPerChannel: number | null;
+    itemId: string | null;
+};
+//# sourceMappingURL=codex-surface-realtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-realtime.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-realtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAEhF,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK3E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,4BAA4B,GAAG,EAAE,CAAC,wBAAwB,CAoBzG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,GAAG;IACtE,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAQA"}

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

@@ -0,0 +1,49 @@
+import type { CodexConversationSummary, CodexSurfaceEvent, CodexSurfaceEventOrigin, CodexSurfaceSnapshot, SurfaceMessage } from '@codex-app-sdk/core/surface';
+import { CodexSurfaceApprovalsController } from './codex-surface-approvals-controller';
+import { CodexSurfaceClientRequestsController } from './codex-surface-client-requests-controller';
+import { runtimeProjection, type ThreadRuntimePatch, type ThreadRuntimeState } from './codex-surface-runtime';
+type SurfaceEventInput = CodexSurfaceEvent extends infer Event ? Event extends CodexSurfaceEvent ? Omit<Event, 'seq' | 'occurredAt' | 'origin'> : never : never;
+export interface CodexSurfaceRuntimeHost {
+    emitEvent(origin: CodexSurfaceEventOrigin, input: SurfaceEventInput): void;
+    getState(): CodexSurfaceSnapshot;
+    notifyConversationListeners(threadId: string): void;
+    patch(patch: Partial<CodexSurfaceSnapshot>, conversationId?: string): void;
+    schedulePluginRefresh(): void;
+}
+export declare class CodexSurfaceRuntimeController {
+    private readonly approvals;
+    private readonly clientRequests;
+    private readonly host;
+    private readonly runtimes;
+    private readonly semanticEventValues;
+    constructor(approvals: CodexSurfaceApprovalsController, clientRequests: CodexSurfaceClientRequestsController, host: CodexSurfaceRuntimeHost);
+    get(threadId: string): ThreadRuntimeState | undefined;
+    values(): IterableIterator<ThreadRuntimeState>;
+    clear(): void;
+    forget(threadId: string): void;
+    create(threadId: string, patch?: ThreadRuntimePatch): ThreadRuntimeState;
+    require(threadId: string): ThreadRuntimeState;
+    projection(runtime: ThreadRuntimeState): ReturnType<typeof runtimeProjection>;
+    snapshot(runtime: ThreadRuntimeState): CodexSurfaceSnapshot;
+    activate(runtime: ThreadRuntimeState): void;
+    patch(threadId: string, patch: ThreadRuntimePatch): void;
+    emitSurfaceStatus(origin: CodexSurfaceEventOrigin): void;
+    emitSummaryUpserted(summary: CodexConversationSummary, reason: Extract<CodexSurfaceEvent, {
+        type: 'conversation.summaryUpserted';
+    }>['payload']['reason'], origin: CodexSurfaceEventOrigin): void;
+    emitConversationActivity(threadId: string, origin: CodexSurfaceEventOrigin): void;
+    emitConversationSettings(threadId: string, origin: CodexSurfaceEventOrigin): void;
+    emitConversationSkills(threadId: string, origin: CodexSurfaceEventOrigin): void;
+    emitConversationPermissions(threadId: string, origin: CodexSurfaceEventOrigin): void;
+    emitHistoryReplaced(threadId: string, reason: Extract<CodexSurfaceEvent, {
+        type: 'conversation.historyReplaced';
+    }>['payload']['reason'], origin: CodexSurfaceEventOrigin): void;
+    emitHistoryPrepended(threadId: string, messages: readonly SurfaceMessage[], origin: CodexSurfaceEventOrigin): void;
+    messageContainingTool(threadId: string, turnId: string, itemId: string): SurfaceMessage | null;
+    assistantMessageForTurn(threadId: string, turnId: string): SurfaceMessage | null;
+    markTurnActive(runtime: ThreadRuntimeState, turnId: string): void;
+    patchConversationStatus(threadId: string, status: CodexConversationSummary['status'], origin?: CodexSurfaceEventOrigin): void;
+    patchConversationTurnCount(threadId: string, turnCount: number, origin?: CodexSurfaceEventOrigin): void;
+}
+export {};
+//# sourceMappingURL=codex-surface-runtime-controller.d.ts.map

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

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

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

@@ -0,0 +1,44 @@
+import type { CodexSurfaceApproval, CodexSurfaceAuthentication, CodexSurfaceClientRequest, CodexSurfaceSnapshot, CodexConversationLoadingStrategy, CodexSurfaceSkill, CodexSurfaceThreadStatus, CodexSurfaceTurn, SurfaceMessage } from '@codex-app-sdk/core/surface';
+import type { ThreadHistoryMode } from '../codex/generated/v2/ThreadHistoryMode';
+export type ThreadRuntimeState = {
+    threadId: string;
+    cwd: string | null;
+    hydrated: boolean;
+    activeTurnId: string | null;
+    turns: CodexSurfaceTurn[];
+    turnIds: string[];
+    messages: SurfaceMessage[];
+    answeredClientRequestIds: string[];
+    approvalPreset: CodexSurfaceSnapshot['approvalPreset'];
+    approvalPresets: CodexSurfaceSnapshot['approvalPresets'];
+    permissionProfiles: CodexSurfaceSnapshot['permissionProfiles'];
+    skills: CodexSurfaceSkill[];
+    skillCatalogStatus: CodexSurfaceSnapshot['skillCatalogStatus'];
+    selectedModelId: string | null;
+    selectedReasoningEffort: string | null;
+    selectedServiceTier: string | null;
+    planMode: boolean;
+    executionPlan: CodexSurfaceSnapshot['executionPlan'];
+    contextUsage: CodexSurfaceSnapshot['contextUsage'];
+    goal: CodexSurfaceSnapshot['goal'];
+    turnGitDiff: CodexSurfaceSnapshot['turnGitDiff'];
+    threadStatus: CodexSurfaceThreadStatus | null;
+    queuedPrompts: CodexSurfaceSnapshot['queuedPrompts'];
+    busy: boolean;
+    turnStartPending: boolean;
+    historyLoading: boolean;
+    historyMode: ThreadHistoryMode;
+    loadingStrategy: CodexConversationLoadingStrategy;
+    historyCursor: string | null;
+    historyHasOlder: boolean;
+    historyLoadingOlder: boolean;
+    fullHistoryHydrated: boolean;
+    error: string | null;
+    planMarkdownByTurn: Map<string, string>;
+};
+export type ThreadRuntimePatch = Partial<Omit<ThreadRuntimeState, 'threadId' | 'planMarkdownByTurn'>>;
+export type ConversationCatalogs = Pick<ThreadRuntimeState, 'approvalPresets' | 'permissionProfiles' | 'skillCatalogStatus' | 'skills'>;
+export declare function initialSurfaceSnapshot(authentication: CodexSurfaceAuthentication): CodexSurfaceSnapshot;
+export declare function createThreadRuntime(threadId: string, state: CodexSurfaceSnapshot, patch?: ThreadRuntimePatch): ThreadRuntimeState;
+export declare function runtimeProjection(runtime: ThreadRuntimeState, approvals: CodexSurfaceApproval[], clientRequests: CodexSurfaceClientRequest[]): Pick<CodexSurfaceSnapshot, 'approvalPreset' | 'approvalPresets' | 'answeredClientRequestIds' | 'approvals' | 'activeTurnId' | 'busy' | 'clientRequests' | 'contextUsage' | 'error' | 'executionPlan' | 'goal' | 'historyLoading' | 'historyState' | 'messages' | 'permissionProfiles' | 'planMode' | 'queuedPrompts' | 'selectedModelId' | 'selectedReasoningEffort' | 'selectedServiceTier' | 'skillCatalogStatus' | 'skills' | 'threadStatus' | 'turnGitDiff' | 'turns'>;
+//# sourceMappingURL=codex-surface-runtime.d.ts.map

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

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

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

@@ -0,0 +1,27 @@
+import type { v2 } from '../codex/index';
+import type { CodexSurfaceApprovalPreset, CodexSurfaceModel, CodexSurfaceSnapshot, SendCodexMessageOptions, UpdateCodexConversationSettings } from '@codex-app-sdk/core/surface';
+export type SurfaceSelection = Pick<CodexSurfaceSnapshot, 'approvalPreset' | 'planMode' | 'selectedModelId' | 'selectedReasoningEffort' | 'selectedServiceTier'>;
+export declare function selectedModel(models: CodexSurfaceModel[], idOrModel: string | null): CodexSurfaceModel | null;
+export declare function requireCatalogModel(models: CodexSurfaceModel[], idOrModel: string): CodexSurfaceModel;
+export declare function validateReasoningEffort(model: CodexSurfaceModel | null, reasoningEffort: string | undefined): void;
+export declare function defaultReasoningEffort(model: CodexSurfaceModel): string | null;
+export declare function defaultServiceTier(model: CodexSurfaceModel): string | null;
+export declare function validateServiceTier(model: CodexSurfaceModel | null, serviceTier: string | null | undefined): void;
+export declare function approvalPresetsForProfiles(profiles: CodexSurfaceSnapshot['permissionProfiles'], requirements: v2.ConfigRequirements | null): CodexSurfaceApprovalPreset[];
+export declare function approvalPresetStartParams(preset: CodexSurfaceApprovalPreset): {
+    approvalPolicy: v2.AskForApproval;
+    approvalsReviewer: v2.ApprovalsReviewer;
+    permissions: string;
+};
+export declare function approvalPresetUpdateParams(preset: CodexSurfaceApprovalPreset): {
+    approvalPolicy: v2.AskForApproval;
+    approvalsReviewer: v2.ApprovalsReviewer;
+    permissions: string;
+};
+export declare function approvalPresetFromSettings(approvalPolicy: v2.AskForApproval, approvalsReviewer: v2.ApprovalsReviewer, sandbox: v2.SandboxPolicy, activePermissionProfile: v2.ActivePermissionProfile | null): CodexSurfaceApprovalPreset | null;
+export declare function sessionSelection(response: v2.ThreadForkResponse | v2.ThreadResumeResponse | v2.ThreadStartResponse, models: CodexSurfaceModel[], current: CodexSurfaceSnapshot): SurfaceSelection;
+export declare function threadSettingsSelection(settings: v2.ThreadSettings, models: CodexSurfaceModel[], current: CodexSurfaceSnapshot): SurfaceSelection;
+export declare function nextSelection(current: CodexSurfaceSnapshot, settings: UpdateCodexConversationSettings): SurfaceSelection;
+export declare function collaborationMode(planMode: boolean, model: string, reasoningEffort: string | null): NonNullable<v2.TurnStartParams['collaborationMode']>;
+export declare function turnSettings(state: CodexSurfaceSnapshot, options: SendCodexMessageOptions): Pick<v2.TurnStartParams, 'collaborationMode' | 'effort' | 'model' | 'serviceTier'>;
+//# sourceMappingURL=codex-surface-settings.d.ts.map

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

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

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

@@ -0,0 +1,6 @@
+import type { v2 } from '../codex/index';
+import type { CodexSurfaceSubagentToolCall } from '@codex-app-sdk/core/surface';
+export declare function surfaceSubagentToolCall(item: Extract<v2.ThreadItem, {
+    type: 'collabAgentToolCall';
+}>): CodexSurfaceSubagentToolCall;
+//# sourceMappingURL=codex-surface-subagents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-subagents.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-subagents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EAEV,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAErC,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,qBAAqB,CAAA;CAAE,CAAC,GAC5D,4BAA4B,CAgB9B"}

package/dist/node/codex-surface-text-generation-controller.d.ts

@@ -0,0 +1,22 @@
+import type { CodexAppServerClient, ServerNotification } from '../codex/index';
+import type { CodexSurfaceSnapshot } from '@codex-app-sdk/core/surface';
+import type { CodexGeneratedText, GenerateCodexTextOptions } from './codex-surface-contracts';
+export type CodexSurfaceTextGenerationHost = {
+    ensureConnected(): Promise<void>;
+    getSnapshot(): CodexSurfaceSnapshot;
+};
+/** Runs isolated, non-persisted text turns without projecting them into surface state. */
+export declare class CodexSurfaceTextGenerationController {
+    private readonly client;
+    private readonly defaultCwd;
+    private readonly host;
+    private readonly hiddenThreadIds;
+    private readonly pendingByThread;
+    constructor(client: CodexAppServerClient, defaultCwd: string | undefined, host: CodexSurfaceTextGenerationHost);
+    /** Returns true when a notification belongs to an ephemeral thread and must stay hidden. */
+    handleNotification(notification: ServerNotification): boolean;
+    generate(prompt: string, options?: GenerateCodexTextOptions): Promise<CodexGeneratedText>;
+    close(error?: Error): void;
+    private consumeNotification;
+}
+//# sourceMappingURL=codex-surface-text-generation-controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-text-generation-controller.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-text-generation-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAM,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAmBnC,MAAM,MAAM,8BAA8B,GAAG;IAC3C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,WAAW,IAAI,oBAAoB,CAAC;CACrC,CAAC;AAEF,0FAA0F;AAC1F,qBAAa,oCAAoC;IAK7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwC;gBAGrD,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,IAAI,EAAE,8BAA8B;IAGvD,4FAA4F;IAC5F,kBAAkB,CAAC,YAAY,EAAE,kBAAkB,GAAG,OAAO;IAevD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+FnG,KAAK,CAAC,KAAK,QAAoC,GAAG,IAAI;IAMtD,OAAO,CAAC,mBAAmB;CAoB5B"}

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

@@ -0,0 +1,6 @@
+import type { CodexAppServerTransportOptions, CodexSurfaceOptions } from './codex-surface-contracts';
+import type { CodexAppServerUnixSocketTransportOptions } from './codex-unix-socket-transport';
+export declare function isUnixSocketTransportOptions(options: CodexAppServerTransportOptions): options is CodexAppServerUnixSocketTransportOptions;
+export declare function surfaceTransportOptions(options: CodexSurfaceOptions): CodexAppServerTransportOptions;
+export declare function absoluteCodexHome(value: string): string;
+//# sourceMappingURL=codex-surface-transport-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-surface-transport-options.d.ts","sourceRoot":"","sources":["../../src/node/codex-surface-transport-options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrG,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,+BAA+B,CAAC;AAE9F,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,8BAA8B,GACtC,OAAO,IAAI,wCAAwC,CAErD;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,8BAA8B,CAapG;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD"}

package/dist/node/codex-surface-turn-actions-controller.d.ts

@@ -0,0 +1,44 @@
+import type { CodexAppServerClient } from '../codex/index';
+import type { CodexConversationSummary, CodexSurfaceSnapshot, SendCodexMessageOptions, StartCodexReviewOptions } from '@codex-app-sdk/core/surface';
+import type { SurfaceEventInput } from './codex-surface-events';
+import type { ThreadRuntimePatch, ThreadRuntimeState } from './codex-surface-runtime';
+export type CodexSurfaceTurnActionsHost = {
+    createConversation(): Promise<void>;
+    emitConversationActivity(threadId: string, origin: 'action'): void;
+    emitEvent(origin: 'action', input: SurfaceEventInput): void;
+    emitHistoryReplaced(threadId: string, reason: 'rollback', origin: 'action'): void;
+    emitSummaryUpserted(summary: CodexConversationSummary, reason: 'updated', origin: 'action'): void;
+    ensureThreadReady(threadId: string): Promise<ThreadRuntimeState>;
+    getSnapshot(): CodexSurfaceSnapshot;
+    getState(): CodexSurfaceSnapshot;
+    hydrateCompleteHistory(threadId: string, options?: {
+        initialPageLoaded?: boolean;
+        cursor?: string | null;
+    }): Promise<void>;
+    patch(patch: Partial<CodexSurfaceSnapshot>): void;
+    patchConversationStatus(threadId: string, status: CodexConversationSummary['status'], origin: 'action'): void;
+    patchConversationTurnCount(threadId: string, turnCount: number, origin: 'action'): void;
+    patchRuntime(threadId: string, patch: ThreadRuntimePatch): void;
+    sendMessageToThread(threadId: string, prompt: string, options?: SendCodexMessageOptions): Promise<void>;
+};
+export declare class CodexSurfaceTurnActionsController {
+    private readonly client;
+    private readonly host;
+    constructor(client: CodexAppServerClient, host: CodexSurfaceTurnActionsHost);
+    compact(): Promise<CodexSurfaceSnapshot>;
+    compactForThread(threadId: string): Promise<void>;
+    startReview(options?: StartCodexReviewOptions): Promise<CodexSurfaceSnapshot>;
+    startReviewForThread(threadId: string, options?: StartCodexReviewOptions): Promise<void>;
+    interrupt(): Promise<CodexSurfaceSnapshot>;
+    interruptThread(threadId: string): Promise<void>;
+    deleteTurn(turnId: string): Promise<CodexSurfaceSnapshot>;
+    deleteTurnForThread(threadId: string, turnId: string): Promise<void>;
+    editTurn(turnId: string, content: string): Promise<CodexSurfaceSnapshot>;
+    editTurnForThread(threadId: string, turnId: string, content: string): Promise<void>;
+    retryTurn(turnId: string): Promise<CodexSurfaceSnapshot>;
+    retryTurnForThread(threadId: string, turnId: string): Promise<void>;
+    rollbackToTurn(threadId: string, turnId: string): Promise<void>;
+    private revertPaginatedThread;
+    private requiredActiveConversation;
+}
+//# sourceMappingURL=codex-surface-turn-actions-controller.d.ts.map

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

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