@theokit/sdk 1.6.2 → 1.8.0

package/dist/run-DrwUpFxZ.d.cts

@@ -0,0 +1,823 @@
+/**
+ * Type-leaf — primitives shared between `agent.ts`, `run.ts`, and
+ * `messages.ts`. Extracted to break LOW type-only cycles #5 and #7
+ * (audit `architecture-output/final_report.md`) per plan
+ * arch-review-fixes-2026-06-06 § Phase 4 / T4.1 (D438).
+ *
+ * Public surface unchanged — `types/agent.ts` re-exports these from this
+ * leaf so `import type { ModelSelection, CustomTool } from "@theokit/sdk"`
+ * keeps resolving.
+ *
+ * @public
+ */
+/**
+ * One slot in a {@link ModelSelection.params} array.
+ *
+ * @public
+ */
+interface ModelParameterValue {
+    id: string;
+    value: string;
+}
+/**
+ * Identifies a model plus optional per-model parameters (e.g. reasoning effort).
+ *
+ * Use `Theokit.models.list()` to discover valid ids and parameter definitions.
+ *
+ * @public
+ */
+interface ModelSelection {
+    id: string;
+    params?: ModelParameterValue[];
+}
+/**
+ * Local function tool declared per-agent via {@link AgentOptions.tools}. The
+ * handler runs in-process; no MCP server is involved. The SDK serializes
+ * `name`, `description`, and `inputSchema` into the model's tool catalog.
+ *
+ * Handlers MUST be re-passed on `Agent.resume()` because closures cannot be
+ * persisted. The tool catalog (name + description + schema) is NOT serialized.
+ *
+ * @public
+ */
+interface CustomTool {
+    /**
+     * Tool name surfaced to the LLM. Must match `^[a-zA-Z][a-zA-Z0-9_-]{0,63}$`
+     * and must not collide with `shell`, `memory_search`, `memory_get`, or any
+     * `mcp_*` prefix (reserved for the SDK's built-in tools).
+     */
+    name: string;
+    /** Description surfaced to the LLM. Required — drives tool-selection accuracy. */
+    description: string;
+    /** JSON Schema (Draft-7 subset) describing the `input` argument. Must be `type: "object"`. */
+    inputSchema: Record<string, unknown>;
+    /**
+     * Local handler invoked when the model emits `tool_use` for this tool.
+     * Returns a string (becomes the `tool_result.content` surfaced back to the
+     * model). Throws → SDK converts to `tool_result` with `isError: true` and
+     * the error `message` as content.
+     */
+    handler: (input: Record<string, unknown>) => string | Promise<string>;
+}
+
+/**
+ * Type-leaf — base message types shared between `conversation.ts` and
+ * `updates.ts`. Extracted to break LOW type-only cycle #6 (audit
+ * `architecture-output/final_report.md`) per plan arch-review-fixes-2026-06-06
+ * § Phase 4 / T4.1 (D438).
+ *
+ * Public surface unchanged — `types/conversation.ts` re-exports `UserMessage`
+ * from this leaf so `import type { UserMessage } from "@theokit/sdk"` keeps
+ * resolving.
+ *
+ * @public
+ */
+/**
+ * User-authored message in a conversation history.
+ *
+ * @public
+ */
+interface UserMessage {
+    text: string;
+}
+
+/**
+ * Single tool call event. The internal `args` and `result` shapes are NOT stable.
+ *
+ * @public
+ */
+interface ToolCall {
+    callId: string;
+    name: string;
+    args?: unknown;
+    result?: unknown;
+}
+/**
+ * Incremental text token from the assistant.
+ *
+ * @public
+ */
+interface TextDeltaUpdate {
+    type: "text-delta";
+    text: string;
+}
+/**
+ * Incremental reasoning token.
+ *
+ * @public
+ */
+interface ThinkingDeltaUpdate {
+    type: "thinking-delta";
+    text: string;
+}
+/**
+ * Emitted when a reasoning block completes.
+ *
+ * @public
+ */
+interface ThinkingCompletedUpdate {
+    type: "thinking-completed";
+    thinkingDurationMs: number;
+}
+/**
+ * Tool call started — args committed.
+ *
+ * @public
+ */
+interface ToolCallStartedUpdate {
+    type: "tool-call-started";
+    callId: string;
+    toolCall: ToolCall;
+    modelCallId: string;
+}
+/**
+ * Tool call arguments streaming in incrementally.
+ *
+ * @public
+ */
+interface PartialToolCallUpdate {
+    type: "partial-tool-call";
+    callId: string;
+    toolCall: ToolCall;
+    modelCallId: string;
+}
+/**
+ * Tool call completed.
+ *
+ * @public
+ */
+interface ToolCallCompletedUpdate {
+    type: "tool-call-completed";
+    callId: string;
+    toolCall: ToolCall;
+    modelCallId: string;
+}
+/**
+ * Token count delta for usage tracking.
+ *
+ * @public
+ */
+interface TokenDeltaUpdate {
+    type: "token-delta";
+    tokens: number;
+}
+/**
+ * Conversation step started.
+ *
+ * @public
+ */
+interface StepStartedUpdate {
+    type: "step-started";
+    stepId: number;
+}
+/**
+ * Conversation step completed.
+ *
+ * @public
+ */
+interface StepCompletedUpdate {
+    type: "step-completed";
+    stepId: number;
+    stepDurationMs: number;
+}
+/**
+ * Turn ended with usage summary.
+ *
+ * @public
+ */
+interface TurnEndedUpdate {
+    type: "turn-ended";
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+    };
+}
+/**
+ * User message appended to the conversation.
+ *
+ * @public
+ */
+interface UserMessageAppendedUpdate {
+    type: "user-message-appended";
+    userMessage: UserMessage;
+}
+/** @public */
+interface SummaryUpdate {
+    type: "summary";
+    summary: string;
+}
+/** @public */
+interface SummaryStartedUpdate {
+    type: "summary-started";
+}
+/** @public */
+interface SummaryCompletedUpdate {
+    type: "summary-completed";
+}
+/** @public */
+interface ShellOutputDeltaUpdate {
+    type: "shell-output-delta";
+    event: Record<string, unknown>;
+}
+/**
+ * Lowest-level raw update from a run. Pass `onDelta` to `agent.send()` to
+ * consume these. Finer-grained than `SDKMessage` events.
+ *
+ * @public
+ */
+type InteractionUpdate = TextDeltaUpdate | ThinkingDeltaUpdate | ThinkingCompletedUpdate | ToolCallStartedUpdate | ToolCallCompletedUpdate | PartialToolCallUpdate | TokenDeltaUpdate | StepStartedUpdate | StepCompletedUpdate | TurnEndedUpdate | UserMessageAppendedUpdate | SummaryUpdate | SummaryStartedUpdate | SummaryCompletedUpdate | ShellOutputDeltaUpdate;
+
+/**
+ * Plain assistant message in a conversation history.
+ *
+ * @public
+ */
+interface AssistantMessage {
+    text: string;
+}
+/**
+ * Reasoning step in a conversation history.
+ *
+ * @public
+ */
+interface ThinkingMessage {
+    text: string;
+    thinkingDurationMs?: number;
+}
+/**
+ * Shell command executed during a run.
+ *
+ * @public
+ */
+interface ShellCommand {
+    command: string;
+    workingDirectory?: string;
+}
+/**
+ * Output of a shell command.
+ *
+ * @public
+ */
+interface ShellOutput {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Single step inside an agent turn.
+ *
+ * @public
+ */
+/**
+ * Result of a tool invocation. Pairs with the preceding `toolCall` step
+ * by `callId`. `isError: true` when the tool returned a failure result.
+ *
+ * T2.3 — added so `Run.conversation()` surfaces the full interaction
+ * including tool results (parity with OpenAI Agents `RunResult.new_items`).
+ *
+ * @public
+ */
+interface ToolResult {
+    callId: string;
+    name: string;
+    result: string;
+    isError: boolean;
+}
+type ConversationStep = {
+    type: "assistantMessage";
+    message: AssistantMessage;
+} | {
+    type: "toolCall";
+    message: ToolCall;
+} | {
+    type: "toolResult";
+    message: ToolResult;
+} | {
+    type: "thinkingMessage";
+    message: ThinkingMessage;
+};
+/**
+ * Agent turn: user message + assistant/tool/thinking steps.
+ *
+ * @public
+ */
+interface AgentConversationTurn {
+    userMessage?: UserMessage;
+    steps: ConversationStep[];
+}
+/**
+ * Shell turn: a command and its output.
+ *
+ * @public
+ */
+interface ShellConversationTurn {
+    shellCommand?: ShellCommand;
+    shellOutput?: ShellOutput;
+}
+/**
+ * Structured per-turn view of a run.
+ *
+ * @public
+ */
+type ConversationTurn = {
+    type: "agentConversationTurn";
+    turn: AgentConversationTurn;
+} | {
+    type: "shellConversationTurn";
+    turn: ShellConversationTurn;
+};
+
+/**
+ * MCP server configuration accepted by `Agent.create()` and `agent.send()`.
+ *
+ * @public
+ */
+type McpStdioServerConfig = {
+    type?: "stdio";
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    /** Local agents only. Cloud rejects this field. */
+    cwd?: string;
+};
+/**
+ * OAuth-style auth bundle for HTTP/SSE MCP servers.
+ *
+ * @public
+ */
+interface McpAuthConfig {
+    CLIENT_ID: string;
+    CLIENT_SECRET?: string;
+    scopes?: string[];
+    /**
+     * OAuth 2.1 PKCE flow configuration (ADR D41, v1.2+). When present, the
+     * SDK runs the PKCE flow on first use and stores tokens via keychain or
+     * file. Without this, the SDK relies on `CLIENT_SECRET` + manual headers.
+     */
+    oauth?: McpOAuthConfig;
+}
+/**
+ * OAuth 2.1 PKCE flow descriptor. See ADR D41.
+ *
+ * @public
+ */
+interface McpOAuthConfig {
+    /** Authorization endpoint (e.g. https://api.notion.com/v1/oauth/authorize). */
+    authorizationEndpoint: string;
+    /** Token endpoint (e.g. https://api.notion.com/v1/oauth/token). */
+    tokenEndpoint: string;
+    /** Where the OAuth `code` is received. */
+    redirectMode: "manual" | "localhost";
+    /** Localhost callback port (0 = random free port, default). */
+    localhostPort?: number;
+    /** Flow timeout in ms (default 300_000 = 5min). */
+    timeoutMs?: number;
+}
+/**
+ * HTTP or SSE MCP server.
+ *
+ * @public
+ */
+type McpHttpServerConfig = {
+    type?: "http" | "sse";
+    url: string;
+    /** Passed through. `Authorization` works here. */
+    headers?: Record<string, string>;
+    auth?: McpAuthConfig;
+};
+/**
+ * Union of MCP server configs. See `docs.md` for the full reference.
+ *
+ * @public
+ */
+type McpServerConfig = McpStdioServerConfig | McpHttpServerConfig;
+
+/**
+ * Plain text content block emitted by the assistant or user.
+ *
+ * @public
+ */
+interface TextBlock {
+    type: "text";
+    text: string;
+}
+/**
+ * Tool invocation block emitted by the assistant.
+ *
+ * @public
+ */
+interface ToolUseBlock {
+    type: "tool_use";
+    id: string;
+    name: string;
+    /** Tool args are not part of the stable schema. Treat as unknown and parse defensively. */
+    input: unknown;
+}
+/**
+ * Init metadata. Emitted once at the start of a run.
+ *
+ * @public
+ */
+interface SDKSystemMessage {
+    type: "system";
+    subtype?: "init";
+    agent_id: string;
+    run_id: string;
+    model?: ModelSelection;
+    tools?: string[];
+}
+/**
+ * Echo of the user prompt for this run.
+ *
+ * @public
+ */
+interface SDKUserMessageEvent {
+    type: "user";
+    agent_id: string;
+    run_id: string;
+    message: {
+        role: "user";
+        content: TextBlock[];
+    };
+}
+/**
+ * Model text output for this run.
+ *
+ * @public
+ */
+interface SDKAssistantMessage {
+    type: "assistant";
+    agent_id: string;
+    run_id: string;
+    message: {
+        role: "assistant";
+        content: Array<TextBlock | ToolUseBlock>;
+    };
+}
+/**
+ * Reasoning content.
+ *
+ * @public
+ */
+interface SDKThinkingMessage {
+    type: "thinking";
+    agent_id: string;
+    run_id: string;
+    text: string;
+    thinking_duration_ms?: number;
+}
+/**
+ * Tool invocation lifecycle event. Emitted at start with `args`, then again on
+ * completion with `result`.
+ *
+ * Tool `args` and `result` are NOT part of the stable schema — treat as unknown.
+ *
+ * @public
+ */
+interface SDKToolUseMessage {
+    type: "tool_call";
+    agent_id: string;
+    run_id: string;
+    call_id: string;
+    name: string;
+    status: "running" | "completed" | "error";
+    args?: unknown;
+    result?: unknown;
+    truncated?: {
+        args?: boolean;
+        result?: boolean;
+    };
+}
+/**
+ * Cloud run lifecycle transitions.
+ *
+ * @public
+ */
+interface SDKStatusMessage {
+    type: "status";
+    agent_id: string;
+    run_id: string;
+    status: "CREATING" | "RUNNING" | "FINISHED" | "ERROR" | "CANCELLED" | "EXPIRED";
+    message?: string;
+}
+/**
+ * Task-level milestones and summaries.
+ *
+ * @public
+ */
+interface SDKTaskMessage {
+    type: "task";
+    agent_id: string;
+    run_id: string;
+    status?: string;
+    text?: string;
+}
+/**
+ * Awaiting user input or approval.
+ *
+ * @public
+ */
+interface SDKRequestMessage {
+    type: "request";
+    agent_id: string;
+    run_id: string;
+    request_id: string;
+}
+/**
+ * Partial object emitted during `Agent.streamObject<T>` streaming (ADR D45).
+ * `partial` is `DeepPartial<z.infer<T>>` at the typed iterator level but
+ * erased to `unknown` here because SDKMessage union is non-generic.
+ *
+ * @public
+ */
+interface SDKObjectDelta {
+    type: "object_delta";
+    agent_id: string;
+    run_id: string;
+    partial: unknown;
+    attempt: number;
+}
+/**
+ * Discriminated union of all stream events. Discriminate on `type`.
+ *
+ * All events include `agent_id` and `run_id`.
+ *
+ * @public
+ */
+type SDKMessage = SDKSystemMessage | SDKUserMessageEvent | SDKAssistantMessage | SDKThinkingMessage | SDKToolUseMessage | SDKStatusMessage | SDKTaskMessage | SDKRequestMessage | SDKObjectDelta;
+
+/**
+ * Public type contract for token usage + cost tracking (ADRs D376-D379).
+ *
+ * Surfaces via `RunResult.usage` + `RunResult.cost` after every Run.
+ * Re-exported through the package barrel; consumers import from
+ * `@theokit/sdk`.
+ *
+ * @public
+ */
+/**
+ * Token usage observed during a Run. 5 closed buckets (D376) cover
+ * 100% of providers in 2026: OpenAI Chat / OpenAI Responses (o-series
+ * with reasoning) / Anthropic Messages (with prompt caching).
+ *
+ * `totalTokens` is derived (`inputTokens + outputTokens`); EC-10
+ * invariant: SDK must never emit `totalTokens !== inputTokens + outputTokens`.
+ *
+ * `requests[]` is the per-request breakdown (mirror openai-agents-python)
+ * — populated only when the run made > 1 LLM call.
+ */
+interface TokenUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens?: number;
+    readonly cacheWriteTokens?: number;
+    readonly reasoningTokens?: number;
+    readonly totalTokens: number;
+    /** Per-request breakdown; absent when the run made a single LLM call. */
+    readonly requests?: ReadonlyArray<Omit<TokenUsage, "requests">>;
+}
+/**
+ * Cost confidence level (D377).
+ * - `actual`: returned by a provider billing API (e.g. OpenRouter `/generation`).
+ * - `estimated`: computed from bundled pricing snapshot.
+ * - `included`: subscription-included route (Codex CLI, Claude Pro).
+ * - `unknown`: pricing data unavailable; `amountUsd` is undefined.
+ */
+type CostStatus = "actual" | "estimated" | "included" | "unknown";
+/** Source of the cost figure for caller-side audit. */
+type CostSource = "openrouter_api" | "litellm_snapshot" | "user_override" | "subscription_included" | "unknown";
+/**
+ * Cost breakdown attached to `RunResult.cost`. When `status === "unknown"`,
+ * `amountUsd` is `undefined` — DO NOT default to 0 (mentira). UI exibe
+ * `n/a` para unknown, `~$1.23` para estimated, `$1.23` para actual.
+ */
+interface CostBreakdown {
+    readonly amountUsd: number | undefined;
+    readonly status: CostStatus;
+    readonly currency: "USD";
+    readonly source: CostSource;
+    readonly pricingVersion: string | undefined;
+    readonly notes?: ReadonlyArray<string>;
+    /** Per-bucket detail (in USD) for caller analytics. */
+    readonly detail?: {
+        readonly input?: number;
+        readonly output?: number;
+        readonly cacheRead?: number;
+        readonly cacheWrite?: number;
+        readonly reasoning?: number;
+    };
+}
+
+/**
+ * Lifecycle status of a {@link Run}.
+ *
+ * @public
+ */
+type RunStatus = "running" | "finished" | "error" | "cancelled";
+/**
+ * Operations that may or may not be supported on a given {@link Run}, or on
+ * its parent agent.
+ *
+ * Runtime-specific availability — query at runtime with `run.supports(op)` and
+ * read the human reason via `run.unsupportedReason(op)`.
+ *
+ * @public
+ */
+type RunOperation = "stream" | "wait" | "cancel" | "conversation" | "listArtifacts" | "downloadArtifact" | "runUntil" | "fork" | "usePersonality" | "workflow";
+/**
+ * Git metadata attached to cloud runs.
+ *
+ * @public
+ */
+interface RunGitInfo {
+    branches: Array<{
+        repoUrl: string;
+        branch?: string;
+        prUrl?: string;
+    }>;
+}
+/**
+ * Terminal result of a {@link Run}.
+ *
+ * @public
+ */
+interface RunResult {
+    id: string;
+    status: "finished" | "error" | "cancelled";
+    result?: string;
+    model?: ModelSelection;
+    durationMs?: number;
+    git?: RunGitInfo;
+    /**
+     * Structured error detail, populated when `status === "error"`. Surfaces
+     * the diagnostic that emit-error-event pushes into the stream so callers
+     * that don't drain `run.stream()` still get the cause via `run.wait()`.
+     *
+     * For successful runs (`status: "finished"`) this is undefined.
+     *
+     * @public
+     */
+    error?: RunErrorDetail;
+    /**
+     * Token usage observed for this run (ADR D376). Populated in every
+     * status where ≥1 LLM call completed — including partial-failure
+     * runs (EC-5). `undefined` only when zero LLM calls executed (e.g.,
+     * abort before send).
+     *
+     * @public
+     */
+    usage?: TokenUsage;
+    /**
+     * Estimated/actual USD cost for this run (ADR D377). Always paired
+     * with `usage` when populated. `cost.status` tells caller how to
+     * trust the figure.
+     *
+     * @public
+     */
+    cost?: CostBreakdown;
+}
+/**
+ * Structured error attached to a {@link RunResult} when the underlying run
+ * transitioned to `"error"` status. `message` is always present; `code` is
+ * a stable identifier suitable for branching (e.g. `"llm_4xx"`,
+ * `"tool_dispatch_failed"`, `"mcp_init_failed"`); `cause` is the raw error
+ * for further inspection when available.
+ *
+ * @public
+ */
+interface RunErrorDetail {
+    message: string;
+    code?: string;
+    cause?: unknown;
+}
+/**
+ * Dimensions of an inline image attachment.
+ *
+ * @public
+ */
+interface SDKImageDimension {
+    width: number;
+    height: number;
+}
+/**
+ * Either a remote URL or inline base64 payload.
+ *
+ * @public
+ */
+type SDKImage = {
+    url: string;
+    dimension?: SDKImageDimension;
+} | {
+    data: string;
+    mimeType: string;
+    dimension?: SDKImageDimension;
+};
+/**
+ * Structured form of `agent.send()`'s message argument. Use it to send images
+ * alongside text.
+ *
+ * @public
+ */
+interface SDKUserMessage {
+    text: string;
+    images?: SDKImage[];
+}
+/**
+ * Per-send overrides and callbacks.
+ *
+ * @public
+ */
+interface SendOptions {
+    model?: ModelSelection;
+    /**
+     * Per-call system prompt override. Wins over `AgentOptions.systemPrompt`.
+     * String only — for dynamic resolvers, configure on `AgentOptions`. An
+     * empty string is honoured (it explicitly clears the system context).
+     */
+    systemPrompt?: string;
+    /** Fully replaces creation-time servers for this run (not merged). */
+    mcpServers?: Record<string, McpServerConfig>;
+    /**
+     * Per-call inline custom tools. Fully replaces `AgentOptions.tools` for
+     * this run (not merged). Local runtime only — cloud agents reject any
+     * non-empty per-call tools array with the same error code as creation
+     * (`cloud_custom_tools_rejected`). Semantics:
+     * - `undefined` → fall back to `AgentOptions.tools`
+     * - `[]` → explicitly clear (no custom tools for this run)
+     * - `[t1, t2]` → use exactly these tools for this run
+     */
+    tools?: CustomTool[];
+    onStep?: (args: {
+        step: ConversationStep;
+    }) => void | Promise<void>;
+    onDelta?: (args: {
+        update: InteractionUpdate;
+    }) => void | Promise<void>;
+    /** Local agents only. Expire a stuck active run before starting this message. */
+    local?: {
+        force?: boolean;
+    };
+    /**
+     * Optional `AbortSignal` propagated to memory adapter `pre_user_send`
+     * hooks (EC-H). Note: the LLM HTTP call itself is NOT cancellable
+     * mid-stream — same constraint as `Agent.batch` (ADR D140).
+     *
+     * @public
+     */
+    signal?: AbortSignal;
+    /**
+     * Opt-in task wrapping (ADRs D363, D374). When truthy, the entire
+     * run is registered as a `Task` in the SDK's observable registry —
+     * caller can list / inspect / cancel / subscribe via the `Task`
+     * namespace. Default behavior (no `task` option) is byte-identical
+     * to v1.1 (no Task overhead).
+     *
+     * Accepts:
+     * - `true` — auto-generate task id; no extra metadata.
+     * - `{ id, meta }` — user-supplied id (D368 grammar enforced) and/or
+     *   metadata attached to the handle's `meta` field.
+     *
+     * The work-fn `signal` is **merged** with `options.signal` (whichever
+     * aborts first wins). Local agents only — CloudAgent throws
+     * `UnsupportedTaskOperationError` (D370).
+     *
+     * @public
+     */
+    task?: true | {
+        id?: string;
+        meta?: Record<string, unknown>;
+    };
+}
+/**
+ * Handle to a single prompt submission.
+ *
+ * @public
+ */
+interface Run {
+    readonly id: string;
+    readonly agentId: string;
+    readonly status: RunStatus;
+    readonly result?: string;
+    readonly model?: ModelSelection;
+    readonly durationMs?: number;
+    readonly git?: RunGitInfo;
+    readonly createdAt?: number;
+    /** AsyncGenerator of normalized stream events. Discriminate on `event.type`. */
+    stream(): AsyncGenerator<SDKMessage, void>;
+    /** Resolves to the terminal {@link RunResult}. */
+    wait(): Promise<RunResult>;
+    /** Move status to `"cancelled"`, abort the stream, stop in-flight tool calls. */
+    cancel(): Promise<void>;
+    /** Structured per-turn view of the conversation. */
+    conversation(): Promise<ConversationTurn[]>;
+    /** Whether the given operation is available on this run's runtime. */
+    supports(operation: RunOperation): boolean;
+    /** Human-readable reason that `supports(operation)` returned `false`. */
+    unsupportedReason(operation: RunOperation): string | undefined;
+    /** Subscribe to status changes. Returns an unsubscribe function. */
+    onDidChangeStatus(listener: (status: RunStatus) => void): () => void;
+}
+
+export type { ToolCall as $, AgentConversationTurn as A, SDKToolUseMessage as B, CustomTool as C, SDKUserMessage as D, SDKUserMessageEvent as E, SendOptions as F, ShellCommand as G, ShellConversationTurn as H, InteractionUpdate as I, ShellOutput as J, ShellOutputDeltaUpdate as K, StepCompletedUpdate as L, ModelSelection as M, StepStartedUpdate as N, SummaryCompletedUpdate as O, PartialToolCallUpdate as P, SummaryStartedUpdate as Q, RunResult as R, SDKMessage as S, SummaryUpdate as T, TextBlock as U, TextDeltaUpdate as V, ThinkingCompletedUpdate as W, ThinkingDeltaUpdate as X, ThinkingMessage as Y, TokenDeltaUpdate as Z, TokenUsage as _, McpServerConfig as a, ToolCallCompletedUpdate as a0, ToolCallStartedUpdate as a1, ToolResult as a2, ToolUseBlock as a3, TurnEndedUpdate as a4, UserMessage as a5, UserMessageAppendedUpdate as a6, Run as b, AssistantMessage as c, ConversationStep as d, ConversationTurn as e, CostBreakdown as f, CostSource as g, CostStatus as h, McpAuthConfig as i, McpHttpServerConfig as j, McpOAuthConfig as k, McpStdioServerConfig as l, ModelParameterValue as m, RunErrorDetail as n, RunGitInfo as o, RunOperation as p, RunStatus as q, SDKAssistantMessage as r, SDKImage as s, SDKImageDimension as t, SDKObjectDelta as u, SDKRequestMessage as v, SDKStatusMessage as w, SDKSystemMessage as x, SDKTaskMessage as y, SDKThinkingMessage as z };