ai-sdk-provider-codex-cli 1.3.1 → 2.0.0

package/dist/index.d.cts

@@ -1,806 +0,0 @@
-import { ProviderV3, LanguageModelV3, UnsupportedFunctionalityError } from '@ai-sdk/provider';
-import { ZodType } from 'zod';
-
-/**
- * Logger interface for custom logging.
- */
-interface Logger {
-    debug: (message: string) => void;
-    info: (message: string) => void;
-    warn: (message: string) => void;
-    error: (message: string) => void;
-}
-/**
- * Known Codex-capable model IDs with string fallback for forward compatibility.
- */
-type CodexModelId = 'gpt-5.5' | 'gpt-5.3-codex' | 'gpt-5.2-codex' | 'gpt-5.2-codex-max' | 'gpt-5.2-codex-mini' | 'gpt-5.1' | 'gpt-5.2' | (string & {});
-type ApprovalMode = 'untrusted' | 'on-failure' | 'on-request' | 'never';
-type SandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access';
-type ReasoningEffort = 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
-/**
- * Reasoning summary detail level for exec mode.
- */
-type ReasoningSummary = 'auto' | 'detailed';
-type ReasoningSummaryFormat = 'none' | 'experimental';
-type ModelVerbosity = 'low' | 'medium' | 'high';
-interface McpServerBase {
-    enabled?: boolean;
-    startupTimeoutSec?: number;
-    toolTimeoutSec?: number;
-    enabledTools?: string[];
-    disabledTools?: string[];
-}
-interface McpServerStdio extends McpServerBase {
-    transport: 'stdio';
-    command: string;
-    args?: string[];
-    env?: Record<string, string>;
-    cwd?: string;
-}
-interface McpServerHttp extends McpServerBase {
-    transport: 'http';
-    url: string;
-    bearerToken?: string;
-    bearerTokenEnvVar?: string;
-    httpHeaders?: Record<string, string>;
-    envHttpHeaders?: Record<string, string>;
-}
-type McpServerConfig = McpServerStdio | McpServerHttp;
-type CodexConfigOverrideValue = string | number | boolean | object;
-interface CodexSharedSettings {
-    cwd?: string;
-    approvalMode?: ApprovalMode;
-    sandboxMode?: SandboxMode;
-    env?: Record<string, string>;
-    verbose?: boolean;
-    logger?: Logger | false;
-    reasoningEffort?: ReasoningEffort;
-    reasoningSummary?: ReasoningSummary;
-    reasoningSummaryFormat?: ReasoningSummaryFormat;
-    modelVerbosity?: ModelVerbosity;
-    mcpServers?: Record<string, McpServerConfig>;
-    rmcpClient?: boolean;
-    configOverrides?: Record<string, CodexConfigOverrideValue>;
-}
-interface CodexSharedProviderOptions {
-    reasoningEffort?: ReasoningEffort;
-    reasoningSummary?: ReasoningSummary;
-    reasoningSummaryFormat?: ReasoningSummaryFormat;
-    textVerbosity?: ModelVerbosity;
-    mcpServers?: Record<string, McpServerConfig>;
-    rmcpClient?: boolean;
-    configOverrides?: Record<string, CodexConfigOverrideValue>;
-}
-
-interface CodexExecSettings extends CodexSharedSettings {
-    codexPath?: string;
-    addDirs?: string[];
-    fullAuto?: boolean;
-    dangerouslyBypassApprovalsAndSandbox?: boolean;
-    skipGitRepoCheck?: boolean;
-    color?: 'always' | 'never' | 'auto';
-    allowNpx?: boolean;
-    outputLastMessageFile?: string;
-    profile?: string;
-    oss?: boolean;
-    webSearch?: boolean;
-    configOverrides?: Record<string, CodexConfigOverrideValue>;
-}
-interface CodexExecProviderSettings {
-    defaultSettings?: CodexExecSettings;
-}
-/**
- * Per-call overrides supplied through AI SDK providerOptions.
- */
-interface CodexExecProviderOptions extends CodexSharedProviderOptions {
-    addDirs?: string[];
-}
-type CodexCliSettings = CodexExecSettings;
-type CodexCliProviderSettings = CodexExecProviderSettings;
-type CodexCliProviderOptions = CodexExecProviderOptions;
-
-type JsonRpcId = number | string;
-interface JsonRpcRequest {
-    id: JsonRpcId;
-    method: string;
-    params?: unknown;
-}
-interface JsonRpcResponse<T = unknown> {
-    id: JsonRpcId;
-    result: T;
-}
-interface JsonRpcError {
-    code: number;
-    message: string;
-    data?: unknown;
-}
-interface JsonRpcErrorResponse {
-    id: JsonRpcId | null;
-    error: JsonRpcError;
-}
-interface JsonRpcNotification {
-    method: string;
-    params?: Record<string, unknown>;
-}
-type JsonRpcMessage = JsonRpcRequest | JsonRpcResponse | JsonRpcErrorResponse | JsonRpcNotification;
-interface ModelInfo {
-    id: string;
-    name?: string | null;
-    modelProvider?: string | null;
-    description?: string | null;
-    isDefault?: boolean | null;
-    [k: string]: unknown;
-}
-interface Thread {
-    id: string;
-    preview?: string;
-    modelProvider?: string;
-    createdAt?: number;
-    [k: string]: unknown;
-}
-interface ThreadStartParams {
-    model?: string | null;
-    modelProvider?: string | null;
-    cwd?: string | null;
-    approvalPolicy?: unknown;
-    sandbox?: unknown;
-    config?: Record<string, unknown> | null;
-    baseInstructions?: string | null;
-    developerInstructions?: string | null;
-    personality?: 'none' | 'friendly' | 'pragmatic' | null;
-    ephemeral?: boolean | null;
-    experimentalRawEvents: boolean;
-    persistExtendedHistory: boolean;
-}
-interface ThreadStartResponse {
-    thread: Thread;
-    model: string;
-    modelProvider: string;
-    cwd: string;
-    approvalPolicy: unknown;
-    sandbox: unknown;
-    reasoningEffort: string | null;
-}
-interface ThreadResumeParams {
-    threadId: string;
-    history?: unknown[] | null;
-    path?: string | null;
-    model?: string | null;
-    modelProvider?: string | null;
-    cwd?: string | null;
-    approvalPolicy?: unknown;
-    sandbox?: unknown;
-    config?: Record<string, unknown> | null;
-    baseInstructions?: string | null;
-    developerInstructions?: string | null;
-    personality?: 'none' | 'friendly' | 'pragmatic' | null;
-    persistExtendedHistory: boolean;
-}
-type ThreadResumeResponse = ThreadStartResponse;
-type UserInput = {
-    type: 'text';
-    text: string;
-    text_elements: unknown[];
-} | {
-    type: 'image';
-    url?: string;
-    imageUrl?: string;
-} | {
-    type: 'localImage';
-    path: string;
-} | {
-    type: 'skill';
-    name: string;
-    path: string;
-} | {
-    type: 'mention';
-    name: string;
-    path: string;
-};
-interface TurnStartParams {
-    threadId: string;
-    input: UserInput[];
-    cwd?: string | null;
-    approvalPolicy?: unknown;
-    sandboxPolicy?: unknown;
-    model?: string | null;
-    effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | null;
-    summary?: 'auto' | 'concise' | 'detailed' | 'none' | null;
-    personality?: 'none' | 'friendly' | 'pragmatic' | null;
-    outputSchema?: unknown;
-    collaborationMode?: unknown;
-}
-type CodexErrorInfo = 'contextWindowExceeded' | 'usageLimitExceeded' | 'serverOverloaded' | 'internalServerError' | 'unauthorized' | 'badRequest' | 'threadRollbackFailed' | 'sandboxError' | 'other' | {
-    httpConnectionFailed: {
-        httpStatusCode: number | null;
-    };
-} | {
-    responseStreamConnectionFailed: {
-        httpStatusCode: number | null;
-    };
-} | {
-    responseStreamDisconnected: {
-        httpStatusCode: number | null;
-    };
-} | {
-    responseTooManyFailedAttempts: {
-        httpStatusCode: number | null;
-    };
-};
-interface TurnError {
-    message: string;
-    codexErrorInfo: CodexErrorInfo | null;
-    additionalDetails: string | null;
-}
-type TurnStatus = 'completed' | 'interrupted' | 'failed' | 'inProgress';
-type UserMessageItem = {
-    type: 'userMessage';
-    id: string;
-    content: UserInput[];
-};
-type AgentMessageItem = {
-    type: 'agentMessage';
-    id: string;
-    text: string;
-    phase: string | null;
-};
-type PlanItem = {
-    type: 'plan';
-    id: string;
-    text: string;
-};
-type ReasoningItem = {
-    type: 'reasoning';
-    id: string;
-    summary: string[];
-    content: string[];
-};
-type CommandExecutionItem = {
-    type: 'commandExecution';
-    id: string;
-    command: string;
-    cwd: string;
-    processId: string | null;
-    status: string;
-    commandActions: unknown[];
-    aggregatedOutput: string | null;
-    exitCode: number | null;
-    durationMs: number | null;
-};
-type FileChangeItem = {
-    type: 'fileChange';
-    id: string;
-    changes: unknown[];
-    status: string;
-};
-type McpToolCallItem = {
-    type: 'mcpToolCall';
-    id: string;
-    server: string;
-    tool: string;
-    status: string;
-    arguments: unknown;
-    result: unknown | null;
-    error: unknown | null;
-    durationMs: number | null;
-};
-type CollabAgentToolCallItem = {
-    type: 'collabAgentToolCall';
-    id: string;
-    tool: string;
-    status: string;
-    senderThreadId: string;
-    receiverThreadIds: string[];
-    prompt: string | null;
-    agentsStates: Record<string, unknown>;
-};
-type WebSearchItem = {
-    type: 'webSearch';
-    id: string;
-    query: string;
-    action: unknown | null;
-};
-type ImageViewItem = {
-    type: 'imageView';
-    id: string;
-    path: string;
-};
-type EnteredReviewModeItem = {
-    type: 'enteredReviewMode';
-    id: string;
-    review: string;
-};
-type ExitedReviewModeItem = {
-    type: 'exitedReviewMode';
-    id: string;
-    review: string;
-};
-type ContextCompactionItem = {
-    type: 'contextCompaction';
-    id: string;
-};
-type ThreadItem = UserMessageItem | AgentMessageItem | PlanItem | ReasoningItem | CommandExecutionItem | FileChangeItem | McpToolCallItem | CollabAgentToolCallItem | WebSearchItem | ImageViewItem | EnteredReviewModeItem | ExitedReviewModeItem | ContextCompactionItem;
-interface Turn {
-    id: string;
-    items: ThreadItem[];
-    status: TurnStatus;
-    error: TurnError | null;
-}
-interface TurnStartResponse {
-    turn: Turn;
-}
-interface TurnInterruptParams {
-    threadId: string;
-    turnId: string;
-}
-type TurnInterruptResponse = Record<string, never>;
-interface ThreadStartedNotification {
-    thread: Thread;
-}
-interface TurnStartedNotification {
-    threadId: string;
-    turn: Turn;
-}
-interface TurnCompletedNotification {
-    threadId: string;
-    turn: Turn;
-}
-interface ItemStartedNotification {
-    item: ThreadItem;
-    threadId: string;
-    turnId: string;
-}
-interface ItemCompletedNotification {
-    item: ThreadItem;
-    threadId: string;
-    turnId: string;
-}
-interface ErrorNotification {
-    error: TurnError;
-    willRetry: boolean;
-    threadId: string;
-    turnId: string;
-    [k: string]: unknown;
-}
-interface CommandExecutionRequestApprovalParams {
-    threadId: string;
-    turnId: string;
-    itemId: string;
-    approvalId?: string | null;
-    reason?: string | null;
-    networkApprovalContext?: unknown | null;
-    command?: string | null;
-    cwd?: string | null;
-    commandActions?: unknown[] | null;
-    proposedExecpolicyAmendment?: unknown | null;
-}
-interface CommandExecutionRequestApprovalResponse {
-    decision: 'accept' | 'acceptForSession' | 'decline' | 'cancel' | {
-        acceptWithExecpolicyAmendment: {
-            execpolicy_amendment: unknown;
-        };
-    };
-}
-interface FileChangeRequestApprovalParams {
-    threadId: string;
-    turnId: string;
-    itemId: string;
-    reason?: string | null;
-    grantRoot?: string | null;
-}
-interface FileChangeRequestApprovalResponse {
-    decision: 'accept' | 'acceptForSession' | 'decline' | 'cancel';
-}
-interface SkillRequestApprovalParams {
-    itemId: string;
-    skillName: string;
-}
-interface SkillRequestApprovalResponse {
-    decision: 'approve' | 'decline';
-}
-interface ToolRequestUserInputParams {
-    threadId: string;
-    turnId: string;
-    itemId: string;
-    questions: unknown[];
-}
-interface ToolRequestUserInputResponse {
-    answers: Record<string, unknown>;
-}
-type McpServerElicitationAction = 'accept' | 'decline' | 'cancel';
-interface McpServerElicitationRequestParams {
-    threadId: string;
-    /** Nullable: the elicitation may arrive outside of an active turn. */
-    turnId?: string | null;
-    serverName: string;
-    /** 'form' requests carry message/requestedSchema; 'url' requests carry url/elicitationId. */
-    mode?: string;
-    message?: string;
-    requestedSchema?: unknown;
-    url?: string;
-    elicitationId?: string;
-    /**
-     * For MCP tool approval elicitations, Codex sets
-     * `codex_approval_kind: 'mcp_tool_call'` and may include `persist` hints.
-     */
-    _meta?: Record<string, unknown> | null;
-}
-interface McpServerElicitationRequestResponse {
-    action: McpServerElicitationAction;
-    /** Structured user input for accepted elicitations; null for decline/cancel. */
-    content?: Record<string, unknown> | null;
-}
-interface DynamicToolCallParams {
-    threadId: string;
-    turnId: string;
-    callId: string;
-    tool: string;
-    arguments: unknown;
-}
-interface DynamicToolCallResponse {
-    contentItems: unknown[];
-    success: boolean;
-}
-interface ChatgptAuthTokensRefreshParams {
-    reason: string;
-    previousAccountId?: string | null;
-}
-interface ChatgptAuthTokensRefreshResponse {
-    accessToken: string;
-    chatgptAccountId: string;
-    chatgptPlanType: string | null;
-}
-
-interface LocalToolDefinition<TParams = unknown, TResult = unknown> {
-    name: string;
-    description: string;
-    parameters: ZodType<TParams>;
-    execute: (params: TParams) => Promise<TResult>;
-}
-interface LocalTool {
-    name: string;
-    description: string;
-    inputSchema: Record<string, unknown>;
-    execute: (params: unknown) => Promise<unknown>;
-}
-declare function tool<TParams, TResult>(definition: LocalToolDefinition<TParams, TResult>): LocalTool;
-
-interface LocalMcpServerOptions {
-    name: string;
-    tools: LocalTool[];
-    port?: number;
-    host?: string;
-    allowNonLoopbackHost?: boolean;
-}
-interface LocalMcpServer {
-    config: McpServerHttp;
-    url: string;
-    port: number;
-    stop: () => Promise<void>;
-}
-declare function createLocalMcpServer(options: LocalMcpServerOptions): Promise<LocalMcpServer>;
-
-declare const SDK_MCP_SERVER_MARKER: unique symbol;
-interface SdkMcpServer {
-    readonly [SDK_MCP_SERVER_MARKER]: true;
-    readonly name: string;
-    readonly cacheKey?: string;
-    readonly tools: LocalTool[];
-    _server?: LocalMcpServer;
-    _start(): Promise<LocalMcpServer['config']>;
-    _stop(): Promise<void>;
-}
-interface SdkMcpServerOptions {
-    name: string;
-    cacheKey?: string;
-    tools: LocalTool[];
-}
-declare function createSdkMcpServer(options: SdkMcpServerOptions): SdkMcpServer;
-
-type AppServerThreadMode = 'stateless' | 'persistent';
-type AppServerPersonality = 'none' | 'friendly' | 'pragmatic';
-type AppServerReasoningSummary = 'auto' | 'concise' | 'detailed' | 'none';
-type AppServerApprovalPolicy = 'untrusted' | 'on-failure' | 'on-request' | 'never' | {
-    reject: {
-        sandbox_approval: boolean;
-        rules: boolean;
-        mcp_elicitations: boolean;
-    };
-};
-type AppServerSandboxPolicy = 'read-only' | 'workspace-write' | 'danger-full-access' | {
-    type: 'dangerFullAccess';
-} | {
-    type: 'readOnly';
-    access?: unknown;
-} | {
-    type: 'externalSandbox';
-    networkAccess?: 'restricted' | 'enabled';
-} | {
-    type: 'workspaceWrite';
-    writableRoots?: string[];
-    readOnlyAccess?: unknown;
-    networkAccess?: boolean;
-    excludeTmpdirEnvVar?: boolean;
-    excludeSlashTmp?: boolean;
-};
-type AppServerUserInput = {
-    type: 'text';
-    text: string;
-} | {
-    type: 'image';
-    imageUrl: string;
-} | {
-    type: 'localImage';
-    path: string;
-};
-/**
- * Live session handle for an active app-server thread.
- *
- * Session callbacks are most useful in streaming flows where you can inject
- * follow-up instructions while a turn is still running.
- */
-interface CodexAppServerSession {
-    readonly threadId: string;
-    readonly turnId: string | null;
-    /**
-     * Injects an additional user message into the current thread.
-     */
-    injectMessage(content: string | AppServerUserInput[]): Promise<void>;
-    /**
-     * Requests interruption of the currently running turn.
-     */
-    interrupt(): Promise<void>;
-    /**
-     * Returns whether this session currently has an active turn.
-     */
-    isActive(): boolean;
-}
-interface AppServerCommandExecutionApprovalRequest {
-    id: JsonRpcId;
-    method: 'item/commandExecution/requestApproval';
-    params: CommandExecutionRequestApprovalParams;
-}
-interface AppServerFileChangeApprovalRequest {
-    id: JsonRpcId;
-    method: 'item/fileChange/requestApproval';
-    params: FileChangeRequestApprovalParams;
-}
-interface AppServerSkillApprovalRequest {
-    id: JsonRpcId;
-    method: 'skill/requestApproval';
-    params: SkillRequestApprovalParams;
-}
-interface AppServerMcpElicitationRequest {
-    id: JsonRpcId;
-    method: 'mcpServer/elicitation/request';
-    params: McpServerElicitationRequestParams;
-}
-interface AppServerToolRequestUserInputRequest {
-    id: JsonRpcId;
-    method: 'item/tool/requestUserInput';
-    params: ToolRequestUserInputParams;
-}
-interface AppServerDynamicToolCallRequest {
-    id: JsonRpcId;
-    method: 'item/tool/call';
-    params: DynamicToolCallParams;
-}
-interface AppServerAuthRefreshRequest {
-    id: JsonRpcId;
-    method: 'account/chatgptAuthTokens/refresh';
-    params: ChatgptAuthTokensRefreshParams;
-}
-interface AppServerUnhandledRequest {
-    id: JsonRpcId;
-    method: string;
-    params: Record<string, unknown>;
-}
-/**
- * Typed handlers for server-initiated JSON-RPC requests.
- *
- * Handler precedence:
- * 1) per-call provider options
- * 2) provider default settings
- * 3) built-in defaults in the RPC client
- * 4) `onUnhandled` fallback
- */
-interface CodexAppServerRequestHandlers {
-    onCommandExecutionApproval?: (request: AppServerCommandExecutionApprovalRequest) => Promise<CommandExecutionRequestApprovalResponse | undefined>;
-    onFileChangeApproval?: (request: AppServerFileChangeApprovalRequest) => Promise<FileChangeRequestApprovalResponse | undefined>;
-    onSkillApproval?: (request: AppServerSkillApprovalRequest) => Promise<SkillRequestApprovalResponse | undefined>;
-    /**
-     * Handles `mcpServer/elicitation/request` (Codex >= 0.139), which includes
-     * MCP tool call approvals (`params._meta.codex_approval_kind === 'mcp_tool_call'`).
-     * Built-in default: accept tool call approvals when `autoApprove` is true,
-     * decline all other elicitations.
-     */
-    onMcpElicitation?: (request: AppServerMcpElicitationRequest) => Promise<McpServerElicitationRequestResponse | undefined>;
-    onToolRequestUserInput?: (request: AppServerToolRequestUserInputRequest) => Promise<ToolRequestUserInputResponse | undefined>;
-    onDynamicToolCall?: (request: AppServerDynamicToolCallRequest) => Promise<DynamicToolCallResponse | undefined>;
-    onAuthRefresh?: (request: AppServerAuthRefreshRequest) => Promise<ChatgptAuthTokensRefreshResponse | undefined>;
-    onUnhandled?: (request: AppServerUnhandledRequest) => Promise<unknown>;
-}
-type AppServerMcpServerConfig = McpServerConfig | SdkMcpServer;
-/**
- * Provider-level and model-level settings for Codex app-server mode.
- */
-interface CodexAppServerSettings {
-    codexPath?: string;
-    cwd?: string;
-    env?: Record<string, string>;
-    verbose?: boolean;
-    logger?: Logger | false;
-    personality?: AppServerPersonality;
-    effort?: ReasoningEffort;
-    summary?: AppServerReasoningSummary;
-    approvalPolicy?: AppServerApprovalPolicy;
-    sandboxPolicy?: AppServerSandboxPolicy;
-    baseInstructions?: string;
-    developerInstructions?: string;
-    mcpServers?: Record<string, AppServerMcpServerConfig>;
-    rmcpClient?: boolean;
-    configOverrides?: Record<string, CodexConfigOverrideValue>;
-    autoApprove?: boolean;
-    persistExtendedHistory?: boolean;
-    connectionTimeoutMs?: number;
-    requestTimeoutMs?: number;
-    idleTimeoutMs?: number;
-    minCodexVersion?: string;
-    threadMode?: AppServerThreadMode;
-    resume?: string;
-    includeRawChunks?: boolean;
-    serverRequests?: CodexAppServerRequestHandlers;
-    onSessionCreated?: (session: CodexAppServerSession) => void | Promise<void>;
-}
-/**
- * Factory options passed to `createCodexAppServer`.
- */
-interface CodexAppServerProviderSettings {
-    defaultSettings?: CodexAppServerSettings;
-}
-/**
- * Per-request overrides passed via `providerOptions['codex-app-server']`.
- */
-interface CodexAppServerProviderOptions {
-    threadId?: string;
-    resume?: string;
-    threadMode?: AppServerThreadMode;
-    includeRawChunks?: boolean;
-    personality?: AppServerPersonality;
-    effort?: ReasoningEffort;
-    summary?: AppServerReasoningSummary;
-    approvalPolicy?: AppServerApprovalPolicy;
-    sandboxPolicy?: AppServerSandboxPolicy;
-    baseInstructions?: string;
-    developerInstructions?: string;
-    mcpServers?: Record<string, AppServerMcpServerConfig>;
-    rmcpClient?: boolean;
-    configOverrides?: Record<string, CodexConfigOverrideValue>;
-    autoApprove?: boolean;
-    persistExtendedHistory?: boolean;
-    serverRequests?: Partial<CodexAppServerRequestHandlers>;
-    onSessionCreated?: (session: CodexAppServerSession) => void | Promise<void>;
-}
-
-interface CodexExecProvider extends ProviderV3 {
-    (modelId: CodexModelId, settings?: CodexExecSettings): LanguageModelV3;
-    languageModel(modelId: CodexModelId, settings?: CodexExecSettings): LanguageModelV3;
-    chat(modelId: CodexModelId, settings?: CodexExecSettings): LanguageModelV3;
-    embeddingModel(modelId: string): never;
-    imageModel(modelId: string): never;
-}
-declare function createCodexExec(options?: CodexExecProviderSettings): CodexExecProvider;
-declare const codexExec: CodexExecProvider;
-
-interface CodexAppServerModelListResult {
-    models: ModelInfo[];
-    defaultModel?: ModelInfo;
-    nextCursor?: string | null;
-}
-/**
- * Provider interface for the persistent Codex app-server transport.
- *
- * Use this via `createCodexAppServer()` or the default `codexAppServer` export.
- */
-interface CodexAppServerProvider extends ProviderV3 {
-    (modelId: CodexModelId, settings?: CodexAppServerSettings): LanguageModelV3;
-    languageModel(modelId: CodexModelId, settings?: CodexAppServerSettings): LanguageModelV3;
-    chat(modelId: CodexModelId, settings?: CodexAppServerSettings): LanguageModelV3;
-    embeddingModel(modelId: string): never;
-    imageModel(modelId: string): never;
-    close(): Promise<void>;
-    dispose(): Promise<void>;
-    listModels(modelProviders?: string[]): Promise<CodexAppServerModelListResult>;
-}
-/**
- * Creates a Codex app-server provider instance.
- *
- * The provider maintains a shared JSON-RPC client process and can be reused
- * across many model calls. Always call `provider.close()` (or `dispose()`)
- * when finished.
- *
- * @example
- * ```ts
- * const provider = createCodexAppServer({
- *   defaultSettings: { minCodexVersion: '0.144.0' },
- * });
- *
- * try {
- *   const model = provider('gpt-5.3-codex');
- *   // use with generateText / streamText / generateObject
- * } finally {
- *   await provider.close();
- * }
- * ```
- */
-declare function createCodexAppServer(options?: CodexAppServerProviderSettings): CodexAppServerProvider;
-declare const codexAppServer: CodexAppServerProvider;
-
-interface ListModelsOptions {
-    codexPath?: string;
-    env?: Record<string, string>;
-    cwd?: string;
-    minCodexVersion?: string;
-    modelProviders?: string[];
-    connectionTimeoutMs?: number;
-    requestTimeoutMs?: number;
-}
-interface ListModelsResult {
-    models: ModelInfo[];
-    defaultModel?: ModelInfo;
-    nextCursor?: string | null;
-}
-declare function listModels(options?: ListModelsOptions): Promise<ListModelsResult>;
-
-interface ExecLanguageModelOptions {
-    id: CodexModelId;
-    settings?: CodexExecSettings;
-}
-declare class ExecLanguageModel implements LanguageModelV3 {
-    readonly specificationVersion: "v3";
-    readonly provider = "codex-cli";
-    readonly defaultObjectGenerationMode: "json";
-    readonly supportsImageUrls = false;
-    readonly supportedUrls: {};
-    readonly supportsStructuredOutputs = true;
-    readonly modelId: string;
-    readonly settings: CodexExecSettings;
-    private logger;
-    private sessionId?;
-    constructor(options: ExecLanguageModelOptions);
-    private mergeSettings;
-    private getItemType;
-    private buildArgs;
-    private applyMcpSettings;
-    private addConfigOverride;
-    /**
-     * Serialize a config override value into a CLI-safe string.
-     */
-    private serializeConfigValue;
-    private parseExperimentalJsonEvent;
-    private extractUsage;
-    private getToolName;
-    private buildToolInputPayload;
-    private buildToolResultPayload;
-    private emitToolInvocation;
-    private emitToolResult;
-    private handleSpawnError;
-    doGenerate(options: Parameters<LanguageModelV3['doGenerate']>[0]): Promise<Awaited<ReturnType<LanguageModelV3['doGenerate']>>>;
-    doStream(options: Parameters<LanguageModelV3['doStream']>[0]): Promise<Awaited<ReturnType<LanguageModelV3['doStream']>>>;
-}
-
-declare class UnsupportedFeatureError extends UnsupportedFunctionalityError {
-    readonly feature: string;
-    readonly minCodexVersion?: string;
-    readonly serverVersion?: string;
-    constructor({ feature, minCodexVersion, serverVersion, message, }: {
-        feature: string;
-        minCodexVersion?: string;
-        serverVersion?: string;
-        message?: string;
-    });
-}
-declare function isAuthenticationError(err: unknown): boolean;
-declare function isUnsupportedFeatureError(err: unknown): err is UnsupportedFeatureError;
-
-export { type AppServerThreadMode, type AppServerUserInput, type CodexAppServerModelListResult, type CodexAppServerProvider, type CodexAppServerProviderOptions, type CodexAppServerProviderSettings, type CodexAppServerRequestHandlers, type CodexAppServerSession, type CodexAppServerSettings, ExecLanguageModel as CodexCliLanguageModel, type CodexExecProvider as CodexCliProvider, type CodexCliProviderOptions, type CodexCliProviderSettings, type CodexCliSettings, type CodexExecProvider, type CodexExecProviderOptions, type CodexExecProviderSettings, type CodexExecSettings, type CodexModelId, type ErrorNotification, ExecLanguageModel, type ItemCompletedNotification, type ItemStartedNotification, type JsonRpcError, type JsonRpcErrorResponse, type JsonRpcId, type JsonRpcMessage, type JsonRpcNotification, type JsonRpcRequest, type JsonRpcResponse, type ListModelsOptions, type ListModelsResult, type LocalMcpServer, type LocalMcpServerOptions, type LocalTool, type LocalToolDefinition, type Logger, type ModelVerbosity, type ReasoningEffort, type ReasoningSummary, type ReasoningSummaryFormat, type SdkMcpServer, type SdkMcpServerOptions, type Thread, type ThreadItem, type ThreadResumeParams, type ThreadResumeResponse, type ThreadStartParams, type ThreadStartResponse, type ThreadStartedNotification, type Turn, type TurnCompletedNotification, type TurnInterruptParams, type TurnInterruptResponse, type TurnStartParams, type TurnStartResponse, type TurnStartedNotification, UnsupportedFeatureError, type UserInput, codexAppServer, codexExec as codexCli, codexExec, createCodexAppServer, createCodexExec as createCodexCli, createCodexExec, createLocalMcpServer, createSdkMcpServer, isAuthenticationError, isUnsupportedFeatureError, listModels, tool };