@archastro/sdk 0.14.0 → 0.16.0

package/dist/types/ai.d.ts

@@ -17,19 +17,19 @@ export declare const aIChatStreamDoneSchema: z.ZodObject<{
     /** 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>>;
+    total_usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
     /** Token usage for the final run, keyed by model ID. */
-    usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
 }, "strip", z.ZodTypeAny, {
     run_count?: number | undefined;
     finish_reason?: string | undefined;
-    total_usage?: Record<string, unknown> | undefined;
-    usage?: Record<string, unknown> | undefined;
+    total_usage?: Record<string, {} | null> | undefined;
+    usage?: Record<string, {} | null> | undefined;
 }, {
     run_count?: number | undefined;
     finish_reason?: string | undefined;
-    total_usage?: Record<string, unknown> | undefined;
-    usage?: Record<string, unknown> | undefined;
+    total_usage?: Record<string, {} | null> | undefined;
+    usage?: Record<string, {} | null> | undefined;
 }>;
 /** Terminal error event for a streaming chat completion (SSE `error` event). */
 export interface AIChatStreamError {
@@ -59,7 +59,7 @@ export interface AIToolCall {
 /** 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>;
+    arguments: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
     /** 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"`. */
@@ -69,12 +69,12 @@ export declare const aIToolCallSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     id: string;
-    arguments: Record<string, unknown>;
+    arguments: Record<string, {} | null>;
     thought_signature?: string | undefined;
 }, {
     name: string;
     id: string;
-    arguments: Record<string, unknown>;
+    arguments: Record<string, {} | null>;
     thought_signature?: string | undefined;
 }>;
 /** The result of executing a tool call, submitted back to the model as a tool-role message. Mirrors the OpenAI tool-result object format. */
@@ -97,17 +97,17 @@ export declare const aIToolResultSchema: z.ZodObject<{
     /** 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>;
+    resolution: z.ZodOptional<z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     id: string;
     content?: string | undefined;
-    resolution?: unknown;
+    resolution?: {} | null | undefined;
 }, {
     name: string;
     id: string;
     content?: string | undefined;
-    resolution?: unknown;
+    resolution?: {} | null | undefined;
 }>;
 /** A single message in an AI conversation, following the OpenAI-compatible chat format. Used in both request inputs and completion responses. */
 export interface AIMessage {
@@ -131,17 +131,17 @@ 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">>;
+    content_parts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>, "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>;
+    structured_output: z.ZodOptional<z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
     /** 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>;
+        arguments: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
         /** 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"`. */
@@ -151,12 +151,12 @@ export declare const aIMessageSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         id: string;
-        arguments: Record<string, unknown>;
+        arguments: Record<string, {} | null>;
         thought_signature?: string | undefined;
     }, {
         name: string;
         id: string;
-        arguments: Record<string, unknown>;
+        arguments: Record<string, {} | null>;
         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. */
@@ -168,53 +168,53 @@ export declare const aIMessageSchema: z.ZodObject<{
         /** 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>;
+        resolution: z.ZodOptional<z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         id: string;
         content?: string | undefined;
-        resolution?: unknown;
+        resolution?: {} | null | undefined;
     }, {
         name: string;
         id: string;
         content?: string | undefined;
-        resolution?: unknown;
+        resolution?: {} | null | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     role: string;
     content?: string | undefined;
-    content_parts?: Record<string, unknown>[] | undefined;
+    content_parts?: Record<string, {} | null>[] | undefined;
     resume_token?: string | undefined;
-    structured_output?: unknown;
+    structured_output?: {} | null | undefined;
     tool_calls?: {
         name: string;
         id: string;
-        arguments: Record<string, unknown>;
+        arguments: Record<string, {} | null>;
         thought_signature?: string | undefined;
     }[] | undefined;
     tool_results?: {
         name: string;
         id: string;
         content?: string | undefined;
-        resolution?: unknown;
+        resolution?: {} | null | undefined;
     }[] | undefined;
 }, {
     role: string;
     content?: string | undefined;
-    content_parts?: Record<string, unknown>[] | undefined;
+    content_parts?: Record<string, {} | null>[] | undefined;
     resume_token?: string | undefined;
-    structured_output?: unknown;
+    structured_output?: {} | null | undefined;
     tool_calls?: {
         name: string;
         id: string;
-        arguments: Record<string, unknown>;
+        arguments: Record<string, {} | null>;
         thought_signature?: string | undefined;
     }[] | undefined;
     tool_results?: {
         name: string;
         id: string;
         content?: string | undefined;
-        resolution?: unknown;
+        resolution?: {} | null | undefined;
     }[] | undefined;
 }>;
 /** The fully assembled assistant message for one run of a streaming chat completion (SSE `message_complete` event). */
@@ -235,17 +235,17 @@ export declare const aIChatStreamMessageCompleteSchema: 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">>;
+        content_parts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>, "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>;
+        structured_output: z.ZodOptional<z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
         /** 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>;
+            arguments: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
             /** 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"`. */
@@ -255,12 +255,12 @@ export declare const aIChatStreamMessageCompleteSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }, {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             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. */
@@ -272,101 +272,101 @@ export declare const aIChatStreamMessageCompleteSchema: z.ZodObject<{
             /** 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>;
+            resolution: z.ZodOptional<z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }, {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | undefined;
     }, {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | 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>>;
+    usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
 }, "strip", z.ZodTypeAny, {
     message: {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | undefined;
     };
     finish_reason?: string | undefined;
-    usage?: Record<string, unknown> | undefined;
+    usage?: Record<string, {} | null> | undefined;
 }, {
     message: {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | undefined;
     };
     finish_reason?: string | undefined;
-    usage?: Record<string, unknown> | undefined;
+    usage?: Record<string, {} | null> | undefined;
 }>;
 /** Incremental assistant text emitted during a streaming chat completion (SSE `message_delta` event). */
 export interface AIChatStreamMessageDelta {
@@ -474,17 +474,17 @@ export declare const aICompletionResultSchema: 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">>;
+        content_parts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>, "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>;
+        structured_output: z.ZodOptional<z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
         /** 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>;
+            arguments: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
             /** 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"`. */
@@ -494,12 +494,12 @@ export declare const aICompletionResultSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }, {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             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. */
@@ -511,53 +511,53 @@ export declare const aICompletionResultSchema: z.ZodObject<{
             /** 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>;
+            resolution: z.ZodOptional<z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }, {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | undefined;
     }, {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | undefined;
     }>;
     /** The complete message history for the conversation, including all user, assistant, and tool messages in order. */
@@ -565,17 +565,17 @@ export declare const aICompletionResultSchema: 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">>;
+        content_parts: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>, "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>;
+        structured_output: z.ZodOptional<z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
         /** 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>;
+            arguments: z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
             /** 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"`. */
@@ -585,12 +585,12 @@ export declare const aICompletionResultSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }, {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             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. */
@@ -602,139 +602,139 @@ export declare const aICompletionResultSchema: z.ZodObject<{
             /** 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>;
+            resolution: z.ZodOptional<z.ZodType<{} | null, z.ZodTypeDef, {} | null>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }, {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | undefined;
     }, {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | 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>>;
+    token_usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
 }, "strip", z.ZodTypeAny, {
     message: {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | undefined;
     };
     messages: {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | undefined;
     }[];
     finish_reason: string;
-    token_usage?: Record<string, unknown> | undefined;
+    token_usage?: Record<string, {} | null> | undefined;
 }, {
     message: {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | undefined;
     };
     messages: {
         role: string;
         content?: string | undefined;
-        content_parts?: Record<string, unknown>[] | undefined;
+        content_parts?: Record<string, {} | null>[] | undefined;
         resume_token?: string | undefined;
-        structured_output?: unknown;
+        structured_output?: {} | null | undefined;
         tool_calls?: {
             name: string;
             id: string;
-            arguments: Record<string, unknown>;
+            arguments: Record<string, {} | null>;
             thought_signature?: string | undefined;
         }[] | undefined;
         tool_results?: {
             name: string;
             id: string;
             content?: string | undefined;
-            resolution?: unknown;
+            resolution?: {} | null | undefined;
         }[] | undefined;
     }[];
     finish_reason: string;
-    token_usage?: Record<string, unknown> | undefined;
+    token_usage?: Record<string, {} | null> | undefined;
 }>;
 /** 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 {
@@ -782,7 +782,7 @@ export declare const aIImageResultSchema: z.ZodObject<{
     /** 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>>;
+    usage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<{} | null, z.ZodTypeDef, {} | null>>>;
     /** Width of the generated image in pixels. `null` when the provider does not report dimensions. */
     width: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
@@ -791,7 +791,7 @@ export declare const aIImageResultSchema: z.ZodObject<{
     width?: number | undefined;
     image_url?: string | undefined;
     size?: string | undefined;
-    usage?: Record<string, unknown> | undefined;
+    usage?: Record<string, {} | null> | undefined;
     aspect_ratio?: string | undefined;
     image_data?: string | undefined;
     image_size?: string | undefined;
@@ -803,7 +803,7 @@ export declare const aIImageResultSchema: z.ZodObject<{
     width?: number | undefined;
     image_url?: string | undefined;
     size?: string | undefined;
-    usage?: Record<string, unknown> | undefined;
+    usage?: Record<string, {} | null> | undefined;
     aspect_ratio?: string | undefined;
     image_data?: string | undefined;
     image_size?: string | undefined;