@archastro/sdk 0.5.2 → 0.6.0

package/dist/types/ai.d.ts

@@ -1,9 +1,70 @@
 import { z } from "zod";
-/** Tool call from assistant message. */
+/** Terminal event marking the end of a streaming chat completion (SSE `done` event). */
+export interface AIChatStreamDone {
+    /** The overall finish reason for the completion. */
+    finish_reason?: string | undefined;
+    /** Number of model runs executed, including continuations triggered by tool calls. */
+    run_count?: number | undefined;
+    /** Aggregate token usage across every run in the completion (including tool-call continuations), keyed by model ID. */
+    total_usage?: Record<string, unknown> | undefined;
+    /** Token usage for the final run, keyed by model ID. */
+    usage?: Record<string, unknown> | undefined;
+}
+/** Runtime validator for {@link AIChatStreamDone}. */
+export declare const aIChatStreamDoneSchema: z.ZodObject<{
+    /** The overall finish reason for the completion. */
+    finish_reason: z.ZodOptional<z.ZodString>;
+    /** Number of model runs executed, including continuations triggered by tool calls. */
+    run_count: z.ZodOptional<z.ZodNumber>;
+    /** Aggregate token usage across every run in the completion (including tool-call continuations), keyed by model ID. */
+    total_usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Token usage for the final run, keyed by model ID. */
+    usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    run_count?: number | undefined;
+    finish_reason?: string | undefined;
+    total_usage?: Record<string, unknown> | undefined;
+    usage?: Record<string, unknown> | undefined;
+}, {
+    run_count?: number | undefined;
+    finish_reason?: string | undefined;
+    total_usage?: Record<string, unknown> | undefined;
+    usage?: Record<string, unknown> | undefined;
+}>;
+/** Terminal error event for a streaming chat completion (SSE `error` event). */
+export interface AIChatStreamError {
+    /** Human-readable description of the error that terminated the stream. */
+    message: string;
+}
+/** Runtime validator for {@link AIChatStreamError}. */
+export declare const aIChatStreamErrorSchema: z.ZodObject<{
+    /** Human-readable description of the error that terminated the stream. */
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+}, {
+    message: string;
+}>;
+/** A tool (function) call emitted by the assistant within an AI message. Mirrors the OpenAI tool-call object format. */
+export interface AIToolCall {
+    /** Arguments the model wants to pass to the tool, as a key-value map. Deserialize and validate these against the tool's input schema before executing. */
+    arguments: Record<string, unknown>;
+    /** Unique identifier for this tool call, assigned by the model. Use this value as `id` when submitting the corresponding tool result. */
+    id: string;
+    /** Name of the tool or function the model wants to invoke, e.g. `"web_search"` or `"run_code"`. */
+    name: string;
+    /** Opaque signature representing the model's internal reasoning that led to this tool call. `null` when the provider does not expose chain-of-thought data. */
+    thought_signature?: string | undefined;
+}
+/** Runtime validator for {@link AIToolCall}. */
 export declare const aIToolCallSchema: z.ZodObject<{
+    /** Arguments the model wants to pass to the tool, as a key-value map. Deserialize and validate these against the tool's input schema before executing. */
     arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /** Unique identifier for this tool call, assigned by the model. Use this value as `id` when submitting the corresponding tool result. */
     id: z.ZodString;
+    /** Name of the tool or function the model wants to invoke, e.g. `"web_search"` or `"run_code"`. */
     name: z.ZodString;
+    /** Opaque signature representing the model's internal reasoning that led to this tool call. `null` when the provider does not expose chain-of-thought data. */
     thought_signature: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
@@ -16,12 +77,26 @@ export declare const aIToolCallSchema: z.ZodObject<{
     arguments: Record<string, unknown>;
     thought_signature?: string | undefined;
 }>;
-export type AIToolCall = z.infer<typeof aIToolCallSchema>;
-/** Tool result from tool execution. */
+/** The result of executing a tool call, submitted back to the model as a tool-role message. Mirrors the OpenAI tool-result object format. */
+export interface AIToolResult {
+    /** Plain-text output produced by the tool execution. `null` when the result is expressed entirely through `resolution`. */
+    content?: string | undefined;
+    /** ID of the tool call this result satisfies. Must match the `id` from the corresponding `AIToolCall`. */
+    id: string;
+    /** Name of the tool or function that was executed, e.g. `"web_search"`. Must match the `name` from the corresponding `AIToolCall`. */
+    name: string;
+    /** Structured result data from the tool execution. Shape varies by tool. `null` when the result is expressed as plain text in `content`. */
+    resolution?: unknown | undefined;
+}
+/** Runtime validator for {@link AIToolResult}. */
 export declare const aIToolResultSchema: z.ZodObject<{
+    /** Plain-text output produced by the tool execution. `null` when the result is expressed entirely through `resolution`. */
     content: z.ZodOptional<z.ZodString>;
+    /** ID of the tool call this result satisfies. Must match the `id` from the corresponding `AIToolCall`. */
     id: z.ZodString;
+    /** Name of the tool or function that was executed, e.g. `"web_search"`. Must match the `name` from the corresponding `AIToolCall`. */
     name: z.ZodString;
+    /** Structured result data from the tool execution. Shape varies by tool. `null` when the result is expressed as plain text in `content`. */
     resolution: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
     id: string;
@@ -34,18 +109,44 @@ export declare const aIToolResultSchema: z.ZodObject<{
     content?: string | undefined;
     resolution?: unknown;
 }>;
-export type AIToolResult = z.infer<typeof aIToolResultSchema>;
-/** AI chat message (OpenAI-compatible format). */
+/** A single message in an AI conversation, following the OpenAI-compatible chat format. Used in both request inputs and completion responses. */
+export interface AIMessage {
+    /** Plain-text content of the message. Present for `system`, `user`, and `assistant` messages. `null` when the message body is expressed through `content_parts` or `tool_calls`. */
+    content?: string | undefined;
+    /** Multimodal content parts for the message, used when the body includes images or mixed media. Each part is a map with a `type` key (`"text"`, `"image_url"`, or `"image_data"`). `null` when `content` is set. */
+    content_parts?: Record<string, unknown>[] | undefined;
+    /** Opaque token that can be passed on a subsequent request to resume this conversation from the current state. `null` when the provider does not support conversation resumption. */
+    resume_token?: string | undefined;
+    /** The speaker role for this message. One of `"system"`, `"user"`, `"assistant"`, or `"tool"`. */
+    role: string;
+    /** Parsed structured data returned by the model when a JSON schema or structured-output mode was requested. Shape varies by the schema supplied at call time. `null` when structured output was not requested. */
+    structured_output?: unknown | undefined;
+    /** Tool calls requested by the model in an `assistant` message. Present only on assistant messages that invoke one or more tools. `null` on all other message roles. */
+    tool_calls?: AIToolCall[] | undefined;
+    /** Tool execution results provided in a `tool` message. Each entry corresponds to a prior tool call by its `id`. `null` on all other message roles. */
+    tool_results?: AIToolResult[] | undefined;
+}
+/** Runtime validator for {@link AIMessage}. */
 export declare const aIMessageSchema: z.ZodObject<{
+    /** Plain-text content of the message. Present for `system`, `user`, and `assistant` messages. `null` when the message body is expressed through `content_parts` or `tool_calls`. */
     content: z.ZodOptional<z.ZodString>;
+    /** Multimodal content parts for the message, used when the body includes images or mixed media. Each part is a map with a `type` key (`"text"`, `"image_url"`, or `"image_data"`). `null` when `content` is set. */
     content_parts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    /** Opaque token that can be passed on a subsequent request to resume this conversation from the current state. `null` when the provider does not support conversation resumption. */
     resume_token: z.ZodOptional<z.ZodString>;
+    /** The speaker role for this message. One of `"system"`, `"user"`, `"assistant"`, or `"tool"`. */
     role: z.ZodString;
+    /** Parsed structured data returned by the model when a JSON schema or structured-output mode was requested. Shape varies by the schema supplied at call time. `null` when structured output was not requested. */
     structured_output: z.ZodOptional<z.ZodUnknown>;
+    /** Tool calls requested by the model in an `assistant` message. Present only on assistant messages that invoke one or more tools. `null` on all other message roles. */
     tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Arguments the model wants to pass to the tool, as a key-value map. Deserialize and validate these against the tool's input schema before executing. */
         arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        /** Unique identifier for this tool call, assigned by the model. Use this value as `id` when submitting the corresponding tool result. */
         id: z.ZodString;
+        /** Name of the tool or function the model wants to invoke, e.g. `"web_search"` or `"run_code"`. */
         name: z.ZodString;
+        /** Opaque signature representing the model's internal reasoning that led to this tool call. `null` when the provider does not expose chain-of-thought data. */
         thought_signature: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         id: string;
@@ -58,10 +159,15 @@ export declare const aIMessageSchema: z.ZodObject<{
         arguments: Record<string, unknown>;
         thought_signature?: string | undefined;
     }>, "many">>;
+    /** Tool execution results provided in a `tool` message. Each entry corresponds to a prior tool call by its `id`. `null` on all other message roles. */
     tool_results: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Plain-text output produced by the tool execution. `null` when the result is expressed entirely through `resolution`. */
         content: z.ZodOptional<z.ZodString>;
+        /** ID of the tool call this result satisfies. Must match the `id` from the corresponding `AIToolCall`. */
         id: z.ZodString;
+        /** Name of the tool or function that was executed, e.g. `"web_search"`. Must match the `name` from the corresponding `AIToolCall`. */
         name: z.ZodString;
+        /** Structured result data from the tool execution. Shape varies by tool. `null` when the result is expressed as plain text in `content`. */
         resolution: z.ZodOptional<z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
         id: string;
@@ -111,20 +217,265 @@ export declare const aIMessageSchema: z.ZodObject<{
         resolution?: unknown;
     }[] | undefined;
 }>;
-export type AIMessage = z.infer<typeof aIMessageSchema>;
-/** Schema for AI chat completion results. */
+/** The fully assembled assistant message for one run of a streaming chat completion (SSE `message_complete` event). */
+export interface AIChatStreamMessageComplete {
+    /** Why the model stopped generating this message, e.g. `"stop"`, `"length"`, or `"tool_calls"`. */
+    finish_reason?: string | undefined;
+    /** The complete assistant message for this run, assembled from the preceding deltas. */
+    message: AIMessage;
+    /** Token consumption for this run, keyed by model ID. `null` when usage data is unavailable. */
+    usage?: Record<string, unknown> | undefined;
+}
+/** Runtime validator for {@link AIChatStreamMessageComplete}. */
+export declare const aIChatStreamMessageCompleteSchema: z.ZodObject<{
+    /** Why the model stopped generating this message, e.g. `"stop"`, `"length"`, or `"tool_calls"`. */
+    finish_reason: z.ZodOptional<z.ZodString>;
+    /** The complete assistant message for this run, assembled from the preceding deltas. */
+    message: z.ZodObject<{
+        /** Plain-text content of the message. Present for `system`, `user`, and `assistant` messages. `null` when the message body is expressed through `content_parts` or `tool_calls`. */
+        content: z.ZodOptional<z.ZodString>;
+        /** Multimodal content parts for the message, used when the body includes images or mixed media. Each part is a map with a `type` key (`"text"`, `"image_url"`, or `"image_data"`). `null` when `content` is set. */
+        content_parts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        /** Opaque token that can be passed on a subsequent request to resume this conversation from the current state. `null` when the provider does not support conversation resumption. */
+        resume_token: z.ZodOptional<z.ZodString>;
+        /** The speaker role for this message. One of `"system"`, `"user"`, `"assistant"`, or `"tool"`. */
+        role: z.ZodString;
+        /** Parsed structured data returned by the model when a JSON schema or structured-output mode was requested. Shape varies by the schema supplied at call time. `null` when structured output was not requested. */
+        structured_output: z.ZodOptional<z.ZodUnknown>;
+        /** Tool calls requested by the model in an `assistant` message. Present only on assistant messages that invoke one or more tools. `null` on all other message roles. */
+        tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Arguments the model wants to pass to the tool, as a key-value map. Deserialize and validate these against the tool's input schema before executing. */
+            arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            /** Unique identifier for this tool call, assigned by the model. Use this value as `id` when submitting the corresponding tool result. */
+            id: z.ZodString;
+            /** Name of the tool or function the model wants to invoke, e.g. `"web_search"` or `"run_code"`. */
+            name: z.ZodString;
+            /** Opaque signature representing the model's internal reasoning that led to this tool call. `null` when the provider does not expose chain-of-thought data. */
+            thought_signature: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+            thought_signature?: string | undefined;
+        }, {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+            thought_signature?: string | undefined;
+        }>, "many">>;
+        /** Tool execution results provided in a `tool` message. Each entry corresponds to a prior tool call by its `id`. `null` on all other message roles. */
+        tool_results: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Plain-text output produced by the tool execution. `null` when the result is expressed entirely through `resolution`. */
+            content: z.ZodOptional<z.ZodString>;
+            /** ID of the tool call this result satisfies. Must match the `id` from the corresponding `AIToolCall`. */
+            id: z.ZodString;
+            /** Name of the tool or function that was executed, e.g. `"web_search"`. Must match the `name` from the corresponding `AIToolCall`. */
+            name: z.ZodString;
+            /** Structured result data from the tool execution. Shape varies by tool. `null` when the result is expressed as plain text in `content`. */
+            resolution: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name: string;
+            content?: string | undefined;
+            resolution?: unknown;
+        }, {
+            id: string;
+            name: string;
+            content?: string | undefined;
+            resolution?: unknown;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        role: string;
+        content?: string | undefined;
+        content_parts?: Record<string, unknown>[] | undefined;
+        resume_token?: string | undefined;
+        structured_output?: unknown;
+        tool_calls?: {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+            thought_signature?: string | undefined;
+        }[] | undefined;
+        tool_results?: {
+            id: string;
+            name: string;
+            content?: string | undefined;
+            resolution?: unknown;
+        }[] | undefined;
+    }, {
+        role: string;
+        content?: string | undefined;
+        content_parts?: Record<string, unknown>[] | undefined;
+        resume_token?: string | undefined;
+        structured_output?: unknown;
+        tool_calls?: {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+            thought_signature?: string | undefined;
+        }[] | undefined;
+        tool_results?: {
+            id: string;
+            name: string;
+            content?: string | undefined;
+            resolution?: unknown;
+        }[] | undefined;
+    }>;
+    /** Token consumption for this run, keyed by model ID. `null` when usage data is unavailable. */
+    usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    message: {
+        role: string;
+        content?: string | undefined;
+        content_parts?: Record<string, unknown>[] | undefined;
+        resume_token?: string | undefined;
+        structured_output?: unknown;
+        tool_calls?: {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+            thought_signature?: string | undefined;
+        }[] | undefined;
+        tool_results?: {
+            id: string;
+            name: string;
+            content?: string | undefined;
+            resolution?: unknown;
+        }[] | undefined;
+    };
+    finish_reason?: string | undefined;
+    usage?: Record<string, unknown> | undefined;
+}, {
+    message: {
+        role: string;
+        content?: string | undefined;
+        content_parts?: Record<string, unknown>[] | undefined;
+        resume_token?: string | undefined;
+        structured_output?: unknown;
+        tool_calls?: {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+            thought_signature?: string | undefined;
+        }[] | undefined;
+        tool_results?: {
+            id: string;
+            name: string;
+            content?: string | undefined;
+            resolution?: unknown;
+        }[] | undefined;
+    };
+    finish_reason?: string | undefined;
+    usage?: Record<string, unknown> | undefined;
+}>;
+/** Incremental assistant text emitted during a streaming chat completion (SSE `message_delta` event). */
+export interface AIChatStreamMessageDelta {
+    /** The chunk of assistant text produced since the previous `message_delta` event. Concatenate deltas in order to reconstruct the message. */
+    delta: string;
+}
+/** Runtime validator for {@link AIChatStreamMessageDelta}. */
+export declare const aIChatStreamMessageDeltaSchema: z.ZodObject<{
+    /** The chunk of assistant text produced since the previous `message_delta` event. Concatenate deltas in order to reconstruct the message. */
+    delta: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    delta: string;
+}, {
+    delta: string;
+}>;
+/** Incremental tool-call data emitted as the model assembles a tool invocation (SSE `tool_call_delta` event). */
+export interface AIChatStreamToolCallDelta {
+    /** A chunk of the tool call's serialized arguments. Concatenate deltas to reconstruct the arguments JSON. */
+    delta?: string | undefined;
+    /** Identifier of the tool call this delta belongs to, once the model has assigned one. */
+    id?: string | undefined;
+    /** Name of the tool being called, once known. */
+    name?: string | undefined;
+}
+/** Runtime validator for {@link AIChatStreamToolCallDelta}. */
+export declare const aIChatStreamToolCallDeltaSchema: z.ZodObject<{
+    /** A chunk of the tool call's serialized arguments. Concatenate deltas to reconstruct the arguments JSON. */
+    delta: z.ZodOptional<z.ZodString>;
+    /** Identifier of the tool call this delta belongs to, once the model has assigned one. */
+    id: z.ZodOptional<z.ZodString>;
+    /** Name of the tool being called, once known. */
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | undefined;
+    name?: string | undefined;
+    delta?: string | undefined;
+}, {
+    id?: string | undefined;
+    name?: string | undefined;
+    delta?: string | undefined;
+}>;
+/** The result of a server-executed tool, streamed back into the run (SSE `tool_result` event). */
+export interface AIChatStreamToolResult {
+    /** The tool's output, serialized as a string. */
+    content?: string | undefined;
+    /** ID of the tool call this result satisfies. */
+    id?: string | undefined;
+    /** Name of the tool that produced this result. */
+    name?: string | undefined;
+    /** How the tool call resolved, e.g. `"ok"` or `"error"`. */
+    resolution?: string | undefined;
+}
+/** Runtime validator for {@link AIChatStreamToolResult}. */
+export declare const aIChatStreamToolResultSchema: z.ZodObject<{
+    /** The tool's output, serialized as a string. */
+    content: z.ZodOptional<z.ZodString>;
+    /** ID of the tool call this result satisfies. */
+    id: z.ZodOptional<z.ZodString>;
+    /** Name of the tool that produced this result. */
+    name: z.ZodOptional<z.ZodString>;
+    /** How the tool call resolved, e.g. `"ok"` or `"error"`. */
+    resolution: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content?: string | undefined;
+    id?: string | undefined;
+    name?: string | undefined;
+    resolution?: string | undefined;
+}, {
+    content?: string | undefined;
+    id?: string | undefined;
+    name?: string | undefined;
+    resolution?: string | undefined;
+}>;
+/** The result of an AI chat completion request. Returned by chat completion endpoints after the model finishes generating. */
+export interface AICompletionResult {
+    /** The reason the model stopped generating. Common values include `"stop"` (natural end), `"length"` (token limit reached), and `"tool_calls"` (the model invoked a tool). */
+    finish_reason: string;
+    /** The final assistant message produced by the completion. */
+    message: AIMessage;
+    /** The complete message history for the conversation, including all user, assistant, and tool messages in order. */
+    messages: AIMessage[];
+    /** Token consumption breakdown keyed by model ID. Each value is a map with `"input_tokens"` and `"output_tokens"` counts. `null` when usage data is unavailable. */
+    token_usage?: Record<string, unknown> | undefined;
+}
+/** Runtime validator for {@link AICompletionResult}. */
 export declare const aICompletionResultSchema: z.ZodObject<{
+    /** The reason the model stopped generating. Common values include `"stop"` (natural end), `"length"` (token limit reached), and `"tool_calls"` (the model invoked a tool). */
     finish_reason: z.ZodString;
+    /** The final assistant message produced by the completion. */
     message: z.ZodObject<{
+        /** Plain-text content of the message. Present for `system`, `user`, and `assistant` messages. `null` when the message body is expressed through `content_parts` or `tool_calls`. */
         content: z.ZodOptional<z.ZodString>;
+        /** Multimodal content parts for the message, used when the body includes images or mixed media. Each part is a map with a `type` key (`"text"`, `"image_url"`, or `"image_data"`). `null` when `content` is set. */
         content_parts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        /** Opaque token that can be passed on a subsequent request to resume this conversation from the current state. `null` when the provider does not support conversation resumption. */
         resume_token: z.ZodOptional<z.ZodString>;
+        /** The speaker role for this message. One of `"system"`, `"user"`, `"assistant"`, or `"tool"`. */
         role: z.ZodString;
+        /** Parsed structured data returned by the model when a JSON schema or structured-output mode was requested. Shape varies by the schema supplied at call time. `null` when structured output was not requested. */
         structured_output: z.ZodOptional<z.ZodUnknown>;
+        /** Tool calls requested by the model in an `assistant` message. Present only on assistant messages that invoke one or more tools. `null` on all other message roles. */
         tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Arguments the model wants to pass to the tool, as a key-value map. Deserialize and validate these against the tool's input schema before executing. */
             arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            /** Unique identifier for this tool call, assigned by the model. Use this value as `id` when submitting the corresponding tool result. */
             id: z.ZodString;
+            /** Name of the tool or function the model wants to invoke, e.g. `"web_search"` or `"run_code"`. */
             name: z.ZodString;
+            /** Opaque signature representing the model's internal reasoning that led to this tool call. `null` when the provider does not expose chain-of-thought data. */
             thought_signature: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             id: string;
@@ -137,10 +488,15 @@ export declare const aICompletionResultSchema: z.ZodObject<{
             arguments: Record<string, unknown>;
             thought_signature?: string | undefined;
         }>, "many">>;
+        /** Tool execution results provided in a `tool` message. Each entry corresponds to a prior tool call by its `id`. `null` on all other message roles. */
         tool_results: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Plain-text output produced by the tool execution. `null` when the result is expressed entirely through `resolution`. */
             content: z.ZodOptional<z.ZodString>;
+            /** ID of the tool call this result satisfies. Must match the `id` from the corresponding `AIToolCall`. */
             id: z.ZodString;
+            /** Name of the tool or function that was executed, e.g. `"web_search"`. Must match the `name` from the corresponding `AIToolCall`. */
             name: z.ZodString;
+            /** Structured result data from the tool execution. Shape varies by tool. `null` when the result is expressed as plain text in `content`. */
             resolution: z.ZodOptional<z.ZodUnknown>;
         }, "strip", z.ZodTypeAny, {
             id: string;
@@ -190,16 +546,27 @@ export declare const aICompletionResultSchema: z.ZodObject<{
             resolution?: unknown;
         }[] | undefined;
     }>;
+    /** The complete message history for the conversation, including all user, assistant, and tool messages in order. */
     messages: z.ZodArray<z.ZodObject<{
+        /** Plain-text content of the message. Present for `system`, `user`, and `assistant` messages. `null` when the message body is expressed through `content_parts` or `tool_calls`. */
         content: z.ZodOptional<z.ZodString>;
+        /** Multimodal content parts for the message, used when the body includes images or mixed media. Each part is a map with a `type` key (`"text"`, `"image_url"`, or `"image_data"`). `null` when `content` is set. */
         content_parts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        /** Opaque token that can be passed on a subsequent request to resume this conversation from the current state. `null` when the provider does not support conversation resumption. */
         resume_token: z.ZodOptional<z.ZodString>;
+        /** The speaker role for this message. One of `"system"`, `"user"`, `"assistant"`, or `"tool"`. */
         role: z.ZodString;
+        /** Parsed structured data returned by the model when a JSON schema or structured-output mode was requested. Shape varies by the schema supplied at call time. `null` when structured output was not requested. */
         structured_output: z.ZodOptional<z.ZodUnknown>;
+        /** Tool calls requested by the model in an `assistant` message. Present only on assistant messages that invoke one or more tools. `null` on all other message roles. */
         tool_calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Arguments the model wants to pass to the tool, as a key-value map. Deserialize and validate these against the tool's input schema before executing. */
             arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            /** Unique identifier for this tool call, assigned by the model. Use this value as `id` when submitting the corresponding tool result. */
             id: z.ZodString;
+            /** Name of the tool or function the model wants to invoke, e.g. `"web_search"` or `"run_code"`. */
             name: z.ZodString;
+            /** Opaque signature representing the model's internal reasoning that led to this tool call. `null` when the provider does not expose chain-of-thought data. */
             thought_signature: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             id: string;
@@ -212,10 +579,15 @@ export declare const aICompletionResultSchema: z.ZodObject<{
             arguments: Record<string, unknown>;
             thought_signature?: string | undefined;
         }>, "many">>;
+        /** Tool execution results provided in a `tool` message. Each entry corresponds to a prior tool call by its `id`. `null` on all other message roles. */
         tool_results: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Plain-text output produced by the tool execution. `null` when the result is expressed entirely through `resolution`. */
             content: z.ZodOptional<z.ZodString>;
+            /** ID of the tool call this result satisfies. Must match the `id` from the corresponding `AIToolCall`. */
             id: z.ZodString;
+            /** Name of the tool or function that was executed, e.g. `"web_search"`. Must match the `name` from the corresponding `AIToolCall`. */
             name: z.ZodString;
+            /** Structured result data from the tool execution. Shape varies by tool. `null` when the result is expressed as plain text in `content`. */
             resolution: z.ZodOptional<z.ZodUnknown>;
         }, "strip", z.ZodTypeAny, {
             id: string;
@@ -265,6 +637,7 @@ export declare const aICompletionResultSchema: z.ZodObject<{
             resolution?: unknown;
         }[] | undefined;
     }>, "many">;
+    /** Token consumption breakdown keyed by model ID. Each value is a map with `"input_tokens"` and `"output_tokens"` counts. `null` when usage data is unavailable. */
     token_usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     message: {
@@ -349,44 +722,78 @@ export declare const aICompletionResultSchema: z.ZodObject<{
     }[];
     token_usage?: Record<string, unknown> | undefined;
 }>;
-export type AICompletionResult = z.infer<typeof aICompletionResultSchema>;
-/** Schema for an AI image generation result. */
+/** The result returned by an AI image generation or editing operation. Contains the generated image (as inline data or a URL) along with dimension, size, and usage metadata. */
+export interface AIImageResult {
+    /** Aspect ratio of the generated image, e.g. `"16:9"` or `"1:1"`. `null` when not reported by the provider. */
+    aspect_ratio?: string | undefined;
+    /** Height of the generated image in pixels. `null` when the provider does not report dimensions. */
+    height?: number | undefined;
+    /** The generated image encoded as a base64 string. Present when the provider returns inline image data. `null` when `image_url` is set instead. */
+    image_data?: string | undefined;
+    /** Resolution tier label for the image, e.g. `"1K"` or `"2K"`. `null` when the provider does not include a tier label. */
+    image_size?: string | undefined;
+    /** MIME type of the generated image, e.g. `"image/png"` or `"image/jpeg"`. `null` when the provider does not report a content type. */
+    image_type?: string | undefined;
+    /** Temporary URL pointing to the generated image hosted by the provider. Present when the provider returns a URL rather than inline data. `null` when `image_data` is set instead. */
+    image_url?: string | undefined;
+    /** Identifier of the model that produced the image, e.g. `"dall-e-3"` or `"imagen-3"`. */
+    model: string;
+    /** The prompt as rewritten by the provider before generation. Some providers (e.g. DALL-E 3) automatically expand or safety-check the original prompt. `null` when the provider does not revise prompts. */
+    revised_prompt?: string | undefined;
+    /** Canonical size string as returned by the provider, e.g. `"1024x1024"`. `null` when not reported. */
+    size?: string | undefined;
+    /** Provider-reported token and compute usage for the request. Structure varies by provider. `null` when usage data is unavailable. */
+    usage?: Record<string, unknown> | undefined;
+    /** Width of the generated image in pixels. `null` when the provider does not report dimensions. */
+    width?: number | undefined;
+}
+/** Runtime validator for {@link AIImageResult}. */
 export declare const aIImageResultSchema: z.ZodObject<{
+    /** Aspect ratio of the generated image, e.g. `"16:9"` or `"1:1"`. `null` when not reported by the provider. */
     aspect_ratio: z.ZodOptional<z.ZodString>;
+    /** Height of the generated image in pixels. `null` when the provider does not report dimensions. */
     height: z.ZodOptional<z.ZodNumber>;
+    /** The generated image encoded as a base64 string. Present when the provider returns inline image data. `null` when `image_url` is set instead. */
     image_data: z.ZodOptional<z.ZodString>;
+    /** Resolution tier label for the image, e.g. `"1K"` or `"2K"`. `null` when the provider does not include a tier label. */
     image_size: z.ZodOptional<z.ZodString>;
+    /** MIME type of the generated image, e.g. `"image/png"` or `"image/jpeg"`. `null` when the provider does not report a content type. */
     image_type: z.ZodOptional<z.ZodString>;
+    /** Temporary URL pointing to the generated image hosted by the provider. Present when the provider returns a URL rather than inline data. `null` when `image_data` is set instead. */
     image_url: z.ZodOptional<z.ZodString>;
+    /** Identifier of the model that produced the image, e.g. `"dall-e-3"` or `"imagen-3"`. */
     model: z.ZodString;
+    /** The prompt as rewritten by the provider before generation. Some providers (e.g. DALL-E 3) automatically expand or safety-check the original prompt. `null` when the provider does not revise prompts. */
     revised_prompt: z.ZodOptional<z.ZodString>;
+    /** Canonical size string as returned by the provider, e.g. `"1024x1024"`. `null` when not reported. */
     size: z.ZodOptional<z.ZodString>;
+    /** Provider-reported token and compute usage for the request. Structure varies by provider. `null` when usage data is unavailable. */
     usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Width of the generated image in pixels. `null` when the provider does not report dimensions. */
     width: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     model: string;
     height?: number | undefined;
     width?: number | undefined;
     image_url?: string | undefined;
+    size?: string | undefined;
+    usage?: Record<string, unknown> | undefined;
     aspect_ratio?: string | undefined;
     image_data?: string | undefined;
     image_size?: string | undefined;
     image_type?: string | undefined;
     revised_prompt?: string | undefined;
-    size?: string | undefined;
-    usage?: Record<string, unknown> | undefined;
 }, {
     model: string;
     height?: number | undefined;
     width?: number | undefined;
     image_url?: string | undefined;
+    size?: string | undefined;
+    usage?: Record<string, unknown> | undefined;
     aspect_ratio?: string | undefined;
     image_data?: string | undefined;
     image_size?: string | undefined;
     image_type?: string | undefined;
     revised_prompt?: string | undefined;
-    size?: string | undefined;
-    usage?: Record<string, unknown> | undefined;
 }>;
-export type AIImageResult = z.infer<typeof aIImageResultSchema>;
 //# sourceMappingURL=ai.d.ts.map

package/dist/types/ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/types/ai.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wCAAwC;AACxC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,uCAAuC;AACvC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,kDAAkD;AAClD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,gDAAgD;AAChD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/types/ai.ts"],"names":[],"mappings":"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"}