ai-sdk-provider-claude-code 3.5.3 → 4.0.1

package/dist/index.d.cts

@@ -1,1331 +0,0 @@
-import { LanguageModelV3, ProviderV3, APICallError, LoadAPIKeyError } from '@ai-sdk/provider';
-import { Options, ThinkingConfig, EffortLevel, PermissionMode, SdkBeta, SdkPluginConfig, SandboxSettings, Settings, ToolConfig, McpServerConfig, CanUseTool, OnUserDialog, AgentDefinition, SessionStore, SessionStoreFlush, SpawnOptions, SpawnedProcess, Query, SdkMcpToolDefinition, McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
-export { AbortError, AccountInfo, AgentDefinition, AgentInfo, AgentMcpServerSpec, AsyncHookJSONOutput, CanUseTool, ConfigChangeHookInput, CwdChangedHookInput, CwdChangedHookSpecificOutput, EffortLevel, ElicitationHookInput, ElicitationHookSpecificOutput, ElicitationResultHookInput, ElicitationResultHookSpecificOutput, FileChangedHookInput, FileChangedHookSpecificOutput, ForkSessionOptions, ForkSessionResult, GetSessionInfoOptions, GetSessionMessagesOptions, GetSubagentMessagesOptions, HOOK_EVENTS, HookCallback, HookCallbackMatcher, HookEvent, HookInput, HookJSONOutput, HookPermissionDecision, ImportSessionToStoreOptions, InMemorySessionStore, InstructionsLoadedHookInput, ListSessionsOptions, ListSubagentsOptions, McpHttpServerConfig, McpSSEServerConfig, McpSdkServerConfig, McpSdkServerConfigWithInstance, McpServerConfig, McpServerConfigForProcessTransport, McpServerStatus, McpSetServersResult, McpStdioServerConfig, MessageDisplayHookInput, MessageDisplayHookSpecificOutput, ModelInfo, NotificationHookInput, NotificationHookSpecificOutput, OnUserDialog, Options, OutputFormat, PermissionBehavior, PermissionDecisionClassification, PermissionDeniedHookInput, PermissionDeniedHookSpecificOutput, PermissionMode, PermissionRequestHookInput, PermissionRequestHookSpecificOutput, PermissionResult, PermissionRuleValue, PermissionUpdate, PermissionUpdateDestination, PostCompactHookInput, PostToolBatchHookInput, PostToolBatchHookSpecificOutput, PostToolUseFailureHookInput, PostToolUseFailureHookSpecificOutput, PostToolUseHookInput, PostToolUseHookSpecificOutput, PreCompactHookInput, PreToolUseHookInput, PreToolUseHookSpecificOutput, Query, RewindFilesResult, SDKMessage, SDKMessageOrigin, SDKSessionInfo, SDKUserMessage, SYSTEM_PROMPT_DYNAMIC_BOUNDARY, SandboxFilesystemConfig, SandboxIgnoreViolations, SandboxNetworkConfig, SandboxSettings, SdkBeta, SdkPluginConfig, SessionCronSummary, SessionEndHookInput, SessionKey, SessionMessage, SessionMutationOptions, SessionStartHookInput, SessionStartHookSpecificOutput, SessionStore, SessionStoreEntry, SessionStoreFlush, SessionSummaryEntry, Settings, SetupHookInput, SetupHookSpecificOutput, SlashCommand, SpawnOptions, SpawnedProcess, StopFailureHookInput, StopHookInput, StopHookSpecificOutput, SubagentStartHookInput, SubagentStartHookSpecificOutput, SubagentStopHookInput, SubagentStopHookSpecificOutput, SyncHookJSONOutput, TaskCompletedHookInput, TaskCreatedHookInput, TeammateIdleHookInput, TerminalReason, ThinkingAdaptive, ThinkingConfig, ThinkingDisabled, ThinkingEnabled, ToolConfig, UserDialogRequest, UserDialogResult, UserPromptExpansionHookInput, UserPromptExpansionHookSpecificOutput, UserPromptSubmitHookInput, UserPromptSubmitHookSpecificOutput, WarmQuery, WorktreeCreateHookInput, WorktreeCreateHookSpecificOutput, WorktreeRemoveHookInput, createSdkMcpServer, deleteSession, foldSessionSummary, forkSession, getSessionInfo, getSessionMessages, getSubagentMessages, importSessionToStore, listSessions, listSubagents, renameSession, startup, tagSession, tool } from '@anthropic-ai/claude-agent-sdk';
-import { ZodObject, ZodRawShape } from 'zod';
-
-type StreamingInputMode = 'auto' | 'always' | 'off';
-/**
- * Logger interface for custom logging.
- * Allows consumers to provide their own logging implementation
- * or disable logging entirely.
- *
- * @example
- * ```typescript
- * const customLogger: Logger = {
- *   debug: (message) => myLoggingService.debug(message),
- *   info: (message) => myLoggingService.info(message),
- *   warn: (message) => myLoggingService.warn(message),
- *   error: (message) => myLoggingService.error(message),
- * };
- * ```
- */
-interface Logger {
-    /**
-     * Log a debug message. Only logged when verbose mode is enabled.
-     * Used for detailed execution tracing and troubleshooting.
-     */
-    debug: (message: string) => void;
-    /**
-     * Log an informational message. Only logged when verbose mode is enabled.
-     * Used for general execution flow information.
-     */
-    info: (message: string) => void;
-    /**
-     * Log a warning message.
-     */
-    warn: (message: string) => void;
-    /**
-     * Log an error message.
-     */
-    error: (message: string) => void;
-}
-/**
- * Configuration settings for Claude Code SDK behavior.
- * These settings control how the CLI executes, what permissions it has,
- * and which tools are available during conversations.
- *
- * @example
- * ```typescript
- * const settings: ClaudeCodeSettings = {
- *   maxTurns: 10,
- *   permissionMode: 'auto',
- *   cwd: '/path/to/project',
- *   allowedTools: ['Read', 'LS'],
- *   disallowedTools: ['Bash(rm:*)']
- * };
- * ```
- */
-interface ClaudeCodeSettings {
-    /**
-     * Custom path to Claude Code SDK executable
-     * @default 'claude' (uses system PATH)
-     */
-    pathToClaudeCodeExecutable?: string;
-    /**
-     * Custom system prompt to use
-     */
-    customSystemPrompt?: string;
-    /**
-     * Append additional content to the system prompt
-     */
-    appendSystemPrompt?: string;
-    /**
-     * Agent SDK system prompt configuration. Preferred over legacy fields.
-     * - string: custom system prompt
-     * - string[]: custom system prompt blocks; include the
-     *   `SYSTEM_PROMPT_DYNAMIC_BOUNDARY` marker (re-exported by this package)
-     *   as a standalone element to split the static (cross-session cacheable)
-     *   prefix from the dynamic (session-specific) suffix
-     * - preset object: Claude Code preset, with optional `append` and
-     *   `excludeDynamicSections` (strips per-user dynamic sections such as
-     *   working directory and git status so the prompt caches across users)
-     */
-    systemPrompt?: Options['systemPrompt'];
-    /**
-     * Maximum number of turns for the conversation
-     */
-    maxTurns?: number;
-    /**
-     * Maximum thinking tokens for the model
-     *
-     * @deprecated Use `thinking` instead.
-     */
-    maxThinkingTokens?: number;
-    /**
-     * Controls Claude's thinking/reasoning behavior.
-     * Takes precedence over the deprecated `maxThinkingTokens`.
-     *
-     * - `{ type: 'adaptive' }` — Claude decides when and how much to think (Opus 4.6+, default)
-     * - `{ type: 'enabled', budgetTokens?: number }` — Fixed thinking token budget
-     * - `{ type: 'disabled' }` — No extended thinking
-     *
-     * @see https://docs.anthropic.com/en/docs/build-with-claude/adaptive-thinking
-     */
-    thinking?: ThinkingConfig;
-    /**
-     * Controls how much effort Claude puts into its response.
-     *
-     * - `'low'` — Minimal thinking, fastest responses
-     * - `'medium'` — Moderate thinking
-     * - `'high'` — Deep reasoning (default)
-     * - `'xhigh'` — Extra-high effort
-     * - `'max'` — Maximum effort (Opus 4.6 only)
-     *
-     * @see https://docs.anthropic.com/en/docs/build-with-claude/effort
-     */
-    effort?: EffortLevel;
-    /**
-     * Enable prompt suggestions. When true, the agent emits a predicted
-     * next user prompt after each turn (arrives after the result message).
-     */
-    promptSuggestions?: boolean;
-    /**
-     * Working directory for CLI operations
-     */
-    cwd?: string;
-    /**
-     * JavaScript runtime to use
-     * @default 'node' (or 'bun' if Bun is detected)
-     */
-    executable?: 'bun' | 'deno' | 'node';
-    /**
-     * Additional arguments for the JavaScript runtime
-     */
-    executableArgs?: string[];
-    /**
-     * Permission mode for tool usage.
-     *
-     * Note: `'delegate'` was removed in Agent SDK 0.3.x — the CLI rejects
-     * `--permission-mode delegate` at argv parsing — so it is no longer
-     * accepted here either.
-     * @default 'default'
-     */
-    permissionMode?: PermissionMode;
-    /**
-     * Custom tool name for permission prompts
-     */
-    permissionPromptToolName?: string;
-    /**
-     * Continue the most recent conversation
-     */
-    continue?: boolean;
-    /**
-     * Resume a specific session by ID
-     */
-    resume?: string;
-    /**
-     * Use a specific session ID for this query.
-     * Allows deterministic session identifiers for tracking and correlation.
-     *
-     * Must be a valid UUID (the CLI rejects other formats). Cannot be combined
-     * with `continue` or `resume` unless `forkSession` is also set (it then
-     * names the forked session's ID); the provider rejects those combinations
-     * at validation time. On multi-turn conversations the provider forwards
-     * `sessionId` only on the first turn — subsequent turns resume the captured
-     * session (which already carries the custom ID).
-     */
-    sessionId?: string;
-    /**
-     * Tools to explicitly allow during execution
-     * Examples: ['Read', 'LS', 'Bash(git log:*)']
-     */
-    allowedTools?: string[];
-    /**
-     * Tools to disallow during execution
-     * Examples: ['Write', 'Edit', 'Bash(rm:*)']
-     */
-    disallowedTools?: string[];
-    /**
-     * Enable Agent SDK beta features.
-     */
-    betas?: SdkBeta[];
-    /**
-     * Allow bypassing permissions when using permissionMode: 'bypassPermissions'.
-     */
-    allowDangerouslySkipPermissions?: boolean;
-    /**
-     * Enable file checkpointing for rewind support.
-     */
-    enableFileCheckpointing?: boolean;
-    /**
-     * Maximum budget in USD for the query.
-     */
-    maxBudgetUsd?: number;
-    /**
-     * Load custom plugins from local paths.
-     */
-    plugins?: SdkPluginConfig[];
-    /**
-     * Resume session at a specific message UUID.
-     */
-    resumeSessionAt?: string;
-    /**
-     * Configure sandbox behavior programmatically.
-     *
-     * Cannot be combined with a `settings` FILE PATH (the SDK throws at query
-     * time); pass `settings` as an inline object instead, or move the sandbox
-     * configuration into the settings file. The provider rejects the
-     * combination at validation time.
-     */
-    sandbox?: SandboxSettings;
-    /**
-     * Tool configuration (array of tool names or Claude Code preset).
-     */
-    tools?: Options['tools'];
-    /**
-     * Skills to enable for the main session. This is the single place to turn
-     * skills on; you do not need to add `'Skill'` to `allowedTools` yourself
-     * when using this option.
-     *
-     * - `'all'`: enable every discovered skill
-     * - `string[]`: enable only the listed skills (SKILL.md `name`/directory
-     *   name, or `plugin:skill` for plugin-qualified skills)
-     * - omitted (default): no SDK auto-configuration
-     *
-     * Note: filesystem skills are discovered via `settingSources` — set it
-     * (e.g. `['user', 'project']`) so skill definitions can be loaded.
-     */
-    skills?: string[] | 'all';
-    /**
-     * Inline settings object or path to a settings JSON file.
-     * Applied as an additional settings layer for the session.
-     *
-     * A settings file path cannot be combined with the `sandbox` option (the
-     * SDK throws at query time; inline objects are fine). The provider rejects
-     * the combination at validation time.
-     */
-    settings?: string | Settings;
-    /**
-     * Policy-tier settings supplied by the spawning parent process.
-     * Filtered restrictive-only by the SDK; intended for embedding
-     * applications that need to enforce lockdown settings on the
-     * subprocess without writing root-owned files.
-     */
-    managedSettings?: Settings;
-    /**
-     * Map built-in tool names to replacement tools (e.g. MCP tools).
-     *
-     * @example
-     * ```typescript
-     * toolAliases: { Bash: 'mcp__workspace__bash' }
-     * ```
-     */
-    toolAliases?: Record<string, string>;
-    /**
-     * Per-tool configuration for built-in tools
-     * (e.g. `{ askUserQuestion: { previewFormat: 'html' } }`).
-     */
-    toolConfig?: ToolConfig;
-    /**
-     * Custom workflow instructions for plan mode. When `permissionMode` is
-     * `'plan'`, this string replaces the default code-implementation workflow
-     * body in the plan-mode system reminder.
-     */
-    planModeInstructions?: string;
-    /**
-     * Custom title for a new session. When provided, the session uses this
-     * title instead of auto-generating one from the first user message.
-     * When resuming, the resumed session's persisted title takes precedence.
-     */
-    title?: string;
-    /**
-     * Forward subagent text and thinking blocks as messages with
-     * `parent_tool_use_id` set so consumers can render a nested transcript.
-     * By default only tool_use/tool_result blocks from subagents are emitted.
-     */
-    forwardSubagentText?: boolean;
-    /**
-     * Enable periodic AI-generated progress summaries for running subagents,
-     * emitted on `task_progress` events via the `summary` field.
-     */
-    agentProgressSummaries?: boolean;
-    /**
-     * Include hook lifecycle events (`hook_started`, `hook_progress`,
-     * `hook_response`) in the output stream for all hook event types.
-     * @default false
-     */
-    includeHookEvents?: boolean;
-    /**
-     * MCP server configuration
-     */
-    mcpServers?: Record<string, McpServerConfig>;
-    /**
-     * Filesystem settings sources to load (CLAUDE.md, settings.json, etc.)
-     * When omitted, the provider explicitly passes `[]` to the Agent SDK so that
-     * no filesystem settings are loaded (isolation mode).
-     *
-     * Note: Agent SDK 0.3.x changed the SDK-level default — omitting
-     * `settingSources` now loads ALL filesystem settings (matching CLI behavior).
-     * The provider pins isolation mode unless you set this option (or override
-     * `settingSources` via the `sdkOptions` escape hatch).
-     *
-     * Required for Skills support - skills are loaded from these sources.
-     * @example ['user', 'project']
-     */
-    settingSources?: Array<'user' | 'project' | 'local'>;
-    /**
-     * Hook callbacks for lifecycle events (e.g., PreToolUse, PostToolUse).
-     * Note: typed loosely to support multiple SDK versions.
-     *
-     * Two verified upstream CLI behaviors to be aware of (CLI 2.1.172):
-     * - A `PreToolUse` hook returning `permissionDecision: 'defer'` combined
-     *   with a {@link canUseTool} callback fails the tool call before
-     *   `canUseTool` is ever consulted. Return no decision (or `'allow'`)
-     *   instead of `'defer'` when `canUseTool` should handle the call.
-     * - The `PermissionDenied` hook only fires for CLI-internal auto-mode
-     *   classifier denials (e.g. `permissionMode: 'auto'`). Denials issued by
-     *   `canUseTool` do NOT trigger it; they surface via the result message's
-     *   `permission_denials`, exposed as
-     *   `providerMetadata['claude-code'].permissionDenials`.
-     */
-    hooks?: Partial<Record<string, Array<{
-        matcher?: string;
-        hooks: Array<(...args: unknown[]) => Promise<unknown>>;
-    }>>>;
-    /**
-     * Dynamic permission callback invoked before a tool is executed.
-     * Allows runtime approval/denial and optional input mutation.
-     *
-     * Upstream CLI caveats (verified on CLI 2.1.172):
-     * - Do not combine with a `PreToolUse` hook that returns
-     *   `permissionDecision: 'defer'` — the CLI fails the tool call before
-     *   this callback is consulted.
-     * - Denials returned here do not fire the `PermissionDenied` hook (it only
-     *   fires for auto-mode classifier denials); they surface in
-     *   `providerMetadata['claude-code'].permissionDenials` instead.
-     */
-    canUseTool?: CanUseTool;
-    /**
-     * Callback for handling `request_user_dialog` control requests — blocking
-     * dialogs the CLI asks the host to render (e.g. the refusal-fallback
-     * prompt). Each `dialogKind` defines its own payload and result shape;
-     * answer unrecognized kinds with `{ behavior: 'cancelled' }` so the CLI
-     * applies the dialog's default behavior.
-     *
-     * The SDK fails closed around dialogs: when the CLI requests a dialog and
-     * no handler/declared kind exists, the dialog-gated flow degrades to its
-     * no-dialog behavior (for `'refusal_fallback_prompt'`, the classic refusal
-     * error ends the turn). Wire this callback together with
-     * `supportedDialogKinds` to opt in — providing the callback alone does NOT
-     * make the CLI emit dialogs.
-     */
-    onUserDialog?: OnUserDialog;
-    /**
-     * Dialog kinds (`request_user_dialog` `dialog_kind` values, e.g.
-     * `'refusal_fallback_prompt'`) that your `onUserDialog` callback can
-     * actually render. The CLI only emits dialog kinds declared here and
-     * fails closed on absence: an undeclared kind is never emitted and the
-     * flow behind it degrades to its no-dialog behavior instead. Omitting the
-     * option entirely means no dialogs are emitted, even with `onUserDialog`
-     * wired.
-     *
-     * Requires `onUserDialog` — the SDK throws at option intake when a
-     * non-empty list is passed without the callback (the provider also warns
-     * at validation time).
-     */
-    supportedDialogKinds?: string[];
-    /**
-     * Controls whether to send streaming input to the SDK (enables canUseTool).
-     * - 'auto' (default): stream when canUseTool is provided
-     * - 'always': always stream
-     * - 'off': never stream (legacy behavior)
-     */
-    streamingInput?: StreamingInputMode;
-    /**
-     * Enable verbose logging for debugging
-     */
-    verbose?: boolean;
-    /**
-     * Enable programmatic debug logging from the SDK.
-     */
-    debug?: boolean;
-    /**
-     * Path to a file for SDK debug log output.
-     */
-    debugFile?: string;
-    /**
-     * Custom logger for handling warnings and errors.
-     * - Set to `false` to disable all logging
-     * - Provide a Logger object to use custom logging
-     * - Leave undefined to use console (default)
-     *
-     * @default console
-     * @example
-     * ```typescript
-     * // Disable logging
-     * const settings = { logger: false };
-     *
-     * // Custom logger
-     * const settings = {
-     *   logger: {
-     *     warn: (msg) => myLogger.warn(msg),
-     *     error: (msg) => myLogger.error(msg),
-     *   }
-     * };
-     * ```
-     */
-    logger?: Logger | false;
-    /**
-     * Environment variables to set for the Claude Code subprocess.
-     *
-     * The provider always constructs the subprocess environment from a sanitizing
-     * allowlist of `process.env` (HOME, PATH, proxy/TLS vars, `ANTHROPIC_*`,
-     * `CLAUDE_*`, `AWS_*`, `GOOGLE_*`, etc.), then merges these values over it
-     * (set a key to `undefined` to remove it). Agent SDK 0.3.x treats
-     * `Options.env` as a full replacement for the subprocess environment, so
-     * variables outside the allowlist are not inherited unless set here.
-     */
-    env?: Record<string, string | undefined>;
-    /**
-     * Additional directories Claude can access.
-     */
-    additionalDirectories?: string[];
-    /**
-     * Programmatically defined subagents.
-     *
-     * Uses the Agent SDK's `AgentDefinition` directly, which includes
-     * `effort`, `permissionMode`, `background`, `memory`, `initialPrompt`,
-     * `skills`, `maxTurns`, and full model ID strings in addition to the
-     * core `description`/`prompt`/`tools` fields.
-     */
-    agents?: Record<string, AgentDefinition>;
-    /**
-     * Include partial message events from the SDK stream.
-     */
-    includePartialMessages?: boolean;
-    /**
-     * Model(s) to use if the primary model is overloaded or unavailable.
-     * Accepts a comma-separated list to try each in order; the primary model
-     * is re-tried at the start of each user turn.
-     *
-     * Must differ from the main model (the SDK throws when they are equal);
-     * the provider rejects the combination before invoking the SDK.
-     */
-    fallbackModel?: string;
-    /**
-     * When resuming, fork to a new session ID instead of continuing the original.
-     */
-    forkSession?: boolean;
-    /**
-     * Callback for stderr output from the underlying process.
-     */
-    stderr?: (data: string) => void;
-    /**
-     * Enforce strict MCP validation.
-     */
-    strictMcpConfig?: boolean;
-    /**
-     * Additional CLI arguments.
-     */
-    extraArgs?: Record<string, string | null>;
-    /**
-     * When false, disables session persistence to disk.
-     * Sessions will not be saved to ~/.claude/projects/ and cannot be resumed later.
-     * Useful for ephemeral or automated workflows where session history is not needed.
-     * @default true
-     */
-    persistSession?: boolean;
-    /**
-     * API-side task budget in tokens. When set, the model is made aware of
-     * its remaining token budget so it can pace tool use and wrap up before
-     * the limit.
-     *
-     * @alpha Subject to change in upstream Agent SDK releases.
-     */
-    taskBudget?: {
-        total: number;
-    };
-    /**
-     * Mirror session transcripts to a custom storage adapter (e.g. Postgres,
-     * S3, Redis) in addition to local JSONL files. Cannot be combined with
-     * `persistSession: false` — local writes are required for the mirror to
-     * function — or with `enableFileCheckpointing: true` — checkpoint backup
-     * blobs are not mirrored, so `rewindFiles()` fails after a store-backed
-     * resume. Combining it with `continue: true` (without a `resume` ID)
-     * additionally requires the store to implement `listSessions()`, which the
-     * SDK uses to discover the most recent session. The provider rejects all
-     * three invalid combinations at validation time.
-     *
-     * @alpha Subject to change in upstream Agent SDK releases.
-     */
-    sessionStore?: SessionStore;
-    /**
-     * Flush strategy for `sessionStore` transcript mirroring:
-     * `'batched'` (default) or `'eager'`. Ignored when `sessionStore` is unset.
-     *
-     * @alpha Subject to change in upstream Agent SDK releases.
-     */
-    sessionStoreFlush?: SessionStoreFlush;
-    /**
-     * Timeout in milliseconds for each `sessionStore.load()` /
-     * `sessionStore.listSubkeys()` call during resume materialization.
-     *
-     * @default 60000
-     * @alpha Subject to change in upstream Agent SDK releases.
-     */
-    loadTimeoutMs?: number;
-    /**
-     * Custom function to spawn the Claude Code process.
-     * Use this to run Claude Code in VMs, containers, or remote environments.
-     */
-    spawnClaudeCodeProcess?: (options: SpawnOptions) => SpawnedProcess;
-    /**
-     * Escape hatch for Agent SDK options. Overrides explicit settings.
-     * Provider-managed fields (e.g. model, abortController, prompt, outputFormat)
-     * are ignored if supplied here.
-     */
-    sdkOptions?: Partial<Options>;
-    /**
-     * Maximum size (in characters) for tool results sent to the client stream.
-     * The interior Claude Code process retains full data; this only affects client stream.
-     * Tool results exceeding this size will be truncated with a `...[truncated N chars]` suffix.
-     * @default 10000
-     */
-    maxToolResultSize?: number;
-    /**
-     * Callback invoked when the Query object is created.
-     * Use this to access the Query for advanced features like mid-stream
-     * message injection via `query.streamInput()`.
-     *
-     * @example
-     * ```typescript
-     * const model = claudeCode('sonnet', {
-     *   onQueryCreated: (query) => {
-     *     // Store query for later injection
-     *     myQueryStore.set(sessionId, query);
-     *   }
-     * });
-     * ```
-     */
-    onQueryCreated?: (query: Query) => void;
-    /**
-     * Callback invoked when streaming input mode starts.
-     * Provides a MessageInjector that can be used to inject messages mid-session.
-     *
-     * This enables supervisor patterns where you can redirect or interrupt
-     * the agent during execution.
-     *
-     * @example
-     * ```typescript
-     * const model = claudeCode("haiku", {
-     *   streamingInput: "always",
-     *   onStreamStart: (injector) => {
-     *     // Store the injector for later use
-     *     supervisorInjector = injector;
-     *   }
-     * });
-     *
-     * // Later, inject a message mid-session:
-     * supervisorInjector.inject("STOP! Change of plans...");
-     * ```
-     */
-    onStreamStart?: (injector: MessageInjector) => void;
-    /**
-     * Callback invoked when the agent emits a prompt suggestion (a predicted
-     * next user prompt). Suggestions are enabled when `promptSuggestions` is
-     * `true` OR left unset (the SDK enables them when the option is absent or
-     * true and disables them only when explicitly `false`). When the callback
-     * is set and `promptSuggestions !== false`, the provider drains post-result
-     * messages to deliver the suggestion. Delivery is still subject to CLI
-     * heuristics — suppressed on the first turn, after API errors, in plan
-     * mode, and by `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false` — so it may not
-     * fire on every turn.
-     *
-     * The SDK emits at most one `prompt_suggestion` message per turn, and it
-     * arrives AFTER the `result` message — i.e. after the AI SDK response has
-     * already finished. That is why suggestions are delivered through this
-     * callback instead of `providerMetadata` (which is finalized with the
-     * finish event/result).
-     *
-     * @example
-     * ```typescript
-     * const model = claudeCode('sonnet', {
-     *   promptSuggestions: true,
-     *   onPromptSuggestion: (suggestion) => {
-     *     console.log('Suggested next prompt:', suggestion);
-     *   }
-     * });
-     * ```
-     */
-    onPromptSuggestion?: (suggestion: string) => void;
-}
-/**
- * Controller for injecting messages into an active Claude Code session.
- * Obtained via the onStreamStart callback.
- */
-interface MessageInjector {
-    /**
-     * Inject a user message into the current session.
-     * The message will be queued and sent to the agent mid-turn.
-     *
-     * @param content - The message content to inject
-     * @param onResult - Optional callback invoked when delivery status is known:
-     *   - `delivered: true` if the message was sent to the agent
-     *   - `delivered: false` if the session ended before the message could be delivered
-     *
-     * @example
-     * ```typescript
-     * // Fire-and-forget
-     * injector.inject("STOP! Cancel the current task.");
-     *
-     * // With delivery tracking
-     * injector.inject("Change of plans!", (delivered) => {
-     *   if (!delivered) {
-     *     console.log("Message not delivered - session ended first");
-     *     // Handle retry via session resume, etc.
-     *   }
-     * });
-     * ```
-     */
-    inject(content: string, onResult?: (delivered: boolean) => void): void;
-    /**
-     * Signal that no more messages will be injected.
-     * Call this when the session should be allowed to complete normally.
-     */
-    close(): void;
-}
-
-/**
- * Options for creating a Claude Code language model instance.
- *
- * @example
- * ```typescript
- * const model = new ClaudeCodeLanguageModel({
- *   id: 'opus',
- *   settings: {
- *     maxTurns: 10,
- *     permissionMode: 'auto'
- *   }
- * });
- * ```
- */
-interface ClaudeCodeLanguageModelOptions {
-    /**
-     * The model identifier to use.
-     * Can be 'opus', 'sonnet', 'haiku', or a custom model string.
-     */
-    id: ClaudeCodeModelId;
-    /**
-     * Optional settings to configure the model behavior.
-     */
-    settings?: ClaudeCodeSettings;
-    /**
-     * Validation warnings from settings validation.
-     * Used internally to pass warnings from provider.
-     */
-    settingsValidationWarnings?: string[];
-}
-/**
- * Supported Claude model identifiers.
- * - 'opus': Claude Opus (most capable)
- * - 'sonnet': Claude Sonnet (balanced performance)
- * - 'haiku': Claude Haiku (fastest, most cost-effective)
- * - Custom string: Any full model identifier (e.g., 'claude-opus-4-5', 'claude-sonnet-4-5-20250514')
- *
- * @example
- * ```typescript
- * const opusModel = claudeCode('opus');
- * const sonnetModel = claudeCode('sonnet');
- * const haikuModel = claudeCode('haiku');
- * const customModel = claudeCode('claude-opus-4-5');
- * ```
- */
-type ClaudeCodeModelId = 'opus' | 'sonnet' | 'haiku' | (string & {});
-/**
- * Language model implementation for Claude Code SDK.
- * This class implements the AI SDK's LanguageModelV3 interface to provide
- * integration with Claude models through the Claude Agent SDK.
- *
- * Features:
- * - Supports streaming and non-streaming generation
- * - Native structured outputs via SDK's outputFormat (guaranteed schema compliance)
- * - Manages CLI sessions for conversation continuity
- * - Provides detailed error handling and retry logic
- *
- * Limitations:
- * - Image inputs require streaming mode
- * - Some parameters like temperature and max tokens are not supported by the CLI
- *
- * @example
- * ```typescript
- * const model = new ClaudeCodeLanguageModel({
- *   id: 'opus',
- *   settings: { maxTurns: 5 }
- * });
- *
- * const result = await model.doGenerate({
- *   prompt: [{ role: 'user', content: 'Hello!' }],
- *   mode: { type: 'regular' }
- * });
- * ```
- */
-declare class ClaudeCodeLanguageModel implements LanguageModelV3 {
-    readonly specificationVersion: "v3";
-    readonly defaultObjectGenerationMode: "json";
-    readonly supportsImageUrls = false;
-    readonly supportedUrls: {};
-    readonly supportsStructuredOutputs = true;
-    static readonly UNKNOWN_TOOL_NAME = "unknown-tool";
-    private static readonly MAX_TOOL_INPUT_SIZE;
-    private static readonly MAX_TOOL_INPUT_WARN;
-    private static readonly MAX_DELTA_CALC_SIZE;
-    private static readonly PROMPT_SUGGESTION_DRAIN_TIMEOUT_MS;
-    readonly modelId: ClaudeCodeModelId;
-    readonly settings: ClaudeCodeSettings;
-    private sessionId?;
-    private modelValidationWarning?;
-    private settingsValidationWarnings;
-    private logger;
-    constructor(options: ClaudeCodeLanguageModelOptions);
-    get provider(): string;
-    private getModel;
-    private getSanitizedSdkOptions;
-    private getEffectiveResume;
-    /**
-     * Single source of truth for the CLI's `--session-id` exclusivity rule.
-     *
-     * The CLI rejects `--session-id` together with `--resume`/`--continue`
-     * unless `--fork-session` is also set (forkSession then names the forked
-     * session's own ID). This predicate captures "there IS a resume/continue
-     * target AND we are not forking", i.e. the case where a session id must NOT
-     * coexist. It is referenced by both:
-     *   - the pre-merge forwarding guard (via its inverse), which decides whether
-     *     to forward `settings.sessionId` onto the base options, and
-     *   - the post-merge exclusivity drop, which removes any session id that the
-     *     generic sdkOptions overlay (or the auto-resume turn) re-introduced.
-     *
-     * Keeping one definition guarantees both sites agree on what "conflicts with
-     * a session id" means. The mirror in validation.ts (construction-time)
-     * intentionally stays separate: it reads settings+sdkOptions, not a built
-     * opts object.
-     */
-    private static sessionIdConflictsWithResumeOrContinue;
-    /**
-     * Owns ALL session-id / resume cross-option resolution on the FINAL merged
-     * options, in the single correct order. Called once, immediately after the
-     * generic sdkOptions overlay in createQueryOptions.
-     *
-     * Two concerns, in this exact order (order matters: step 1 can change whether
-     * step 2 sees a resume target):
-     *
-     *  1. Blank-resume restoration. The overlay copies the raw `sdkOptions.resume`
-     *     verbatim, which can re-introduce a blank/whitespace value over the
-     *     base `resume` that getEffectiveResume already normalized. The SDK treats
-     *     a blank resume as absent, so a blank must NOT clobber the computed
-     *     fallback — restore `effectiveResume` (already blank-stripped; may itself
-     *     be undefined for a genuinely new session) rather than leaving '' or
-     *     forcing undefined, which would erase a real settings.resume / captured
-     *     session id.
-     *
-     *  2. Session-id exclusivity. Drop `opts.sessionId` whenever it conflicts with
-     *     a resume/continue target (see sessionIdConflictsWithResumeOrContinue).
-     *     This runs on the merged opts so it catches a sessionId re-added by the
-     *     sdkOptions overlay AND the auto-resumed second turn (where resume was
-     *     populated from the captured session id). It complements — does not
-     *     replace — the pre-merge forwarding guard, which governs whether
-     *     settings.sessionId was forwarded BEFORE the overlay could mutate
-     *     forkSession/continue/resume.
-     */
-    private applySessionResolution;
-    private extractToolUses;
-    private extractToolResults;
-    private extractToolErrors;
-    private serializeToolInput;
-    private checkInputSize;
-    private normalizeToolResult;
-    /**
-     * Builds a provider-executed `tool-call` part from an assistant `tool_use`
-     * block. Shared by doGenerate (content part) and doStream (stream part) so
-     * the two paths cannot drift in field shape.
-     */
-    private buildToolCallPart;
-    /**
-     * Builds a provider-executed `tool-result` part from a user-message
-     * `tool_result` block, applying normalization and `maxToolResultSize`
-     * truncation. Shared by doGenerate and doStream.
-     */
-    private buildToolResultPart;
-    private serializeToolError;
-    /**
-     * Builds a provider-executed `tool-error` STREAM part from a user-message
-     * `tool_error` block (doStream only; AI SDK core handles tool-error stream
-     * parts natively).
-     */
-    private buildToolErrorPart;
-    /**
-     * Builds a V3 `tool-result` CONTENT part with `isError: true` from a
-     * user-message `tool_error` block (doGenerate only). The V3 content union
-     * has no `tool-error` member and AI SDK core's asContent() silently drops
-     * unknown content part types, so an extension tool-error part would never
-     * reach `generateText` users — an isError tool-result, by contrast,
-     * round-trips into a proper tool-error part in steps content.
-     */
-    private buildToolErrorResultPart;
-    /**
-     * Policy (P3): late-frame drop guard, shared by all four tool_result/tool_error
-     * sites (doGenerate result+error, doStream result+error). When a frame's tool
-     * id is tombstoned (its tool-call was retracted by a supersede/refusal-fallback
-     * signal), the frame must be DROPPED rather than re-synthesized into an orphan
-     * tool-call. Centralizing the predicate + debug message keeps the four sites in
-     * lockstep so a future tombstone change can't be applied to only some of them.
-     */
-    private isRetractedToolFrame;
-    private generateAllWarnings;
-    private createQueryOptions;
-    private handleClaudeCodeError;
-    private setSessionId;
-    private logMcpConnectionIssues;
-    /**
-     * Handles SDK 0.3.x system messages other than 'init', shared by doGenerate
-     * and doStream:
-     * - 'api_retry' is counted into providerMetadata (`apiRetries`) and debug-logged.
-     * - 'permission_denied' is warn-logged and recorded into providerMetadata
-     *   (`permissionDenials`); without this a denial is invisible until the
-     *   model talks about it.
-     * - 'model_refusal_fallback' is debug-logged (the superseding assistant
-     *   message is handled by the text-dedup guard in the message loops).
-     * - 'thinking_tokens' deltas are accumulated into providerMetadata
-     *   (`estimatedThinkingTokens`); the estimate is explicitly not the
-     *   authoritative billed output tokens, so it is surfaced as metadata
-     *   instead of feeding `usage.outputTokens.reasoning`.
-     * - The subtypes in {@link INFORMATIONAL_SYSTEM_SUBTYPES} are intentionally
-     *   informational and only debug-logged.
-     */
-    private handleSystemMessage;
-    /**
-     * Merges the result message's `permission_denials` list into the tracked
-     * denials. PreToolUse-hook denies bypass canUseTool and emit no
-     * `permission_denied` system event (per the SDK docs on
-     * SDKPermissionDeniedMessage), so the result list is the only place they
-     * surface. Entries already recorded from stream-time events are deduped by
-     * `tool_use_id`.
-     */
-    private mergeResultPermissionDenials;
-    /**
-     * Bounded post-result drain for the `prompt_suggestion` message
-     * (promptSuggestions: true), shared by doGenerate and doStream. The
-     * suggestion arrives AFTER the result message; the SDK emits at most one
-     * per turn, so stop once it is delivered, and a timeout closes the
-     * iterator (tearing down the subprocess) if the CLI lingers after the
-     * result without emitting one. Advances the response's own generator, so
-     * the caller's surrounding loop resumes to a finished iterator.
-     */
-    private drainPromptSuggestion;
-    doGenerate(options: Parameters<LanguageModelV3['doGenerate']>[0]): Promise<Awaited<ReturnType<LanguageModelV3['doGenerate']>>>;
-    doStream(options: Parameters<LanguageModelV3['doStream']>[0]): Promise<Awaited<ReturnType<LanguageModelV3['doStream']>>>;
-    private serializeWarningsForMetadata;
-}
-
-/**
- * Claude Code provider interface that extends the AI SDK's ProviderV3.
- * Provides methods to create language models for interacting with Claude via the CLI.
- *
- * @example
- * ```typescript
- * import { claudeCode } from 'ai-sdk-provider-claude-code';
- *
- * // Create a model instance
- * const model = claudeCode('opus');
- *
- * // Or use the explicit methods
- * const chatModel = claudeCode.chat('sonnet');
- * const languageModel = claudeCode.languageModel('opus', { maxTurns: 10 });
- * ```
- */
-interface ClaudeCodeProvider extends ProviderV3 {
-    /**
-     * Creates a language model instance for the specified model ID.
-     * This is a shorthand for calling `languageModel()`.
-     *
-     * @param modelId - The Claude model to use ('opus' or 'sonnet')
-     * @param settings - Optional settings to configure the model
-     * @returns A language model instance
-     */
-    (modelId: ClaudeCodeModelId, settings?: ClaudeCodeSettings): LanguageModelV3;
-    /**
-     * Creates a language model instance for text generation.
-     *
-     * @param modelId - The Claude model to use ('opus' or 'sonnet')
-     * @param settings - Optional settings to configure the model
-     * @returns A language model instance
-     */
-    languageModel(modelId: ClaudeCodeModelId, settings?: ClaudeCodeSettings): LanguageModelV3;
-    /**
-     * Alias for `languageModel()` to maintain compatibility with AI SDK patterns.
-     *
-     * @param modelId - The Claude model to use ('opus' or 'sonnet')
-     * @param settings - Optional settings to configure the model
-     * @returns A language model instance
-     */
-    chat(modelId: ClaudeCodeModelId, settings?: ClaudeCodeSettings): LanguageModelV3;
-    imageModel(modelId: string): never;
-}
-/**
- * Configuration options for creating a Claude Code provider instance.
- * These settings will be applied as defaults to all models created by the provider.
- *
- * @example
- * ```typescript
- * const provider = createClaudeCode({
- *   defaultSettings: {
- *     maxTurns: 5,
- *     cwd: '/path/to/project'
- *   }
- * });
- * ```
- */
-interface ClaudeCodeProviderSettings {
-    /**
-     * Default settings to use for all models created by this provider.
-     * Individual model settings will override these defaults.
-     */
-    defaultSettings?: ClaudeCodeSettings;
-}
-/**
- * Creates a Claude Code provider instance with the specified configuration.
- * The provider can be used to create language models for interacting with Claude 4 models.
- *
- * @param options - Provider configuration options
- * @returns Claude Code provider instance
- *
- * @example
- * ```typescript
- * const provider = createClaudeCode({
- *   defaultSettings: {
- *     permissionMode: 'bypassPermissions',
- *     maxTurns: 10
- *   }
- * });
- *
- * const model = provider('opus');
- * ```
- */
-declare function createClaudeCode(options?: ClaudeCodeProviderSettings): ClaudeCodeProvider;
-/**
- * Default Claude Code provider instance.
- * Pre-configured provider for quick usage without custom settings.
- *
- * @example
- * ```typescript
- * import { claudeCode } from 'ai-sdk-provider-claude-code';
- * import { generateText } from 'ai';
- *
- * const { text } = await generateText({
- *   model: claudeCode('sonnet'),
- *   prompt: 'Hello, Claude!'
- * });
- * ```
- */
-declare const claudeCode: ClaudeCodeProvider;
-
-/**
- * Optional annotations for content items, per MCP specification.
- * Validated against MCP SDK schema version 2025-06-18.
- */
-type ContentAnnotations = {
-    /** Intended audience(s) for this content */
-    audience?: ('user' | 'assistant')[];
-    /** Priority hint (0 = least important, 1 = most important) */
-    priority?: number;
-    /** ISO 8601 timestamp of last modification */
-    lastModified?: string;
-};
-/**
- * MCP tool annotations for hinting tool behavior to the model.
- * Derived from the SDK's SdkMcpToolDefinition type to stay in sync
- * with the upstream MCP ToolAnnotations definition.
- */
-type ToolAnnotations = NonNullable<SdkMcpToolDefinition['annotations']>;
-/**
- * Convenience helper to create an SDK MCP server from a simple tool map.
- * Each tool provides a description, a Zod object schema, and a handler.
- *
- * Type definition validated against MCP SDK specification version 2025-06-18.
- * See: https://modelcontextprotocol.io/specification/2025-06-18/server/tools
- */
-type MinimalCallToolResult = {
-    content: Array<{
-        /** Text content */
-        type: 'text';
-        /** The text content (plain text or structured format like JSON) */
-        text: string;
-        annotations?: ContentAnnotations;
-        _meta?: Record<string, unknown>;
-        [key: string]: unknown;
-    } | {
-        /** Image content (base64-encoded) */
-        type: 'image';
-        /** Base64-encoded image data */
-        data: string;
-        /** MIME type of the image (e.g., image/png, image/jpeg) */
-        mimeType: string;
-        annotations?: ContentAnnotations;
-        _meta?: Record<string, unknown>;
-        [key: string]: unknown;
-    } | {
-        /** Audio content (base64-encoded) */
-        type: 'audio';
-        /** Base64-encoded audio data */
-        data: string;
-        /** MIME type of the audio (e.g., audio/wav, audio/mp3) */
-        mimeType: string;
-        annotations?: ContentAnnotations;
-        _meta?: Record<string, unknown>;
-        [key: string]: unknown;
-    } | {
-        /** Embedded resource with full content (text or blob) */
-        type: 'resource';
-        /** Resource contents - either text or blob variant */
-        resource: {
-            uri: string;
-            _meta?: Record<string, unknown>;
-            [key: string]: unknown;
-        } & ({
-            text: string;
-            mimeType?: string;
-        } | {
-            blob: string;
-            mimeType: string;
-        });
-        annotations?: ContentAnnotations;
-        _meta?: Record<string, unknown>;
-        [key: string]: unknown;
-    } | {
-        /** Resource link (reference only - no embedded content) */
-        type: 'resource_link';
-        /** URI of the resource */
-        uri: string;
-        /** Human-readable name (required per MCP spec) */
-        name: string;
-        /** Optional description of what this resource represents */
-        description?: string;
-        /** MIME type of the resource, if known */
-        mimeType?: string;
-        annotations?: ContentAnnotations;
-        _meta?: Record<string, unknown>;
-        [key: string]: unknown;
-    }>;
-    isError?: boolean;
-    structuredContent?: Record<string, unknown>;
-    _meta?: Record<string, unknown>;
-    [key: string]: unknown;
-};
-declare function createCustomMcpServer<Tools extends Record<string, {
-    description: string;
-    inputSchema: ZodObject<ZodRawShape>;
-    handler: (args: Record<string, unknown>, extra: unknown) => Promise<MinimalCallToolResult>;
-    annotations?: ToolAnnotations;
-}>>(config: {
-    name: string;
-    version?: string;
-    tools: Tools;
-}): McpSdkServerConfigWithInstance;
-/**
- * Minimal per-call options passed to an AI SDK tool's `execute` function
- * when it is invoked through {@link createAiSdkMcpServer}.
- *
- * Note that the AI SDK's full `ToolCallOptions` (e.g. `messages`,
- * `experimental_context`) is not available here: the tool runs inside the
- * Claude Code CLI's MCP transport, outside the AI SDK call loop.
- */
-type AiSdkToolExecuteOptions = {
-    /**
-     * Identifier of the MCP request that triggered this call, when available.
-     *
-     * Note: this is the MCP JSON-RPC request id (often a small integer like
-     * `'42'`), not the model's `toolu_...` tool_use id, so it will not match
-     * the `toolCallId` on the AI SDK's `tool-call`/`tool-result` stream parts.
-     */
-    toolCallId?: string;
-    /** Abort signal for the MCP request, when available. */
-    abortSignal?: AbortSignal;
-};
-/**
- * Structural shape of an AI SDK tool (what the `ai` package's `tool()` helper
- * returns) as accepted by {@link createAiSdkMcpServer}. Deliberately
- * structurally typed so this package does not depend on the `ai` package.
- *
- * Constraints:
- * - `inputSchema` must be a Zod object schema (`z.object({...})`, Zod v3 or
- *   v4) — the same schema you would pass to the `ai` package's `tool()`
- *   helper. Schemas created with the AI SDK's `jsonSchema()` helper are not
- *   supported because the Agent SDK's `tool()` requires a Zod shape.
- * - `execute` is required: only tools that execute locally can be bridged.
- */
-type AiSdkLikeTool = {
-    description?: string;
-    /** A Zod object schema (`z.object({...})`), Zod v3 or v4. */
-    inputSchema: unknown;
-    /**
-     * Tool implementation. Receives the validated input and a minimal options
-     * object ({@link AiSdkToolExecuteOptions}).
-     *
-     * Optional in the type only to stay assignment-compatible with the AI
-     * SDK's `Tool` type — {@link createAiSdkMcpServer} throws at creation time
-     * if it is missing.
-     */
-    execute?(input: never, options?: AiSdkToolExecuteOptions): PromiseLike<unknown> | unknown;
-};
-/**
- * Bridges AI SDK tool definitions (the `ai` package's `tool()` helper) into
- * an in-process SDK MCP server that the Claude Code CLI can execute.
- *
- * Why this helper exists: the Claude Code CLI executes its own tools, so AI
- * SDK tools passed to `generateText`/`streamText` via the `tools` option
- * cannot be auto-bridged by the provider — at the `LanguageModelV3` layer the
- * provider only receives tool *declarations* (name, description, JSON
- * schema); the `execute` functions live in the `ai` package layer and never
- * reach providers. This helper is the explicit alternative: pass your tools
- * here and wire the result into the `mcpServers` setting.
- *
- * Validation scope: the Agent SDK's `tool()` takes only the schema SHAPE and
- * validates incoming args against a default `z.object(shape)` — running
- * FIELD-LEVEL validation and transforms (the handler receives each field's
- * parsed `_output`) and STRIPPING unknown keys — before this handler runs. The
- * bridge does NOT re-parse on top of that: re-parsing the SDK's already-parsed
- * output against the original schema would re-run field transforms and would
- * outright reject any schema whose output type differs from its input (e.g.
- * `z.string().transform(v => v.length)`). Consequently OBJECT-LEVEL constructs
- * are NOT enforced by the bridge — `.refine()`/`.superRefine()` (cross-field
- * invariants) and `.strict()`/`.passthrough()`/`.catchall()` (unknown-key
- * modes) — so perform those checks inside `execute()`.
- *
- * Each tool's `execute` is called with the SDK-validated input and a minimal
- * options object ({@link AiSdkToolExecuteOptions}). String results pass
- * through as MCP text content; all other results are `JSON.stringify`'d.
- * Errors thrown (or rejections) become `isError: true` tool results instead
- * of crashing the CLI session. Results that cannot be serialized to JSON
- * (e.g. circular objects) also become `isError: true` results with a
- * serialization message, even though the tool itself succeeded.
- *
- * Tool results surface to the AI SDK as provider-executed dynamic tool parts
- * (`tool-call`/`tool-result` with `mcp__<serverName>__<toolName>` names), not
- * as executions of your local `tools` option.
- *
- * @param name - MCP server name. Tools are exposed to the CLI as
- *   `mcp__<name>__<toolName>`.
- * @param tools - Map of tool name to AI SDK tool. Each tool must have an
- *   `execute` function and a Zod object schema as its `inputSchema`
- *   (`jsonSchema()`-based tools are rejected).
- * @returns An SDK MCP server config for the `mcpServers` setting.
- * @throws If a tool lacks an `execute` function or its `inputSchema` is not
- *   a Zod object schema.
- *
- * @example
- * ```typescript
- * import { generateText, tool } from 'ai';
- * import { z } from 'zod';
- * import { claudeCode, createAiSdkMcpServer } from 'ai-sdk-provider-claude-code';
- *
- * const tools = {
- *   add: tool({
- *     description: 'Add two numbers',
- *     inputSchema: z.object({ a: z.number(), b: z.number() }),
- *     execute: async ({ a, b }) => ({ sum: a + b }),
- *   }),
- * };
- *
- * const { text } = await generateText({
- *   model: claudeCode('sonnet', {
- *     mcpServers: { myTools: createAiSdkMcpServer('myTools', tools) },
- *     // Tools are named mcp__<serverName>__<toolName>
- *     allowedTools: ['mcp__myTools__add'],
- *   }),
- *   prompt: 'What is 2 + 3? Use the add tool.',
- * });
- * ```
- */
-declare function createAiSdkMcpServer(name: string, tools: Record<string, AiSdkLikeTool>): McpSdkServerConfigWithInstance;
-
-/**
- * Metadata associated with Claude Code SDK errors.
- * Provides additional context about command execution failures.
- */
-interface ClaudeCodeErrorMetadata {
-    /**
-     * Error code from the CLI process (e.g., 'ENOENT', 'ETIMEDOUT').
-     */
-    code?: string;
-    /**
-     * Exit code from the Claude Code SDK process.
-     * Common codes:
-     * - 401: Authentication error
-     * - 1: General error
-     */
-    exitCode?: number;
-    /**
-     * Standard error output from the CLI process.
-     */
-    stderr?: string;
-    /**
-     * Excerpt from the prompt that caused the error.
-     * Limited to first 200 characters for debugging.
-     */
-    promptExcerpt?: string;
-}
-/**
- * Creates an APICallError with Claude Code specific metadata.
- * Used for general CLI execution errors.
- *
- * @param options - Error details and metadata
- * @param options.message - Human-readable error message
- * @param options.code - Error code from the CLI process
- * @param options.exitCode - Exit code from the CLI
- * @param options.stderr - Standard error output
- * @param options.promptExcerpt - Excerpt of the prompt that caused the error
- * @param options.isRetryable - Whether the error is potentially retryable
- * @returns An APICallError instance with Claude Code metadata
- *
- * @example
- * ```typescript
- * throw createAPICallError({
- *   message: 'Claude Code SDK failed',
- *   code: 'ENOENT',
- *   isRetryable: true
- * });
- * ```
- */
-declare function createAPICallError({ message, code, exitCode, stderr, promptExcerpt, isRetryable, }: ClaudeCodeErrorMetadata & {
-    message: string;
-    isRetryable?: boolean;
-}): APICallError;
-/**
- * Creates an authentication error for Claude Code SDK login failures.
- *
- * @param options - Error configuration
- * @param options.message - Error message describing the authentication failure
- * @returns A LoadAPIKeyError instance
- *
- * @example
- * ```typescript
- * throw createAuthenticationError({
- *   message: 'Please run "claude auth login" to authenticate'
- * });
- * ```
- */
-declare function createAuthenticationError({ message, stderr, }: {
-    message: string;
-    stderr?: string;
-}): LoadAPIKeyError;
-/**
- * Creates a timeout error for Claude Code SDK operations.
- *
- * @param options - Timeout error details
- * @param options.message - Error message describing the timeout
- * @param options.promptExcerpt - Excerpt of the prompt that timed out
- * @param options.timeoutMs - Timeout duration in milliseconds
- * @returns An APICallError instance configured as a timeout error
- *
- * @example
- * ```typescript
- * throw createTimeoutError({
- *   message: 'Request timed out after 2 minutes',
- *   timeoutMs: 120000
- * });
- * ```
- */
-declare function createTimeoutError({ message, stderr, promptExcerpt, timeoutMs, }: {
-    message: string;
-    stderr?: string;
-    promptExcerpt?: string;
-    timeoutMs?: number;
-}): APICallError;
-/**
- * Checks if an error is an authentication error.
- * Returns true for LoadAPIKeyError instances or APICallError with exit code 401.
- *
- * @param error - The error to check
- * @returns True if the error is an authentication error
- *
- * @example
- * ```typescript
- * try {
- *   await model.generate(...);
- * } catch (error) {
- *   if (isAuthenticationError(error)) {
- *     console.log('Please authenticate with Claude Code SDK');
- *   }
- * }
- * ```
- */
-declare function isAuthenticationError(error: unknown): boolean;
-/**
- * Checks if an error is a timeout error.
- * Returns true for APICallError instances with code 'TIMEOUT'.
- *
- * @param error - The error to check
- * @returns True if the error is a timeout error
- *
- * @example
- * ```typescript
- * try {
- *   await model.generate(...);
- * } catch (error) {
- *   if (isTimeoutError(error)) {
- *     console.log('Request timed out, consider retrying');
- *   }
- * }
- * ```
- */
-declare function isTimeoutError(error: unknown): boolean;
-/**
- * Extracts Claude Code error metadata from an error object.
- *
- * @param error - The error to extract metadata from
- * @returns The error metadata if available, undefined otherwise
- *
- * @example
- * ```typescript
- * try {
- *   await model.generate(...);
- * } catch (error) {
- *   const metadata = getErrorMetadata(error);
- *   if (metadata?.exitCode === 401) {
- *     console.log('Authentication required');
- *   }
- * }
- * ```
- */
-declare function getErrorMetadata(error: unknown): ClaudeCodeErrorMetadata | undefined;
-
-export { type AiSdkLikeTool, type AiSdkToolExecuteOptions, type ClaudeCodeErrorMetadata, ClaudeCodeLanguageModel, type ClaudeCodeLanguageModelOptions, type ClaudeCodeModelId, type ClaudeCodeProvider, type ClaudeCodeProviderSettings, type ClaudeCodeSettings, type Logger, type MessageInjector, type MinimalCallToolResult, type ToolAnnotations, claudeCode, createAPICallError, createAiSdkMcpServer, createAuthenticationError, createClaudeCode, createCustomMcpServer, createTimeoutError, getErrorMetadata, isAuthenticationError, isTimeoutError };