@codex-app-sdk/vue 0.0.0-stage → 0.14.0

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

@@ -0,0 +1,3639 @@
+import type { CodexConversationHistory, CodexConversationPromptHistory, CodexSurfaceApprovalDecision, CodexSurfaceApprovalScope, CodexSurfaceClientRequestResponse, CodexSurfaceEvent, CodexSurfaceRendererApi, CodexSurfaceSnapshot, CreateCodexRendererConversationOptions, ListCodexConversationsOptions, ListCodexModelsOptions, CodexRendererSendMessageOptions, StartCodexReviewOptions, UpdateCodexConversationSettings } from '@codex-app-sdk/core/surface';
+export declare function useCodexSurface(api: CodexSurfaceRendererApi): {
+    state: {
+        readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceStatus;
+        readonly authentication: {
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+            readonly account: {
+                readonly type: "apiKey";
+            } | {
+                readonly type: "chatgpt";
+                readonly email: string | null;
+                readonly planType: string;
+            } | {
+                readonly type: "amazonBedrock";
+                readonly credentialSource: "codexManaged" | "awsManaged";
+            } | null;
+            readonly requiresOpenaiAuth: boolean | null;
+            readonly error: string | null;
+            readonly login: {
+                readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceLoginStatus;
+                readonly loginId: string | null;
+                readonly authUrl: string | null;
+                readonly error: string | null;
+            };
+        };
+        readonly conversations: readonly {
+            readonly id: string;
+            readonly sessionId?: string | undefined;
+            readonly parentConversationId?: string | undefined;
+            readonly agentNickname?: string | undefined;
+            readonly agentRole?: string | undefined;
+            readonly title: string;
+            readonly preview: string;
+            readonly cwd: string;
+            readonly status: "idle" | "active" | "error";
+            readonly turnCount: number;
+            readonly createdAt: string;
+            readonly updatedAt: string;
+        }[];
+        readonly activeConversationId: string | null;
+        readonly activeTurnId: string | null;
+        readonly turns: readonly {
+            readonly id: string;
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceTurnStatus;
+            readonly error: {
+                readonly message: string;
+                readonly additionalDetails: string | null;
+                readonly codexErrorInfo: any;
+            } | null;
+            readonly willRetry: boolean;
+            readonly startedAt: string | null;
+            readonly completedAt: string | null;
+            readonly durationMs: number | null;
+        }[];
+        readonly messages: readonly {
+            readonly id: string;
+            readonly kind?: "compaction" | "steer" | undefined;
+            readonly role: "user" | "assistant" | "system";
+            readonly status: "complete" | "streaming" | "error";
+            readonly parts: readonly ({
+                readonly type: "text";
+                readonly text: string;
+                readonly itemId?: string | undefined;
+                readonly phase?: "commentary" | "final_answer" | undefined;
+            } | {
+                readonly type: "reasoning";
+                readonly summary: string;
+                readonly itemId: string;
+                readonly summaryIndex: number;
+            } | {
+                readonly type: "status";
+                readonly text: string;
+            } | {
+                readonly type: "question";
+                readonly historical?: boolean | undefined;
+                readonly request: {
+                    readonly id: string;
+                    readonly kind: "ask_user";
+                    readonly conversationId: string;
+                    readonly turnId: string;
+                    readonly itemId: string;
+                    readonly payload: {
+                        readonly request: {
+                            readonly itemId: string;
+                            readonly delivery: "tool" | "async";
+                            readonly blocking: boolean;
+                            readonly questions: readonly {
+                                readonly id: string;
+                                readonly header: string;
+                                readonly question: string;
+                                readonly isOther: boolean;
+                                readonly isSecret: boolean;
+                                readonly options: readonly {
+                                    readonly label: string;
+                                    readonly description: string;
+                                }[] | null;
+                            }[];
+                            readonly autoResolutionMs?: number | undefined;
+                        };
+                    };
+                };
+            } | {
+                readonly type: "attachment";
+                readonly attachment: {
+                    readonly kind: "file" | "image";
+                    readonly name: string;
+                    readonly path?: string | undefined;
+                    readonly url?: string | undefined;
+                    readonly mimeType?: string | undefined;
+                };
+            } | {
+                readonly type: "media";
+                readonly media: {
+                    readonly url: string;
+                    readonly alt?: string | undefined;
+                    readonly mimeType?: string | undefined;
+                    readonly prompt?: string | undefined;
+                    readonly title?: string | undefined;
+                };
+                readonly itemId?: string | undefined;
+            } | {
+                readonly type: "tool";
+                readonly id: string;
+                readonly title: string;
+                readonly kind?: string | undefined;
+                readonly status: "running" | "completed" | "failed";
+                readonly statusText?: string | undefined;
+                readonly body?: string | undefined;
+                readonly input?: Readonly<unknown> | undefined;
+                readonly output?: Readonly<unknown> | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            })[];
+            readonly createdAt?: string | undefined;
+            readonly turnId?: string | undefined;
+            readonly metadata?: {
+                readonly [x: string]: Readonly<unknown>;
+            } | undefined;
+        }[];
+        readonly clientRequests: readonly ({
+            readonly id: string;
+            readonly kind: "confirm_tool";
+            readonly conversationId: string;
+            readonly turnId: string | null;
+            readonly itemId: string;
+            readonly payload: {
+                readonly confirmation: {
+                    readonly argumentsPreview: string;
+                    readonly integrationId: string;
+                    readonly integrationName: string;
+                    readonly summary: string;
+                    readonly toolName: string;
+                    readonly allowConversation?: boolean | undefined;
+                    readonly allowAlways?: boolean | undefined;
+                };
+            };
+        } | {
+            readonly id: string;
+            readonly kind: "ask_user";
+            readonly conversationId: string;
+            readonly turnId: string;
+            readonly itemId: string;
+            readonly payload: {
+                readonly request: {
+                    readonly itemId: string;
+                    readonly delivery: "tool" | "async";
+                    readonly blocking: boolean;
+                    readonly questions: readonly {
+                        readonly id: string;
+                        readonly header: string;
+                        readonly question: string;
+                        readonly isOther: boolean;
+                        readonly isSecret: boolean;
+                        readonly options: readonly {
+                            readonly label: string;
+                            readonly description: string;
+                        }[] | null;
+                    }[];
+                    readonly autoResolutionMs?: number | undefined;
+                };
+            };
+        })[];
+        readonly answeredClientRequestIds: readonly string[];
+        readonly approvals: readonly {
+            readonly id: string;
+            readonly kind: "command" | "file-change" | "permissions";
+            readonly conversationId: string;
+            readonly turnId?: string | undefined;
+            readonly itemId: string;
+            readonly title: string;
+            readonly description?: string | undefined;
+            readonly command?: string | undefined;
+            readonly cwd?: string | undefined;
+            readonly requestedPermissions?: readonly ({
+                readonly kind: "filesystem";
+                readonly access: "read" | "write" | "deny";
+                readonly path: string;
+            } | {
+                readonly kind: "network";
+                readonly enabled: boolean;
+                readonly host?: string | undefined;
+                readonly protocol?: string | undefined;
+            })[] | undefined;
+            readonly allowedScopes?: readonly CodexSurfaceApprovalScope[] | undefined;
+            readonly canDeny?: boolean | undefined;
+        }[];
+        readonly models: readonly {
+            readonly id: string;
+            readonly model: string;
+            readonly displayName: string;
+            readonly description?: string | undefined;
+            readonly hidden?: boolean | undefined;
+            readonly supportedReasoningEfforts?: readonly {
+                readonly reasoningEffort: string;
+                readonly description: string;
+            }[] | undefined;
+            readonly defaultReasoningEffort?: string | null | undefined;
+            readonly serviceTiers?: readonly {
+                readonly id: string;
+                readonly name: string;
+                readonly description: string;
+            }[] | undefined;
+            readonly defaultServiceTier?: string | null | undefined;
+            readonly isDefault?: boolean | undefined;
+            readonly providerMetadata?: {
+                readonly [x: string]: Readonly<unknown>;
+            } | undefined;
+        }[];
+        readonly modelCatalogStatus: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        readonly skills: readonly {
+            readonly name: string;
+            readonly description?: string | undefined;
+            readonly shortDescription?: string | undefined;
+            readonly displayName?: string | undefined;
+            readonly iconSmall?: string | undefined;
+            readonly iconLarge?: string | undefined;
+            readonly brandColor?: string | undefined;
+            readonly defaultPrompt?: string | undefined;
+            readonly path: string;
+            readonly scope?: string | undefined;
+            readonly enabled: boolean;
+        }[];
+        readonly skillCatalogStatus: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        readonly plugins: readonly {
+            readonly id: string;
+            readonly name: string;
+            readonly displayName: string;
+            readonly shortDescription?: string | undefined;
+            readonly longDescription?: string | undefined;
+            readonly brandColor?: string | undefined;
+            readonly iconUrl?: string | undefined;
+            readonly iconUrlDark?: string | undefined;
+            readonly enabled: boolean;
+        }[];
+        readonly pluginCatalogStatus: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        readonly permissionProfiles: readonly {
+            readonly id: string;
+            readonly description: string | null;
+            readonly allowed: boolean;
+        }[];
+        readonly approvalPresets: readonly import("@codex-app-sdk/core/surface").CodexSurfaceApprovalPreset[];
+        readonly approvalPreset: import("@codex-app-sdk/core/surface").CodexSurfaceApprovalPreset | null;
+        readonly selectedModelId: string | null;
+        readonly selectedReasoningEffort: string | null;
+        readonly selectedServiceTier?: string | null | undefined;
+        readonly planMode: boolean;
+        readonly executionPlan?: {
+            readonly turnId: string;
+            readonly explanation: string | null;
+            readonly steps: readonly {
+                readonly step: string;
+                readonly status: import("@codex-app-sdk/core/surface").CodexSurfacePlanStepStatus;
+            }[];
+            readonly markdown: string;
+            readonly updatedAt: string;
+        } | null | undefined;
+        readonly contextUsage: {
+            readonly totalTokens: number;
+            readonly inputTokens: number;
+            readonly cachedInputTokens: number;
+            readonly outputTokens: number;
+            readonly reasoningOutputTokens: number;
+            readonly lastTotalTokens: number;
+            readonly modelContextWindow: number | null;
+            readonly usedPercent: number | null;
+        } | null;
+        readonly goal: {
+            readonly threadId: string;
+            readonly objective: string;
+            readonly status: "active" | "paused" | "blocked" | "usageLimited" | "budgetLimited" | "complete";
+            readonly tokenBudget: number | null;
+            readonly tokensUsed: number;
+            readonly timeUsedSeconds: number;
+            readonly createdAt: number;
+            readonly updatedAt: number;
+        } | null;
+        readonly turnGitDiff: {
+            readonly turnId: string;
+            readonly addedLines: number;
+            readonly removedLines: number;
+            readonly diff?: string | undefined;
+            readonly updatedAt: string;
+        } | null;
+        readonly threadStatus: {
+            readonly type: "notLoaded";
+        } | {
+            readonly type: "idle";
+        } | {
+            readonly type: "systemError";
+        } | {
+            readonly type: "active";
+            readonly activeFlags: readonly ("waitingOnApproval" | "waitingOnUserInput")[];
+        } | null;
+        readonly rateLimits: {
+            readonly rateLimits: {
+                readonly limitId: string | null;
+                readonly limitName: string | null;
+                readonly primary: {
+                    readonly usedPercent: number;
+                    readonly windowDurationMins: number | null;
+                    readonly resetsAt: number | null;
+                } | null;
+                readonly secondary: {
+                    readonly usedPercent: number;
+                    readonly windowDurationMins: number | null;
+                    readonly resetsAt: number | null;
+                } | null;
+                readonly credits: {
+                    readonly hasCredits: boolean;
+                    readonly unlimited: boolean;
+                    readonly balance: string | null;
+                } | null;
+                readonly individualLimit: {
+                    readonly limit: string;
+                    readonly used: string;
+                    readonly remainingPercent: number;
+                    readonly resetsAt: number;
+                } | null;
+                readonly planType: string | null;
+                readonly rateLimitReachedType: string | null;
+            };
+            readonly rateLimitsByLimitId: {
+                readonly [x: string]: {
+                    readonly limitId: string | null;
+                    readonly limitName: string | null;
+                    readonly primary: {
+                        readonly usedPercent: number;
+                        readonly windowDurationMins: number | null;
+                        readonly resetsAt: number | null;
+                    } | null;
+                    readonly secondary: {
+                        readonly usedPercent: number;
+                        readonly windowDurationMins: number | null;
+                        readonly resetsAt: number | null;
+                    } | null;
+                    readonly credits: {
+                        readonly hasCredits: boolean;
+                        readonly unlimited: boolean;
+                        readonly balance: string | null;
+                    } | null;
+                    readonly individualLimit: {
+                        readonly limit: string;
+                        readonly used: string;
+                        readonly remainingPercent: number;
+                        readonly resetsAt: number;
+                    } | null;
+                    readonly planType: string | null;
+                    readonly rateLimitReachedType: string | null;
+                };
+            } | null;
+            readonly rateLimitResetCredits: {
+                readonly availableCount: string;
+                readonly credits: readonly {
+                    readonly id: string;
+                    readonly resetType: string;
+                    readonly status: string;
+                    readonly grantedAt: number;
+                    readonly expiresAt: number | null;
+                    readonly title: string | null;
+                    readonly description: string | null;
+                }[] | null;
+            } | null;
+        } | null;
+        readonly queuedPrompts: readonly {
+            readonly id: string;
+            readonly text: string;
+            readonly options?: {
+                readonly attachments?: readonly ({
+                    readonly type: "image";
+                    readonly path: string;
+                    readonly detail?: "auto" | "low" | "high" | "original" | undefined;
+                    readonly name?: string | undefined;
+                    readonly mimeType?: string | undefined;
+                    readonly previewUrl?: string | undefined;
+                } | {
+                    readonly type: "file";
+                    readonly path: string;
+                    readonly name?: string | undefined;
+                    readonly mimeType?: string | undefined;
+                })[] | undefined;
+                readonly inputMethod?: "typed" | "dictated" | undefined;
+                readonly model?: string | undefined;
+                readonly reasoningEffort?: string | undefined;
+                readonly serviceTier?: string | null | undefined;
+                readonly planMode?: boolean | undefined;
+                readonly skills?: readonly {
+                    readonly name: string;
+                    readonly path: string;
+                }[] | undefined;
+                readonly outputSchema?: any;
+            } | undefined;
+        }[];
+        readonly busy: boolean;
+        readonly historyLoading: boolean;
+        readonly historyState?: {
+            readonly loadingStrategy: import("@codex-app-sdk/core/surface").CodexConversationLoadingStrategy;
+            readonly hasOlder: boolean;
+            readonly loadingOlder: boolean;
+            readonly fullyLoaded: boolean;
+        } | undefined;
+        readonly error: string | null;
+    };
+    lastEvent: Readonly<import("vue").Ref<{
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "surface.statusChanged";
+        readonly payload: {
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceStatus;
+            readonly error: string | null;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "authentication.changed";
+        readonly payload: {
+            readonly authentication: {
+                readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+                readonly account: {
+                    readonly type: "apiKey";
+                } | {
+                    readonly type: "chatgpt";
+                    readonly email: string | null;
+                    readonly planType: string;
+                } | {
+                    readonly type: "amazonBedrock";
+                    readonly credentialSource: "codexManaged" | "awsManaged";
+                } | null;
+                readonly requiresOpenaiAuth: boolean | null;
+                readonly error: string | null;
+                readonly login: {
+                    readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceLoginStatus;
+                    readonly loginId: string | null;
+                    readonly authUrl: string | null;
+                    readonly error: string | null;
+                };
+            };
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "catalog.modelsChanged";
+        readonly payload: {
+            readonly models: readonly {
+                readonly id: string;
+                readonly model: string;
+                readonly displayName: string;
+                readonly description?: string | undefined;
+                readonly hidden?: boolean | undefined;
+                readonly supportedReasoningEfforts?: readonly {
+                    readonly reasoningEffort: string;
+                    readonly description: string;
+                }[] | undefined;
+                readonly defaultReasoningEffort?: string | null | undefined;
+                readonly serviceTiers?: readonly {
+                    readonly id: string;
+                    readonly name: string;
+                    readonly description: string;
+                }[] | undefined;
+                readonly defaultServiceTier?: string | null | undefined;
+                readonly isDefault?: boolean | undefined;
+                readonly providerMetadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            }[];
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "catalog.skillsChanged";
+        readonly payload: {
+            readonly cwd: string | null;
+            readonly skills: readonly {
+                readonly name: string;
+                readonly description?: string | undefined;
+                readonly shortDescription?: string | undefined;
+                readonly displayName?: string | undefined;
+                readonly iconSmall?: string | undefined;
+                readonly iconLarge?: string | undefined;
+                readonly brandColor?: string | undefined;
+                readonly defaultPrompt?: string | undefined;
+                readonly path: string;
+                readonly scope?: string | undefined;
+                readonly enabled: boolean;
+            }[];
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "catalog.pluginsChanged";
+        readonly payload: {
+            readonly plugins: readonly {
+                readonly id: string;
+                readonly name: string;
+                readonly displayName: string;
+                readonly shortDescription?: string | undefined;
+                readonly longDescription?: string | undefined;
+                readonly brandColor?: string | undefined;
+                readonly iconUrl?: string | undefined;
+                readonly iconUrlDark?: string | undefined;
+                readonly enabled: boolean;
+            }[];
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "catalog.permissionsChanged";
+        readonly payload: {
+            readonly cwd: string | null;
+            readonly permissionProfiles: readonly {
+                readonly id: string;
+                readonly description: string | null;
+                readonly allowed: boolean;
+            }[];
+            readonly approvalPresets: readonly import("@codex-app-sdk/core/surface").CodexSurfaceApprovalPreset[];
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "rateLimits.changed";
+        readonly payload: {
+            readonly rateLimits: {
+                readonly rateLimits: {
+                    readonly limitId: string | null;
+                    readonly limitName: string | null;
+                    readonly primary: {
+                        readonly usedPercent: number;
+                        readonly windowDurationMins: number | null;
+                        readonly resetsAt: number | null;
+                    } | null;
+                    readonly secondary: {
+                        readonly usedPercent: number;
+                        readonly windowDurationMins: number | null;
+                        readonly resetsAt: number | null;
+                    } | null;
+                    readonly credits: {
+                        readonly hasCredits: boolean;
+                        readonly unlimited: boolean;
+                        readonly balance: string | null;
+                    } | null;
+                    readonly individualLimit: {
+                        readonly limit: string;
+                        readonly used: string;
+                        readonly remainingPercent: number;
+                        readonly resetsAt: number;
+                    } | null;
+                    readonly planType: string | null;
+                    readonly rateLimitReachedType: string | null;
+                };
+                readonly rateLimitsByLimitId: {
+                    readonly [x: string]: {
+                        readonly limitId: string | null;
+                        readonly limitName: string | null;
+                        readonly primary: {
+                            readonly usedPercent: number;
+                            readonly windowDurationMins: number | null;
+                            readonly resetsAt: number | null;
+                        } | null;
+                        readonly secondary: {
+                            readonly usedPercent: number;
+                            readonly windowDurationMins: number | null;
+                            readonly resetsAt: number | null;
+                        } | null;
+                        readonly credits: {
+                            readonly hasCredits: boolean;
+                            readonly unlimited: boolean;
+                            readonly balance: string | null;
+                        } | null;
+                        readonly individualLimit: {
+                            readonly limit: string;
+                            readonly used: string;
+                            readonly remainingPercent: number;
+                            readonly resetsAt: number;
+                        } | null;
+                        readonly planType: string | null;
+                        readonly rateLimitReachedType: string | null;
+                    };
+                } | null;
+                readonly rateLimitResetCredits: {
+                    readonly availableCount: string;
+                    readonly credits: readonly {
+                        readonly id: string;
+                        readonly resetType: string;
+                        readonly status: string;
+                        readonly grantedAt: number;
+                        readonly expiresAt: number | null;
+                        readonly title: string | null;
+                        readonly description: string | null;
+                    }[] | null;
+                } | null;
+            } | null;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "remoteControl.statusChanged";
+        readonly payload: {
+            readonly status: {
+                readonly status: "disabled" | "connecting" | "connected" | "errored";
+                readonly serverName: string;
+                readonly installationId: string;
+                readonly environmentId: string | null;
+            };
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.selected";
+        readonly payload: {
+            readonly conversationId: string | null;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.summaryUpserted";
+        readonly payload: {
+            readonly summary: {
+                readonly id: string;
+                readonly sessionId?: string | undefined;
+                readonly parentConversationId?: string | undefined;
+                readonly agentNickname?: string | undefined;
+                readonly agentRole?: string | undefined;
+                readonly title: string;
+                readonly preview: string;
+                readonly cwd: string;
+                readonly status: "idle" | "active" | "error";
+                readonly turnCount: number;
+                readonly createdAt: string;
+                readonly updatedAt: string;
+            };
+            readonly reason: "created" | "listed" | "resumed" | "started" | "updated";
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.summaryRemoved";
+        readonly payload: {
+            readonly reason: "archived" | "deleted";
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.historyReplaced";
+        readonly payload: {
+            readonly reason: import("@codex-app-sdk/core/surface").CodexSurfaceHistoryReason;
+            readonly messages: readonly {
+                readonly id: string;
+                readonly kind?: "compaction" | "steer" | undefined;
+                readonly role: "user" | "assistant" | "system";
+                readonly status: "complete" | "streaming" | "error";
+                readonly parts: readonly ({
+                    readonly type: "text";
+                    readonly text: string;
+                    readonly itemId?: string | undefined;
+                    readonly phase?: "commentary" | "final_answer" | undefined;
+                } | {
+                    readonly type: "reasoning";
+                    readonly summary: string;
+                    readonly itemId: string;
+                    readonly summaryIndex: number;
+                } | {
+                    readonly type: "status";
+                    readonly text: string;
+                } | {
+                    readonly type: "question";
+                    readonly historical?: boolean | undefined;
+                    readonly request: {
+                        readonly id: string;
+                        readonly kind: "ask_user";
+                        readonly conversationId: string;
+                        readonly turnId: string;
+                        readonly itemId: string;
+                        readonly payload: {
+                            readonly request: {
+                                readonly itemId: string;
+                                readonly delivery: "tool" | "async";
+                                readonly blocking: boolean;
+                                readonly questions: readonly {
+                                    readonly id: string;
+                                    readonly header: string;
+                                    readonly question: string;
+                                    readonly isOther: boolean;
+                                    readonly isSecret: boolean;
+                                    readonly options: readonly {
+                                        readonly label: string;
+                                        readonly description: string;
+                                    }[] | null;
+                                }[];
+                                readonly autoResolutionMs?: number | undefined;
+                            };
+                        };
+                    };
+                } | {
+                    readonly type: "attachment";
+                    readonly attachment: {
+                        readonly kind: "file" | "image";
+                        readonly name: string;
+                        readonly path?: string | undefined;
+                        readonly url?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    };
+                } | {
+                    readonly type: "media";
+                    readonly media: {
+                        readonly url: string;
+                        readonly alt?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly prompt?: string | undefined;
+                        readonly title?: string | undefined;
+                    };
+                    readonly itemId?: string | undefined;
+                } | {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                })[];
+                readonly createdAt?: string | undefined;
+                readonly turnId?: string | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            }[];
+            readonly threadStatus: {
+                readonly type: "notLoaded";
+            } | {
+                readonly type: "idle";
+            } | {
+                readonly type: "systemError";
+            } | {
+                readonly type: "active";
+                readonly activeFlags: readonly ("waitingOnApproval" | "waitingOnUserInput")[];
+            } | null;
+            readonly state?: {
+                readonly error: string | null;
+                readonly activeTurnId: string | null;
+                readonly answeredClientRequestIds: readonly string[];
+                readonly busy: boolean;
+                readonly contextUsage: {
+                    readonly totalTokens: number;
+                    readonly inputTokens: number;
+                    readonly cachedInputTokens: number;
+                    readonly outputTokens: number;
+                    readonly reasoningOutputTokens: number;
+                    readonly lastTotalTokens: number;
+                    readonly modelContextWindow: number | null;
+                    readonly usedPercent: number | null;
+                } | null;
+                readonly executionPlan?: {
+                    readonly turnId: string;
+                    readonly explanation: string | null;
+                    readonly steps: readonly {
+                        readonly step: string;
+                        readonly status: import("@codex-app-sdk/core/surface").CodexSurfacePlanStepStatus;
+                    }[];
+                    readonly markdown: string;
+                    readonly updatedAt: string;
+                } | null | undefined;
+                readonly historyLoading: boolean;
+                readonly historyState?: {
+                    readonly loadingStrategy: import("@codex-app-sdk/core/surface").CodexConversationLoadingStrategy;
+                    readonly hasOlder: boolean;
+                    readonly loadingOlder: boolean;
+                    readonly fullyLoaded: boolean;
+                } | undefined;
+                readonly turnGitDiff: {
+                    readonly turnId: string;
+                    readonly addedLines: number;
+                    readonly removedLines: number;
+                    readonly diff?: string | undefined;
+                    readonly updatedAt: string;
+                } | null;
+                readonly turnIds: readonly string[];
+                readonly turns: readonly {
+                    readonly id: string;
+                    readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceTurnStatus;
+                    readonly error: {
+                        readonly message: string;
+                        readonly additionalDetails: string | null;
+                        readonly codexErrorInfo: any;
+                    } | null;
+                    readonly willRetry: boolean;
+                    readonly startedAt: string | null;
+                    readonly completedAt: string | null;
+                    readonly durationMs: number | null;
+                }[];
+            } | undefined;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.historyPrepended";
+        readonly payload: {
+            readonly messages: readonly {
+                readonly id: string;
+                readonly kind?: "compaction" | "steer" | undefined;
+                readonly role: "user" | "assistant" | "system";
+                readonly status: "complete" | "streaming" | "error";
+                readonly parts: readonly ({
+                    readonly type: "text";
+                    readonly text: string;
+                    readonly itemId?: string | undefined;
+                    readonly phase?: "commentary" | "final_answer" | undefined;
+                } | {
+                    readonly type: "reasoning";
+                    readonly summary: string;
+                    readonly itemId: string;
+                    readonly summaryIndex: number;
+                } | {
+                    readonly type: "status";
+                    readonly text: string;
+                } | {
+                    readonly type: "question";
+                    readonly historical?: boolean | undefined;
+                    readonly request: {
+                        readonly id: string;
+                        readonly kind: "ask_user";
+                        readonly conversationId: string;
+                        readonly turnId: string;
+                        readonly itemId: string;
+                        readonly payload: {
+                            readonly request: {
+                                readonly itemId: string;
+                                readonly delivery: "tool" | "async";
+                                readonly blocking: boolean;
+                                readonly questions: readonly {
+                                    readonly id: string;
+                                    readonly header: string;
+                                    readonly question: string;
+                                    readonly isOther: boolean;
+                                    readonly isSecret: boolean;
+                                    readonly options: readonly {
+                                        readonly label: string;
+                                        readonly description: string;
+                                    }[] | null;
+                                }[];
+                                readonly autoResolutionMs?: number | undefined;
+                            };
+                        };
+                    };
+                } | {
+                    readonly type: "attachment";
+                    readonly attachment: {
+                        readonly kind: "file" | "image";
+                        readonly name: string;
+                        readonly path?: string | undefined;
+                        readonly url?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    };
+                } | {
+                    readonly type: "media";
+                    readonly media: {
+                        readonly url: string;
+                        readonly alt?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly prompt?: string | undefined;
+                        readonly title?: string | undefined;
+                    };
+                    readonly itemId?: string | undefined;
+                } | {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                })[];
+                readonly createdAt?: string | undefined;
+                readonly turnId?: string | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            }[];
+            readonly state?: {
+                readonly historyLoading: boolean;
+                readonly historyState?: {
+                    readonly loadingStrategy: import("@codex-app-sdk/core/surface").CodexConversationLoadingStrategy;
+                    readonly hasOlder: boolean;
+                    readonly loadingOlder: boolean;
+                    readonly fullyLoaded: boolean;
+                } | undefined;
+                readonly turnIds: readonly string[];
+                readonly turns: readonly {
+                    readonly id: string;
+                    readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceTurnStatus;
+                    readonly error: {
+                        readonly message: string;
+                        readonly additionalDetails: string | null;
+                        readonly codexErrorInfo: any;
+                    } | null;
+                    readonly willRetry: boolean;
+                    readonly startedAt: string | null;
+                    readonly completedAt: string | null;
+                    readonly durationMs: number | null;
+                }[];
+            } | undefined;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.historyStateChanged";
+        readonly payload: {
+            readonly historyLoading: boolean;
+            readonly historyState: {
+                readonly loadingStrategy: import("@codex-app-sdk/core/surface").CodexConversationLoadingStrategy;
+                readonly hasOlder: boolean;
+                readonly loadingOlder: boolean;
+                readonly fullyLoaded: boolean;
+            };
+            readonly error: string | null;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.activityChanged";
+        readonly payload: {
+            readonly threadStatus: {
+                readonly type: "notLoaded";
+            } | {
+                readonly type: "idle";
+            } | {
+                readonly type: "systemError";
+            } | {
+                readonly type: "active";
+                readonly activeFlags: readonly ("waitingOnApproval" | "waitingOnUserInput")[];
+            } | null;
+            readonly busy: boolean;
+            readonly error: string | null;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.settingsChanged";
+        readonly payload: {
+            readonly approvalPreset: import("@codex-app-sdk/core/surface").CodexSurfaceApprovalPreset | null;
+            readonly selectedModelId: string | null;
+            readonly selectedReasoningEffort: string | null;
+            readonly selectedServiceTier?: string | null | undefined;
+            readonly planMode: boolean;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.goalChanged";
+        readonly payload: {
+            readonly goal: {
+                readonly threadId: string;
+                readonly objective: string;
+                readonly status: "active" | "paused" | "blocked" | "usageLimited" | "budgetLimited" | "complete";
+                readonly tokenBudget: number | null;
+                readonly tokensUsed: number;
+                readonly timeUsedSeconds: number;
+                readonly createdAt: number;
+                readonly updatedAt: number;
+            } | null;
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.contextUsageChanged";
+        readonly payload: {
+            readonly contextUsage: {
+                readonly totalTokens: number;
+                readonly inputTokens: number;
+                readonly cachedInputTokens: number;
+                readonly outputTokens: number;
+                readonly reasoningOutputTokens: number;
+                readonly lastTotalTokens: number;
+                readonly modelContextWindow: number | null;
+                readonly usedPercent: number | null;
+            } | null;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.skillsChanged";
+        readonly payload: {
+            readonly cwd: string | null;
+            readonly skills: readonly {
+                readonly name: string;
+                readonly description?: string | undefined;
+                readonly shortDescription?: string | undefined;
+                readonly displayName?: string | undefined;
+                readonly iconSmall?: string | undefined;
+                readonly iconLarge?: string | undefined;
+                readonly brandColor?: string | undefined;
+                readonly defaultPrompt?: string | undefined;
+                readonly path: string;
+                readonly scope?: string | undefined;
+                readonly enabled: boolean;
+            }[];
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.permissionsChanged";
+        readonly payload: {
+            readonly cwd: string | null;
+            readonly permissionProfiles: readonly {
+                readonly id: string;
+                readonly description: string | null;
+                readonly allowed: boolean;
+            }[];
+            readonly approvalPresets: readonly import("@codex-app-sdk/core/surface").CodexSurfaceApprovalPreset[];
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.diffUpdated";
+        readonly payload: {
+            readonly diff: {
+                readonly turnId: string;
+                readonly addedLines: number;
+                readonly removedLines: number;
+                readonly diff?: string | undefined;
+                readonly updatedAt: string;
+            } | null;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.queueChanged";
+        readonly payload: {
+            readonly queuedPrompts: readonly {
+                readonly id: string;
+                readonly text: string;
+                readonly options?: {
+                    readonly attachments?: readonly ({
+                        readonly type: "image";
+                        readonly path: string;
+                        readonly detail?: "auto" | "low" | "high" | "original" | undefined;
+                        readonly name?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly previewUrl?: string | undefined;
+                    } | {
+                        readonly type: "file";
+                        readonly path: string;
+                        readonly name?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    })[] | undefined;
+                    readonly inputMethod?: "typed" | "dictated" | undefined;
+                    readonly model?: string | undefined;
+                    readonly reasoningEffort?: string | undefined;
+                    readonly serviceTier?: string | null | undefined;
+                    readonly planMode?: boolean | undefined;
+                    readonly skills?: readonly {
+                        readonly name: string;
+                        readonly path: string;
+                    }[] | undefined;
+                    readonly outputSchema?: any;
+                } | undefined;
+            }[];
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.started";
+        readonly payload: {
+            readonly realtimeSessionId: string | null;
+            readonly version: import("@codex-app-sdk/core/surface").CodexRealtimeVersion;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.itemAdded";
+        readonly payload: {
+            readonly item: any;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.itemStarted";
+        readonly payload: {
+            readonly item: any;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.itemCompleted";
+        readonly payload: {
+            readonly item: any;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.itemTranscriptDelta";
+        readonly payload: {
+            readonly itemId: string;
+            readonly delta: string;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.transcriptDelta";
+        readonly payload: {
+            readonly role: string;
+            readonly delta: string;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.transcriptCompleted";
+        readonly payload: {
+            readonly role: string;
+            readonly text: string;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.audioDelta";
+        readonly payload: {
+            readonly audio: {
+                readonly data: {
+                    readonly [x: number]: number;
+                    readonly BYTES_PER_ELEMENT: number;
+                    readonly buffer: {
+                        readonly byteLength: number;
+                        readonly slice: (begin?: number, end?: number) => ArrayBuffer;
+                        readonly [Symbol.toStringTag]: "ArrayBuffer";
+                    } | {
+                        readonly byteLength: number;
+                        readonly slice: (begin?: number, end?: number) => SharedArrayBuffer;
+                        readonly [Symbol.toStringTag]: "SharedArrayBuffer";
+                    };
+                    readonly byteLength: number;
+                    readonly byteOffset: number;
+                    readonly copyWithin: (target: number, start: number, end?: number) => Uint8Array<ArrayBufferLike>;
+                    readonly every: (predicate: (value: number, index: number, array: Uint8Array<ArrayBufferLike>) => unknown, thisArg?: any) => boolean;
+                    readonly fill: (value: number, start?: number, end?: number) => Uint8Array<ArrayBufferLike>;
+                    readonly filter: (predicate: (value: number, index: number, array: Uint8Array<ArrayBufferLike>) => any, thisArg?: any) => Uint8Array<ArrayBuffer>;
+                    readonly find: (predicate: (value: number, index: number, obj: Uint8Array<ArrayBufferLike>) => boolean, thisArg?: any) => number | undefined;
+                    readonly findIndex: (predicate: (value: number, index: number, obj: Uint8Array<ArrayBufferLike>) => boolean, thisArg?: any) => number;
+                    readonly forEach: (callbackfn: (value: number, index: number, array: Uint8Array<ArrayBufferLike>) => void, thisArg?: any) => void;
+                    readonly indexOf: (searchElement: number, fromIndex?: number) => number;
+                    readonly join: (separator?: string) => string;
+                    readonly lastIndexOf: (searchElement: number, fromIndex?: number) => number;
+                    readonly length: number;
+                    readonly map: (callbackfn: (value: number, index: number, array: Uint8Array<ArrayBufferLike>) => number, thisArg?: any) => Uint8Array<ArrayBuffer>;
+                    readonly reduce: {
+                        (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => number): number;
+                        (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => number, initialValue: number): number;
+                        <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => U, initialValue: U): U;
+                    };
+                    readonly reduceRight: {
+                        (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => number): number;
+                        (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => number, initialValue: number): number;
+                        <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => U, initialValue: U): U;
+                    };
+                    readonly reverse: () => Uint8Array<ArrayBufferLike>;
+                    readonly set: (array: ArrayLike<number>, offset?: number) => void;
+                    readonly slice: (start?: number, end?: number) => Uint8Array<ArrayBuffer>;
+                    readonly some: (predicate: (value: number, index: number, array: Uint8Array<ArrayBufferLike>) => unknown, thisArg?: any) => boolean;
+                    readonly sort: (compareFn?: ((a: number, b: number) => number) | undefined) => Uint8Array<ArrayBufferLike>;
+                    readonly subarray: (begin?: number, end?: number) => Uint8Array<ArrayBufferLike>;
+                    readonly toLocaleString: {
+                        (): string;
+                        (locales: string | string[], options?: Intl.NumberFormatOptions): string;
+                    };
+                    readonly toString: () => string;
+                    readonly valueOf: () => Uint8Array<ArrayBufferLike>;
+                    readonly entries: () => ArrayIterator<[number, number]>;
+                    readonly keys: () => ArrayIterator<number>;
+                    readonly values: () => ArrayIterator<number>;
+                    readonly includes: (searchElement: number, fromIndex?: number) => boolean;
+                    readonly at: (index: number) => number | undefined;
+                    readonly [Symbol.iterator]: () => ArrayIterator<number>;
+                    readonly [Symbol.toStringTag]: "Uint8Array";
+                };
+                readonly sampleRate: number;
+                readonly numChannels: number;
+                readonly samplesPerChannel: number | null;
+                readonly itemId: string | null;
+            };
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.sdp";
+        readonly payload: {
+            readonly sdp: string;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.error";
+        readonly payload: {
+            readonly message: string;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.closed";
+        readonly payload: {
+            readonly reason: string | null;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "turn.started";
+        readonly payload: {
+            readonly startedAt: string;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "turn.completed";
+        readonly payload: {
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceTurnStatus;
+            readonly error: {
+                readonly message: string;
+                readonly additionalDetails: string | null;
+                readonly codexErrorInfo: any;
+            } | null;
+            readonly willRetry: boolean;
+            readonly startedAt: string | null;
+            readonly completedAt: string | null;
+            readonly durationMs: number | null;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "turn.error";
+        readonly payload: {
+            readonly error: {
+                readonly message: string;
+                readonly additionalDetails: string | null;
+                readonly codexErrorInfo: any;
+            };
+            readonly willRetry: boolean;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "message.appended";
+        readonly payload: {
+            readonly message: {
+                readonly id: string;
+                readonly kind?: "compaction" | "steer" | undefined;
+                readonly role: "user" | "assistant" | "system";
+                readonly status: "complete" | "streaming" | "error";
+                readonly parts: readonly ({
+                    readonly type: "text";
+                    readonly text: string;
+                    readonly itemId?: string | undefined;
+                    readonly phase?: "commentary" | "final_answer" | undefined;
+                } | {
+                    readonly type: "reasoning";
+                    readonly summary: string;
+                    readonly itemId: string;
+                    readonly summaryIndex: number;
+                } | {
+                    readonly type: "status";
+                    readonly text: string;
+                } | {
+                    readonly type: "question";
+                    readonly historical?: boolean | undefined;
+                    readonly request: {
+                        readonly id: string;
+                        readonly kind: "ask_user";
+                        readonly conversationId: string;
+                        readonly turnId: string;
+                        readonly itemId: string;
+                        readonly payload: {
+                            readonly request: {
+                                readonly itemId: string;
+                                readonly delivery: "tool" | "async";
+                                readonly blocking: boolean;
+                                readonly questions: readonly {
+                                    readonly id: string;
+                                    readonly header: string;
+                                    readonly question: string;
+                                    readonly isOther: boolean;
+                                    readonly isSecret: boolean;
+                                    readonly options: readonly {
+                                        readonly label: string;
+                                        readonly description: string;
+                                    }[] | null;
+                                }[];
+                                readonly autoResolutionMs?: number | undefined;
+                            };
+                        };
+                    };
+                } | {
+                    readonly type: "attachment";
+                    readonly attachment: {
+                        readonly kind: "file" | "image";
+                        readonly name: string;
+                        readonly path?: string | undefined;
+                        readonly url?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    };
+                } | {
+                    readonly type: "media";
+                    readonly media: {
+                        readonly url: string;
+                        readonly alt?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly prompt?: string | undefined;
+                        readonly title?: string | undefined;
+                    };
+                    readonly itemId?: string | undefined;
+                } | {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                })[];
+                readonly createdAt?: string | undefined;
+                readonly turnId?: string | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "message.delta";
+        readonly payload: {
+            readonly messageId: string;
+            readonly itemId: string;
+            readonly delta: string;
+            readonly phase?: "commentary" | "final_answer" | undefined;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "message.updated";
+        readonly payload: {
+            readonly message: {
+                readonly id: string;
+                readonly kind?: "compaction" | "steer" | undefined;
+                readonly role: "user" | "assistant" | "system";
+                readonly status: "complete" | "streaming" | "error";
+                readonly parts: readonly ({
+                    readonly type: "text";
+                    readonly text: string;
+                    readonly itemId?: string | undefined;
+                    readonly phase?: "commentary" | "final_answer" | undefined;
+                } | {
+                    readonly type: "reasoning";
+                    readonly summary: string;
+                    readonly itemId: string;
+                    readonly summaryIndex: number;
+                } | {
+                    readonly type: "status";
+                    readonly text: string;
+                } | {
+                    readonly type: "question";
+                    readonly historical?: boolean | undefined;
+                    readonly request: {
+                        readonly id: string;
+                        readonly kind: "ask_user";
+                        readonly conversationId: string;
+                        readonly turnId: string;
+                        readonly itemId: string;
+                        readonly payload: {
+                            readonly request: {
+                                readonly itemId: string;
+                                readonly delivery: "tool" | "async";
+                                readonly blocking: boolean;
+                                readonly questions: readonly {
+                                    readonly id: string;
+                                    readonly header: string;
+                                    readonly question: string;
+                                    readonly isOther: boolean;
+                                    readonly isSecret: boolean;
+                                    readonly options: readonly {
+                                        readonly label: string;
+                                        readonly description: string;
+                                    }[] | null;
+                                }[];
+                                readonly autoResolutionMs?: number | undefined;
+                            };
+                        };
+                    };
+                } | {
+                    readonly type: "attachment";
+                    readonly attachment: {
+                        readonly kind: "file" | "image";
+                        readonly name: string;
+                        readonly path?: string | undefined;
+                        readonly url?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    };
+                } | {
+                    readonly type: "media";
+                    readonly media: {
+                        readonly url: string;
+                        readonly alt?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly prompt?: string | undefined;
+                        readonly title?: string | undefined;
+                    };
+                    readonly itemId?: string | undefined;
+                } | {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                })[];
+                readonly createdAt?: string | undefined;
+                readonly turnId?: string | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "tool.started";
+        readonly payload: {
+            readonly messageId: string;
+            readonly toolPart: {
+                readonly type: "tool";
+                readonly id: string;
+                readonly title: string;
+                readonly kind?: string | undefined;
+                readonly status: "running" | "completed" | "failed";
+                readonly statusText?: string | undefined;
+                readonly body?: string | undefined;
+                readonly input?: Readonly<unknown> | undefined;
+                readonly output?: Readonly<unknown> | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "tool.updated";
+        readonly payload: {
+            readonly messageId: string;
+            readonly update: {
+                readonly itemId: string;
+                readonly title?: string | undefined;
+                readonly status?: import("@codex-app-sdk/core/surface").SurfaceMessageToolPart["status"] | undefined;
+                readonly statusText?: string | null | undefined;
+                readonly body?: string | undefined;
+                readonly bodyDelta?: string | undefined;
+                readonly bodyAppend?: string | undefined;
+                readonly input?: Readonly<unknown> | undefined;
+                readonly output?: Readonly<unknown> | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+                readonly fallbackToolPart?: {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "tool.completed";
+        readonly payload: {
+            readonly messageId: string;
+            readonly toolPart: {
+                readonly type: "tool";
+                readonly id: string;
+                readonly title: string;
+                readonly kind?: string | undefined;
+                readonly status: "running" | "completed" | "failed";
+                readonly statusText?: string | undefined;
+                readonly body?: string | undefined;
+                readonly input?: Readonly<unknown> | undefined;
+                readonly output?: Readonly<unknown> | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "file.activity";
+        readonly payload: {
+            readonly messageId: string;
+            readonly itemId: string;
+            readonly path: string;
+            readonly action: import("@codex-app-sdk/core/surface").CodexSurfaceFileActivityAction;
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceFileActivityStatus;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "subagent.toolCallChanged";
+        readonly payload: {
+            readonly lifecycle: import("@codex-app-sdk/core/surface").CodexSurfaceSubagentItemLifecycle;
+            readonly toolCall: {
+                readonly id: string;
+                readonly tool: import("@codex-app-sdk/core/surface").CodexSurfaceSubagentTool;
+                readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceSubagentToolCallStatus;
+                readonly senderConversationId: string;
+                readonly receiverConversationIds: readonly string[];
+                readonly prompt: string | null;
+                readonly model: string | null;
+                readonly reasoningEffort: string | null;
+                readonly agentStates: {
+                    readonly [x: string]: {
+                        readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceSubagentStatus;
+                        readonly message: string | null;
+                    };
+                };
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "subagent.activity";
+        readonly payload: {
+            readonly lifecycle: import("@codex-app-sdk/core/surface").CodexSurfaceSubagentItemLifecycle;
+            readonly activity: {
+                readonly id: string;
+                readonly kind: "started" | "interacted" | "interrupted" | "completed";
+                readonly agentConversationId: string;
+                readonly agentPath: string;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "plan.delta";
+        readonly payload: {
+            readonly itemId: string;
+            readonly delta: string;
+            readonly markdown: string;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "plan.updated";
+        readonly payload: {
+            readonly explanation: string | null;
+            readonly steps: readonly {
+                readonly step: string;
+                readonly status: import("@codex-app-sdk/core/surface").CodexSurfacePlanStepStatus;
+            }[];
+            readonly markdown: string;
+            readonly status: "running" | "completed";
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "plan.completed";
+        readonly payload: {
+            readonly itemId: string;
+            readonly markdown: string;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "context.compactionStarted";
+        readonly payload: {
+            readonly itemId: string | null;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "context.compactionCompleted";
+        readonly payload: {
+            readonly itemId: string | null;
+            readonly message: {
+                readonly id: string;
+                readonly kind?: "compaction" | "steer" | undefined;
+                readonly role: "user" | "assistant" | "system";
+                readonly status: "complete" | "streaming" | "error";
+                readonly parts: readonly ({
+                    readonly type: "text";
+                    readonly text: string;
+                    readonly itemId?: string | undefined;
+                    readonly phase?: "commentary" | "final_answer" | undefined;
+                } | {
+                    readonly type: "reasoning";
+                    readonly summary: string;
+                    readonly itemId: string;
+                    readonly summaryIndex: number;
+                } | {
+                    readonly type: "status";
+                    readonly text: string;
+                } | {
+                    readonly type: "question";
+                    readonly historical?: boolean | undefined;
+                    readonly request: {
+                        readonly id: string;
+                        readonly kind: "ask_user";
+                        readonly conversationId: string;
+                        readonly turnId: string;
+                        readonly itemId: string;
+                        readonly payload: {
+                            readonly request: {
+                                readonly itemId: string;
+                                readonly delivery: "tool" | "async";
+                                readonly blocking: boolean;
+                                readonly questions: readonly {
+                                    readonly id: string;
+                                    readonly header: string;
+                                    readonly question: string;
+                                    readonly isOther: boolean;
+                                    readonly isSecret: boolean;
+                                    readonly options: readonly {
+                                        readonly label: string;
+                                        readonly description: string;
+                                    }[] | null;
+                                }[];
+                                readonly autoResolutionMs?: number | undefined;
+                            };
+                        };
+                    };
+                } | {
+                    readonly type: "attachment";
+                    readonly attachment: {
+                        readonly kind: "file" | "image";
+                        readonly name: string;
+                        readonly path?: string | undefined;
+                        readonly url?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    };
+                } | {
+                    readonly type: "media";
+                    readonly media: {
+                        readonly url: string;
+                        readonly alt?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly prompt?: string | undefined;
+                        readonly title?: string | undefined;
+                    };
+                    readonly itemId?: string | undefined;
+                } | {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                })[];
+                readonly createdAt?: string | undefined;
+                readonly turnId?: string | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "approval.requested";
+        readonly payload: {
+            readonly approval: {
+                readonly id: string;
+                readonly kind: "command" | "file-change" | "permissions";
+                readonly conversationId: string;
+                readonly turnId?: string | undefined;
+                readonly itemId: string;
+                readonly title: string;
+                readonly description?: string | undefined;
+                readonly command?: string | undefined;
+                readonly cwd?: string | undefined;
+                readonly requestedPermissions?: readonly ({
+                    readonly kind: "filesystem";
+                    readonly access: "read" | "write" | "deny";
+                    readonly path: string;
+                } | {
+                    readonly kind: "network";
+                    readonly enabled: boolean;
+                    readonly host?: string | undefined;
+                    readonly protocol?: string | undefined;
+                })[] | undefined;
+                readonly allowedScopes?: readonly CodexSurfaceApprovalScope[] | undefined;
+                readonly canDeny?: boolean | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "approval.resolved";
+        readonly payload: {
+            readonly approval: {
+                readonly id: string;
+                readonly kind: "command" | "file-change" | "permissions";
+                readonly conversationId: string;
+                readonly turnId?: string | undefined;
+                readonly itemId: string;
+                readonly title: string;
+                readonly description?: string | undefined;
+                readonly command?: string | undefined;
+                readonly cwd?: string | undefined;
+                readonly requestedPermissions?: readonly ({
+                    readonly kind: "filesystem";
+                    readonly access: "read" | "write" | "deny";
+                    readonly path: string;
+                } | {
+                    readonly kind: "network";
+                    readonly enabled: boolean;
+                    readonly host?: string | undefined;
+                    readonly protocol?: string | undefined;
+                })[] | undefined;
+                readonly allowedScopes?: readonly CodexSurfaceApprovalScope[] | undefined;
+                readonly canDeny?: boolean | undefined;
+            };
+            readonly decision: CodexSurfaceApprovalDecision | null;
+            readonly scope: CodexSurfaceApprovalScope | null;
+            readonly reason: "host" | "server" | "conversation_closed" | "conversation_removed" | "surface_disconnected";
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "clientRequest.requested";
+        readonly payload: {
+            readonly request: {
+                readonly id: string;
+                readonly kind: "ask_user";
+                readonly conversationId: string;
+                readonly turnId: string;
+                readonly itemId: string;
+                readonly payload: {
+                    readonly request: {
+                        readonly itemId: string;
+                        readonly delivery: "tool" | "async";
+                        readonly blocking: boolean;
+                        readonly questions: readonly {
+                            readonly id: string;
+                            readonly header: string;
+                            readonly question: string;
+                            readonly isOther: boolean;
+                            readonly isSecret: boolean;
+                            readonly options: readonly {
+                                readonly label: string;
+                                readonly description: string;
+                            }[] | null;
+                        }[];
+                        readonly autoResolutionMs?: number | undefined;
+                    };
+                };
+            } | {
+                readonly id: string;
+                readonly kind: "confirm_tool";
+                readonly conversationId: string;
+                readonly turnId: string | null;
+                readonly itemId: string;
+                readonly payload: {
+                    readonly confirmation: {
+                        readonly argumentsPreview: string;
+                        readonly integrationId: string;
+                        readonly integrationName: string;
+                        readonly summary: string;
+                        readonly toolName: string;
+                        readonly allowConversation?: boolean | undefined;
+                        readonly allowAlways?: boolean | undefined;
+                    };
+                };
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "clientRequest.resolved";
+        readonly payload: {
+            readonly request: {
+                readonly id: string;
+                readonly kind: "ask_user";
+                readonly conversationId: string;
+                readonly turnId: string;
+                readonly itemId: string;
+                readonly payload: {
+                    readonly request: {
+                        readonly itemId: string;
+                        readonly delivery: "tool" | "async";
+                        readonly blocking: boolean;
+                        readonly questions: readonly {
+                            readonly id: string;
+                            readonly header: string;
+                            readonly question: string;
+                            readonly isOther: boolean;
+                            readonly isSecret: boolean;
+                            readonly options: readonly {
+                                readonly label: string;
+                                readonly description: string;
+                            }[] | null;
+                        }[];
+                        readonly autoResolutionMs?: number | undefined;
+                    };
+                };
+            } | {
+                readonly id: string;
+                readonly kind: "confirm_tool";
+                readonly conversationId: string;
+                readonly turnId: string | null;
+                readonly itemId: string;
+                readonly payload: {
+                    readonly confirmation: {
+                        readonly argumentsPreview: string;
+                        readonly integrationId: string;
+                        readonly integrationName: string;
+                        readonly summary: string;
+                        readonly toolName: string;
+                        readonly allowConversation?: boolean | undefined;
+                        readonly allowAlways?: boolean | undefined;
+                    };
+                };
+            };
+            readonly response: {
+                readonly id: string;
+                readonly payload?: {
+                    readonly answers?: {
+                        readonly [x: string]: {
+                            readonly answers: readonly string[];
+                        };
+                    } | undefined;
+                    readonly cancelled?: boolean | undefined;
+                    readonly decision?: (import("@codex-app-sdk/core/surface").CodexSurfaceToolConfirmationDecision | null) | undefined;
+                } | undefined;
+            } | null;
+            readonly reason: "host" | "server" | "conversation_closed" | "conversation_removed" | "surface_disconnected";
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | null, {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "surface.statusChanged";
+        readonly payload: {
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceStatus;
+            readonly error: string | null;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "authentication.changed";
+        readonly payload: {
+            readonly authentication: {
+                readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+                readonly account: {
+                    readonly type: "apiKey";
+                } | {
+                    readonly type: "chatgpt";
+                    readonly email: string | null;
+                    readonly planType: string;
+                } | {
+                    readonly type: "amazonBedrock";
+                    readonly credentialSource: "codexManaged" | "awsManaged";
+                } | null;
+                readonly requiresOpenaiAuth: boolean | null;
+                readonly error: string | null;
+                readonly login: {
+                    readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceLoginStatus;
+                    readonly loginId: string | null;
+                    readonly authUrl: string | null;
+                    readonly error: string | null;
+                };
+            };
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "catalog.modelsChanged";
+        readonly payload: {
+            readonly models: readonly {
+                readonly id: string;
+                readonly model: string;
+                readonly displayName: string;
+                readonly description?: string | undefined;
+                readonly hidden?: boolean | undefined;
+                readonly supportedReasoningEfforts?: readonly {
+                    readonly reasoningEffort: string;
+                    readonly description: string;
+                }[] | undefined;
+                readonly defaultReasoningEffort?: string | null | undefined;
+                readonly serviceTiers?: readonly {
+                    readonly id: string;
+                    readonly name: string;
+                    readonly description: string;
+                }[] | undefined;
+                readonly defaultServiceTier?: string | null | undefined;
+                readonly isDefault?: boolean | undefined;
+                readonly providerMetadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            }[];
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "catalog.skillsChanged";
+        readonly payload: {
+            readonly cwd: string | null;
+            readonly skills: readonly {
+                readonly name: string;
+                readonly description?: string | undefined;
+                readonly shortDescription?: string | undefined;
+                readonly displayName?: string | undefined;
+                readonly iconSmall?: string | undefined;
+                readonly iconLarge?: string | undefined;
+                readonly brandColor?: string | undefined;
+                readonly defaultPrompt?: string | undefined;
+                readonly path: string;
+                readonly scope?: string | undefined;
+                readonly enabled: boolean;
+            }[];
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "catalog.pluginsChanged";
+        readonly payload: {
+            readonly plugins: readonly {
+                readonly id: string;
+                readonly name: string;
+                readonly displayName: string;
+                readonly shortDescription?: string | undefined;
+                readonly longDescription?: string | undefined;
+                readonly brandColor?: string | undefined;
+                readonly iconUrl?: string | undefined;
+                readonly iconUrlDark?: string | undefined;
+                readonly enabled: boolean;
+            }[];
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "catalog.permissionsChanged";
+        readonly payload: {
+            readonly cwd: string | null;
+            readonly permissionProfiles: readonly {
+                readonly id: string;
+                readonly description: string | null;
+                readonly allowed: boolean;
+            }[];
+            readonly approvalPresets: readonly import("@codex-app-sdk/core/surface").CodexSurfaceApprovalPreset[];
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "rateLimits.changed";
+        readonly payload: {
+            readonly rateLimits: {
+                readonly rateLimits: {
+                    readonly limitId: string | null;
+                    readonly limitName: string | null;
+                    readonly primary: {
+                        readonly usedPercent: number;
+                        readonly windowDurationMins: number | null;
+                        readonly resetsAt: number | null;
+                    } | null;
+                    readonly secondary: {
+                        readonly usedPercent: number;
+                        readonly windowDurationMins: number | null;
+                        readonly resetsAt: number | null;
+                    } | null;
+                    readonly credits: {
+                        readonly hasCredits: boolean;
+                        readonly unlimited: boolean;
+                        readonly balance: string | null;
+                    } | null;
+                    readonly individualLimit: {
+                        readonly limit: string;
+                        readonly used: string;
+                        readonly remainingPercent: number;
+                        readonly resetsAt: number;
+                    } | null;
+                    readonly planType: string | null;
+                    readonly rateLimitReachedType: string | null;
+                };
+                readonly rateLimitsByLimitId: {
+                    readonly [x: string]: {
+                        readonly limitId: string | null;
+                        readonly limitName: string | null;
+                        readonly primary: {
+                            readonly usedPercent: number;
+                            readonly windowDurationMins: number | null;
+                            readonly resetsAt: number | null;
+                        } | null;
+                        readonly secondary: {
+                            readonly usedPercent: number;
+                            readonly windowDurationMins: number | null;
+                            readonly resetsAt: number | null;
+                        } | null;
+                        readonly credits: {
+                            readonly hasCredits: boolean;
+                            readonly unlimited: boolean;
+                            readonly balance: string | null;
+                        } | null;
+                        readonly individualLimit: {
+                            readonly limit: string;
+                            readonly used: string;
+                            readonly remainingPercent: number;
+                            readonly resetsAt: number;
+                        } | null;
+                        readonly planType: string | null;
+                        readonly rateLimitReachedType: string | null;
+                    };
+                } | null;
+                readonly rateLimitResetCredits: {
+                    readonly availableCount: string;
+                    readonly credits: readonly {
+                        readonly id: string;
+                        readonly resetType: string;
+                        readonly status: string;
+                        readonly grantedAt: number;
+                        readonly expiresAt: number | null;
+                        readonly title: string | null;
+                        readonly description: string | null;
+                    }[] | null;
+                } | null;
+            } | null;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "remoteControl.statusChanged";
+        readonly payload: {
+            readonly status: {
+                readonly status: "disabled" | "connecting" | "connected" | "errored";
+                readonly serverName: string;
+                readonly installationId: string;
+                readonly environmentId: string | null;
+            };
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.selected";
+        readonly payload: {
+            readonly conversationId: string | null;
+        };
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.summaryUpserted";
+        readonly payload: {
+            readonly summary: {
+                readonly id: string;
+                readonly sessionId?: string | undefined;
+                readonly parentConversationId?: string | undefined;
+                readonly agentNickname?: string | undefined;
+                readonly agentRole?: string | undefined;
+                readonly title: string;
+                readonly preview: string;
+                readonly cwd: string;
+                readonly status: "idle" | "active" | "error";
+                readonly turnCount: number;
+                readonly createdAt: string;
+                readonly updatedAt: string;
+            };
+            readonly reason: "created" | "listed" | "resumed" | "started" | "updated";
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.summaryRemoved";
+        readonly payload: {
+            readonly reason: "archived" | "deleted";
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.historyReplaced";
+        readonly payload: {
+            readonly reason: import("@codex-app-sdk/core/surface").CodexSurfaceHistoryReason;
+            readonly messages: readonly {
+                readonly id: string;
+                readonly kind?: "compaction" | "steer" | undefined;
+                readonly role: "user" | "assistant" | "system";
+                readonly status: "complete" | "streaming" | "error";
+                readonly parts: readonly ({
+                    readonly type: "text";
+                    readonly text: string;
+                    readonly itemId?: string | undefined;
+                    readonly phase?: "commentary" | "final_answer" | undefined;
+                } | {
+                    readonly type: "reasoning";
+                    readonly summary: string;
+                    readonly itemId: string;
+                    readonly summaryIndex: number;
+                } | {
+                    readonly type: "status";
+                    readonly text: string;
+                } | {
+                    readonly type: "question";
+                    readonly historical?: boolean | undefined;
+                    readonly request: {
+                        readonly id: string;
+                        readonly kind: "ask_user";
+                        readonly conversationId: string;
+                        readonly turnId: string;
+                        readonly itemId: string;
+                        readonly payload: {
+                            readonly request: {
+                                readonly itemId: string;
+                                readonly delivery: "tool" | "async";
+                                readonly blocking: boolean;
+                                readonly questions: readonly {
+                                    readonly id: string;
+                                    readonly header: string;
+                                    readonly question: string;
+                                    readonly isOther: boolean;
+                                    readonly isSecret: boolean;
+                                    readonly options: readonly {
+                                        readonly label: string;
+                                        readonly description: string;
+                                    }[] | null;
+                                }[];
+                                readonly autoResolutionMs?: number | undefined;
+                            };
+                        };
+                    };
+                } | {
+                    readonly type: "attachment";
+                    readonly attachment: {
+                        readonly kind: "file" | "image";
+                        readonly name: string;
+                        readonly path?: string | undefined;
+                        readonly url?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    };
+                } | {
+                    readonly type: "media";
+                    readonly media: {
+                        readonly url: string;
+                        readonly alt?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly prompt?: string | undefined;
+                        readonly title?: string | undefined;
+                    };
+                    readonly itemId?: string | undefined;
+                } | {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                })[];
+                readonly createdAt?: string | undefined;
+                readonly turnId?: string | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            }[];
+            readonly threadStatus: {
+                readonly type: "notLoaded";
+            } | {
+                readonly type: "idle";
+            } | {
+                readonly type: "systemError";
+            } | {
+                readonly type: "active";
+                readonly activeFlags: readonly ("waitingOnApproval" | "waitingOnUserInput")[];
+            } | null;
+            readonly state?: {
+                readonly error: string | null;
+                readonly activeTurnId: string | null;
+                readonly answeredClientRequestIds: readonly string[];
+                readonly busy: boolean;
+                readonly contextUsage: {
+                    readonly totalTokens: number;
+                    readonly inputTokens: number;
+                    readonly cachedInputTokens: number;
+                    readonly outputTokens: number;
+                    readonly reasoningOutputTokens: number;
+                    readonly lastTotalTokens: number;
+                    readonly modelContextWindow: number | null;
+                    readonly usedPercent: number | null;
+                } | null;
+                readonly executionPlan?: {
+                    readonly turnId: string;
+                    readonly explanation: string | null;
+                    readonly steps: readonly {
+                        readonly step: string;
+                        readonly status: import("@codex-app-sdk/core/surface").CodexSurfacePlanStepStatus;
+                    }[];
+                    readonly markdown: string;
+                    readonly updatedAt: string;
+                } | null | undefined;
+                readonly historyLoading: boolean;
+                readonly historyState?: {
+                    readonly loadingStrategy: import("@codex-app-sdk/core/surface").CodexConversationLoadingStrategy;
+                    readonly hasOlder: boolean;
+                    readonly loadingOlder: boolean;
+                    readonly fullyLoaded: boolean;
+                } | undefined;
+                readonly turnGitDiff: {
+                    readonly turnId: string;
+                    readonly addedLines: number;
+                    readonly removedLines: number;
+                    readonly diff?: string | undefined;
+                    readonly updatedAt: string;
+                } | null;
+                readonly turnIds: readonly string[];
+                readonly turns: readonly {
+                    readonly id: string;
+                    readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceTurnStatus;
+                    readonly error: {
+                        readonly message: string;
+                        readonly additionalDetails: string | null;
+                        readonly codexErrorInfo: any;
+                    } | null;
+                    readonly willRetry: boolean;
+                    readonly startedAt: string | null;
+                    readonly completedAt: string | null;
+                    readonly durationMs: number | null;
+                }[];
+            } | undefined;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.historyPrepended";
+        readonly payload: {
+            readonly messages: readonly {
+                readonly id: string;
+                readonly kind?: "compaction" | "steer" | undefined;
+                readonly role: "user" | "assistant" | "system";
+                readonly status: "complete" | "streaming" | "error";
+                readonly parts: readonly ({
+                    readonly type: "text";
+                    readonly text: string;
+                    readonly itemId?: string | undefined;
+                    readonly phase?: "commentary" | "final_answer" | undefined;
+                } | {
+                    readonly type: "reasoning";
+                    readonly summary: string;
+                    readonly itemId: string;
+                    readonly summaryIndex: number;
+                } | {
+                    readonly type: "status";
+                    readonly text: string;
+                } | {
+                    readonly type: "question";
+                    readonly historical?: boolean | undefined;
+                    readonly request: {
+                        readonly id: string;
+                        readonly kind: "ask_user";
+                        readonly conversationId: string;
+                        readonly turnId: string;
+                        readonly itemId: string;
+                        readonly payload: {
+                            readonly request: {
+                                readonly itemId: string;
+                                readonly delivery: "tool" | "async";
+                                readonly blocking: boolean;
+                                readonly questions: readonly {
+                                    readonly id: string;
+                                    readonly header: string;
+                                    readonly question: string;
+                                    readonly isOther: boolean;
+                                    readonly isSecret: boolean;
+                                    readonly options: readonly {
+                                        readonly label: string;
+                                        readonly description: string;
+                                    }[] | null;
+                                }[];
+                                readonly autoResolutionMs?: number | undefined;
+                            };
+                        };
+                    };
+                } | {
+                    readonly type: "attachment";
+                    readonly attachment: {
+                        readonly kind: "file" | "image";
+                        readonly name: string;
+                        readonly path?: string | undefined;
+                        readonly url?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    };
+                } | {
+                    readonly type: "media";
+                    readonly media: {
+                        readonly url: string;
+                        readonly alt?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly prompt?: string | undefined;
+                        readonly title?: string | undefined;
+                    };
+                    readonly itemId?: string | undefined;
+                } | {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                })[];
+                readonly createdAt?: string | undefined;
+                readonly turnId?: string | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            }[];
+            readonly state?: {
+                readonly historyLoading: boolean;
+                readonly historyState?: {
+                    readonly loadingStrategy: import("@codex-app-sdk/core/surface").CodexConversationLoadingStrategy;
+                    readonly hasOlder: boolean;
+                    readonly loadingOlder: boolean;
+                    readonly fullyLoaded: boolean;
+                } | undefined;
+                readonly turnIds: readonly string[];
+                readonly turns: readonly {
+                    readonly id: string;
+                    readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceTurnStatus;
+                    readonly error: {
+                        readonly message: string;
+                        readonly additionalDetails: string | null;
+                        readonly codexErrorInfo: any;
+                    } | null;
+                    readonly willRetry: boolean;
+                    readonly startedAt: string | null;
+                    readonly completedAt: string | null;
+                    readonly durationMs: number | null;
+                }[];
+            } | undefined;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.historyStateChanged";
+        readonly payload: {
+            readonly historyLoading: boolean;
+            readonly historyState: {
+                readonly loadingStrategy: import("@codex-app-sdk/core/surface").CodexConversationLoadingStrategy;
+                readonly hasOlder: boolean;
+                readonly loadingOlder: boolean;
+                readonly fullyLoaded: boolean;
+            };
+            readonly error: string | null;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.activityChanged";
+        readonly payload: {
+            readonly threadStatus: {
+                readonly type: "notLoaded";
+            } | {
+                readonly type: "idle";
+            } | {
+                readonly type: "systemError";
+            } | {
+                readonly type: "active";
+                readonly activeFlags: readonly ("waitingOnApproval" | "waitingOnUserInput")[];
+            } | null;
+            readonly busy: boolean;
+            readonly error: string | null;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.settingsChanged";
+        readonly payload: {
+            readonly approvalPreset: import("@codex-app-sdk/core/surface").CodexSurfaceApprovalPreset | null;
+            readonly selectedModelId: string | null;
+            readonly selectedReasoningEffort: string | null;
+            readonly selectedServiceTier?: string | null | undefined;
+            readonly planMode: boolean;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.goalChanged";
+        readonly payload: {
+            readonly goal: {
+                readonly threadId: string;
+                readonly objective: string;
+                readonly status: "active" | "paused" | "blocked" | "usageLimited" | "budgetLimited" | "complete";
+                readonly tokenBudget: number | null;
+                readonly tokensUsed: number;
+                readonly timeUsedSeconds: number;
+                readonly createdAt: number;
+                readonly updatedAt: number;
+            } | null;
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.contextUsageChanged";
+        readonly payload: {
+            readonly contextUsage: {
+                readonly totalTokens: number;
+                readonly inputTokens: number;
+                readonly cachedInputTokens: number;
+                readonly outputTokens: number;
+                readonly reasoningOutputTokens: number;
+                readonly lastTotalTokens: number;
+                readonly modelContextWindow: number | null;
+                readonly usedPercent: number | null;
+            } | null;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.skillsChanged";
+        readonly payload: {
+            readonly cwd: string | null;
+            readonly skills: readonly {
+                readonly name: string;
+                readonly description?: string | undefined;
+                readonly shortDescription?: string | undefined;
+                readonly displayName?: string | undefined;
+                readonly iconSmall?: string | undefined;
+                readonly iconLarge?: string | undefined;
+                readonly brandColor?: string | undefined;
+                readonly defaultPrompt?: string | undefined;
+                readonly path: string;
+                readonly scope?: string | undefined;
+                readonly enabled: boolean;
+            }[];
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceCatalogStatus;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.permissionsChanged";
+        readonly payload: {
+            readonly cwd: string | null;
+            readonly permissionProfiles: readonly {
+                readonly id: string;
+                readonly description: string | null;
+                readonly allowed: boolean;
+            }[];
+            readonly approvalPresets: readonly import("@codex-app-sdk/core/surface").CodexSurfaceApprovalPreset[];
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.diffUpdated";
+        readonly payload: {
+            readonly diff: {
+                readonly turnId: string;
+                readonly addedLines: number;
+                readonly removedLines: number;
+                readonly diff?: string | undefined;
+                readonly updatedAt: string;
+            } | null;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "conversation.queueChanged";
+        readonly payload: {
+            readonly queuedPrompts: readonly {
+                readonly id: string;
+                readonly text: string;
+                readonly options?: {
+                    readonly attachments?: readonly ({
+                        readonly type: "image";
+                        readonly path: string;
+                        readonly detail?: "auto" | "low" | "high" | "original" | undefined;
+                        readonly name?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly previewUrl?: string | undefined;
+                    } | {
+                        readonly type: "file";
+                        readonly path: string;
+                        readonly name?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    })[] | undefined;
+                    readonly inputMethod?: "typed" | "dictated" | undefined;
+                    readonly model?: string | undefined;
+                    readonly reasoningEffort?: string | undefined;
+                    readonly serviceTier?: string | null | undefined;
+                    readonly planMode?: boolean | undefined;
+                    readonly skills?: readonly {
+                        readonly name: string;
+                        readonly path: string;
+                    }[] | undefined;
+                    readonly outputSchema?: any;
+                } | undefined;
+            }[];
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.started";
+        readonly payload: {
+            readonly realtimeSessionId: string | null;
+            readonly version: import("@codex-app-sdk/core/surface").CodexRealtimeVersion;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.itemAdded";
+        readonly payload: {
+            readonly item: any;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.itemStarted";
+        readonly payload: {
+            readonly item: any;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.itemCompleted";
+        readonly payload: {
+            readonly item: any;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.itemTranscriptDelta";
+        readonly payload: {
+            readonly itemId: string;
+            readonly delta: string;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.transcriptDelta";
+        readonly payload: {
+            readonly role: string;
+            readonly delta: string;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.transcriptCompleted";
+        readonly payload: {
+            readonly role: string;
+            readonly text: string;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.audioDelta";
+        readonly payload: {
+            readonly audio: {
+                readonly data: {
+                    readonly [x: number]: number;
+                    readonly BYTES_PER_ELEMENT: number;
+                    readonly buffer: {
+                        readonly byteLength: number;
+                        readonly slice: (begin?: number, end?: number) => ArrayBuffer;
+                        readonly [Symbol.toStringTag]: "ArrayBuffer";
+                    } | {
+                        readonly byteLength: number;
+                        readonly slice: (begin?: number, end?: number) => SharedArrayBuffer;
+                        readonly [Symbol.toStringTag]: "SharedArrayBuffer";
+                    };
+                    readonly byteLength: number;
+                    readonly byteOffset: number;
+                    readonly copyWithin: (target: number, start: number, end?: number) => Uint8Array<ArrayBufferLike>;
+                    readonly every: (predicate: (value: number, index: number, array: Uint8Array<ArrayBufferLike>) => unknown, thisArg?: any) => boolean;
+                    readonly fill: (value: number, start?: number, end?: number) => Uint8Array<ArrayBufferLike>;
+                    readonly filter: (predicate: (value: number, index: number, array: Uint8Array<ArrayBufferLike>) => any, thisArg?: any) => Uint8Array<ArrayBuffer>;
+                    readonly find: (predicate: (value: number, index: number, obj: Uint8Array<ArrayBufferLike>) => boolean, thisArg?: any) => number | undefined;
+                    readonly findIndex: (predicate: (value: number, index: number, obj: Uint8Array<ArrayBufferLike>) => boolean, thisArg?: any) => number;
+                    readonly forEach: (callbackfn: (value: number, index: number, array: Uint8Array<ArrayBufferLike>) => void, thisArg?: any) => void;
+                    readonly indexOf: (searchElement: number, fromIndex?: number) => number;
+                    readonly join: (separator?: string) => string;
+                    readonly lastIndexOf: (searchElement: number, fromIndex?: number) => number;
+                    readonly length: number;
+                    readonly map: (callbackfn: (value: number, index: number, array: Uint8Array<ArrayBufferLike>) => number, thisArg?: any) => Uint8Array<ArrayBuffer>;
+                    readonly reduce: {
+                        (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => number): number;
+                        (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => number, initialValue: number): number;
+                        <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => U, initialValue: U): U;
+                    };
+                    readonly reduceRight: {
+                        (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => number): number;
+                        (callbackfn: (previousValue: number, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => number, initialValue: number): number;
+                        <U>(callbackfn: (previousValue: U, currentValue: number, currentIndex: number, array: Uint8Array<ArrayBufferLike>) => U, initialValue: U): U;
+                    };
+                    readonly reverse: () => Uint8Array<ArrayBufferLike>;
+                    readonly set: (array: ArrayLike<number>, offset?: number) => void;
+                    readonly slice: (start?: number, end?: number) => Uint8Array<ArrayBuffer>;
+                    readonly some: (predicate: (value: number, index: number, array: Uint8Array<ArrayBufferLike>) => unknown, thisArg?: any) => boolean;
+                    readonly sort: (compareFn?: ((a: number, b: number) => number) | undefined) => Uint8Array<ArrayBufferLike>;
+                    readonly subarray: (begin?: number, end?: number) => Uint8Array<ArrayBufferLike>;
+                    readonly toLocaleString: {
+                        (): string;
+                        (locales: string | string[], options?: Intl.NumberFormatOptions): string;
+                    };
+                    readonly toString: () => string;
+                    readonly valueOf: () => Uint8Array<ArrayBufferLike>;
+                    readonly entries: () => ArrayIterator<[number, number]>;
+                    readonly keys: () => ArrayIterator<number>;
+                    readonly values: () => ArrayIterator<number>;
+                    readonly includes: (searchElement: number, fromIndex?: number) => boolean;
+                    readonly at: (index: number) => number | undefined;
+                    readonly [Symbol.iterator]: () => ArrayIterator<number>;
+                    readonly [Symbol.toStringTag]: "Uint8Array";
+                };
+                readonly sampleRate: number;
+                readonly numChannels: number;
+                readonly samplesPerChannel: number | null;
+                readonly itemId: string | null;
+            };
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.sdp";
+        readonly payload: {
+            readonly sdp: string;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.error";
+        readonly payload: {
+            readonly message: string;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "realtime.closed";
+        readonly payload: {
+            readonly reason: string | null;
+        };
+        readonly conversationId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "turn.started";
+        readonly payload: {
+            readonly startedAt: string;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "turn.completed";
+        readonly payload: {
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceTurnStatus;
+            readonly error: {
+                readonly message: string;
+                readonly additionalDetails: string | null;
+                readonly codexErrorInfo: any;
+            } | null;
+            readonly willRetry: boolean;
+            readonly startedAt: string | null;
+            readonly completedAt: string | null;
+            readonly durationMs: number | null;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "turn.error";
+        readonly payload: {
+            readonly error: {
+                readonly message: string;
+                readonly additionalDetails: string | null;
+                readonly codexErrorInfo: any;
+            };
+            readonly willRetry: boolean;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "message.appended";
+        readonly payload: {
+            readonly message: {
+                readonly id: string;
+                readonly kind?: "compaction" | "steer" | undefined;
+                readonly role: "user" | "assistant" | "system";
+                readonly status: "complete" | "streaming" | "error";
+                readonly parts: readonly ({
+                    readonly type: "text";
+                    readonly text: string;
+                    readonly itemId?: string | undefined;
+                    readonly phase?: "commentary" | "final_answer" | undefined;
+                } | {
+                    readonly type: "reasoning";
+                    readonly summary: string;
+                    readonly itemId: string;
+                    readonly summaryIndex: number;
+                } | {
+                    readonly type: "status";
+                    readonly text: string;
+                } | {
+                    readonly type: "question";
+                    readonly historical?: boolean | undefined;
+                    readonly request: {
+                        readonly id: string;
+                        readonly kind: "ask_user";
+                        readonly conversationId: string;
+                        readonly turnId: string;
+                        readonly itemId: string;
+                        readonly payload: {
+                            readonly request: {
+                                readonly itemId: string;
+                                readonly delivery: "tool" | "async";
+                                readonly blocking: boolean;
+                                readonly questions: readonly {
+                                    readonly id: string;
+                                    readonly header: string;
+                                    readonly question: string;
+                                    readonly isOther: boolean;
+                                    readonly isSecret: boolean;
+                                    readonly options: readonly {
+                                        readonly label: string;
+                                        readonly description: string;
+                                    }[] | null;
+                                }[];
+                                readonly autoResolutionMs?: number | undefined;
+                            };
+                        };
+                    };
+                } | {
+                    readonly type: "attachment";
+                    readonly attachment: {
+                        readonly kind: "file" | "image";
+                        readonly name: string;
+                        readonly path?: string | undefined;
+                        readonly url?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    };
+                } | {
+                    readonly type: "media";
+                    readonly media: {
+                        readonly url: string;
+                        readonly alt?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly prompt?: string | undefined;
+                        readonly title?: string | undefined;
+                    };
+                    readonly itemId?: string | undefined;
+                } | {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                })[];
+                readonly createdAt?: string | undefined;
+                readonly turnId?: string | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "message.delta";
+        readonly payload: {
+            readonly messageId: string;
+            readonly itemId: string;
+            readonly delta: string;
+            readonly phase?: "commentary" | "final_answer" | undefined;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "message.updated";
+        readonly payload: {
+            readonly message: {
+                readonly id: string;
+                readonly kind?: "compaction" | "steer" | undefined;
+                readonly role: "user" | "assistant" | "system";
+                readonly status: "complete" | "streaming" | "error";
+                readonly parts: readonly ({
+                    readonly type: "text";
+                    readonly text: string;
+                    readonly itemId?: string | undefined;
+                    readonly phase?: "commentary" | "final_answer" | undefined;
+                } | {
+                    readonly type: "reasoning";
+                    readonly summary: string;
+                    readonly itemId: string;
+                    readonly summaryIndex: number;
+                } | {
+                    readonly type: "status";
+                    readonly text: string;
+                } | {
+                    readonly type: "question";
+                    readonly historical?: boolean | undefined;
+                    readonly request: {
+                        readonly id: string;
+                        readonly kind: "ask_user";
+                        readonly conversationId: string;
+                        readonly turnId: string;
+                        readonly itemId: string;
+                        readonly payload: {
+                            readonly request: {
+                                readonly itemId: string;
+                                readonly delivery: "tool" | "async";
+                                readonly blocking: boolean;
+                                readonly questions: readonly {
+                                    readonly id: string;
+                                    readonly header: string;
+                                    readonly question: string;
+                                    readonly isOther: boolean;
+                                    readonly isSecret: boolean;
+                                    readonly options: readonly {
+                                        readonly label: string;
+                                        readonly description: string;
+                                    }[] | null;
+                                }[];
+                                readonly autoResolutionMs?: number | undefined;
+                            };
+                        };
+                    };
+                } | {
+                    readonly type: "attachment";
+                    readonly attachment: {
+                        readonly kind: "file" | "image";
+                        readonly name: string;
+                        readonly path?: string | undefined;
+                        readonly url?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    };
+                } | {
+                    readonly type: "media";
+                    readonly media: {
+                        readonly url: string;
+                        readonly alt?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly prompt?: string | undefined;
+                        readonly title?: string | undefined;
+                    };
+                    readonly itemId?: string | undefined;
+                } | {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                })[];
+                readonly createdAt?: string | undefined;
+                readonly turnId?: string | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "tool.started";
+        readonly payload: {
+            readonly messageId: string;
+            readonly toolPart: {
+                readonly type: "tool";
+                readonly id: string;
+                readonly title: string;
+                readonly kind?: string | undefined;
+                readonly status: "running" | "completed" | "failed";
+                readonly statusText?: string | undefined;
+                readonly body?: string | undefined;
+                readonly input?: Readonly<unknown> | undefined;
+                readonly output?: Readonly<unknown> | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "tool.updated";
+        readonly payload: {
+            readonly messageId: string;
+            readonly update: {
+                readonly itemId: string;
+                readonly title?: string | undefined;
+                readonly status?: import("@codex-app-sdk/core/surface").SurfaceMessageToolPart["status"] | undefined;
+                readonly statusText?: string | null | undefined;
+                readonly body?: string | undefined;
+                readonly bodyDelta?: string | undefined;
+                readonly bodyAppend?: string | undefined;
+                readonly input?: Readonly<unknown> | undefined;
+                readonly output?: Readonly<unknown> | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+                readonly fallbackToolPart?: {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "tool.completed";
+        readonly payload: {
+            readonly messageId: string;
+            readonly toolPart: {
+                readonly type: "tool";
+                readonly id: string;
+                readonly title: string;
+                readonly kind?: string | undefined;
+                readonly status: "running" | "completed" | "failed";
+                readonly statusText?: string | undefined;
+                readonly body?: string | undefined;
+                readonly input?: Readonly<unknown> | undefined;
+                readonly output?: Readonly<unknown> | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "file.activity";
+        readonly payload: {
+            readonly messageId: string;
+            readonly itemId: string;
+            readonly path: string;
+            readonly action: import("@codex-app-sdk/core/surface").CodexSurfaceFileActivityAction;
+            readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceFileActivityStatus;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "subagent.toolCallChanged";
+        readonly payload: {
+            readonly lifecycle: import("@codex-app-sdk/core/surface").CodexSurfaceSubagentItemLifecycle;
+            readonly toolCall: {
+                readonly id: string;
+                readonly tool: import("@codex-app-sdk/core/surface").CodexSurfaceSubagentTool;
+                readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceSubagentToolCallStatus;
+                readonly senderConversationId: string;
+                readonly receiverConversationIds: readonly string[];
+                readonly prompt: string | null;
+                readonly model: string | null;
+                readonly reasoningEffort: string | null;
+                readonly agentStates: {
+                    readonly [x: string]: {
+                        readonly status: import("@codex-app-sdk/core/surface").CodexSurfaceSubagentStatus;
+                        readonly message: string | null;
+                    };
+                };
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "subagent.activity";
+        readonly payload: {
+            readonly lifecycle: import("@codex-app-sdk/core/surface").CodexSurfaceSubagentItemLifecycle;
+            readonly activity: {
+                readonly id: string;
+                readonly kind: "started" | "interacted" | "interrupted" | "completed";
+                readonly agentConversationId: string;
+                readonly agentPath: string;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "plan.delta";
+        readonly payload: {
+            readonly itemId: string;
+            readonly delta: string;
+            readonly markdown: string;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "plan.updated";
+        readonly payload: {
+            readonly explanation: string | null;
+            readonly steps: readonly {
+                readonly step: string;
+                readonly status: import("@codex-app-sdk/core/surface").CodexSurfacePlanStepStatus;
+            }[];
+            readonly markdown: string;
+            readonly status: "running" | "completed";
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "plan.completed";
+        readonly payload: {
+            readonly itemId: string;
+            readonly markdown: string;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "context.compactionStarted";
+        readonly payload: {
+            readonly itemId: string | null;
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "context.compactionCompleted";
+        readonly payload: {
+            readonly itemId: string | null;
+            readonly message: {
+                readonly id: string;
+                readonly kind?: "compaction" | "steer" | undefined;
+                readonly role: "user" | "assistant" | "system";
+                readonly status: "complete" | "streaming" | "error";
+                readonly parts: readonly ({
+                    readonly type: "text";
+                    readonly text: string;
+                    readonly itemId?: string | undefined;
+                    readonly phase?: "commentary" | "final_answer" | undefined;
+                } | {
+                    readonly type: "reasoning";
+                    readonly summary: string;
+                    readonly itemId: string;
+                    readonly summaryIndex: number;
+                } | {
+                    readonly type: "status";
+                    readonly text: string;
+                } | {
+                    readonly type: "question";
+                    readonly historical?: boolean | undefined;
+                    readonly request: {
+                        readonly id: string;
+                        readonly kind: "ask_user";
+                        readonly conversationId: string;
+                        readonly turnId: string;
+                        readonly itemId: string;
+                        readonly payload: {
+                            readonly request: {
+                                readonly itemId: string;
+                                readonly delivery: "tool" | "async";
+                                readonly blocking: boolean;
+                                readonly questions: readonly {
+                                    readonly id: string;
+                                    readonly header: string;
+                                    readonly question: string;
+                                    readonly isOther: boolean;
+                                    readonly isSecret: boolean;
+                                    readonly options: readonly {
+                                        readonly label: string;
+                                        readonly description: string;
+                                    }[] | null;
+                                }[];
+                                readonly autoResolutionMs?: number | undefined;
+                            };
+                        };
+                    };
+                } | {
+                    readonly type: "attachment";
+                    readonly attachment: {
+                        readonly kind: "file" | "image";
+                        readonly name: string;
+                        readonly path?: string | undefined;
+                        readonly url?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                    };
+                } | {
+                    readonly type: "media";
+                    readonly media: {
+                        readonly url: string;
+                        readonly alt?: string | undefined;
+                        readonly mimeType?: string | undefined;
+                        readonly prompt?: string | undefined;
+                        readonly title?: string | undefined;
+                    };
+                    readonly itemId?: string | undefined;
+                } | {
+                    readonly type: "tool";
+                    readonly id: string;
+                    readonly title: string;
+                    readonly kind?: string | undefined;
+                    readonly status: "running" | "completed" | "failed";
+                    readonly statusText?: string | undefined;
+                    readonly body?: string | undefined;
+                    readonly input?: Readonly<unknown> | undefined;
+                    readonly output?: Readonly<unknown> | undefined;
+                    readonly metadata?: {
+                        readonly [x: string]: Readonly<unknown>;
+                    } | undefined;
+                })[];
+                readonly createdAt?: string | undefined;
+                readonly turnId?: string | undefined;
+                readonly metadata?: {
+                    readonly [x: string]: Readonly<unknown>;
+                } | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId: string;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "approval.requested";
+        readonly payload: {
+            readonly approval: {
+                readonly id: string;
+                readonly kind: "command" | "file-change" | "permissions";
+                readonly conversationId: string;
+                readonly turnId?: string | undefined;
+                readonly itemId: string;
+                readonly title: string;
+                readonly description?: string | undefined;
+                readonly command?: string | undefined;
+                readonly cwd?: string | undefined;
+                readonly requestedPermissions?: readonly ({
+                    readonly kind: "filesystem";
+                    readonly access: "read" | "write" | "deny";
+                    readonly path: string;
+                } | {
+                    readonly kind: "network";
+                    readonly enabled: boolean;
+                    readonly host?: string | undefined;
+                    readonly protocol?: string | undefined;
+                })[] | undefined;
+                readonly allowedScopes?: readonly CodexSurfaceApprovalScope[] | undefined;
+                readonly canDeny?: boolean | undefined;
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "approval.resolved";
+        readonly payload: {
+            readonly approval: {
+                readonly id: string;
+                readonly kind: "command" | "file-change" | "permissions";
+                readonly conversationId: string;
+                readonly turnId?: string | undefined;
+                readonly itemId: string;
+                readonly title: string;
+                readonly description?: string | undefined;
+                readonly command?: string | undefined;
+                readonly cwd?: string | undefined;
+                readonly requestedPermissions?: readonly ({
+                    readonly kind: "filesystem";
+                    readonly access: "read" | "write" | "deny";
+                    readonly path: string;
+                } | {
+                    readonly kind: "network";
+                    readonly enabled: boolean;
+                    readonly host?: string | undefined;
+                    readonly protocol?: string | undefined;
+                })[] | undefined;
+                readonly allowedScopes?: readonly CodexSurfaceApprovalScope[] | undefined;
+                readonly canDeny?: boolean | undefined;
+            };
+            readonly decision: CodexSurfaceApprovalDecision | null;
+            readonly scope: CodexSurfaceApprovalScope | null;
+            readonly reason: "host" | "server" | "conversation_closed" | "conversation_removed" | "surface_disconnected";
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "clientRequest.requested";
+        readonly payload: {
+            readonly request: {
+                readonly id: string;
+                readonly kind: "ask_user";
+                readonly conversationId: string;
+                readonly turnId: string;
+                readonly itemId: string;
+                readonly payload: {
+                    readonly request: {
+                        readonly itemId: string;
+                        readonly delivery: "tool" | "async";
+                        readonly blocking: boolean;
+                        readonly questions: readonly {
+                            readonly id: string;
+                            readonly header: string;
+                            readonly question: string;
+                            readonly isOther: boolean;
+                            readonly isSecret: boolean;
+                            readonly options: readonly {
+                                readonly label: string;
+                                readonly description: string;
+                            }[] | null;
+                        }[];
+                        readonly autoResolutionMs?: number | undefined;
+                    };
+                };
+            } | {
+                readonly id: string;
+                readonly kind: "confirm_tool";
+                readonly conversationId: string;
+                readonly turnId: string | null;
+                readonly itemId: string;
+                readonly payload: {
+                    readonly confirmation: {
+                        readonly argumentsPreview: string;
+                        readonly integrationId: string;
+                        readonly integrationName: string;
+                        readonly summary: string;
+                        readonly toolName: string;
+                        readonly allowConversation?: boolean | undefined;
+                        readonly allowAlways?: boolean | undefined;
+                    };
+                };
+            };
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | {
+        readonly seq: number;
+        readonly occurredAt: string;
+        readonly origin: import("@codex-app-sdk/core/surface").CodexSurfaceEventOrigin;
+        readonly type: "clientRequest.resolved";
+        readonly payload: {
+            readonly request: {
+                readonly id: string;
+                readonly kind: "ask_user";
+                readonly conversationId: string;
+                readonly turnId: string;
+                readonly itemId: string;
+                readonly payload: {
+                    readonly request: {
+                        readonly itemId: string;
+                        readonly delivery: "tool" | "async";
+                        readonly blocking: boolean;
+                        readonly questions: readonly {
+                            readonly id: string;
+                            readonly header: string;
+                            readonly question: string;
+                            readonly isOther: boolean;
+                            readonly isSecret: boolean;
+                            readonly options: readonly {
+                                readonly label: string;
+                                readonly description: string;
+                            }[] | null;
+                        }[];
+                        readonly autoResolutionMs?: number | undefined;
+                    };
+                };
+            } | {
+                readonly id: string;
+                readonly kind: "confirm_tool";
+                readonly conversationId: string;
+                readonly turnId: string | null;
+                readonly itemId: string;
+                readonly payload: {
+                    readonly confirmation: {
+                        readonly argumentsPreview: string;
+                        readonly integrationId: string;
+                        readonly integrationName: string;
+                        readonly summary: string;
+                        readonly toolName: string;
+                        readonly allowConversation?: boolean | undefined;
+                        readonly allowAlways?: boolean | undefined;
+                    };
+                };
+            };
+            readonly response: {
+                readonly id: string;
+                readonly payload?: {
+                    readonly answers?: {
+                        readonly [x: string]: {
+                            readonly answers: readonly string[];
+                        };
+                    } | undefined;
+                    readonly cancelled?: boolean | undefined;
+                    readonly decision?: (import("@codex-app-sdk/core/surface").CodexSurfaceToolConfirmationDecision | null) | undefined;
+                } | undefined;
+            } | null;
+            readonly reason: "host" | "server" | "conversation_closed" | "conversation_removed" | "surface_disconnected";
+        };
+        readonly conversationId: string;
+        readonly turnId?: string | undefined;
+    } | null>>;
+    answeredClientRequestIds: ReadonlySet<string>;
+    onEvent: (listener: (event: CodexSurfaceEvent) => void) => () => boolean;
+    archiveConversation: (conversationId: string) => Promise<CodexSurfaceSnapshot>;
+    cancelLogin: (loginId?: string) => Promise<CodexSurfaceSnapshot>;
+    clearGoal: () => Promise<CodexSurfaceSnapshot>;
+    compactConversation: () => Promise<CodexSurfaceSnapshot>;
+    continueInterruptedTurn: () => Promise<CodexSurfaceSnapshot>;
+    connect: () => Promise<CodexSurfaceSnapshot>;
+    createConversation: (options?: CreateCodexRendererConversationOptions) => Promise<CodexSurfaceSnapshot>;
+    deleteConversation: (conversationId: string) => Promise<CodexSurfaceSnapshot>;
+    deleteTurn: (turnId: string) => Promise<CodexSurfaceSnapshot>;
+    deleteQueuedPrompt: (promptId: string) => Promise<CodexSurfaceSnapshot>;
+    updateQueuedPrompt: (promptId: string, prompt: string) => Promise<CodexSurfaceSnapshot>;
+    editTurn: (turnId: string, content: string) => Promise<CodexSurfaceSnapshot>;
+    forkTurn: (turnId: string) => Promise<CodexSurfaceSnapshot>;
+    interrupt: () => Promise<CodexSurfaceSnapshot>;
+    listConversations: (options?: ListCodexConversationsOptions) => Promise<import("@codex-app-sdk/core/surface").CodexConversationSummary[]>;
+    listModels: (options?: ListCodexModelsOptions) => Promise<import("@codex-app-sdk/core/surface").CodexSurfaceModel[]>;
+    logout: () => Promise<CodexSurfaceSnapshot>;
+    readConversationHistory: (conversationId?: string) => Promise<CodexConversationHistory>;
+    readConversationPromptHistory: (conversationId?: string) => Promise<CodexConversationPromptHistory>;
+    loadOlderConversationHistory: (conversationId?: string) => Promise<import("@codex-app-sdk/core/surface").CodexConversationHistoryPage>;
+    refreshAccount: () => Promise<CodexSurfaceSnapshot>;
+    refreshConversations: () => Promise<CodexSurfaceSnapshot>;
+    renameConversation: (title: string) => Promise<CodexSurfaceSnapshot>;
+    respondToClientRequest: (response: CodexSurfaceClientRequestResponse) => Promise<CodexSurfaceSnapshot>;
+    resolveApproval: (approvalId: string, decision: CodexSurfaceApprovalDecision, scope?: CodexSurfaceApprovalScope) => Promise<CodexSurfaceSnapshot>;
+    retryTurn: (turnId: string) => Promise<CodexSurfaceSnapshot>;
+    setGoal: (objective: string, tokenBudget?: number | null) => Promise<CodexSurfaceSnapshot>;
+    selectConversation: (conversationId: string) => Promise<CodexSurfaceSnapshot>;
+    sendMessage: (prompt: string, options?: CodexRendererSendMessageOptions) => Promise<CodexSurfaceSnapshot>;
+    startReview: (options?: StartCodexReviewOptions) => Promise<CodexSurfaceSnapshot>;
+    startChatGptDeviceCodeLogin: () => Promise<import("@codex-app-sdk/core/surface").CodexSurfaceChatGptDeviceCodeLogin>;
+    startChatGptLogin: () => Promise<import("@codex-app-sdk/core/surface").CodexSurfaceChatGptLogin>;
+    steerMessage: (prompt: string, options?: CodexRendererSendMessageOptions) => Promise<CodexSurfaceSnapshot>;
+    steerQueuedPrompt: (promptId: string, prompt?: string) => Promise<CodexSurfaceSnapshot>;
+    unarchiveConversation: (conversationId: string) => Promise<CodexSurfaceSnapshot>;
+    updateConversationSettings: (settings: UpdateCodexConversationSettings) => Promise<CodexSurfaceSnapshot>;
+};
+export type CodexSurfaceController = ReturnType<typeof useCodexSurface>;
+//# sourceMappingURL=use-codex-surface.d.ts.map