@jrkropp/codex-js 0.1.2 → 0.1.4

package/dist/protocol-mpBcYHrm.d.ts

@@ -0,0 +1,1655 @@
+type CodexBrand<TValue, TBrand extends string> = TValue & {
+    readonly __codexBrand: TBrand;
+};
+type ThreadId = CodexBrand<string, "ThreadId">;
+declare function asThreadId(value: string): ThreadId;
+
+declare const ModeKind: {
+    readonly Plan: "plan";
+    readonly Default: "default";
+};
+type ModeKind = (typeof ModeKind)[keyof typeof ModeKind];
+type ReasoningEffort = string;
+type CollaborationModeSettings = {
+    model: string;
+    reasoning_effort: ReasoningEffort | null;
+    developer_instructions: string | null;
+};
+type CollaborationMode = {
+    mode: ModeKind;
+    settings: CollaborationModeSettings;
+};
+type CollaborationModeMask = {
+    name: string;
+    mode?: ModeKind | null;
+    model?: string | null;
+    reasoning_effort?: ReasoningEffort | null | undefined;
+    developer_instructions?: string | null | undefined;
+};
+declare const TUI_VISIBLE_COLLABORATION_MODES: readonly ["default", "plan"];
+declare function allowsRequestUserInput(mode: ModeKind): boolean;
+declare function modeDisplayName(mode: ModeKind): string;
+declare function collaborationModeWithUpdates(collaborationMode: CollaborationMode, model?: string | null, effort?: ReasoningEffort | null | undefined, developerInstructions?: string | null | undefined): CollaborationMode;
+declare function applyCollaborationModeMask(collaborationMode: CollaborationMode, mask: CollaborationModeMask): CollaborationMode;
+declare function collaborationModeForModel(model: string, effort?: ReasoningEffort | null, mode?: ModeKind, developerInstructions?: string | null): CollaborationMode;
+
+declare const ThreadMemoryMode: {
+    readonly Enabled: "Enabled";
+    readonly Disabled: "Disabled";
+};
+type ThreadMemoryMode = (typeof ThreadMemoryMode)[keyof typeof ThreadMemoryMode];
+declare const ThreadMemoryModeSessionMetaValue: {
+    readonly Enabled: "enabled";
+    readonly Disabled: "disabled";
+};
+type ThreadMemoryModeSessionMetaValue = (typeof ThreadMemoryModeSessionMetaValue)[keyof typeof ThreadMemoryModeSessionMetaValue];
+declare function threadMemoryModeToSessionMetaValue(mode: ThreadMemoryMode): ThreadMemoryModeSessionMetaValue;
+type MemoryCitation = {
+    entries: MemoryCitationEntry[];
+    rolloutIds: string[];
+};
+type MemoryCitationEntry = {
+    path: string;
+    lineStart: number;
+    lineEnd: number;
+    note: string;
+};
+
+type AgentMessageContent = {
+    type: "Text";
+    text: string;
+};
+type UserMessageTurnItem = {
+    type: "UserMessage";
+    id: string;
+    content: UserInput[];
+};
+type HookPromptFragment = {
+    text: string;
+    hookRunId: string;
+};
+type HookPromptTurnItem = {
+    type: "HookPrompt";
+    id: string;
+    fragments: HookPromptFragment[];
+};
+type AgentMessageTurnItem = {
+    type: "AgentMessage";
+    id: string;
+    content: AgentMessageContent[];
+    phase?: string | null;
+    memory_citation?: MemoryCitation | null;
+};
+type PlanTurnItem = {
+    type: "Plan";
+    id: string;
+    text: string;
+};
+type ReasoningTurnItem = {
+    type: "Reasoning";
+    id: string;
+    summary_text: string[];
+    raw_content: string[];
+};
+type WebSearchAction = {
+    type: "search";
+    query?: string;
+    queries?: string[];
+} | {
+    type: "open_page";
+    url?: string;
+} | {
+    type: "find_in_page";
+    url?: string;
+    pattern?: string;
+} | {
+    type: "other";
+};
+type WebSearchTurnItem = {
+    type: "WebSearch";
+    id: string;
+    query: string;
+    action: WebSearchAction;
+};
+type ImageViewTurnItem = {
+    type: "ImageView";
+    id: string;
+    path: string;
+};
+type ImageGenerationTurnItem = {
+    type: "ImageGeneration";
+    id: string;
+    status: string;
+    revised_prompt?: string;
+    result: string;
+    saved_path?: string;
+};
+type FileChange = {
+    type: "add";
+    content: string;
+} | {
+    type: "delete";
+    content: string;
+} | {
+    type: "update";
+    unified_diff: string;
+    move_path: string | null;
+};
+type PatchApplyStatus = "completed" | "failed" | "declined";
+type FileChangeTurnItem = {
+    type: "FileChange";
+    id: string;
+    changes: Record<string, FileChange>;
+    status?: PatchApplyStatus | null;
+    auto_approved?: boolean;
+    stdout?: string;
+    stderr?: string;
+};
+type CommandExecutionStatus = "in_progress" | "completed" | "failed" | "cancelled";
+type CommandExecutionTurnItem = {
+    type: "CommandExecution";
+    id: string;
+    command: string[];
+    cwd: string;
+    status: CommandExecutionStatus;
+    stdout?: string;
+    stderr?: string;
+    exit_code?: number | null;
+    duration_ms?: number | null;
+};
+type McpToolCallStatus = "inProgress" | "completed" | "failed";
+type McpToolCallError = {
+    message: string;
+};
+type McpToolCallTurnItem = {
+    type: "McpToolCall";
+    id: string;
+    server: string;
+    tool: string;
+    arguments: unknown;
+    mcpAppResourceUri?: string;
+    status: McpToolCallStatus;
+    result?: unknown;
+    error?: McpToolCallError;
+    duration?: string;
+};
+type DynamicToolCallStatus = "inProgress" | "completed" | "failed";
+type DynamicToolCallTurnItem = {
+    type: "DynamicToolCall";
+    id: string;
+    namespace?: string | null;
+    tool: string;
+    arguments: unknown;
+    status: DynamicToolCallStatus;
+    content_items?: unknown[] | null;
+    success?: boolean | null;
+    duration?: string | null;
+};
+type ContextCompactionTurnItem = {
+    type: "ContextCompaction";
+    id: string;
+};
+type TurnItem = UserMessageTurnItem | HookPromptTurnItem | AgentMessageTurnItem | PlanTurnItem | ReasoningTurnItem | WebSearchTurnItem | ImageViewTurnItem | ImageGenerationTurnItem | CommandExecutionTurnItem | FileChangeTurnItem | McpToolCallTurnItem | DynamicToolCallTurnItem | ContextCompactionTurnItem;
+
+type StreamOutput<T = string> = {
+    text: T;
+    truncated_after_lines?: number | null;
+};
+type ExecToolCallOutput = {
+    exit_code: number;
+    stdout: StreamOutput<string>;
+    stderr: StreamOutput<string>;
+    aggregated_output: StreamOutput<string>;
+    duration_ms: number;
+    timed_out: boolean;
+};
+declare function streamOutput(text: string): StreamOutput<string>;
+declare function execToolCallOutput(input: {
+    exit_code: number;
+    stdout?: string;
+    stderr?: string;
+    duration_ms?: number;
+    timed_out?: boolean;
+}): ExecToolCallOutput;
+
+type DynamicToolSpec = {
+    namespace?: string | null;
+    name: string;
+    description: string;
+    input_schema: unknown;
+    defer_loading?: boolean;
+};
+type DynamicToolCallRequest = {
+    call_id: string;
+    turn_id: string;
+    started_at_ms?: number;
+    namespace?: string | null;
+    tool: string;
+    arguments: unknown;
+};
+type DynamicToolCallOutputContentItem = {
+    type: "inputText";
+    text: string;
+} | {
+    type: "inputImage";
+    imageUrl: string;
+};
+type DynamicToolResponse = {
+    content_items: DynamicToolCallOutputContentItem[];
+    success: boolean;
+};
+type DynamicToolCallResponseEvent = {
+    call_id: string;
+    turn_id: string;
+    completed_at_ms?: number;
+    namespace?: string | null;
+    tool: string;
+    arguments: unknown;
+    content_items: DynamicToolCallOutputContentItem[];
+    success: boolean;
+    error?: string | null;
+    duration: string;
+};
+type DynamicToolSpecWire = {
+    namespace?: string | null;
+    name: string;
+    description: string;
+    inputSchema: unknown;
+    deferLoading?: boolean;
+    exposeToContext?: boolean;
+};
+declare function dynamicToolSpecToWire(spec: DynamicToolSpec): DynamicToolSpecWire;
+declare function dynamicToolSpecFromWire(spec: DynamicToolSpecWire): DynamicToolSpec;
+
+type FreeformTool = {
+    name: string;
+    description: string;
+    format: {
+        type: string;
+        syntax: string;
+        definition: string;
+    };
+};
+type ResponsesApiTool = {
+    name: string;
+    description: string;
+    strict: boolean;
+    defer_loading?: boolean;
+    parameters: JsonSchema;
+};
+type ResponsesApiFunctionTool = ResponsesApiTool & {
+    type: "function";
+};
+type LoadableToolSpec = ResponsesApiFunctionTool | (ResponsesApiNamespace & {
+    type: "namespace";
+});
+type ResponsesApiNamespace = {
+    name: string;
+    description: string;
+    tools: ResponsesApiNamespaceTool[];
+};
+type ResponsesApiNamespaceTool = ResponsesApiFunctionTool;
+declare function default_namespace_description(namespaceName: string): string;
+declare function dynamic_tool_to_responses_api_tool(tool: DynamicToolSpec): ResponsesApiTool;
+declare function dynamic_tool_to_loadable_tool_spec(tool: DynamicToolSpec): LoadableToolSpec;
+declare function coalesce_loadable_tool_specs(specs: Iterable<LoadableToolSpec>): LoadableToolSpec[];
+
+type JsonSchema = unknown;
+type ToolSpec = LoadableToolSpec | {
+    type: "tool_search";
+    execution: string;
+    description: string;
+    parameters: JsonSchema;
+} | {
+    type: "local_shell";
+} | {
+    type: "image_generation";
+    output_format: string;
+} | {
+    type: "web_search";
+    external_web_access?: boolean;
+    filters?: unknown;
+    user_location?: unknown;
+    search_context_size?: unknown;
+    search_content_types?: string[];
+} | (FreeformTool & {
+    type: "custom";
+});
+type ConfiguredToolSpec = {
+    spec: ToolSpec;
+    supports_parallel_tool_calls: boolean;
+};
+declare function toolSpecName(spec: ToolSpec): string;
+declare function create_tools_json_for_responses_api(tools: readonly ToolSpec[]): ToolSpec[];
+declare function assertValidResponsesToolSpecs(specs: readonly ToolSpec[]): asserts specs is ToolSpec[];
+
+declare const REQUEST_USER_INPUT_TOOL_NAME = "request_user_input";
+type RequestUserInputQuestionOption = {
+    label: string;
+    description: string;
+};
+type RequestUserInputQuestion = {
+    id: string;
+    header: string;
+    question: string;
+    isOther?: boolean;
+    isSecret?: boolean;
+    options?: RequestUserInputQuestionOption[];
+};
+type NormalizedRequestUserInputQuestion = {
+    id: string;
+    header: string;
+    question: string;
+    isOther: boolean;
+    isSecret: boolean;
+    options: RequestUserInputQuestionOption[];
+};
+type RequestUserInputArgs = {
+    questions: RequestUserInputQuestion[];
+};
+type NormalizedRequestUserInputArgs = {
+    questions: NormalizedRequestUserInputQuestion[];
+};
+type RequestUserInputAnswer = {
+    answers: string[];
+};
+type RequestUserInputResponse = {
+    answers: Record<string, RequestUserInputAnswer>;
+};
+type RequestUserInputEvent = {
+    /** Responses API call id for the associated tool call, if available. */
+    call_id: string;
+    /** Turn id that this request belongs to. */
+    turn_id: string;
+    questions: NormalizedRequestUserInputQuestion[];
+};
+declare function normalizeRequestUserInputArgs(args: RequestUserInputArgs): NormalizedRequestUserInputArgs;
+declare function requestUserInputAvailableModes(): ModeKind[];
+declare function createRequestUserInputTool(description: string): ToolSpec;
+declare function requestUserInputUnavailableMessage(mode: CollaborationMode["mode"], availableModes: readonly ModeKind[]): string | null;
+declare function requestUserInputToolDescription(availableModes: readonly ModeKind[]): string;
+
+declare const REQUEST_PERMISSIONS_TOOL_NAME = "request_permissions";
+declare const PermissionGrantScope: {
+    readonly Turn: "turn";
+    readonly Session: "session";
+};
+type PermissionGrantScope = (typeof PermissionGrantScope)[keyof typeof PermissionGrantScope];
+declare const ReviewDecision: {
+    readonly Approved: "approved";
+    readonly ApprovedForSession: "approved_for_session";
+    readonly Denied: "denied";
+    readonly Abort: "abort";
+    readonly TimedOut: "timed_out";
+};
+type ReviewDecision = (typeof ReviewDecision)[keyof typeof ReviewDecision];
+type NetworkPermissions = {
+    enabled?: boolean | null;
+    [key: string]: unknown;
+};
+type FileSystemPermissions = {
+    entries?: Array<Record<string, unknown>>;
+    [key: string]: unknown;
+};
+type RequestPermissionProfile = {
+    network?: NetworkPermissions | null;
+    file_system?: FileSystemPermissions | null;
+};
+type RequestPermissionsArgs = {
+    reason?: string | null;
+    permissions: RequestPermissionProfile;
+};
+type RequestPermissionsResponse = {
+    permissions: RequestPermissionProfile;
+    scope?: PermissionGrantScope;
+    strict_auto_review?: boolean;
+};
+type RequestPermissionsEvent = {
+    /** Responses API call id for the associated tool call, if available. */
+    call_id: string;
+    /** Turn id that this request belongs to. */
+    turn_id: string;
+    reason?: string | null;
+    permissions: RequestPermissionProfile;
+    cwd?: string | null;
+};
+declare function createRequestPermissionsTool(description: string): ToolSpec;
+declare function requestPermissionsToolDescription(): string;
+declare function normalizeRequestPermissionsArgs(args: RequestPermissionsArgs): RequestPermissionsArgs;
+declare function emptyRequestPermissionsResponse(): RequestPermissionsResponse;
+declare function deniedRequestPermissionsResponse(): RequestPermissionsResponse;
+declare function isEmptyRequestPermissionProfile(permissions: RequestPermissionProfile | null | undefined): boolean;
+declare function cloneRequestPermissionProfile(permissions: RequestPermissionProfile): RequestPermissionProfile;
+
+type MessagePhase = "commentary" | "final_answer";
+type ContentItem = {
+    type: "input_text";
+    text: string;
+} | {
+    type: "input_image";
+    image_url: string;
+    detail?: string | null;
+} | {
+    type: "output_text";
+    text: string;
+};
+type FunctionCallOutputContentItem = {
+    type: "input_text";
+    text: string;
+} | {
+    type: "input_image";
+    image_url: string;
+    detail?: string | null;
+};
+type FunctionCallOutputBody = {
+    type: "text";
+    text: string;
+} | {
+    type: "content_items";
+    items: FunctionCallOutputContentItem[];
+};
+type FunctionCallOutputPayload = {
+    body: FunctionCallOutputBody;
+    success?: boolean | null;
+};
+type MessageResponseInputItem = {
+    type: "message";
+    id?: string;
+    role: string;
+    content: ContentItem[];
+    phase?: MessagePhase | null;
+};
+type FunctionCallOutputResponseInputItem = {
+    type: "function_call_output";
+    call_id: string;
+    output: FunctionCallOutputPayload;
+};
+type CustomToolCallOutputResponseInputItem = {
+    type: "custom_tool_call_output";
+    call_id: string;
+    name?: string | null;
+    output: FunctionCallOutputPayload;
+};
+type McpToolCallOutputResponseInputItem = {
+    type: "mcp_tool_call_output";
+    call_id: string;
+    output: unknown;
+};
+type ToolSearchOutputResponseInputItem = {
+    type: "tool_search_output";
+    call_id: string;
+    status: "completed";
+    execution: "client";
+    tools: unknown[];
+};
+type ResponseInputItem = MessageResponseInputItem | FunctionCallOutputResponseInputItem | CustomToolCallOutputResponseInputItem | McpToolCallOutputResponseInputItem | ToolSearchOutputResponseInputItem;
+type ResponseMessageItem = {
+    type: "message";
+    id?: string;
+    role: string;
+    content: ContentItem[];
+    phase?: MessagePhase | null;
+};
+type ReasoningItemReasoningSummary = Record<string, unknown>;
+type ReasoningItemContent = Record<string, unknown>;
+type ResponseReasoningItem = {
+    type: "reasoning";
+    id?: string;
+    summary: ReasoningItemReasoningSummary[];
+    content?: ReasoningItemContent[] | null;
+    encrypted_content?: string | null;
+};
+type ResponseLocalShellCallItem = {
+    type: "local_shell_call";
+    id?: string | null;
+    call_id?: string | null;
+    status?: string | null;
+    action: Record<string, unknown>;
+};
+type ResponseFunctionCallItem = {
+    type: "function_call";
+    id?: string | null;
+    name: string;
+    namespace?: string | null;
+    arguments: string;
+    call_id: string;
+};
+type ResponseToolSearchCallItem = {
+    type: "tool_search_call";
+    id?: string | null;
+    call_id?: string | null;
+    status?: string | null;
+    execution: string;
+    arguments: unknown;
+};
+type ResponseFunctionCallOutputItem = {
+    type: "function_call_output";
+    call_id: string;
+    output: FunctionCallOutputPayload;
+};
+type ResponseCustomToolCallItem = {
+    type: "custom_tool_call";
+    id?: string | null;
+    status?: string | null;
+    call_id: string;
+    name: string;
+    input: string;
+};
+type ResponseCustomToolCallOutputItem = {
+    type: "custom_tool_call_output";
+    call_id: string;
+    name?: string | null;
+    output: FunctionCallOutputPayload;
+};
+type ResponseToolSearchOutputItem = {
+    type: "tool_search_output";
+    call_id?: string | null;
+    status: string;
+    execution: string;
+    tools: unknown[];
+};
+type ResponseWebSearchCallItem = {
+    type: "web_search_call";
+    id?: string | null;
+    status?: string | null;
+    action?: Record<string, unknown> | null;
+};
+type ResponseImageGenerationCallItem = {
+    type: "image_generation_call";
+    id: string;
+    status: string;
+    revised_prompt?: string | null;
+    result: string;
+    saved_path?: string;
+};
+type ResponseCompactionItem = {
+    type: "compaction" | "context_compaction";
+    encrypted_content?: string | null;
+};
+type ResponseOtherItem = {
+    type: "other";
+};
+type ResponseItem = ResponseMessageItem | ResponseReasoningItem | ResponseLocalShellCallItem | ResponseFunctionCallItem | ResponseToolSearchCallItem | ResponseFunctionCallOutputItem | ResponseCustomToolCallItem | ResponseCustomToolCallOutputItem | ResponseToolSearchOutputItem | ResponseWebSearchCallItem | ResponseImageGenerationCallItem | ResponseCompactionItem | ResponseOtherItem;
+type ResponseItemWire = (Omit<ResponseMessageItem, "phase"> & {
+    phase?: MessagePhase | null;
+}) | ResponseReasoningItem | ResponseLocalShellCallItem | ResponseFunctionCallItem | ResponseToolSearchCallItem | (Omit<ResponseFunctionCallOutputItem, "output"> & {
+    output: string | FunctionCallOutputContentItem[];
+}) | ResponseCustomToolCallItem | (Omit<ResponseCustomToolCallOutputItem, "output"> & {
+    output: string | FunctionCallOutputContentItem[];
+}) | ResponseToolSearchOutputItem | ResponseWebSearchCallItem | ResponseImageGenerationCallItem | ResponseCompactionItem | ResponseOtherItem;
+declare function responseInputToResponseItem(item: ResponseInputItem): ResponseItem;
+declare function functionCallOutputPayloadToWire(output: FunctionCallOutputPayload): string | FunctionCallOutputContentItem[];
+
+type McpRequestId = string | number;
+declare const McpServerStartupState: {
+    readonly Starting: "starting";
+    readonly Ready: "ready";
+    readonly Failed: "failed";
+    readonly Cancelled: "cancelled";
+};
+type McpServerStartupState = (typeof McpServerStartupState)[keyof typeof McpServerStartupState];
+type McpAuthStatus = "unsupported" | "notLoggedIn" | "bearerToken" | "oAuth";
+type McpServerStatus = {
+    name: string;
+    startup_state: McpServerStartupState;
+    error?: string | null;
+    tools?: McpToolInfo[];
+    resources?: McpResourceInfo[];
+    resource_templates?: McpResourceTemplateInfo[];
+    auth_status?: McpAuthStatus;
+    authStatus?: McpAuthStatus;
+    oauth?: {
+        status: "not_required" | "required" | "authenticated" | "failed";
+        error?: string | null;
+    } | null;
+};
+type McpServerStatusDetail = "full" | "toolsAndAuthOnly";
+type McpServerStatusListOptions = {
+    detail?: McpServerStatusDetail | null;
+};
+type McpServerRegistry = {
+    servers: Record<string, unknown>;
+};
+type McpServerRefreshConfig = {
+    mcp_servers: Record<string, unknown>;
+    mcp_oauth_credentials_store_mode?: unknown;
+};
+type McpRuntimeEnvironment = {
+    cwd: string;
+    environment_id?: string | null;
+};
+type McpToolInfo = {
+    /** Raw MCP server name used to route protocol calls. */
+    server_name: string;
+    /** Raw MCP tool name sent back to the MCP server. */
+    name: string;
+    /** Model-visible namespace. Defaults to Codex's qualified MCP namespace. */
+    callable_namespace?: string | null;
+    /** Model-visible tool name. Defaults to `name` for simple hosts. */
+    callable_name?: string | null;
+    namespace_description?: string | null;
+    title?: string | null;
+    description?: string | null;
+    input_schema?: unknown;
+    connector_id?: string | null;
+    connector_name?: string | null;
+    plugin_display_names?: string[];
+    source_label?: string | null;
+    mcp_app_resource_uri?: string | null;
+};
+type McpResourceInfo = {
+    uri: string;
+    name?: string | null;
+    description?: string | null;
+    mime_type?: string | null;
+};
+type McpResourceTemplateInfo = McpResourceInfo & {
+    uri_template: string;
+};
+type McpResourceReadParams = {
+    thread_id?: ThreadId | null;
+    server_name: string;
+    uri: string;
+};
+type McpResourceListParams = {
+    thread_id?: ThreadId | null;
+    server_name?: string | null;
+    cursor?: string | null;
+};
+type McpResourceListResponse = {
+    server_name?: string | null;
+    resources: McpResourceInfo[];
+    next_cursor?: string | null;
+};
+type McpResourceTemplateListResponse = {
+    server_name?: string | null;
+    resource_templates: McpResourceTemplateInfo[];
+    next_cursor?: string | null;
+};
+type McpResourceReadResponse = {
+    server_name: string;
+    uri: string;
+    contents: unknown[];
+};
+type McpServerToolCallParams = {
+    thread_id: ThreadId;
+    call_id?: string | null;
+    server_name: string;
+    tool_name: string;
+    arguments?: unknown;
+    meta?: unknown;
+};
+type McpServerToolCallResponse = {
+    call_id?: string | null;
+    server_name: string;
+    tool_name: string;
+    output: unknown;
+    response_item?: ResponseInputItem | null;
+};
+type McpServerOauthLoginParams = {
+    name: string;
+};
+type McpServerOauthLoginResponse = {
+    status: "unsupported" | "started";
+    name: string;
+    message?: string | null;
+};
+type McpServerElicitationRequest = {
+    type: "form";
+    meta?: unknown;
+    message: string;
+    requested_schema: unknown;
+} | {
+    type: "url";
+    meta?: unknown;
+    message: string;
+    url: string;
+    elicitation_id?: string | null;
+};
+type McpServerElicitationAction = "accept" | "decline" | "cancel";
+type McpServerElicitationResponse = {
+    action: McpServerElicitationAction;
+    content?: unknown;
+    meta?: unknown;
+};
+type McpServerElicitationRequestEvent = {
+    turn_id: string;
+    server_name: string;
+    id: McpRequestId;
+    request: McpServerElicitationRequest;
+};
+type McpServerElicitationResponseOp = {
+    type: "mcp_server_elicitation_response";
+    server_name: string;
+    id: McpRequestId;
+    response: McpServerElicitationResponse;
+};
+type McpToolCallProgressEvent = {
+    call_id: string;
+    turn_id?: string | null;
+    server_name: string;
+    tool_name: string;
+    message?: string | null;
+    progress?: unknown;
+};
+type McpServerStatusUpdatedEvent = {
+    status: McpServerStatus;
+};
+type McpServerOauthLoginCompletedEvent = {
+    name: string;
+    status: "completed" | "failed" | "cancelled";
+    error?: string | null;
+};
+declare function mcpToolDisplayName(tool: McpToolInfo): string;
+declare function mcpToolCallableNamespace(tool: McpToolInfo): string;
+declare function mcpToolCallableName(tool: McpToolInfo): string;
+
+type ByteRange = {
+    start: number;
+    end: number;
+};
+type TextElement = {
+    byte_range: ByteRange;
+    placeholder?: string;
+};
+type UserInput = {
+    type: "text";
+    text: string;
+    text_elements?: TextElement[];
+} | {
+    type: "image";
+    image_url: string;
+} | {
+    type: "local_image";
+    path: string;
+} | {
+    type: "skill";
+    name: string;
+    path: string;
+} | {
+    type: "mention";
+    name: string;
+    path: string;
+};
+type MentionInput = Extract<UserInput, {
+    type: "mention";
+}>;
+
+type W3cTraceContext = {
+    traceparent?: string;
+    tracestate?: string;
+};
+type Submission = {
+    id: string;
+    op: Op;
+    trace?: W3cTraceContext;
+};
+declare const BASE_INSTRUCTIONS_DEFAULT = "You are Codex, based on GPT-5. You are running as a coding agent in the Codex CLI on a user's computer.\n\n## General\n\n- Prefer to be concise, direct, and useful.\n- When asked to modify code, inspect the repository first and follow existing patterns.\n- Do not make unrelated changes.\n- If you run commands or edit files, summarize what changed and how you verified it.";
+type BaseInstructions = {
+    text: string;
+};
+declare const BaseInstructions: {
+    default(): BaseInstructions;
+};
+type TokenUsage = {
+    input_tokens: number;
+    cached_input_tokens: number;
+    output_tokens: number;
+    reasoning_output_tokens: number;
+    total_tokens: number;
+};
+type TokenUsageInfo = {
+    total_token_usage: TokenUsage;
+    last_token_usage: TokenUsage;
+    model_context_window?: number | null;
+};
+type RateLimitWindow = {
+    remaining?: number | null;
+    limit?: number | null;
+    reset_seconds?: number | null;
+    [key: string]: unknown;
+};
+type RateLimitSnapshot = {
+    limit_id?: string | null;
+    primary?: RateLimitWindow | null;
+    secondary?: RateLimitWindow | null;
+    credits?: Record<string, unknown> | null;
+    plan_type?: string | null;
+    [key: string]: unknown;
+};
+type SessionSource = string;
+type ReasoningEffortConfig = string;
+type ReasoningSummaryConfig = string;
+type AskForApproval = string;
+type ApprovalsReviewer = string;
+type SandboxPolicy = Record<string, unknown>;
+type PermissionProfile = Record<string, unknown>;
+type ActivePermissionProfile = Record<string, unknown>;
+type PermissionProfileBuiltinName = ":read-only" | ":workspace" | ":danger-no-sandbox";
+type WindowsSandboxLevel = string;
+type ServiceTier = string;
+type Personality = string;
+type TurnEnvironmentSelection = {
+    environment_id: string;
+    cwd: string;
+};
+type TurnContextNetworkItem = {
+    allowed_domains: string[];
+    denied_domains: string[];
+};
+type FileSystemSandboxPolicy = Record<string, unknown>;
+type TruncationPolicy = Record<string, unknown>;
+type GitInfo = Record<string, unknown>;
+type McpInvocation = Record<string, unknown>;
+type UserTurnOp = {
+    type: "user_turn";
+    items: UserInput[];
+    cwd: string;
+    approval_policy: AskForApproval;
+    approvals_reviewer?: ApprovalsReviewer | null;
+    sandbox_policy: SandboxPolicy;
+    permission_profile?: PermissionProfile | null;
+    model: string;
+    effort?: ReasoningEffortConfig;
+    summary?: ReasoningSummaryConfig;
+    service_tier?: ServiceTier | null;
+    final_output_json_schema?: unknown;
+    collaboration_mode?: CollaborationMode;
+    personality?: Personality;
+    environments?: TurnEnvironmentSelection[];
+};
+type UserInputOp = {
+    type: "user_input";
+    items: UserInput[];
+    environments?: TurnEnvironmentSelection[];
+    final_output_json_schema?: unknown;
+    responsesapi_client_metadata?: Record<string, string>;
+};
+type UserInputWithTurnContextOp = {
+    type: "user_input_with_turn_context";
+    items: UserInput[];
+    final_output_json_schema?: unknown;
+    responsesapi_client_metadata?: Record<string, string>;
+    cwd?: string;
+    approval_policy?: AskForApproval;
+    approvals_reviewer?: ApprovalsReviewer;
+    sandbox_policy?: SandboxPolicy;
+    permission_profile?: PermissionProfile;
+    active_permission_profile?: ActivePermissionProfile;
+    windows_sandbox_level?: WindowsSandboxLevel;
+    model?: string;
+    effort?: ReasoningEffortConfig | null;
+    summary?: ReasoningSummaryConfig;
+    service_tier?: ServiceTier | null;
+    collaboration_mode?: CollaborationMode;
+    personality?: Personality;
+    environments?: TurnEnvironmentSelection[];
+};
+type OverrideTurnContextOp = {
+    type: "override_turn_context";
+    cwd?: string;
+    approval_policy?: AskForApproval;
+    approvals_reviewer?: ApprovalsReviewer | null;
+    sandbox_policy?: SandboxPolicy;
+    permission_profile?: PermissionProfile | null;
+    active_permission_profile?: ActivePermissionProfile | null;
+    windows_sandbox_level?: WindowsSandboxLevel;
+    model?: string;
+    effort?: ReasoningEffortConfig | null;
+    summary?: ReasoningSummaryConfig;
+    service_tier?: ServiceTier | null;
+    collaboration_mode?: CollaborationMode;
+    personality?: Personality | null;
+    environments?: TurnEnvironmentSelection[];
+};
+type UserInputAnswerOp = {
+    type: "user_input_answer";
+    id: string;
+    response: RequestUserInputResponse;
+};
+type RequestPermissionsResponseOp = {
+    type: "request_permissions_response";
+    id: string;
+    response: RequestPermissionsResponse;
+};
+type DynamicToolResponseOp = {
+    type: "dynamic_tool_response";
+    id: string;
+    response: DynamicToolResponse;
+};
+type RealtimeOutputModality = "text" | "audio";
+type RealtimeVoice = "alloy" | "arbor" | "ash" | "ballad" | "breeze" | "cedar" | "coral" | "cove" | "echo" | "ember" | "juniper" | "maple" | "marin" | "sage" | "shimmer" | "sol" | "spruce" | "vale" | "verse";
+type RealtimeVoicesList = {
+    v1: RealtimeVoice[];
+    v2: RealtimeVoice[];
+    default_v1: RealtimeVoice;
+    default_v2: RealtimeVoice;
+};
+declare const RealtimeVoicesList: {
+    builtin(): RealtimeVoicesList;
+};
+type ConversationStartTransport = {
+    type: "websocket";
+} | {
+    type: "webrtc";
+    sdp: string;
+};
+type ConversationStartParams = {
+    output_modality: RealtimeOutputModality;
+    prompt?: string | null;
+    realtime_session_id?: string | null;
+    transport?: ConversationStartTransport | null;
+    voice?: RealtimeVoice | null;
+};
+type RealtimeAudioFrame = {
+    data: string;
+    sample_rate: number;
+    num_channels: number;
+    samples_per_channel?: number | null;
+    item_id?: string | null;
+};
+type RealtimeTranscriptDelta = {
+    delta: string;
+};
+type RealtimeTranscriptDone = {
+    text: string;
+};
+type RealtimeTranscriptEntry = {
+    role: string;
+    text: string;
+};
+type RealtimeHandoffRequested = {
+    handoff_id: string;
+    item_id: string;
+    input_transcript: string;
+    active_transcript: RealtimeTranscriptEntry[];
+};
+type RealtimeNoopRequested = {
+    call_id: string;
+    item_id: string;
+};
+type RealtimeInputAudioSpeechStarted = {
+    item_id?: string | null;
+};
+type RealtimeResponseLifecycle = {
+    response_id?: string | null;
+};
+type RealtimeEvent = {
+    type: "session_updated";
+    realtime_session_id: string;
+    instructions?: string | null;
+} | ({
+    type: "input_audio_speech_started";
+} & RealtimeInputAudioSpeechStarted) | ({
+    type: "input_transcript_delta";
+} & RealtimeTranscriptDelta) | ({
+    type: "input_transcript_done";
+} & RealtimeTranscriptDone) | ({
+    type: "output_transcript_delta";
+} & RealtimeTranscriptDelta) | ({
+    type: "output_transcript_done";
+} & RealtimeTranscriptDone) | ({
+    type: "audio_out";
+} & RealtimeAudioFrame) | ({
+    type: "response_created";
+} & RealtimeResponseLifecycle) | ({
+    type: "response_cancelled";
+} & RealtimeResponseLifecycle) | ({
+    type: "response_done";
+} & RealtimeResponseLifecycle) | {
+    type: "conversation_item_added";
+    item: unknown;
+} | {
+    type: "conversation_item_done";
+    item_id: string;
+} | ({
+    type: "handoff_requested";
+} & RealtimeHandoffRequested) | ({
+    type: "noop_requested";
+} & RealtimeNoopRequested) | {
+    type: "error";
+    message: string;
+};
+type ConversationAudioParams = {
+    frame: RealtimeAudioFrame;
+};
+type ConversationTextParams = {
+    text: string;
+};
+type ThreadRealtimeStartParams = ConversationStartParams & {
+    thread_id: ThreadId;
+};
+type ThreadRealtimeStartResponse = Record<never, never>;
+type ThreadRealtimeAppendAudioParams = ConversationAudioParams & {
+    thread_id: ThreadId;
+};
+type ThreadRealtimeAppendAudioResponse = Record<never, never>;
+type ThreadRealtimeAppendTextParams = ConversationTextParams & {
+    thread_id: ThreadId;
+};
+type ThreadRealtimeAppendTextResponse = Record<never, never>;
+type ThreadRealtimeStopParams = {
+    thread_id: ThreadId;
+};
+type ThreadRealtimeStopResponse = Record<never, never>;
+type ThreadRealtimeListVoicesParams = Record<never, never>;
+type ThreadRealtimeListVoicesResponse = {
+    voices: RealtimeVoicesList;
+};
+type RealtimeConversationStartOp = {
+    type: "realtime_conversation_start";
+} & ConversationStartParams;
+type RealtimeConversationAudioOp = {
+    type: "realtime_conversation_audio";
+} & ConversationAudioParams;
+type RealtimeConversationTextOp = {
+    type: "realtime_conversation_text";
+} & ConversationTextParams;
+type RealtimeConversationCloseOp = {
+    type: "realtime_conversation_close";
+};
+type RealtimeConversationListVoicesOp = {
+    type: "realtime_conversation_list_voices";
+};
+type AgentPathWire = string;
+declare const AgentStatusWire: {
+    readonly Running: "running";
+    readonly Completed: "completed";
+    readonly Failed: "failed";
+    readonly Closed: "closed";
+    readonly Cancelled: "cancelled";
+};
+type AgentStatusWire = (typeof AgentStatusWire)[keyof typeof AgentStatusWire];
+type SubAgentSource = {
+    type: "thread_spawn";
+    parent_thread_id: ThreadId;
+    depth: number;
+    agent_path?: AgentPathWire | null;
+    agent_role?: string | null;
+} | {
+    type: "other";
+    value: string;
+};
+type InterAgentCommunicationWire = {
+    author: AgentPathWire;
+    recipient: AgentPathWire;
+    items?: unknown[];
+    content: string;
+    trigger_turn: boolean;
+    seq?: number;
+};
+type CollabAgentRef = {
+    thread_id?: ThreadId | null;
+    agent_path?: AgentPathWire | null;
+    agent_nickname?: string | null;
+    agent_role?: string | null;
+};
+type CollabAgentSpawnBeginEvent = {
+    turn_id: string;
+    call_id: string;
+    task?: string | null;
+};
+type CollabAgentSpawnEndEvent = {
+    turn_id: string;
+    call_id: string;
+    agent?: CollabAgentRef | null;
+    error?: string | null;
+};
+type CollabAgentInteractionBeginEvent = {
+    turn_id: string;
+    call_id: string;
+    target: CollabAgentRef;
+};
+type CollabAgentInteractionEndEvent = {
+    turn_id: string;
+    call_id: string;
+    target: CollabAgentRef;
+    error?: string | null;
+};
+type CollabWaitingBeginEvent = {
+    turn_id: string;
+    call_id: string;
+    targets: CollabAgentRef[];
+};
+type CollabWaitingEndEvent = {
+    turn_id: string;
+    call_id: string;
+    statuses?: Record<string, AgentStatusWire>;
+    error?: string | null;
+};
+type CollabResumeBeginEvent = {
+    turn_id: string;
+    call_id: string;
+    target: CollabAgentRef;
+};
+type CollabResumeEndEvent = CollabAgentInteractionEndEvent;
+type CollabCloseBeginEvent = CollabAgentInteractionBeginEvent;
+type CollabCloseEndEvent = CollabAgentInteractionEndEvent;
+type CompactOp = {
+    type: "compact";
+};
+type SetThreadNameOp = {
+    type: "set_thread_name";
+    name: string;
+};
+type SetThreadMemoryModeOp = {
+    type: "set_thread_memory_mode";
+    mode: ThreadMemoryMode;
+};
+type ThreadRollbackOp = {
+    type: "thread_rollback";
+    num_turns: number;
+};
+type InterruptOp = {
+    type: "interrupt";
+};
+type ShutdownOp = {
+    type: "shutdown";
+};
+type Op = UserTurnOp | UserInputOp | UserInputWithTurnContextOp | OverrideTurnContextOp | UserInputAnswerOp | RequestPermissionsResponseOp | DynamicToolResponseOp | McpServerElicitationResponseOp | RealtimeConversationStartOp | RealtimeConversationAudioOp | RealtimeConversationTextOp | RealtimeConversationCloseOp | RealtimeConversationListVoicesOp | CompactOp | SetThreadNameOp | SetThreadMemoryModeOp | ThreadRollbackOp | InterruptOp | ShutdownOp;
+type ErrorEvent = {
+    message: string;
+    codex_error_info?: unknown;
+};
+type WarningEvent = {
+    message: string;
+};
+type TurnStartedEvent = {
+    turn_id: string;
+    started_at?: number | null;
+    model_context_window?: number | null;
+    collaboration_mode_kind?: CollaborationMode["mode"];
+};
+type TurnCompleteEvent = {
+    turn_id: string;
+    last_agent_message?: string | null;
+    completed_at?: number | null;
+    duration_ms?: number | null;
+    time_to_first_token_ms?: number | null;
+};
+type TurnAbortReason = "interrupted";
+type TurnAbortedEvent = {
+    turn_id: string;
+    reason: TurnAbortReason;
+    aborted_at?: number | null;
+    completed_at?: number | null;
+    duration_ms?: number | null;
+};
+type AgentMessageEvent = {
+    message: string;
+    phase?: string | null;
+    memory_citation?: MemoryCitation | null;
+};
+type UserMessageEvent = {
+    message: string;
+    images?: string[] | null;
+    local_images?: string[];
+    text_elements?: TextElement[];
+};
+type RawResponseItemEvent = {
+    item: ResponseItem;
+};
+type ItemStartedEvent = {
+    turn_id?: string;
+    item: TurnItem;
+};
+type ItemCompletedEvent = {
+    turn_id?: string;
+    item: TurnItem;
+};
+type ExecCommandStatus = "completed" | "failed" | "cancelled";
+type ExecCommandBeginEvent = {
+    call_id: string;
+    process_id?: string | null;
+    turn_id: string;
+    started_at_ms: number;
+    command: string[];
+    cwd: string;
+    parsed_cmd?: unknown[] | null;
+    source?: string | null;
+    interaction_input?: string | null;
+};
+type ExecCommandOutputDeltaEvent = {
+    call_id: string;
+    turn_id?: string;
+    stream: "stdout" | "stderr";
+    chunk: string;
+};
+type TerminalInteractionEvent = {
+    call_id: string;
+    process_id?: string | null;
+    stdin: string;
+};
+type ExecCommandEndEvent = {
+    call_id: string;
+    turn_id?: string;
+    process_id?: string | null;
+    completed_at_ms: number;
+    exit_code: number;
+    status: ExecCommandStatus;
+    duration_ms?: number | null;
+    stdout?: string | null;
+    stderr?: string | null;
+    output?: ExecToolCallOutput | null;
+};
+type PatchApplyUpdatedEvent = {
+    call_id: string;
+    turn_id?: string;
+    changes: Record<string, FileChange>;
+    status?: "completed" | "failed" | "declined" | null;
+    stdout?: string | null;
+    stderr?: string | null;
+};
+type CommandApprovalRequestEvent = {
+    call_id: string;
+    command: string[];
+    cwd: string;
+    reason?: string | null;
+};
+type FileChangeApprovalRequestEvent = {
+    call_id: string;
+    changes: Record<string, FileChange>;
+    reason?: string | null;
+};
+type AgentMessageContentDeltaEvent = {
+    thread_id: string;
+    turn_id: string;
+    item_id: string;
+    delta: string;
+};
+type PlanDeltaEvent = {
+    thread_id: string;
+    turn_id: string;
+    item_id: string;
+    delta: string;
+};
+type UpdatePlanStepStatus = "pending" | "in_progress" | "completed";
+type UpdatePlanStep = {
+    step: string;
+    status: UpdatePlanStepStatus;
+};
+type UpdatePlanArgs = {
+    explanation?: string | null;
+    plan: UpdatePlanStep[];
+};
+type ImageGenerationBeginEvent = {
+    call_id: string;
+};
+type ImageGenerationEndEvent = {
+    call_id: string;
+    status: string;
+    revised_prompt?: string;
+    result: string;
+    saved_path?: string;
+};
+type ContextCompactedEvent = Record<never, never>;
+type ThreadRolledBackEvent = {
+    num_turns: number;
+};
+type TokenCountEvent = {
+    info?: TokenUsageInfo | null;
+    rate_limits?: RateLimitSnapshot | null;
+};
+declare const ThreadGoalStatus: {
+    readonly Active: "active";
+    readonly Paused: "paused";
+    readonly BudgetLimited: "budgetLimited";
+    readonly Complete: "complete";
+};
+type ThreadGoalStatus = (typeof ThreadGoalStatus)[keyof typeof ThreadGoalStatus];
+declare const MAX_THREAD_GOAL_OBJECTIVE_CHARS = 4000;
+declare function validateThreadGoalObjective(value: string): void;
+type ThreadGoal = {
+    thread_id: ThreadId;
+    objective: string;
+    status: ThreadGoalStatus;
+    token_budget?: number | null;
+    tokens_used: number;
+    time_used_seconds: number;
+    created_at: number;
+    updated_at: number;
+};
+type ThreadGoalUpdatedEvent = {
+    thread_id: ThreadId;
+    turn_id?: string | null;
+    goal: ThreadGoal;
+};
+type McpToolCallBeginEvent = {
+    call_id: string;
+    invocation: McpInvocation;
+    mcp_app_resource_uri?: string;
+};
+type McpToolCallEndEvent = {
+    call_id: string;
+    invocation: McpInvocation;
+    mcp_app_resource_uri?: string;
+    duration: string;
+    result: unknown;
+};
+type McpToolCallProgressEventMsg = {
+    type: "mcp_tool_call_progress";
+} & McpToolCallProgressEvent;
+type McpServerStatusUpdatedEventMsg = {
+    type: "mcp_server_status_updated";
+} & McpServerStatusUpdatedEvent;
+type McpServerOauthLoginCompletedEventMsg = {
+    type: "mcp_server_oauth_login_completed";
+} & McpServerOauthLoginCompletedEvent;
+type McpServerElicitationRequestEventMsg = {
+    type: "mcp_server_elicitation_request";
+} & McpServerElicitationRequestEvent;
+declare const HookEventName: {
+    readonly PreToolUse: "pre_tool_use";
+    readonly PermissionRequest: "permission_request";
+    readonly PostToolUse: "post_tool_use";
+    readonly PreCompact: "pre_compact";
+    readonly PostCompact: "post_compact";
+    readonly SessionStart: "session_start";
+    readonly UserPromptSubmit: "user_prompt_submit";
+    readonly Stop: "stop";
+};
+type HookEventName = (typeof HookEventName)[keyof typeof HookEventName];
+declare const HookHandlerType: {
+    readonly Command: "command";
+    readonly Prompt: "prompt";
+    readonly Agent: "agent";
+};
+type HookHandlerType = (typeof HookHandlerType)[keyof typeof HookHandlerType];
+declare const HookExecutionMode: {
+    readonly Sync: "sync";
+    readonly Async: "async";
+};
+type HookExecutionMode = (typeof HookExecutionMode)[keyof typeof HookExecutionMode];
+declare const HookScope: {
+    readonly Thread: "thread";
+    readonly Turn: "turn";
+};
+type HookScope = (typeof HookScope)[keyof typeof HookScope];
+declare const HookSource: {
+    readonly System: "system";
+    readonly User: "user";
+    readonly Project: "project";
+    readonly Mdm: "mdm";
+    readonly SessionFlags: "session_flags";
+    readonly Plugin: "plugin";
+    readonly CloudRequirements: "cloud_requirements";
+    readonly LegacyManagedConfigFile: "legacy_managed_config_file";
+    readonly LegacyManagedConfigMdm: "legacy_managed_config_mdm";
+    readonly Unknown: "unknown";
+};
+type HookSource = (typeof HookSource)[keyof typeof HookSource];
+declare const HookTrustStatus: {
+    readonly Managed: "managed";
+    readonly Untrusted: "untrusted";
+    readonly Trusted: "trusted";
+    readonly Modified: "modified";
+};
+type HookTrustStatus = (typeof HookTrustStatus)[keyof typeof HookTrustStatus];
+declare const HookRunStatus: {
+    readonly Running: "running";
+    readonly Completed: "completed";
+    readonly Failed: "failed";
+    readonly Blocked: "blocked";
+    readonly Stopped: "stopped";
+};
+type HookRunStatus = (typeof HookRunStatus)[keyof typeof HookRunStatus];
+declare const HookOutputEntryKind: {
+    readonly Warning: "warning";
+    readonly Stop: "stop";
+    readonly Feedback: "feedback";
+    readonly Context: "context";
+    readonly Error: "error";
+};
+type HookOutputEntryKind = (typeof HookOutputEntryKind)[keyof typeof HookOutputEntryKind];
+type HookOutputEntry = {
+    kind: HookOutputEntryKind;
+    text: string;
+};
+type HookRunSummary = {
+    id: string;
+    event_name: HookEventName;
+    handler_type: HookHandlerType;
+    execution_mode: HookExecutionMode;
+    scope: HookScope;
+    source_path: string;
+    source: HookSource;
+    display_order: number;
+    status: HookRunStatus;
+    status_message?: string | null;
+    started_at: number;
+    completed_at?: number | null;
+    duration_ms?: number | null;
+    entries: HookOutputEntry[];
+};
+type HookStartedEvent = {
+    turn_id?: string | null;
+    run: HookRunSummary;
+};
+type HookCompletedEvent = {
+    turn_id?: string | null;
+    run: HookRunSummary;
+};
+type RealtimeConversationVersion = "v1" | "v2";
+type RealtimeConversationStartedEvent = {
+    realtime_session_id?: string | null;
+    version: RealtimeConversationVersion;
+};
+type RealtimeConversationRealtimeEvent = {
+    payload: RealtimeEvent;
+};
+type RealtimeConversationClosedEvent = {
+    reason?: string | null;
+};
+type RealtimeConversationSdpEvent = {
+    sdp: string;
+};
+type RealtimeConversationListVoicesResponseEvent = {
+    voices: RealtimeVoicesList;
+};
+/** Codex Rust variant: `TurnStarted`; v1 wire value: `turn_started`. */
+type TurnStartedEventMsg = {
+    type: "turn_started";
+} & TurnStartedEvent;
+/** Codex Rust variant: `TurnComplete`; v1 wire value: `turn_complete`. */
+type TurnCompleteEventMsg = {
+    type: "turn_complete";
+} & TurnCompleteEvent;
+/** Codex Rust variant: `TurnAborted`; v1 wire value: `turn_aborted`. */
+type TurnAbortedEventMsg = {
+    type: "turn_aborted";
+} & TurnAbortedEvent;
+type AgentMessageEventMsg = {
+    type: "agent_message";
+} & AgentMessageEvent;
+type UserMessageEventMsg = {
+    type: "user_message";
+} & UserMessageEvent;
+type RawResponseItemEventMsg = {
+    type: "raw_response_item";
+} & RawResponseItemEvent;
+type ItemStartedEventMsg = {
+    type: "item_started";
+} & ItemStartedEvent;
+type ItemCompletedEventMsg = {
+    type: "item_completed";
+} & ItemCompletedEvent;
+type ExecCommandBeginEventMsg = {
+    type: "exec_command_begin";
+} & ExecCommandBeginEvent;
+type ExecCommandOutputDeltaEventMsg = {
+    type: "exec_command_output_delta";
+} & ExecCommandOutputDeltaEvent;
+type TerminalInteractionEventMsg = {
+    type: "terminal_interaction";
+} & TerminalInteractionEvent;
+type ExecCommandEndEventMsg = {
+    type: "exec_command_end";
+} & ExecCommandEndEvent;
+type PatchApplyUpdatedEventMsg = {
+    type: "patch_apply_updated";
+} & PatchApplyUpdatedEvent;
+type CommandApprovalRequestEventMsg = {
+    type: "command_approval_request";
+} & CommandApprovalRequestEvent;
+type FileChangeApprovalRequestEventMsg = {
+    type: "file_change_approval_request";
+} & FileChangeApprovalRequestEvent;
+type AgentMessageContentDeltaEventMsg = {
+    type: "agent_message_content_delta";
+} & AgentMessageContentDeltaEvent;
+/** Codex Rust variant: `PlanDelta`; v1 wire value: `plan_delta`. */
+type PlanDeltaEventMsg = {
+    type: "plan_delta";
+} & PlanDeltaEvent;
+type PlanUpdateEventMsg = {
+    type: "plan_update";
+} & UpdatePlanArgs;
+type RequestUserInputEventMsg = {
+    type: "request_user_input";
+} & RequestUserInputEvent;
+type RequestPermissionsEventMsg = {
+    type: "request_permissions";
+} & RequestPermissionsEvent;
+type DynamicToolCallRequestEventMsg = {
+    type: "dynamic_tool_call_request";
+} & DynamicToolCallRequest;
+type DynamicToolCallResponseEventMsg = {
+    type: "dynamic_tool_call_response";
+} & DynamicToolCallResponseEvent;
+type ImageGenerationBeginEventMsg = {
+    type: "image_generation_begin";
+} & ImageGenerationBeginEvent;
+type ImageGenerationEndEventMsg = {
+    type: "image_generation_end";
+} & ImageGenerationEndEvent;
+type ContextCompactedEventMsg = {
+    type: "context_compacted";
+} & ContextCompactedEvent;
+type ThreadRolledBackEventMsg = {
+    type: "thread_rolled_back";
+} & ThreadRolledBackEvent;
+type TokenCountEventMsg = {
+    type: "token_count";
+} & TokenCountEvent;
+type ThreadGoalUpdatedEventMsg = {
+    type: "thread_goal_updated";
+} & ThreadGoalUpdatedEvent;
+type WarningEventMsg = {
+    type: "warning";
+} & WarningEvent;
+type ErrorEventMsg = {
+    type: "error";
+} & ErrorEvent;
+type HookStartedEventMsg = {
+    type: "hook_started";
+} & HookStartedEvent;
+type HookCompletedEventMsg = {
+    type: "hook_completed";
+} & HookCompletedEvent;
+type RealtimeConversationStartedEventMsg = {
+    type: "realtime_conversation_started";
+} & RealtimeConversationStartedEvent;
+type RealtimeConversationRealtimeEventMsg = {
+    type: "realtime_conversation_realtime";
+} & RealtimeConversationRealtimeEvent;
+type RealtimeConversationClosedEventMsg = {
+    type: "realtime_conversation_closed";
+} & RealtimeConversationClosedEvent;
+type RealtimeConversationSdpEventMsg = {
+    type: "realtime_conversation_sdp";
+} & RealtimeConversationSdpEvent;
+type RealtimeConversationListVoicesResponseEventMsg = {
+    type: "realtime_conversation_list_voices_response";
+} & RealtimeConversationListVoicesResponseEvent;
+type SessionConfiguredEvent = {
+    session_id: string;
+    thread_id: ThreadId;
+    forked_from_id?: ThreadId | null;
+    thread_source?: string | null;
+    thread_name?: string | null;
+    model: string;
+    model_provider_id: string;
+    service_tier?: ServiceTier | null;
+    approval_policy: AskForApproval;
+    approvals_reviewer?: ApprovalsReviewer | null;
+    permission_profile: PermissionProfile;
+    active_permission_profile?: ActivePermissionProfile | null;
+    cwd: string;
+    reasoning_effort?: ReasoningEffortConfig | null;
+    initial_messages?: EventMsg[] | null;
+    network_proxy?: unknown | null;
+    rollout_path?: string | null;
+};
+type SessionConfiguredEventMsg = {
+    type: "session_configured";
+} & SessionConfiguredEvent;
+type EventMsg = SessionConfiguredEventMsg | TurnStartedEventMsg | TurnCompleteEventMsg | TurnAbortedEventMsg | AgentMessageEventMsg | UserMessageEventMsg | RawResponseItemEventMsg | ItemStartedEventMsg | ItemCompletedEventMsg | ExecCommandBeginEventMsg | ExecCommandOutputDeltaEventMsg | TerminalInteractionEventMsg | ExecCommandEndEventMsg | PatchApplyUpdatedEventMsg | CommandApprovalRequestEventMsg | FileChangeApprovalRequestEventMsg | AgentMessageContentDeltaEventMsg | PlanDeltaEventMsg | PlanUpdateEventMsg | RequestUserInputEventMsg | RequestPermissionsEventMsg | DynamicToolCallRequestEventMsg | DynamicToolCallResponseEventMsg | McpToolCallProgressEventMsg | McpServerStatusUpdatedEventMsg | McpServerOauthLoginCompletedEventMsg | McpServerElicitationRequestEventMsg | ImageGenerationBeginEventMsg | ImageGenerationEndEventMsg | ContextCompactedEventMsg | ThreadRolledBackEventMsg | TokenCountEventMsg | ThreadGoalUpdatedEventMsg | WarningEventMsg | HookStartedEventMsg | HookCompletedEventMsg | RealtimeConversationStartedEventMsg | RealtimeConversationRealtimeEventMsg | RealtimeConversationClosedEventMsg | RealtimeConversationSdpEventMsg | RealtimeConversationListVoicesResponseEventMsg | ErrorEventMsg;
+type SessionMeta = {
+    id: ThreadId;
+    forked_from_id?: ThreadId | null;
+    timestamp: string;
+    cwd: string;
+    originator: string;
+    cli_version: string;
+    source: SessionSource;
+    agent_nickname?: string | null;
+    agent_role?: string | null;
+    agent_path?: string | null;
+    model_provider: string | null;
+    base_instructions: BaseInstructions | null;
+    dynamic_tools?: DynamicToolSpec[] | null;
+    memory_mode?: ThreadMemoryModeSessionMetaValue | null;
+};
+type SessionMetaLine = SessionMeta & {
+    git?: GitInfo | null;
+};
+type CompactedItem = {
+    message: string;
+    replacement_history?: ResponseItem[];
+};
+type TurnContextItem = {
+    turn_id?: string;
+    trace_id?: string;
+    cwd: string;
+    current_date?: string;
+    timezone?: string;
+    approval_policy: AskForApproval;
+    sandbox_policy: SandboxPolicy;
+    permission_profile?: PermissionProfile | null;
+    windows_sandbox_level?: WindowsSandboxLevel | null;
+    network?: TurnContextNetworkItem | null;
+    file_system_sandbox_policy?: FileSystemSandboxPolicy | null;
+    model: string;
+    personality?: Personality | null;
+    collaboration_mode?: CollaborationMode | null;
+    realtime_active?: boolean | null;
+    effort?: ReasoningEffortConfig | null;
+    summary: ReasoningSummaryConfig;
+    user_instructions?: string | null;
+    developer_instructions?: string | null;
+    final_output_json_schema?: unknown;
+    truncation_policy?: TruncationPolicy | null;
+};
+type SessionMetaRolloutItem = {
+    type: "session_meta";
+    payload: SessionMetaLine;
+};
+type ResponseRolloutItem = {
+    type: "response_item";
+    payload: ResponseItem;
+};
+type CompactedRolloutItem = {
+    type: "compacted";
+    payload: CompactedItem;
+};
+type TurnContextRolloutItem = {
+    type: "turn_context";
+    payload: TurnContextItem;
+};
+type EventMsgRolloutItem = {
+    type: "event_msg";
+    payload: EventMsg;
+};
+type RolloutItem = SessionMetaRolloutItem | ResponseRolloutItem | CompactedRolloutItem | TurnContextRolloutItem | EventMsgRolloutItem;
+
+export { type LoadableToolSpec as $, type ResponseItem as A, BaseInstructions as B, type CollaborationMode as C, type DynamicToolSpec as D, type EventMsg as E, type FunctionCallOutputContentItem as F, type ToolSpec as G, type TokenUsage as H, type RateLimitSnapshot as I, type SessionSource as J, type TextElement as K, type ActivePermissionProfile as L, type McpResourceInfo as M, type ServiceTier as N, type Op as O, type PermissionProfile as P, type ReasoningEffortConfig as Q, type RealtimeEvent as R, type SandboxPolicy as S, TUI_VISIBLE_COLLABORATION_MODES as T, type UserInput as U, type ReasoningSummaryConfig as V, type Personality as W, type AskForApproval as X, type ApprovalsReviewer as Y, type WindowsSandboxLevel as Z, type TurnEnvironmentSelection as _, type CollaborationModeMask as a, type CollabWaitingEndEvent as a$, type ConfiguredToolSpec as a0, type PermissionProfileBuiltinName as a1, type ResponseItemWire as a2, responseInputToResponseItem as a3, type UserMessageTurnItem as a4, type DynamicToolResponse as a5, type McpResourceListParams as a6, type McpResourceListResponse as a7, type McpResourceTemplateListResponse as a8, type McpResourceReadParams as a9, type W3cTraceContext as aA, type ResponseInputItem as aB, type ContentItem as aC, type AgentMessageTurnItem as aD, type HookPromptTurnItem as aE, type FileChange as aF, type ExecToolCallOutput as aG, type AgentMessageContent as aH, type AgentMessageContentDeltaEvent as aI, type AgentMessageContentDeltaEventMsg as aJ, type AgentMessageEvent as aK, type AgentMessageEventMsg as aL, type AgentPathWire as aM, AgentStatusWire as aN, BASE_INSTRUCTIONS_DEFAULT as aO, type ByteRange as aP, type CodexBrand as aQ, type CollabAgentInteractionBeginEvent as aR, type CollabAgentInteractionEndEvent as aS, type CollabAgentRef as aT, type CollabAgentSpawnBeginEvent as aU, type CollabAgentSpawnEndEvent as aV, type CollabCloseBeginEvent as aW, type CollabCloseEndEvent as aX, type CollabResumeBeginEvent as aY, type CollabResumeEndEvent as aZ, type CollabWaitingBeginEvent as a_, type McpResourceReadResponse as aa, type McpServerToolCallParams as ab, type McpServerToolCallResponse as ac, type McpRequestId as ad, type McpServerElicitationResponse as ae, type ThreadGoal as af, ThreadGoalStatus as ag, HookEventName as ah, HookSource as ai, HookRunStatus as aj, type HookOutputEntry as ak, type HookRunSummary as al, HookScope as am, type HookCompletedEvent as an, type RequestPermissionsResponse as ao, type RequestUserInputResponse as ap, type RequestPermissionProfile as aq, type OverrideTurnContextOp as ar, type UserInputOp as as, type UserInputWithTurnContextOp as at, type UserTurnOp as au, type NormalizedRequestUserInputArgs as av, type RequestPermissionsArgs as aw, type McpServerElicitationRequest as ax, type CompactedItem as ay, type TurnContextItem as az, type DynamicToolSpecWire as b, type McpServerElicitationRequestEvent as b$, type CollaborationModeSettings as b0, type CommandApprovalRequestEvent as b1, type CommandApprovalRequestEventMsg as b2, type CommandExecutionStatus as b3, type CommandExecutionTurnItem as b4, type CompactOp as b5, type CompactedRolloutItem as b6, type ContextCompactedEvent as b7, type ContextCompactedEventMsg as b8, type ContextCompactionTurnItem as b9, type FreeformTool as bA, type FunctionCallOutputBody as bB, type GitInfo as bC, type HookCompletedEventMsg as bD, HookExecutionMode as bE, HookHandlerType as bF, HookOutputEntryKind as bG, type HookPromptFragment as bH, type HookStartedEvent as bI, type HookStartedEventMsg as bJ, HookTrustStatus as bK, type ImageGenerationBeginEvent as bL, type ImageGenerationBeginEventMsg as bM, type ImageGenerationEndEvent as bN, type ImageGenerationEndEventMsg as bO, type ImageGenerationTurnItem as bP, type ImageViewTurnItem as bQ, type InterAgentCommunicationWire as bR, type InterruptOp as bS, type ItemCompletedEvent as bT, type ItemCompletedEventMsg as bU, type ItemStartedEvent as bV, type ItemStartedEventMsg as bW, type JsonSchema as bX, MAX_THREAD_GOAL_OBJECTIVE_CHARS as bY, type McpInvocation as bZ, type McpServerElicitationAction as b_, type ConversationAudioParams as ba, type ConversationStartParams as bb, type ConversationStartTransport as bc, type ConversationTextParams as bd, type DynamicToolCallOutputContentItem as be, type DynamicToolCallRequestEventMsg as bf, type DynamicToolCallResponseEvent as bg, type DynamicToolCallResponseEventMsg as bh, type DynamicToolCallStatus as bi, type DynamicToolCallTurnItem as bj, type DynamicToolResponseOp as bk, type ErrorEvent as bl, type ErrorEventMsg as bm, type EventMsgRolloutItem as bn, type ExecCommandBeginEvent as bo, type ExecCommandBeginEventMsg as bp, type ExecCommandEndEvent as bq, type ExecCommandEndEventMsg as br, type ExecCommandOutputDeltaEvent as bs, type ExecCommandOutputDeltaEventMsg as bt, type ExecCommandStatus as bu, type FileChangeApprovalRequestEvent as bv, type FileChangeApprovalRequestEventMsg as bw, type FileChangeTurnItem as bx, type FileSystemPermissions as by, type FileSystemSandboxPolicy as bz, type McpResourceTemplateInfo as c, RealtimeVoicesList as c$, type McpServerElicitationRequestEventMsg as c0, type McpServerElicitationResponseOp as c1, type McpServerOauthLoginCompletedEvent as c2, type McpServerOauthLoginCompletedEventMsg as c3, type McpServerOauthLoginParams as c4, type McpServerOauthLoginResponse as c5, type McpServerRegistry as c6, McpServerStartupState as c7, type McpServerStatusDetail as c8, type McpServerStatusUpdatedEvent as c9, type RawResponseItemEventMsg as cA, type RealtimeAudioFrame as cB, type RealtimeConversationAudioOp as cC, type RealtimeConversationCloseOp as cD, type RealtimeConversationClosedEvent as cE, type RealtimeConversationClosedEventMsg as cF, type RealtimeConversationListVoicesOp as cG, type RealtimeConversationListVoicesResponseEvent as cH, type RealtimeConversationListVoicesResponseEventMsg as cI, type RealtimeConversationRealtimeEvent as cJ, type RealtimeConversationRealtimeEventMsg as cK, type RealtimeConversationSdpEvent as cL, type RealtimeConversationSdpEventMsg as cM, type RealtimeConversationStartOp as cN, type RealtimeConversationStartedEvent as cO, type RealtimeConversationStartedEventMsg as cP, type RealtimeConversationTextOp as cQ, type RealtimeConversationVersion as cR, type RealtimeHandoffRequested as cS, type RealtimeInputAudioSpeechStarted as cT, type RealtimeNoopRequested as cU, type RealtimeOutputModality as cV, type RealtimeResponseLifecycle as cW, type RealtimeTranscriptDelta as cX, type RealtimeTranscriptDone as cY, type RealtimeTranscriptEntry as cZ, type RealtimeVoice as c_, type McpServerStatusUpdatedEventMsg as ca, type McpToolCallBeginEvent as cb, type McpToolCallEndEvent as cc, type McpToolCallError as cd, type McpToolCallProgressEvent as ce, type McpToolCallProgressEventMsg as cf, type McpToolCallStatus as cg, type McpToolCallTurnItem as ch, type MemoryCitation as ci, type MemoryCitationEntry as cj, type MentionInput as ck, type MessagePhase as cl, type NetworkPermissions as cm, type NormalizedRequestUserInputQuestion as cn, type PatchApplyStatus as co, type PatchApplyUpdatedEvent as cp, type PatchApplyUpdatedEventMsg as cq, PermissionGrantScope as cr, type PlanDeltaEvent as cs, type PlanDeltaEventMsg as ct, type PlanTurnItem as cu, type PlanUpdateEventMsg as cv, REQUEST_PERMISSIONS_TOOL_NAME as cw, REQUEST_USER_INPUT_TOOL_NAME as cx, type RateLimitWindow as cy, type RawResponseItemEvent as cz, type McpRuntimeEnvironment as d, type WebSearchAction as d$, type ReasoningEffort as d0, type ReasoningTurnItem as d1, type RequestPermissionsEventMsg as d2, type RequestPermissionsResponseOp as d3, type RequestUserInputAnswer as d4, type RequestUserInputArgs as d5, type RequestUserInputEventMsg as d6, type RequestUserInputQuestion as d7, type RequestUserInputQuestionOption as d8, type ResponseRolloutItem as d9, type ThreadRealtimeListVoicesResponse as dA, type ThreadRealtimeStartParams as dB, type ThreadRealtimeStartResponse as dC, type ThreadRealtimeStopParams as dD, type ThreadRealtimeStopResponse as dE, type ThreadRollbackOp as dF, type ThreadRolledBackEvent as dG, type ThreadRolledBackEventMsg as dH, type TokenCountEvent as dI, type TokenCountEventMsg as dJ, type TurnAbortReason as dK, type TurnAbortedEvent as dL, type TurnAbortedEventMsg as dM, type TurnCompleteEvent as dN, type TurnCompleteEventMsg as dO, type TurnContextNetworkItem as dP, type TurnContextRolloutItem as dQ, type TurnStartedEvent as dR, type TurnStartedEventMsg as dS, type UpdatePlanArgs as dT, type UpdatePlanStep as dU, type UpdatePlanStepStatus as dV, type UserInputAnswerOp as dW, type UserMessageEvent as dX, type UserMessageEventMsg as dY, type WarningEvent as dZ, type WarningEventMsg as d_, type ResponsesApiFunctionTool as da, type ResponsesApiNamespace as db, type ResponsesApiNamespaceTool as dc, type ResponsesApiTool as dd, ReviewDecision as de, type SessionConfiguredEvent as df, type SessionConfiguredEventMsg as dg, type SessionMeta as dh, type SessionMetaLine as di, type SessionMetaRolloutItem as dj, type SetThreadMemoryModeOp as dk, type SetThreadNameOp as dl, type ShutdownOp as dm, type StreamOutput as dn, type SubAgentSource as dp, type TerminalInteractionEvent as dq, type TerminalInteractionEventMsg as dr, type ThreadGoalUpdatedEvent as ds, type ThreadGoalUpdatedEventMsg as dt, ThreadMemoryModeSessionMetaValue as du, type ThreadRealtimeAppendAudioParams as dv, type ThreadRealtimeAppendAudioResponse as dw, type ThreadRealtimeAppendTextParams as dx, type ThreadRealtimeAppendTextResponse as dy, type ThreadRealtimeListVoicesParams as dz, type McpServerRefreshConfig as e, type WebSearchTurnItem as e0, assertValidResponsesToolSpecs as e1, cloneRequestPermissionProfile as e2, coalesce_loadable_tool_specs as e3, createRequestPermissionsTool as e4, createRequestUserInputTool as e5, create_tools_json_for_responses_api as e6, default_namespace_description as e7, dynamicToolSpecFromWire as e8, dynamicToolSpecToWire as e9, dynamic_tool_to_loadable_tool_spec as ea, dynamic_tool_to_responses_api_tool as eb, emptyRequestPermissionsResponse as ec, execToolCallOutput as ed, functionCallOutputPayloadToWire as ee, isEmptyRequestPermissionProfile as ef, mcpToolCallableName as eg, mcpToolCallableNamespace as eh, mcpToolDisplayName as ei, modeDisplayName as ej, normalizeRequestPermissionsArgs as ek, normalizeRequestUserInputArgs as el, requestPermissionsToolDescription as em, requestUserInputAvailableModes as en, requestUserInputToolDescription as eo, requestUserInputUnavailableMessage as ep, streamOutput as eq, threadMemoryModeToSessionMetaValue as er, toolSpecName as es, validateThreadGoalObjective as et, type McpServerStatus as f, type McpServerStatusListOptions as g, type McpToolInfo as h, ModeKind as i, type RolloutItem as j, type Submission as k, type ThreadId as l, ThreadMemoryMode as m, allowsRequestUserInput as n, applyCollaborationModeMask as o, asThreadId as p, collaborationModeForModel as q, collaborationModeWithUpdates as r, deniedRequestPermissionsResponse as s, type TurnItem as t, type RequestUserInputEvent as u, type RequestPermissionsEvent as v, type DynamicToolCallRequest as w, type TokenUsageInfo as x, type TruncationPolicy as y, type FunctionCallOutputPayload as z };