@jrkropp/codex-js 0.1.4 → 0.3.0

package/dist/history-CfM-4V7b.d.ts

@@ -1,1654 +0,0 @@
-import { e as McpServerRefreshConfig, d as McpRuntimeEnvironment$1, g as McpServerStatusListOptions, f as McpServerStatus, a6 as McpResourceListParams, a7 as McpResourceListResponse, a8 as McpResourceTemplateListResponse, a9 as McpResourceReadParams, aa as McpResourceReadResponse, ab as McpServerToolCallParams, ac as McpServerToolCallResponse, h as McpToolInfo, ad as McpRequestId, ae as McpServerElicitationResponse, M as McpResourceInfo, c as McpResourceTemplateInfo, l as ThreadId, j as RolloutItem, af as ThreadGoal, ag as ThreadGoalStatus, A as ResponseItem, ah as HookEventName, ai as HookSource, aj as HookRunStatus, ak as HookOutputEntry, al as HookRunSummary, am as HookScope, an as HookCompletedEvent, ao as RequestPermissionsResponse, U as UserInput, H as TokenUsage, ap as RequestUserInputResponse, a5 as DynamicToolResponse, aq as RequestPermissionProfile, X as AskForApproval, Y as ApprovalsReviewer, S as SandboxPolicy, P as PermissionProfile, L as ActivePermissionProfile, Z as WindowsSandboxLevel, Q as ReasoningEffortConfig, V as ReasoningSummaryConfig, N as ServiceTier, C as CollaborationMode, W as Personality, _ as TurnEnvironmentSelection, ar as OverrideTurnContextOp, as as UserInputOp, at as UserInputWithTurnContextOp, au as UserTurnOp, B as BaseInstructions, J as SessionSource, D as DynamicToolSpec, y as TruncationPolicy, E as EventMsg, O as Op, k as Submission, av as NormalizedRequestUserInputArgs, aw as RequestPermissionsArgs, ax as McpServerElicitationRequest, ay as CompactedItem, I as RateLimitSnapshot, x as TokenUsageInfo, az as TurnContextItem, aA as W3cTraceContext, z as FunctionCallOutputPayload } from './protocol-mpBcYHrm.js';
-import { l as ModelInfo, m as ModelProvider } from './index-CoDZosq0.js';
-import { k as ToolsConfig, R as ResolvedConfig } from './spec_plan_types-CmsJ-Tfn.js';
-import { L as LiveThread } from './live-thread-BMvlflzM.js';
-import { P as Prompt, c as ResponseStream, h as ResponsesWebsocketConnection, d as ResponsesApiRequest, T as TurnState$1, j as ResponsesOptions, e as ResponsesClient, g as ResponsesWebsocketClient } from './responses_websocket-BhxSgCzK.js';
-
-type ToolInfo = {
-    server_name: string;
-    name: string;
-    callable_name?: string | null;
-    callable_namespace?: string | null;
-    namespace_description?: string | null;
-    title?: string | null;
-    description?: string | null;
-    input_schema?: unknown;
-    meta?: unknown;
-    connector_id?: string | null;
-    connector_name?: string | null;
-    plugin_display_names?: string[];
-    source_label?: string | null;
-    mcp_app_resource_uri?: string | null;
-};
-type QualifiedToolInfo<T extends ToolInfo = ToolInfo> = T & {
-    callable_name: string;
-    callable_namespace: string;
-    plugin_display_names: string[];
-};
-declare class ToolFilter {
-    readonly enabled: ReadonlySet<string> | null;
-    readonly disabled: ReadonlySet<string>;
-    constructor(enabled?: ReadonlySet<string> | null, disabled?: ReadonlySet<string>);
-    static from_config(config: {
-        enabled_tools?: readonly string[] | null;
-        disabled_tools?: readonly string[] | null;
-    }): ToolFilter;
-    allows(toolName: string): boolean;
-}
-declare function declared_openai_file_input_param_names(meta: unknown): string[];
-declare function tool_with_model_visible_input_schema<T extends ToolInfo>(tool: T): T;
-declare function filter_tools<T extends ToolInfo>(tools: readonly T[], filter: ToolFilter): T[];
-declare function qualify_tools<T extends ToolInfo>(tools: Iterable<T>): Map<string, QualifiedToolInfo<T>>;
-declare function qualify_tool_infos<T extends ToolInfo>(tools: readonly T[]): Array<QualifiedToolInfo<T>>;
-
-declare const CODEX_APPS_TOOLS_CACHE_SCHEMA_VERSION = 2;
-declare const CODEX_APPS_TOOLS_CACHE_DIR = "cache/codex_apps_tools";
-type CodexAuthLike = {
-    account_id?: string | null;
-    chatgpt_user_id?: string | null;
-    is_workspace_account?: boolean | (() => boolean | null | undefined) | null;
-    get_account_id?: () => string | null | undefined;
-    get_chatgpt_user_id?: () => string | null | undefined;
-};
-type CodexAppsToolsCacheKey = {
-    account_id?: string | null;
-    chatgpt_user_id?: string | null;
-    is_workspace_account: boolean;
-};
-declare function codex_apps_tools_cache_key(auth?: CodexAuthLike | null): CodexAppsToolsCacheKey;
-declare function filter_non_codex_apps_mcp_tools_only(mcpTools: ReadonlyMap<string, ToolInfo> | Record<string, ToolInfo>): Map<string, ToolInfo>;
-type CodexAppsToolsCacheStorage = {
-    read(path: string): string | Uint8Array | null | undefined;
-    write(path: string, bytes: string): void;
-};
-declare class InMemoryCodexAppsToolsCacheStorage implements CodexAppsToolsCacheStorage {
-    private readonly files;
-    read(path: string): string | null;
-    write(path: string, bytes: string): void;
-}
-declare class CodexAppsToolsCacheContext {
-    readonly codex_home: string;
-    readonly user_key: CodexAppsToolsCacheKey;
-    readonly storage: CodexAppsToolsCacheStorage | null;
-    constructor(codex_home: string, user_key: CodexAppsToolsCacheKey, storage?: CodexAppsToolsCacheStorage | null);
-    cache_path(): string;
-}
-type CachedCodexAppsToolsLoad = {
-    type: "Hit";
-    tools: ToolInfo[];
-} | {
-    type: "Missing";
-} | {
-    type: "Invalid";
-};
-declare const CachedCodexAppsToolsLoad: {
-    readonly Hit: (tools: ToolInfo[]) => CachedCodexAppsToolsLoad;
-    readonly Missing: CachedCodexAppsToolsLoad;
-    readonly Invalid: CachedCodexAppsToolsLoad;
-};
-declare function normalize_codex_apps_tool_title(server_name: string, connector_name: string | null | undefined, value: string): string;
-declare function normalize_codex_apps_callable_name(server_name: string, tool_name: string, connector_id?: string | null, connector_name?: string | null): string;
-declare function normalize_codex_apps_callable_namespace(server_name: string, connector_name?: string | null): string;
-declare function write_cached_codex_apps_tools_if_needed(server_name: string, cache_context: CodexAppsToolsCacheContext | null | undefined, tools: readonly ToolInfo[]): void;
-declare function load_startup_cached_codex_apps_tools_snapshot(server_name: string, cache_context: CodexAppsToolsCacheContext | null | undefined): ToolInfo[] | null;
-declare function read_cached_codex_apps_tools(cache_context: CodexAppsToolsCacheContext): ToolInfo[] | null;
-declare function load_cached_codex_apps_tools(cache_context: CodexAppsToolsCacheContext): CachedCodexAppsToolsLoad;
-declare function write_cached_codex_apps_tools(cache_context: CodexAppsToolsCacheContext, tools: readonly ToolInfo[]): void;
-declare function filter_disallowed_codex_apps_tools(tools: ToolInfo[]): ToolInfo[];
-declare function sanitize_name(name: string): string;
-declare function is_connector_id_allowed(connector_id: string, first_party_chat_originator?: boolean): boolean;
-
-declare const MCP_SANDBOX_STATE_META_CAPABILITY = "codex/sandbox-state-meta";
-declare const MCP_TOOLS_LIST_DURATION_METRIC = "codex.mcp.tools.list.duration_ms";
-declare const MCP_TOOLS_FETCH_UNCACHED_DURATION_METRIC = "codex.mcp.tools.fetch_uncached.duration_ms";
-declare const DEFAULT_STARTUP_TIMEOUT = 30000;
-declare const DEFAULT_TOOL_TIMEOUT = 120000;
-type McpServerTransportConfig = {
-    type: "streamable_http";
-    url: string;
-    bearer_token_env_var?: string | null;
-    http_headers?: Record<string, string> | null;
-    env_http_headers?: Record<string, string> | null;
-    oauth_tokens_present?: boolean | null;
-} | {
-    type: "stdio";
-    command: string;
-    args?: readonly string[];
-    env?: Record<string, string> | null;
-    env_vars?: readonly string[];
-    cwd?: string | null;
-};
-type McpServerConfig$1 = {
-    transport: McpServerTransportConfig;
-    enabled?: boolean;
-    required?: boolean;
-    startup_timeout_sec?: number | null;
-    tool_timeout_sec?: number | null;
-    enabled_tools?: readonly string[] | null;
-    disabled_tools?: readonly string[] | null;
-    experimental_environment?: string | null;
-};
-type McpRuntimeEnvironment = {
-    cwd?: string | null;
-    environment_id?: string | null;
-    remote?: boolean | null;
-};
-type McpClientFactoryOptions = {
-    fetch?: typeof fetch;
-    environment?: Record<string, string | undefined>;
-    stdio_server_launcher?: StdioServerLauncher | null;
-    runtime_environment?: McpRuntimeEnvironment | null;
-};
-type StdioServerLauncher = {
-    launch(server_name: string, config: Extract<McpServerTransportConfig, {
-        type: "stdio";
-    }>, runtime_environment?: McpRuntimeEnvironment | null): Promise<RmcpClientLike>;
-};
-type McpJsonRpcMessage = {
-    jsonrpc: "2.0";
-    id?: string | number;
-    method?: string;
-    params?: unknown;
-    result?: unknown;
-    error?: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-};
-type McpJsonRpcTransport = {
-    request(message: McpJsonRpcMessage, timeout?: number | null): Promise<McpJsonRpcMessage>;
-    notify?(message: McpJsonRpcMessage, timeout?: number | null): Promise<void>;
-    close?(): Promise<void> | void;
-};
-type RmcpRawTool = {
-    name: string;
-    title?: string | null;
-    description?: string | null;
-    input_schema?: unknown;
-    meta?: unknown;
-    connector_id?: string | null;
-    connector_name?: string | null;
-    connector_description?: string | null;
-};
-type RmcpListToolsResult = readonly ToolInfo[] | readonly RmcpRawTool[] | {
-    tools: readonly (ToolInfo | RmcpRawTool | ({
-        tool: RmcpRawTool;
-    } & Record<string, unknown>))[];
-};
-type RmcpClientLike = {
-    initialize?: (timeout?: number | null) => Promise<RmcpInitializeResult>;
-    list_tools?: (params?: unknown, timeout?: number | null) => Promise<RmcpListToolsResult>;
-    call_tool?: (tool: string, arguments_: unknown, meta?: unknown, timeout?: number | null) => Promise<unknown>;
-    list_resources?: (params?: unknown, timeout?: number | null) => Promise<unknown>;
-    list_resource_templates?: (params?: unknown, timeout?: number | null) => Promise<unknown>;
-    read_resource?: (params: unknown, timeout?: number | null) => Promise<unknown>;
-    shutdown?: () => Promise<void> | void;
-};
-type RmcpInitializeResult = {
-    instructions?: string | null;
-    capabilities?: {
-        experimental?: Record<string, unknown> | null;
-        [key: string]: unknown;
-    } | null;
-};
-type ManagedClientInput = {
-    client?: RmcpClientLike | null;
-    tools?: readonly ToolInfo[];
-    tool_filter?: ToolFilter;
-    tool_timeout?: number | null;
-    server_instructions?: string | null;
-    server_supports_sandbox_state_meta_capability?: boolean;
-    codex_apps_tools_cache_context?: CodexAppsToolsCacheContext | null;
-};
-declare class ManagedClient {
-    readonly client: RmcpClientLike | null;
-    readonly tools: readonly ToolInfo[];
-    readonly tool_filter: ToolFilter;
-    readonly tool_timeout: number | null;
-    readonly server_instructions: string | null;
-    readonly server_supports_sandbox_state_meta_capability: boolean;
-    readonly codex_apps_tools_cache_context: CodexAppsToolsCacheContext | null;
-    constructor(input?: ManagedClientInput);
-    listed_tools(): ToolInfo[];
-    call_tool(tool: string, arguments_: unknown, meta?: unknown): Promise<unknown>;
-    list_resources(params?: unknown): Promise<unknown>;
-    list_resource_templates(params?: unknown): Promise<unknown>;
-    read_resource(params: unknown): Promise<unknown>;
-    shutdown(): Promise<void>;
-}
-type AsyncManagedClientInput = {
-    client: ManagedClient | Promise<ManagedClient> | (() => ManagedClient | Promise<ManagedClient>);
-    startup_snapshot?: readonly ToolInfo[] | null;
-    tool_plugin_provenance?: ToolPluginProvenance;
-    cancel_token?: CancellationToken;
-};
-type AsyncManagedClientStartupStatus = {
-    status: "starting";
-} | {
-    status: "ready";
-} | {
-    status: "cancelled";
-} | {
-    status: "failed";
-    error: string;
-};
-declare class AsyncManagedClient {
-    private readonly client_promise;
-    private readonly startup_snapshot;
-    private readonly startup_complete;
-    private readonly tool_plugin_provenance;
-    private readonly cancel_token;
-    private startup_status_value;
-    constructor(input: AsyncManagedClientInput);
-    static from_managed_client(client: ManagedClient, startup_snapshot?: readonly ToolInfo[] | null): AsyncManagedClient;
-    static new(server_name: string, input: {
-        client: RmcpClientLike | Promise<RmcpClientLike> | (() => RmcpClientLike | Promise<RmcpClientLike>);
-        tool_filter?: ToolFilter;
-        tool_timeout?: number | null;
-        server_instructions?: string | null;
-        codex_apps_tools_cache_context?: CodexAppsToolsCacheContext | null;
-        tool_plugin_provenance?: ToolPluginProvenance;
-    }): AsyncManagedClient;
-    static from_config(server_name: string, config: McpServerConfig$1, options?: {
-        codex_apps_tools_cache_context?: CodexAppsToolsCacheContext | null;
-        tool_plugin_provenance?: ToolPluginProvenance;
-        client_factory_options?: McpClientFactoryOptions;
-    }): AsyncManagedClient;
-    client(): Promise<ManagedClient>;
-    shutdown(): Promise<void>;
-    startup_status(): AsyncManagedClientStartupStatus;
-    listed_tools(): Promise<ToolInfo[] | null>;
-    private startup_snapshot_while_initializing;
-    private listed_tools_from_client;
-    private annotate_tools;
-}
-declare class StartupOutcomeError extends Error {
-    readonly kind: "Cancelled" | "Failed";
-    readonly error?: string | undefined;
-    private constructor();
-    static cancelled(): StartupOutcomeError;
-    static failed(error: string): StartupOutcomeError;
-}
-declare class CancellationToken {
-    private cancelled;
-    cancel(): void;
-    is_cancelled(): boolean;
-    child_token(): CancellationToken;
-}
-declare function elicitation_capability_for_server(): Record<string, never>;
-declare function start_server_task(server_name: string, client: RmcpClientLike, params: {
-    startup_timeout?: number | null;
-    tool_timeout?: number | null;
-    tool_filter?: ToolFilter;
-    codex_apps_tools_cache_context?: CodexAppsToolsCacheContext | null;
-}): Promise<ManagedClient>;
-declare function make_rmcp_client(server_name: string, config: McpServerConfig$1, options?: McpClientFactoryOptions): Promise<RmcpClientLike>;
-declare class RmcpJsonRpcClient implements RmcpClientLike {
-    readonly transport: McpJsonRpcTransport;
-    private next_id;
-    constructor(transport: McpJsonRpcTransport);
-    initialize(timeout?: number | null): Promise<RmcpInitializeResult>;
-    list_tools(params?: unknown, timeout?: number | null): Promise<RmcpListToolsResult>;
-    call_tool(tool: string, arguments_: unknown, meta?: unknown, timeout?: number | null): Promise<unknown>;
-    list_resources(params?: unknown, timeout?: number | null): Promise<unknown>;
-    list_resource_templates(params?: unknown, timeout?: number | null): Promise<unknown>;
-    read_resource(params: unknown, timeout?: number | null): Promise<unknown>;
-    shutdown(): Promise<void>;
-    private request;
-    private notify;
-}
-declare class StreamableHttpMcpTransport implements McpJsonRpcTransport {
-    private readonly fetch_impl;
-    private readonly headers;
-    constructor(input: {
-        url: string;
-        headers?: Record<string, string>;
-        fetch?: typeof fetch;
-    });
-    readonly url: string;
-    request(message: McpJsonRpcMessage, timeout?: number | null): Promise<McpJsonRpcMessage>;
-    notify(message: McpJsonRpcMessage, timeout?: number | null): Promise<void>;
-    private post;
-}
-declare class UnsupportedStdioServerLauncher implements StdioServerLauncher {
-    launch(server_name: string): Promise<RmcpClientLike>;
-}
-declare function list_tools_for_client_uncached(server_name: string, client: RmcpClientLike, timeout?: number | null, server_instructions?: string | null): Promise<ToolInfo[]>;
-declare function validate_mcp_server_name(server_name: string): void;
-
-type McpAuthStatus = "unsupported" | "notLoggedIn" | "bearerToken" | "oAuth";
-type OAuthCredentialsStoreMode = unknown;
-type McpServerConfig = {
-    enabled?: boolean;
-    transport: McpServerTransportConfig;
-    scopes?: readonly string[] | null;
-    oauth_tokens_present?: boolean | null;
-    startup_timeout_sec?: number | null;
-};
-type CodexMcpAuthLike = {
-    uses_codex_backend?: boolean | (() => boolean | null | undefined) | null;
-};
-type McpOAuthLoginConfig = {
-    url: string;
-    http_headers?: Record<string, string> | null;
-    env_http_headers?: Record<string, string> | null;
-    discovered_scopes?: string[] | null;
-};
-type McpOAuthLoginSupport = {
-    type: "Supported";
-    config: McpOAuthLoginConfig;
-} | {
-    type: "Unsupported";
-} | {
-    type: "Unknown";
-    error: Error;
-};
-declare const McpOAuthLoginSupport: {
-    readonly Supported: (config: McpOAuthLoginConfig) => McpOAuthLoginSupport;
-    readonly Unsupported: McpOAuthLoginSupport;
-    readonly Unknown: (error: unknown) => McpOAuthLoginSupport;
-};
-declare const McpOAuthScopesSource: {
-    readonly Explicit: "Explicit";
-    readonly Configured: "Configured";
-    readonly Discovered: "Discovered";
-    readonly Empty: "Empty";
-};
-type McpOAuthScopesSource = (typeof McpOAuthScopesSource)[keyof typeof McpOAuthScopesSource];
-type ResolvedMcpOAuthScopes = {
-    scopes: string[];
-    source: McpOAuthScopesSource;
-};
-type McpAuthStatusEntry = {
-    config: McpServerConfig;
-    auth_status: McpAuthStatus;
-};
-declare class OAuthProviderError extends Error {
-    readonly error?: string | null | undefined;
-    readonly error_description?: string | null | undefined;
-    constructor(error?: string | null | undefined, error_description?: string | null | undefined);
-}
-declare function oauth_login_support(transport: McpServerTransportConfig): Promise<McpOAuthLoginSupport>;
-declare function discover_supported_scopes(transport: McpServerTransportConfig): Promise<string[] | null>;
-declare function resolve_oauth_scopes(explicit_scopes?: readonly string[] | null, configured_scopes?: readonly string[] | null, discovered_scopes?: readonly string[] | null): ResolvedMcpOAuthScopes;
-declare function should_retry_without_scopes(scopes: ResolvedMcpOAuthScopes, error: unknown): boolean;
-declare function compute_auth_statuses(servers: ReadonlyMap<string, McpServerConfig> | Record<string, McpServerConfig> | Iterable<[string, McpServerConfig]>, store_mode?: OAuthCredentialsStoreMode, auth?: CodexMcpAuthLike | null): Promise<Map<string, McpAuthStatusEntry>>;
-declare function compute_auth_status(server_name: string, config: McpServerConfig, _store_mode?: OAuthCredentialsStoreMode, has_runtime_auth?: boolean): Promise<McpAuthStatus>;
-type StreamableHttpOAuthDiscovery = {
-    scopes_supported?: string[] | null;
-};
-declare function discover_streamable_http_oauth(url: string, http_headers?: Record<string, string> | null, env_http_headers?: Record<string, string> | null): Promise<StreamableHttpOAuthDiscovery | null>;
-declare function discovery_paths(base_path: string): string[];
-
-declare const MCP_TOOL_NAME_PREFIX = "mcp";
-declare const MCP_TOOL_NAME_DELIMITER = "__";
-declare const CODEX_APPS_MCP_SERVER_NAME = "codex_apps";
-declare function sanitize_responses_api_tool_name(name: string): string;
-declare function qualified_mcp_tool_name_prefix(serverName: string): string;
-
-declare class ToolPluginProvenance {
-    private readonly plugin_display_names_by_connector_id;
-    private readonly plugin_display_names_by_mcp_server_name;
-    constructor(input?: {
-        plugin_display_names_by_connector_id?: ReadonlyMap<string, readonly string[]> | Record<string, readonly string[]>;
-        plugin_display_names_by_mcp_server_name?: ReadonlyMap<string, readonly string[]> | Record<string, readonly string[]>;
-    });
-    plugin_display_names_for_connector_id(connectorId: string): readonly string[];
-    plugin_display_names_for_mcp_server_name(serverName: string): readonly string[];
-}
-
-type RequestId = string | number;
-type ElicitationAction = "accept" | "decline" | "cancel";
-type ElicitationResponse = {
-    action: ElicitationAction;
-    content?: unknown;
-    meta?: unknown;
-};
-type CreateElicitationRequestParams = {
-    type: "form";
-    meta?: unknown;
-    message: string;
-    requested_schema: {
-        properties?: Record<string, unknown>;
-        [key: string]: unknown;
-    };
-} | {
-    type: "url";
-    meta?: unknown;
-    message: string;
-    url: string;
-    elicitation_id?: string | null;
-};
-type ElicitationRequestEvent = {
-    id: "mcp_elicitation_request";
-    msg: {
-        type: "elicitation_request";
-        turn_id: null;
-        server_name: string;
-        id: RequestId;
-        request: {
-            type: "form";
-            meta?: unknown;
-            message: string;
-            requested_schema: unknown;
-        } | {
-            type: "url";
-            meta?: unknown;
-            message: string;
-            url: string;
-            elicitation_id?: string | null;
-        };
-    };
-};
-type ElicitationReviewRequest = {
-    server_name: string;
-    request_id: RequestId;
-    elicitation: CreateElicitationRequestParams;
-};
-type ElicitationReviewer = {
-    review(request: ElicitationReviewRequest): Promise<ElicitationResponse | null | undefined>;
-};
-type ElicitationReviewerHandle = ElicitationReviewer;
-type ElicitationEventSink = ((event: ElicitationRequestEvent) => Promise<void> | void) | {
-    send(event: ElicitationRequestEvent): Promise<void> | void;
-};
-type SendElicitation = (id: RequestId, elicitation: CreateElicitationRequestParams) => Promise<ElicitationResponse>;
-declare class ElicitationRequestManager {
-    private readonly reviewer;
-    private readonly requests;
-    private approval_policy;
-    private permission_profile;
-    private auto_deny_value;
-    constructor(approval_policy: unknown, permission_profile: unknown, reviewer?: ElicitationReviewerHandle | null);
-    auto_deny(): boolean;
-    set_auto_deny(auto_deny: boolean): void;
-    set_approval_policy(approval_policy: unknown): void;
-    set_permission_profile(permission_profile: unknown): void;
-    resolve(server_name: string, id: RequestId, response: ElicitationResponse): Promise<void>;
-    make_sender(server_name: string, tx_event: ElicitationEventSink): SendElicitation;
-}
-declare function elicitation_is_rejected_by_policy(approval_policy: unknown): boolean;
-declare function can_auto_accept_elicitation(elicitation: CreateElicitationRequestParams): boolean;
-type McpPermissionPromptAutoApproveContext = {
-    approvals_reviewer?: unknown;
-    tool_approval_mode?: string | null;
-};
-declare function mcp_permission_prompt_is_auto_approved(approval_policy: unknown, permission_profile: unknown, context?: McpPermissionPromptAutoApproveContext): boolean;
-
-type McpConnectionManagerInput = {
-    clients?: ReadonlyMap<string, AsyncManagedClient> | Record<string, AsyncManagedClient>;
-    server_origins?: ReadonlyMap<string, string> | Record<string, string>;
-    host_owned_codex_apps_enabled?: boolean;
-    elicitation_requests?: ElicitationRequestManager | null;
-};
-type McpStartupFailure = {
-    server: string;
-    error: string;
-};
-type McpStartupStatus = AsyncManagedClientStartupStatus;
-declare class McpConnectionManager$1 {
-    readonly clients: Map<string, AsyncManagedClient>;
-    private readonly server_origins;
-    private readonly elicitation_requests;
-    private host_owned_codex_apps_enabled;
-    private startup_cancelled;
-    constructor(input?: McpConnectionManagerInput);
-    static new_uninitialized(): McpConnectionManager$1;
-    static from_managed_clients(clients: ReadonlyMap<string, ManagedClient> | Record<string, ManagedClient>): McpConnectionManager$1;
-    static from_rmcp_clients(clients: ReadonlyMap<string, RmcpClientLike> | Record<string, RmcpClientLike>, options?: {
-        tool_filter_by_server?: ReadonlyMap<string, ToolFilter> | Record<string, ToolFilter>;
-        tool_timeout?: number | null;
-        codex_apps_tools_cache_context?: CodexAppsToolsCacheContext | null;
-        tool_plugin_provenance?: ToolPluginProvenance;
-    }): McpConnectionManager$1;
-    static from_config(mcp_servers: ReadonlyMap<string, McpServerConfig$1> | Record<string, McpServerConfig$1>, options?: {
-        client_factory_options?: McpClientFactoryOptions;
-        codex_apps_tools_cache_context?: CodexAppsToolsCacheContext | null;
-        host_owned_codex_apps_enabled?: boolean;
-        tool_plugin_provenance?: ToolPluginProvenance;
-        elicitation_requests?: ElicitationRequestManager | null;
-    }): McpConnectionManager$1;
-    has_servers(): boolean;
-    begin_shutdown(): Promise<void>;
-    shutdown(): Promise<void>;
-    server_origin(server_name: string): string | null;
-    is_host_owned_codex_apps_server(server_name: string): boolean;
-    set_approval_policy(approval_policy: unknown): void;
-    set_permission_profile(permission_profile: unknown): void;
-    elicitations_auto_deny(): boolean;
-    set_elicitations_auto_deny(auto_deny: boolean): void;
-    resolve_elicitation(server_name: string, id: string | number, response: ElicitationResponse): Promise<void>;
-    wait_for_server_ready(server_name: string, timeout_ms?: number): Promise<boolean>;
-    required_startup_failures(required_servers: readonly string[]): Promise<McpStartupFailure[]>;
-    startup_statuses(): Map<string, McpStartupStatus>;
-    list_all_tools(): Promise<Map<string, ToolInfo>>;
-    hard_refresh_codex_apps_tools_cache(): Promise<Map<string, ToolInfo>>;
-    list_all_resources(): Promise<Map<string, unknown[]>>;
-    list_all_resource_templates(): Promise<Map<string, unknown[]>>;
-    call_tool(server: string, tool: string, arguments_: unknown, meta?: unknown): Promise<unknown>;
-    server_supports_sandbox_state_meta_capability(server: string): Promise<boolean>;
-    list_resources(server: string, params?: unknown): Promise<unknown>;
-    list_resource_templates(server: string, params?: unknown): Promise<unknown>;
-    read_resource(server: string, params: unknown): Promise<unknown>;
-    resolve_tool_info(tool_name: string | {
-        namespace?: string | null;
-        name: string;
-    }): Promise<ToolInfo | null>;
-    private client_by_name;
-}
-declare function transport_origin(transport: McpServerTransportConfig): string | null;
-declare function mcp_init_error_display(server_name: string, entry: McpAuthStatusEntry | null | undefined, err: unknown): string;
-declare function startup_outcome_error_message(error: unknown): string;
-declare function is_mcp_client_auth_required_error(error: unknown): boolean;
-declare function is_mcp_client_startup_timeout_error(error: unknown): boolean;
-
-interface McpConnectionManager {
-    refresh_mcp_servers_now(config: McpServerRefreshConfig, environment: McpRuntimeEnvironment$1): Promise<void>;
-    list_server_statuses(options?: McpServerStatusListOptions): Promise<McpServerStatus[]>;
-    list_resources(params: McpResourceListParams): Promise<McpResourceListResponse>;
-    list_resource_templates(params: McpResourceListParams): Promise<McpResourceTemplateListResponse>;
-    read_resource(params: McpResourceReadParams): Promise<McpResourceReadResponse>;
-    call_tool(params: McpServerToolCallParams): Promise<McpServerToolCallResponse>;
-    resolve_tool_info(serverName: string, toolName: string): Promise<McpToolInfo | null>;
-    list_tools(): Promise<McpToolInfo[]>;
-    resolve_elicitation(serverName: string, id: McpRequestId, response: McpServerElicitationResponse): Promise<void>;
-    shutdown(): Promise<void>;
-}
-declare class EmptyMcpConnectionManager implements McpConnectionManager {
-    static readonly instance: EmptyMcpConnectionManager;
-    refresh_mcp_servers_now(): Promise<void>;
-    list_server_statuses(): Promise<McpServerStatus[]>;
-    list_resources(params: McpResourceListParams): Promise<McpResourceListResponse>;
-    list_resource_templates(params: McpResourceListParams): Promise<McpResourceTemplateListResponse>;
-    read_resource(params: McpResourceReadParams): Promise<McpResourceReadResponse>;
-    call_tool(params: McpServerToolCallParams): Promise<McpServerToolCallResponse>;
-    resolve_tool_info(): Promise<McpToolInfo | null>;
-    list_tools(): Promise<McpToolInfo[]>;
-    resolve_elicitation(serverName: string): Promise<void>;
-    shutdown(): Promise<void>;
-}
-type CodexMcpConnectionManagerAdapterOptions = {
-    client_factory_options?: McpClientFactoryOptions;
-};
-declare class CodexMcpConnectionManagerAdapter implements McpConnectionManager {
-    private manager;
-    private readonly client_factory_options?;
-    private configured_servers;
-    private auth_statuses;
-    constructor(manager?: McpConnectionManager$1, options?: CodexMcpConnectionManagerAdapterOptions);
-    refresh_mcp_servers_now(config: McpServerRefreshConfig, environment: McpRuntimeEnvironment$1): Promise<void>;
-    list_server_statuses(options?: McpServerStatusListOptions): Promise<McpServerStatus[]>;
-    list_resources(params: McpResourceListParams): Promise<McpResourceListResponse>;
-    list_resource_templates(params: McpResourceListParams): Promise<McpResourceTemplateListResponse>;
-    read_resource(params: McpResourceReadParams): Promise<McpResourceReadResponse>;
-    call_tool(params: McpServerToolCallParams): Promise<McpServerToolCallResponse>;
-    resolve_tool_info(serverName: string, toolName: string): Promise<McpToolInfo | null>;
-    list_tools(): Promise<McpToolInfo[]>;
-    resolve_elicitation(serverName: string, id: McpRequestId, response: McpServerElicitationResponse): Promise<void>;
-    shutdown(): Promise<void>;
-    required_startup_failures(required_servers: readonly string[]): Promise<McpStartupFailure[]>;
-}
-declare function normalize_mcp_server_configs(input: Record<string, unknown>): Map<string, McpServerConfig$1>;
-declare function normalize_mcp_server_config(serverName: string, value: unknown): McpServerConfig$1;
-type StaticMcpConnectionManagerOptions = {
-    resources?: Record<string, ReadonlyArray<McpResourceInfo>>;
-    resource_templates?: Record<string, ReadonlyArray<McpResourceTemplateInfo>>;
-    read_resources?: Record<string, McpResourceReadResponse>;
-};
-declare class StaticMcpConnectionManager implements McpConnectionManager {
-    private readonly tools;
-    private readonly resources;
-    private readonly resource_templates;
-    private readonly read_resources;
-    constructor(tools?: readonly McpToolInfo[], options?: StaticMcpConnectionManagerOptions);
-    refresh_mcp_servers_now(): Promise<void>;
-    list_server_statuses(options?: McpServerStatusListOptions): Promise<McpServerStatus[]>;
-    list_resources(params: McpResourceListParams): Promise<McpResourceListResponse>;
-    list_resource_templates(params: McpResourceListParams): Promise<McpResourceTemplateListResponse>;
-    read_resource(params: McpResourceReadParams): Promise<McpResourceReadResponse>;
-    call_tool(params: McpServerToolCallParams): Promise<McpServerToolCallResponse>;
-    resolve_tool_info(serverName: string, toolName: string): Promise<McpToolInfo | null>;
-    list_tools(): Promise<McpToolInfo[]>;
-    resolve_elicitation(): Promise<void>;
-    shutdown(): Promise<void>;
-}
-
-declare class AgentPath {
-    private readonly value;
-    static readonly ROOT = "/root";
-    private constructor();
-    static root(): AgentPath;
-    static parse(value: string): AgentPath;
-    isRoot(): boolean;
-    toString(): string;
-}
-declare const DEFAULT_ROLE_NAME = "default";
-type AgentRoleConfig = {
-    name: string;
-    description?: string | null;
-    instructions?: string | null;
-    nickname_candidates?: string[] | null;
-};
-declare function resolve_role_config(roles: Record<string, AgentRoleConfig> | null | undefined, role_name?: string): AgentRoleConfig | null;
-declare function builtin_agent_roles(): Record<string, AgentRoleConfig>;
-declare function default_agent_nickname_list(): string[];
-
-type AgentMetadata = {
-    agent_id?: ThreadId | null;
-    agent_path?: AgentPath | null;
-    agent_nickname?: string | null;
-    agent_role?: string | null;
-    last_task_message?: string | null;
-};
-type LiveAgent = {
-    thread_id: ThreadId;
-    metadata: AgentMetadata;
-    status: AgentStatus;
-};
-type ListedAgent = {
-    agent_name: string;
-    agent_status: AgentStatus;
-    last_task_message?: string | null;
-};
-declare const AgentStatus: {
-    readonly Running: "running";
-    readonly Completed: "completed";
-    readonly Failed: "failed";
-    readonly Closed: "closed";
-    readonly Cancelled: "cancelled";
-};
-type AgentStatus = (typeof AgentStatus)[keyof typeof AgentStatus];
-declare class AgentRegistry {
-    private readonly agent_tree;
-    private readonly used_agent_nicknames;
-    private total_count;
-    private nickname_reset_count;
-    reserve_spawn_slot(max_threads?: number | null): SpawnReservation;
-    release_spawned_thread(thread_id: ThreadId): void;
-    release_spawn_slot(): void;
-    register_root_thread(thread_id: ThreadId): void;
-    agent_id_for_path(agent_path: AgentPath): ThreadId | null;
-    agent_metadata_for_thread(thread_id: ThreadId): AgentMetadata | null;
-    live_agents(): AgentMetadata[];
-    update_last_task_message(thread_id: ThreadId, last_task_message: string): void;
-    register_spawned_thread(agent_metadata: AgentMetadata): void;
-    reserve_agent_nickname(names: readonly string[], preferred?: string | null): string | null;
-    reserve_agent_path(agent_path: AgentPath): void;
-    private reset_and_select_nickname;
-}
-declare class SpawnReservation {
-    private readonly registry;
-    private active;
-    constructor(registry: AgentRegistry);
-    commit(metadata: AgentMetadata): void;
-    release(): void;
-}
-declare function next_thread_spawn_depth(session_source: unknown): number;
-declare function exceeds_thread_spawn_depth_limit(depth: number, max_depth: number): boolean;
-
-type InterAgentCommunication = {
-    author: AgentPath;
-    recipient: AgentPath;
-    items: unknown[];
-    content: string;
-    trigger_turn: boolean;
-    seq?: number;
-};
-declare class Mailbox {
-    private readonly pending;
-    private next_seq;
-    static new(): {
-        mailbox: Mailbox;
-        receiver: MailboxReceiver;
-    };
-    send(communication: Omit<InterAgentCommunication, "seq">): number;
-    drain(): InterAgentCommunication[];
-    has_pending(): boolean;
-    has_pending_trigger_turn(): boolean;
-}
-declare class MailboxReceiver {
-    private readonly mailbox;
-    constructor(mailbox: Mailbox);
-    has_pending(): boolean;
-    has_pending_trigger_turn(): boolean;
-    drain(): InterAgentCommunication[];
-}
-
-declare const SpawnAgentForkMode: {
-    readonly FullHistory: "full_history";
-    readonly LastNTurns: "last_n_turns";
-};
-type SpawnAgentForkMode = {
-    type: typeof SpawnAgentForkMode.FullHistory;
-} | {
-    type: typeof SpawnAgentForkMode.LastNTurns;
-    turns: number;
-};
-type SpawnAgentOptions = {
-    fork_parent_spawn_call_id?: string | null;
-    fork_mode?: SpawnAgentForkMode | null;
-    environments?: unknown[] | null;
-};
-type AgentControlExecutor = {
-    spawn_agent?(input: {
-        initial_operation: unknown;
-        session_source?: unknown;
-        options?: SpawnAgentOptions;
-    }): Promise<LiveAgent>;
-    send_input?(input: {
-        target: ThreadId;
-        message?: string | null;
-        items?: unknown[] | null;
-        interrupt?: boolean;
-    }): Promise<unknown>;
-    wait_agent?(input: {
-        targets: ThreadId[];
-        timeout_ms?: number | null;
-    }): Promise<unknown>;
-    close_agent?(input: {
-        target: ThreadId;
-    }): Promise<unknown>;
-    resume_agent?(input: {
-        id: ThreadId;
-    }): Promise<unknown>;
-};
-declare class AgentControl {
-    private readonly executor;
-    readonly registry: AgentRegistry;
-    readonly mailbox: Mailbox;
-    constructor(executor?: AgentControlExecutor | null);
-    static empty(): AgentControl;
-    spawn_agent_with_metadata(input: {
-        initial_operation: unknown;
-        session_source?: unknown;
-        options?: SpawnAgentOptions;
-    }): Promise<LiveAgent>;
-    send_input(input: {
-        target: ThreadId;
-        message?: string | null;
-        items?: unknown[] | null;
-        interrupt?: boolean;
-    }): Promise<unknown>;
-    wait_agent(input: {
-        targets: ThreadId[];
-        timeout_ms?: number | null;
-    }): Promise<unknown>;
-    close_agent(input: {
-        target: ThreadId;
-    }): Promise<unknown>;
-    resume_agent(input: {
-        id: ThreadId;
-    }): Promise<unknown>;
-    list_agents(): ListedAgent[];
-    send_mail(communication: Omit<InterAgentCommunication, "seq">): number;
-}
-
-declare function keep_forked_rollout_item(item: RolloutItem): boolean;
-
-type ThreadGoalUpdate = {
-    status?: ThreadGoalStatus;
-    token_budget?: number | null;
-    expected_goal_id?: string | null;
-};
-declare const ThreadGoalAccountingMode: {
-    readonly ActiveStatusOnly: "active_status_only";
-    readonly ActiveOnly: "active_only";
-    readonly ActiveOrComplete: "active_or_complete";
-    readonly ActiveOrStopped: "active_or_stopped";
-};
-type ThreadGoalAccountingMode = (typeof ThreadGoalAccountingMode)[keyof typeof ThreadGoalAccountingMode];
-type ThreadGoalAccountingOutcome = {
-    type: "updated";
-    goal: ThreadGoal;
-} | {
-    type: "unchanged";
-    goal: ThreadGoal | null;
-};
-type ThreadGoalStore = {
-    getThreadGoal(threadId: ThreadId): Promise<ThreadGoal | null>;
-    replaceThreadGoal(params: {
-        thread_id: ThreadId;
-        objective: string;
-        status: ThreadGoalStatus;
-        token_budget?: number | null;
-    }): Promise<ThreadGoal>;
-    insertThreadGoal(params: {
-        thread_id: ThreadId;
-        objective: string;
-        status: ThreadGoalStatus;
-        token_budget?: number | null;
-    }): Promise<ThreadGoal>;
-    updateThreadGoal(params: {
-        thread_id: ThreadId;
-        update: ThreadGoalUpdate;
-    }): Promise<ThreadGoal>;
-    pauseActiveThreadGoal(threadId: ThreadId): Promise<ThreadGoal | null>;
-    deleteThreadGoal(threadId: ThreadId): Promise<void>;
-    accountThreadGoalUsage(params: {
-        thread_id: ThreadId;
-        tokens_used_delta?: number;
-        time_used_seconds_delta?: number;
-        mode?: ThreadGoalAccountingMode;
-    }): Promise<ThreadGoalAccountingOutcome>;
-};
-type GoalRuntimeEvent = {
-    type: "turn_started";
-    turn_id: string;
-    total_tokens: number;
-} | {
-    type: "tool_completed";
-    turn_id: string;
-    tool_name: string;
-    total_tokens: number;
-} | {
-    type: "tool_completed_goal";
-    turn_id: string;
-    total_tokens: number;
-} | {
-    type: "turn_finished";
-    turn_id: string;
-    total_tokens: number;
-} | {
-    type: "task_aborted";
-    turn_id: string;
-    total_tokens: number;
-} | {
-    type: "thread_resumed";
-};
-type GoalRuntimeApplyResult = {
-    goal_updated?: ThreadGoal | null;
-};
-type GoalTurnAccountingSnapshot = {
-    total_tokens: number;
-    started_at_ms: number;
-    last_accounted_total_tokens: number;
-    last_accounted_at_ms: number;
-};
-type CreateGoalRequest = {
-    objective: string;
-    token_budget?: number | null;
-};
-type SetGoalRequest = {
-    objective?: string | null;
-    status?: ThreadGoalStatus | null;
-    token_budget?: number | null;
-};
-type GoalToolOutput = {
-    goal: ThreadGoal | null;
-    remaining_token_budget: number | null;
-};
-type GoalSteeringItem = ResponseItem;
-
-declare const HOOK_EVENT_NAMES: readonly ["PreToolUse", "PermissionRequest", "PostToolUse", "PreCompact", "PostCompact", "SessionStart", "UserPromptSubmit", "Stop"];
-declare const HOOK_EVENT_NAMES_WITH_MATCHERS: readonly ["PreToolUse", "PermissionRequest", "PostToolUse", "PreCompact", "PostCompact", "SessionStart"];
-type ConfiguredHookHandler = {
-    event_name: HookEventName;
-    matcher?: string | null;
-    name?: string | null;
-    status_message?: string | null;
-    source_path?: string | null;
-    source?: HookSource;
-    display_order?: number;
-    run?: (request: unknown) => Promise<HookHandlerResult> | HookHandlerResult;
-};
-type HookHandlerResult = {
-    status?: HookRunStatus;
-    entries?: HookOutputEntry[];
-    additional_contexts?: string[];
-    block_reason?: string | null;
-    stop_reason?: string | null;
-    feedback_message?: string | null;
-    permission_decision?: PermissionRequestDecision | null;
-};
-declare const PermissionRequestDecision: {
-    readonly Allow: "allow";
-    readonly Deny: "deny";
-};
-type PermissionRequestDecision = {
-    type: typeof PermissionRequestDecision.Allow;
-} | {
-    type: typeof PermissionRequestDecision.Deny;
-    message?: string | null;
-};
-declare function runningHookRunSummary(handler: ConfiguredHookHandler, now?: number): HookRunSummary;
-declare function completedHookRunSummary(handler: ConfiguredHookHandler, result: HookHandlerResult, input: {
-    started_at: number;
-    completed_at?: number;
-}): HookRunSummary;
-declare function hookRunId(handler: ConfiguredHookHandler): string;
-declare function scopeForHookEvent(eventName: HookEventName): HookScope;
-
-type HookRuntimeOutcome = {
-    should_stop: boolean;
-    stop_reason?: string | null;
-    additional_contexts: string[];
-};
-type SessionStartRequest = {
-    session_id: string;
-    turn_id: string;
-    cwd: string;
-    transcript_path?: string | null;
-    model: string;
-    permission_mode: string;
-    source: string;
-};
-type UserPromptSubmitRequest = {
-    session_id: string;
-    turn_id: string;
-    cwd: string;
-    transcript_path?: string | null;
-    model: string;
-    permission_mode: string;
-    prompt: string;
-};
-type PreToolUseRequest = {
-    session_id: string;
-    turn_id: string;
-    cwd: string;
-    transcript_path?: string | null;
-    model: string;
-    permission_mode: string;
-    tool_name: string;
-    matcher_aliases: string[];
-    tool_use_id: string;
-    tool_input: unknown;
-};
-type PostToolUseRequest = PreToolUseRequest & {
-    tool_response: unknown;
-};
-type PermissionRequestRequest = PreToolUseRequest & {
-    run_id_suffix: string;
-};
-type CompactHookRequest = {
-    session_id: string;
-    turn_id: string;
-    cwd: string;
-    transcript_path?: string | null;
-    model: string;
-    trigger: "manual" | "auto";
-};
-type PreToolUseOutcome = {
-    hook_events: HookCompletedEvent[];
-    should_block: boolean;
-    block_reason?: string | null;
-    additional_contexts: string[];
-};
-type PostToolUseOutcome = {
-    hook_events: HookCompletedEvent[];
-    should_stop: boolean;
-    stop_reason?: string | null;
-    feedback_message?: string | null;
-    additional_contexts: string[];
-};
-type PermissionRequestOutcome = {
-    hook_events: HookCompletedEvent[];
-    decision?: PermissionRequestDecision | null;
-};
-declare class Hooks {
-    private readonly handlers;
-    constructor(handlers?: readonly ConfiguredHookHandler[]);
-    static empty(): Hooks;
-    static withHandlersForTest(handlers: readonly ConfiguredHookHandler[]): Hooks;
-    is_empty(): boolean;
-    preview_session_start(request: SessionStartRequest): HookRunSummary[];
-    run_session_start(request: SessionStartRequest): Promise<PostToolUseOutcome>;
-    preview_user_prompt_submit(): HookRunSummary[];
-    run_user_prompt_submit(request: UserPromptSubmitRequest): Promise<PostToolUseOutcome>;
-    preview_pre_tool_use(request: PreToolUseRequest): HookRunSummary[];
-    run_pre_tool_use(request: PreToolUseRequest): Promise<PreToolUseOutcome>;
-    preview_post_tool_use(request: PostToolUseRequest): HookRunSummary[];
-    run_post_tool_use(request: PostToolUseRequest): Promise<PostToolUseOutcome>;
-    preview_permission_request(request: PermissionRequestRequest): HookRunSummary[];
-    run_permission_request(request: PermissionRequestRequest): Promise<PermissionRequestOutcome>;
-    preview_pre_compact(request: CompactHookRequest): HookRunSummary[];
-    run_pre_compact(request: CompactHookRequest): Promise<PostToolUseOutcome>;
-    preview_post_compact(request: CompactHookRequest): HookRunSummary[];
-    run_post_compact(request: CompactHookRequest): Promise<PostToolUseOutcome>;
-    preview_stop(): HookRunSummary[];
-    run_stop(request: CompactHookRequest): Promise<PostToolUseOutcome>;
-    private preview;
-    private runContextInjecting;
-    private runMatching;
-}
-declare function run_session_start_hooks(session: Session, turnContext: TurnContext, source?: string): Promise<boolean>;
-declare function run_user_prompt_submit_hooks(session: Session, turnContext: TurnContext, prompt: string): Promise<HookRuntimeOutcome>;
-declare function run_pre_tool_use_hooks(session: Session, turnContext: TurnContext, input: {
-    tool_use_id: string;
-    tool_name: string;
-    matcher_aliases?: string[];
-    tool_input: unknown;
-}): Promise<string | null>;
-declare function run_post_tool_use_hooks(session: Session, turnContext: TurnContext, input: {
-    tool_use_id: string;
-    tool_name: string;
-    matcher_aliases?: string[];
-    tool_input: unknown;
-    tool_response: unknown;
-}): Promise<PostToolUseOutcome>;
-declare function run_permission_request_hooks(session: Session, turnContext: TurnContext, input: {
-    run_id_suffix: string;
-    tool_name: string;
-    matcher_aliases?: string[];
-    tool_input: unknown;
-}): Promise<PermissionRequestDecision | null>;
-declare function run_pre_compact_hooks(session: Session, turnContext: TurnContext, trigger?: "manual" | "auto"): Promise<HookRuntimeOutcome>;
-declare function run_post_compact_hooks(session: Session, turnContext: TurnContext, trigger?: "manual" | "auto"): Promise<HookRuntimeOutcome>;
-declare function run_stop_hooks(session: Session, turnContext: TurnContext): Promise<HookRuntimeOutcome>;
-declare function hookAdditionalContextResponseItem(text: string): ResponseItem;
-declare function record_additional_contexts(session: Session, turnContext: TurnContext, contexts: readonly string[]): Promise<void>;
-declare function requestPermissionsResponseFromDecision(decision: PermissionRequestDecision | null): RequestPermissionsResponse | null;
-
-declare const TaskKind: {
-    readonly Regular: "Regular";
-    readonly Compact: "Compact";
-    readonly Review: "Review";
-};
-type TaskKind = (typeof TaskKind)[keyof typeof TaskKind];
-type SessionTaskResult = {
-    last_agent_message: string | null;
-    steps?: number;
-    message?: string;
-};
-declare class SessionTaskContext {
-    private readonly session;
-    constructor(session: Session);
-    clone_session(): Session;
-}
-type SessionTaskRunInput = {
-    session: SessionTaskContext;
-    ctx: TurnContext;
-    input: UserInput[];
-    signal?: AbortSignal;
-};
-interface SessionTask {
-    kind(): TaskKind;
-    span_name(): string;
-    records_turn_token_usage_on_span(): boolean;
-    run(input: SessionTaskRunInput): Promise<SessionTaskResult>;
-    abort?(input: {
-        session: SessionTaskContext;
-        ctx: TurnContext;
-    }): Promise<void>;
-}
-type RunningTask = {
-    sub_id: string;
-    kind: TaskKind;
-    turn_context: TurnContext;
-    task?: SessionTask;
-    abort_controller?: AbortController;
-    records_turn_token_usage_on_span?: boolean;
-};
-
-declare const MailboxDeliveryPhase: {
-    readonly CurrentTurn: "CurrentTurn";
-    readonly NextTurn: "NextTurn";
-};
-type MailboxDeliveryPhase = (typeof MailboxDeliveryPhase)[keyof typeof MailboxDeliveryPhase];
-type PendingUserInput = {
-    resolve(response: RequestUserInputResponse | null): void;
-};
-type PendingDynamicTool = {
-    resolve(response: DynamicToolResponse | null): void;
-};
-type PendingRequestPermissions = {
-    resolve(response: RequestPermissionsResponse | null): void;
-};
-type PendingMcpElicitation = {
-    resolve(response: McpServerElicitationResponse | null): void;
-};
-type RunningTaskPlaceholder = {
-    sub_id: string;
-    kind: TaskKind;
-    turn_context: TurnContext;
-};
-type RemovedTask = {
-    active_turn_is_empty: boolean;
-    task: RunningTask;
-};
-declare const emptyTokenUsage: TokenUsage;
-declare class TurnState {
-    private readonly pending_user_input;
-    private readonly pending_dynamic_tools;
-    private readonly pending_request_permissions;
-    private readonly pending_mcp_elicitations;
-    private pending_input;
-    private readonly mailbox;
-    private mailbox_delivery_phase;
-    private readonly permission_grants;
-    tool_calls: number;
-    has_memory_citation: boolean;
-    token_usage_at_turn_start: TokenUsage;
-    insertPendingUserInput(key: string, pending: PendingUserInput): PendingUserInput | undefined;
-    removePendingUserInput(key: string): PendingUserInput | undefined;
-    insertPendingDynamicTool(key: string, pending: PendingDynamicTool): PendingDynamicTool | undefined;
-    removePendingDynamicTool(key: string): PendingDynamicTool | undefined;
-    insertPendingRequestPermissions(key: string, pending: PendingRequestPermissions): PendingRequestPermissions | undefined;
-    removePendingRequestPermissions(key: string): PendingRequestPermissions | undefined;
-    insertPendingMcpElicitation(serverName: string, id: McpRequestId, pending: PendingMcpElicitation): PendingMcpElicitation | undefined;
-    removePendingMcpElicitation(serverName: string, id: McpRequestId): PendingMcpElicitation | undefined;
-    recordPermissionGrant(response: RequestPermissionsResponse): void;
-    grantedPermissions(): RequestPermissionProfile[];
-    strictAutoReviewEnabled(): boolean;
-    pushPendingInput(input: UserInput): void;
-    prependPendingInput(input: UserInput[]): void;
-    takePendingInput(): UserInput[];
-    hasPendingInput(): boolean;
-    clearPending(): void;
-    cancelPending(): void;
-    sendMailboxMessage(communication: Omit<InterAgentCommunication, "seq">): number;
-    drainMailbox(): InterAgentCommunication[];
-    hasMailboxPending(): boolean;
-    hasMailboxPendingTriggerTurn(): boolean;
-    acceptMailboxDeliveryForCurrentTurn(): void;
-    acceptsMailboxDeliveryForCurrentTurn(): boolean;
-    setMailboxDeliveryPhase(phase: MailboxDeliveryPhase): void;
-}
-declare class ActiveTurn {
-    private readonly tasks;
-    readonly turn_state: TurnState;
-    addTask(task: RunningTask): void;
-    removeTask(sub_id: string): RemovedTask | undefined;
-    drainTasks(): RunningTask[];
-    firstTask(): RunningTask | null;
-    hasTask(sub_id: string): boolean;
-    clearPending(): void;
-    cancelPending(): void;
-    get size(): number;
-}
-
-type SessionSettingsUpdate = {
-    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 | null;
-    model?: string;
-    effort?: ReasoningEffortConfig | null;
-    summary?: ReasoningSummaryConfig;
-    service_tier?: ServiceTier | null;
-    collaboration_mode?: CollaborationMode;
-    personality?: Personality | null;
-    environments?: TurnEnvironmentSelection[];
-    persist_environments?: boolean;
-    final_output_json_schema?: unknown;
-};
-declare class SessionSettingsUpdateError extends Error {
-    constructor(message: string);
-}
-declare function sessionSettingsUpdateFromUserTurn(op: UserTurnOp): SessionSettingsUpdate;
-declare function sessionSettingsUpdateFromUserInput(op: UserInputOp): SessionSettingsUpdate;
-declare function sessionSettingsUpdateFromUserInputWithTurnContext(op: UserInputWithTurnContextOp, current: SessionConfiguration): SessionSettingsUpdate;
-declare function sessionSettingsUpdateFromOverrideTurnContext(op: OverrideTurnContextOp, current: SessionConfiguration): SessionSettingsUpdate;
-declare function applySessionSettingsUpdate(configuration: SessionConfiguration, updates: SessionSettingsUpdate): SessionConfiguration;
-
-type Event = {
-    id: string;
-    msg: EventMsg;
-};
-type SessionConfiguration = {
-    provider: string;
-    model: string;
-    model_info?: ModelInfo | null;
-    collaboration_mode: CollaborationMode;
-    reasoning_effort?: ReasoningEffortConfig | null;
-    reasoning_summary: ReasoningSummaryConfig;
-    service_tier?: ServiceTier | null;
-    base_instructions: BaseInstructions;
-    developer_instructions?: string | null;
-    user_instructions?: string | null;
-    personality?: Personality | null;
-    cwd: string;
-    approval_policy: AskForApproval;
-    approvals_reviewer?: ApprovalsReviewer | null;
-    sandbox_policy: SandboxPolicy;
-    permission_profile: PermissionProfile;
-    active_permission_profile?: ActivePermissionProfile | null;
-    windows_sandbox_level?: WindowsSandboxLevel | null;
-    environments: TurnEnvironmentSelection[];
-    session_source: SessionSource;
-    dynamic_tools: DynamicToolSpec[];
-    tools: ToolsConfig;
-    final_output_json_schema?: unknown;
-    truncation_policy?: TruncationPolicy | null;
-};
-type SessionParams = {
-    threadId: ThreadId;
-    configuration: SessionConfiguration;
-    liveThread?: LiveThread | null;
-    idGenerator?: () => string;
-    eventSink?: (event: Event) => void;
-    now?: () => number;
-    initialHistory?: RolloutItem[] | null;
-    rolloutPath?: string | null;
-    forkedFromId?: ThreadId | null;
-    threadName?: string | null;
-    threadSource?: string | null;
-    hooks?: Hooks;
-    threadGoalStore?: ThreadGoalStore | null;
-    mcpConnectionManager?: McpConnectionManager | null;
-    agentControl?: AgentControl | null;
-};
-type SessionConfigurationFromConfigOptions = {
-    previous_base_instructions?: BaseInstructions | null;
-    model_info?: ModelInfo | null;
-};
-declare const SteerInputErrorKind: {
-    readonly EmptyInput: "empty_input";
-    readonly NoActiveTurn: "no_active_turn";
-    readonly ExpectedTurnMismatch: "expected_turn_mismatch";
-    readonly ActiveTurnNotSteerable: "active_turn_not_steerable";
-};
-type SteerInputErrorKind = (typeof SteerInputErrorKind)[keyof typeof SteerInputErrorKind];
-declare class SteerInputError extends Error {
-    readonly kind: SteerInputErrorKind;
-    readonly input: UserInput[];
-    private constructor();
-    static emptyInput(): SteerInputError;
-    static noActiveTurn(input: UserInput[]): SteerInputError;
-    static expectedTurnMismatch(input: {
-        expected: string;
-        actual: string;
-        items: UserInput[];
-    }): SteerInputError;
-    static activeTurnNotSteerable(input: {
-        kind: TaskKind;
-        items: UserInput[];
-    }): SteerInputError;
-}
-declare function defaultSessionConfiguration(overrides?: Partial<SessionConfiguration>): SessionConfiguration;
-declare function session_configuration_from_config(config: ResolvedConfig, options?: SessionConfigurationFromConfigOptions): SessionConfiguration;
-declare function resolve_session_base_instructions(config: ResolvedConfig, options?: SessionConfigurationFromConfigOptions): BaseInstructions;
-declare function sessionConfigurationPermissionProfile(configuration: SessionConfiguration): PermissionProfile;
-declare function sessionConfigurationActivePermissionProfile(configuration: SessionConfiguration): ActivePermissionProfile | null;
-declare function sessionConfigurationSandboxPolicy(configuration: SessionConfiguration): SandboxPolicy;
-declare function turn_context_from_config(config: ResolvedConfig, submissionId: string, trace?: Submission["trace"]): TurnContext;
-declare class Session {
-    readonly threadId: ThreadId;
-    readonly emittedEvents: Event[];
-    private readonly liveThread;
-    private readonly idGenerator;
-    private readonly eventSink?;
-    private readonly now;
-    private configuration;
-    private readonly rolloutPath;
-    private readonly forkedFromId;
-    private readonly threadName;
-    private readonly threadSource;
-    private readonly initialMessages;
-    private readonly hook_runtime;
-    private readonly agent_control;
-    private readonly goal_runtime;
-    private readonly mcp_connection_manager;
-    private readonly state;
-    private sessionConfiguredSent;
-    private sessionStartHooksRan;
-    private readonly idle_pending_input;
-    private readonly session_permission_grants;
-    activeTurn: ActiveTurn | null;
-    constructor(params: SessionParams);
-    private get token_info();
-    private set token_info(value);
-    private get latest_rate_limits();
-    private set latest_rate_limits(value);
-    private get reference_context_item();
-    private set reference_context_item(value);
-    private get previous_turn_settings();
-    private set previous_turn_settings(value);
-    submit(op: Op): Promise<string>;
-    submit_with_id(submission: Submission): Promise<void>;
-    insertPendingUserInput(key: string, pending: PendingUserInput): void;
-    insertPendingDynamicTool(key: string, pending: PendingDynamicTool): void;
-    insertPendingRequestPermissions(key: string, pending: PendingRequestPermissions): void;
-    steer_input(input: UserInput[], expected_turn_id?: string | null): Promise<string>;
-    inject_response_items(input: UserInput[]): Promise<boolean>;
-    prepend_pending_input(input: UserInput[]): Promise<boolean>;
-    get_pending_input(): Promise<UserInput[]>;
-    has_pending_input(): Promise<boolean>;
-    queue_response_items_for_next_turn(items: UserInput[]): Promise<void>;
-    take_queued_response_items_for_next_turn(): Promise<UserInput[]>;
-    collaboration_mode(): CollaborationMode;
-    granted_session_permissions(): RequestPermissionProfile[];
-    hooks(): Hooks;
-    agentControl(): AgentControl;
-    configure_session(initialMessages?: EventMsg[] | null): Promise<void>;
-    strict_auto_review_enabled_for_turn(): boolean;
-    request_user_input(turnContext: TurnContext, callId: string, args: NormalizedRequestUserInputArgs): Promise<RequestUserInputResponse | null>;
-    request_permissions(turnContext: TurnContext, callId: string, args: RequestPermissionsArgs): Promise<RequestPermissionsResponse | null>;
-    refresh_mcp_servers_now(turnContext: TurnContext, config: McpServerRefreshConfig, environment?: McpRuntimeEnvironment$1): Promise<void>;
-    refresh_mcp_servers_if_requested(turnContext: TurnContext, config?: McpServerRefreshConfig | null): Promise<void>;
-    list_mcp_server_statuses(): Promise<McpServerStatus[]>;
-    list_mcp_tools(): Promise<McpToolInfo[]>;
-    list_resources(params: McpResourceListParams): Promise<McpResourceListResponse>;
-    list_resource_templates(params: McpResourceListParams): Promise<McpResourceTemplateListResponse>;
-    read_resource(_paramsTurnContext: TurnContext | null, params: McpResourceReadParams): Promise<McpResourceReadResponse>;
-    call_tool(turnContext: TurnContext, params: McpServerToolCallParams): Promise<McpServerToolCallResponse>;
-    resolve_mcp_tool_info(toolName: string): Promise<McpToolInfo | null>;
-    request_mcp_server_elicitation(turnContext: TurnContext, serverName: string, id: McpRequestId, request: McpServerElicitationRequest): Promise<McpServerElicitationResponse | null>;
-    request_dynamic_tool(turnContext: TurnContext, callId: string, toolName: string, argumentsValue: unknown): Promise<DynamicToolResponse | null>;
-    startTurn(submission: Submission): Promise<TurnContext>;
-    startCompactTurn(submission: Submission): Promise<TurnContext>;
-    start_task(input: {
-        turnContext: TurnContext;
-        task?: SessionTask;
-        kind?: TaskKind;
-        abortController?: AbortController;
-    }): Promise<RunningTask>;
-    spawn_task(input: {
-        turnContext: TurnContext;
-        task: SessionTask;
-        input: UserInput[];
-        abortController?: AbortController;
-    }): Promise<SessionTaskResult>;
-    recordCompactedItem(item: CompactedItem): Promise<void>;
-    record_into_history(turnContext: TurnContext, items: readonly ResponseItem[]): void;
-    record_conversation_items(turnContext: TurnContext, items: readonly ResponseItem[]): Promise<void>;
-    completeTurn(turnContext: TurnContext, lastAgentMessage?: string | null): Promise<void>;
-    on_task_finished(turnContext: TurnContext, result: SessionTaskResult): Promise<void>;
-    failTurn(turnContext: TurnContext, error: unknown): Promise<void>;
-    abortActiveTurn(reason?: "interrupted"): Promise<void>;
-    abort_all_tasks(reason?: "interrupted"): Promise<void>;
-    markFirstToken(turnContext: TurnContext): void;
-    update_token_usage_info(turnContext: TurnContext, tokenUsage?: TokenUsage | null): Promise<void>;
-    update_rate_limits(turnContext: TurnContext, newRateLimits: RateLimitSnapshot): Promise<void>;
-    token_usage_info(): TokenUsageInfo | null;
-    clone_history(): ContextManager;
-    replace_history(items: ResponseItem[], referenceContextItem?: TurnContextItem | null): void;
-    replace_compacted_history(turnContext: TurnContext, items: ResponseItem[], referenceContextItem?: TurnContextItem | null): Promise<void>;
-    get_total_token_usage_breakdown(): TotalTokenUsageBreakdown;
-    get_total_token_usage(): number;
-    get_thread_goal(): Promise<ThreadGoal | null>;
-    create_thread_goal(turnContext: TurnContext, request: CreateGoalRequest): Promise<ThreadGoal>;
-    update_thread_goal_complete(turnContext: TurnContext): Promise<ThreadGoal>;
-    note_tool_completed(turnContext: TurnContext, toolName: string): Promise<void>;
-    thread_goal_steering_items(): Promise<ResponseItem[]>;
-    latest_rate_limit_snapshot(): RateLimitSnapshot | null;
-    private send_token_count_event;
-    private send_thread_goal_update_if_needed;
-    private send_thread_goal_updated;
-    private userInputOrTurn;
-    private createTurnContext;
-    new_turn_with_sub_id(submissionId: string, updates: SessionSettingsUpdate, trace?: Submission["trace"]): Promise<TurnContext>;
-    new_default_turn_with_sub_id(submissionId: string, trace?: Submission["trace"]): Promise<TurnContext>;
-    turn_context_from_config(config: ResolvedConfig, submissionId: string, trace?: Submission["trace"]): TurnContext;
-    private turnContextFromConfiguration;
-    private overrideTurnContext;
-    private sessionSettingsUpdateFromOp;
-    private notifyUserInputResponse;
-    notify_request_permissions_response(callId: string, response: RequestPermissionsResponse): void;
-    resolve_elicitation(serverName: string, id: McpRequestId, response: McpServerElicitationResponse): Promise<void>;
-    private record_granted_request_permissions;
-    notify_dynamic_tool_response(callId: string, response: DynamicToolResponse): void;
-    private setThreadMemoryMode;
-    private shutdown;
-    private interrupt;
-    private threadRollback;
-    private compactWithoutModel;
-    send_event(turnContext: TurnContext, msg: EventMsg): Promise<void>;
-    recordResponseItem(turnContext: TurnContext, item: ResponseItem): Promise<void>;
-    record_context_updates_and_set_reference_context_item(turnContext: TurnContext): Promise<void>;
-    send_event_raw(event: Event): Promise<void>;
-    private deliver_event_raw;
-    private persist_rollout_items;
-}
-
-type TurnTimingSnapshot = {
-    completed_at: number;
-    duration_ms: number;
-    time_to_first_token_ms: number | null;
-};
-declare class TurnTimingState {
-    private started_at_ms;
-    private first_token_at_ms;
-    markTurnStarted(now: number): number;
-    markFirstToken(now: number): void;
-    completedAtAndDuration(now: number): TurnTimingSnapshot;
-}
-
-type TurnContextParams = {
-    sub_id: string;
-    trace?: W3cTraceContext;
-    cwd: string;
-    current_date?: string;
-    timezone?: string;
-    approval_policy: AskForApproval;
-    approvals_reviewer?: ApprovalsReviewer | null;
-    sandbox_policy: SandboxPolicy;
-    permission_profile?: PermissionProfile | null;
-    active_permission_profile?: ActivePermissionProfile | null;
-    windows_sandbox_level?: WindowsSandboxLevel | null;
-    model: string;
-    model_info?: ModelInfo | null;
-    personality?: Personality | null;
-    collaboration_mode?: CollaborationMode | null;
-    effort?: ReasoningEffortConfig | null;
-    summary: ReasoningSummaryConfig;
-    service_tier?: ServiceTier | null;
-    session_source: SessionSource;
-    environments: TurnEnvironmentSelection[];
-    base_instructions?: string | null;
-    user_instructions?: string | null;
-    developer_instructions?: string | null;
-    final_output_json_schema?: unknown;
-    truncation_policy?: TruncationPolicy | null;
-    dynamic_tools: DynamicToolSpec[];
-    tools: ToolsConfig;
-};
-declare class TurnContext {
-    readonly sub_id: string;
-    readonly trace_id?: string;
-    readonly cwd: string;
-    readonly current_date?: string;
-    readonly timezone?: string;
-    readonly approval_policy: AskForApproval;
-    readonly approvals_reviewer?: ApprovalsReviewer | null;
-    readonly sandbox_policy: SandboxPolicy;
-    readonly permission_profile?: PermissionProfile | null;
-    readonly active_permission_profile?: ActivePermissionProfile | null;
-    readonly windows_sandbox_level?: WindowsSandboxLevel | null;
-    readonly model: string;
-    readonly model_info: ModelInfo;
-    readonly personality?: Personality | null;
-    readonly collaboration_mode?: CollaborationMode | null;
-    readonly effort?: ReasoningEffortConfig | null;
-    readonly summary: ReasoningSummaryConfig;
-    readonly service_tier?: ServiceTier | null;
-    readonly session_source: SessionSource;
-    readonly environments: TurnEnvironmentSelection[];
-    readonly base_instructions?: string | null;
-    readonly user_instructions?: string | null;
-    readonly developer_instructions?: string | null;
-    readonly final_output_json_schema?: unknown;
-    readonly truncation_policy?: TruncationPolicy | null;
-    readonly dynamic_tools: DynamicToolSpec[];
-    readonly tools: ToolsConfig;
-    readonly turn_timing_state: TurnTimingState;
-    constructor(params: TurnContextParams);
-    toTurnContextItem(): TurnContextItem;
-    effectivePermissionProfile(): PermissionProfile;
-    effectiveSandboxPolicy(): SandboxPolicy;
-    model_context_window(): number | null;
-    auto_compact_token_limit(): number | null;
-    effectiveReasoningEffort(): ReasoningEffortConfig | null;
-}
-
-declare const OPENAI_BETA_HEADER = "OpenAI-Beta";
-declare const X_CODEX_INSTALLATION_ID_HEADER = "x-codex-installation-id";
-declare const X_CODEX_TURN_STATE_HEADER = "x-codex-turn-state";
-declare const X_CODEX_TURN_METADATA_HEADER = "x-codex-turn-metadata";
-declare const X_CODEX_PARENT_THREAD_ID_HEADER = "x-codex-parent-thread-id";
-declare const X_CODEX_WINDOW_ID_HEADER = "x-codex-window-id";
-declare const X_OPENAI_SUBAGENT_HEADER = "x-openai-subagent";
-declare const X_RESPONSESAPI_INCLUDE_TIMING_METRICS_HEADER = "x-responsesapi-include-timing-metrics";
-declare const RESPONSES_WEBSOCKETS_V2_BETA_HEADER_VALUE = "responses_websockets=2026-02-06";
-declare const CHATGPT_CODEX_RESPONSES_URL = "https://chatgpt.com/backend-api/codex/responses";
-declare const CODEX_USER_AGENT = "codex_cli_rs/0.128.0 (Mac OS 15.7.3; arm64) dumb";
-type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
-type CreateModelClientInput = {
-    apiKey: string;
-    baseUrl?: string;
-    chatgptAccountId?: string | null;
-    fedramp?: boolean;
-    fetch?: FetchLike;
-    provider?: ModelProvider;
-    sessionId: string;
-    threadId: ThreadId | string;
-    installationId: string;
-    includeTimingMetrics?: boolean;
-    betaFeaturesHeader?: string | null;
-};
-type ModelClientSessionHandle = {
-    prewarm_websocket(prompt: Prompt, options?: {
-        signal?: AbortSignal;
-        turn?: TurnContext;
-        turn_metadata_header?: string | null;
-    }): Promise<void>;
-    send_response_processed(response_id: string): Promise<void>;
-    stream(prompt: Prompt, options?: {
-        signal?: AbortSignal;
-        turn?: TurnContext;
-        turn_metadata_header?: string | null;
-    }): Promise<ResponseStream>;
-    release(): void;
-};
-type ModelClient = {
-    new_session(turn?: TurnContext): ModelClientSessionHandle;
-    responses_websocket_enabled(): boolean;
-    force_http_fallback(): boolean;
-};
-declare function createModelClient(input: CreateModelClientInput): ModelClient;
-type LastResponse = {
-    response_id: string;
-    items_added: ResponseItem[];
-};
-type WebsocketSession = {
-    connection: ResponsesWebsocketConnection | null;
-    last_request: ResponsesApiRequest | null;
-    last_response: LastResponse | null;
-    connection_reused: boolean;
-};
-declare class CodexModelClient implements ModelClient {
-    private readonly provider;
-    private readonly runtime;
-    private readonly apiKey;
-    private readonly chatgptAccountId;
-    private readonly fedramp;
-    private readonly fetcher?;
-    private readonly sessionId;
-    private readonly threadId;
-    private readonly installationId;
-    private readonly includeTimingMetrics;
-    private readonly betaFeaturesHeader;
-    private disableWebsockets;
-    private windowGeneration;
-    private cachedWebsocketSession;
-    constructor(input: CreateModelClientInput);
-    new_session(turn?: TurnContext): ModelClientSession;
-    responses_websocket_enabled(): boolean;
-    force_http_fallback(): boolean;
-    set_window_generation(windowGeneration: number): void;
-    advance_window_generation(): void;
-    current_window_id(): string;
-    stream_max_retries(): number;
-    websocket_connect_timeout_ms(): number;
-    take_cached_websocket_session(): WebsocketSession;
-    store_cached_websocket_session(websocketSession: WebsocketSession): void;
-    build_responses_request(prompt: Prompt, turn: TurnContext): ResponsesApiRequest;
-    build_responses_options(turn: TurnContext, turnState: TurnState$1, turnMetadataHeader?: string | null): ResponsesOptions;
-    build_websocket_headers(turn: TurnContext, turnState: TurnState$1, turnMetadataHeader?: string | null): Headers;
-    build_ws_client_metadata(turn: TurnContext, turnMetadataHeader?: string | null): Record<string, string>;
-    new_responses_client(): ResponsesClient;
-    new_responses_websocket_client(): ResponsesWebsocketClient;
-    private build_responses_headers;
-}
-declare class ModelClientSession {
-    private readonly client;
-    private readonly turn?;
-    private websocketSession;
-    private readonly turnState;
-    private released;
-    constructor(client: CodexModelClient, turn?: TurnContext | undefined, websocketSession?: WebsocketSession);
-    prewarm_websocket(prompt: Prompt, options?: {
-        signal?: AbortSignal;
-        turn?: TurnContext;
-        turn_metadata_header?: string | null;
-    }): Promise<void>;
-    send_response_processed(response_id: string): Promise<void>;
-    stream(prompt: Prompt, options?: {
-        signal?: AbortSignal;
-        turn?: TurnContext;
-        turn_metadata_header?: string | null;
-    }): Promise<ResponseStream>;
-    release(): void;
-    private stream_responses_api;
-    private stream_responses_websocket;
-    private websocket_connection;
-    private codex_client;
-    private prepare_websocket_request;
-    private get_incremental_items;
-    private reset_websocket_session;
-    private try_switch_fallback_transport;
-}
-
-type TotalTokenUsageBreakdown = {
-    last_api_response_total_tokens: number;
-    all_history_items_model_visible_bytes: number;
-    estimated_tokens_of_items_added_since_last_successful_api_response: number;
-    estimated_bytes_of_items_added_since_last_successful_api_response: number;
-};
-declare class ContextManager {
-    private items;
-    private history_version;
-    private token_info_value;
-    private reference_context_item_value;
-    static new(): ContextManager;
-    clone(): ContextManager;
-    token_info(): TokenUsageInfo | null;
-    tokenInfo(): TokenUsageInfo | null;
-    set_token_info(info: TokenUsageInfo | null): void;
-    setTokenInfo(info: TokenUsageInfo | null): void;
-    set_token_usage_full(contextWindow: number): void;
-    setTokenUsageFull(contextWindow: number): void;
-    recordItems(items: Iterable<ResponseItem>, policy?: TruncationPolicy | null): void;
-    record_items(items: Iterable<ResponseItem>, policy?: TruncationPolicy | null): void;
-    replace(items: ResponseItem[]): void;
-    rawItems(): ResponseItem[];
-    raw_items(): ResponseItem[];
-    forPrompt(inputModalities?: readonly string[] | null): ResponseItem[];
-    for_prompt(inputModalities?: readonly string[] | null): ResponseItem[];
-    historyVersion(): number;
-    history_version_value(): number;
-    estimate_token_count_with_base_instructions(baseInstructions: BaseInstructions): number;
-    setReferenceContextItem(item: TurnContextItem | null): void;
-    set_reference_context_item(item: TurnContextItem | null): void;
-    referenceContextItem(): TurnContextItem | null;
-    reference_context_item(): TurnContextItem | null;
-    dropLastNUserTurns(numTurns: number): void;
-    drop_last_n_user_turns(numTurns: number): void;
-    removeFirstItem(): void;
-    remove_first_item(): void;
-    removeLastItem(): boolean;
-    remove_last_item(): boolean;
-    replaceLastTurnImages(placeholder: string): boolean;
-    replace_last_turn_images(placeholder: string): boolean;
-    updateTokenInfo(usage: TokenUsage, modelContextWindow?: number | null): void;
-    update_token_info(usage: TokenUsage, modelContextWindow?: number | null): void;
-    getTotalTokenUsage(serverReasoningIncluded?: boolean): number;
-    get_total_token_usage(serverReasoningIncluded?: boolean): number;
-    getTotalTokenUsageBreakdown(): TotalTokenUsageBreakdown;
-    get_total_token_usage_breakdown(): TotalTokenUsageBreakdown;
-    private getNonLastReasoningItemsTokens;
-    private itemsAfterLastModelGeneratedItem;
-    private trim_pre_turn_context_updates;
-}
-declare function processResponseItemForPrompt(item: ResponseItem, policy?: TruncationPolicy | null): ResponseItem;
-declare function truncate_function_output_payload(output: FunctionCallOutputPayload, policy?: TruncationPolicy | null): FunctionCallOutputPayload;
-declare function isApiMessage(item: ResponseItem): boolean;
-declare function isUserTurnBoundary(item: ResponseItem): boolean;
-declare function dropLastNUserTurns(items: ResponseItem[], numTurns: number): ResponseItem[];
-declare function estimate_item_token_count(item: ResponseItem): number;
-declare function estimate_response_item_model_visible_bytes(item: ResponseItem): number;
-
-export { DEFAULT_STARTUP_TIMEOUT as $, AgentRegistry as A, AgentPath as B, CodexMcpConnectionManagerAdapter as C, type AgentRoleConfig as D, EmptyMcpConnectionManager as E, AsyncManagedClient as F, type GoalRuntimeEvent as G, type HookHandlerResult as H, CHATGPT_CODEX_RESPONSES_URL as I, CODEX_APPS_MCP_SERVER_NAME as J, CODEX_APPS_TOOLS_CACHE_DIR as K, CODEX_APPS_TOOLS_CACHE_SCHEMA_VERSION as L, type McpConnectionManager as M, CODEX_USER_AGENT as N, CachedCodexAppsToolsLoad as O, CodexAppsToolsCacheContext as P, type CodexAppsToolsCacheKey as Q, type CodexAppsToolsCacheStorage as R, StaticMcpConnectionManager as S, TurnContext as T, type CodexAuthLike as U, type CodexMcpAuthLike as V, McpConnectionManager$1 as W, type CodexMcpConnectionManagerAdapterOptions as X, type CompactHookRequest as Y, type CreateElicitationRequestParams as Z, DEFAULT_ROLE_NAME as _, type CreateModelClientInput as a, type RmcpRawTool as a$, DEFAULT_TOOL_TIMEOUT as a0, type ElicitationAction as a1, type ElicitationEventSink as a2, type ElicitationRequestEvent as a3, ElicitationRequestManager as a4, type ElicitationResponse as a5, type ElicitationReviewRequest as a6, type ElicitationReviewer as a7, type ElicitationReviewerHandle as a8, type GoalSteeringItem as a9, type McpOAuthLoginConfig as aA, McpOAuthLoginSupport as aB, McpOAuthScopesSource as aC, type McpServerConfig as aD, type McpServerTransportConfig as aE, type McpStartupFailure as aF, type McpServerConfig$1 as aG, OAuthProviderError as aH, OPENAI_BETA_HEADER as aI, type PendingDynamicTool as aJ, type PendingMcpElicitation as aK, type PendingRequestPermissions as aL, type PendingUserInput as aM, PermissionRequestDecision as aN, type PermissionRequestOutcome as aO, type PermissionRequestRequest as aP, type PostToolUseOutcome as aQ, type PostToolUseRequest as aR, type PreToolUseOutcome as aS, type PreToolUseRequest as aT, type QualifiedToolInfo as aU, RESPONSES_WEBSOCKETS_V2_BETA_HEADER_VALUE as aV, type RemovedTask as aW, type ResolvedMcpOAuthScopes as aX, type RmcpClientLike as aY, RmcpJsonRpcClient as aZ, type RmcpListToolsResult as a_, type GoalTurnAccountingSnapshot as aa, HOOK_EVENT_NAMES as ab, HOOK_EVENT_NAMES_WITH_MATCHERS as ac, type HookRuntimeOutcome as ad, Hooks as ae, InMemoryCodexAppsToolsCacheStorage as af, type InterAgentCommunication as ag, type ListedAgent as ah, type LiveAgent as ai, MCP_SANDBOX_STATE_META_CAPABILITY as aj, MCP_TOOLS_FETCH_UNCACHED_DURATION_METRIC as ak, MCP_TOOLS_LIST_DURATION_METRIC as al, MCP_TOOL_NAME_DELIMITER as am, MCP_TOOL_NAME_PREFIX as an, Mailbox as ao, MailboxDeliveryPhase as ap, MailboxReceiver as aq, ManagedClient as ar, type ManagedClientInput as as, type McpAuthStatus as at, type McpAuthStatusEntry as au, CancellationToken as av, type McpClientFactoryOptions as aw, type McpRuntimeEnvironment as ax, type McpJsonRpcMessage as ay, type McpJsonRpcTransport as az, type Event as b, isUserTurnBoundary as b$, type RunningTask as b0, type RunningTaskPlaceholder as b1, type SendElicitation as b2, type SessionConfigurationFromConfigOptions as b3, type SessionParams as b4, type SessionSettingsUpdate as b5, SessionSettingsUpdateError as b6, type SessionStartRequest as b7, SessionTaskContext as b8, SpawnAgentForkMode as b9, X_RESPONSESAPI_INCLUDE_TIMING_METRICS_HEADER as bA, applySessionSettingsUpdate as bB, builtin_agent_roles as bC, can_auto_accept_elicitation as bD, codex_apps_tools_cache_key as bE, completedHookRunSummary as bF, compute_auth_status as bG, compute_auth_statuses as bH, declared_openai_file_input_param_names as bI, defaultSessionConfiguration as bJ, default_agent_nickname_list as bK, discover_streamable_http_oauth as bL, discover_supported_scopes as bM, discovery_paths as bN, dropLastNUserTurns as bO, elicitation_capability_for_server as bP, elicitation_is_rejected_by_policy as bQ, emptyTokenUsage as bR, estimate_item_token_count as bS, estimate_response_item_model_visible_bytes as bT, exceeds_thread_spawn_depth_limit as bU, filter_disallowed_codex_apps_tools as bV, filter_non_codex_apps_mcp_tools_only as bW, filter_tools as bX, hookAdditionalContextResponseItem as bY, hookRunId as bZ, isApiMessage as b_, type SpawnAgentOptions as ba, SpawnReservation as bb, StartupOutcomeError as bc, type StaticMcpConnectionManagerOptions as bd, type StdioServerLauncher as be, SteerInputError as bf, StreamableHttpMcpTransport as bg, type StreamableHttpOAuthDiscovery as bh, ThreadGoalAccountingMode as bi, type ThreadGoalAccountingOutcome as bj, type ThreadGoalUpdate as bk, ToolFilter as bl, type ToolInfo as bm, ToolPluginProvenance as bn, type TurnContextParams as bo, TurnState as bp, type TurnTimingSnapshot as bq, TurnTimingState as br, UnsupportedStdioServerLauncher as bs, type UserPromptSubmitRequest as bt, X_CODEX_INSTALLATION_ID_HEADER as bu, X_CODEX_PARENT_THREAD_ID_HEADER as bv, X_CODEX_TURN_METADATA_HEADER as bw, X_CODEX_TURN_STATE_HEADER as bx, X_CODEX_WINDOW_ID_HEADER as by, X_OPENAI_SUBAGENT_HEADER as bz, type ModelClient as c, is_connector_id_allowed as c0, is_mcp_client_auth_required_error as c1, is_mcp_client_startup_timeout_error as c2, keep_forked_rollout_item as c3, list_tools_for_client_uncached as c4, load_cached_codex_apps_tools as c5, load_startup_cached_codex_apps_tools_snapshot as c6, make_rmcp_client as c7, mcp_init_error_display as c8, mcp_permission_prompt_is_auto_approved as c9, sanitize_name as cA, sanitize_responses_api_tool_name as cB, scopeForHookEvent as cC, sessionConfigurationActivePermissionProfile as cD, sessionConfigurationPermissionProfile as cE, sessionConfigurationSandboxPolicy as cF, sessionSettingsUpdateFromOverrideTurnContext as cG, sessionSettingsUpdateFromUserInput as cH, sessionSettingsUpdateFromUserInputWithTurnContext as cI, sessionSettingsUpdateFromUserTurn as cJ, session_configuration_from_config as cK, should_retry_without_scopes as cL, start_server_task as cM, startup_outcome_error_message as cN, tool_with_model_visible_input_schema as cO, transport_origin as cP, truncate_function_output_payload as cQ, turn_context_from_config as cR, validate_mcp_server_name as cS, write_cached_codex_apps_tools as cT, write_cached_codex_apps_tools_if_needed as cU, next_thread_spawn_depth as ca, normalize_codex_apps_callable_name as cb, normalize_codex_apps_callable_namespace as cc, normalize_codex_apps_tool_title as cd, normalize_mcp_server_config as ce, normalize_mcp_server_configs as cf, oauth_login_support as cg, processResponseItemForPrompt as ch, qualified_mcp_tool_name_prefix as ci, qualify_tool_infos as cj, qualify_tools as ck, read_cached_codex_apps_tools as cl, record_additional_contexts as cm, requestPermissionsResponseFromDecision as cn, resolve_oauth_scopes as co, resolve_role_config as cp, resolve_session_base_instructions as cq, run_permission_request_hooks as cr, run_post_compact_hooks as cs, run_post_tool_use_hooks as ct, run_pre_compact_hooks as cu, run_pre_tool_use_hooks as cv, run_session_start_hooks as cw, run_stop_hooks as cx, run_user_prompt_submit_hooks as cy, runningHookRunSummary as cz, ModelClientSession as d, type ModelClientSessionHandle as e, createModelClient as f, type SessionConfiguration as g, Session as h, SteerInputErrorKind as i, AgentStatus as j, type ThreadGoalStore as k, type CreateGoalRequest as l, type SetGoalRequest as m, type GoalRuntimeApplyResult as n, type GoalToolOutput as o, type ConfiguredHookHandler as p, ContextManager as q, type TotalTokenUsageBreakdown as r, type SessionTask as s, type SessionTaskResult as t, TaskKind as u, type SessionTaskRunInput as v, ActiveTurn as w, AgentControl as x, type AgentControlExecutor as y, type AgentMetadata as z };