From b45fd52de5835693ba63668dc28eced80af5ad9e Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Fri, 16 Jan 2026 22:25:57 -0500
Subject: [PATCH 01/26] Enhance createTool function to match AI SDK v6
 additional properties and context handling

- Introduced new types for tool execution and approval functions.
- Added support for input examples, strict mode, and tool approval logic.
- Updated the function signature to accommodate new properties and ensure compatibility with existing functionality.
---
 src/client/createTool.ts | 310 +++++++++++++++++++++++++++++++--------
 1 file changed, 250 insertions(+), 60 deletions(-)

diff --git a/src/client/createTool.ts b/src/client/createTool.ts
index 83ca5288..a51616b9 100644
--- a/src/client/createTool.ts
+++ b/src/client/createTool.ts
@@ -1,9 +1,15 @@
-import type { FlexibleSchema } from "@ai-sdk/provider-utils";
-import type { Tool, ToolExecutionOptions, ToolSet } from "ai";
+import type { ToolResultOutput } from "@ai-sdk/provider-utils";
+import type {
+  FlexibleSchema,
+  ModelMessage,
+  Tool,
+  ToolExecutionOptions,
+  ToolSet,
+} from "ai";
 import { tool } from "ai";
-import type { Agent } from "./index.js";
 import type { GenericActionCtx, GenericDataModel } from "convex/server";
 import type { ProviderOptions } from "../validators.js";
+import type { Agent } from "./index.js";
 
 export type ToolCtx<DataModel extends GenericDataModel = GenericDataModel> =
   GenericActionCtx<DataModel> & {
@@ -13,6 +19,107 @@ export type ToolCtx<DataModel extends GenericDataModel = GenericDataModel> =
     messageId?: string;
   };
 
+/**
+ * Function that is called to determine if the tool needs approval before it can be executed.
+ */
+export type ToolNeedsApprovalFunctionCtx<
+  INPUT,
+  Ctx extends ToolCtx = ToolCtx,
+> = (
+  ctx: Ctx,
+  input: INPUT,
+  options: {
+    /**
+     * The ID of the tool call. You can use it e.g. when sending tool-call related information with stream data.
+     */
+    toolCallId: string;
+    /**
+     * Messages that were sent to the language model to initiate the response that contained the tool call.
+     * The messages **do not** include the system prompt nor the assistant response that contained the tool call.
+     */
+    messages: ModelMessage[];
+    /**
+     * Additional context.
+     *
+     * Experimental (can break in patch releases).
+     */
+    experimental_context?: unknown;
+  },
+) => boolean | PromiseLike<boolean>;
+
+export type ToolExecuteFunctionCtx<
+  INPUT,
+  OUTPUT,
+  Ctx extends ToolCtx = ToolCtx,
+> = (
+  ctx: Ctx,
+  input: INPUT,
+  options: ToolExecutionOptions,
+) => AsyncIterable<OUTPUT> | PromiseLike<OUTPUT>;
+
+type NeverOptional<N, T> = 0 extends 1 & N
+  ? Partial<T>
+  : [N] extends [never]
+    ? Partial<Record<keyof T, undefined>>
+    : T;
+
+export type ToolOutputPropertiesCtx<
+  INPUT,
+  OUTPUT,
+  Ctx extends ToolCtx = ToolCtx,
+> = NeverOptional<
+  OUTPUT,
+  | {
+      /**
+       * An async function that is called with the arguments from the tool call and produces a result.
+       * If not provided, the tool will not be executed automatically.
+       *
+       * @args is the input of the tool call.
+       * @options.abortSignal is a signal that can be used to abort the tool call.
+       */
+      execute: ToolExecuteFunctionCtx<INPUT, OUTPUT, Ctx>;
+      outputSchema?: FlexibleSchema<OUTPUT>;
+      handler?: never;
+    }
+  | {
+      /** @deprecated Use execute instead. */
+      handler: ToolExecuteFunctionCtx<INPUT, OUTPUT, Ctx>;
+      outputSchema?: FlexibleSchema<OUTPUT>;
+      execute?: never;
+    }
+  | {
+      outputSchema: FlexibleSchema<OUTPUT>;
+      execute?: never;
+      handler?: never;
+    }
+>;
+
+export type ToolInputProperties<INPUT> = NeverOptional<
+  INPUT,
+  | {
+      /**
+       * The schema of the input that the tool expects.
+       * The language model will use this to generate the input.
+       * It is also used to validate the output of the language model.
+       *
+       * You can use descriptions on the schema properties to make the input understandable for the language model.
+       */
+      inputSchema: FlexibleSchema<INPUT>;
+      args?: never;
+    }
+  | {
+      /**
+       * The schema of the input that the tool expects. The language model will use this to generate the input.
+       * It is also used to validate the output of the language model.
+       * Use descriptions to make the input understandable for the language model.
+       *
+       * @deprecated Use inputSchema instead.
+       */
+      args: FlexibleSchema<INPUT>;
+      inputSchema?: never;
+    }
+>;
+
 /**
  * This is a wrapper around the ai.tool function that adds extra context to the
  * tool call, including the action context, userId, threadId, and messageId.
@@ -20,72 +127,133 @@ export type ToolCtx<DataModel extends GenericDataModel = GenericDataModel> =
  * but swap parameters for args and handler for execute.
  * @returns A tool to be used with the AI SDK.
  */
-export function createTool<INPUT, OUTPUT, Ctx extends ToolCtx = ToolCtx>(def: {
-  /**
+export function createTool<INPUT, OUTPUT, Ctx extends ToolCtx = ToolCtx>(
+  def: {
+    /**
   An optional description of what the tool does.
   Will be used by the language model to decide whether to use the tool.
   Not used for provider-defined tools.
      */
-  description?: string;
-  /**
-  The schema of the input that the tool expects. The language model will use this to generate the input.
-  It is also used to validate the output of the language model.
-  Use descriptions to make the input understandable for the language model.
+    description?: string;
+    /**
+     * An optional title of the tool.
      */
-  args: FlexibleSchema<INPUT>;
-  /**
-  An async function that is called with the arguments from the tool call and produces a result.
-  If not provided, the tool will not be executed automatically.
-
-  @args is the input of the tool call.
-  @options.abortSignal is a signal that can be used to abort the tool call.
+    title?: string;
+    /**
+     * Additional provider-specific metadata. They are passed through
+     * to the provider from the AI SDK and enable provider-specific
+     * functionality that can be fully encapsulated in the provider.
      */
-  handler: (
-    ctx: Ctx,
-    args: INPUT,
-    options: ToolExecutionOptions,
-  ) => PromiseLike<OUTPUT> | AsyncIterable<OUTPUT>;
-  /**
-   * Provide the context to use, e.g. when defining the tool at runtime.
-   */
-  ctx?: Ctx;
-  /**
-   * Optional function that is called when the argument streaming starts.
-   * Only called when the tool is used in a streaming context.
-   */
-  onInputStart?: (
-    ctx: Ctx,
-    options: ToolExecutionOptions,
-  ) => void | PromiseLike<void>;
-  /**
-   * Optional function that is called when an argument streaming delta is available.
-   * Only called when the tool is used in a streaming context.
-   */
-  onInputDelta?: (
-    ctx: Ctx,
-    options: { inputTextDelta: string } & ToolExecutionOptions,
-  ) => void | PromiseLike<void>;
-  /**
-   * Optional function that is called when a tool call can be started,
-   * even if the execute function is not provided.
-   */
-  onInputAvailable?: (
-    ctx: Ctx,
-    options: {
-      input: [INPUT] extends [never] ? unknown : INPUT;
-    } & ToolExecutionOptions,
-  ) => void | PromiseLike<void>;
+    providerOptions?: ProviderOptions;
+  } & ToolInputProperties<INPUT> & {
+      /**
+       * An optional list of input examples that show the language
+       * model what the input should look like.
+       */
+      inputExamples?: Array<{
+        input: NoInfer<INPUT>;
+      }>;
+      /**
+       * Whether the tool needs approval before it can be executed.
+       */
+      needsApproval?:
+        | boolean
+        | ToolNeedsApprovalFunctionCtx<
+            [INPUT] extends [never] ? unknown : INPUT,
+            Ctx
+          >;
+      /**
+       * Strict mode setting for the tool.
+       *
+       * Providers that support strict mode will use this setting to determine
+       * how the input should be generated. Strict mode will always produce
+       * valid inputs, but it might limit what input schemas are supported.
+       */
+      strict?: boolean;
+      /**
+       * Provide the context to use, e.g. when defining the tool at runtime.
+       */
+      ctx?: Ctx;
+      /**
+       * Optional function that is called when the argument streaming starts.
+       * Only called when the tool is used in a streaming context.
+       */
+      onInputStart?: (
+        ctx: Ctx,
+        options: ToolExecutionOptions,
+      ) => void | PromiseLike<void>;
+      /**
+       * Optional function that is called when an argument streaming delta is available.
+       * Only called when the tool is used in a streaming context.
+       */
+      onInputDelta?: (
+        ctx: Ctx,
+        options: { inputTextDelta: string } & ToolExecutionOptions,
+      ) => void | PromiseLike<void>;
+      /**
+       * Optional function that is called when a tool call can be started,
+       * even if the execute function is not provided.
+       */
+      onInputAvailable?: (
+        ctx: Ctx,
+        options: {
+          input: [INPUT] extends [never] ? unknown : INPUT;
+        } & ToolExecutionOptions,
+      ) => void | PromiseLike<void>;
+    } & ToolOutputPropertiesCtx<INPUT, OUTPUT, Ctx> & {
+      /**
+       * Optional conversion function that maps the tool result to an output that can be used by the language model.
+       *
+       * If not provided, the tool result will be sent as a JSON object.
+       */
+      toModelOutput?: (
+        ctx: Ctx,
+        options: {
+          /**
+           * The ID of the tool call. You can use it e.g. when sending tool-call related information with stream data.
+           */
+          toolCallId: string;
+          /**
+           * The input of the tool call.
+           */
+          input: [INPUT] extends [never] ? unknown : INPUT;
+          /**
+           * The output of the tool call.
+           */
+          output: 0 extends 1 & OUTPUT
+            ? any
+            : [OUTPUT] extends [never]
+              ? any
+              : NoInfer<OUTPUT>;
+        },
+      ) => ToolResultOutput | PromiseLike<ToolResultOutput>;
+    },
+): Tool<INPUT, OUTPUT> {
+  const inputSchema = def.inputSchema ?? def.args;
+  if (!inputSchema)
+    throw new Error("To use a Convex tool, you must provide an `inputSchema`");
+
+  const executeHandler = def.execute ?? def.handler;
+  if (!executeHandler && !def.outputSchema)
+    throw new Error(
+      "To use a Convex tool, you must either provide an execute" +
+        " handler function, define an outputSchema, or both",
+    );
 
-  // Extra AI SDK pass-through options.
-  providerOptions?: ProviderOptions;
-}): Tool<INPUT, OUTPUT> {
-  const t = tool({
+  const t = tool<INPUT, OUTPUT>({
     type: "function",
     __acceptsCtx: true,
     ctx: def.ctx,
     description: def.description,
-    inputSchema: def.args,
-    execute(args: INPUT, options: ToolExecutionOptions) {
+    title: def.title,
+    providerOptions: def.providerOptions,
+    inputSchema,
+    inputExamples: def.inputExamples,
+    needsApproval(input, options) {
+      const needsApproval = def.needsApproval;
+      if (!needsApproval || typeof needsApproval === "boolean")
+        return Boolean(needsApproval);
+
       if (!getCtx(this)) {
         throw new Error(
           "To use a Convex tool, you must either provide the ctx" +
@@ -93,9 +261,28 @@ export function createTool<INPUT, OUTPUT, Ctx extends ToolCtx = ToolCtx>(def: {
             " call it (which injects the ctx, userId and threadId)",
         );
       }
-      return def.handler(getCtx(this), args, options);
+      return needsApproval(getCtx(this), input, options);
     },
-    providerOptions: def.providerOptions,
+    strict: def.strict,
+    ...(executeHandler
+      ? {
+          execute(
+            this: Tool<INPUT, OUTPUT>,
+            input: INPUT,
+            options: ToolExecutionOptions,
+          ) {
+            if (!getCtx(this)) {
+              throw new Error(
+                "To use a Convex tool, you must either provide the ctx" +
+                  " at definition time (dynamically in an action), or use the Agent to" +
+                  " call it (which injects the ctx, userId and threadId)",
+              );
+            }
+            return executeHandler(getCtx(this), input, options);
+          },
+        }
+      : {}),
+    outputSchema: def.outputSchema,
   });
   if (def.onInputStart) {
     t.onInputStart = def.onInputStart.bind(t, getCtx(t));
@@ -106,6 +293,9 @@ export function createTool<INPUT, OUTPUT, Ctx extends ToolCtx = ToolCtx>(def: {
   if (def.onInputAvailable) {
     t.onInputAvailable = def.onInputAvailable.bind(t, getCtx(t));
   }
+  if (def.toModelOutput) {
+    t.toModelOutput = def.toModelOutput.bind(t, getCtx(t));
+  }
   return t;
 }
 

From 676d067a7a380017a94571a46b3880df6f76763f Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Fri, 16 Jan 2026 23:17:43 -0500
Subject: [PATCH 02/26] Relaxed ToolInputProperties type definition

---
 src/client/createTool.ts | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/client/createTool.ts b/src/client/createTool.ts
index a51616b9..b6266da5 100644
--- a/src/client/createTool.ts
+++ b/src/client/createTool.ts
@@ -94,8 +94,7 @@ export type ToolOutputPropertiesCtx<
     }
 >;
 
-export type ToolInputProperties<INPUT> = NeverOptional<
-  INPUT,
+export type ToolInputProperties<INPUT> =
   | {
       /**
        * The schema of the input that the tool expects.
@@ -117,8 +116,7 @@ export type ToolInputProperties<INPUT> = NeverOptional<
        */
       args: FlexibleSchema<INPUT>;
       inputSchema?: never;
-    }
->;
+    };
 
 /**
  * This is a wrapper around the ai.tool function that adds extra context to the

From b6acbf3c84cb89ecc14ce85b3a84142ea442a530 Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Fri, 16 Jan 2026 23:33:40 -0500
Subject: [PATCH 03/26] Refine createTool function documentation and type
 definitions

---
 src/client/createTool.ts | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/src/client/createTool.ts b/src/client/createTool.ts
index b6266da5..05767e83 100644
--- a/src/client/createTool.ts
+++ b/src/client/createTool.ts
@@ -72,10 +72,10 @@ export type ToolOutputPropertiesCtx<
   | {
       /**
        * An async function that is called with the arguments from the tool call and produces a result.
-       * If not provided, the tool will not be executed automatically.
+       * If `execute` (or `handler`) is not provided, the tool will not be executed automatically.
        *
-       * @args is the input of the tool call.
-       * @options.abortSignal is a signal that can be used to abort the tool call.
+       * @param input - The input of the tool call.
+       * @param options.abortSignal - A signal that can be used to abort the tool call.
        */
       execute: ToolExecuteFunctionCtx<INPUT, OUTPUT, Ctx>;
       outputSchema?: FlexibleSchema<OUTPUT>;
@@ -122,15 +122,17 @@ export type ToolInputProperties<INPUT> =
  * This is a wrapper around the ai.tool function that adds extra context to the
  * tool call, including the action context, userId, threadId, and messageId.
  * @param tool The tool. See https://sdk.vercel.ai/docs/ai-sdk-core/tools-and-tool-calling
- * but swap parameters for args and handler for execute.
+ * Currently contains deprecated parameters `args` and `handler` to maintain backwards compatibility
+ * but these will be removed in the future. Use `inputSchema` and `execute` instead, respectively.
+ * 
  * @returns A tool to be used with the AI SDK.
  */
 export function createTool<INPUT, OUTPUT, Ctx extends ToolCtx = ToolCtx>(
   def: {
     /**
-  An optional description of what the tool does.
-  Will be used by the language model to decide whether to use the tool.
-  Not used for provider-defined tools.
+     * An optional description of what the tool does.
+     * Will be used by the language model to decide whether to use the tool.
+     * Not used for provider-defined tools.
      */
     description?: string;
     /**
@@ -229,7 +231,7 @@ export function createTool<INPUT, OUTPUT, Ctx extends ToolCtx = ToolCtx>(
 ): Tool<INPUT, OUTPUT> {
   const inputSchema = def.inputSchema ?? def.args;
   if (!inputSchema)
-    throw new Error("To use a Convex tool, you must provide an `inputSchema`");
+    throw new Error("To use a Convex tool, you must provide an `inputSchema` (or `args`)");
 
   const executeHandler = def.execute ?? def.handler;
   if (!executeHandler && !def.outputSchema)
@@ -247,7 +249,7 @@ export function createTool<INPUT, OUTPUT, Ctx extends ToolCtx = ToolCtx>(
     providerOptions: def.providerOptions,
     inputSchema,
     inputExamples: def.inputExamples,
-    needsApproval(input, options) {
+    needsApproval(this: Tool<INPUT, OUTPUT>, input, options) {
       const needsApproval = def.needsApproval;
       if (!needsApproval || typeof needsApproval === "boolean")
         return Boolean(needsApproval);

From b1624a99459bcb888093f9cae82a32fdb8b6723e Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sat, 17 Jan 2026 00:16:01 -0500
Subject: [PATCH 04/26] Refactor validators to introduce new tool approval
 request and response types, update existing type definitions, and deprecate
 certain fields in favor of new alternatives.

---
 src/validators.ts | 149 ++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 138 insertions(+), 11 deletions(-)

diff --git a/src/validators.ts b/src/validators.ts
index 8d664ea4..78fda983 100644
--- a/src/validators.ts
+++ b/src/validators.ts
@@ -1,4 +1,5 @@
-import { v, type Infer, type Validator, type Value } from "convex/values";
+import type { Infer, Validator, Value } from "convex/values";
+import { v } from "convex/values";
 import { vVectorDimension } from "./component/vector/tables.js";
 
 // const deprecated = v.optional(v.any()) as unknown as VNull<unknown, "optional">;
@@ -42,6 +43,8 @@ export const vTextPart = v.object({
 export const vImagePart = v.object({
   type: v.literal("image"),
   image: v.union(v.string(), v.bytes()),
+  mediaType: v.optional(v.string()),
+  /** @deprecated Use `mediaType` instead. */
   mimeType: v.optional(v.string()),
   providerOptions,
 });
@@ -50,7 +53,9 @@ export const vFilePart = v.object({
   type: v.literal("file"),
   data: v.union(v.string(), v.bytes()),
   filename: v.optional(v.string()),
-  mimeType: v.string(),
+  mediaType: v.optional(v.string()),
+  /** @deprecated Use `mediaType` instead. */
+  mimeType: v.optional(v.string()),
   providerOptions,
   providerMetadata,
 });
@@ -114,7 +119,9 @@ export const vToolCallPart = v.object({
   type: v.literal("tool-call"),
   toolCallId: v.string(),
   toolName: v.string(),
-  args: v.any(),
+  input: v.any(),
+  /** @deprecated Use `input` instead. */
+  args: v.optional(v.any()),
   providerExecuted: v.optional(v.boolean()),
   providerOptions,
   providerMetadata,
@@ -132,25 +139,142 @@ const vToolResultContent = v.array(
 );
 
 export const vToolResultOutput = v.union(
-  v.object({ type: v.literal("text"), value: v.string() }),
-  v.object({ type: v.literal("json"), value: v.any() }),
-  v.object({ type: v.literal("error-text"), value: v.string() }),
-  v.object({ type: v.literal("error-json"), value: v.any() }),
+  v.object({ type: v.literal("text"), value: v.string(), providerOptions }),
+  v.object({ type: v.literal("json"), value: v.any(), providerOptions }),
+  v.object({
+    type: v.literal("error-text"),
+    value: v.string(),
+    providerOptions,
+  }),
+  v.object({ type: v.literal("error-json"), value: v.any(), providerOptions }),
+  v.object({
+    type: v.literal("execution-denied"),
+    reason: v.optional(v.string()),
+    providerOptions,
+  }),
   v.object({
     type: v.literal("content"),
     value: v.array(
       v.union(
-        v.object({ type: v.literal("text"), text: v.string() }),
+        v.object({
+          type: v.literal("text"),
+          text: v.string(),
+          providerOptions,
+        }),
+        /** @deprecated Use `image-data` or `file-data` instead. */
         v.object({
           type: v.literal("media"),
           data: v.string(),
           mediaType: v.string(),
         }),
+        v.object({
+          type: v.literal("file-data"),
+          /** Base-64 encoded */
+          data: v.string(),
+          /**
+           * IANA media type.
+           * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+           */
+          mediaType: v.string(),
+          filename: v.optional(v.string()),
+          providerOptions,
+        }),
+        v.object({
+          type: v.literal("file-url"),
+          url: v.string(),
+          providerOptions,
+        }),
+        v.object({
+          type: v.literal("file-id"),
+          /**
+           * ID of the file.
+           *
+           * If you use multiple providers, you need to
+           * specify the provider specific ids using
+           * the Record option. The key is the provider
+           * name, e.g. 'openai' or 'anthropic'.
+           */
+          fileId: v.union(v.string(), v.record(v.string(), v.string())),
+          providerOptions,
+        }),
+        v.object({
+          type: v.literal("image-data"),
+          data: v.string(),
+          /**
+           * IANA media type.
+           * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+           */
+          mediaType: v.string(),
+          providerOptions,
+        }),
+        v.object({
+          type: v.literal("image-url"),
+          url: v.string(),
+          providerOptions,
+        }),
+        v.object({
+          /**
+           * Images that are referenced using a provider file id.
+           */
+          type: v.literal("image-file-id"),
+          /**
+           * Image that is referenced using a provider file id.
+           *
+           * If you use multiple providers, you need to
+           * specify the provider specific ids using
+           * the Record option. The key is the provider
+           * name, e.g. 'openai' or 'anthropic'.
+           */
+          fileId: v.union(v.string(), v.record(v.string(), v.string())),
+          providerOptions,
+        }),
+        v.object({
+          /**
+           * Custom content part. This can be used to implement
+           * provider-specific content parts.
+           */
+          type: v.literal("custom"),
+          providerOptions,
+        }),
       ),
     ),
   }),
 );
 
+/**
+ * Tool approval request prompt part.
+ */
+export const vToolApprovalRequest = v.object({
+  type: v.literal("tool-approval-request"),
+  /**
+   * ID of the tool approval.
+   */
+  approvalId: v.string(),
+  /**
+   * ID of the tool call that the approval request is for.
+   */
+  toolCallId: v.string(),
+});
+
+/**
+ * Tool approval response prompt part.
+ */
+export const vToolApprovalResponse = v.object({
+  type: v.literal("tool-approval-response"),
+  /**
+   * ID of the tool approval.
+   */
+  approvalId: v.string(),
+  /**
+   * Flag indicating whether the approval was granted or denied.
+   */
+  approved: v.boolean(),
+  /**
+   * Optional reason for the approval or denial.
+   */
+  reason: v.optional(v.string()),
+});
+
 export const vToolResultPart = v.object({
   type: v.literal("tool-result"),
   toolCallId: v.string(),
@@ -169,7 +293,9 @@ export const vToolResultPart = v.object({
   args: v.optional(v.any()),
   experimental_content: v.optional(vToolResultContent),
 });
-export const vToolContent = v.array(vToolResultPart);
+export const vToolContent = v.array(
+  v.union(vToolResultPart, vToolApprovalResponse),
+);
 
 export const vAssistantContent = v.union(
   v.string(),
@@ -182,6 +308,7 @@ export const vAssistantContent = v.union(
       vToolCallPart,
       vToolResultPart,
       vSourcePart,
+      vToolApprovalRequest,
     ),
   ),
 );
@@ -462,7 +589,7 @@ export const vStreamMessage = v.object({
   agentName: v.optional(v.string()),
   model: v.optional(v.string()),
   provider: v.optional(v.string()),
-  providerOptions: v.optional(vProviderOptions), // Sent to model
+  providerOptions, // Sent to model
 });
 export type StreamMessage = Infer<typeof vStreamMessage>;
 
@@ -490,7 +617,7 @@ export const vMessageDoc = v.object({
   agentName: v.optional(v.string()),
   model: v.optional(v.string()),
   provider: v.optional(v.string()),
-  providerOptions: v.optional(vProviderOptions), // Sent to model
+  providerOptions, // Sent to model
 
   // The result
   message: v.optional(vMessage),

From b1e0df91cf85bd1970e068cb22338ca15d5965ed Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sat, 17 Jan 2026 00:37:40 -0500
Subject: [PATCH 05/26] Implement tool approval request and response handling
 in mapping and validators, updating serialization logic and deprecating the
 'args' field in favor of 'input'.

---
 src/mapping.ts    | 44 +++++++++++++++++++++++++++++++++++++++++---
 src/validators.ts |  8 ++++++++
 2 files changed, 49 insertions(+), 3 deletions(-)

diff --git a/src/mapping.ts b/src/mapping.ts
index 2d69c0ac..6c9a49dd 100644
--- a/src/mapping.ts
+++ b/src/mapping.ts
@@ -36,6 +36,8 @@ import {
   type SourcePart,
   vToolResultOutput,
   type MessageDoc,
+  vToolApprovalRequest,
+  vToolApprovalResponse,
 } from "./validators.js";
 import type { ActionCtx, AgentComponent } from "./client/types.js";
 import type { MutationCtx } from "./client/types.js";
@@ -45,6 +47,8 @@ import {
   convertUint8ArrayToBase64,
   type ProviderOptions,
   type ReasoningPart,
+  type ToolApprovalRequest,
+  type ToolApprovalResponse,
 } from "@ai-sdk/provider-utils";
 import { parse, validate } from "convex-helpers/validators";
 import {
@@ -349,10 +353,12 @@ export async function serializeContent(
           } satisfies Infer<typeof vFilePart>;
         }
         case "tool-call": {
-          const args = "input" in part ? part.input : part.args;
+          const input = part.input ?? (part as any)?.args;
           return {
             type: part.type,
-            args: args ?? null,
+            input: input ?? null,
+            /** @deprecated Use `input` instead. */
+            args: input ?? null,
             toolCallId: part.toolCallId,
             toolName: part.toolName,
             providerExecuted: part.providerExecuted,
@@ -428,6 +434,8 @@ export function fromModelMessageContent(content: Content): Message["content"] {
         case "tool-call":
           return {
             type: part.type,
+            input: part.input ?? null,
+            /** @deprecated Use `input` instead. */
             args: part.input ?? null,
             toolCallId: part.toolCallId,
             toolName: part.toolName,
@@ -442,6 +450,21 @@ export function fromModelMessageContent(content: Content): Message["content"] {
             text: part.text,
             ...metadata,
           } satisfies Infer<typeof vReasoningPart>;
+        case "tool-approval-request":
+          return {
+            type: part.type,
+            approvalId: part.approvalId,
+            toolCallId: part.toolCallId,
+            ...metadata,
+          } satisfies Infer<typeof vToolApprovalRequest>;
+        case "tool-approval-response":
+          return {
+            type: part.type,
+            approvalId: part.approvalId,
+            approved: part.approved,
+            reason: part.reason,
+            ...metadata,
+          } satisfies Infer<typeof vToolApprovalResponse>;
         // Not in current generation output, but could be in historical messages
         default:
           return null;
@@ -491,7 +514,7 @@ export function toModelMessageContent(
             ...metadata,
           } satisfies FilePart;
         case "tool-call": {
-          const input = "input" in part ? part.input : part.args;
+          const input = part.input ?? (part as any)?.args;
           return {
             type: part.type,
             input: input ?? null,
@@ -531,6 +554,21 @@ export function toModelMessageContent(
           } satisfies ReasoningPart;
         case "source":
           return part satisfies SourcePart;
+        case "tool-approval-request":
+          return {
+            type: part.type,
+            approvalId: part.approvalId,
+            toolCallId: part.toolCallId,
+            ...metadata,
+          } satisfies ToolApprovalRequest;
+        case "tool-approval-response":
+          return {
+            type: part.type,
+            approvalId: part.approvalId,
+            approved: part.approved,
+            reason: part.reason,
+            ...metadata,
+          } satisfies ToolApprovalResponse;
         default:
           return null;
       }
diff --git a/src/validators.ts b/src/validators.ts
index 78fda983..bb8af563 100644
--- a/src/validators.ts
+++ b/src/validators.ts
@@ -254,6 +254,10 @@ export const vToolApprovalRequest = v.object({
    * ID of the tool call that the approval request is for.
    */
   toolCallId: v.string(),
+  /** @todo Should we continue to include? */
+  providerMetadata,
+  /** @todo Should we continue to include? */
+  providerOptions,
 });
 
 /**
@@ -273,6 +277,10 @@ export const vToolApprovalResponse = v.object({
    * Optional reason for the approval or denial.
    */
   reason: v.optional(v.string()),
+  /** @todo Should we continue to include? */
+  providerMetadata,
+  /** @todo Should we continue to include? */
+  providerOptions,
 });
 
 export const vToolResultPart = v.object({

From a9c4598f6baa1ec30531d7231016098930e899c7 Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sat, 17 Jan 2026 00:52:38 -0500
Subject: [PATCH 06/26] Add providerExecuted flag to tool approval response
 validator and mapping

---
 src/mapping.ts    | 2 ++
 src/validators.ts | 5 +++++
 2 files changed, 7 insertions(+)

diff --git a/src/mapping.ts b/src/mapping.ts
index 6c9a49dd..71c95ac0 100644
--- a/src/mapping.ts
+++ b/src/mapping.ts
@@ -463,6 +463,7 @@ export function fromModelMessageContent(content: Content): Message["content"] {
             approvalId: part.approvalId,
             approved: part.approved,
             reason: part.reason,
+            providerExecuted: part.providerExecuted,
             ...metadata,
           } satisfies Infer<typeof vToolApprovalResponse>;
         // Not in current generation output, but could be in historical messages
@@ -567,6 +568,7 @@ export function toModelMessageContent(
             approvalId: part.approvalId,
             approved: part.approved,
             reason: part.reason,
+            providerExecuted: part.providerExecuted,
             ...metadata,
           } satisfies ToolApprovalResponse;
         default:
diff --git a/src/validators.ts b/src/validators.ts
index bb8af563..f7ecea38 100644
--- a/src/validators.ts
+++ b/src/validators.ts
@@ -277,6 +277,11 @@ export const vToolApprovalResponse = v.object({
    * Optional reason for the approval or denial.
    */
   reason: v.optional(v.string()),
+  /**
+   * Flag indicating whether the tool call is provider-executed.
+   * Only provider-executed tool approval responses should be sent to the model.
+   */
+  providerExecuted: v.optional(v.boolean()),
   /** @todo Should we continue to include? */
   providerMetadata,
   /** @todo Should we continue to include? */

From 9376e9b1ee55aecc162b1b1d65cf11463a4c59e6 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 06:04:49 +0000
Subject: [PATCH 07/26] Initial plan


From 19692bfc0516ba53e7b1df6b84e6162dc845f717 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 06:09:10 +0000
Subject: [PATCH 08/26] Update mimeType to mediaType with backwards
 compatibility

- Updated component schema to use optional mediaType and mimeType
- Updated files.ts addFile mutation to accept both mediaType and mimeType
- Updated client files.ts to use mediaType when calling component
- Updated getFile to support both mediaType and mimeType from database
- Updated mapping.ts to return mediaType instead of mimeType
- Maintained backwards compatibility throughout

Co-authored-by: zboyles <2215540+zboyles@users.noreply.github.com>
---
 src/client/files.ts     |  6 ++++--
 src/component/files.ts  | 13 +++++++++++--
 src/component/schema.ts |  4 +++-
 src/mapping.ts          |  8 ++++----
 4 files changed, 22 insertions(+), 9 deletions(-)

diff --git a/src/client/files.ts b/src/client/files.ts
index 6ee78506..ae56581e 100644
--- a/src/client/files.ts
+++ b/src/client/files.ts
@@ -92,7 +92,7 @@ export async function storeFile(
     storageId: newStorageId,
     hash,
     filename,
-    mimeType: blob.type,
+    mediaType: blob.type,
   });
   const url = (await ctx.storage.getUrl(storageId as Id<"_storage">))!;
   if (storageId !== newStorageId) {
@@ -142,8 +142,10 @@ export async function getFile(
   if (!url) {
     throw new Error(`File not found in storage: ${file.storageId}`);
   }
+  // Support both mediaType (preferred) and mimeType (deprecated)
+  const mediaType = file.mediaType ?? file.mimeType ?? "";
   return {
-    ...getParts(url, file.mimeType, file.filename),
+    ...getParts(url, mediaType, file.filename),
     file: {
       fileId,
       url,
diff --git a/src/component/files.ts b/src/component/files.ts
index c6ce165b..89506f4c 100644
--- a/src/component/files.ts
+++ b/src/component/files.ts
@@ -9,7 +9,9 @@ const addFileArgs = v.object({
   storageId: v.string(),
   hash: v.string(),
   filename: v.optional(v.string()),
-  mimeType: v.string(),
+  mediaType: v.optional(v.string()),
+  /** @deprecated Use `mediaType` instead. */
+  mimeType: v.optional(v.string()),
 });
 
 export const addFile = mutation({
@@ -25,6 +27,9 @@ export async function addFileHandler(
   ctx: MutationCtx,
   args: Infer<typeof addFileArgs>,
 ) {
+  // Support both mediaType (preferred) and mimeType (deprecated)
+  const mediaType = args.mediaType ?? args.mimeType;
+  
   const existingFile = await ctx.db
     .query("files")
     .withIndex("hash", (q) => q.eq("hash", args.hash))
@@ -42,7 +47,11 @@ export async function addFileHandler(
     };
   }
   const fileId = await ctx.db.insert("files", {
-    ...args,
+    storageId: args.storageId,
+    hash: args.hash,
+    filename: args.filename,
+    mediaType,
+    mimeType: args.mimeType, // Keep for backwards compatibility
     // We start out with it unused - when it's saved in a message we increment.
     refcount: 0,
     lastTouchedAt: Date.now(),
diff --git a/src/component/schema.ts b/src/component/schema.ts
index da319828..644cc62e 100644
--- a/src/component/schema.ts
+++ b/src/component/schema.ts
@@ -149,7 +149,9 @@ export const schema = defineSchema({
 
   files: defineTable({
     storageId: v.string(),
-    mimeType: v.string(),
+    mediaType: v.optional(v.string()),
+    /** @deprecated Use `mediaType` instead. */
+    mimeType: v.optional(v.string()),
     filename: v.optional(v.string()),
     hash: v.string(),
     refcount: v.number(),
diff --git a/src/mapping.ts b/src/mapping.ts
index 71c95ac0..4bb91659 100644
--- a/src/mapping.ts
+++ b/src/mapping.ts
@@ -328,7 +328,7 @@ export async function serializeContent(
           }
           return {
             type: part.type,
-            mimeType: getMimeOrMediaType(part),
+            mediaType: getMimeOrMediaType(part),
             ...metadata,
             image,
           } satisfies Infer<typeof vImagePart>;
@@ -348,7 +348,7 @@ export async function serializeContent(
             type: part.type,
             data,
             filename: part.filename,
-            mimeType: getMimeOrMediaType(part)!,
+            mediaType: getMimeOrMediaType(part)!,
             ...metadata,
           } satisfies Infer<typeof vFilePart>;
         }
@@ -419,7 +419,7 @@ export function fromModelMessageContent(content: Content): Message["content"] {
         case "image":
           return {
             type: part.type,
-            mimeType: getMimeOrMediaType(part),
+            mediaType: getMimeOrMediaType(part),
             ...metadata,
             image: serializeDataOrUrl(part.image),
           } satisfies Infer<typeof vImagePart>;
@@ -428,7 +428,7 @@ export function fromModelMessageContent(content: Content): Message["content"] {
             type: part.type,
             data: serializeDataOrUrl(part.data),
             filename: part.filename,
-            mimeType: getMimeOrMediaType(part)!,
+            mediaType: getMimeOrMediaType(part)!,
             ...metadata,
           } satisfies Infer<typeof vFilePart>;
         case "tool-call":

From dcdd9ea4aa358ea2f9b63f013660b70c9a9b4e0f Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 06:10:29 +0000
Subject: [PATCH 09/26] Fix test to expect mediaType instead of mimeType

Co-authored-by: zboyles <2215540+zboyles@users.noreply.github.com>
---
 src/fromUIMessages.test.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/fromUIMessages.test.ts b/src/fromUIMessages.test.ts
index 4d295d43..cbe0cb24 100644
--- a/src/fromUIMessages.test.ts
+++ b/src/fromUIMessages.test.ts
@@ -277,7 +277,7 @@ describe("fromUIMessages round-trip tests", () => {
       expect(fileContent).toBeDefined();
       expect(fileContent).toMatchObject({
         type: "file",
-        mimeType: "image/png",
+        mediaType: "image/png",
       });
     }
   });

From d051529f14c33f5f63cf8b73d97a006c8f9ffd1d Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 06:12:50 +0000
Subject: [PATCH 10/26] Update generated component types to use mediaType
 instead of mimeType

- Updated all file part definitions in generated component.ts
- Changed mimeType from required to optional
- Added mediaType as optional field
- Resolved all TypeScript type errors related to mimeType/mediaType

Co-authored-by: zboyles <2215540+zboyles@users.noreply.github.com>
---
 src/component/_generated/component.ts | 57 ++++++++++++++++++---------
 1 file changed, 38 insertions(+), 19 deletions(-)

diff --git a/src/component/_generated/component.ts b/src/component/_generated/component.ts
index 228108ff..7ee22d7d 100644
--- a/src/component/_generated/component.ts
+++ b/src/component/_generated/component.ts
@@ -56,7 +56,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         {
           filename?: string;
           hash: string;
-          mimeType: string;
+          mediaType?: string;
+          mimeType?: string;
           storageId: string;
         },
         { fileId: string; storageId: string },
@@ -86,7 +87,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
           filename?: string;
           hash: string;
           lastTouchedAt: number;
-          mimeType: string;
+          mediaType?: string;
+          mimeType?: string;
           refcount: number;
           storageId: string;
         },
@@ -114,7 +116,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
             filename?: string;
             hash: string;
             lastTouchedAt: number;
-            mimeType: string;
+            mediaType?: string;
+            mimeType?: string;
             refcount: number;
             storageId: string;
           }>;
@@ -192,7 +195,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             data: string | ArrayBuffer;
                             filename?: string;
-                            mimeType: string;
+                            mediaType?: string;
+                            mimeType?: string;
                             providerMetadata?: Record<
                               string,
                               Record<string, any>
@@ -226,7 +230,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             data: string | ArrayBuffer;
                             filename?: string;
-                            mimeType: string;
+                            mediaType?: string;
+                            mimeType?: string;
                             providerMetadata?: Record<
                               string,
                               Record<string, any>
@@ -495,7 +500,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             data: string | ArrayBuffer;
                             filename?: string;
-                            mimeType: string;
+                            mediaType?: string;
+                            mimeType?: string;
                             providerMetadata?: Record<
                               string,
                               Record<string, any>
@@ -529,7 +535,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             data: string | ArrayBuffer;
                             filename?: string;
-                            mimeType: string;
+                            mediaType?: string;
+                            mimeType?: string;
                             providerMetadata?: Record<
                               string,
                               Record<string, any>
@@ -846,7 +853,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           data: string | ArrayBuffer;
                           filename?: string;
-                          mimeType: string;
+                          mediaType?: string;
+                            mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -874,7 +882,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           data: string | ArrayBuffer;
                           filename?: string;
-                          mimeType: string;
+                          mediaType?: string;
+                            mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -1144,7 +1153,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             data: string | ArrayBuffer;
                             filename?: string;
-                            mimeType: string;
+                            mediaType?: string;
+                            mimeType?: string;
                             providerMetadata?: Record<
                               string,
                               Record<string, any>
@@ -1178,7 +1188,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             data: string | ArrayBuffer;
                             filename?: string;
-                            mimeType: string;
+                            mediaType?: string;
+                            mimeType?: string;
                             providerMetadata?: Record<
                               string,
                               Record<string, any>
@@ -1462,7 +1473,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           data: string | ArrayBuffer;
                           filename?: string;
-                          mimeType: string;
+                          mediaType?: string;
+                            mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -1490,7 +1502,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           data: string | ArrayBuffer;
                           filename?: string;
-                          mimeType: string;
+                          mediaType?: string;
+                            mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -1736,7 +1749,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           data: string | ArrayBuffer;
                           filename?: string;
-                          mimeType: string;
+                          mediaType?: string;
+                            mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -1764,7 +1778,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           data: string | ArrayBuffer;
                           filename?: string;
-                          mimeType: string;
+                          mediaType?: string;
+                            mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -2006,7 +2021,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             data: string | ArrayBuffer;
                             filename?: string;
-                            mimeType: string;
+                            mediaType?: string;
+                            mimeType?: string;
                             providerMetadata?: Record<
                               string,
                               Record<string, any>
@@ -2040,7 +2056,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             data: string | ArrayBuffer;
                             filename?: string;
-                            mimeType: string;
+                            mediaType?: string;
+                            mimeType?: string;
                             providerMetadata?: Record<
                               string,
                               Record<string, any>
@@ -2248,7 +2265,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           data: string | ArrayBuffer;
                           filename?: string;
-                          mimeType: string;
+                          mediaType?: string;
+                            mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -2276,7 +2294,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           data: string | ArrayBuffer;
                           filename?: string;
-                          mimeType: string;
+                          mediaType?: string;
+                            mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>

From 392152f5fd5c0b6c10a0dc6c3523bba567a34e15 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 22:19:05 +0000
Subject: [PATCH 11/26] Initial plan


From 1e3f63ca3588b1832a4ac57dca93141a08fb8382 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 22:27:40 +0000
Subject: [PATCH 12/26] Fix tool-call input field and add execution-denied
 output type

Co-authored-by: zboyles <2215540+zboyles@users.noreply.github.com>
---
 src/client/search.ts                      |   11 +-
 src/component/_generated/component.ts     |   96 +-
 src/component/_generated/component.ts.bak | 2941 +++++++++++++++++++++
 src/mapping.ts                            |   17 +-
 4 files changed, 3047 insertions(+), 18 deletions(-)
 create mode 100644 src/component/_generated/component.ts.bak

diff --git a/src/client/search.ts b/src/client/search.ts
index 05cf42d5..5c970932 100644
--- a/src/client/search.ts
+++ b/src/client/search.ts
@@ -267,9 +267,14 @@ export function filterOutOrphanedToolMessages(docs: MessageDoc[]) {
         });
       }
     } else if (doc.message?.role === "tool") {
-      const content = doc.message.content.filter((c) =>
-        toolCallIds.has(c.toolCallId),
-      );
+      const content = doc.message.content.filter((c) => {
+        // tool-result parts have toolCallId
+        if (c.type === "tool-result") {
+          return toolCallIds.has(c.toolCallId);
+        }
+        // tool-approval-response parts don't have toolCallId, so include them
+        return true;
+      });
       if (content.length) {
         result.push({
           ...doc,
diff --git a/src/component/_generated/component.ts b/src/component/_generated/component.ts
index 7ee22d7d..eea30b00 100644
--- a/src/component/_generated/component.ts
+++ b/src/component/_generated/component.ts
@@ -268,7 +268,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             type: "redacted-reasoning";
                           }
                         | {
-                            args: any;
+                            input: any;
+                            args?: any;
                             providerExecuted?: boolean;
                             providerMetadata?: Record<
                               string,
@@ -298,6 +299,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                               | { type: "json"; value: any }
                               | { type: "error-text"; value: string }
                               | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                               | {
                                   type: "content";
                                   value: Array<
@@ -371,11 +373,19 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | { type: "json"; value: any }
                       | { type: "error-text"; value: string }
                       | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | {
                           type: "content";
                           value: Array<
                             | { text: string; type: "text" }
                             | { data: string; mediaType: string; type: "media" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                           >;
                         };
                     providerExecuted?: boolean;
@@ -573,7 +583,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             type: "redacted-reasoning";
                           }
                         | {
-                            args: any;
+                            input: any;
+                            args?: any;
                             providerExecuted?: boolean;
                             providerMetadata?: Record<
                               string,
@@ -603,6 +614,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                               | { type: "json"; value: any }
                               | { type: "error-text"; value: string }
                               | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                               | {
                                   type: "content";
                                   value: Array<
@@ -676,11 +688,19 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | { type: "json"; value: any }
                       | { type: "error-text"; value: string }
                       | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | {
                           type: "content";
                           value: Array<
                             | { text: string; type: "text" }
                             | { data: string; mediaType: string; type: "media" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                           >;
                         };
                     providerExecuted?: boolean;
@@ -911,7 +931,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           type: "redacted-reasoning";
                         }
                       | {
-                          args: any;
+                          input: any;
+                            args?: any;
                           providerExecuted?: boolean;
                           providerMetadata?: Record<
                             string,
@@ -934,6 +955,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { type: "json"; value: any }
                             | { type: "error-text"; value: string }
                             | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                             | {
                                 type: "content";
                                 value: Array<
@@ -998,11 +1020,19 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                     | { type: "json"; value: any }
                     | { type: "error-text"; value: string }
                     | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                     | {
                         type: "content";
                         value: Array<
                           | { text: string; type: "text" }
                           | { data: string; mediaType: string; type: "media" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                         >;
                       };
                   providerExecuted?: boolean;
@@ -1226,7 +1256,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             type: "redacted-reasoning";
                           }
                         | {
-                            args: any;
+                            input: any;
+                            args?: any;
                             providerExecuted?: boolean;
                             providerMetadata?: Record<
                               string,
@@ -1256,6 +1287,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                               | { type: "json"; value: any }
                               | { type: "error-text"; value: string }
                               | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                               | {
                                   type: "content";
                                   value: Array<
@@ -1329,11 +1361,19 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | { type: "json"; value: any }
                       | { type: "error-text"; value: string }
                       | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | {
                           type: "content";
                           value: Array<
                             | { text: string; type: "text" }
                             | { data: string; mediaType: string; type: "media" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                           >;
                         };
                     providerExecuted?: boolean;
@@ -1531,7 +1571,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           type: "redacted-reasoning";
                         }
                       | {
-                          args: any;
+                          input: any;
+                            args?: any;
                           providerExecuted?: boolean;
                           providerMetadata?: Record<
                             string,
@@ -1554,6 +1595,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { type: "json"; value: any }
                             | { type: "error-text"; value: string }
                             | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                             | {
                                 type: "content";
                                 value: Array<
@@ -1618,11 +1660,19 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                     | { type: "json"; value: any }
                     | { type: "error-text"; value: string }
                     | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                     | {
                         type: "content";
                         value: Array<
                           | { text: string; type: "text" }
                           | { data: string; mediaType: string; type: "media" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                         >;
                       };
                   providerExecuted?: boolean;
@@ -1807,7 +1857,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           type: "redacted-reasoning";
                         }
                       | {
-                          args: any;
+                          input: any;
+                            args?: any;
                           providerExecuted?: boolean;
                           providerMetadata?: Record<
                             string,
@@ -1830,6 +1881,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { type: "json"; value: any }
                             | { type: "error-text"; value: string }
                             | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                             | {
                                 type: "content";
                                 value: Array<
@@ -1894,11 +1946,19 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                     | { type: "json"; value: any }
                     | { type: "error-text"; value: string }
                     | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                     | {
                         type: "content";
                         value: Array<
                           | { text: string; type: "text" }
                           | { data: string; mediaType: string; type: "media" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                         >;
                       };
                   providerExecuted?: boolean;
@@ -2094,7 +2154,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             type: "redacted-reasoning";
                           }
                         | {
-                            args: any;
+                            input: any;
+                            args?: any;
                             providerExecuted?: boolean;
                             providerMetadata?: Record<
                               string,
@@ -2124,6 +2185,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                               | { type: "json"; value: any }
                               | { type: "error-text"; value: string }
                               | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                               | {
                                   type: "content";
                                   value: Array<
@@ -2197,11 +2259,19 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | { type: "json"; value: any }
                       | { type: "error-text"; value: string }
                       | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | {
                           type: "content";
                           value: Array<
                             | { text: string; type: "text" }
                             | { data: string; mediaType: string; type: "media" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                           >;
                         };
                     providerExecuted?: boolean;
@@ -2323,7 +2393,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           type: "redacted-reasoning";
                         }
                       | {
-                          args: any;
+                          input: any;
+                            args?: any;
                           providerExecuted?: boolean;
                           providerMetadata?: Record<
                             string,
@@ -2346,6 +2417,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { type: "json"; value: any }
                             | { type: "error-text"; value: string }
                             | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                             | {
                                 type: "content";
                                 value: Array<
@@ -2410,11 +2482,19 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                     | { type: "json"; value: any }
                     | { type: "error-text"; value: string }
                     | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                     | {
                         type: "content";
                         value: Array<
                           | { text: string; type: "text" }
                           | { data: string; mediaType: string; type: "media" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                         >;
                       };
                   providerExecuted?: boolean;
diff --git a/src/component/_generated/component.ts.bak b/src/component/_generated/component.ts.bak
new file mode 100644
index 00000000..7ee22d7d
--- /dev/null
+++ b/src/component/_generated/component.ts.bak
@@ -0,0 +1,2941 @@
+/* eslint-disable */
+/**
+ * Generated `ComponentApi` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+
+import type { FunctionReference } from "convex/server";
+
+/**
+ * A utility for referencing a Convex component's exposed API.
+ *
+ * Useful when expecting a parameter like `components.myComponent`.
+ * Usage:
+ * ```ts
+ * async function myFunction(ctx: QueryCtx, component: ComponentApi) {
+ *   return ctx.runQuery(component.someFile.someQuery, { ...args });
+ * }
+ * ```
+ */
+export type ComponentApi<Name extends string | undefined = string | undefined> =
+  {
+    apiKeys: {
+      destroy: FunctionReference<
+        "mutation",
+        "internal",
+        { apiKey?: string; name?: string },
+        | "missing"
+        | "deleted"
+        | "name mismatch"
+        | "must provide either apiKey or name",
+        Name
+      >;
+      issue: FunctionReference<
+        "mutation",
+        "internal",
+        { name?: string },
+        string,
+        Name
+      >;
+      validate: FunctionReference<
+        "query",
+        "internal",
+        { apiKey: string },
+        boolean,
+        Name
+      >;
+    };
+    files: {
+      addFile: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          filename?: string;
+          hash: string;
+          mediaType?: string;
+          mimeType?: string;
+          storageId: string;
+        },
+        { fileId: string; storageId: string },
+        Name
+      >;
+      copyFile: FunctionReference<
+        "mutation",
+        "internal",
+        { fileId: string },
+        null,
+        Name
+      >;
+      deleteFiles: FunctionReference<
+        "mutation",
+        "internal",
+        { fileIds: Array<string>; force?: boolean },
+        Array<string>,
+        Name
+      >;
+      get: FunctionReference<
+        "query",
+        "internal",
+        { fileId: string },
+        null | {
+          _creationTime: number;
+          _id: string;
+          filename?: string;
+          hash: string;
+          lastTouchedAt: number;
+          mediaType?: string;
+          mimeType?: string;
+          refcount: number;
+          storageId: string;
+        },
+        Name
+      >;
+      getFilesToDelete: FunctionReference<
+        "query",
+        "internal",
+        {
+          paginationOpts: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
+        },
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            filename?: string;
+            hash: string;
+            lastTouchedAt: number;
+            mediaType?: string;
+            mimeType?: string;
+            refcount: number;
+            storageId: string;
+          }>;
+        },
+        Name
+      >;
+      useExistingFile: FunctionReference<
+        "mutation",
+        "internal",
+        { filename?: string; hash: string },
+        null | { fileId: string; storageId: string },
+        Name
+      >;
+    };
+    messages: {
+      addMessages: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          agentName?: string;
+          embeddings?: {
+            dimension:
+              | 128
+              | 256
+              | 512
+              | 768
+              | 1024
+              | 1408
+              | 1536
+              | 2048
+              | 3072
+              | 4096;
+            model: string;
+            vectors: Array<Array<number> | null>;
+          };
+          failPendingSteps?: boolean;
+          hideFromUserIdSearch?: boolean;
+          messages: Array<{
+            error?: string;
+            fileIds?: Array<string>;
+            finishReason?:
+              | "stop"
+              | "length"
+              | "content-filter"
+              | "tool-calls"
+              | "error"
+              | "other"
+              | "unknown";
+            message:
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            image: string | ArrayBuffer;
+                            mimeType?: string;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "image";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "user";
+                }
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            signature?: string;
+                            text: string;
+                            type: "reasoning";
+                          }
+                        | {
+                            data: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "redacted-reasoning";
+                          }
+                        | {
+                            args: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
+                        | {
+                            args?: any;
+                            experimental_content?: Array<
+                              | { text: string; type: "text" }
+                              | {
+                                  data: string;
+                                  mimeType?: string;
+                                  type: "image";
+                                }
+                            >;
+                            isError?: boolean;
+                            output?:
+                              | { type: "text"; value: string }
+                              | { type: "json"; value: any }
+                              | { type: "error-text"; value: string }
+                              | { type: "error-json"; value: any }
+                              | {
+                                  type: "content";
+                                  value: Array<
+                                    | { text: string; type: "text" }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        type: "media";
+                                      }
+                                  >;
+                                };
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            result?: any;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-result";
+                          }
+                        | {
+                            id: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "url";
+                            title?: string;
+                            type: "source";
+                            url: string;
+                          }
+                        | {
+                            filename?: string;
+                            id: string;
+                            mediaType: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "document";
+                            title: string;
+                            type: "source";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "assistant";
+                }
+              | {
+                  content: Array<{
+                    args?: any;
+                    experimental_content?: Array<
+                      | { text: string; type: "text" }
+                      | { data: string; mimeType?: string; type: "image" }
+                    >;
+                    isError?: boolean;
+                    output?:
+                      | { type: "text"; value: string }
+                      | { type: "json"; value: any }
+                      | { type: "error-text"; value: string }
+                      | { type: "error-json"; value: any }
+                      | {
+                          type: "content";
+                          value: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mediaType: string; type: "media" }
+                          >;
+                        };
+                    providerExecuted?: boolean;
+                    providerMetadata?: Record<string, Record<string, any>>;
+                    providerOptions?: Record<string, Record<string, any>>;
+                    result?: any;
+                    toolCallId: string;
+                    toolName: string;
+                    type: "tool-result";
+                  }>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "tool";
+                }
+              | {
+                  content: string;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "system";
+                };
+            model?: string;
+            provider?: string;
+            providerMetadata?: Record<string, Record<string, any>>;
+            reasoning?: string;
+            reasoningDetails?: Array<
+              | {
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  signature?: string;
+                  text: string;
+                  type: "reasoning";
+                }
+              | { signature?: string; text: string; type: "text" }
+              | { data: string; type: "redacted" }
+            >;
+            sources?: Array<
+              | {
+                  id: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "url";
+                  title?: string;
+                  type?: "source";
+                  url: string;
+                }
+              | {
+                  filename?: string;
+                  id: string;
+                  mediaType: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "document";
+                  title: string;
+                  type: "source";
+                }
+            >;
+            status?: "pending" | "success" | "failed";
+            text?: string;
+            usage?: {
+              cachedInputTokens?: number;
+              completionTokens: number;
+              promptTokens: number;
+              reasoningTokens?: number;
+              totalTokens: number;
+            };
+            warnings?: Array<
+              | {
+                  details?: string;
+                  setting: string;
+                  type: "unsupported-setting";
+                }
+              | { details?: string; tool: any; type: "unsupported-tool" }
+              | { message: string; type: "other" }
+            >;
+          }>;
+          pendingMessageId?: string;
+          promptMessageId?: string;
+          threadId: string;
+          userId?: string;
+        },
+        {
+          messages: Array<{
+            _creationTime: number;
+            _id: string;
+            agentName?: string;
+            embeddingId?: string;
+            error?: string;
+            fileIds?: Array<string>;
+            finishReason?:
+              | "stop"
+              | "length"
+              | "content-filter"
+              | "tool-calls"
+              | "error"
+              | "other"
+              | "unknown";
+            id?: string;
+            message?:
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            image: string | ArrayBuffer;
+                            mimeType?: string;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "image";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "user";
+                }
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            signature?: string;
+                            text: string;
+                            type: "reasoning";
+                          }
+                        | {
+                            data: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "redacted-reasoning";
+                          }
+                        | {
+                            args: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
+                        | {
+                            args?: any;
+                            experimental_content?: Array<
+                              | { text: string; type: "text" }
+                              | {
+                                  data: string;
+                                  mimeType?: string;
+                                  type: "image";
+                                }
+                            >;
+                            isError?: boolean;
+                            output?:
+                              | { type: "text"; value: string }
+                              | { type: "json"; value: any }
+                              | { type: "error-text"; value: string }
+                              | { type: "error-json"; value: any }
+                              | {
+                                  type: "content";
+                                  value: Array<
+                                    | { text: string; type: "text" }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        type: "media";
+                                      }
+                                  >;
+                                };
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            result?: any;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-result";
+                          }
+                        | {
+                            id: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "url";
+                            title?: string;
+                            type: "source";
+                            url: string;
+                          }
+                        | {
+                            filename?: string;
+                            id: string;
+                            mediaType: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "document";
+                            title: string;
+                            type: "source";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "assistant";
+                }
+              | {
+                  content: Array<{
+                    args?: any;
+                    experimental_content?: Array<
+                      | { text: string; type: "text" }
+                      | { data: string; mimeType?: string; type: "image" }
+                    >;
+                    isError?: boolean;
+                    output?:
+                      | { type: "text"; value: string }
+                      | { type: "json"; value: any }
+                      | { type: "error-text"; value: string }
+                      | { type: "error-json"; value: any }
+                      | {
+                          type: "content";
+                          value: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mediaType: string; type: "media" }
+                          >;
+                        };
+                    providerExecuted?: boolean;
+                    providerMetadata?: Record<string, Record<string, any>>;
+                    providerOptions?: Record<string, Record<string, any>>;
+                    result?: any;
+                    toolCallId: string;
+                    toolName: string;
+                    type: "tool-result";
+                  }>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "tool";
+                }
+              | {
+                  content: string;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "system";
+                };
+            model?: string;
+            order: number;
+            provider?: string;
+            providerMetadata?: Record<string, Record<string, any>>;
+            providerOptions?: Record<string, Record<string, any>>;
+            reasoning?: string;
+            reasoningDetails?: Array<
+              | {
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  signature?: string;
+                  text: string;
+                  type: "reasoning";
+                }
+              | { signature?: string; text: string; type: "text" }
+              | { data: string; type: "redacted" }
+            >;
+            sources?: Array<
+              | {
+                  id: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "url";
+                  title?: string;
+                  type?: "source";
+                  url: string;
+                }
+              | {
+                  filename?: string;
+                  id: string;
+                  mediaType: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "document";
+                  title: string;
+                  type: "source";
+                }
+            >;
+            status: "pending" | "success" | "failed";
+            stepOrder: number;
+            text?: string;
+            threadId: string;
+            tool: boolean;
+            usage?: {
+              cachedInputTokens?: number;
+              completionTokens: number;
+              promptTokens: number;
+              reasoningTokens?: number;
+              totalTokens: number;
+            };
+            userId?: string;
+            warnings?: Array<
+              | {
+                  details?: string;
+                  setting: string;
+                  type: "unsupported-setting";
+                }
+              | { details?: string; tool: any; type: "unsupported-tool" }
+              | { message: string; type: "other" }
+            >;
+          }>;
+        },
+        Name
+      >;
+      cloneThread: FunctionReference<
+        "action",
+        "internal",
+        {
+          batchSize?: number;
+          copyUserIdForVectorSearch?: boolean;
+          excludeToolMessages?: boolean;
+          insertAtOrder?: number;
+          limit?: number;
+          sourceThreadId: string;
+          statuses?: Array<"pending" | "success" | "failed">;
+          targetThreadId: string;
+          upToAndIncludingMessageId?: string;
+        },
+        number,
+        Name
+      >;
+      deleteByIds: FunctionReference<
+        "mutation",
+        "internal",
+        { messageIds: Array<string> },
+        Array<string>,
+        Name
+      >;
+      deleteByOrder: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          endOrder: number;
+          endStepOrder?: number;
+          startOrder: number;
+          startStepOrder?: number;
+          threadId: string;
+        },
+        { isDone: boolean; lastOrder?: number; lastStepOrder?: number },
+        Name
+      >;
+      finalizeMessage: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          messageId: string;
+          result: { status: "success" } | { error: string; status: "failed" };
+        },
+        null,
+        Name
+      >;
+      getMessagesByIds: FunctionReference<
+        "query",
+        "internal",
+        { messageIds: Array<string> },
+        Array<null | {
+          _creationTime: number;
+          _id: string;
+          agentName?: string;
+          embeddingId?: string;
+          error?: string;
+          fileIds?: Array<string>;
+          finishReason?:
+            | "stop"
+            | "length"
+            | "content-filter"
+            | "tool-calls"
+            | "error"
+            | "other"
+            | "unknown";
+          id?: string;
+          message?:
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          image: string | ArrayBuffer;
+                          mimeType?: string;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "image";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                            mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "user";
+              }
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                            mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          signature?: string;
+                          text: string;
+                          type: "reasoning";
+                        }
+                      | {
+                          data: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "redacted-reasoning";
+                        }
+                      | {
+                          args: any;
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-call";
+                        }
+                      | {
+                          args?: any;
+                          experimental_content?: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mimeType?: string; type: "image" }
+                          >;
+                          isError?: boolean;
+                          output?:
+                            | { type: "text"; value: string }
+                            | { type: "json"; value: any }
+                            | { type: "error-text"; value: string }
+                            | { type: "error-json"; value: any }
+                            | {
+                                type: "content";
+                                value: Array<
+                                  | { text: string; type: "text" }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      type: "media";
+                                    }
+                                >;
+                              };
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          result?: any;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-result";
+                        }
+                      | {
+                          id: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "url";
+                          title?: string;
+                          type: "source";
+                          url: string;
+                        }
+                      | {
+                          filename?: string;
+                          id: string;
+                          mediaType: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "document";
+                          title: string;
+                          type: "source";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "assistant";
+              }
+            | {
+                content: Array<{
+                  args?: any;
+                  experimental_content?: Array<
+                    | { text: string; type: "text" }
+                    | { data: string; mimeType?: string; type: "image" }
+                  >;
+                  isError?: boolean;
+                  output?:
+                    | { type: "text"; value: string }
+                    | { type: "json"; value: any }
+                    | { type: "error-text"; value: string }
+                    | { type: "error-json"; value: any }
+                    | {
+                        type: "content";
+                        value: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mediaType: string; type: "media" }
+                        >;
+                      };
+                  providerExecuted?: boolean;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  result?: any;
+                  toolCallId: string;
+                  toolName: string;
+                  type: "tool-result";
+                }>;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "tool";
+              }
+            | {
+                content: string;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "system";
+              };
+          model?: string;
+          order: number;
+          provider?: string;
+          providerMetadata?: Record<string, Record<string, any>>;
+          providerOptions?: Record<string, Record<string, any>>;
+          reasoning?: string;
+          reasoningDetails?: Array<
+            | {
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                signature?: string;
+                text: string;
+                type: "reasoning";
+              }
+            | { signature?: string; text: string; type: "text" }
+            | { data: string; type: "redacted" }
+          >;
+          sources?: Array<
+            | {
+                id: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "url";
+                title?: string;
+                type?: "source";
+                url: string;
+              }
+            | {
+                filename?: string;
+                id: string;
+                mediaType: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "document";
+                title: string;
+                type: "source";
+              }
+          >;
+          status: "pending" | "success" | "failed";
+          stepOrder: number;
+          text?: string;
+          threadId: string;
+          tool: boolean;
+          usage?: {
+            cachedInputTokens?: number;
+            completionTokens: number;
+            promptTokens: number;
+            reasoningTokens?: number;
+            totalTokens: number;
+          };
+          userId?: string;
+          warnings?: Array<
+            | { details?: string; setting: string; type: "unsupported-setting" }
+            | { details?: string; tool: any; type: "unsupported-tool" }
+            | { message: string; type: "other" }
+          >;
+        }>,
+        Name
+      >;
+      getMessageSearchFields: FunctionReference<
+        "query",
+        "internal",
+        { messageId: string },
+        { embedding?: Array<number>; embeddingModel?: string; text?: string },
+        Name
+      >;
+      listMessagesByThreadId: FunctionReference<
+        "query",
+        "internal",
+        {
+          excludeToolMessages?: boolean;
+          order: "asc" | "desc";
+          paginationOpts?: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
+          statuses?: Array<"pending" | "success" | "failed">;
+          threadId: string;
+          upToAndIncludingMessageId?: string;
+        },
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            agentName?: string;
+            embeddingId?: string;
+            error?: string;
+            fileIds?: Array<string>;
+            finishReason?:
+              | "stop"
+              | "length"
+              | "content-filter"
+              | "tool-calls"
+              | "error"
+              | "other"
+              | "unknown";
+            id?: string;
+            message?:
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            image: string | ArrayBuffer;
+                            mimeType?: string;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "image";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "user";
+                }
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            signature?: string;
+                            text: string;
+                            type: "reasoning";
+                          }
+                        | {
+                            data: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "redacted-reasoning";
+                          }
+                        | {
+                            args: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
+                        | {
+                            args?: any;
+                            experimental_content?: Array<
+                              | { text: string; type: "text" }
+                              | {
+                                  data: string;
+                                  mimeType?: string;
+                                  type: "image";
+                                }
+                            >;
+                            isError?: boolean;
+                            output?:
+                              | { type: "text"; value: string }
+                              | { type: "json"; value: any }
+                              | { type: "error-text"; value: string }
+                              | { type: "error-json"; value: any }
+                              | {
+                                  type: "content";
+                                  value: Array<
+                                    | { text: string; type: "text" }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        type: "media";
+                                      }
+                                  >;
+                                };
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            result?: any;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-result";
+                          }
+                        | {
+                            id: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "url";
+                            title?: string;
+                            type: "source";
+                            url: string;
+                          }
+                        | {
+                            filename?: string;
+                            id: string;
+                            mediaType: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "document";
+                            title: string;
+                            type: "source";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "assistant";
+                }
+              | {
+                  content: Array<{
+                    args?: any;
+                    experimental_content?: Array<
+                      | { text: string; type: "text" }
+                      | { data: string; mimeType?: string; type: "image" }
+                    >;
+                    isError?: boolean;
+                    output?:
+                      | { type: "text"; value: string }
+                      | { type: "json"; value: any }
+                      | { type: "error-text"; value: string }
+                      | { type: "error-json"; value: any }
+                      | {
+                          type: "content";
+                          value: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mediaType: string; type: "media" }
+                          >;
+                        };
+                    providerExecuted?: boolean;
+                    providerMetadata?: Record<string, Record<string, any>>;
+                    providerOptions?: Record<string, Record<string, any>>;
+                    result?: any;
+                    toolCallId: string;
+                    toolName: string;
+                    type: "tool-result";
+                  }>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "tool";
+                }
+              | {
+                  content: string;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "system";
+                };
+            model?: string;
+            order: number;
+            provider?: string;
+            providerMetadata?: Record<string, Record<string, any>>;
+            providerOptions?: Record<string, Record<string, any>>;
+            reasoning?: string;
+            reasoningDetails?: Array<
+              | {
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  signature?: string;
+                  text: string;
+                  type: "reasoning";
+                }
+              | { signature?: string; text: string; type: "text" }
+              | { data: string; type: "redacted" }
+            >;
+            sources?: Array<
+              | {
+                  id: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "url";
+                  title?: string;
+                  type?: "source";
+                  url: string;
+                }
+              | {
+                  filename?: string;
+                  id: string;
+                  mediaType: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "document";
+                  title: string;
+                  type: "source";
+                }
+            >;
+            status: "pending" | "success" | "failed";
+            stepOrder: number;
+            text?: string;
+            threadId: string;
+            tool: boolean;
+            usage?: {
+              cachedInputTokens?: number;
+              completionTokens: number;
+              promptTokens: number;
+              reasoningTokens?: number;
+              totalTokens: number;
+            };
+            userId?: string;
+            warnings?: Array<
+              | {
+                  details?: string;
+                  setting: string;
+                  type: "unsupported-setting";
+                }
+              | { details?: string; tool: any; type: "unsupported-tool" }
+              | { message: string; type: "other" }
+            >;
+          }>;
+          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+          splitCursor?: string | null;
+        },
+        Name
+      >;
+      searchMessages: FunctionReference<
+        "action",
+        "internal",
+        {
+          embedding?: Array<number>;
+          embeddingModel?: string;
+          limit: number;
+          messageRange?: { after: number; before: number };
+          searchAllMessagesForUserId?: string;
+          targetMessageId?: string;
+          text?: string;
+          textSearch?: boolean;
+          threadId?: string;
+          vectorScoreThreshold?: number;
+          vectorSearch?: boolean;
+        },
+        Array<{
+          _creationTime: number;
+          _id: string;
+          agentName?: string;
+          embeddingId?: string;
+          error?: string;
+          fileIds?: Array<string>;
+          finishReason?:
+            | "stop"
+            | "length"
+            | "content-filter"
+            | "tool-calls"
+            | "error"
+            | "other"
+            | "unknown";
+          id?: string;
+          message?:
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          image: string | ArrayBuffer;
+                          mimeType?: string;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "image";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                            mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "user";
+              }
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                            mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          signature?: string;
+                          text: string;
+                          type: "reasoning";
+                        }
+                      | {
+                          data: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "redacted-reasoning";
+                        }
+                      | {
+                          args: any;
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-call";
+                        }
+                      | {
+                          args?: any;
+                          experimental_content?: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mimeType?: string; type: "image" }
+                          >;
+                          isError?: boolean;
+                          output?:
+                            | { type: "text"; value: string }
+                            | { type: "json"; value: any }
+                            | { type: "error-text"; value: string }
+                            | { type: "error-json"; value: any }
+                            | {
+                                type: "content";
+                                value: Array<
+                                  | { text: string; type: "text" }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      type: "media";
+                                    }
+                                >;
+                              };
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          result?: any;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-result";
+                        }
+                      | {
+                          id: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "url";
+                          title?: string;
+                          type: "source";
+                          url: string;
+                        }
+                      | {
+                          filename?: string;
+                          id: string;
+                          mediaType: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "document";
+                          title: string;
+                          type: "source";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "assistant";
+              }
+            | {
+                content: Array<{
+                  args?: any;
+                  experimental_content?: Array<
+                    | { text: string; type: "text" }
+                    | { data: string; mimeType?: string; type: "image" }
+                  >;
+                  isError?: boolean;
+                  output?:
+                    | { type: "text"; value: string }
+                    | { type: "json"; value: any }
+                    | { type: "error-text"; value: string }
+                    | { type: "error-json"; value: any }
+                    | {
+                        type: "content";
+                        value: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mediaType: string; type: "media" }
+                        >;
+                      };
+                  providerExecuted?: boolean;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  result?: any;
+                  toolCallId: string;
+                  toolName: string;
+                  type: "tool-result";
+                }>;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "tool";
+              }
+            | {
+                content: string;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "system";
+              };
+          model?: string;
+          order: number;
+          provider?: string;
+          providerMetadata?: Record<string, Record<string, any>>;
+          providerOptions?: Record<string, Record<string, any>>;
+          reasoning?: string;
+          reasoningDetails?: Array<
+            | {
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                signature?: string;
+                text: string;
+                type: "reasoning";
+              }
+            | { signature?: string; text: string; type: "text" }
+            | { data: string; type: "redacted" }
+          >;
+          sources?: Array<
+            | {
+                id: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "url";
+                title?: string;
+                type?: "source";
+                url: string;
+              }
+            | {
+                filename?: string;
+                id: string;
+                mediaType: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "document";
+                title: string;
+                type: "source";
+              }
+          >;
+          status: "pending" | "success" | "failed";
+          stepOrder: number;
+          text?: string;
+          threadId: string;
+          tool: boolean;
+          usage?: {
+            cachedInputTokens?: number;
+            completionTokens: number;
+            promptTokens: number;
+            reasoningTokens?: number;
+            totalTokens: number;
+          };
+          userId?: string;
+          warnings?: Array<
+            | { details?: string; setting: string; type: "unsupported-setting" }
+            | { details?: string; tool: any; type: "unsupported-tool" }
+            | { message: string; type: "other" }
+          >;
+        }>,
+        Name
+      >;
+      textSearch: FunctionReference<
+        "query",
+        "internal",
+        {
+          limit: number;
+          searchAllMessagesForUserId?: string;
+          targetMessageId?: string;
+          text?: string;
+          threadId?: string;
+        },
+        Array<{
+          _creationTime: number;
+          _id: string;
+          agentName?: string;
+          embeddingId?: string;
+          error?: string;
+          fileIds?: Array<string>;
+          finishReason?:
+            | "stop"
+            | "length"
+            | "content-filter"
+            | "tool-calls"
+            | "error"
+            | "other"
+            | "unknown";
+          id?: string;
+          message?:
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          image: string | ArrayBuffer;
+                          mimeType?: string;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "image";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                            mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "user";
+              }
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                            mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          signature?: string;
+                          text: string;
+                          type: "reasoning";
+                        }
+                      | {
+                          data: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "redacted-reasoning";
+                        }
+                      | {
+                          args: any;
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-call";
+                        }
+                      | {
+                          args?: any;
+                          experimental_content?: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mimeType?: string; type: "image" }
+                          >;
+                          isError?: boolean;
+                          output?:
+                            | { type: "text"; value: string }
+                            | { type: "json"; value: any }
+                            | { type: "error-text"; value: string }
+                            | { type: "error-json"; value: any }
+                            | {
+                                type: "content";
+                                value: Array<
+                                  | { text: string; type: "text" }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      type: "media";
+                                    }
+                                >;
+                              };
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          result?: any;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-result";
+                        }
+                      | {
+                          id: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "url";
+                          title?: string;
+                          type: "source";
+                          url: string;
+                        }
+                      | {
+                          filename?: string;
+                          id: string;
+                          mediaType: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "document";
+                          title: string;
+                          type: "source";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "assistant";
+              }
+            | {
+                content: Array<{
+                  args?: any;
+                  experimental_content?: Array<
+                    | { text: string; type: "text" }
+                    | { data: string; mimeType?: string; type: "image" }
+                  >;
+                  isError?: boolean;
+                  output?:
+                    | { type: "text"; value: string }
+                    | { type: "json"; value: any }
+                    | { type: "error-text"; value: string }
+                    | { type: "error-json"; value: any }
+                    | {
+                        type: "content";
+                        value: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mediaType: string; type: "media" }
+                        >;
+                      };
+                  providerExecuted?: boolean;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  result?: any;
+                  toolCallId: string;
+                  toolName: string;
+                  type: "tool-result";
+                }>;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "tool";
+              }
+            | {
+                content: string;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "system";
+              };
+          model?: string;
+          order: number;
+          provider?: string;
+          providerMetadata?: Record<string, Record<string, any>>;
+          providerOptions?: Record<string, Record<string, any>>;
+          reasoning?: string;
+          reasoningDetails?: Array<
+            | {
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                signature?: string;
+                text: string;
+                type: "reasoning";
+              }
+            | { signature?: string; text: string; type: "text" }
+            | { data: string; type: "redacted" }
+          >;
+          sources?: Array<
+            | {
+                id: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "url";
+                title?: string;
+                type?: "source";
+                url: string;
+              }
+            | {
+                filename?: string;
+                id: string;
+                mediaType: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "document";
+                title: string;
+                type: "source";
+              }
+          >;
+          status: "pending" | "success" | "failed";
+          stepOrder: number;
+          text?: string;
+          threadId: string;
+          tool: boolean;
+          usage?: {
+            cachedInputTokens?: number;
+            completionTokens: number;
+            promptTokens: number;
+            reasoningTokens?: number;
+            totalTokens: number;
+          };
+          userId?: string;
+          warnings?: Array<
+            | { details?: string; setting: string; type: "unsupported-setting" }
+            | { details?: string; tool: any; type: "unsupported-tool" }
+            | { message: string; type: "other" }
+          >;
+        }>,
+        Name
+      >;
+      updateMessage: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          messageId: string;
+          patch: {
+            error?: string;
+            fileIds?: Array<string>;
+            finishReason?:
+              | "stop"
+              | "length"
+              | "content-filter"
+              | "tool-calls"
+              | "error"
+              | "other"
+              | "unknown";
+            message?:
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            image: string | ArrayBuffer;
+                            mimeType?: string;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "image";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "user";
+                }
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            signature?: string;
+                            text: string;
+                            type: "reasoning";
+                          }
+                        | {
+                            data: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "redacted-reasoning";
+                          }
+                        | {
+                            args: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
+                        | {
+                            args?: any;
+                            experimental_content?: Array<
+                              | { text: string; type: "text" }
+                              | {
+                                  data: string;
+                                  mimeType?: string;
+                                  type: "image";
+                                }
+                            >;
+                            isError?: boolean;
+                            output?:
+                              | { type: "text"; value: string }
+                              | { type: "json"; value: any }
+                              | { type: "error-text"; value: string }
+                              | { type: "error-json"; value: any }
+                              | {
+                                  type: "content";
+                                  value: Array<
+                                    | { text: string; type: "text" }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        type: "media";
+                                      }
+                                  >;
+                                };
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            result?: any;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-result";
+                          }
+                        | {
+                            id: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "url";
+                            title?: string;
+                            type: "source";
+                            url: string;
+                          }
+                        | {
+                            filename?: string;
+                            id: string;
+                            mediaType: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "document";
+                            title: string;
+                            type: "source";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "assistant";
+                }
+              | {
+                  content: Array<{
+                    args?: any;
+                    experimental_content?: Array<
+                      | { text: string; type: "text" }
+                      | { data: string; mimeType?: string; type: "image" }
+                    >;
+                    isError?: boolean;
+                    output?:
+                      | { type: "text"; value: string }
+                      | { type: "json"; value: any }
+                      | { type: "error-text"; value: string }
+                      | { type: "error-json"; value: any }
+                      | {
+                          type: "content";
+                          value: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mediaType: string; type: "media" }
+                          >;
+                        };
+                    providerExecuted?: boolean;
+                    providerMetadata?: Record<string, Record<string, any>>;
+                    providerOptions?: Record<string, Record<string, any>>;
+                    result?: any;
+                    toolCallId: string;
+                    toolName: string;
+                    type: "tool-result";
+                  }>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "tool";
+                }
+              | {
+                  content: string;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "system";
+                };
+            model?: string;
+            provider?: string;
+            providerOptions?: Record<string, Record<string, any>>;
+            status?: "pending" | "success" | "failed";
+          };
+        },
+        {
+          _creationTime: number;
+          _id: string;
+          agentName?: string;
+          embeddingId?: string;
+          error?: string;
+          fileIds?: Array<string>;
+          finishReason?:
+            | "stop"
+            | "length"
+            | "content-filter"
+            | "tool-calls"
+            | "error"
+            | "other"
+            | "unknown";
+          id?: string;
+          message?:
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          image: string | ArrayBuffer;
+                          mimeType?: string;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "image";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                            mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "user";
+              }
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                            mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          signature?: string;
+                          text: string;
+                          type: "reasoning";
+                        }
+                      | {
+                          data: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "redacted-reasoning";
+                        }
+                      | {
+                          args: any;
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-call";
+                        }
+                      | {
+                          args?: any;
+                          experimental_content?: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mimeType?: string; type: "image" }
+                          >;
+                          isError?: boolean;
+                          output?:
+                            | { type: "text"; value: string }
+                            | { type: "json"; value: any }
+                            | { type: "error-text"; value: string }
+                            | { type: "error-json"; value: any }
+                            | {
+                                type: "content";
+                                value: Array<
+                                  | { text: string; type: "text" }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      type: "media";
+                                    }
+                                >;
+                              };
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          result?: any;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-result";
+                        }
+                      | {
+                          id: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "url";
+                          title?: string;
+                          type: "source";
+                          url: string;
+                        }
+                      | {
+                          filename?: string;
+                          id: string;
+                          mediaType: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "document";
+                          title: string;
+                          type: "source";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "assistant";
+              }
+            | {
+                content: Array<{
+                  args?: any;
+                  experimental_content?: Array<
+                    | { text: string; type: "text" }
+                    | { data: string; mimeType?: string; type: "image" }
+                  >;
+                  isError?: boolean;
+                  output?:
+                    | { type: "text"; value: string }
+                    | { type: "json"; value: any }
+                    | { type: "error-text"; value: string }
+                    | { type: "error-json"; value: any }
+                    | {
+                        type: "content";
+                        value: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mediaType: string; type: "media" }
+                        >;
+                      };
+                  providerExecuted?: boolean;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  result?: any;
+                  toolCallId: string;
+                  toolName: string;
+                  type: "tool-result";
+                }>;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "tool";
+              }
+            | {
+                content: string;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "system";
+              };
+          model?: string;
+          order: number;
+          provider?: string;
+          providerMetadata?: Record<string, Record<string, any>>;
+          providerOptions?: Record<string, Record<string, any>>;
+          reasoning?: string;
+          reasoningDetails?: Array<
+            | {
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                signature?: string;
+                text: string;
+                type: "reasoning";
+              }
+            | { signature?: string; text: string; type: "text" }
+            | { data: string; type: "redacted" }
+          >;
+          sources?: Array<
+            | {
+                id: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "url";
+                title?: string;
+                type?: "source";
+                url: string;
+              }
+            | {
+                filename?: string;
+                id: string;
+                mediaType: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "document";
+                title: string;
+                type: "source";
+              }
+          >;
+          status: "pending" | "success" | "failed";
+          stepOrder: number;
+          text?: string;
+          threadId: string;
+          tool: boolean;
+          usage?: {
+            cachedInputTokens?: number;
+            completionTokens: number;
+            promptTokens: number;
+            reasoningTokens?: number;
+            totalTokens: number;
+          };
+          userId?: string;
+          warnings?: Array<
+            | { details?: string; setting: string; type: "unsupported-setting" }
+            | { details?: string; tool: any; type: "unsupported-tool" }
+            | { message: string; type: "other" }
+          >;
+        },
+        Name
+      >;
+    };
+    streams: {
+      abort: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          finalDelta?: {
+            end: number;
+            parts: Array<any>;
+            start: number;
+            streamId: string;
+          };
+          reason: string;
+          streamId: string;
+        },
+        boolean,
+        Name
+      >;
+      abortByOrder: FunctionReference<
+        "mutation",
+        "internal",
+        { order: number; reason: string; threadId: string },
+        boolean,
+        Name
+      >;
+      addDelta: FunctionReference<
+        "mutation",
+        "internal",
+        { end: number; parts: Array<any>; start: number; streamId: string },
+        boolean,
+        Name
+      >;
+      create: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          agentName?: string;
+          format?: "UIMessageChunk" | "TextStreamPart";
+          model?: string;
+          order: number;
+          provider?: string;
+          providerOptions?: Record<string, Record<string, any>>;
+          stepOrder: number;
+          threadId: string;
+          userId?: string;
+        },
+        string,
+        Name
+      >;
+      deleteAllStreamsForThreadIdAsync: FunctionReference<
+        "mutation",
+        "internal",
+        { deltaCursor?: string; streamOrder?: number; threadId: string },
+        { deltaCursor?: string; isDone: boolean; streamOrder?: number },
+        Name
+      >;
+      deleteAllStreamsForThreadIdSync: FunctionReference<
+        "action",
+        "internal",
+        { threadId: string },
+        null,
+        Name
+      >;
+      deleteStreamAsync: FunctionReference<
+        "mutation",
+        "internal",
+        { cursor?: string; streamId: string },
+        null,
+        Name
+      >;
+      deleteStreamSync: FunctionReference<
+        "mutation",
+        "internal",
+        { streamId: string },
+        null,
+        Name
+      >;
+      finish: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          finalDelta?: {
+            end: number;
+            parts: Array<any>;
+            start: number;
+            streamId: string;
+          };
+          streamId: string;
+        },
+        null,
+        Name
+      >;
+      heartbeat: FunctionReference<
+        "mutation",
+        "internal",
+        { streamId: string },
+        null,
+        Name
+      >;
+      list: FunctionReference<
+        "query",
+        "internal",
+        {
+          startOrder?: number;
+          statuses?: Array<"streaming" | "finished" | "aborted">;
+          threadId: string;
+        },
+        Array<{
+          agentName?: string;
+          format?: "UIMessageChunk" | "TextStreamPart";
+          model?: string;
+          order: number;
+          provider?: string;
+          providerOptions?: Record<string, Record<string, any>>;
+          status: "streaming" | "finished" | "aborted";
+          stepOrder: number;
+          streamId: string;
+          userId?: string;
+        }>,
+        Name
+      >;
+      listDeltas: FunctionReference<
+        "query",
+        "internal",
+        {
+          cursors: Array<{ cursor: number; streamId: string }>;
+          threadId: string;
+        },
+        Array<{
+          end: number;
+          parts: Array<any>;
+          start: number;
+          streamId: string;
+        }>,
+        Name
+      >;
+    };
+    threads: {
+      createThread: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          defaultSystemPrompt?: string;
+          parentThreadIds?: Array<string>;
+          summary?: string;
+          title?: string;
+          userId?: string;
+        },
+        {
+          _creationTime: number;
+          _id: string;
+          status: "active" | "archived";
+          summary?: string;
+          title?: string;
+          userId?: string;
+        },
+        Name
+      >;
+      deleteAllForThreadIdAsync: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          cursor?: string;
+          deltaCursor?: string;
+          limit?: number;
+          messagesDone?: boolean;
+          streamOrder?: number;
+          streamsDone?: boolean;
+          threadId: string;
+        },
+        { isDone: boolean },
+        Name
+      >;
+      deleteAllForThreadIdSync: FunctionReference<
+        "action",
+        "internal",
+        { limit?: number; threadId: string },
+        null,
+        Name
+      >;
+      getThread: FunctionReference<
+        "query",
+        "internal",
+        { threadId: string },
+        {
+          _creationTime: number;
+          _id: string;
+          status: "active" | "archived";
+          summary?: string;
+          title?: string;
+          userId?: string;
+        } | null,
+        Name
+      >;
+      listThreadsByUserId: FunctionReference<
+        "query",
+        "internal",
+        {
+          order?: "asc" | "desc";
+          paginationOpts?: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
+          userId?: string;
+        },
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            status: "active" | "archived";
+            summary?: string;
+            title?: string;
+            userId?: string;
+          }>;
+          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+          splitCursor?: string | null;
+        },
+        Name
+      >;
+      searchThreadTitles: FunctionReference<
+        "query",
+        "internal",
+        { limit: number; query: string; userId?: string | null },
+        Array<{
+          _creationTime: number;
+          _id: string;
+          status: "active" | "archived";
+          summary?: string;
+          title?: string;
+          userId?: string;
+        }>,
+        Name
+      >;
+      updateThread: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          patch: {
+            status?: "active" | "archived";
+            summary?: string;
+            title?: string;
+            userId?: string;
+          };
+          threadId: string;
+        },
+        {
+          _creationTime: number;
+          _id: string;
+          status: "active" | "archived";
+          summary?: string;
+          title?: string;
+          userId?: string;
+        },
+        Name
+      >;
+    };
+    users: {
+      deleteAllForUserId: FunctionReference<
+        "action",
+        "internal",
+        { userId: string },
+        null,
+        Name
+      >;
+      deleteAllForUserIdAsync: FunctionReference<
+        "mutation",
+        "internal",
+        { userId: string },
+        boolean,
+        Name
+      >;
+      listUsersWithThreads: FunctionReference<
+        "query",
+        "internal",
+        {
+          paginationOpts: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
+        },
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<string>;
+          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+          splitCursor?: string | null;
+        },
+        Name
+      >;
+    };
+    vector: {
+      index: {
+        deleteBatch: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            ids: Array<
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+            >;
+          },
+          null,
+          Name
+        >;
+        deleteBatchForThread: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            cursor?: string;
+            limit: number;
+            model: string;
+            threadId: string;
+            vectorDimension:
+              | 128
+              | 256
+              | 512
+              | 768
+              | 1024
+              | 1408
+              | 1536
+              | 2048
+              | 3072
+              | 4096;
+          },
+          { continueCursor: string; isDone: boolean },
+          Name
+        >;
+        insertBatch: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            vectorDimension:
+              | 128
+              | 256
+              | 512
+              | 768
+              | 1024
+              | 1408
+              | 1536
+              | 2048
+              | 3072
+              | 4096;
+            vectors: Array<{
+              messageId?: string;
+              model: string;
+              table: string;
+              threadId?: string;
+              userId?: string;
+              vector: Array<number>;
+            }>;
+          },
+          Array<
+            | string
+            | string
+            | string
+            | string
+            | string
+            | string
+            | string
+            | string
+            | string
+            | string
+          >,
+          Name
+        >;
+        paginate: FunctionReference<
+          "query",
+          "internal",
+          {
+            cursor?: string;
+            limit: number;
+            table?: string;
+            targetModel: string;
+            vectorDimension:
+              | 128
+              | 256
+              | 512
+              | 768
+              | 1024
+              | 1408
+              | 1536
+              | 2048
+              | 3072
+              | 4096;
+          },
+          {
+            continueCursor: string;
+            ids: Array<
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+            >;
+            isDone: boolean;
+          },
+          Name
+        >;
+        updateBatch: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            vectors: Array<{
+              id:
+                | string
+                | string
+                | string
+                | string
+                | string
+                | string
+                | string
+                | string
+                | string
+                | string;
+              model: string;
+              vector: Array<number>;
+            }>;
+          },
+          null,
+          Name
+        >;
+      };
+    };
+  };
diff --git a/src/mapping.ts b/src/mapping.ts
index 4bb91659..c2d179c0 100644
--- a/src/mapping.ts
+++ b/src/mapping.ts
@@ -353,12 +353,13 @@ export async function serializeContent(
           } satisfies Infer<typeof vFilePart>;
         }
         case "tool-call": {
-          const input = part.input ?? (part as any)?.args;
+          // Handle legacy data where only args field exists
+          const input = part.input ?? (part as any)?.args ?? {};
           return {
             type: part.type,
-            input: input ?? null,
+            input,
             /** @deprecated Use `input` instead. */
-            args: input ?? null,
+            args: input,
             toolCallId: part.toolCallId,
             toolName: part.toolName,
             providerExecuted: part.providerExecuted,
@@ -432,11 +433,12 @@ export function fromModelMessageContent(content: Content): Message["content"] {
             ...metadata,
           } satisfies Infer<typeof vFilePart>;
         case "tool-call":
+          // Handle legacy data where only args field exists
           return {
             type: part.type,
-            input: part.input ?? null,
+            input: part.input ?? (part as any)?.args ?? {},
             /** @deprecated Use `input` instead. */
-            args: part.input ?? null,
+            args: part.input ?? (part as any)?.args ?? {},
             toolCallId: part.toolCallId,
             toolName: part.toolName,
             providerExecuted: part.providerExecuted,
@@ -515,10 +517,11 @@ export function toModelMessageContent(
             ...metadata,
           } satisfies FilePart;
         case "tool-call": {
-          const input = part.input ?? (part as any)?.args;
+          // Handle legacy data where only args field exists
+          const input = part.input ?? (part as any)?.args ?? {};
           return {
             type: part.type,
-            input: input ?? null,
+            input,
             toolCallId: part.toolCallId,
             toolName: part.toolName,
             providerExecuted: part.providerExecuted,

From 7d85495000530e0d71774072793bad3d7a44f6e4 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 22:27:49 +0000
Subject: [PATCH 13/26] Remove backup file

---
 src/component/_generated/component.ts.bak | 2941 ---------------------
 1 file changed, 2941 deletions(-)
 delete mode 100644 src/component/_generated/component.ts.bak

diff --git a/src/component/_generated/component.ts.bak b/src/component/_generated/component.ts.bak
deleted file mode 100644
index 7ee22d7d..00000000
--- a/src/component/_generated/component.ts.bak
+++ /dev/null
@@ -1,2941 +0,0 @@
-/* eslint-disable */
-/**
- * Generated `ComponentApi` utility.
- *
- * THIS CODE IS AUTOMATICALLY GENERATED.
- *
- * To regenerate, run `npx convex dev`.
- * @module
- */
-
-import type { FunctionReference } from "convex/server";
-
-/**
- * A utility for referencing a Convex component's exposed API.
- *
- * Useful when expecting a parameter like `components.myComponent`.
- * Usage:
- * ```ts
- * async function myFunction(ctx: QueryCtx, component: ComponentApi) {
- *   return ctx.runQuery(component.someFile.someQuery, { ...args });
- * }
- * ```
- */
-export type ComponentApi<Name extends string | undefined = string | undefined> =
-  {
-    apiKeys: {
-      destroy: FunctionReference<
-        "mutation",
-        "internal",
-        { apiKey?: string; name?: string },
-        | "missing"
-        | "deleted"
-        | "name mismatch"
-        | "must provide either apiKey or name",
-        Name
-      >;
-      issue: FunctionReference<
-        "mutation",
-        "internal",
-        { name?: string },
-        string,
-        Name
-      >;
-      validate: FunctionReference<
-        "query",
-        "internal",
-        { apiKey: string },
-        boolean,
-        Name
-      >;
-    };
-    files: {
-      addFile: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          filename?: string;
-          hash: string;
-          mediaType?: string;
-          mimeType?: string;
-          storageId: string;
-        },
-        { fileId: string; storageId: string },
-        Name
-      >;
-      copyFile: FunctionReference<
-        "mutation",
-        "internal",
-        { fileId: string },
-        null,
-        Name
-      >;
-      deleteFiles: FunctionReference<
-        "mutation",
-        "internal",
-        { fileIds: Array<string>; force?: boolean },
-        Array<string>,
-        Name
-      >;
-      get: FunctionReference<
-        "query",
-        "internal",
-        { fileId: string },
-        null | {
-          _creationTime: number;
-          _id: string;
-          filename?: string;
-          hash: string;
-          lastTouchedAt: number;
-          mediaType?: string;
-          mimeType?: string;
-          refcount: number;
-          storageId: string;
-        },
-        Name
-      >;
-      getFilesToDelete: FunctionReference<
-        "query",
-        "internal",
-        {
-          paginationOpts: {
-            cursor: string | null;
-            endCursor?: string | null;
-            id?: number;
-            maximumBytesRead?: number;
-            maximumRowsRead?: number;
-            numItems: number;
-          };
-        },
-        {
-          continueCursor: string;
-          isDone: boolean;
-          page: Array<{
-            _creationTime: number;
-            _id: string;
-            filename?: string;
-            hash: string;
-            lastTouchedAt: number;
-            mediaType?: string;
-            mimeType?: string;
-            refcount: number;
-            storageId: string;
-          }>;
-        },
-        Name
-      >;
-      useExistingFile: FunctionReference<
-        "mutation",
-        "internal",
-        { filename?: string; hash: string },
-        null | { fileId: string; storageId: string },
-        Name
-      >;
-    };
-    messages: {
-      addMessages: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          agentName?: string;
-          embeddings?: {
-            dimension:
-              | 128
-              | 256
-              | 512
-              | 768
-              | 1024
-              | 1408
-              | 1536
-              | 2048
-              | 3072
-              | 4096;
-            model: string;
-            vectors: Array<Array<number> | null>;
-          };
-          failPendingSteps?: boolean;
-          hideFromUserIdSearch?: boolean;
-          messages: Array<{
-            error?: string;
-            fileIds?: Array<string>;
-            finishReason?:
-              | "stop"
-              | "length"
-              | "content-filter"
-              | "tool-calls"
-              | "error"
-              | "other"
-              | "unknown";
-            message:
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            image: string | ArrayBuffer;
-                            mimeType?: string;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "image";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "user";
-                }
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            signature?: string;
-                            text: string;
-                            type: "reasoning";
-                          }
-                        | {
-                            data: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "redacted-reasoning";
-                          }
-                        | {
-                            args: any;
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-call";
-                          }
-                        | {
-                            args?: any;
-                            experimental_content?: Array<
-                              | { text: string; type: "text" }
-                              | {
-                                  data: string;
-                                  mimeType?: string;
-                                  type: "image";
-                                }
-                            >;
-                            isError?: boolean;
-                            output?:
-                              | { type: "text"; value: string }
-                              | { type: "json"; value: any }
-                              | { type: "error-text"; value: string }
-                              | { type: "error-json"; value: any }
-                              | {
-                                  type: "content";
-                                  value: Array<
-                                    | { text: string; type: "text" }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        type: "media";
-                                      }
-                                  >;
-                                };
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            result?: any;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-result";
-                          }
-                        | {
-                            id: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "url";
-                            title?: string;
-                            type: "source";
-                            url: string;
-                          }
-                        | {
-                            filename?: string;
-                            id: string;
-                            mediaType: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "document";
-                            title: string;
-                            type: "source";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "assistant";
-                }
-              | {
-                  content: Array<{
-                    args?: any;
-                    experimental_content?: Array<
-                      | { text: string; type: "text" }
-                      | { data: string; mimeType?: string; type: "image" }
-                    >;
-                    isError?: boolean;
-                    output?:
-                      | { type: "text"; value: string }
-                      | { type: "json"; value: any }
-                      | { type: "error-text"; value: string }
-                      | { type: "error-json"; value: any }
-                      | {
-                          type: "content";
-                          value: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mediaType: string; type: "media" }
-                          >;
-                        };
-                    providerExecuted?: boolean;
-                    providerMetadata?: Record<string, Record<string, any>>;
-                    providerOptions?: Record<string, Record<string, any>>;
-                    result?: any;
-                    toolCallId: string;
-                    toolName: string;
-                    type: "tool-result";
-                  }>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "tool";
-                }
-              | {
-                  content: string;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "system";
-                };
-            model?: string;
-            provider?: string;
-            providerMetadata?: Record<string, Record<string, any>>;
-            reasoning?: string;
-            reasoningDetails?: Array<
-              | {
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  signature?: string;
-                  text: string;
-                  type: "reasoning";
-                }
-              | { signature?: string; text: string; type: "text" }
-              | { data: string; type: "redacted" }
-            >;
-            sources?: Array<
-              | {
-                  id: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "url";
-                  title?: string;
-                  type?: "source";
-                  url: string;
-                }
-              | {
-                  filename?: string;
-                  id: string;
-                  mediaType: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "document";
-                  title: string;
-                  type: "source";
-                }
-            >;
-            status?: "pending" | "success" | "failed";
-            text?: string;
-            usage?: {
-              cachedInputTokens?: number;
-              completionTokens: number;
-              promptTokens: number;
-              reasoningTokens?: number;
-              totalTokens: number;
-            };
-            warnings?: Array<
-              | {
-                  details?: string;
-                  setting: string;
-                  type: "unsupported-setting";
-                }
-              | { details?: string; tool: any; type: "unsupported-tool" }
-              | { message: string; type: "other" }
-            >;
-          }>;
-          pendingMessageId?: string;
-          promptMessageId?: string;
-          threadId: string;
-          userId?: string;
-        },
-        {
-          messages: Array<{
-            _creationTime: number;
-            _id: string;
-            agentName?: string;
-            embeddingId?: string;
-            error?: string;
-            fileIds?: Array<string>;
-            finishReason?:
-              | "stop"
-              | "length"
-              | "content-filter"
-              | "tool-calls"
-              | "error"
-              | "other"
-              | "unknown";
-            id?: string;
-            message?:
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            image: string | ArrayBuffer;
-                            mimeType?: string;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "image";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "user";
-                }
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            signature?: string;
-                            text: string;
-                            type: "reasoning";
-                          }
-                        | {
-                            data: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "redacted-reasoning";
-                          }
-                        | {
-                            args: any;
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-call";
-                          }
-                        | {
-                            args?: any;
-                            experimental_content?: Array<
-                              | { text: string; type: "text" }
-                              | {
-                                  data: string;
-                                  mimeType?: string;
-                                  type: "image";
-                                }
-                            >;
-                            isError?: boolean;
-                            output?:
-                              | { type: "text"; value: string }
-                              | { type: "json"; value: any }
-                              | { type: "error-text"; value: string }
-                              | { type: "error-json"; value: any }
-                              | {
-                                  type: "content";
-                                  value: Array<
-                                    | { text: string; type: "text" }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        type: "media";
-                                      }
-                                  >;
-                                };
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            result?: any;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-result";
-                          }
-                        | {
-                            id: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "url";
-                            title?: string;
-                            type: "source";
-                            url: string;
-                          }
-                        | {
-                            filename?: string;
-                            id: string;
-                            mediaType: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "document";
-                            title: string;
-                            type: "source";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "assistant";
-                }
-              | {
-                  content: Array<{
-                    args?: any;
-                    experimental_content?: Array<
-                      | { text: string; type: "text" }
-                      | { data: string; mimeType?: string; type: "image" }
-                    >;
-                    isError?: boolean;
-                    output?:
-                      | { type: "text"; value: string }
-                      | { type: "json"; value: any }
-                      | { type: "error-text"; value: string }
-                      | { type: "error-json"; value: any }
-                      | {
-                          type: "content";
-                          value: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mediaType: string; type: "media" }
-                          >;
-                        };
-                    providerExecuted?: boolean;
-                    providerMetadata?: Record<string, Record<string, any>>;
-                    providerOptions?: Record<string, Record<string, any>>;
-                    result?: any;
-                    toolCallId: string;
-                    toolName: string;
-                    type: "tool-result";
-                  }>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "tool";
-                }
-              | {
-                  content: string;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "system";
-                };
-            model?: string;
-            order: number;
-            provider?: string;
-            providerMetadata?: Record<string, Record<string, any>>;
-            providerOptions?: Record<string, Record<string, any>>;
-            reasoning?: string;
-            reasoningDetails?: Array<
-              | {
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  signature?: string;
-                  text: string;
-                  type: "reasoning";
-                }
-              | { signature?: string; text: string; type: "text" }
-              | { data: string; type: "redacted" }
-            >;
-            sources?: Array<
-              | {
-                  id: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "url";
-                  title?: string;
-                  type?: "source";
-                  url: string;
-                }
-              | {
-                  filename?: string;
-                  id: string;
-                  mediaType: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "document";
-                  title: string;
-                  type: "source";
-                }
-            >;
-            status: "pending" | "success" | "failed";
-            stepOrder: number;
-            text?: string;
-            threadId: string;
-            tool: boolean;
-            usage?: {
-              cachedInputTokens?: number;
-              completionTokens: number;
-              promptTokens: number;
-              reasoningTokens?: number;
-              totalTokens: number;
-            };
-            userId?: string;
-            warnings?: Array<
-              | {
-                  details?: string;
-                  setting: string;
-                  type: "unsupported-setting";
-                }
-              | { details?: string; tool: any; type: "unsupported-tool" }
-              | { message: string; type: "other" }
-            >;
-          }>;
-        },
-        Name
-      >;
-      cloneThread: FunctionReference<
-        "action",
-        "internal",
-        {
-          batchSize?: number;
-          copyUserIdForVectorSearch?: boolean;
-          excludeToolMessages?: boolean;
-          insertAtOrder?: number;
-          limit?: number;
-          sourceThreadId: string;
-          statuses?: Array<"pending" | "success" | "failed">;
-          targetThreadId: string;
-          upToAndIncludingMessageId?: string;
-        },
-        number,
-        Name
-      >;
-      deleteByIds: FunctionReference<
-        "mutation",
-        "internal",
-        { messageIds: Array<string> },
-        Array<string>,
-        Name
-      >;
-      deleteByOrder: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          endOrder: number;
-          endStepOrder?: number;
-          startOrder: number;
-          startStepOrder?: number;
-          threadId: string;
-        },
-        { isDone: boolean; lastOrder?: number; lastStepOrder?: number },
-        Name
-      >;
-      finalizeMessage: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          messageId: string;
-          result: { status: "success" } | { error: string; status: "failed" };
-        },
-        null,
-        Name
-      >;
-      getMessagesByIds: FunctionReference<
-        "query",
-        "internal",
-        { messageIds: Array<string> },
-        Array<null | {
-          _creationTime: number;
-          _id: string;
-          agentName?: string;
-          embeddingId?: string;
-          error?: string;
-          fileIds?: Array<string>;
-          finishReason?:
-            | "stop"
-            | "length"
-            | "content-filter"
-            | "tool-calls"
-            | "error"
-            | "other"
-            | "unknown";
-          id?: string;
-          message?:
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          image: string | ArrayBuffer;
-                          mimeType?: string;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "image";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                            mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "user";
-              }
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                            mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          signature?: string;
-                          text: string;
-                          type: "reasoning";
-                        }
-                      | {
-                          data: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "redacted-reasoning";
-                        }
-                      | {
-                          args: any;
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-call";
-                        }
-                      | {
-                          args?: any;
-                          experimental_content?: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mimeType?: string; type: "image" }
-                          >;
-                          isError?: boolean;
-                          output?:
-                            | { type: "text"; value: string }
-                            | { type: "json"; value: any }
-                            | { type: "error-text"; value: string }
-                            | { type: "error-json"; value: any }
-                            | {
-                                type: "content";
-                                value: Array<
-                                  | { text: string; type: "text" }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      type: "media";
-                                    }
-                                >;
-                              };
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          result?: any;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-result";
-                        }
-                      | {
-                          id: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "url";
-                          title?: string;
-                          type: "source";
-                          url: string;
-                        }
-                      | {
-                          filename?: string;
-                          id: string;
-                          mediaType: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "document";
-                          title: string;
-                          type: "source";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "assistant";
-              }
-            | {
-                content: Array<{
-                  args?: any;
-                  experimental_content?: Array<
-                    | { text: string; type: "text" }
-                    | { data: string; mimeType?: string; type: "image" }
-                  >;
-                  isError?: boolean;
-                  output?:
-                    | { type: "text"; value: string }
-                    | { type: "json"; value: any }
-                    | { type: "error-text"; value: string }
-                    | { type: "error-json"; value: any }
-                    | {
-                        type: "content";
-                        value: Array<
-                          | { text: string; type: "text" }
-                          | { data: string; mediaType: string; type: "media" }
-                        >;
-                      };
-                  providerExecuted?: boolean;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  result?: any;
-                  toolCallId: string;
-                  toolName: string;
-                  type: "tool-result";
-                }>;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "tool";
-              }
-            | {
-                content: string;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "system";
-              };
-          model?: string;
-          order: number;
-          provider?: string;
-          providerMetadata?: Record<string, Record<string, any>>;
-          providerOptions?: Record<string, Record<string, any>>;
-          reasoning?: string;
-          reasoningDetails?: Array<
-            | {
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                signature?: string;
-                text: string;
-                type: "reasoning";
-              }
-            | { signature?: string; text: string; type: "text" }
-            | { data: string; type: "redacted" }
-          >;
-          sources?: Array<
-            | {
-                id: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "url";
-                title?: string;
-                type?: "source";
-                url: string;
-              }
-            | {
-                filename?: string;
-                id: string;
-                mediaType: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "document";
-                title: string;
-                type: "source";
-              }
-          >;
-          status: "pending" | "success" | "failed";
-          stepOrder: number;
-          text?: string;
-          threadId: string;
-          tool: boolean;
-          usage?: {
-            cachedInputTokens?: number;
-            completionTokens: number;
-            promptTokens: number;
-            reasoningTokens?: number;
-            totalTokens: number;
-          };
-          userId?: string;
-          warnings?: Array<
-            | { details?: string; setting: string; type: "unsupported-setting" }
-            | { details?: string; tool: any; type: "unsupported-tool" }
-            | { message: string; type: "other" }
-          >;
-        }>,
-        Name
-      >;
-      getMessageSearchFields: FunctionReference<
-        "query",
-        "internal",
-        { messageId: string },
-        { embedding?: Array<number>; embeddingModel?: string; text?: string },
-        Name
-      >;
-      listMessagesByThreadId: FunctionReference<
-        "query",
-        "internal",
-        {
-          excludeToolMessages?: boolean;
-          order: "asc" | "desc";
-          paginationOpts?: {
-            cursor: string | null;
-            endCursor?: string | null;
-            id?: number;
-            maximumBytesRead?: number;
-            maximumRowsRead?: number;
-            numItems: number;
-          };
-          statuses?: Array<"pending" | "success" | "failed">;
-          threadId: string;
-          upToAndIncludingMessageId?: string;
-        },
-        {
-          continueCursor: string;
-          isDone: boolean;
-          page: Array<{
-            _creationTime: number;
-            _id: string;
-            agentName?: string;
-            embeddingId?: string;
-            error?: string;
-            fileIds?: Array<string>;
-            finishReason?:
-              | "stop"
-              | "length"
-              | "content-filter"
-              | "tool-calls"
-              | "error"
-              | "other"
-              | "unknown";
-            id?: string;
-            message?:
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            image: string | ArrayBuffer;
-                            mimeType?: string;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "image";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "user";
-                }
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            signature?: string;
-                            text: string;
-                            type: "reasoning";
-                          }
-                        | {
-                            data: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "redacted-reasoning";
-                          }
-                        | {
-                            args: any;
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-call";
-                          }
-                        | {
-                            args?: any;
-                            experimental_content?: Array<
-                              | { text: string; type: "text" }
-                              | {
-                                  data: string;
-                                  mimeType?: string;
-                                  type: "image";
-                                }
-                            >;
-                            isError?: boolean;
-                            output?:
-                              | { type: "text"; value: string }
-                              | { type: "json"; value: any }
-                              | { type: "error-text"; value: string }
-                              | { type: "error-json"; value: any }
-                              | {
-                                  type: "content";
-                                  value: Array<
-                                    | { text: string; type: "text" }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        type: "media";
-                                      }
-                                  >;
-                                };
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            result?: any;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-result";
-                          }
-                        | {
-                            id: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "url";
-                            title?: string;
-                            type: "source";
-                            url: string;
-                          }
-                        | {
-                            filename?: string;
-                            id: string;
-                            mediaType: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "document";
-                            title: string;
-                            type: "source";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "assistant";
-                }
-              | {
-                  content: Array<{
-                    args?: any;
-                    experimental_content?: Array<
-                      | { text: string; type: "text" }
-                      | { data: string; mimeType?: string; type: "image" }
-                    >;
-                    isError?: boolean;
-                    output?:
-                      | { type: "text"; value: string }
-                      | { type: "json"; value: any }
-                      | { type: "error-text"; value: string }
-                      | { type: "error-json"; value: any }
-                      | {
-                          type: "content";
-                          value: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mediaType: string; type: "media" }
-                          >;
-                        };
-                    providerExecuted?: boolean;
-                    providerMetadata?: Record<string, Record<string, any>>;
-                    providerOptions?: Record<string, Record<string, any>>;
-                    result?: any;
-                    toolCallId: string;
-                    toolName: string;
-                    type: "tool-result";
-                  }>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "tool";
-                }
-              | {
-                  content: string;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "system";
-                };
-            model?: string;
-            order: number;
-            provider?: string;
-            providerMetadata?: Record<string, Record<string, any>>;
-            providerOptions?: Record<string, Record<string, any>>;
-            reasoning?: string;
-            reasoningDetails?: Array<
-              | {
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  signature?: string;
-                  text: string;
-                  type: "reasoning";
-                }
-              | { signature?: string; text: string; type: "text" }
-              | { data: string; type: "redacted" }
-            >;
-            sources?: Array<
-              | {
-                  id: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "url";
-                  title?: string;
-                  type?: "source";
-                  url: string;
-                }
-              | {
-                  filename?: string;
-                  id: string;
-                  mediaType: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "document";
-                  title: string;
-                  type: "source";
-                }
-            >;
-            status: "pending" | "success" | "failed";
-            stepOrder: number;
-            text?: string;
-            threadId: string;
-            tool: boolean;
-            usage?: {
-              cachedInputTokens?: number;
-              completionTokens: number;
-              promptTokens: number;
-              reasoningTokens?: number;
-              totalTokens: number;
-            };
-            userId?: string;
-            warnings?: Array<
-              | {
-                  details?: string;
-                  setting: string;
-                  type: "unsupported-setting";
-                }
-              | { details?: string; tool: any; type: "unsupported-tool" }
-              | { message: string; type: "other" }
-            >;
-          }>;
-          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
-          splitCursor?: string | null;
-        },
-        Name
-      >;
-      searchMessages: FunctionReference<
-        "action",
-        "internal",
-        {
-          embedding?: Array<number>;
-          embeddingModel?: string;
-          limit: number;
-          messageRange?: { after: number; before: number };
-          searchAllMessagesForUserId?: string;
-          targetMessageId?: string;
-          text?: string;
-          textSearch?: boolean;
-          threadId?: string;
-          vectorScoreThreshold?: number;
-          vectorSearch?: boolean;
-        },
-        Array<{
-          _creationTime: number;
-          _id: string;
-          agentName?: string;
-          embeddingId?: string;
-          error?: string;
-          fileIds?: Array<string>;
-          finishReason?:
-            | "stop"
-            | "length"
-            | "content-filter"
-            | "tool-calls"
-            | "error"
-            | "other"
-            | "unknown";
-          id?: string;
-          message?:
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          image: string | ArrayBuffer;
-                          mimeType?: string;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "image";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                            mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "user";
-              }
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                            mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          signature?: string;
-                          text: string;
-                          type: "reasoning";
-                        }
-                      | {
-                          data: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "redacted-reasoning";
-                        }
-                      | {
-                          args: any;
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-call";
-                        }
-                      | {
-                          args?: any;
-                          experimental_content?: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mimeType?: string; type: "image" }
-                          >;
-                          isError?: boolean;
-                          output?:
-                            | { type: "text"; value: string }
-                            | { type: "json"; value: any }
-                            | { type: "error-text"; value: string }
-                            | { type: "error-json"; value: any }
-                            | {
-                                type: "content";
-                                value: Array<
-                                  | { text: string; type: "text" }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      type: "media";
-                                    }
-                                >;
-                              };
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          result?: any;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-result";
-                        }
-                      | {
-                          id: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "url";
-                          title?: string;
-                          type: "source";
-                          url: string;
-                        }
-                      | {
-                          filename?: string;
-                          id: string;
-                          mediaType: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "document";
-                          title: string;
-                          type: "source";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "assistant";
-              }
-            | {
-                content: Array<{
-                  args?: any;
-                  experimental_content?: Array<
-                    | { text: string; type: "text" }
-                    | { data: string; mimeType?: string; type: "image" }
-                  >;
-                  isError?: boolean;
-                  output?:
-                    | { type: "text"; value: string }
-                    | { type: "json"; value: any }
-                    | { type: "error-text"; value: string }
-                    | { type: "error-json"; value: any }
-                    | {
-                        type: "content";
-                        value: Array<
-                          | { text: string; type: "text" }
-                          | { data: string; mediaType: string; type: "media" }
-                        >;
-                      };
-                  providerExecuted?: boolean;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  result?: any;
-                  toolCallId: string;
-                  toolName: string;
-                  type: "tool-result";
-                }>;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "tool";
-              }
-            | {
-                content: string;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "system";
-              };
-          model?: string;
-          order: number;
-          provider?: string;
-          providerMetadata?: Record<string, Record<string, any>>;
-          providerOptions?: Record<string, Record<string, any>>;
-          reasoning?: string;
-          reasoningDetails?: Array<
-            | {
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                signature?: string;
-                text: string;
-                type: "reasoning";
-              }
-            | { signature?: string; text: string; type: "text" }
-            | { data: string; type: "redacted" }
-          >;
-          sources?: Array<
-            | {
-                id: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "url";
-                title?: string;
-                type?: "source";
-                url: string;
-              }
-            | {
-                filename?: string;
-                id: string;
-                mediaType: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "document";
-                title: string;
-                type: "source";
-              }
-          >;
-          status: "pending" | "success" | "failed";
-          stepOrder: number;
-          text?: string;
-          threadId: string;
-          tool: boolean;
-          usage?: {
-            cachedInputTokens?: number;
-            completionTokens: number;
-            promptTokens: number;
-            reasoningTokens?: number;
-            totalTokens: number;
-          };
-          userId?: string;
-          warnings?: Array<
-            | { details?: string; setting: string; type: "unsupported-setting" }
-            | { details?: string; tool: any; type: "unsupported-tool" }
-            | { message: string; type: "other" }
-          >;
-        }>,
-        Name
-      >;
-      textSearch: FunctionReference<
-        "query",
-        "internal",
-        {
-          limit: number;
-          searchAllMessagesForUserId?: string;
-          targetMessageId?: string;
-          text?: string;
-          threadId?: string;
-        },
-        Array<{
-          _creationTime: number;
-          _id: string;
-          agentName?: string;
-          embeddingId?: string;
-          error?: string;
-          fileIds?: Array<string>;
-          finishReason?:
-            | "stop"
-            | "length"
-            | "content-filter"
-            | "tool-calls"
-            | "error"
-            | "other"
-            | "unknown";
-          id?: string;
-          message?:
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          image: string | ArrayBuffer;
-                          mimeType?: string;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "image";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                            mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "user";
-              }
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                            mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          signature?: string;
-                          text: string;
-                          type: "reasoning";
-                        }
-                      | {
-                          data: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "redacted-reasoning";
-                        }
-                      | {
-                          args: any;
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-call";
-                        }
-                      | {
-                          args?: any;
-                          experimental_content?: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mimeType?: string; type: "image" }
-                          >;
-                          isError?: boolean;
-                          output?:
-                            | { type: "text"; value: string }
-                            | { type: "json"; value: any }
-                            | { type: "error-text"; value: string }
-                            | { type: "error-json"; value: any }
-                            | {
-                                type: "content";
-                                value: Array<
-                                  | { text: string; type: "text" }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      type: "media";
-                                    }
-                                >;
-                              };
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          result?: any;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-result";
-                        }
-                      | {
-                          id: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "url";
-                          title?: string;
-                          type: "source";
-                          url: string;
-                        }
-                      | {
-                          filename?: string;
-                          id: string;
-                          mediaType: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "document";
-                          title: string;
-                          type: "source";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "assistant";
-              }
-            | {
-                content: Array<{
-                  args?: any;
-                  experimental_content?: Array<
-                    | { text: string; type: "text" }
-                    | { data: string; mimeType?: string; type: "image" }
-                  >;
-                  isError?: boolean;
-                  output?:
-                    | { type: "text"; value: string }
-                    | { type: "json"; value: any }
-                    | { type: "error-text"; value: string }
-                    | { type: "error-json"; value: any }
-                    | {
-                        type: "content";
-                        value: Array<
-                          | { text: string; type: "text" }
-                          | { data: string; mediaType: string; type: "media" }
-                        >;
-                      };
-                  providerExecuted?: boolean;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  result?: any;
-                  toolCallId: string;
-                  toolName: string;
-                  type: "tool-result";
-                }>;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "tool";
-              }
-            | {
-                content: string;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "system";
-              };
-          model?: string;
-          order: number;
-          provider?: string;
-          providerMetadata?: Record<string, Record<string, any>>;
-          providerOptions?: Record<string, Record<string, any>>;
-          reasoning?: string;
-          reasoningDetails?: Array<
-            | {
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                signature?: string;
-                text: string;
-                type: "reasoning";
-              }
-            | { signature?: string; text: string; type: "text" }
-            | { data: string; type: "redacted" }
-          >;
-          sources?: Array<
-            | {
-                id: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "url";
-                title?: string;
-                type?: "source";
-                url: string;
-              }
-            | {
-                filename?: string;
-                id: string;
-                mediaType: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "document";
-                title: string;
-                type: "source";
-              }
-          >;
-          status: "pending" | "success" | "failed";
-          stepOrder: number;
-          text?: string;
-          threadId: string;
-          tool: boolean;
-          usage?: {
-            cachedInputTokens?: number;
-            completionTokens: number;
-            promptTokens: number;
-            reasoningTokens?: number;
-            totalTokens: number;
-          };
-          userId?: string;
-          warnings?: Array<
-            | { details?: string; setting: string; type: "unsupported-setting" }
-            | { details?: string; tool: any; type: "unsupported-tool" }
-            | { message: string; type: "other" }
-          >;
-        }>,
-        Name
-      >;
-      updateMessage: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          messageId: string;
-          patch: {
-            error?: string;
-            fileIds?: Array<string>;
-            finishReason?:
-              | "stop"
-              | "length"
-              | "content-filter"
-              | "tool-calls"
-              | "error"
-              | "other"
-              | "unknown";
-            message?:
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            image: string | ArrayBuffer;
-                            mimeType?: string;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "image";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "user";
-                }
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            signature?: string;
-                            text: string;
-                            type: "reasoning";
-                          }
-                        | {
-                            data: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "redacted-reasoning";
-                          }
-                        | {
-                            args: any;
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-call";
-                          }
-                        | {
-                            args?: any;
-                            experimental_content?: Array<
-                              | { text: string; type: "text" }
-                              | {
-                                  data: string;
-                                  mimeType?: string;
-                                  type: "image";
-                                }
-                            >;
-                            isError?: boolean;
-                            output?:
-                              | { type: "text"; value: string }
-                              | { type: "json"; value: any }
-                              | { type: "error-text"; value: string }
-                              | { type: "error-json"; value: any }
-                              | {
-                                  type: "content";
-                                  value: Array<
-                                    | { text: string; type: "text" }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        type: "media";
-                                      }
-                                  >;
-                                };
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            result?: any;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-result";
-                          }
-                        | {
-                            id: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "url";
-                            title?: string;
-                            type: "source";
-                            url: string;
-                          }
-                        | {
-                            filename?: string;
-                            id: string;
-                            mediaType: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "document";
-                            title: string;
-                            type: "source";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "assistant";
-                }
-              | {
-                  content: Array<{
-                    args?: any;
-                    experimental_content?: Array<
-                      | { text: string; type: "text" }
-                      | { data: string; mimeType?: string; type: "image" }
-                    >;
-                    isError?: boolean;
-                    output?:
-                      | { type: "text"; value: string }
-                      | { type: "json"; value: any }
-                      | { type: "error-text"; value: string }
-                      | { type: "error-json"; value: any }
-                      | {
-                          type: "content";
-                          value: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mediaType: string; type: "media" }
-                          >;
-                        };
-                    providerExecuted?: boolean;
-                    providerMetadata?: Record<string, Record<string, any>>;
-                    providerOptions?: Record<string, Record<string, any>>;
-                    result?: any;
-                    toolCallId: string;
-                    toolName: string;
-                    type: "tool-result";
-                  }>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "tool";
-                }
-              | {
-                  content: string;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "system";
-                };
-            model?: string;
-            provider?: string;
-            providerOptions?: Record<string, Record<string, any>>;
-            status?: "pending" | "success" | "failed";
-          };
-        },
-        {
-          _creationTime: number;
-          _id: string;
-          agentName?: string;
-          embeddingId?: string;
-          error?: string;
-          fileIds?: Array<string>;
-          finishReason?:
-            | "stop"
-            | "length"
-            | "content-filter"
-            | "tool-calls"
-            | "error"
-            | "other"
-            | "unknown";
-          id?: string;
-          message?:
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          image: string | ArrayBuffer;
-                          mimeType?: string;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "image";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                            mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "user";
-              }
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                            mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          signature?: string;
-                          text: string;
-                          type: "reasoning";
-                        }
-                      | {
-                          data: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "redacted-reasoning";
-                        }
-                      | {
-                          args: any;
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-call";
-                        }
-                      | {
-                          args?: any;
-                          experimental_content?: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mimeType?: string; type: "image" }
-                          >;
-                          isError?: boolean;
-                          output?:
-                            | { type: "text"; value: string }
-                            | { type: "json"; value: any }
-                            | { type: "error-text"; value: string }
-                            | { type: "error-json"; value: any }
-                            | {
-                                type: "content";
-                                value: Array<
-                                  | { text: string; type: "text" }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      type: "media";
-                                    }
-                                >;
-                              };
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          result?: any;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-result";
-                        }
-                      | {
-                          id: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "url";
-                          title?: string;
-                          type: "source";
-                          url: string;
-                        }
-                      | {
-                          filename?: string;
-                          id: string;
-                          mediaType: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "document";
-                          title: string;
-                          type: "source";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "assistant";
-              }
-            | {
-                content: Array<{
-                  args?: any;
-                  experimental_content?: Array<
-                    | { text: string; type: "text" }
-                    | { data: string; mimeType?: string; type: "image" }
-                  >;
-                  isError?: boolean;
-                  output?:
-                    | { type: "text"; value: string }
-                    | { type: "json"; value: any }
-                    | { type: "error-text"; value: string }
-                    | { type: "error-json"; value: any }
-                    | {
-                        type: "content";
-                        value: Array<
-                          | { text: string; type: "text" }
-                          | { data: string; mediaType: string; type: "media" }
-                        >;
-                      };
-                  providerExecuted?: boolean;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  result?: any;
-                  toolCallId: string;
-                  toolName: string;
-                  type: "tool-result";
-                }>;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "tool";
-              }
-            | {
-                content: string;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "system";
-              };
-          model?: string;
-          order: number;
-          provider?: string;
-          providerMetadata?: Record<string, Record<string, any>>;
-          providerOptions?: Record<string, Record<string, any>>;
-          reasoning?: string;
-          reasoningDetails?: Array<
-            | {
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                signature?: string;
-                text: string;
-                type: "reasoning";
-              }
-            | { signature?: string; text: string; type: "text" }
-            | { data: string; type: "redacted" }
-          >;
-          sources?: Array<
-            | {
-                id: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "url";
-                title?: string;
-                type?: "source";
-                url: string;
-              }
-            | {
-                filename?: string;
-                id: string;
-                mediaType: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "document";
-                title: string;
-                type: "source";
-              }
-          >;
-          status: "pending" | "success" | "failed";
-          stepOrder: number;
-          text?: string;
-          threadId: string;
-          tool: boolean;
-          usage?: {
-            cachedInputTokens?: number;
-            completionTokens: number;
-            promptTokens: number;
-            reasoningTokens?: number;
-            totalTokens: number;
-          };
-          userId?: string;
-          warnings?: Array<
-            | { details?: string; setting: string; type: "unsupported-setting" }
-            | { details?: string; tool: any; type: "unsupported-tool" }
-            | { message: string; type: "other" }
-          >;
-        },
-        Name
-      >;
-    };
-    streams: {
-      abort: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          finalDelta?: {
-            end: number;
-            parts: Array<any>;
-            start: number;
-            streamId: string;
-          };
-          reason: string;
-          streamId: string;
-        },
-        boolean,
-        Name
-      >;
-      abortByOrder: FunctionReference<
-        "mutation",
-        "internal",
-        { order: number; reason: string; threadId: string },
-        boolean,
-        Name
-      >;
-      addDelta: FunctionReference<
-        "mutation",
-        "internal",
-        { end: number; parts: Array<any>; start: number; streamId: string },
-        boolean,
-        Name
-      >;
-      create: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          agentName?: string;
-          format?: "UIMessageChunk" | "TextStreamPart";
-          model?: string;
-          order: number;
-          provider?: string;
-          providerOptions?: Record<string, Record<string, any>>;
-          stepOrder: number;
-          threadId: string;
-          userId?: string;
-        },
-        string,
-        Name
-      >;
-      deleteAllStreamsForThreadIdAsync: FunctionReference<
-        "mutation",
-        "internal",
-        { deltaCursor?: string; streamOrder?: number; threadId: string },
-        { deltaCursor?: string; isDone: boolean; streamOrder?: number },
-        Name
-      >;
-      deleteAllStreamsForThreadIdSync: FunctionReference<
-        "action",
-        "internal",
-        { threadId: string },
-        null,
-        Name
-      >;
-      deleteStreamAsync: FunctionReference<
-        "mutation",
-        "internal",
-        { cursor?: string; streamId: string },
-        null,
-        Name
-      >;
-      deleteStreamSync: FunctionReference<
-        "mutation",
-        "internal",
-        { streamId: string },
-        null,
-        Name
-      >;
-      finish: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          finalDelta?: {
-            end: number;
-            parts: Array<any>;
-            start: number;
-            streamId: string;
-          };
-          streamId: string;
-        },
-        null,
-        Name
-      >;
-      heartbeat: FunctionReference<
-        "mutation",
-        "internal",
-        { streamId: string },
-        null,
-        Name
-      >;
-      list: FunctionReference<
-        "query",
-        "internal",
-        {
-          startOrder?: number;
-          statuses?: Array<"streaming" | "finished" | "aborted">;
-          threadId: string;
-        },
-        Array<{
-          agentName?: string;
-          format?: "UIMessageChunk" | "TextStreamPart";
-          model?: string;
-          order: number;
-          provider?: string;
-          providerOptions?: Record<string, Record<string, any>>;
-          status: "streaming" | "finished" | "aborted";
-          stepOrder: number;
-          streamId: string;
-          userId?: string;
-        }>,
-        Name
-      >;
-      listDeltas: FunctionReference<
-        "query",
-        "internal",
-        {
-          cursors: Array<{ cursor: number; streamId: string }>;
-          threadId: string;
-        },
-        Array<{
-          end: number;
-          parts: Array<any>;
-          start: number;
-          streamId: string;
-        }>,
-        Name
-      >;
-    };
-    threads: {
-      createThread: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          defaultSystemPrompt?: string;
-          parentThreadIds?: Array<string>;
-          summary?: string;
-          title?: string;
-          userId?: string;
-        },
-        {
-          _creationTime: number;
-          _id: string;
-          status: "active" | "archived";
-          summary?: string;
-          title?: string;
-          userId?: string;
-        },
-        Name
-      >;
-      deleteAllForThreadIdAsync: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          cursor?: string;
-          deltaCursor?: string;
-          limit?: number;
-          messagesDone?: boolean;
-          streamOrder?: number;
-          streamsDone?: boolean;
-          threadId: string;
-        },
-        { isDone: boolean },
-        Name
-      >;
-      deleteAllForThreadIdSync: FunctionReference<
-        "action",
-        "internal",
-        { limit?: number; threadId: string },
-        null,
-        Name
-      >;
-      getThread: FunctionReference<
-        "query",
-        "internal",
-        { threadId: string },
-        {
-          _creationTime: number;
-          _id: string;
-          status: "active" | "archived";
-          summary?: string;
-          title?: string;
-          userId?: string;
-        } | null,
-        Name
-      >;
-      listThreadsByUserId: FunctionReference<
-        "query",
-        "internal",
-        {
-          order?: "asc" | "desc";
-          paginationOpts?: {
-            cursor: string | null;
-            endCursor?: string | null;
-            id?: number;
-            maximumBytesRead?: number;
-            maximumRowsRead?: number;
-            numItems: number;
-          };
-          userId?: string;
-        },
-        {
-          continueCursor: string;
-          isDone: boolean;
-          page: Array<{
-            _creationTime: number;
-            _id: string;
-            status: "active" | "archived";
-            summary?: string;
-            title?: string;
-            userId?: string;
-          }>;
-          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
-          splitCursor?: string | null;
-        },
-        Name
-      >;
-      searchThreadTitles: FunctionReference<
-        "query",
-        "internal",
-        { limit: number; query: string; userId?: string | null },
-        Array<{
-          _creationTime: number;
-          _id: string;
-          status: "active" | "archived";
-          summary?: string;
-          title?: string;
-          userId?: string;
-        }>,
-        Name
-      >;
-      updateThread: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          patch: {
-            status?: "active" | "archived";
-            summary?: string;
-            title?: string;
-            userId?: string;
-          };
-          threadId: string;
-        },
-        {
-          _creationTime: number;
-          _id: string;
-          status: "active" | "archived";
-          summary?: string;
-          title?: string;
-          userId?: string;
-        },
-        Name
-      >;
-    };
-    users: {
-      deleteAllForUserId: FunctionReference<
-        "action",
-        "internal",
-        { userId: string },
-        null,
-        Name
-      >;
-      deleteAllForUserIdAsync: FunctionReference<
-        "mutation",
-        "internal",
-        { userId: string },
-        boolean,
-        Name
-      >;
-      listUsersWithThreads: FunctionReference<
-        "query",
-        "internal",
-        {
-          paginationOpts: {
-            cursor: string | null;
-            endCursor?: string | null;
-            id?: number;
-            maximumBytesRead?: number;
-            maximumRowsRead?: number;
-            numItems: number;
-          };
-        },
-        {
-          continueCursor: string;
-          isDone: boolean;
-          page: Array<string>;
-          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
-          splitCursor?: string | null;
-        },
-        Name
-      >;
-    };
-    vector: {
-      index: {
-        deleteBatch: FunctionReference<
-          "mutation",
-          "internal",
-          {
-            ids: Array<
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-            >;
-          },
-          null,
-          Name
-        >;
-        deleteBatchForThread: FunctionReference<
-          "mutation",
-          "internal",
-          {
-            cursor?: string;
-            limit: number;
-            model: string;
-            threadId: string;
-            vectorDimension:
-              | 128
-              | 256
-              | 512
-              | 768
-              | 1024
-              | 1408
-              | 1536
-              | 2048
-              | 3072
-              | 4096;
-          },
-          { continueCursor: string; isDone: boolean },
-          Name
-        >;
-        insertBatch: FunctionReference<
-          "mutation",
-          "internal",
-          {
-            vectorDimension:
-              | 128
-              | 256
-              | 512
-              | 768
-              | 1024
-              | 1408
-              | 1536
-              | 2048
-              | 3072
-              | 4096;
-            vectors: Array<{
-              messageId?: string;
-              model: string;
-              table: string;
-              threadId?: string;
-              userId?: string;
-              vector: Array<number>;
-            }>;
-          },
-          Array<
-            | string
-            | string
-            | string
-            | string
-            | string
-            | string
-            | string
-            | string
-            | string
-            | string
-          >,
-          Name
-        >;
-        paginate: FunctionReference<
-          "query",
-          "internal",
-          {
-            cursor?: string;
-            limit: number;
-            table?: string;
-            targetModel: string;
-            vectorDimension:
-              | 128
-              | 256
-              | 512
-              | 768
-              | 1024
-              | 1408
-              | 1536
-              | 2048
-              | 3072
-              | 4096;
-          },
-          {
-            continueCursor: string;
-            ids: Array<
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-            >;
-            isDone: boolean;
-          },
-          Name
-        >;
-        updateBatch: FunctionReference<
-          "mutation",
-          "internal",
-          {
-            vectors: Array<{
-              id:
-                | string
-                | string
-                | string
-                | string
-                | string
-                | string
-                | string
-                | string
-                | string
-                | string;
-              model: string;
-              vector: Array<number>;
-            }>;
-          },
-          null,
-          Name
-        >;
-      };
-    };
-  };

From 3ee52636b23e89714fc50f816758e7494123572a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 22:31:15 +0000
Subject: [PATCH 14/26] Add tool-call input field, execution-denied type, and
 extended content types

Co-authored-by: zboyles <2215540+zboyles@users.noreply.github.com>
---
 src/component/_generated/component.ts | 136 ++++++++++++++++++++------
 1 file changed, 104 insertions(+), 32 deletions(-)

diff --git a/src/component/_generated/component.ts b/src/component/_generated/component.ts
index eea30b00..066eee0e 100644
--- a/src/component/_generated/component.ts
+++ b/src/component/_generated/component.ts
@@ -286,7 +286,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             args?: any;
                             experimental_content?: Array<
-                              | { text: string; type: "text" }
+                              | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                               | {
                                   data: string;
                                   mimeType?: string;
@@ -299,11 +299,12 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                               | { type: "json"; value: any }
                               | { type: "error-text"; value: string }
                               | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | { type: "execution-denied"; reason?: string; }
                               | {
                                   type: "content";
                                   value: Array<
-                                    | { text: string; type: "text" }
+                                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                                     | {
                                         data: string;
                                         mediaType: string;
@@ -364,7 +365,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                   content: Array<{
                     args?: any;
                     experimental_content?: Array<
-                      | { text: string; type: "text" }
+                      | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                       | { data: string; mimeType?: string; type: "image" }
                     >;
                     isError?: boolean;
@@ -374,10 +375,11 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | { type: "error-text"; value: string }
                       | { type: "error-json"; value: any }
                       | { type: "execution-denied"; reason?: string; }
+                      | { type: "execution-denied"; reason?: string; }
                       | {
                           type: "content";
                           value: Array<
-                            | { text: string; type: "text" }
+                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                             | { data: string; mediaType: string; type: "media" }
                             | { data: string; mediaType: string; filename?: string; type: "file-data" }
                             | { url: string; type: "file-url" }
@@ -386,6 +388,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { url: string; type: "image-url" }
                             | { fileId: string | Record<string, string>; type: "image-file-id" }
                             | { type: "custom" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                           >;
                         };
                     providerExecuted?: boolean;
@@ -601,7 +610,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             args?: any;
                             experimental_content?: Array<
-                              | { text: string; type: "text" }
+                              | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                               | {
                                   data: string;
                                   mimeType?: string;
@@ -614,11 +623,12 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                               | { type: "json"; value: any }
                               | { type: "error-text"; value: string }
                               | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | { type: "execution-denied"; reason?: string; }
                               | {
                                   type: "content";
                                   value: Array<
-                                    | { text: string; type: "text" }
+                                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                                     | {
                                         data: string;
                                         mediaType: string;
@@ -679,7 +689,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                   content: Array<{
                     args?: any;
                     experimental_content?: Array<
-                      | { text: string; type: "text" }
+                      | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                       | { data: string; mimeType?: string; type: "image" }
                     >;
                     isError?: boolean;
@@ -689,10 +699,11 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | { type: "error-text"; value: string }
                       | { type: "error-json"; value: any }
                       | { type: "execution-denied"; reason?: string; }
+                      | { type: "execution-denied"; reason?: string; }
                       | {
                           type: "content";
                           value: Array<
-                            | { text: string; type: "text" }
+                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                             | { data: string; mediaType: string; type: "media" }
                             | { data: string; mediaType: string; filename?: string; type: "file-data" }
                             | { url: string; type: "file-url" }
@@ -701,6 +712,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { url: string; type: "image-url" }
                             | { fileId: string | Record<string, string>; type: "image-file-id" }
                             | { type: "custom" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                           >;
                         };
                     providerExecuted?: boolean;
@@ -946,7 +964,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           args?: any;
                           experimental_content?: Array<
-                            | { text: string; type: "text" }
+                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                             | { data: string; mimeType?: string; type: "image" }
                           >;
                           isError?: boolean;
@@ -955,11 +973,12 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { type: "json"; value: any }
                             | { type: "error-text"; value: string }
                             | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | { type: "execution-denied"; reason?: string; }
                             | {
                                 type: "content";
                                 value: Array<
-                                  | { text: string; type: "text" }
+                                  | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                                   | {
                                       data: string;
                                       mediaType: string;
@@ -1011,7 +1030,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                 content: Array<{
                   args?: any;
                   experimental_content?: Array<
-                    | { text: string; type: "text" }
+                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                     | { data: string; mimeType?: string; type: "image" }
                   >;
                   isError?: boolean;
@@ -1021,10 +1040,11 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                     | { type: "error-text"; value: string }
                     | { type: "error-json"; value: any }
                       | { type: "execution-denied"; reason?: string; }
+                      | { type: "execution-denied"; reason?: string; }
                     | {
                         type: "content";
                         value: Array<
-                          | { text: string; type: "text" }
+                          | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                           | { data: string; mediaType: string; type: "media" }
                             | { data: string; mediaType: string; filename?: string; type: "file-data" }
                             | { url: string; type: "file-url" }
@@ -1033,6 +1053,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { url: string; type: "image-url" }
                             | { fileId: string | Record<string, string>; type: "image-file-id" }
                             | { type: "custom" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                         >;
                       };
                   providerExecuted?: boolean;
@@ -1274,7 +1301,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             args?: any;
                             experimental_content?: Array<
-                              | { text: string; type: "text" }
+                              | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                               | {
                                   data: string;
                                   mimeType?: string;
@@ -1287,11 +1314,12 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                               | { type: "json"; value: any }
                               | { type: "error-text"; value: string }
                               | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | { type: "execution-denied"; reason?: string; }
                               | {
                                   type: "content";
                                   value: Array<
-                                    | { text: string; type: "text" }
+                                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                                     | {
                                         data: string;
                                         mediaType: string;
@@ -1352,7 +1380,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                   content: Array<{
                     args?: any;
                     experimental_content?: Array<
-                      | { text: string; type: "text" }
+                      | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                       | { data: string; mimeType?: string; type: "image" }
                     >;
                     isError?: boolean;
@@ -1362,10 +1390,11 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | { type: "error-text"; value: string }
                       | { type: "error-json"; value: any }
                       | { type: "execution-denied"; reason?: string; }
+                      | { type: "execution-denied"; reason?: string; }
                       | {
                           type: "content";
                           value: Array<
-                            | { text: string; type: "text" }
+                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                             | { data: string; mediaType: string; type: "media" }
                             | { data: string; mediaType: string; filename?: string; type: "file-data" }
                             | { url: string; type: "file-url" }
@@ -1374,6 +1403,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { url: string; type: "image-url" }
                             | { fileId: string | Record<string, string>; type: "image-file-id" }
                             | { type: "custom" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                           >;
                         };
                     providerExecuted?: boolean;
@@ -1586,7 +1622,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           args?: any;
                           experimental_content?: Array<
-                            | { text: string; type: "text" }
+                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                             | { data: string; mimeType?: string; type: "image" }
                           >;
                           isError?: boolean;
@@ -1595,11 +1631,12 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { type: "json"; value: any }
                             | { type: "error-text"; value: string }
                             | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | { type: "execution-denied"; reason?: string; }
                             | {
                                 type: "content";
                                 value: Array<
-                                  | { text: string; type: "text" }
+                                  | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                                   | {
                                       data: string;
                                       mediaType: string;
@@ -1651,7 +1688,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                 content: Array<{
                   args?: any;
                   experimental_content?: Array<
-                    | { text: string; type: "text" }
+                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                     | { data: string; mimeType?: string; type: "image" }
                   >;
                   isError?: boolean;
@@ -1661,10 +1698,11 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                     | { type: "error-text"; value: string }
                     | { type: "error-json"; value: any }
                       | { type: "execution-denied"; reason?: string; }
+                      | { type: "execution-denied"; reason?: string; }
                     | {
                         type: "content";
                         value: Array<
-                          | { text: string; type: "text" }
+                          | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                           | { data: string; mediaType: string; type: "media" }
                             | { data: string; mediaType: string; filename?: string; type: "file-data" }
                             | { url: string; type: "file-url" }
@@ -1673,6 +1711,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { url: string; type: "image-url" }
                             | { fileId: string | Record<string, string>; type: "image-file-id" }
                             | { type: "custom" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                         >;
                       };
                   providerExecuted?: boolean;
@@ -1872,7 +1917,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           args?: any;
                           experimental_content?: Array<
-                            | { text: string; type: "text" }
+                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                             | { data: string; mimeType?: string; type: "image" }
                           >;
                           isError?: boolean;
@@ -1881,11 +1926,12 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { type: "json"; value: any }
                             | { type: "error-text"; value: string }
                             | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | { type: "execution-denied"; reason?: string; }
                             | {
                                 type: "content";
                                 value: Array<
-                                  | { text: string; type: "text" }
+                                  | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                                   | {
                                       data: string;
                                       mediaType: string;
@@ -1937,7 +1983,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                 content: Array<{
                   args?: any;
                   experimental_content?: Array<
-                    | { text: string; type: "text" }
+                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                     | { data: string; mimeType?: string; type: "image" }
                   >;
                   isError?: boolean;
@@ -1947,10 +1993,11 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                     | { type: "error-text"; value: string }
                     | { type: "error-json"; value: any }
                       | { type: "execution-denied"; reason?: string; }
+                      | { type: "execution-denied"; reason?: string; }
                     | {
                         type: "content";
                         value: Array<
-                          | { text: string; type: "text" }
+                          | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                           | { data: string; mediaType: string; type: "media" }
                             | { data: string; mediaType: string; filename?: string; type: "file-data" }
                             | { url: string; type: "file-url" }
@@ -1959,6 +2006,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { url: string; type: "image-url" }
                             | { fileId: string | Record<string, string>; type: "image-file-id" }
                             | { type: "custom" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                         >;
                       };
                   providerExecuted?: boolean;
@@ -2172,7 +2226,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             args?: any;
                             experimental_content?: Array<
-                              | { text: string; type: "text" }
+                              | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                               | {
                                   data: string;
                                   mimeType?: string;
@@ -2185,11 +2239,12 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                               | { type: "json"; value: any }
                               | { type: "error-text"; value: string }
                               | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | { type: "execution-denied"; reason?: string; }
                               | {
                                   type: "content";
                                   value: Array<
-                                    | { text: string; type: "text" }
+                                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                                     | {
                                         data: string;
                                         mediaType: string;
@@ -2250,7 +2305,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                   content: Array<{
                     args?: any;
                     experimental_content?: Array<
-                      | { text: string; type: "text" }
+                      | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                       | { data: string; mimeType?: string; type: "image" }
                     >;
                     isError?: boolean;
@@ -2260,10 +2315,11 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | { type: "error-text"; value: string }
                       | { type: "error-json"; value: any }
                       | { type: "execution-denied"; reason?: string; }
+                      | { type: "execution-denied"; reason?: string; }
                       | {
                           type: "content";
                           value: Array<
-                            | { text: string; type: "text" }
+                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                             | { data: string; mediaType: string; type: "media" }
                             | { data: string; mediaType: string; filename?: string; type: "file-data" }
                             | { url: string; type: "file-url" }
@@ -2272,6 +2328,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { url: string; type: "image-url" }
                             | { fileId: string | Record<string, string>; type: "image-file-id" }
                             | { type: "custom" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                           >;
                         };
                     providerExecuted?: boolean;
@@ -2408,7 +2471,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           args?: any;
                           experimental_content?: Array<
-                            | { text: string; type: "text" }
+                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                             | { data: string; mimeType?: string; type: "image" }
                           >;
                           isError?: boolean;
@@ -2417,11 +2480,12 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { type: "json"; value: any }
                             | { type: "error-text"; value: string }
                             | { type: "error-json"; value: any }
+                      | { type: "execution-denied"; reason?: string; }
                       | { type: "execution-denied"; reason?: string; }
                             | {
                                 type: "content";
                                 value: Array<
-                                  | { text: string; type: "text" }
+                                  | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                                   | {
                                       data: string;
                                       mediaType: string;
@@ -2473,7 +2537,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                 content: Array<{
                   args?: any;
                   experimental_content?: Array<
-                    | { text: string; type: "text" }
+                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                     | { data: string; mimeType?: string; type: "image" }
                   >;
                   isError?: boolean;
@@ -2483,10 +2547,11 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                     | { type: "error-text"; value: string }
                     | { type: "error-json"; value: any }
                       | { type: "execution-denied"; reason?: string; }
+                      | { type: "execution-denied"; reason?: string; }
                     | {
                         type: "content";
                         value: Array<
-                          | { text: string; type: "text" }
+                          | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
                           | { data: string; mediaType: string; type: "media" }
                             | { data: string; mediaType: string; filename?: string; type: "file-data" }
                             | { url: string; type: "file-url" }
@@ -2495,6 +2560,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             | { url: string; type: "image-url" }
                             | { fileId: string | Record<string, string>; type: "image-file-id" }
                             | { type: "custom" }
+                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
+                            | { url: string; type: "file-url" }
+                            | { fileId: string | Record<string, string>; type: "file-id" }
+                            | { data: string; mediaType: string; type: "image-data" }
+                            | { url: string; type: "image-url" }
+                            | { fileId: string | Record<string, string>; type: "image-file-id" }
+                            | { type: "custom" }
                         >;
                       };
                   providerExecuted?: boolean;

From 298753057689eb2d9e6e93406f3f1c7c4fa249c2 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 17 Jan 2026 22:31:52 +0000
Subject: [PATCH 15/26] Add summary document for type error fixes

Co-authored-by: zboyles <2215540+zboyles@users.noreply.github.com>
---
 TYPE_FIX_SUMMARY.md | 63 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 TYPE_FIX_SUMMARY.md

diff --git a/TYPE_FIX_SUMMARY.md b/TYPE_FIX_SUMMARY.md
new file mode 100644
index 00000000..f11e3ad2
--- /dev/null
+++ b/TYPE_FIX_SUMMARY.md
@@ -0,0 +1,63 @@
+# AI SDK v6 Type Error Fix Summary
+
+## Problem
+The build fails with TypeScript errors after upgrading to AI SDK v6. The main issues are:
+1. `ToolCallPart` type now requires `input` field (not optional), but stored data may only have deprecated `args` field
+2. Tool-result output types missing newer types like `execution-denied` and extended content types
+3. Generated component types out of sync with updated validators
+
+## Changes Made
+
+### 1. Fixed `tool-call` Part Handling (src/mapping.ts)
+- Updated `toModelMessageContent()` to ensure `input` is always present by falling back to `args` or `{}`
+- Updated `serializeContent()` and `fromModelMessageContent()` to handle both `input` and legacy `args` fields
+- This fixes the core issue where AI SDK v6's `ToolCallPart` expects non-nullable `input`
+
+### 2. Fixed Tool Approval Response Handling (src/client/search.ts)
+- Updated `filterOutOrphanedToolMessages()` to handle tool-approval-response parts that don't have `toolCallId`
+- Tool-approval-response only has `approvalId`, not `toolCallId`
+
+### 3. Updated Generated Component Types (src/component/_generated/component.ts)
+Made manual updates to sync with validators (normally done via `convex codegen`):
+- Added `input: any` field to all tool-call type definitions
+- Made `args` optional (`args?: any`) in tool-call types  
+- Added `execution-denied` output type to tool-result
+- Added extended content types: `file-data`, `file-url`, `file-id`, `image-data`, `image-url`, `image-file-id`, `custom`
+- Added `providerOptions` to text types in content values
+
+## Remaining Issues (5 TypeScript errors)
+
+The remaining errors are due to a structural mismatch in the generated component types:
+- Generated types have BOTH `experimental_content` (deprecated) and `output` (new) fields on tool-result
+- Our validators only define `output`, not `experimental_content`
+- TypeScript is comparing our new output types against the old experimental_content types
+- This cannot be fixed manually - requires proper component regeneration
+
+### To Complete the Fix:
+1. Run `convex codegen --component-dir ./src/component` with a valid Convex deployment
+2. This will regenerate `src/component/_generated/component.ts` from the validators
+3. The regenerated types will:
+   - Remove the deprecated `experimental_content` field
+   - Use only the `output` field with correct types
+   - Properly match the validator definitions
+
+### Error Locations:
+- `src/client/index.ts:1052` - addMessages call
+- `src/client/index.ts:1103` - addMessages call  
+- `src/client/index.ts:1169` - updateMessage call
+- `src/client/messages.ts:141` - addMessages call
+- `src/client/start.ts:265` - addMessages call
+
+All errors have the same root cause: content value types in tool-result output don't match experimental_content expectations.
+
+## Testing Plan
+Once component types are regenerated:
+1. Run `npm run build` - should complete without errors
+2. Run `npm test` - ensure no regressions
+3. Test with actual AI SDK v6 workflow - verify tool-call handling works with both new `input` and legacy `args` fields
+
+## Notes
+- The mapping functions in `src/mapping.ts` correctly handle both old and new formats
+- Data with only `args` will be converted to have `input` (with `args` as fallback)
+- Data with `input` will work directly
+- This provides backward compatibility while supporting AI SDK v6's requirements

From 1e7c351d5b870785d08edd34a4149435f8a4deb9 Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sat, 17 Jan 2026 20:51:40 -0500
Subject: [PATCH 16/26] Fix type errors due to experimental_content vs output
 field mismatch in generated types. Ran `convex codegen --component-dir
 ./src/component`.

---
 src/component/_generated/component.ts | 2562 ++++++++++++++++++++-----
 1 file changed, 2127 insertions(+), 435 deletions(-)

diff --git a/src/component/_generated/component.ts b/src/component/_generated/component.ts
index 066eee0e..b64ff3ed 100644
--- a/src/component/_generated/component.ts
+++ b/src/component/_generated/component.ts
@@ -185,6 +185,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           }
                         | {
                             image: string | ArrayBuffer;
+                            mediaType?: string;
                             mimeType?: string;
                             providerOptions?: Record<
                               string,
@@ -268,8 +269,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             type: "redacted-reasoning";
                           }
                         | {
-                            input: any;
                             args?: any;
+                            input: any;
                             providerExecuted?: boolean;
                             providerMetadata?: Record<
                               string,
@@ -286,7 +287,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             args?: any;
                             experimental_content?: Array<
-                              | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                              | { text: string; type: "text" }
                               | {
                                   data: string;
                                   mimeType?: string;
@@ -295,21 +296,120 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             >;
                             isError?: boolean;
                             output?:
-                              | { type: "text"; value: string }
-                              | { type: "json"; value: any }
-                              | { type: "error-text"; value: string }
-                              | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  reason?: string;
+                                  type: "execution-denied";
+                                }
                               | {
                                   type: "content";
                                   value: Array<
-                                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        text: string;
+                                        type: "text";
+                                      }
                                     | {
                                         data: string;
                                         mediaType: string;
                                         type: "media";
                                       }
+                                    | {
+                                        data: string;
+                                        filename?: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-id";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-file-id";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "custom";
+                                      }
                                   >;
                                 };
                             providerExecuted?: boolean;
@@ -357,54 +457,167 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             title: string;
                             type: "source";
                           }
+                        | {
+                            approvalId: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            type: "tool-approval-request";
+                          }
                       >;
                   providerOptions?: Record<string, Record<string, any>>;
                   role: "assistant";
                 }
               | {
-                  content: Array<{
-                    args?: any;
-                    experimental_content?: Array<
-                      | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                      | { data: string; mimeType?: string; type: "image" }
-                    >;
-                    isError?: boolean;
-                    output?:
-                      | { type: "text"; value: string }
-                      | { type: "json"; value: any }
-                      | { type: "error-text"; value: string }
-                      | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
-                      | {
-                          type: "content";
-                          value: Array<
-                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                            | { data: string; mediaType: string; type: "media" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                          >;
-                        };
-                    providerExecuted?: boolean;
-                    providerMetadata?: Record<string, Record<string, any>>;
-                    providerOptions?: Record<string, Record<string, any>>;
-                    result?: any;
-                    toolCallId: string;
-                    toolName: string;
-                    type: "tool-result";
-                  }>;
+                  content: Array<
+                    | {
+                        args?: any;
+                        experimental_content?: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mimeType?: string; type: "image" }
+                        >;
+                        isError?: boolean;
+                        output?:
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              reason?: string;
+                              type: "execution-denied";
+                            }
+                          | {
+                              type: "content";
+                              value: Array<
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    text: string;
+                                    type: "text";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    type: "media";
+                                  }
+                                | {
+                                    data: string;
+                                    filename?: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-id";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-file-id";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "custom";
+                                  }
+                              >;
+                            };
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        result?: any;
+                        toolCallId: string;
+                        toolName: string;
+                        type: "tool-result";
+                      }
+                    | {
+                        approvalId: string;
+                        approved: boolean;
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        reason?: string;
+                        type: "tool-approval-response";
+                      }
+                  >;
                   providerOptions?: Record<string, Record<string, any>>;
                   role: "tool";
                 }
@@ -509,6 +722,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           }
                         | {
                             image: string | ArrayBuffer;
+                            mediaType?: string;
                             mimeType?: string;
                             providerOptions?: Record<
                               string,
@@ -592,8 +806,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             type: "redacted-reasoning";
                           }
                         | {
-                            input: any;
                             args?: any;
+                            input: any;
                             providerExecuted?: boolean;
                             providerMetadata?: Record<
                               string,
@@ -610,7 +824,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             args?: any;
                             experimental_content?: Array<
-                              | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                              | { text: string; type: "text" }
                               | {
                                   data: string;
                                   mimeType?: string;
@@ -619,21 +833,120 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             >;
                             isError?: boolean;
                             output?:
-                              | { type: "text"; value: string }
-                              | { type: "json"; value: any }
-                              | { type: "error-text"; value: string }
-                              | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  reason?: string;
+                                  type: "execution-denied";
+                                }
                               | {
                                   type: "content";
                                   value: Array<
-                                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        text: string;
+                                        type: "text";
+                                      }
                                     | {
                                         data: string;
                                         mediaType: string;
                                         type: "media";
                                       }
+                                    | {
+                                        data: string;
+                                        filename?: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-id";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-file-id";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "custom";
+                                      }
                                   >;
                                 };
                             providerExecuted?: boolean;
@@ -681,54 +994,167 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             title: string;
                             type: "source";
                           }
+                        | {
+                            approvalId: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            type: "tool-approval-request";
+                          }
                       >;
                   providerOptions?: Record<string, Record<string, any>>;
                   role: "assistant";
                 }
               | {
-                  content: Array<{
-                    args?: any;
-                    experimental_content?: Array<
-                      | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                      | { data: string; mimeType?: string; type: "image" }
-                    >;
-                    isError?: boolean;
-                    output?:
-                      | { type: "text"; value: string }
-                      | { type: "json"; value: any }
-                      | { type: "error-text"; value: string }
-                      | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
-                      | {
-                          type: "content";
-                          value: Array<
-                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                            | { data: string; mediaType: string; type: "media" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                          >;
-                        };
-                    providerExecuted?: boolean;
-                    providerMetadata?: Record<string, Record<string, any>>;
-                    providerOptions?: Record<string, Record<string, any>>;
-                    result?: any;
-                    toolCallId: string;
-                    toolName: string;
-                    type: "tool-result";
-                  }>;
+                  content: Array<
+                    | {
+                        args?: any;
+                        experimental_content?: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mimeType?: string; type: "image" }
+                        >;
+                        isError?: boolean;
+                        output?:
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              reason?: string;
+                              type: "execution-denied";
+                            }
+                          | {
+                              type: "content";
+                              value: Array<
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    text: string;
+                                    type: "text";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    type: "media";
+                                  }
+                                | {
+                                    data: string;
+                                    filename?: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-id";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-file-id";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "custom";
+                                  }
+                              >;
+                            };
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        result?: any;
+                        toolCallId: string;
+                        toolName: string;
+                        type: "tool-result";
+                      }
+                    | {
+                        approvalId: string;
+                        approved: boolean;
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        reason?: string;
+                        type: "tool-approval-response";
+                      }
+                  >;
                   providerOptions?: Record<string, Record<string, any>>;
                   role: "tool";
                 }
@@ -884,6 +1310,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         }
                       | {
                           image: string | ArrayBuffer;
+                          mediaType?: string;
                           mimeType?: string;
                           providerOptions?: Record<string, Record<string, any>>;
                           type: "image";
@@ -892,7 +1319,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           data: string | ArrayBuffer;
                           filename?: string;
                           mediaType?: string;
-                            mimeType?: string;
+                          mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -921,7 +1348,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           data: string | ArrayBuffer;
                           filename?: string;
                           mediaType?: string;
-                            mimeType?: string;
+                          mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -949,8 +1376,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           type: "redacted-reasoning";
                         }
                       | {
+                          args?: any;
                           input: any;
-                            args?: any;
                           providerExecuted?: boolean;
                           providerMetadata?: Record<
                             string,
@@ -964,26 +1391,125 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           args?: any;
                           experimental_content?: Array<
-                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                            | { text: string; type: "text" }
                             | { data: string; mimeType?: string; type: "image" }
                           >;
                           isError?: boolean;
                           output?:
-                            | { type: "text"; value: string }
-                            | { type: "json"; value: any }
-                            | { type: "error-text"; value: string }
-                            | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                reason?: string;
+                                type: "execution-denied";
+                              }
                             | {
                                 type: "content";
                                 value: Array<
-                                  | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      text: string;
+                                      type: "text";
+                                    }
                                   | {
                                       data: string;
                                       mediaType: string;
                                       type: "media";
                                     }
+                                  | {
+                                      data: string;
+                                      filename?: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-id";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-file-id";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "custom";
+                                    }
                                 >;
                               };
                           providerExecuted?: boolean;
@@ -1022,54 +1548,164 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           title: string;
                           type: "source";
                         }
+                      | {
+                          approvalId: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          type: "tool-approval-request";
+                        }
                     >;
                 providerOptions?: Record<string, Record<string, any>>;
                 role: "assistant";
               }
             | {
-                content: Array<{
-                  args?: any;
-                  experimental_content?: Array<
-                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                    | { data: string; mimeType?: string; type: "image" }
-                  >;
-                  isError?: boolean;
-                  output?:
-                    | { type: "text"; value: string }
-                    | { type: "json"; value: any }
-                    | { type: "error-text"; value: string }
-                    | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
-                    | {
-                        type: "content";
-                        value: Array<
-                          | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                          | { data: string; mediaType: string; type: "media" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                        >;
-                      };
-                  providerExecuted?: boolean;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  result?: any;
-                  toolCallId: string;
-                  toolName: string;
-                  type: "tool-result";
-                }>;
+                content: Array<
+                  | {
+                      args?: any;
+                      experimental_content?: Array<
+                        | { text: string; type: "text" }
+                        | { data: string; mimeType?: string; type: "image" }
+                      >;
+                      isError?: boolean;
+                      output?:
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            reason?: string;
+                            type: "execution-denied";
+                          }
+                        | {
+                            type: "content";
+                            value: Array<
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  text: string;
+                                  type: "text";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  type: "media";
+                                }
+                              | {
+                                  data: string;
+                                  filename?: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-id";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-file-id";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "custom";
+                                }
+                            >;
+                          };
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      result?: any;
+                      toolCallId: string;
+                      toolName: string;
+                      type: "tool-result";
+                    }
+                  | {
+                      approvalId: string;
+                      approved: boolean;
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      reason?: string;
+                      type: "tool-approval-response";
+                    }
+                >;
                 providerOptions?: Record<string, Record<string, any>>;
                 role: "tool";
               }
@@ -1200,6 +1836,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           }
                         | {
                             image: string | ArrayBuffer;
+                            mediaType?: string;
                             mimeType?: string;
                             providerOptions?: Record<
                               string,
@@ -1283,8 +1920,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             type: "redacted-reasoning";
                           }
                         | {
-                            input: any;
                             args?: any;
+                            input: any;
                             providerExecuted?: boolean;
                             providerMetadata?: Record<
                               string,
@@ -1301,7 +1938,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             args?: any;
                             experimental_content?: Array<
-                              | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                              | { text: string; type: "text" }
                               | {
                                   data: string;
                                   mimeType?: string;
@@ -1310,32 +1947,131 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             >;
                             isError?: boolean;
                             output?:
-                              | { type: "text"; value: string }
-                              | { type: "json"; value: any }
-                              | { type: "error-text"; value: string }
-                              | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  reason?: string;
+                                  type: "execution-denied";
+                                }
                               | {
                                   type: "content";
                                   value: Array<
-                                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        text: string;
+                                        type: "text";
+                                      }
                                     | {
                                         data: string;
                                         mediaType: string;
                                         type: "media";
                                       }
-                                  >;
-                                };
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
+                                    | {
+                                        data: string;
+                                        filename?: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-id";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-file-id";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "custom";
+                                      }
+                                  >;
+                                };
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
                             result?: any;
                             toolCallId: string;
                             toolName: string;
@@ -1372,54 +2108,167 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             title: string;
                             type: "source";
                           }
+                        | {
+                            approvalId: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            type: "tool-approval-request";
+                          }
                       >;
                   providerOptions?: Record<string, Record<string, any>>;
                   role: "assistant";
                 }
               | {
-                  content: Array<{
-                    args?: any;
-                    experimental_content?: Array<
-                      | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                      | { data: string; mimeType?: string; type: "image" }
-                    >;
-                    isError?: boolean;
-                    output?:
-                      | { type: "text"; value: string }
-                      | { type: "json"; value: any }
-                      | { type: "error-text"; value: string }
-                      | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
-                      | {
-                          type: "content";
-                          value: Array<
-                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                            | { data: string; mediaType: string; type: "media" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                          >;
-                        };
-                    providerExecuted?: boolean;
-                    providerMetadata?: Record<string, Record<string, any>>;
-                    providerOptions?: Record<string, Record<string, any>>;
-                    result?: any;
-                    toolCallId: string;
-                    toolName: string;
-                    type: "tool-result";
-                  }>;
+                  content: Array<
+                    | {
+                        args?: any;
+                        experimental_content?: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mimeType?: string; type: "image" }
+                        >;
+                        isError?: boolean;
+                        output?:
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              reason?: string;
+                              type: "execution-denied";
+                            }
+                          | {
+                              type: "content";
+                              value: Array<
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    text: string;
+                                    type: "text";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    type: "media";
+                                  }
+                                | {
+                                    data: string;
+                                    filename?: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-id";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-file-id";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "custom";
+                                  }
+                              >;
+                            };
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        result?: any;
+                        toolCallId: string;
+                        toolName: string;
+                        type: "tool-result";
+                      }
+                    | {
+                        approvalId: string;
+                        approved: boolean;
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        reason?: string;
+                        type: "tool-approval-response";
+                      }
+                  >;
                   providerOptions?: Record<string, Record<string, any>>;
                   role: "tool";
                 }
@@ -1542,6 +2391,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         }
                       | {
                           image: string | ArrayBuffer;
+                          mediaType?: string;
                           mimeType?: string;
                           providerOptions?: Record<string, Record<string, any>>;
                           type: "image";
@@ -1550,7 +2400,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           data: string | ArrayBuffer;
                           filename?: string;
                           mediaType?: string;
-                            mimeType?: string;
+                          mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -1579,7 +2429,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           data: string | ArrayBuffer;
                           filename?: string;
                           mediaType?: string;
-                            mimeType?: string;
+                          mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -1607,8 +2457,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           type: "redacted-reasoning";
                         }
                       | {
+                          args?: any;
                           input: any;
-                            args?: any;
                           providerExecuted?: boolean;
                           providerMetadata?: Record<
                             string,
@@ -1622,26 +2472,125 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           args?: any;
                           experimental_content?: Array<
-                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                            | { text: string; type: "text" }
                             | { data: string; mimeType?: string; type: "image" }
                           >;
                           isError?: boolean;
                           output?:
-                            | { type: "text"; value: string }
-                            | { type: "json"; value: any }
-                            | { type: "error-text"; value: string }
-                            | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                reason?: string;
+                                type: "execution-denied";
+                              }
                             | {
                                 type: "content";
                                 value: Array<
-                                  | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      text: string;
+                                      type: "text";
+                                    }
                                   | {
                                       data: string;
                                       mediaType: string;
                                       type: "media";
                                     }
+                                  | {
+                                      data: string;
+                                      filename?: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-id";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-file-id";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "custom";
+                                    }
                                 >;
                               };
                           providerExecuted?: boolean;
@@ -1680,54 +2629,164 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           title: string;
                           type: "source";
                         }
+                      | {
+                          approvalId: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          type: "tool-approval-request";
+                        }
                     >;
                 providerOptions?: Record<string, Record<string, any>>;
                 role: "assistant";
               }
             | {
-                content: Array<{
-                  args?: any;
-                  experimental_content?: Array<
-                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                    | { data: string; mimeType?: string; type: "image" }
-                  >;
-                  isError?: boolean;
-                  output?:
-                    | { type: "text"; value: string }
-                    | { type: "json"; value: any }
-                    | { type: "error-text"; value: string }
-                    | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
-                    | {
-                        type: "content";
-                        value: Array<
-                          | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                          | { data: string; mediaType: string; type: "media" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                        >;
-                      };
-                  providerExecuted?: boolean;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  result?: any;
-                  toolCallId: string;
-                  toolName: string;
-                  type: "tool-result";
-                }>;
+                content: Array<
+                  | {
+                      args?: any;
+                      experimental_content?: Array<
+                        | { text: string; type: "text" }
+                        | { data: string; mimeType?: string; type: "image" }
+                      >;
+                      isError?: boolean;
+                      output?:
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            reason?: string;
+                            type: "execution-denied";
+                          }
+                        | {
+                            type: "content";
+                            value: Array<
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  text: string;
+                                  type: "text";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  type: "media";
+                                }
+                              | {
+                                  data: string;
+                                  filename?: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-id";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-file-id";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "custom";
+                                }
+                            >;
+                          };
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      result?: any;
+                      toolCallId: string;
+                      toolName: string;
+                      type: "tool-result";
+                    }
+                  | {
+                      approvalId: string;
+                      approved: boolean;
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      reason?: string;
+                      type: "tool-approval-response";
+                    }
+                >;
                 providerOptions?: Record<string, Record<string, any>>;
                 role: "tool";
               }
@@ -1837,6 +2896,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         }
                       | {
                           image: string | ArrayBuffer;
+                          mediaType?: string;
                           mimeType?: string;
                           providerOptions?: Record<string, Record<string, any>>;
                           type: "image";
@@ -1845,7 +2905,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           data: string | ArrayBuffer;
                           filename?: string;
                           mediaType?: string;
-                            mimeType?: string;
+                          mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -1874,7 +2934,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           data: string | ArrayBuffer;
                           filename?: string;
                           mediaType?: string;
-                            mimeType?: string;
+                          mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -1902,8 +2962,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           type: "redacted-reasoning";
                         }
                       | {
+                          args?: any;
                           input: any;
-                            args?: any;
                           providerExecuted?: boolean;
                           providerMetadata?: Record<
                             string,
@@ -1917,26 +2977,125 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           args?: any;
                           experimental_content?: Array<
-                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                            | { text: string; type: "text" }
                             | { data: string; mimeType?: string; type: "image" }
                           >;
                           isError?: boolean;
                           output?:
-                            | { type: "text"; value: string }
-                            | { type: "json"; value: any }
-                            | { type: "error-text"; value: string }
-                            | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                reason?: string;
+                                type: "execution-denied";
+                              }
                             | {
                                 type: "content";
                                 value: Array<
-                                  | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      text: string;
+                                      type: "text";
+                                    }
                                   | {
                                       data: string;
                                       mediaType: string;
                                       type: "media";
                                     }
+                                  | {
+                                      data: string;
+                                      filename?: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-id";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-file-id";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "custom";
+                                    }
                                 >;
                               };
                           providerExecuted?: boolean;
@@ -1975,54 +3134,164 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           title: string;
                           type: "source";
                         }
+                      | {
+                          approvalId: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          type: "tool-approval-request";
+                        }
                     >;
                 providerOptions?: Record<string, Record<string, any>>;
                 role: "assistant";
               }
             | {
-                content: Array<{
-                  args?: any;
-                  experimental_content?: Array<
-                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                    | { data: string; mimeType?: string; type: "image" }
-                  >;
-                  isError?: boolean;
-                  output?:
-                    | { type: "text"; value: string }
-                    | { type: "json"; value: any }
-                    | { type: "error-text"; value: string }
-                    | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
-                    | {
-                        type: "content";
-                        value: Array<
-                          | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                          | { data: string; mediaType: string; type: "media" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                        >;
-                      };
-                  providerExecuted?: boolean;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  result?: any;
-                  toolCallId: string;
-                  toolName: string;
-                  type: "tool-result";
-                }>;
+                content: Array<
+                  | {
+                      args?: any;
+                      experimental_content?: Array<
+                        | { text: string; type: "text" }
+                        | { data: string; mimeType?: string; type: "image" }
+                      >;
+                      isError?: boolean;
+                      output?:
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            reason?: string;
+                            type: "execution-denied";
+                          }
+                        | {
+                            type: "content";
+                            value: Array<
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  text: string;
+                                  type: "text";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  type: "media";
+                                }
+                              | {
+                                  data: string;
+                                  filename?: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-id";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-file-id";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "custom";
+                                }
+                            >;
+                          };
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      result?: any;
+                      toolCallId: string;
+                      toolName: string;
+                      type: "tool-result";
+                    }
+                  | {
+                      approvalId: string;
+                      approved: boolean;
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      reason?: string;
+                      type: "tool-approval-response";
+                    }
+                >;
                 providerOptions?: Record<string, Record<string, any>>;
                 role: "tool";
               }
@@ -2125,6 +3394,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           }
                         | {
                             image: string | ArrayBuffer;
+                            mediaType?: string;
                             mimeType?: string;
                             providerOptions?: Record<
                               string,
@@ -2208,8 +3478,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             type: "redacted-reasoning";
                           }
                         | {
-                            input: any;
                             args?: any;
+                            input: any;
                             providerExecuted?: boolean;
                             providerMetadata?: Record<
                               string,
@@ -2226,7 +3496,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         | {
                             args?: any;
                             experimental_content?: Array<
-                              | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                              | { text: string; type: "text" }
                               | {
                                   data: string;
                                   mimeType?: string;
@@ -2235,21 +3505,120 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             >;
                             isError?: boolean;
                             output?:
-                              | { type: "text"; value: string }
-                              | { type: "json"; value: any }
-                              | { type: "error-text"; value: string }
-                              | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  reason?: string;
+                                  type: "execution-denied";
+                                }
                               | {
                                   type: "content";
                                   value: Array<
-                                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        text: string;
+                                        type: "text";
+                                      }
                                     | {
                                         data: string;
                                         mediaType: string;
                                         type: "media";
                                       }
+                                    | {
+                                        data: string;
+                                        filename?: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-id";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-file-id";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "custom";
+                                      }
                                   >;
                                 };
                             providerExecuted?: boolean;
@@ -2297,54 +3666,167 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             title: string;
                             type: "source";
                           }
+                        | {
+                            approvalId: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            type: "tool-approval-request";
+                          }
                       >;
                   providerOptions?: Record<string, Record<string, any>>;
                   role: "assistant";
                 }
               | {
-                  content: Array<{
-                    args?: any;
-                    experimental_content?: Array<
-                      | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                      | { data: string; mimeType?: string; type: "image" }
-                    >;
-                    isError?: boolean;
-                    output?:
-                      | { type: "text"; value: string }
-                      | { type: "json"; value: any }
-                      | { type: "error-text"; value: string }
-                      | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
-                      | {
-                          type: "content";
-                          value: Array<
-                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                            | { data: string; mediaType: string; type: "media" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                          >;
-                        };
-                    providerExecuted?: boolean;
-                    providerMetadata?: Record<string, Record<string, any>>;
-                    providerOptions?: Record<string, Record<string, any>>;
-                    result?: any;
-                    toolCallId: string;
-                    toolName: string;
-                    type: "tool-result";
-                  }>;
+                  content: Array<
+                    | {
+                        args?: any;
+                        experimental_content?: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mimeType?: string; type: "image" }
+                        >;
+                        isError?: boolean;
+                        output?:
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              reason?: string;
+                              type: "execution-denied";
+                            }
+                          | {
+                              type: "content";
+                              value: Array<
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    text: string;
+                                    type: "text";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    type: "media";
+                                  }
+                                | {
+                                    data: string;
+                                    filename?: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-id";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-file-id";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "custom";
+                                  }
+                              >;
+                            };
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        result?: any;
+                        toolCallId: string;
+                        toolName: string;
+                        type: "tool-result";
+                      }
+                    | {
+                        approvalId: string;
+                        approved: boolean;
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        reason?: string;
+                        type: "tool-approval-response";
+                      }
+                  >;
                   providerOptions?: Record<string, Record<string, any>>;
                   role: "tool";
                 }
@@ -2391,6 +3873,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                         }
                       | {
                           image: string | ArrayBuffer;
+                          mediaType?: string;
                           mimeType?: string;
                           providerOptions?: Record<string, Record<string, any>>;
                           type: "image";
@@ -2399,7 +3882,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           data: string | ArrayBuffer;
                           filename?: string;
                           mediaType?: string;
-                            mimeType?: string;
+                          mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -2428,7 +3911,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           data: string | ArrayBuffer;
                           filename?: string;
                           mediaType?: string;
-                            mimeType?: string;
+                          mimeType?: string;
                           providerMetadata?: Record<
                             string,
                             Record<string, any>
@@ -2456,8 +3939,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           type: "redacted-reasoning";
                         }
                       | {
+                          args?: any;
                           input: any;
-                            args?: any;
                           providerExecuted?: boolean;
                           providerMetadata?: Record<
                             string,
@@ -2471,26 +3954,125 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                       | {
                           args?: any;
                           experimental_content?: Array<
-                            | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                            | { text: string; type: "text" }
                             | { data: string; mimeType?: string; type: "image" }
                           >;
                           isError?: boolean;
                           output?:
-                            | { type: "text"; value: string }
-                            | { type: "json"; value: any }
-                            | { type: "error-text"; value: string }
-                            | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                reason?: string;
+                                type: "execution-denied";
+                              }
                             | {
                                 type: "content";
                                 value: Array<
-                                  | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      text: string;
+                                      type: "text";
+                                    }
                                   | {
                                       data: string;
                                       mediaType: string;
                                       type: "media";
                                     }
+                                  | {
+                                      data: string;
+                                      filename?: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-id";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-file-id";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "custom";
+                                    }
                                 >;
                               };
                           providerExecuted?: boolean;
@@ -2529,54 +4111,164 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           title: string;
                           type: "source";
                         }
+                      | {
+                          approvalId: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          type: "tool-approval-request";
+                        }
                     >;
                 providerOptions?: Record<string, Record<string, any>>;
                 role: "assistant";
               }
             | {
-                content: Array<{
-                  args?: any;
-                  experimental_content?: Array<
-                    | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                    | { data: string; mimeType?: string; type: "image" }
-                  >;
-                  isError?: boolean;
-                  output?:
-                    | { type: "text"; value: string }
-                    | { type: "json"; value: any }
-                    | { type: "error-text"; value: string }
-                    | { type: "error-json"; value: any }
-                      | { type: "execution-denied"; reason?: string; }
-                      | { type: "execution-denied"; reason?: string; }
-                    | {
-                        type: "content";
-                        value: Array<
-                          | { text: string; type: "text"; providerOptions?: Record<string, Record<string, any>> }
-                          | { data: string; mediaType: string; type: "media" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                            | { data: string; mediaType: string; filename?: string; type: "file-data" }
-                            | { url: string; type: "file-url" }
-                            | { fileId: string | Record<string, string>; type: "file-id" }
-                            | { data: string; mediaType: string; type: "image-data" }
-                            | { url: string; type: "image-url" }
-                            | { fileId: string | Record<string, string>; type: "image-file-id" }
-                            | { type: "custom" }
-                        >;
-                      };
-                  providerExecuted?: boolean;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  result?: any;
-                  toolCallId: string;
-                  toolName: string;
-                  type: "tool-result";
-                }>;
+                content: Array<
+                  | {
+                      args?: any;
+                      experimental_content?: Array<
+                        | { text: string; type: "text" }
+                        | { data: string; mimeType?: string; type: "image" }
+                      >;
+                      isError?: boolean;
+                      output?:
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            reason?: string;
+                            type: "execution-denied";
+                          }
+                        | {
+                            type: "content";
+                            value: Array<
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  text: string;
+                                  type: "text";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  type: "media";
+                                }
+                              | {
+                                  data: string;
+                                  filename?: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-id";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-file-id";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "custom";
+                                }
+                            >;
+                          };
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      result?: any;
+                      toolCallId: string;
+                      toolName: string;
+                      type: "tool-result";
+                    }
+                  | {
+                      approvalId: string;
+                      approved: boolean;
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      reason?: string;
+                      type: "tool-approval-response";
+                    }
+                >;
                 providerOptions?: Record<string, Record<string, any>>;
                 role: "tool";
               }

From 219f520da900998534adf7b8f65db7eff5afc2a6 Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sat, 17 Jan 2026 20:59:26 -0500
Subject: [PATCH 17/26] Refactor test cases to replace 'args' with 'input' in
 tool-call definitions for consistency

---
 src/component/messages.test.ts | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/component/messages.test.ts b/src/component/messages.test.ts
index 9581b8f6..0c273307 100644
--- a/src/component/messages.test.ts
+++ b/src/component/messages.test.ts
@@ -68,7 +68,7 @@ describe("agent", () => {
             content: [
               {
                 type: "tool-call",
-                args: { a: 1 },
+                input: { a: 1 },
                 toolCallId: "1",
                 toolName: "tool",
               },
@@ -258,7 +258,7 @@ describe("agent", () => {
             content: [
               {
                 type: "tool-call",
-                args: { a: 1 },
+                input: { a: 1 },
                 toolCallId: "1",
                 toolName: "tool",
               },
@@ -389,7 +389,7 @@ describe("agent", () => {
             content: [
               {
                 type: "tool-call",
-                args: { a: 1 },
+                input: { a: 1 },
                 toolCallId: "1",
                 toolName: "tool",
               },
@@ -408,7 +408,7 @@ describe("agent", () => {
           content: [
             {
               type: "tool-call",
-              args: { a: 2, b: 3 },
+              input: { a: 2, b: 3 },
               toolCallId: "1",
               toolName: "tool",
             },
@@ -422,7 +422,7 @@ describe("agent", () => {
       content: [
         {
           type: "tool-call",
-          args: { a: 2, b: 3 },
+          input: { a: 2, b: 3 },
           toolCallId: "1",
           toolName: "tool",
         },

From 0a1bcb581dbc17d0aa916eb46ec08156a3417c05 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 18 Jan 2026 02:23:17 +0000
Subject: [PATCH 18/26] Use union type for tool-call to support both input and
 args formats

Co-authored-by: zboyles <2215540+zboyles@users.noreply.github.com>
---
 src/component/_generated/component.ts        |  128 +
 src/component/_generated/component.ts.backup | 4785 ++++++++++++++++++
 src/validators.ts                            |   39 +-
 3 files changed, 4941 insertions(+), 11 deletions(-)
 create mode 100644 src/component/_generated/component.ts.backup

diff --git a/src/component/_generated/component.ts b/src/component/_generated/component.ts
index b64ff3ed..f6708edc 100644
--- a/src/component/_generated/component.ts
+++ b/src/component/_generated/component.ts
@@ -284,6 +284,22 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             toolName: string;
                             type: "tool-call";
                           }
+                        | {
+                            args: any;
+                            input?: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
                         | {
                             args?: any;
                             experimental_content?: Array<
@@ -821,6 +837,22 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             toolName: string;
                             type: "tool-call";
                           }
+                        | {
+                            args: any;
+                            input?: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
                         | {
                             args?: any;
                             experimental_content?: Array<
@@ -1388,6 +1420,22 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           toolName: string;
                           type: "tool-call";
                         }
+                        | {
+                            args: any;
+                            input?: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
                       | {
                           args?: any;
                           experimental_content?: Array<
@@ -1935,6 +1983,22 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             toolName: string;
                             type: "tool-call";
                           }
+                        | {
+                            args: any;
+                            input?: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
                         | {
                             args?: any;
                             experimental_content?: Array<
@@ -2469,6 +2533,22 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           toolName: string;
                           type: "tool-call";
                         }
+                        | {
+                            args: any;
+                            input?: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
                       | {
                           args?: any;
                           experimental_content?: Array<
@@ -2974,6 +3054,22 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           toolName: string;
                           type: "tool-call";
                         }
+                        | {
+                            args: any;
+                            input?: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
                       | {
                           args?: any;
                           experimental_content?: Array<
@@ -3493,6 +3589,22 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                             toolName: string;
                             type: "tool-call";
                           }
+                        | {
+                            args: any;
+                            input?: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
                         | {
                             args?: any;
                             experimental_content?: Array<
@@ -3951,6 +4063,22 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                           toolName: string;
                           type: "tool-call";
                         }
+                        | {
+                            args: any;
+                            input?: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
                       | {
                           args?: any;
                           experimental_content?: Array<
diff --git a/src/component/_generated/component.ts.backup b/src/component/_generated/component.ts.backup
new file mode 100644
index 00000000..b64ff3ed
--- /dev/null
+++ b/src/component/_generated/component.ts.backup
@@ -0,0 +1,4785 @@
+/* eslint-disable */
+/**
+ * Generated `ComponentApi` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+
+import type { FunctionReference } from "convex/server";
+
+/**
+ * A utility for referencing a Convex component's exposed API.
+ *
+ * Useful when expecting a parameter like `components.myComponent`.
+ * Usage:
+ * ```ts
+ * async function myFunction(ctx: QueryCtx, component: ComponentApi) {
+ *   return ctx.runQuery(component.someFile.someQuery, { ...args });
+ * }
+ * ```
+ */
+export type ComponentApi<Name extends string | undefined = string | undefined> =
+  {
+    apiKeys: {
+      destroy: FunctionReference<
+        "mutation",
+        "internal",
+        { apiKey?: string; name?: string },
+        | "missing"
+        | "deleted"
+        | "name mismatch"
+        | "must provide either apiKey or name",
+        Name
+      >;
+      issue: FunctionReference<
+        "mutation",
+        "internal",
+        { name?: string },
+        string,
+        Name
+      >;
+      validate: FunctionReference<
+        "query",
+        "internal",
+        { apiKey: string },
+        boolean,
+        Name
+      >;
+    };
+    files: {
+      addFile: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          filename?: string;
+          hash: string;
+          mediaType?: string;
+          mimeType?: string;
+          storageId: string;
+        },
+        { fileId: string; storageId: string },
+        Name
+      >;
+      copyFile: FunctionReference<
+        "mutation",
+        "internal",
+        { fileId: string },
+        null,
+        Name
+      >;
+      deleteFiles: FunctionReference<
+        "mutation",
+        "internal",
+        { fileIds: Array<string>; force?: boolean },
+        Array<string>,
+        Name
+      >;
+      get: FunctionReference<
+        "query",
+        "internal",
+        { fileId: string },
+        null | {
+          _creationTime: number;
+          _id: string;
+          filename?: string;
+          hash: string;
+          lastTouchedAt: number;
+          mediaType?: string;
+          mimeType?: string;
+          refcount: number;
+          storageId: string;
+        },
+        Name
+      >;
+      getFilesToDelete: FunctionReference<
+        "query",
+        "internal",
+        {
+          paginationOpts: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
+        },
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            filename?: string;
+            hash: string;
+            lastTouchedAt: number;
+            mediaType?: string;
+            mimeType?: string;
+            refcount: number;
+            storageId: string;
+          }>;
+        },
+        Name
+      >;
+      useExistingFile: FunctionReference<
+        "mutation",
+        "internal",
+        { filename?: string; hash: string },
+        null | { fileId: string; storageId: string },
+        Name
+      >;
+    };
+    messages: {
+      addMessages: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          agentName?: string;
+          embeddings?: {
+            dimension:
+              | 128
+              | 256
+              | 512
+              | 768
+              | 1024
+              | 1408
+              | 1536
+              | 2048
+              | 3072
+              | 4096;
+            model: string;
+            vectors: Array<Array<number> | null>;
+          };
+          failPendingSteps?: boolean;
+          hideFromUserIdSearch?: boolean;
+          messages: Array<{
+            error?: string;
+            fileIds?: Array<string>;
+            finishReason?:
+              | "stop"
+              | "length"
+              | "content-filter"
+              | "tool-calls"
+              | "error"
+              | "other"
+              | "unknown";
+            message:
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            image: string | ArrayBuffer;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "image";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "user";
+                }
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            signature?: string;
+                            text: string;
+                            type: "reasoning";
+                          }
+                        | {
+                            data: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "redacted-reasoning";
+                          }
+                        | {
+                            args?: any;
+                            input: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
+                        | {
+                            args?: any;
+                            experimental_content?: Array<
+                              | { text: string; type: "text" }
+                              | {
+                                  data: string;
+                                  mimeType?: string;
+                                  type: "image";
+                                }
+                            >;
+                            isError?: boolean;
+                            output?:
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  reason?: string;
+                                  type: "execution-denied";
+                                }
+                              | {
+                                  type: "content";
+                                  value: Array<
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        text: string;
+                                        type: "text";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        type: "media";
+                                      }
+                                    | {
+                                        data: string;
+                                        filename?: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-id";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-file-id";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "custom";
+                                      }
+                                  >;
+                                };
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            result?: any;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-result";
+                          }
+                        | {
+                            id: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "url";
+                            title?: string;
+                            type: "source";
+                            url: string;
+                          }
+                        | {
+                            filename?: string;
+                            id: string;
+                            mediaType: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "document";
+                            title: string;
+                            type: "source";
+                          }
+                        | {
+                            approvalId: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            type: "tool-approval-request";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "assistant";
+                }
+              | {
+                  content: Array<
+                    | {
+                        args?: any;
+                        experimental_content?: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mimeType?: string; type: "image" }
+                        >;
+                        isError?: boolean;
+                        output?:
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              reason?: string;
+                              type: "execution-denied";
+                            }
+                          | {
+                              type: "content";
+                              value: Array<
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    text: string;
+                                    type: "text";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    type: "media";
+                                  }
+                                | {
+                                    data: string;
+                                    filename?: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-id";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-file-id";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "custom";
+                                  }
+                              >;
+                            };
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        result?: any;
+                        toolCallId: string;
+                        toolName: string;
+                        type: "tool-result";
+                      }
+                    | {
+                        approvalId: string;
+                        approved: boolean;
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        reason?: string;
+                        type: "tool-approval-response";
+                      }
+                  >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "tool";
+                }
+              | {
+                  content: string;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "system";
+                };
+            model?: string;
+            provider?: string;
+            providerMetadata?: Record<string, Record<string, any>>;
+            reasoning?: string;
+            reasoningDetails?: Array<
+              | {
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  signature?: string;
+                  text: string;
+                  type: "reasoning";
+                }
+              | { signature?: string; text: string; type: "text" }
+              | { data: string; type: "redacted" }
+            >;
+            sources?: Array<
+              | {
+                  id: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "url";
+                  title?: string;
+                  type?: "source";
+                  url: string;
+                }
+              | {
+                  filename?: string;
+                  id: string;
+                  mediaType: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "document";
+                  title: string;
+                  type: "source";
+                }
+            >;
+            status?: "pending" | "success" | "failed";
+            text?: string;
+            usage?: {
+              cachedInputTokens?: number;
+              completionTokens: number;
+              promptTokens: number;
+              reasoningTokens?: number;
+              totalTokens: number;
+            };
+            warnings?: Array<
+              | {
+                  details?: string;
+                  setting: string;
+                  type: "unsupported-setting";
+                }
+              | { details?: string; tool: any; type: "unsupported-tool" }
+              | { message: string; type: "other" }
+            >;
+          }>;
+          pendingMessageId?: string;
+          promptMessageId?: string;
+          threadId: string;
+          userId?: string;
+        },
+        {
+          messages: Array<{
+            _creationTime: number;
+            _id: string;
+            agentName?: string;
+            embeddingId?: string;
+            error?: string;
+            fileIds?: Array<string>;
+            finishReason?:
+              | "stop"
+              | "length"
+              | "content-filter"
+              | "tool-calls"
+              | "error"
+              | "other"
+              | "unknown";
+            id?: string;
+            message?:
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            image: string | ArrayBuffer;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "image";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "user";
+                }
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            signature?: string;
+                            text: string;
+                            type: "reasoning";
+                          }
+                        | {
+                            data: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "redacted-reasoning";
+                          }
+                        | {
+                            args?: any;
+                            input: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
+                        | {
+                            args?: any;
+                            experimental_content?: Array<
+                              | { text: string; type: "text" }
+                              | {
+                                  data: string;
+                                  mimeType?: string;
+                                  type: "image";
+                                }
+                            >;
+                            isError?: boolean;
+                            output?:
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  reason?: string;
+                                  type: "execution-denied";
+                                }
+                              | {
+                                  type: "content";
+                                  value: Array<
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        text: string;
+                                        type: "text";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        type: "media";
+                                      }
+                                    | {
+                                        data: string;
+                                        filename?: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-id";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-file-id";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "custom";
+                                      }
+                                  >;
+                                };
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            result?: any;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-result";
+                          }
+                        | {
+                            id: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "url";
+                            title?: string;
+                            type: "source";
+                            url: string;
+                          }
+                        | {
+                            filename?: string;
+                            id: string;
+                            mediaType: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "document";
+                            title: string;
+                            type: "source";
+                          }
+                        | {
+                            approvalId: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            type: "tool-approval-request";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "assistant";
+                }
+              | {
+                  content: Array<
+                    | {
+                        args?: any;
+                        experimental_content?: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mimeType?: string; type: "image" }
+                        >;
+                        isError?: boolean;
+                        output?:
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              reason?: string;
+                              type: "execution-denied";
+                            }
+                          | {
+                              type: "content";
+                              value: Array<
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    text: string;
+                                    type: "text";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    type: "media";
+                                  }
+                                | {
+                                    data: string;
+                                    filename?: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-id";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-file-id";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "custom";
+                                  }
+                              >;
+                            };
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        result?: any;
+                        toolCallId: string;
+                        toolName: string;
+                        type: "tool-result";
+                      }
+                    | {
+                        approvalId: string;
+                        approved: boolean;
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        reason?: string;
+                        type: "tool-approval-response";
+                      }
+                  >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "tool";
+                }
+              | {
+                  content: string;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "system";
+                };
+            model?: string;
+            order: number;
+            provider?: string;
+            providerMetadata?: Record<string, Record<string, any>>;
+            providerOptions?: Record<string, Record<string, any>>;
+            reasoning?: string;
+            reasoningDetails?: Array<
+              | {
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  signature?: string;
+                  text: string;
+                  type: "reasoning";
+                }
+              | { signature?: string; text: string; type: "text" }
+              | { data: string; type: "redacted" }
+            >;
+            sources?: Array<
+              | {
+                  id: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "url";
+                  title?: string;
+                  type?: "source";
+                  url: string;
+                }
+              | {
+                  filename?: string;
+                  id: string;
+                  mediaType: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "document";
+                  title: string;
+                  type: "source";
+                }
+            >;
+            status: "pending" | "success" | "failed";
+            stepOrder: number;
+            text?: string;
+            threadId: string;
+            tool: boolean;
+            usage?: {
+              cachedInputTokens?: number;
+              completionTokens: number;
+              promptTokens: number;
+              reasoningTokens?: number;
+              totalTokens: number;
+            };
+            userId?: string;
+            warnings?: Array<
+              | {
+                  details?: string;
+                  setting: string;
+                  type: "unsupported-setting";
+                }
+              | { details?: string; tool: any; type: "unsupported-tool" }
+              | { message: string; type: "other" }
+            >;
+          }>;
+        },
+        Name
+      >;
+      cloneThread: FunctionReference<
+        "action",
+        "internal",
+        {
+          batchSize?: number;
+          copyUserIdForVectorSearch?: boolean;
+          excludeToolMessages?: boolean;
+          insertAtOrder?: number;
+          limit?: number;
+          sourceThreadId: string;
+          statuses?: Array<"pending" | "success" | "failed">;
+          targetThreadId: string;
+          upToAndIncludingMessageId?: string;
+        },
+        number,
+        Name
+      >;
+      deleteByIds: FunctionReference<
+        "mutation",
+        "internal",
+        { messageIds: Array<string> },
+        Array<string>,
+        Name
+      >;
+      deleteByOrder: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          endOrder: number;
+          endStepOrder?: number;
+          startOrder: number;
+          startStepOrder?: number;
+          threadId: string;
+        },
+        { isDone: boolean; lastOrder?: number; lastStepOrder?: number },
+        Name
+      >;
+      finalizeMessage: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          messageId: string;
+          result: { status: "success" } | { error: string; status: "failed" };
+        },
+        null,
+        Name
+      >;
+      getMessagesByIds: FunctionReference<
+        "query",
+        "internal",
+        { messageIds: Array<string> },
+        Array<null | {
+          _creationTime: number;
+          _id: string;
+          agentName?: string;
+          embeddingId?: string;
+          error?: string;
+          fileIds?: Array<string>;
+          finishReason?:
+            | "stop"
+            | "length"
+            | "content-filter"
+            | "tool-calls"
+            | "error"
+            | "other"
+            | "unknown";
+          id?: string;
+          message?:
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          image: string | ArrayBuffer;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "image";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "user";
+              }
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          signature?: string;
+                          text: string;
+                          type: "reasoning";
+                        }
+                      | {
+                          data: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "redacted-reasoning";
+                        }
+                      | {
+                          args?: any;
+                          input: any;
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-call";
+                        }
+                      | {
+                          args?: any;
+                          experimental_content?: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mimeType?: string; type: "image" }
+                          >;
+                          isError?: boolean;
+                          output?:
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                reason?: string;
+                                type: "execution-denied";
+                              }
+                            | {
+                                type: "content";
+                                value: Array<
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      text: string;
+                                      type: "text";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      type: "media";
+                                    }
+                                  | {
+                                      data: string;
+                                      filename?: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-id";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-file-id";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "custom";
+                                    }
+                                >;
+                              };
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          result?: any;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-result";
+                        }
+                      | {
+                          id: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "url";
+                          title?: string;
+                          type: "source";
+                          url: string;
+                        }
+                      | {
+                          filename?: string;
+                          id: string;
+                          mediaType: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "document";
+                          title: string;
+                          type: "source";
+                        }
+                      | {
+                          approvalId: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          type: "tool-approval-request";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "assistant";
+              }
+            | {
+                content: Array<
+                  | {
+                      args?: any;
+                      experimental_content?: Array<
+                        | { text: string; type: "text" }
+                        | { data: string; mimeType?: string; type: "image" }
+                      >;
+                      isError?: boolean;
+                      output?:
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            reason?: string;
+                            type: "execution-denied";
+                          }
+                        | {
+                            type: "content";
+                            value: Array<
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  text: string;
+                                  type: "text";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  type: "media";
+                                }
+                              | {
+                                  data: string;
+                                  filename?: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-id";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-file-id";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "custom";
+                                }
+                            >;
+                          };
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      result?: any;
+                      toolCallId: string;
+                      toolName: string;
+                      type: "tool-result";
+                    }
+                  | {
+                      approvalId: string;
+                      approved: boolean;
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      reason?: string;
+                      type: "tool-approval-response";
+                    }
+                >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "tool";
+              }
+            | {
+                content: string;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "system";
+              };
+          model?: string;
+          order: number;
+          provider?: string;
+          providerMetadata?: Record<string, Record<string, any>>;
+          providerOptions?: Record<string, Record<string, any>>;
+          reasoning?: string;
+          reasoningDetails?: Array<
+            | {
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                signature?: string;
+                text: string;
+                type: "reasoning";
+              }
+            | { signature?: string; text: string; type: "text" }
+            | { data: string; type: "redacted" }
+          >;
+          sources?: Array<
+            | {
+                id: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "url";
+                title?: string;
+                type?: "source";
+                url: string;
+              }
+            | {
+                filename?: string;
+                id: string;
+                mediaType: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "document";
+                title: string;
+                type: "source";
+              }
+          >;
+          status: "pending" | "success" | "failed";
+          stepOrder: number;
+          text?: string;
+          threadId: string;
+          tool: boolean;
+          usage?: {
+            cachedInputTokens?: number;
+            completionTokens: number;
+            promptTokens: number;
+            reasoningTokens?: number;
+            totalTokens: number;
+          };
+          userId?: string;
+          warnings?: Array<
+            | { details?: string; setting: string; type: "unsupported-setting" }
+            | { details?: string; tool: any; type: "unsupported-tool" }
+            | { message: string; type: "other" }
+          >;
+        }>,
+        Name
+      >;
+      getMessageSearchFields: FunctionReference<
+        "query",
+        "internal",
+        { messageId: string },
+        { embedding?: Array<number>; embeddingModel?: string; text?: string },
+        Name
+      >;
+      listMessagesByThreadId: FunctionReference<
+        "query",
+        "internal",
+        {
+          excludeToolMessages?: boolean;
+          order: "asc" | "desc";
+          paginationOpts?: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
+          statuses?: Array<"pending" | "success" | "failed">;
+          threadId: string;
+          upToAndIncludingMessageId?: string;
+        },
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            agentName?: string;
+            embeddingId?: string;
+            error?: string;
+            fileIds?: Array<string>;
+            finishReason?:
+              | "stop"
+              | "length"
+              | "content-filter"
+              | "tool-calls"
+              | "error"
+              | "other"
+              | "unknown";
+            id?: string;
+            message?:
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            image: string | ArrayBuffer;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "image";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "user";
+                }
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            signature?: string;
+                            text: string;
+                            type: "reasoning";
+                          }
+                        | {
+                            data: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "redacted-reasoning";
+                          }
+                        | {
+                            args?: any;
+                            input: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
+                        | {
+                            args?: any;
+                            experimental_content?: Array<
+                              | { text: string; type: "text" }
+                              | {
+                                  data: string;
+                                  mimeType?: string;
+                                  type: "image";
+                                }
+                            >;
+                            isError?: boolean;
+                            output?:
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  reason?: string;
+                                  type: "execution-denied";
+                                }
+                              | {
+                                  type: "content";
+                                  value: Array<
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        text: string;
+                                        type: "text";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        type: "media";
+                                      }
+                                    | {
+                                        data: string;
+                                        filename?: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-id";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-file-id";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "custom";
+                                      }
+                                  >;
+                                };
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            result?: any;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-result";
+                          }
+                        | {
+                            id: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "url";
+                            title?: string;
+                            type: "source";
+                            url: string;
+                          }
+                        | {
+                            filename?: string;
+                            id: string;
+                            mediaType: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "document";
+                            title: string;
+                            type: "source";
+                          }
+                        | {
+                            approvalId: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            type: "tool-approval-request";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "assistant";
+                }
+              | {
+                  content: Array<
+                    | {
+                        args?: any;
+                        experimental_content?: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mimeType?: string; type: "image" }
+                        >;
+                        isError?: boolean;
+                        output?:
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              reason?: string;
+                              type: "execution-denied";
+                            }
+                          | {
+                              type: "content";
+                              value: Array<
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    text: string;
+                                    type: "text";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    type: "media";
+                                  }
+                                | {
+                                    data: string;
+                                    filename?: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-id";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-file-id";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "custom";
+                                  }
+                              >;
+                            };
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        result?: any;
+                        toolCallId: string;
+                        toolName: string;
+                        type: "tool-result";
+                      }
+                    | {
+                        approvalId: string;
+                        approved: boolean;
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        reason?: string;
+                        type: "tool-approval-response";
+                      }
+                  >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "tool";
+                }
+              | {
+                  content: string;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "system";
+                };
+            model?: string;
+            order: number;
+            provider?: string;
+            providerMetadata?: Record<string, Record<string, any>>;
+            providerOptions?: Record<string, Record<string, any>>;
+            reasoning?: string;
+            reasoningDetails?: Array<
+              | {
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  signature?: string;
+                  text: string;
+                  type: "reasoning";
+                }
+              | { signature?: string; text: string; type: "text" }
+              | { data: string; type: "redacted" }
+            >;
+            sources?: Array<
+              | {
+                  id: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "url";
+                  title?: string;
+                  type?: "source";
+                  url: string;
+                }
+              | {
+                  filename?: string;
+                  id: string;
+                  mediaType: string;
+                  providerMetadata?: Record<string, Record<string, any>>;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  sourceType: "document";
+                  title: string;
+                  type: "source";
+                }
+            >;
+            status: "pending" | "success" | "failed";
+            stepOrder: number;
+            text?: string;
+            threadId: string;
+            tool: boolean;
+            usage?: {
+              cachedInputTokens?: number;
+              completionTokens: number;
+              promptTokens: number;
+              reasoningTokens?: number;
+              totalTokens: number;
+            };
+            userId?: string;
+            warnings?: Array<
+              | {
+                  details?: string;
+                  setting: string;
+                  type: "unsupported-setting";
+                }
+              | { details?: string; tool: any; type: "unsupported-tool" }
+              | { message: string; type: "other" }
+            >;
+          }>;
+          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+          splitCursor?: string | null;
+        },
+        Name
+      >;
+      searchMessages: FunctionReference<
+        "action",
+        "internal",
+        {
+          embedding?: Array<number>;
+          embeddingModel?: string;
+          limit: number;
+          messageRange?: { after: number; before: number };
+          searchAllMessagesForUserId?: string;
+          targetMessageId?: string;
+          text?: string;
+          textSearch?: boolean;
+          threadId?: string;
+          vectorScoreThreshold?: number;
+          vectorSearch?: boolean;
+        },
+        Array<{
+          _creationTime: number;
+          _id: string;
+          agentName?: string;
+          embeddingId?: string;
+          error?: string;
+          fileIds?: Array<string>;
+          finishReason?:
+            | "stop"
+            | "length"
+            | "content-filter"
+            | "tool-calls"
+            | "error"
+            | "other"
+            | "unknown";
+          id?: string;
+          message?:
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          image: string | ArrayBuffer;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "image";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "user";
+              }
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          signature?: string;
+                          text: string;
+                          type: "reasoning";
+                        }
+                      | {
+                          data: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "redacted-reasoning";
+                        }
+                      | {
+                          args?: any;
+                          input: any;
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-call";
+                        }
+                      | {
+                          args?: any;
+                          experimental_content?: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mimeType?: string; type: "image" }
+                          >;
+                          isError?: boolean;
+                          output?:
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                reason?: string;
+                                type: "execution-denied";
+                              }
+                            | {
+                                type: "content";
+                                value: Array<
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      text: string;
+                                      type: "text";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      type: "media";
+                                    }
+                                  | {
+                                      data: string;
+                                      filename?: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-id";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-file-id";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "custom";
+                                    }
+                                >;
+                              };
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          result?: any;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-result";
+                        }
+                      | {
+                          id: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "url";
+                          title?: string;
+                          type: "source";
+                          url: string;
+                        }
+                      | {
+                          filename?: string;
+                          id: string;
+                          mediaType: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "document";
+                          title: string;
+                          type: "source";
+                        }
+                      | {
+                          approvalId: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          type: "tool-approval-request";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "assistant";
+              }
+            | {
+                content: Array<
+                  | {
+                      args?: any;
+                      experimental_content?: Array<
+                        | { text: string; type: "text" }
+                        | { data: string; mimeType?: string; type: "image" }
+                      >;
+                      isError?: boolean;
+                      output?:
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            reason?: string;
+                            type: "execution-denied";
+                          }
+                        | {
+                            type: "content";
+                            value: Array<
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  text: string;
+                                  type: "text";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  type: "media";
+                                }
+                              | {
+                                  data: string;
+                                  filename?: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-id";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-file-id";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "custom";
+                                }
+                            >;
+                          };
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      result?: any;
+                      toolCallId: string;
+                      toolName: string;
+                      type: "tool-result";
+                    }
+                  | {
+                      approvalId: string;
+                      approved: boolean;
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      reason?: string;
+                      type: "tool-approval-response";
+                    }
+                >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "tool";
+              }
+            | {
+                content: string;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "system";
+              };
+          model?: string;
+          order: number;
+          provider?: string;
+          providerMetadata?: Record<string, Record<string, any>>;
+          providerOptions?: Record<string, Record<string, any>>;
+          reasoning?: string;
+          reasoningDetails?: Array<
+            | {
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                signature?: string;
+                text: string;
+                type: "reasoning";
+              }
+            | { signature?: string; text: string; type: "text" }
+            | { data: string; type: "redacted" }
+          >;
+          sources?: Array<
+            | {
+                id: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "url";
+                title?: string;
+                type?: "source";
+                url: string;
+              }
+            | {
+                filename?: string;
+                id: string;
+                mediaType: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "document";
+                title: string;
+                type: "source";
+              }
+          >;
+          status: "pending" | "success" | "failed";
+          stepOrder: number;
+          text?: string;
+          threadId: string;
+          tool: boolean;
+          usage?: {
+            cachedInputTokens?: number;
+            completionTokens: number;
+            promptTokens: number;
+            reasoningTokens?: number;
+            totalTokens: number;
+          };
+          userId?: string;
+          warnings?: Array<
+            | { details?: string; setting: string; type: "unsupported-setting" }
+            | { details?: string; tool: any; type: "unsupported-tool" }
+            | { message: string; type: "other" }
+          >;
+        }>,
+        Name
+      >;
+      textSearch: FunctionReference<
+        "query",
+        "internal",
+        {
+          limit: number;
+          searchAllMessagesForUserId?: string;
+          targetMessageId?: string;
+          text?: string;
+          threadId?: string;
+        },
+        Array<{
+          _creationTime: number;
+          _id: string;
+          agentName?: string;
+          embeddingId?: string;
+          error?: string;
+          fileIds?: Array<string>;
+          finishReason?:
+            | "stop"
+            | "length"
+            | "content-filter"
+            | "tool-calls"
+            | "error"
+            | "other"
+            | "unknown";
+          id?: string;
+          message?:
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          image: string | ArrayBuffer;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "image";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "user";
+              }
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          signature?: string;
+                          text: string;
+                          type: "reasoning";
+                        }
+                      | {
+                          data: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "redacted-reasoning";
+                        }
+                      | {
+                          args?: any;
+                          input: any;
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-call";
+                        }
+                      | {
+                          args?: any;
+                          experimental_content?: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mimeType?: string; type: "image" }
+                          >;
+                          isError?: boolean;
+                          output?:
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                reason?: string;
+                                type: "execution-denied";
+                              }
+                            | {
+                                type: "content";
+                                value: Array<
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      text: string;
+                                      type: "text";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      type: "media";
+                                    }
+                                  | {
+                                      data: string;
+                                      filename?: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-id";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-file-id";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "custom";
+                                    }
+                                >;
+                              };
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          result?: any;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-result";
+                        }
+                      | {
+                          id: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "url";
+                          title?: string;
+                          type: "source";
+                          url: string;
+                        }
+                      | {
+                          filename?: string;
+                          id: string;
+                          mediaType: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "document";
+                          title: string;
+                          type: "source";
+                        }
+                      | {
+                          approvalId: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          type: "tool-approval-request";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "assistant";
+              }
+            | {
+                content: Array<
+                  | {
+                      args?: any;
+                      experimental_content?: Array<
+                        | { text: string; type: "text" }
+                        | { data: string; mimeType?: string; type: "image" }
+                      >;
+                      isError?: boolean;
+                      output?:
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            reason?: string;
+                            type: "execution-denied";
+                          }
+                        | {
+                            type: "content";
+                            value: Array<
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  text: string;
+                                  type: "text";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  type: "media";
+                                }
+                              | {
+                                  data: string;
+                                  filename?: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-id";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-file-id";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "custom";
+                                }
+                            >;
+                          };
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      result?: any;
+                      toolCallId: string;
+                      toolName: string;
+                      type: "tool-result";
+                    }
+                  | {
+                      approvalId: string;
+                      approved: boolean;
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      reason?: string;
+                      type: "tool-approval-response";
+                    }
+                >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "tool";
+              }
+            | {
+                content: string;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "system";
+              };
+          model?: string;
+          order: number;
+          provider?: string;
+          providerMetadata?: Record<string, Record<string, any>>;
+          providerOptions?: Record<string, Record<string, any>>;
+          reasoning?: string;
+          reasoningDetails?: Array<
+            | {
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                signature?: string;
+                text: string;
+                type: "reasoning";
+              }
+            | { signature?: string; text: string; type: "text" }
+            | { data: string; type: "redacted" }
+          >;
+          sources?: Array<
+            | {
+                id: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "url";
+                title?: string;
+                type?: "source";
+                url: string;
+              }
+            | {
+                filename?: string;
+                id: string;
+                mediaType: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "document";
+                title: string;
+                type: "source";
+              }
+          >;
+          status: "pending" | "success" | "failed";
+          stepOrder: number;
+          text?: string;
+          threadId: string;
+          tool: boolean;
+          usage?: {
+            cachedInputTokens?: number;
+            completionTokens: number;
+            promptTokens: number;
+            reasoningTokens?: number;
+            totalTokens: number;
+          };
+          userId?: string;
+          warnings?: Array<
+            | { details?: string; setting: string; type: "unsupported-setting" }
+            | { details?: string; tool: any; type: "unsupported-tool" }
+            | { message: string; type: "other" }
+          >;
+        }>,
+        Name
+      >;
+      updateMessage: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          messageId: string;
+          patch: {
+            error?: string;
+            fileIds?: Array<string>;
+            finishReason?:
+              | "stop"
+              | "length"
+              | "content-filter"
+              | "tool-calls"
+              | "error"
+              | "other"
+              | "unknown";
+            message?:
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            image: string | ArrayBuffer;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "image";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "user";
+                }
+              | {
+                  content:
+                    | string
+                    | Array<
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            text: string;
+                            type: "text";
+                          }
+                        | {
+                            data: string | ArrayBuffer;
+                            filename?: string;
+                            mediaType?: string;
+                            mimeType?: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "file";
+                          }
+                        | {
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            signature?: string;
+                            text: string;
+                            type: "reasoning";
+                          }
+                        | {
+                            data: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "redacted-reasoning";
+                          }
+                        | {
+                            args?: any;
+                            input: any;
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-call";
+                          }
+                        | {
+                            args?: any;
+                            experimental_content?: Array<
+                              | { text: string; type: "text" }
+                              | {
+                                  data: string;
+                                  mimeType?: string;
+                                  type: "image";
+                                }
+                            >;
+                            isError?: boolean;
+                            output?:
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-text";
+                                  value: string;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "error-json";
+                                  value: any;
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  reason?: string;
+                                  type: "execution-denied";
+                                }
+                              | {
+                                  type: "content";
+                                  value: Array<
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        text: string;
+                                        type: "text";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        type: "media";
+                                      }
+                                    | {
+                                        data: string;
+                                        filename?: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "file-id";
+                                      }
+                                    | {
+                                        data: string;
+                                        mediaType: string;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-data";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-url";
+                                        url: string;
+                                      }
+                                    | {
+                                        fileId: string | Record<string, string>;
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "image-file-id";
+                                      }
+                                    | {
+                                        providerOptions?: Record<
+                                          string,
+                                          Record<string, any>
+                                        >;
+                                        type: "custom";
+                                      }
+                                  >;
+                                };
+                            providerExecuted?: boolean;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            result?: any;
+                            toolCallId: string;
+                            toolName: string;
+                            type: "tool-result";
+                          }
+                        | {
+                            id: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "url";
+                            title?: string;
+                            type: "source";
+                            url: string;
+                          }
+                        | {
+                            filename?: string;
+                            id: string;
+                            mediaType: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            sourceType: "document";
+                            title: string;
+                            type: "source";
+                          }
+                        | {
+                            approvalId: string;
+                            providerMetadata?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            toolCallId: string;
+                            type: "tool-approval-request";
+                          }
+                      >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "assistant";
+                }
+              | {
+                  content: Array<
+                    | {
+                        args?: any;
+                        experimental_content?: Array<
+                          | { text: string; type: "text" }
+                          | { data: string; mimeType?: string; type: "image" }
+                        >;
+                        isError?: boolean;
+                        output?:
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-text";
+                              value: string;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              type: "error-json";
+                              value: any;
+                            }
+                          | {
+                              providerOptions?: Record<
+                                string,
+                                Record<string, any>
+                              >;
+                              reason?: string;
+                              type: "execution-denied";
+                            }
+                          | {
+                              type: "content";
+                              value: Array<
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    text: string;
+                                    type: "text";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    type: "media";
+                                  }
+                                | {
+                                    data: string;
+                                    filename?: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "file-id";
+                                  }
+                                | {
+                                    data: string;
+                                    mediaType: string;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-data";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-url";
+                                    url: string;
+                                  }
+                                | {
+                                    fileId: string | Record<string, string>;
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "image-file-id";
+                                  }
+                                | {
+                                    providerOptions?: Record<
+                                      string,
+                                      Record<string, any>
+                                    >;
+                                    type: "custom";
+                                  }
+                              >;
+                            };
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        result?: any;
+                        toolCallId: string;
+                        toolName: string;
+                        type: "tool-result";
+                      }
+                    | {
+                        approvalId: string;
+                        approved: boolean;
+                        providerExecuted?: boolean;
+                        providerMetadata?: Record<string, Record<string, any>>;
+                        providerOptions?: Record<string, Record<string, any>>;
+                        reason?: string;
+                        type: "tool-approval-response";
+                      }
+                  >;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "tool";
+                }
+              | {
+                  content: string;
+                  providerOptions?: Record<string, Record<string, any>>;
+                  role: "system";
+                };
+            model?: string;
+            provider?: string;
+            providerOptions?: Record<string, Record<string, any>>;
+            status?: "pending" | "success" | "failed";
+          };
+        },
+        {
+          _creationTime: number;
+          _id: string;
+          agentName?: string;
+          embeddingId?: string;
+          error?: string;
+          fileIds?: Array<string>;
+          finishReason?:
+            | "stop"
+            | "length"
+            | "content-filter"
+            | "tool-calls"
+            | "error"
+            | "other"
+            | "unknown";
+          id?: string;
+          message?:
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          image: string | ArrayBuffer;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "image";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "user";
+              }
+            | {
+                content:
+                  | string
+                  | Array<
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          text: string;
+                          type: "text";
+                        }
+                      | {
+                          data: string | ArrayBuffer;
+                          filename?: string;
+                          mediaType?: string;
+                          mimeType?: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "file";
+                        }
+                      | {
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          signature?: string;
+                          text: string;
+                          type: "reasoning";
+                        }
+                      | {
+                          data: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          type: "redacted-reasoning";
+                        }
+                      | {
+                          args?: any;
+                          input: any;
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-call";
+                        }
+                      | {
+                          args?: any;
+                          experimental_content?: Array<
+                            | { text: string; type: "text" }
+                            | { data: string; mimeType?: string; type: "image" }
+                          >;
+                          isError?: boolean;
+                          output?:
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-text";
+                                value: string;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                type: "error-json";
+                                value: any;
+                              }
+                            | {
+                                providerOptions?: Record<
+                                  string,
+                                  Record<string, any>
+                                >;
+                                reason?: string;
+                                type: "execution-denied";
+                              }
+                            | {
+                                type: "content";
+                                value: Array<
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      text: string;
+                                      type: "text";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      type: "media";
+                                    }
+                                  | {
+                                      data: string;
+                                      filename?: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "file-id";
+                                    }
+                                  | {
+                                      data: string;
+                                      mediaType: string;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-data";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-url";
+                                      url: string;
+                                    }
+                                  | {
+                                      fileId: string | Record<string, string>;
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "image-file-id";
+                                    }
+                                  | {
+                                      providerOptions?: Record<
+                                        string,
+                                        Record<string, any>
+                                      >;
+                                      type: "custom";
+                                    }
+                                >;
+                              };
+                          providerExecuted?: boolean;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          result?: any;
+                          toolCallId: string;
+                          toolName: string;
+                          type: "tool-result";
+                        }
+                      | {
+                          id: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "url";
+                          title?: string;
+                          type: "source";
+                          url: string;
+                        }
+                      | {
+                          filename?: string;
+                          id: string;
+                          mediaType: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          sourceType: "document";
+                          title: string;
+                          type: "source";
+                        }
+                      | {
+                          approvalId: string;
+                          providerMetadata?: Record<
+                            string,
+                            Record<string, any>
+                          >;
+                          providerOptions?: Record<string, Record<string, any>>;
+                          toolCallId: string;
+                          type: "tool-approval-request";
+                        }
+                    >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "assistant";
+              }
+            | {
+                content: Array<
+                  | {
+                      args?: any;
+                      experimental_content?: Array<
+                        | { text: string; type: "text" }
+                        | { data: string; mimeType?: string; type: "image" }
+                      >;
+                      isError?: boolean;
+                      output?:
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-text";
+                            value: string;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            type: "error-json";
+                            value: any;
+                          }
+                        | {
+                            providerOptions?: Record<
+                              string,
+                              Record<string, any>
+                            >;
+                            reason?: string;
+                            type: "execution-denied";
+                          }
+                        | {
+                            type: "content";
+                            value: Array<
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  text: string;
+                                  type: "text";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  type: "media";
+                                }
+                              | {
+                                  data: string;
+                                  filename?: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "file-id";
+                                }
+                              | {
+                                  data: string;
+                                  mediaType: string;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-data";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-url";
+                                  url: string;
+                                }
+                              | {
+                                  fileId: string | Record<string, string>;
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "image-file-id";
+                                }
+                              | {
+                                  providerOptions?: Record<
+                                    string,
+                                    Record<string, any>
+                                  >;
+                                  type: "custom";
+                                }
+                            >;
+                          };
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      result?: any;
+                      toolCallId: string;
+                      toolName: string;
+                      type: "tool-result";
+                    }
+                  | {
+                      approvalId: string;
+                      approved: boolean;
+                      providerExecuted?: boolean;
+                      providerMetadata?: Record<string, Record<string, any>>;
+                      providerOptions?: Record<string, Record<string, any>>;
+                      reason?: string;
+                      type: "tool-approval-response";
+                    }
+                >;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "tool";
+              }
+            | {
+                content: string;
+                providerOptions?: Record<string, Record<string, any>>;
+                role: "system";
+              };
+          model?: string;
+          order: number;
+          provider?: string;
+          providerMetadata?: Record<string, Record<string, any>>;
+          providerOptions?: Record<string, Record<string, any>>;
+          reasoning?: string;
+          reasoningDetails?: Array<
+            | {
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                signature?: string;
+                text: string;
+                type: "reasoning";
+              }
+            | { signature?: string; text: string; type: "text" }
+            | { data: string; type: "redacted" }
+          >;
+          sources?: Array<
+            | {
+                id: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "url";
+                title?: string;
+                type?: "source";
+                url: string;
+              }
+            | {
+                filename?: string;
+                id: string;
+                mediaType: string;
+                providerMetadata?: Record<string, Record<string, any>>;
+                providerOptions?: Record<string, Record<string, any>>;
+                sourceType: "document";
+                title: string;
+                type: "source";
+              }
+          >;
+          status: "pending" | "success" | "failed";
+          stepOrder: number;
+          text?: string;
+          threadId: string;
+          tool: boolean;
+          usage?: {
+            cachedInputTokens?: number;
+            completionTokens: number;
+            promptTokens: number;
+            reasoningTokens?: number;
+            totalTokens: number;
+          };
+          userId?: string;
+          warnings?: Array<
+            | { details?: string; setting: string; type: "unsupported-setting" }
+            | { details?: string; tool: any; type: "unsupported-tool" }
+            | { message: string; type: "other" }
+          >;
+        },
+        Name
+      >;
+    };
+    streams: {
+      abort: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          finalDelta?: {
+            end: number;
+            parts: Array<any>;
+            start: number;
+            streamId: string;
+          };
+          reason: string;
+          streamId: string;
+        },
+        boolean,
+        Name
+      >;
+      abortByOrder: FunctionReference<
+        "mutation",
+        "internal",
+        { order: number; reason: string; threadId: string },
+        boolean,
+        Name
+      >;
+      addDelta: FunctionReference<
+        "mutation",
+        "internal",
+        { end: number; parts: Array<any>; start: number; streamId: string },
+        boolean,
+        Name
+      >;
+      create: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          agentName?: string;
+          format?: "UIMessageChunk" | "TextStreamPart";
+          model?: string;
+          order: number;
+          provider?: string;
+          providerOptions?: Record<string, Record<string, any>>;
+          stepOrder: number;
+          threadId: string;
+          userId?: string;
+        },
+        string,
+        Name
+      >;
+      deleteAllStreamsForThreadIdAsync: FunctionReference<
+        "mutation",
+        "internal",
+        { deltaCursor?: string; streamOrder?: number; threadId: string },
+        { deltaCursor?: string; isDone: boolean; streamOrder?: number },
+        Name
+      >;
+      deleteAllStreamsForThreadIdSync: FunctionReference<
+        "action",
+        "internal",
+        { threadId: string },
+        null,
+        Name
+      >;
+      deleteStreamAsync: FunctionReference<
+        "mutation",
+        "internal",
+        { cursor?: string; streamId: string },
+        null,
+        Name
+      >;
+      deleteStreamSync: FunctionReference<
+        "mutation",
+        "internal",
+        { streamId: string },
+        null,
+        Name
+      >;
+      finish: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          finalDelta?: {
+            end: number;
+            parts: Array<any>;
+            start: number;
+            streamId: string;
+          };
+          streamId: string;
+        },
+        null,
+        Name
+      >;
+      heartbeat: FunctionReference<
+        "mutation",
+        "internal",
+        { streamId: string },
+        null,
+        Name
+      >;
+      list: FunctionReference<
+        "query",
+        "internal",
+        {
+          startOrder?: number;
+          statuses?: Array<"streaming" | "finished" | "aborted">;
+          threadId: string;
+        },
+        Array<{
+          agentName?: string;
+          format?: "UIMessageChunk" | "TextStreamPart";
+          model?: string;
+          order: number;
+          provider?: string;
+          providerOptions?: Record<string, Record<string, any>>;
+          status: "streaming" | "finished" | "aborted";
+          stepOrder: number;
+          streamId: string;
+          userId?: string;
+        }>,
+        Name
+      >;
+      listDeltas: FunctionReference<
+        "query",
+        "internal",
+        {
+          cursors: Array<{ cursor: number; streamId: string }>;
+          threadId: string;
+        },
+        Array<{
+          end: number;
+          parts: Array<any>;
+          start: number;
+          streamId: string;
+        }>,
+        Name
+      >;
+    };
+    threads: {
+      createThread: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          defaultSystemPrompt?: string;
+          parentThreadIds?: Array<string>;
+          summary?: string;
+          title?: string;
+          userId?: string;
+        },
+        {
+          _creationTime: number;
+          _id: string;
+          status: "active" | "archived";
+          summary?: string;
+          title?: string;
+          userId?: string;
+        },
+        Name
+      >;
+      deleteAllForThreadIdAsync: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          cursor?: string;
+          deltaCursor?: string;
+          limit?: number;
+          messagesDone?: boolean;
+          streamOrder?: number;
+          streamsDone?: boolean;
+          threadId: string;
+        },
+        { isDone: boolean },
+        Name
+      >;
+      deleteAllForThreadIdSync: FunctionReference<
+        "action",
+        "internal",
+        { limit?: number; threadId: string },
+        null,
+        Name
+      >;
+      getThread: FunctionReference<
+        "query",
+        "internal",
+        { threadId: string },
+        {
+          _creationTime: number;
+          _id: string;
+          status: "active" | "archived";
+          summary?: string;
+          title?: string;
+          userId?: string;
+        } | null,
+        Name
+      >;
+      listThreadsByUserId: FunctionReference<
+        "query",
+        "internal",
+        {
+          order?: "asc" | "desc";
+          paginationOpts?: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
+          userId?: string;
+        },
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            status: "active" | "archived";
+            summary?: string;
+            title?: string;
+            userId?: string;
+          }>;
+          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+          splitCursor?: string | null;
+        },
+        Name
+      >;
+      searchThreadTitles: FunctionReference<
+        "query",
+        "internal",
+        { limit: number; query: string; userId?: string | null },
+        Array<{
+          _creationTime: number;
+          _id: string;
+          status: "active" | "archived";
+          summary?: string;
+          title?: string;
+          userId?: string;
+        }>,
+        Name
+      >;
+      updateThread: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          patch: {
+            status?: "active" | "archived";
+            summary?: string;
+            title?: string;
+            userId?: string;
+          };
+          threadId: string;
+        },
+        {
+          _creationTime: number;
+          _id: string;
+          status: "active" | "archived";
+          summary?: string;
+          title?: string;
+          userId?: string;
+        },
+        Name
+      >;
+    };
+    users: {
+      deleteAllForUserId: FunctionReference<
+        "action",
+        "internal",
+        { userId: string },
+        null,
+        Name
+      >;
+      deleteAllForUserIdAsync: FunctionReference<
+        "mutation",
+        "internal",
+        { userId: string },
+        boolean,
+        Name
+      >;
+      listUsersWithThreads: FunctionReference<
+        "query",
+        "internal",
+        {
+          paginationOpts: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
+        },
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<string>;
+          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+          splitCursor?: string | null;
+        },
+        Name
+      >;
+    };
+    vector: {
+      index: {
+        deleteBatch: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            ids: Array<
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+            >;
+          },
+          null,
+          Name
+        >;
+        deleteBatchForThread: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            cursor?: string;
+            limit: number;
+            model: string;
+            threadId: string;
+            vectorDimension:
+              | 128
+              | 256
+              | 512
+              | 768
+              | 1024
+              | 1408
+              | 1536
+              | 2048
+              | 3072
+              | 4096;
+          },
+          { continueCursor: string; isDone: boolean },
+          Name
+        >;
+        insertBatch: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            vectorDimension:
+              | 128
+              | 256
+              | 512
+              | 768
+              | 1024
+              | 1408
+              | 1536
+              | 2048
+              | 3072
+              | 4096;
+            vectors: Array<{
+              messageId?: string;
+              model: string;
+              table: string;
+              threadId?: string;
+              userId?: string;
+              vector: Array<number>;
+            }>;
+          },
+          Array<
+            | string
+            | string
+            | string
+            | string
+            | string
+            | string
+            | string
+            | string
+            | string
+            | string
+          >,
+          Name
+        >;
+        paginate: FunctionReference<
+          "query",
+          "internal",
+          {
+            cursor?: string;
+            limit: number;
+            table?: string;
+            targetModel: string;
+            vectorDimension:
+              | 128
+              | 256
+              | 512
+              | 768
+              | 1024
+              | 1408
+              | 1536
+              | 2048
+              | 3072
+              | 4096;
+          },
+          {
+            continueCursor: string;
+            ids: Array<
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+              | string
+            >;
+            isDone: boolean;
+          },
+          Name
+        >;
+        updateBatch: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            vectors: Array<{
+              id:
+                | string
+                | string
+                | string
+                | string
+                | string
+                | string
+                | string
+                | string
+                | string
+                | string;
+              model: string;
+              vector: Array<number>;
+            }>;
+          },
+          null,
+          Name
+        >;
+      };
+    };
+  };
diff --git a/src/validators.ts b/src/validators.ts
index f7ecea38..f8e03132 100644
--- a/src/validators.ts
+++ b/src/validators.ts
@@ -115,17 +115,34 @@ export const vSourcePart = v.union(
 );
 export type SourcePart = Infer<typeof vSourcePart>;
 
-export const vToolCallPart = v.object({
-  type: v.literal("tool-call"),
-  toolCallId: v.string(),
-  toolName: v.string(),
-  input: v.any(),
-  /** @deprecated Use `input` instead. */
-  args: v.optional(v.any()),
-  providerExecuted: v.optional(v.boolean()),
-  providerOptions,
-  providerMetadata,
-});
+// Union type to support both old (args) and new (input) formats
+// Both include input for type hint support
+export const vToolCallPart = v.union(
+  // New format: input is primary, args is optional for backwards compat
+  v.object({
+    type: v.literal("tool-call"),
+    toolCallId: v.string(),
+    toolName: v.string(),
+    input: v.any(),
+    /** @deprecated Use `input` instead. */
+    args: v.optional(v.any()),
+    providerExecuted: v.optional(v.boolean()),
+    providerOptions,
+    providerMetadata,
+  }),
+  // Legacy format: args is present, input is optional
+  v.object({
+    type: v.literal("tool-call"),
+    toolCallId: v.string(),
+    toolName: v.string(),
+    /** @deprecated Use `input` instead. */
+    args: v.any(),
+    input: v.optional(v.any()),
+    providerExecuted: v.optional(v.boolean()),
+    providerOptions,
+    providerMetadata,
+  }),
+);
 
 const vToolResultContent = v.array(
   v.union(

From ca35f100e8eb87fb6fdfa56158abf0ec73af0146 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 18 Jan 2026 02:24:13 +0000
Subject: [PATCH 19/26] Fix AI SDK v6 type errors: tool-call input/args union
 type and tool-result output types

Co-authored-by: zboyles <2215540+zboyles@users.noreply.github.com>
---
 src/component/_generated/component.ts.backup | 4785 ------------------
 1 file changed, 4785 deletions(-)
 delete mode 100644 src/component/_generated/component.ts.backup

diff --git a/src/component/_generated/component.ts.backup b/src/component/_generated/component.ts.backup
deleted file mode 100644
index b64ff3ed..00000000
--- a/src/component/_generated/component.ts.backup
+++ /dev/null
@@ -1,4785 +0,0 @@
-/* eslint-disable */
-/**
- * Generated `ComponentApi` utility.
- *
- * THIS CODE IS AUTOMATICALLY GENERATED.
- *
- * To regenerate, run `npx convex dev`.
- * @module
- */
-
-import type { FunctionReference } from "convex/server";
-
-/**
- * A utility for referencing a Convex component's exposed API.
- *
- * Useful when expecting a parameter like `components.myComponent`.
- * Usage:
- * ```ts
- * async function myFunction(ctx: QueryCtx, component: ComponentApi) {
- *   return ctx.runQuery(component.someFile.someQuery, { ...args });
- * }
- * ```
- */
-export type ComponentApi<Name extends string | undefined = string | undefined> =
-  {
-    apiKeys: {
-      destroy: FunctionReference<
-        "mutation",
-        "internal",
-        { apiKey?: string; name?: string },
-        | "missing"
-        | "deleted"
-        | "name mismatch"
-        | "must provide either apiKey or name",
-        Name
-      >;
-      issue: FunctionReference<
-        "mutation",
-        "internal",
-        { name?: string },
-        string,
-        Name
-      >;
-      validate: FunctionReference<
-        "query",
-        "internal",
-        { apiKey: string },
-        boolean,
-        Name
-      >;
-    };
-    files: {
-      addFile: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          filename?: string;
-          hash: string;
-          mediaType?: string;
-          mimeType?: string;
-          storageId: string;
-        },
-        { fileId: string; storageId: string },
-        Name
-      >;
-      copyFile: FunctionReference<
-        "mutation",
-        "internal",
-        { fileId: string },
-        null,
-        Name
-      >;
-      deleteFiles: FunctionReference<
-        "mutation",
-        "internal",
-        { fileIds: Array<string>; force?: boolean },
-        Array<string>,
-        Name
-      >;
-      get: FunctionReference<
-        "query",
-        "internal",
-        { fileId: string },
-        null | {
-          _creationTime: number;
-          _id: string;
-          filename?: string;
-          hash: string;
-          lastTouchedAt: number;
-          mediaType?: string;
-          mimeType?: string;
-          refcount: number;
-          storageId: string;
-        },
-        Name
-      >;
-      getFilesToDelete: FunctionReference<
-        "query",
-        "internal",
-        {
-          paginationOpts: {
-            cursor: string | null;
-            endCursor?: string | null;
-            id?: number;
-            maximumBytesRead?: number;
-            maximumRowsRead?: number;
-            numItems: number;
-          };
-        },
-        {
-          continueCursor: string;
-          isDone: boolean;
-          page: Array<{
-            _creationTime: number;
-            _id: string;
-            filename?: string;
-            hash: string;
-            lastTouchedAt: number;
-            mediaType?: string;
-            mimeType?: string;
-            refcount: number;
-            storageId: string;
-          }>;
-        },
-        Name
-      >;
-      useExistingFile: FunctionReference<
-        "mutation",
-        "internal",
-        { filename?: string; hash: string },
-        null | { fileId: string; storageId: string },
-        Name
-      >;
-    };
-    messages: {
-      addMessages: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          agentName?: string;
-          embeddings?: {
-            dimension:
-              | 128
-              | 256
-              | 512
-              | 768
-              | 1024
-              | 1408
-              | 1536
-              | 2048
-              | 3072
-              | 4096;
-            model: string;
-            vectors: Array<Array<number> | null>;
-          };
-          failPendingSteps?: boolean;
-          hideFromUserIdSearch?: boolean;
-          messages: Array<{
-            error?: string;
-            fileIds?: Array<string>;
-            finishReason?:
-              | "stop"
-              | "length"
-              | "content-filter"
-              | "tool-calls"
-              | "error"
-              | "other"
-              | "unknown";
-            message:
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            image: string | ArrayBuffer;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "image";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "user";
-                }
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            signature?: string;
-                            text: string;
-                            type: "reasoning";
-                          }
-                        | {
-                            data: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "redacted-reasoning";
-                          }
-                        | {
-                            args?: any;
-                            input: any;
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-call";
-                          }
-                        | {
-                            args?: any;
-                            experimental_content?: Array<
-                              | { text: string; type: "text" }
-                              | {
-                                  data: string;
-                                  mimeType?: string;
-                                  type: "image";
-                                }
-                            >;
-                            isError?: boolean;
-                            output?:
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "text";
-                                  value: string;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "json";
-                                  value: any;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "error-text";
-                                  value: string;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "error-json";
-                                  value: any;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  reason?: string;
-                                  type: "execution-denied";
-                                }
-                              | {
-                                  type: "content";
-                                  value: Array<
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        text: string;
-                                        type: "text";
-                                      }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        type: "media";
-                                      }
-                                    | {
-                                        data: string;
-                                        filename?: string;
-                                        mediaType: string;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-data";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-url";
-                                        url: string;
-                                      }
-                                    | {
-                                        fileId: string | Record<string, string>;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-id";
-                                      }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-data";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-url";
-                                        url: string;
-                                      }
-                                    | {
-                                        fileId: string | Record<string, string>;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-file-id";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "custom";
-                                      }
-                                  >;
-                                };
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            result?: any;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-result";
-                          }
-                        | {
-                            id: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "url";
-                            title?: string;
-                            type: "source";
-                            url: string;
-                          }
-                        | {
-                            filename?: string;
-                            id: string;
-                            mediaType: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "document";
-                            title: string;
-                            type: "source";
-                          }
-                        | {
-                            approvalId: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            type: "tool-approval-request";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "assistant";
-                }
-              | {
-                  content: Array<
-                    | {
-                        args?: any;
-                        experimental_content?: Array<
-                          | { text: string; type: "text" }
-                          | { data: string; mimeType?: string; type: "image" }
-                        >;
-                        isError?: boolean;
-                        output?:
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "text";
-                              value: string;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "json";
-                              value: any;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "error-text";
-                              value: string;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "error-json";
-                              value: any;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              reason?: string;
-                              type: "execution-denied";
-                            }
-                          | {
-                              type: "content";
-                              value: Array<
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    text: string;
-                                    type: "text";
-                                  }
-                                | {
-                                    data: string;
-                                    mediaType: string;
-                                    type: "media";
-                                  }
-                                | {
-                                    data: string;
-                                    filename?: string;
-                                    mediaType: string;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-data";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-url";
-                                    url: string;
-                                  }
-                                | {
-                                    fileId: string | Record<string, string>;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-id";
-                                  }
-                                | {
-                                    data: string;
-                                    mediaType: string;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-data";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-url";
-                                    url: string;
-                                  }
-                                | {
-                                    fileId: string | Record<string, string>;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-file-id";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "custom";
-                                  }
-                              >;
-                            };
-                        providerExecuted?: boolean;
-                        providerMetadata?: Record<string, Record<string, any>>;
-                        providerOptions?: Record<string, Record<string, any>>;
-                        result?: any;
-                        toolCallId: string;
-                        toolName: string;
-                        type: "tool-result";
-                      }
-                    | {
-                        approvalId: string;
-                        approved: boolean;
-                        providerExecuted?: boolean;
-                        providerMetadata?: Record<string, Record<string, any>>;
-                        providerOptions?: Record<string, Record<string, any>>;
-                        reason?: string;
-                        type: "tool-approval-response";
-                      }
-                  >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "tool";
-                }
-              | {
-                  content: string;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "system";
-                };
-            model?: string;
-            provider?: string;
-            providerMetadata?: Record<string, Record<string, any>>;
-            reasoning?: string;
-            reasoningDetails?: Array<
-              | {
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  signature?: string;
-                  text: string;
-                  type: "reasoning";
-                }
-              | { signature?: string; text: string; type: "text" }
-              | { data: string; type: "redacted" }
-            >;
-            sources?: Array<
-              | {
-                  id: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "url";
-                  title?: string;
-                  type?: "source";
-                  url: string;
-                }
-              | {
-                  filename?: string;
-                  id: string;
-                  mediaType: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "document";
-                  title: string;
-                  type: "source";
-                }
-            >;
-            status?: "pending" | "success" | "failed";
-            text?: string;
-            usage?: {
-              cachedInputTokens?: number;
-              completionTokens: number;
-              promptTokens: number;
-              reasoningTokens?: number;
-              totalTokens: number;
-            };
-            warnings?: Array<
-              | {
-                  details?: string;
-                  setting: string;
-                  type: "unsupported-setting";
-                }
-              | { details?: string; tool: any; type: "unsupported-tool" }
-              | { message: string; type: "other" }
-            >;
-          }>;
-          pendingMessageId?: string;
-          promptMessageId?: string;
-          threadId: string;
-          userId?: string;
-        },
-        {
-          messages: Array<{
-            _creationTime: number;
-            _id: string;
-            agentName?: string;
-            embeddingId?: string;
-            error?: string;
-            fileIds?: Array<string>;
-            finishReason?:
-              | "stop"
-              | "length"
-              | "content-filter"
-              | "tool-calls"
-              | "error"
-              | "other"
-              | "unknown";
-            id?: string;
-            message?:
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            image: string | ArrayBuffer;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "image";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "user";
-                }
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            signature?: string;
-                            text: string;
-                            type: "reasoning";
-                          }
-                        | {
-                            data: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "redacted-reasoning";
-                          }
-                        | {
-                            args?: any;
-                            input: any;
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-call";
-                          }
-                        | {
-                            args?: any;
-                            experimental_content?: Array<
-                              | { text: string; type: "text" }
-                              | {
-                                  data: string;
-                                  mimeType?: string;
-                                  type: "image";
-                                }
-                            >;
-                            isError?: boolean;
-                            output?:
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "text";
-                                  value: string;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "json";
-                                  value: any;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "error-text";
-                                  value: string;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "error-json";
-                                  value: any;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  reason?: string;
-                                  type: "execution-denied";
-                                }
-                              | {
-                                  type: "content";
-                                  value: Array<
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        text: string;
-                                        type: "text";
-                                      }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        type: "media";
-                                      }
-                                    | {
-                                        data: string;
-                                        filename?: string;
-                                        mediaType: string;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-data";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-url";
-                                        url: string;
-                                      }
-                                    | {
-                                        fileId: string | Record<string, string>;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-id";
-                                      }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-data";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-url";
-                                        url: string;
-                                      }
-                                    | {
-                                        fileId: string | Record<string, string>;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-file-id";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "custom";
-                                      }
-                                  >;
-                                };
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            result?: any;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-result";
-                          }
-                        | {
-                            id: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "url";
-                            title?: string;
-                            type: "source";
-                            url: string;
-                          }
-                        | {
-                            filename?: string;
-                            id: string;
-                            mediaType: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "document";
-                            title: string;
-                            type: "source";
-                          }
-                        | {
-                            approvalId: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            type: "tool-approval-request";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "assistant";
-                }
-              | {
-                  content: Array<
-                    | {
-                        args?: any;
-                        experimental_content?: Array<
-                          | { text: string; type: "text" }
-                          | { data: string; mimeType?: string; type: "image" }
-                        >;
-                        isError?: boolean;
-                        output?:
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "text";
-                              value: string;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "json";
-                              value: any;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "error-text";
-                              value: string;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "error-json";
-                              value: any;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              reason?: string;
-                              type: "execution-denied";
-                            }
-                          | {
-                              type: "content";
-                              value: Array<
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    text: string;
-                                    type: "text";
-                                  }
-                                | {
-                                    data: string;
-                                    mediaType: string;
-                                    type: "media";
-                                  }
-                                | {
-                                    data: string;
-                                    filename?: string;
-                                    mediaType: string;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-data";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-url";
-                                    url: string;
-                                  }
-                                | {
-                                    fileId: string | Record<string, string>;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-id";
-                                  }
-                                | {
-                                    data: string;
-                                    mediaType: string;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-data";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-url";
-                                    url: string;
-                                  }
-                                | {
-                                    fileId: string | Record<string, string>;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-file-id";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "custom";
-                                  }
-                              >;
-                            };
-                        providerExecuted?: boolean;
-                        providerMetadata?: Record<string, Record<string, any>>;
-                        providerOptions?: Record<string, Record<string, any>>;
-                        result?: any;
-                        toolCallId: string;
-                        toolName: string;
-                        type: "tool-result";
-                      }
-                    | {
-                        approvalId: string;
-                        approved: boolean;
-                        providerExecuted?: boolean;
-                        providerMetadata?: Record<string, Record<string, any>>;
-                        providerOptions?: Record<string, Record<string, any>>;
-                        reason?: string;
-                        type: "tool-approval-response";
-                      }
-                  >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "tool";
-                }
-              | {
-                  content: string;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "system";
-                };
-            model?: string;
-            order: number;
-            provider?: string;
-            providerMetadata?: Record<string, Record<string, any>>;
-            providerOptions?: Record<string, Record<string, any>>;
-            reasoning?: string;
-            reasoningDetails?: Array<
-              | {
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  signature?: string;
-                  text: string;
-                  type: "reasoning";
-                }
-              | { signature?: string; text: string; type: "text" }
-              | { data: string; type: "redacted" }
-            >;
-            sources?: Array<
-              | {
-                  id: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "url";
-                  title?: string;
-                  type?: "source";
-                  url: string;
-                }
-              | {
-                  filename?: string;
-                  id: string;
-                  mediaType: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "document";
-                  title: string;
-                  type: "source";
-                }
-            >;
-            status: "pending" | "success" | "failed";
-            stepOrder: number;
-            text?: string;
-            threadId: string;
-            tool: boolean;
-            usage?: {
-              cachedInputTokens?: number;
-              completionTokens: number;
-              promptTokens: number;
-              reasoningTokens?: number;
-              totalTokens: number;
-            };
-            userId?: string;
-            warnings?: Array<
-              | {
-                  details?: string;
-                  setting: string;
-                  type: "unsupported-setting";
-                }
-              | { details?: string; tool: any; type: "unsupported-tool" }
-              | { message: string; type: "other" }
-            >;
-          }>;
-        },
-        Name
-      >;
-      cloneThread: FunctionReference<
-        "action",
-        "internal",
-        {
-          batchSize?: number;
-          copyUserIdForVectorSearch?: boolean;
-          excludeToolMessages?: boolean;
-          insertAtOrder?: number;
-          limit?: number;
-          sourceThreadId: string;
-          statuses?: Array<"pending" | "success" | "failed">;
-          targetThreadId: string;
-          upToAndIncludingMessageId?: string;
-        },
-        number,
-        Name
-      >;
-      deleteByIds: FunctionReference<
-        "mutation",
-        "internal",
-        { messageIds: Array<string> },
-        Array<string>,
-        Name
-      >;
-      deleteByOrder: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          endOrder: number;
-          endStepOrder?: number;
-          startOrder: number;
-          startStepOrder?: number;
-          threadId: string;
-        },
-        { isDone: boolean; lastOrder?: number; lastStepOrder?: number },
-        Name
-      >;
-      finalizeMessage: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          messageId: string;
-          result: { status: "success" } | { error: string; status: "failed" };
-        },
-        null,
-        Name
-      >;
-      getMessagesByIds: FunctionReference<
-        "query",
-        "internal",
-        { messageIds: Array<string> },
-        Array<null | {
-          _creationTime: number;
-          _id: string;
-          agentName?: string;
-          embeddingId?: string;
-          error?: string;
-          fileIds?: Array<string>;
-          finishReason?:
-            | "stop"
-            | "length"
-            | "content-filter"
-            | "tool-calls"
-            | "error"
-            | "other"
-            | "unknown";
-          id?: string;
-          message?:
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          image: string | ArrayBuffer;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "image";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "user";
-              }
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          signature?: string;
-                          text: string;
-                          type: "reasoning";
-                        }
-                      | {
-                          data: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "redacted-reasoning";
-                        }
-                      | {
-                          args?: any;
-                          input: any;
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-call";
-                        }
-                      | {
-                          args?: any;
-                          experimental_content?: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mimeType?: string; type: "image" }
-                          >;
-                          isError?: boolean;
-                          output?:
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "text";
-                                value: string;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "json";
-                                value: any;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "error-text";
-                                value: string;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "error-json";
-                                value: any;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                reason?: string;
-                                type: "execution-denied";
-                              }
-                            | {
-                                type: "content";
-                                value: Array<
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      text: string;
-                                      type: "text";
-                                    }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      type: "media";
-                                    }
-                                  | {
-                                      data: string;
-                                      filename?: string;
-                                      mediaType: string;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-data";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-url";
-                                      url: string;
-                                    }
-                                  | {
-                                      fileId: string | Record<string, string>;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-id";
-                                    }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-data";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-url";
-                                      url: string;
-                                    }
-                                  | {
-                                      fileId: string | Record<string, string>;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-file-id";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "custom";
-                                    }
-                                >;
-                              };
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          result?: any;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-result";
-                        }
-                      | {
-                          id: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "url";
-                          title?: string;
-                          type: "source";
-                          url: string;
-                        }
-                      | {
-                          filename?: string;
-                          id: string;
-                          mediaType: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "document";
-                          title: string;
-                          type: "source";
-                        }
-                      | {
-                          approvalId: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          type: "tool-approval-request";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "assistant";
-              }
-            | {
-                content: Array<
-                  | {
-                      args?: any;
-                      experimental_content?: Array<
-                        | { text: string; type: "text" }
-                        | { data: string; mimeType?: string; type: "image" }
-                      >;
-                      isError?: boolean;
-                      output?:
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "text";
-                            value: string;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "json";
-                            value: any;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "error-text";
-                            value: string;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "error-json";
-                            value: any;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            reason?: string;
-                            type: "execution-denied";
-                          }
-                        | {
-                            type: "content";
-                            value: Array<
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  text: string;
-                                  type: "text";
-                                }
-                              | {
-                                  data: string;
-                                  mediaType: string;
-                                  type: "media";
-                                }
-                              | {
-                                  data: string;
-                                  filename?: string;
-                                  mediaType: string;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-data";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-url";
-                                  url: string;
-                                }
-                              | {
-                                  fileId: string | Record<string, string>;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-id";
-                                }
-                              | {
-                                  data: string;
-                                  mediaType: string;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-data";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-url";
-                                  url: string;
-                                }
-                              | {
-                                  fileId: string | Record<string, string>;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-file-id";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "custom";
-                                }
-                            >;
-                          };
-                      providerExecuted?: boolean;
-                      providerMetadata?: Record<string, Record<string, any>>;
-                      providerOptions?: Record<string, Record<string, any>>;
-                      result?: any;
-                      toolCallId: string;
-                      toolName: string;
-                      type: "tool-result";
-                    }
-                  | {
-                      approvalId: string;
-                      approved: boolean;
-                      providerExecuted?: boolean;
-                      providerMetadata?: Record<string, Record<string, any>>;
-                      providerOptions?: Record<string, Record<string, any>>;
-                      reason?: string;
-                      type: "tool-approval-response";
-                    }
-                >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "tool";
-              }
-            | {
-                content: string;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "system";
-              };
-          model?: string;
-          order: number;
-          provider?: string;
-          providerMetadata?: Record<string, Record<string, any>>;
-          providerOptions?: Record<string, Record<string, any>>;
-          reasoning?: string;
-          reasoningDetails?: Array<
-            | {
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                signature?: string;
-                text: string;
-                type: "reasoning";
-              }
-            | { signature?: string; text: string; type: "text" }
-            | { data: string; type: "redacted" }
-          >;
-          sources?: Array<
-            | {
-                id: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "url";
-                title?: string;
-                type?: "source";
-                url: string;
-              }
-            | {
-                filename?: string;
-                id: string;
-                mediaType: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "document";
-                title: string;
-                type: "source";
-              }
-          >;
-          status: "pending" | "success" | "failed";
-          stepOrder: number;
-          text?: string;
-          threadId: string;
-          tool: boolean;
-          usage?: {
-            cachedInputTokens?: number;
-            completionTokens: number;
-            promptTokens: number;
-            reasoningTokens?: number;
-            totalTokens: number;
-          };
-          userId?: string;
-          warnings?: Array<
-            | { details?: string; setting: string; type: "unsupported-setting" }
-            | { details?: string; tool: any; type: "unsupported-tool" }
-            | { message: string; type: "other" }
-          >;
-        }>,
-        Name
-      >;
-      getMessageSearchFields: FunctionReference<
-        "query",
-        "internal",
-        { messageId: string },
-        { embedding?: Array<number>; embeddingModel?: string; text?: string },
-        Name
-      >;
-      listMessagesByThreadId: FunctionReference<
-        "query",
-        "internal",
-        {
-          excludeToolMessages?: boolean;
-          order: "asc" | "desc";
-          paginationOpts?: {
-            cursor: string | null;
-            endCursor?: string | null;
-            id?: number;
-            maximumBytesRead?: number;
-            maximumRowsRead?: number;
-            numItems: number;
-          };
-          statuses?: Array<"pending" | "success" | "failed">;
-          threadId: string;
-          upToAndIncludingMessageId?: string;
-        },
-        {
-          continueCursor: string;
-          isDone: boolean;
-          page: Array<{
-            _creationTime: number;
-            _id: string;
-            agentName?: string;
-            embeddingId?: string;
-            error?: string;
-            fileIds?: Array<string>;
-            finishReason?:
-              | "stop"
-              | "length"
-              | "content-filter"
-              | "tool-calls"
-              | "error"
-              | "other"
-              | "unknown";
-            id?: string;
-            message?:
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            image: string | ArrayBuffer;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "image";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "user";
-                }
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            signature?: string;
-                            text: string;
-                            type: "reasoning";
-                          }
-                        | {
-                            data: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "redacted-reasoning";
-                          }
-                        | {
-                            args?: any;
-                            input: any;
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-call";
-                          }
-                        | {
-                            args?: any;
-                            experimental_content?: Array<
-                              | { text: string; type: "text" }
-                              | {
-                                  data: string;
-                                  mimeType?: string;
-                                  type: "image";
-                                }
-                            >;
-                            isError?: boolean;
-                            output?:
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "text";
-                                  value: string;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "json";
-                                  value: any;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "error-text";
-                                  value: string;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "error-json";
-                                  value: any;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  reason?: string;
-                                  type: "execution-denied";
-                                }
-                              | {
-                                  type: "content";
-                                  value: Array<
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        text: string;
-                                        type: "text";
-                                      }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        type: "media";
-                                      }
-                                    | {
-                                        data: string;
-                                        filename?: string;
-                                        mediaType: string;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-data";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-url";
-                                        url: string;
-                                      }
-                                    | {
-                                        fileId: string | Record<string, string>;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-id";
-                                      }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-data";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-url";
-                                        url: string;
-                                      }
-                                    | {
-                                        fileId: string | Record<string, string>;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-file-id";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "custom";
-                                      }
-                                  >;
-                                };
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            result?: any;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-result";
-                          }
-                        | {
-                            id: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "url";
-                            title?: string;
-                            type: "source";
-                            url: string;
-                          }
-                        | {
-                            filename?: string;
-                            id: string;
-                            mediaType: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "document";
-                            title: string;
-                            type: "source";
-                          }
-                        | {
-                            approvalId: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            type: "tool-approval-request";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "assistant";
-                }
-              | {
-                  content: Array<
-                    | {
-                        args?: any;
-                        experimental_content?: Array<
-                          | { text: string; type: "text" }
-                          | { data: string; mimeType?: string; type: "image" }
-                        >;
-                        isError?: boolean;
-                        output?:
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "text";
-                              value: string;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "json";
-                              value: any;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "error-text";
-                              value: string;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "error-json";
-                              value: any;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              reason?: string;
-                              type: "execution-denied";
-                            }
-                          | {
-                              type: "content";
-                              value: Array<
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    text: string;
-                                    type: "text";
-                                  }
-                                | {
-                                    data: string;
-                                    mediaType: string;
-                                    type: "media";
-                                  }
-                                | {
-                                    data: string;
-                                    filename?: string;
-                                    mediaType: string;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-data";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-url";
-                                    url: string;
-                                  }
-                                | {
-                                    fileId: string | Record<string, string>;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-id";
-                                  }
-                                | {
-                                    data: string;
-                                    mediaType: string;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-data";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-url";
-                                    url: string;
-                                  }
-                                | {
-                                    fileId: string | Record<string, string>;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-file-id";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "custom";
-                                  }
-                              >;
-                            };
-                        providerExecuted?: boolean;
-                        providerMetadata?: Record<string, Record<string, any>>;
-                        providerOptions?: Record<string, Record<string, any>>;
-                        result?: any;
-                        toolCallId: string;
-                        toolName: string;
-                        type: "tool-result";
-                      }
-                    | {
-                        approvalId: string;
-                        approved: boolean;
-                        providerExecuted?: boolean;
-                        providerMetadata?: Record<string, Record<string, any>>;
-                        providerOptions?: Record<string, Record<string, any>>;
-                        reason?: string;
-                        type: "tool-approval-response";
-                      }
-                  >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "tool";
-                }
-              | {
-                  content: string;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "system";
-                };
-            model?: string;
-            order: number;
-            provider?: string;
-            providerMetadata?: Record<string, Record<string, any>>;
-            providerOptions?: Record<string, Record<string, any>>;
-            reasoning?: string;
-            reasoningDetails?: Array<
-              | {
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  signature?: string;
-                  text: string;
-                  type: "reasoning";
-                }
-              | { signature?: string; text: string; type: "text" }
-              | { data: string; type: "redacted" }
-            >;
-            sources?: Array<
-              | {
-                  id: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "url";
-                  title?: string;
-                  type?: "source";
-                  url: string;
-                }
-              | {
-                  filename?: string;
-                  id: string;
-                  mediaType: string;
-                  providerMetadata?: Record<string, Record<string, any>>;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  sourceType: "document";
-                  title: string;
-                  type: "source";
-                }
-            >;
-            status: "pending" | "success" | "failed";
-            stepOrder: number;
-            text?: string;
-            threadId: string;
-            tool: boolean;
-            usage?: {
-              cachedInputTokens?: number;
-              completionTokens: number;
-              promptTokens: number;
-              reasoningTokens?: number;
-              totalTokens: number;
-            };
-            userId?: string;
-            warnings?: Array<
-              | {
-                  details?: string;
-                  setting: string;
-                  type: "unsupported-setting";
-                }
-              | { details?: string; tool: any; type: "unsupported-tool" }
-              | { message: string; type: "other" }
-            >;
-          }>;
-          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
-          splitCursor?: string | null;
-        },
-        Name
-      >;
-      searchMessages: FunctionReference<
-        "action",
-        "internal",
-        {
-          embedding?: Array<number>;
-          embeddingModel?: string;
-          limit: number;
-          messageRange?: { after: number; before: number };
-          searchAllMessagesForUserId?: string;
-          targetMessageId?: string;
-          text?: string;
-          textSearch?: boolean;
-          threadId?: string;
-          vectorScoreThreshold?: number;
-          vectorSearch?: boolean;
-        },
-        Array<{
-          _creationTime: number;
-          _id: string;
-          agentName?: string;
-          embeddingId?: string;
-          error?: string;
-          fileIds?: Array<string>;
-          finishReason?:
-            | "stop"
-            | "length"
-            | "content-filter"
-            | "tool-calls"
-            | "error"
-            | "other"
-            | "unknown";
-          id?: string;
-          message?:
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          image: string | ArrayBuffer;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "image";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "user";
-              }
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          signature?: string;
-                          text: string;
-                          type: "reasoning";
-                        }
-                      | {
-                          data: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "redacted-reasoning";
-                        }
-                      | {
-                          args?: any;
-                          input: any;
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-call";
-                        }
-                      | {
-                          args?: any;
-                          experimental_content?: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mimeType?: string; type: "image" }
-                          >;
-                          isError?: boolean;
-                          output?:
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "text";
-                                value: string;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "json";
-                                value: any;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "error-text";
-                                value: string;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "error-json";
-                                value: any;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                reason?: string;
-                                type: "execution-denied";
-                              }
-                            | {
-                                type: "content";
-                                value: Array<
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      text: string;
-                                      type: "text";
-                                    }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      type: "media";
-                                    }
-                                  | {
-                                      data: string;
-                                      filename?: string;
-                                      mediaType: string;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-data";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-url";
-                                      url: string;
-                                    }
-                                  | {
-                                      fileId: string | Record<string, string>;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-id";
-                                    }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-data";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-url";
-                                      url: string;
-                                    }
-                                  | {
-                                      fileId: string | Record<string, string>;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-file-id";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "custom";
-                                    }
-                                >;
-                              };
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          result?: any;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-result";
-                        }
-                      | {
-                          id: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "url";
-                          title?: string;
-                          type: "source";
-                          url: string;
-                        }
-                      | {
-                          filename?: string;
-                          id: string;
-                          mediaType: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "document";
-                          title: string;
-                          type: "source";
-                        }
-                      | {
-                          approvalId: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          type: "tool-approval-request";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "assistant";
-              }
-            | {
-                content: Array<
-                  | {
-                      args?: any;
-                      experimental_content?: Array<
-                        | { text: string; type: "text" }
-                        | { data: string; mimeType?: string; type: "image" }
-                      >;
-                      isError?: boolean;
-                      output?:
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "text";
-                            value: string;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "json";
-                            value: any;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "error-text";
-                            value: string;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "error-json";
-                            value: any;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            reason?: string;
-                            type: "execution-denied";
-                          }
-                        | {
-                            type: "content";
-                            value: Array<
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  text: string;
-                                  type: "text";
-                                }
-                              | {
-                                  data: string;
-                                  mediaType: string;
-                                  type: "media";
-                                }
-                              | {
-                                  data: string;
-                                  filename?: string;
-                                  mediaType: string;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-data";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-url";
-                                  url: string;
-                                }
-                              | {
-                                  fileId: string | Record<string, string>;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-id";
-                                }
-                              | {
-                                  data: string;
-                                  mediaType: string;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-data";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-url";
-                                  url: string;
-                                }
-                              | {
-                                  fileId: string | Record<string, string>;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-file-id";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "custom";
-                                }
-                            >;
-                          };
-                      providerExecuted?: boolean;
-                      providerMetadata?: Record<string, Record<string, any>>;
-                      providerOptions?: Record<string, Record<string, any>>;
-                      result?: any;
-                      toolCallId: string;
-                      toolName: string;
-                      type: "tool-result";
-                    }
-                  | {
-                      approvalId: string;
-                      approved: boolean;
-                      providerExecuted?: boolean;
-                      providerMetadata?: Record<string, Record<string, any>>;
-                      providerOptions?: Record<string, Record<string, any>>;
-                      reason?: string;
-                      type: "tool-approval-response";
-                    }
-                >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "tool";
-              }
-            | {
-                content: string;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "system";
-              };
-          model?: string;
-          order: number;
-          provider?: string;
-          providerMetadata?: Record<string, Record<string, any>>;
-          providerOptions?: Record<string, Record<string, any>>;
-          reasoning?: string;
-          reasoningDetails?: Array<
-            | {
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                signature?: string;
-                text: string;
-                type: "reasoning";
-              }
-            | { signature?: string; text: string; type: "text" }
-            | { data: string; type: "redacted" }
-          >;
-          sources?: Array<
-            | {
-                id: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "url";
-                title?: string;
-                type?: "source";
-                url: string;
-              }
-            | {
-                filename?: string;
-                id: string;
-                mediaType: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "document";
-                title: string;
-                type: "source";
-              }
-          >;
-          status: "pending" | "success" | "failed";
-          stepOrder: number;
-          text?: string;
-          threadId: string;
-          tool: boolean;
-          usage?: {
-            cachedInputTokens?: number;
-            completionTokens: number;
-            promptTokens: number;
-            reasoningTokens?: number;
-            totalTokens: number;
-          };
-          userId?: string;
-          warnings?: Array<
-            | { details?: string; setting: string; type: "unsupported-setting" }
-            | { details?: string; tool: any; type: "unsupported-tool" }
-            | { message: string; type: "other" }
-          >;
-        }>,
-        Name
-      >;
-      textSearch: FunctionReference<
-        "query",
-        "internal",
-        {
-          limit: number;
-          searchAllMessagesForUserId?: string;
-          targetMessageId?: string;
-          text?: string;
-          threadId?: string;
-        },
-        Array<{
-          _creationTime: number;
-          _id: string;
-          agentName?: string;
-          embeddingId?: string;
-          error?: string;
-          fileIds?: Array<string>;
-          finishReason?:
-            | "stop"
-            | "length"
-            | "content-filter"
-            | "tool-calls"
-            | "error"
-            | "other"
-            | "unknown";
-          id?: string;
-          message?:
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          image: string | ArrayBuffer;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "image";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "user";
-              }
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          signature?: string;
-                          text: string;
-                          type: "reasoning";
-                        }
-                      | {
-                          data: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "redacted-reasoning";
-                        }
-                      | {
-                          args?: any;
-                          input: any;
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-call";
-                        }
-                      | {
-                          args?: any;
-                          experimental_content?: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mimeType?: string; type: "image" }
-                          >;
-                          isError?: boolean;
-                          output?:
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "text";
-                                value: string;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "json";
-                                value: any;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "error-text";
-                                value: string;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "error-json";
-                                value: any;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                reason?: string;
-                                type: "execution-denied";
-                              }
-                            | {
-                                type: "content";
-                                value: Array<
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      text: string;
-                                      type: "text";
-                                    }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      type: "media";
-                                    }
-                                  | {
-                                      data: string;
-                                      filename?: string;
-                                      mediaType: string;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-data";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-url";
-                                      url: string;
-                                    }
-                                  | {
-                                      fileId: string | Record<string, string>;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-id";
-                                    }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-data";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-url";
-                                      url: string;
-                                    }
-                                  | {
-                                      fileId: string | Record<string, string>;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-file-id";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "custom";
-                                    }
-                                >;
-                              };
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          result?: any;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-result";
-                        }
-                      | {
-                          id: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "url";
-                          title?: string;
-                          type: "source";
-                          url: string;
-                        }
-                      | {
-                          filename?: string;
-                          id: string;
-                          mediaType: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "document";
-                          title: string;
-                          type: "source";
-                        }
-                      | {
-                          approvalId: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          type: "tool-approval-request";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "assistant";
-              }
-            | {
-                content: Array<
-                  | {
-                      args?: any;
-                      experimental_content?: Array<
-                        | { text: string; type: "text" }
-                        | { data: string; mimeType?: string; type: "image" }
-                      >;
-                      isError?: boolean;
-                      output?:
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "text";
-                            value: string;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "json";
-                            value: any;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "error-text";
-                            value: string;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "error-json";
-                            value: any;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            reason?: string;
-                            type: "execution-denied";
-                          }
-                        | {
-                            type: "content";
-                            value: Array<
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  text: string;
-                                  type: "text";
-                                }
-                              | {
-                                  data: string;
-                                  mediaType: string;
-                                  type: "media";
-                                }
-                              | {
-                                  data: string;
-                                  filename?: string;
-                                  mediaType: string;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-data";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-url";
-                                  url: string;
-                                }
-                              | {
-                                  fileId: string | Record<string, string>;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-id";
-                                }
-                              | {
-                                  data: string;
-                                  mediaType: string;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-data";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-url";
-                                  url: string;
-                                }
-                              | {
-                                  fileId: string | Record<string, string>;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-file-id";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "custom";
-                                }
-                            >;
-                          };
-                      providerExecuted?: boolean;
-                      providerMetadata?: Record<string, Record<string, any>>;
-                      providerOptions?: Record<string, Record<string, any>>;
-                      result?: any;
-                      toolCallId: string;
-                      toolName: string;
-                      type: "tool-result";
-                    }
-                  | {
-                      approvalId: string;
-                      approved: boolean;
-                      providerExecuted?: boolean;
-                      providerMetadata?: Record<string, Record<string, any>>;
-                      providerOptions?: Record<string, Record<string, any>>;
-                      reason?: string;
-                      type: "tool-approval-response";
-                    }
-                >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "tool";
-              }
-            | {
-                content: string;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "system";
-              };
-          model?: string;
-          order: number;
-          provider?: string;
-          providerMetadata?: Record<string, Record<string, any>>;
-          providerOptions?: Record<string, Record<string, any>>;
-          reasoning?: string;
-          reasoningDetails?: Array<
-            | {
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                signature?: string;
-                text: string;
-                type: "reasoning";
-              }
-            | { signature?: string; text: string; type: "text" }
-            | { data: string; type: "redacted" }
-          >;
-          sources?: Array<
-            | {
-                id: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "url";
-                title?: string;
-                type?: "source";
-                url: string;
-              }
-            | {
-                filename?: string;
-                id: string;
-                mediaType: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "document";
-                title: string;
-                type: "source";
-              }
-          >;
-          status: "pending" | "success" | "failed";
-          stepOrder: number;
-          text?: string;
-          threadId: string;
-          tool: boolean;
-          usage?: {
-            cachedInputTokens?: number;
-            completionTokens: number;
-            promptTokens: number;
-            reasoningTokens?: number;
-            totalTokens: number;
-          };
-          userId?: string;
-          warnings?: Array<
-            | { details?: string; setting: string; type: "unsupported-setting" }
-            | { details?: string; tool: any; type: "unsupported-tool" }
-            | { message: string; type: "other" }
-          >;
-        }>,
-        Name
-      >;
-      updateMessage: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          messageId: string;
-          patch: {
-            error?: string;
-            fileIds?: Array<string>;
-            finishReason?:
-              | "stop"
-              | "length"
-              | "content-filter"
-              | "tool-calls"
-              | "error"
-              | "other"
-              | "unknown";
-            message?:
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            image: string | ArrayBuffer;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "image";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "user";
-                }
-              | {
-                  content:
-                    | string
-                    | Array<
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            text: string;
-                            type: "text";
-                          }
-                        | {
-                            data: string | ArrayBuffer;
-                            filename?: string;
-                            mediaType?: string;
-                            mimeType?: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "file";
-                          }
-                        | {
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            signature?: string;
-                            text: string;
-                            type: "reasoning";
-                          }
-                        | {
-                            data: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "redacted-reasoning";
-                          }
-                        | {
-                            args?: any;
-                            input: any;
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-call";
-                          }
-                        | {
-                            args?: any;
-                            experimental_content?: Array<
-                              | { text: string; type: "text" }
-                              | {
-                                  data: string;
-                                  mimeType?: string;
-                                  type: "image";
-                                }
-                            >;
-                            isError?: boolean;
-                            output?:
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "text";
-                                  value: string;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "json";
-                                  value: any;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "error-text";
-                                  value: string;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "error-json";
-                                  value: any;
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  reason?: string;
-                                  type: "execution-denied";
-                                }
-                              | {
-                                  type: "content";
-                                  value: Array<
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        text: string;
-                                        type: "text";
-                                      }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        type: "media";
-                                      }
-                                    | {
-                                        data: string;
-                                        filename?: string;
-                                        mediaType: string;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-data";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-url";
-                                        url: string;
-                                      }
-                                    | {
-                                        fileId: string | Record<string, string>;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "file-id";
-                                      }
-                                    | {
-                                        data: string;
-                                        mediaType: string;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-data";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-url";
-                                        url: string;
-                                      }
-                                    | {
-                                        fileId: string | Record<string, string>;
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "image-file-id";
-                                      }
-                                    | {
-                                        providerOptions?: Record<
-                                          string,
-                                          Record<string, any>
-                                        >;
-                                        type: "custom";
-                                      }
-                                  >;
-                                };
-                            providerExecuted?: boolean;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            result?: any;
-                            toolCallId: string;
-                            toolName: string;
-                            type: "tool-result";
-                          }
-                        | {
-                            id: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "url";
-                            title?: string;
-                            type: "source";
-                            url: string;
-                          }
-                        | {
-                            filename?: string;
-                            id: string;
-                            mediaType: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            sourceType: "document";
-                            title: string;
-                            type: "source";
-                          }
-                        | {
-                            approvalId: string;
-                            providerMetadata?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            toolCallId: string;
-                            type: "tool-approval-request";
-                          }
-                      >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "assistant";
-                }
-              | {
-                  content: Array<
-                    | {
-                        args?: any;
-                        experimental_content?: Array<
-                          | { text: string; type: "text" }
-                          | { data: string; mimeType?: string; type: "image" }
-                        >;
-                        isError?: boolean;
-                        output?:
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "text";
-                              value: string;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "json";
-                              value: any;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "error-text";
-                              value: string;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              type: "error-json";
-                              value: any;
-                            }
-                          | {
-                              providerOptions?: Record<
-                                string,
-                                Record<string, any>
-                              >;
-                              reason?: string;
-                              type: "execution-denied";
-                            }
-                          | {
-                              type: "content";
-                              value: Array<
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    text: string;
-                                    type: "text";
-                                  }
-                                | {
-                                    data: string;
-                                    mediaType: string;
-                                    type: "media";
-                                  }
-                                | {
-                                    data: string;
-                                    filename?: string;
-                                    mediaType: string;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-data";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-url";
-                                    url: string;
-                                  }
-                                | {
-                                    fileId: string | Record<string, string>;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "file-id";
-                                  }
-                                | {
-                                    data: string;
-                                    mediaType: string;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-data";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-url";
-                                    url: string;
-                                  }
-                                | {
-                                    fileId: string | Record<string, string>;
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "image-file-id";
-                                  }
-                                | {
-                                    providerOptions?: Record<
-                                      string,
-                                      Record<string, any>
-                                    >;
-                                    type: "custom";
-                                  }
-                              >;
-                            };
-                        providerExecuted?: boolean;
-                        providerMetadata?: Record<string, Record<string, any>>;
-                        providerOptions?: Record<string, Record<string, any>>;
-                        result?: any;
-                        toolCallId: string;
-                        toolName: string;
-                        type: "tool-result";
-                      }
-                    | {
-                        approvalId: string;
-                        approved: boolean;
-                        providerExecuted?: boolean;
-                        providerMetadata?: Record<string, Record<string, any>>;
-                        providerOptions?: Record<string, Record<string, any>>;
-                        reason?: string;
-                        type: "tool-approval-response";
-                      }
-                  >;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "tool";
-                }
-              | {
-                  content: string;
-                  providerOptions?: Record<string, Record<string, any>>;
-                  role: "system";
-                };
-            model?: string;
-            provider?: string;
-            providerOptions?: Record<string, Record<string, any>>;
-            status?: "pending" | "success" | "failed";
-          };
-        },
-        {
-          _creationTime: number;
-          _id: string;
-          agentName?: string;
-          embeddingId?: string;
-          error?: string;
-          fileIds?: Array<string>;
-          finishReason?:
-            | "stop"
-            | "length"
-            | "content-filter"
-            | "tool-calls"
-            | "error"
-            | "other"
-            | "unknown";
-          id?: string;
-          message?:
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          image: string | ArrayBuffer;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "image";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "user";
-              }
-            | {
-                content:
-                  | string
-                  | Array<
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          text: string;
-                          type: "text";
-                        }
-                      | {
-                          data: string | ArrayBuffer;
-                          filename?: string;
-                          mediaType?: string;
-                          mimeType?: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "file";
-                        }
-                      | {
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          signature?: string;
-                          text: string;
-                          type: "reasoning";
-                        }
-                      | {
-                          data: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          type: "redacted-reasoning";
-                        }
-                      | {
-                          args?: any;
-                          input: any;
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-call";
-                        }
-                      | {
-                          args?: any;
-                          experimental_content?: Array<
-                            | { text: string; type: "text" }
-                            | { data: string; mimeType?: string; type: "image" }
-                          >;
-                          isError?: boolean;
-                          output?:
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "text";
-                                value: string;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "json";
-                                value: any;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "error-text";
-                                value: string;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                type: "error-json";
-                                value: any;
-                              }
-                            | {
-                                providerOptions?: Record<
-                                  string,
-                                  Record<string, any>
-                                >;
-                                reason?: string;
-                                type: "execution-denied";
-                              }
-                            | {
-                                type: "content";
-                                value: Array<
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      text: string;
-                                      type: "text";
-                                    }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      type: "media";
-                                    }
-                                  | {
-                                      data: string;
-                                      filename?: string;
-                                      mediaType: string;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-data";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-url";
-                                      url: string;
-                                    }
-                                  | {
-                                      fileId: string | Record<string, string>;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "file-id";
-                                    }
-                                  | {
-                                      data: string;
-                                      mediaType: string;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-data";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-url";
-                                      url: string;
-                                    }
-                                  | {
-                                      fileId: string | Record<string, string>;
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "image-file-id";
-                                    }
-                                  | {
-                                      providerOptions?: Record<
-                                        string,
-                                        Record<string, any>
-                                      >;
-                                      type: "custom";
-                                    }
-                                >;
-                              };
-                          providerExecuted?: boolean;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          result?: any;
-                          toolCallId: string;
-                          toolName: string;
-                          type: "tool-result";
-                        }
-                      | {
-                          id: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "url";
-                          title?: string;
-                          type: "source";
-                          url: string;
-                        }
-                      | {
-                          filename?: string;
-                          id: string;
-                          mediaType: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          sourceType: "document";
-                          title: string;
-                          type: "source";
-                        }
-                      | {
-                          approvalId: string;
-                          providerMetadata?: Record<
-                            string,
-                            Record<string, any>
-                          >;
-                          providerOptions?: Record<string, Record<string, any>>;
-                          toolCallId: string;
-                          type: "tool-approval-request";
-                        }
-                    >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "assistant";
-              }
-            | {
-                content: Array<
-                  | {
-                      args?: any;
-                      experimental_content?: Array<
-                        | { text: string; type: "text" }
-                        | { data: string; mimeType?: string; type: "image" }
-                      >;
-                      isError?: boolean;
-                      output?:
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "text";
-                            value: string;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "json";
-                            value: any;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "error-text";
-                            value: string;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            type: "error-json";
-                            value: any;
-                          }
-                        | {
-                            providerOptions?: Record<
-                              string,
-                              Record<string, any>
-                            >;
-                            reason?: string;
-                            type: "execution-denied";
-                          }
-                        | {
-                            type: "content";
-                            value: Array<
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  text: string;
-                                  type: "text";
-                                }
-                              | {
-                                  data: string;
-                                  mediaType: string;
-                                  type: "media";
-                                }
-                              | {
-                                  data: string;
-                                  filename?: string;
-                                  mediaType: string;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-data";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-url";
-                                  url: string;
-                                }
-                              | {
-                                  fileId: string | Record<string, string>;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "file-id";
-                                }
-                              | {
-                                  data: string;
-                                  mediaType: string;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-data";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-url";
-                                  url: string;
-                                }
-                              | {
-                                  fileId: string | Record<string, string>;
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "image-file-id";
-                                }
-                              | {
-                                  providerOptions?: Record<
-                                    string,
-                                    Record<string, any>
-                                  >;
-                                  type: "custom";
-                                }
-                            >;
-                          };
-                      providerExecuted?: boolean;
-                      providerMetadata?: Record<string, Record<string, any>>;
-                      providerOptions?: Record<string, Record<string, any>>;
-                      result?: any;
-                      toolCallId: string;
-                      toolName: string;
-                      type: "tool-result";
-                    }
-                  | {
-                      approvalId: string;
-                      approved: boolean;
-                      providerExecuted?: boolean;
-                      providerMetadata?: Record<string, Record<string, any>>;
-                      providerOptions?: Record<string, Record<string, any>>;
-                      reason?: string;
-                      type: "tool-approval-response";
-                    }
-                >;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "tool";
-              }
-            | {
-                content: string;
-                providerOptions?: Record<string, Record<string, any>>;
-                role: "system";
-              };
-          model?: string;
-          order: number;
-          provider?: string;
-          providerMetadata?: Record<string, Record<string, any>>;
-          providerOptions?: Record<string, Record<string, any>>;
-          reasoning?: string;
-          reasoningDetails?: Array<
-            | {
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                signature?: string;
-                text: string;
-                type: "reasoning";
-              }
-            | { signature?: string; text: string; type: "text" }
-            | { data: string; type: "redacted" }
-          >;
-          sources?: Array<
-            | {
-                id: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "url";
-                title?: string;
-                type?: "source";
-                url: string;
-              }
-            | {
-                filename?: string;
-                id: string;
-                mediaType: string;
-                providerMetadata?: Record<string, Record<string, any>>;
-                providerOptions?: Record<string, Record<string, any>>;
-                sourceType: "document";
-                title: string;
-                type: "source";
-              }
-          >;
-          status: "pending" | "success" | "failed";
-          stepOrder: number;
-          text?: string;
-          threadId: string;
-          tool: boolean;
-          usage?: {
-            cachedInputTokens?: number;
-            completionTokens: number;
-            promptTokens: number;
-            reasoningTokens?: number;
-            totalTokens: number;
-          };
-          userId?: string;
-          warnings?: Array<
-            | { details?: string; setting: string; type: "unsupported-setting" }
-            | { details?: string; tool: any; type: "unsupported-tool" }
-            | { message: string; type: "other" }
-          >;
-        },
-        Name
-      >;
-    };
-    streams: {
-      abort: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          finalDelta?: {
-            end: number;
-            parts: Array<any>;
-            start: number;
-            streamId: string;
-          };
-          reason: string;
-          streamId: string;
-        },
-        boolean,
-        Name
-      >;
-      abortByOrder: FunctionReference<
-        "mutation",
-        "internal",
-        { order: number; reason: string; threadId: string },
-        boolean,
-        Name
-      >;
-      addDelta: FunctionReference<
-        "mutation",
-        "internal",
-        { end: number; parts: Array<any>; start: number; streamId: string },
-        boolean,
-        Name
-      >;
-      create: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          agentName?: string;
-          format?: "UIMessageChunk" | "TextStreamPart";
-          model?: string;
-          order: number;
-          provider?: string;
-          providerOptions?: Record<string, Record<string, any>>;
-          stepOrder: number;
-          threadId: string;
-          userId?: string;
-        },
-        string,
-        Name
-      >;
-      deleteAllStreamsForThreadIdAsync: FunctionReference<
-        "mutation",
-        "internal",
-        { deltaCursor?: string; streamOrder?: number; threadId: string },
-        { deltaCursor?: string; isDone: boolean; streamOrder?: number },
-        Name
-      >;
-      deleteAllStreamsForThreadIdSync: FunctionReference<
-        "action",
-        "internal",
-        { threadId: string },
-        null,
-        Name
-      >;
-      deleteStreamAsync: FunctionReference<
-        "mutation",
-        "internal",
-        { cursor?: string; streamId: string },
-        null,
-        Name
-      >;
-      deleteStreamSync: FunctionReference<
-        "mutation",
-        "internal",
-        { streamId: string },
-        null,
-        Name
-      >;
-      finish: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          finalDelta?: {
-            end: number;
-            parts: Array<any>;
-            start: number;
-            streamId: string;
-          };
-          streamId: string;
-        },
-        null,
-        Name
-      >;
-      heartbeat: FunctionReference<
-        "mutation",
-        "internal",
-        { streamId: string },
-        null,
-        Name
-      >;
-      list: FunctionReference<
-        "query",
-        "internal",
-        {
-          startOrder?: number;
-          statuses?: Array<"streaming" | "finished" | "aborted">;
-          threadId: string;
-        },
-        Array<{
-          agentName?: string;
-          format?: "UIMessageChunk" | "TextStreamPart";
-          model?: string;
-          order: number;
-          provider?: string;
-          providerOptions?: Record<string, Record<string, any>>;
-          status: "streaming" | "finished" | "aborted";
-          stepOrder: number;
-          streamId: string;
-          userId?: string;
-        }>,
-        Name
-      >;
-      listDeltas: FunctionReference<
-        "query",
-        "internal",
-        {
-          cursors: Array<{ cursor: number; streamId: string }>;
-          threadId: string;
-        },
-        Array<{
-          end: number;
-          parts: Array<any>;
-          start: number;
-          streamId: string;
-        }>,
-        Name
-      >;
-    };
-    threads: {
-      createThread: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          defaultSystemPrompt?: string;
-          parentThreadIds?: Array<string>;
-          summary?: string;
-          title?: string;
-          userId?: string;
-        },
-        {
-          _creationTime: number;
-          _id: string;
-          status: "active" | "archived";
-          summary?: string;
-          title?: string;
-          userId?: string;
-        },
-        Name
-      >;
-      deleteAllForThreadIdAsync: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          cursor?: string;
-          deltaCursor?: string;
-          limit?: number;
-          messagesDone?: boolean;
-          streamOrder?: number;
-          streamsDone?: boolean;
-          threadId: string;
-        },
-        { isDone: boolean },
-        Name
-      >;
-      deleteAllForThreadIdSync: FunctionReference<
-        "action",
-        "internal",
-        { limit?: number; threadId: string },
-        null,
-        Name
-      >;
-      getThread: FunctionReference<
-        "query",
-        "internal",
-        { threadId: string },
-        {
-          _creationTime: number;
-          _id: string;
-          status: "active" | "archived";
-          summary?: string;
-          title?: string;
-          userId?: string;
-        } | null,
-        Name
-      >;
-      listThreadsByUserId: FunctionReference<
-        "query",
-        "internal",
-        {
-          order?: "asc" | "desc";
-          paginationOpts?: {
-            cursor: string | null;
-            endCursor?: string | null;
-            id?: number;
-            maximumBytesRead?: number;
-            maximumRowsRead?: number;
-            numItems: number;
-          };
-          userId?: string;
-        },
-        {
-          continueCursor: string;
-          isDone: boolean;
-          page: Array<{
-            _creationTime: number;
-            _id: string;
-            status: "active" | "archived";
-            summary?: string;
-            title?: string;
-            userId?: string;
-          }>;
-          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
-          splitCursor?: string | null;
-        },
-        Name
-      >;
-      searchThreadTitles: FunctionReference<
-        "query",
-        "internal",
-        { limit: number; query: string; userId?: string | null },
-        Array<{
-          _creationTime: number;
-          _id: string;
-          status: "active" | "archived";
-          summary?: string;
-          title?: string;
-          userId?: string;
-        }>,
-        Name
-      >;
-      updateThread: FunctionReference<
-        "mutation",
-        "internal",
-        {
-          patch: {
-            status?: "active" | "archived";
-            summary?: string;
-            title?: string;
-            userId?: string;
-          };
-          threadId: string;
-        },
-        {
-          _creationTime: number;
-          _id: string;
-          status: "active" | "archived";
-          summary?: string;
-          title?: string;
-          userId?: string;
-        },
-        Name
-      >;
-    };
-    users: {
-      deleteAllForUserId: FunctionReference<
-        "action",
-        "internal",
-        { userId: string },
-        null,
-        Name
-      >;
-      deleteAllForUserIdAsync: FunctionReference<
-        "mutation",
-        "internal",
-        { userId: string },
-        boolean,
-        Name
-      >;
-      listUsersWithThreads: FunctionReference<
-        "query",
-        "internal",
-        {
-          paginationOpts: {
-            cursor: string | null;
-            endCursor?: string | null;
-            id?: number;
-            maximumBytesRead?: number;
-            maximumRowsRead?: number;
-            numItems: number;
-          };
-        },
-        {
-          continueCursor: string;
-          isDone: boolean;
-          page: Array<string>;
-          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
-          splitCursor?: string | null;
-        },
-        Name
-      >;
-    };
-    vector: {
-      index: {
-        deleteBatch: FunctionReference<
-          "mutation",
-          "internal",
-          {
-            ids: Array<
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-            >;
-          },
-          null,
-          Name
-        >;
-        deleteBatchForThread: FunctionReference<
-          "mutation",
-          "internal",
-          {
-            cursor?: string;
-            limit: number;
-            model: string;
-            threadId: string;
-            vectorDimension:
-              | 128
-              | 256
-              | 512
-              | 768
-              | 1024
-              | 1408
-              | 1536
-              | 2048
-              | 3072
-              | 4096;
-          },
-          { continueCursor: string; isDone: boolean },
-          Name
-        >;
-        insertBatch: FunctionReference<
-          "mutation",
-          "internal",
-          {
-            vectorDimension:
-              | 128
-              | 256
-              | 512
-              | 768
-              | 1024
-              | 1408
-              | 1536
-              | 2048
-              | 3072
-              | 4096;
-            vectors: Array<{
-              messageId?: string;
-              model: string;
-              table: string;
-              threadId?: string;
-              userId?: string;
-              vector: Array<number>;
-            }>;
-          },
-          Array<
-            | string
-            | string
-            | string
-            | string
-            | string
-            | string
-            | string
-            | string
-            | string
-            | string
-          >,
-          Name
-        >;
-        paginate: FunctionReference<
-          "query",
-          "internal",
-          {
-            cursor?: string;
-            limit: number;
-            table?: string;
-            targetModel: string;
-            vectorDimension:
-              | 128
-              | 256
-              | 512
-              | 768
-              | 1024
-              | 1408
-              | 1536
-              | 2048
-              | 3072
-              | 4096;
-          },
-          {
-            continueCursor: string;
-            ids: Array<
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-              | string
-            >;
-            isDone: boolean;
-          },
-          Name
-        >;
-        updateBatch: FunctionReference<
-          "mutation",
-          "internal",
-          {
-            vectors: Array<{
-              id:
-                | string
-                | string
-                | string
-                | string
-                | string
-                | string
-                | string
-                | string
-                | string
-                | string;
-              model: string;
-              vector: Array<number>;
-            }>;
-          },
-          null,
-          Name
-        >;
-      };
-    };
-  };

From 34df29bef44491c6948a8e05f966f7ed8adb58e3 Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sat, 17 Jan 2026 21:31:00 -0500
Subject: [PATCH 20/26] Added `input` values to the test types, kept `args`

---
 src/client/index.test.ts   |  1 +
 src/client/search.test.ts  |  2 ++
 src/fromUIMessages.test.ts |  9 +++++++--
 src/toUIMessages.test.ts   | 13 +++++++++++++
 4 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/src/client/index.test.ts b/src/client/index.test.ts
index f6e97269..9a2c4e18 100644
--- a/src/client/index.test.ts
+++ b/src/client/index.test.ts
@@ -193,6 +193,7 @@ describe("filterOutOrphanedToolMessages", () => {
           type: "tool-call",
           toolCallId: "1",
           toolName: "tool1",
+          input: { test: "test" },
           args: { test: "test" },
         },
       ],
diff --git a/src/client/search.test.ts b/src/client/search.test.ts
index c2749c92..3a9b9b86 100644
--- a/src/client/search.test.ts
+++ b/src/client/search.test.ts
@@ -159,6 +159,7 @@ describe("search.ts", () => {
                 type: "tool-call",
                 toolCallId: "call_123",
                 toolName: "test",
+                input: {},
                 args: {},
               },
             ],
@@ -202,6 +203,7 @@ describe("search.ts", () => {
                 type: "tool-call",
                 toolCallId: "call_orphaned",
                 toolName: "test",
+                input: {},
                 args: {},
               },
             ],
diff --git a/src/fromUIMessages.test.ts b/src/fromUIMessages.test.ts
index cbe0cb24..4413c3c1 100644
--- a/src/fromUIMessages.test.ts
+++ b/src/fromUIMessages.test.ts
@@ -166,6 +166,7 @@ describe("fromUIMessages round-trip tests", () => {
               type: "tool-call",
               toolName: "calculator",
               toolCallId: "call1",
+              input: { operation: "add", a: 2, b: 3 },
               args: { operation: "add", a: 2, b: 3 },
             },
           ],
@@ -442,7 +443,9 @@ describe("fromUIMessages functionality tests", () => {
       ],
     };
 
-    const result = await fromUIMessages([toolUIMessage], { threadId: "thread1" });
+    const result = await fromUIMessages([toolUIMessage], {
+      threadId: "thread1",
+    });
     expect(result.length).toBeGreaterThan(0);
 
     // Should have tool messages
@@ -471,7 +474,9 @@ describe("fromUIMessages functionality tests", () => {
       ],
     };
 
-    const result = await fromUIMessages([toolUIMessage], { threadId: "thread1" });
+    const result = await fromUIMessages([toolUIMessage], {
+      threadId: "thread1",
+    });
     expect(result.length).toBeGreaterThan(0);
 
     // Should have tool messages
diff --git a/src/toUIMessages.test.ts b/src/toUIMessages.test.ts
index f871f8d3..63edb787 100644
--- a/src/toUIMessages.test.ts
+++ b/src/toUIMessages.test.ts
@@ -90,6 +90,7 @@ describe("toUIMessages", () => {
               type: "tool-call",
               toolName: "myTool",
               toolCallId: "call1",
+              input: "an arg",
               args: "an arg",
             },
           ],
@@ -219,6 +220,7 @@ describe("toUIMessages", () => {
             },
             {
               type: "tool-call",
+              input: "What's the meaning of life?",
               args: "What's the meaning of life?",
               toolCallId: "call1",
               toolName: "myTool",
@@ -310,6 +312,7 @@ describe("toUIMessages", () => {
               type: "tool-call",
               toolName: "myTool",
               toolCallId: "call1",
+              input: { query: "test" },
               args: { query: "test" },
             },
           ],
@@ -356,6 +359,7 @@ describe("toUIMessages", () => {
               type: "tool-call",
               toolName: "myTool",
               toolCallId: "call1",
+              input: "hi",
               args: "hi",
             },
           ],
@@ -387,6 +391,7 @@ describe("toUIMessages", () => {
               type: "tool-call",
               toolName: "myTool",
               toolCallId: "call1",
+              input: "",
               args: "",
             },
           ],
@@ -448,6 +453,7 @@ describe("toUIMessages", () => {
               type: "tool-call",
               toolName: "calculator",
               toolCallId: "call1",
+              input: { operation: "add", a: 2, b: 3 },
               args: { operation: "add", a: 2, b: 3 },
             },
             {
@@ -490,6 +496,7 @@ describe("toUIMessages", () => {
               type: "tool-call",
               toolName: "calculator",
               toolCallId: "call1",
+              input: { operation: "add", a: 1, b: 2 },
               args: { operation: "add", a: 1, b: 2 },
             },
           ],
@@ -561,6 +568,9 @@ describe("toUIMessages", () => {
               text: "**Finding the Time**\n\nI've pinpointed the core task: obtaining the current time in Paris. It involves using the `dateTime` tool. I've identified \"Europe/Paris\" as the necessary timezone identifier to provide to the tool. My next step is to test the tool.\n\n\n",
             },
             {
+              input: {
+                timezone: "Europe/Paris",
+              },
               args: {
                 timezone: "Europe/Paris",
               },
@@ -690,6 +700,7 @@ describe("toUIMessages", () => {
               type: "tool-call",
               toolName: "calculator",
               toolCallId: "call1",
+              input: { operation: "add", a: 40, b: 2 },
               args: { operation: "add", a: 40, b: 2 },
             },
           ],
@@ -744,6 +755,7 @@ describe("toUIMessages", () => {
               type: "tool-call",
               toolName: "generateImage",
               toolCallId: "call1",
+              input: { id: "invalid-id" },
               args: { id: "invalid-id" },
             },
           ],
@@ -898,6 +910,7 @@ describe("toUIMessages", () => {
                 type: "tool-call",
                 toolName: "myTool",
                 toolCallId: "call1",
+                input: {},
                 args: {},
               },
             ],

From 06358df562f6340b6d8d07916815f687bbc523fe Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sat, 17 Jan 2026 22:07:48 -0500
Subject: [PATCH 21/26] Add support for tool approval workflow in deltas and UI
 messages

- Implemented handling of `tool-approval-request` and `tool-approval-response` in `deltas.ts` to update tool state accordingly.
- Enhanced tests in `deltas.test.ts` and `toUIMessages.test.ts` to verify the approval workflow, including state transitions for approval requests and responses.
- Updated `UIMessages.ts` to manage tool approval states and responses, ensuring correct state updates for tool calls based on approval outcomes.
---
 src/UIMessages.ts        | 102 +++++++++++++-
 src/deltas.test.ts       |  47 +++++++
 src/deltas.ts            |  19 +++
 src/toUIMessages.test.ts | 296 +++++++++++++++++++++++++++++++++++++++
 4 files changed, 460 insertions(+), 4 deletions(-)

diff --git a/src/UIMessages.ts b/src/UIMessages.ts
index d65de779..45011f77 100644
--- a/src/UIMessages.ts
+++ b/src/UIMessages.ts
@@ -114,9 +114,10 @@ export async function fromUIMessages<METADATA = unknown>(
             );
             if (partWithProviderOptions?.providerOptions) {
               // convertToModelMessages changes providerMetadata to providerOptions
-              const providerOptions = partWithProviderOptions.providerOptions as
-                | Record<string, Record<string, unknown>>
-                | undefined;
+              const providerOptions =
+                partWithProviderOptions.providerOptions as
+                  | Record<string, Record<string, unknown>>
+                  | undefined;
               if (providerOptions) {
                 doc.providerMetadata = providerOptions;
                 doc.providerOptions ??= providerOptions;
@@ -477,8 +478,39 @@ function createAssistantUIMessage<
         }
         case "tool-result": {
           const typedPart = contentPart as unknown as ToolResultPart & {
-            output: { type: string; value: unknown };
+            output: { type: string; value?: unknown; reason?: string };
           };
+
+          // Check if this is an execution-denied result
+          if (typedPart.output?.type === "execution-denied") {
+            const call = allParts.find(
+              (part) =>
+                part.type === `tool-${contentPart.toolName}` &&
+                "toolCallId" in part &&
+                part.toolCallId === contentPart.toolCallId,
+            ) as ToolUIPart | undefined;
+
+            if (call) {
+              call.state = "output-denied";
+              if (!("approval" in call) || !call.approval) {
+                (call as ToolUIPart & { approval?: object }).approval = {
+                  id: "",
+                  approved: false,
+                  reason: typedPart.output.reason,
+                };
+              } else {
+                const approval = (
+                  call as ToolUIPart & {
+                    approval: { approved?: boolean; reason?: string };
+                  }
+                ).approval;
+                approval.approved = false;
+                approval.reason = typedPart.output.reason;
+              }
+            }
+            break;
+          }
+
           const output =
             typeof typedPart.output?.type === "string"
               ? typedPart.output.value
@@ -531,6 +563,68 @@ function createAssistantUIMessage<
           }
           break;
         }
+        case "tool-approval-request": {
+          // Find the matching tool call
+          const typedPart = contentPart as {
+            toolCallId: string;
+            approvalId: string;
+          };
+          const toolCallPart = allParts.find(
+            (part) =>
+              "toolCallId" in part && part.toolCallId === typedPart.toolCallId,
+          ) as ToolUIPart | undefined;
+
+          if (toolCallPart) {
+            toolCallPart.state = "approval-requested";
+            (toolCallPart as ToolUIPart & { approval?: object }).approval = {
+              id: typedPart.approvalId,
+            };
+          } else {
+            console.warn(
+              "Tool approval request without preceding tool call",
+              contentPart,
+            );
+          }
+          break;
+        }
+        case "tool-approval-response": {
+          // Find the tool call that has this approval by matching approval.id
+          const typedPart = contentPart as {
+            approvalId: string;
+            approved: boolean;
+            reason?: string;
+          };
+          const toolCallPart = allParts.find(
+            (part) =>
+              "approval" in part &&
+              (part as ToolUIPart & { approval?: { id: string } }).approval
+                ?.id === typedPart.approvalId,
+          ) as ToolUIPart | undefined;
+
+          if (toolCallPart) {
+            if (typedPart.approved) {
+              toolCallPart.state = "approval-responded";
+              (toolCallPart as ToolUIPart & { approval?: object }).approval = {
+                id: typedPart.approvalId,
+                approved: true,
+                reason: typedPart.reason,
+              };
+            } else {
+              toolCallPart.state = "output-denied";
+              (toolCallPart as ToolUIPart & { approval?: object }).approval = {
+                id: typedPart.approvalId,
+                approved: false,
+                reason: typedPart.reason,
+              };
+            }
+          } else {
+            console.warn(
+              "Tool approval response without matching approval request",
+              contentPart,
+            );
+          }
+          break;
+        }
         default: {
           const maybeSource = contentPart as unknown as SourcePart;
           if (maybeSource.type === "source") {
diff --git a/src/deltas.test.ts b/src/deltas.test.ts
index fab52758..e39f5573 100644
--- a/src/deltas.test.ts
+++ b/src/deltas.test.ts
@@ -533,4 +533,51 @@ describe("mergeDeltas", () => {
       },
     ]);
   });
+
+  it("handles streaming tool-approval-request and updates tool state", () => {
+    const streamId = "s10";
+    const deltas = [
+      {
+        streamId,
+        start: 0,
+        end: 1,
+        parts: [
+          {
+            type: "tool-call",
+            toolCallId: "call1",
+            toolName: "dangerousTool",
+            input: { action: "delete" },
+          },
+        ],
+      } satisfies StreamDelta,
+      {
+        streamId,
+        start: 1,
+        end: 2,
+        parts: [
+          {
+            type: "tool-approval-request",
+            toolCallId: "call1",
+            approvalId: "approval1",
+          },
+        ],
+      } satisfies StreamDelta,
+    ];
+    const [[message], _, changed] = deriveUIMessagesFromTextStreamParts(
+      "thread1",
+      [{ streamId, order: 10, stepOrder: 0, status: "streaming" }],
+      [],
+      deltas,
+    );
+    expect(message).toBeDefined();
+    expect(message.role).toBe("assistant");
+    expect(changed).toBe(true);
+
+    const toolPart = message.parts.find(
+      (p) => p.type === "tool-dangerousTool",
+    ) as any;
+    expect(toolPart).toBeDefined();
+    expect(toolPart.state).toBe("approval-requested");
+    expect(toolPart.approval).toEqual({ id: "approval1" });
+  });
 });
diff --git a/src/deltas.ts b/src/deltas.ts
index e5764fd5..15d20a6a 100644
--- a/src/deltas.ts
+++ b/src/deltas.ts
@@ -472,6 +472,25 @@ export function updateFromTextStreamParts(
         }
         break;
       }
+      case "tool-approval-request": {
+        const typedPart = part as unknown as {
+          type: "tool-approval-request";
+          toolCallId: string;
+          approvalId: string;
+        };
+        const toolPart = toolPartsById.get(typedPart.toolCallId);
+        if (toolPart) {
+          toolPart.state = "approval-requested";
+          (toolPart as ToolUIPart & { approval?: object }).approval = {
+            id: typedPart.approvalId,
+          };
+        } else {
+          console.warn(
+            `Expected tool call part ${typedPart.toolCallId} for approval request`,
+          );
+        }
+        break;
+      }
       case "file":
       case "text-end":
       case "finish-step":
diff --git a/src/toUIMessages.test.ts b/src/toUIMessages.test.ts
index 63edb787..73707cbe 100644
--- a/src/toUIMessages.test.ts
+++ b/src/toUIMessages.test.ts
@@ -970,4 +970,300 @@ describe("toUIMessages", () => {
       expect(uiMessages[0].userId).toBeUndefined();
     });
   });
+
+  describe("tool approval workflow", () => {
+    it("sets state to approval-requested when tool-approval-request is present", () => {
+      const messages = [
+        baseMessageDoc({
+          _id: "msg1",
+          order: 1,
+          stepOrder: 1,
+          tool: true,
+          message: {
+            role: "assistant",
+            content: [
+              {
+                type: "tool-call",
+                toolName: "dangerousTool",
+                toolCallId: "call1",
+                input: { action: "delete" },
+                args: { action: "delete" },
+              },
+              {
+                type: "tool-approval-request",
+                approvalId: "approval1",
+                toolCallId: "call1",
+              },
+            ],
+          },
+        }),
+      ];
+
+      const uiMessages = toUIMessages(messages);
+
+      expect(uiMessages).toHaveLength(1);
+      const toolPart = uiMessages[0].parts.find(
+        (p) => p.type === "tool-dangerousTool",
+      ) as any;
+      expect(toolPart).toBeDefined();
+      expect(toolPart.state).toBe("approval-requested");
+      expect(toolPart.approval).toEqual({ id: "approval1" });
+    });
+
+    it("sets state to approval-responded when tool-approval-response with approved: true", () => {
+      const messages = [
+        baseMessageDoc({
+          _id: "msg1",
+          order: 1,
+          stepOrder: 1,
+          tool: true,
+          message: {
+            role: "assistant",
+            content: [
+              {
+                type: "tool-call",
+                toolName: "dangerousTool",
+                toolCallId: "call1",
+                input: { action: "delete" },
+                args: { action: "delete" },
+              },
+              {
+                type: "tool-approval-request",
+                approvalId: "approval1",
+                toolCallId: "call1",
+              },
+            ],
+          },
+        }),
+        baseMessageDoc({
+          _id: "msg2",
+          order: 1,
+          stepOrder: 2,
+          tool: true,
+          message: {
+            role: "tool",
+            content: [
+              {
+                type: "tool-approval-response",
+                approvalId: "approval1",
+                approved: true,
+                reason: "User confirmed",
+              },
+            ],
+          },
+        }),
+      ];
+
+      const uiMessages = toUIMessages(messages);
+
+      expect(uiMessages).toHaveLength(1);
+      const toolPart = uiMessages[0].parts.find(
+        (p) => p.type === "tool-dangerousTool",
+      ) as any;
+      expect(toolPart).toBeDefined();
+      expect(toolPart.state).toBe("approval-responded");
+      expect(toolPart.approval).toEqual({
+        id: "approval1",
+        approved: true,
+        reason: "User confirmed",
+      });
+    });
+
+    it("sets state to output-denied when tool-approval-response with approved: false", () => {
+      const messages = [
+        baseMessageDoc({
+          _id: "msg1",
+          order: 1,
+          stepOrder: 1,
+          tool: true,
+          message: {
+            role: "assistant",
+            content: [
+              {
+                type: "tool-call",
+                toolName: "dangerousTool",
+                toolCallId: "call1",
+                input: { action: "delete" },
+                args: { action: "delete" },
+              },
+              {
+                type: "tool-approval-request",
+                approvalId: "approval1",
+                toolCallId: "call1",
+              },
+            ],
+          },
+        }),
+        baseMessageDoc({
+          _id: "msg2",
+          order: 1,
+          stepOrder: 2,
+          tool: true,
+          message: {
+            role: "tool",
+            content: [
+              {
+                type: "tool-approval-response",
+                approvalId: "approval1",
+                approved: false,
+                reason: "User declined the operation",
+              },
+            ],
+          },
+        }),
+      ];
+
+      const uiMessages = toUIMessages(messages);
+
+      expect(uiMessages).toHaveLength(1);
+      const toolPart = uiMessages[0].parts.find(
+        (p) => p.type === "tool-dangerousTool",
+      ) as any;
+      expect(toolPart).toBeDefined();
+      expect(toolPart.state).toBe("output-denied");
+      expect(toolPart.approval).toEqual({
+        id: "approval1",
+        approved: false,
+        reason: "User declined the operation",
+      });
+    });
+
+    it("sets state to output-denied when tool-result has execution-denied output", () => {
+      const messages = [
+        baseMessageDoc({
+          _id: "msg1",
+          order: 1,
+          stepOrder: 1,
+          tool: true,
+          message: {
+            role: "assistant",
+            content: [
+              {
+                type: "tool-call",
+                toolName: "dangerousTool",
+                toolCallId: "call1",
+                input: { action: "delete" },
+                args: { action: "delete" },
+              },
+            ],
+          },
+        }),
+        baseMessageDoc({
+          _id: "msg2",
+          order: 1,
+          stepOrder: 2,
+          tool: true,
+          message: {
+            role: "tool",
+            content: [
+              {
+                type: "tool-result",
+                toolCallId: "call1",
+                toolName: "dangerousTool",
+                output: {
+                  type: "execution-denied",
+                  reason: "Tool execution was denied by the user",
+                },
+              },
+            ],
+          },
+        }),
+      ];
+
+      const uiMessages = toUIMessages(messages);
+
+      expect(uiMessages).toHaveLength(1);
+      const toolPart = uiMessages[0].parts.find(
+        (p) => p.type === "tool-dangerousTool",
+      ) as any;
+      expect(toolPart).toBeDefined();
+      expect(toolPart.state).toBe("output-denied");
+      expect(toolPart.approval).toEqual({
+        id: "",
+        approved: false,
+        reason: "Tool execution was denied by the user",
+      });
+    });
+
+    it("handles full approval flow: request → approved → executed → output-available", () => {
+      const messages = [
+        baseMessageDoc({
+          _id: "msg1",
+          order: 1,
+          stepOrder: 1,
+          tool: true,
+          message: {
+            role: "assistant",
+            content: [
+              {
+                type: "tool-call",
+                toolName: "dangerousTool",
+                toolCallId: "call1",
+                input: { action: "delete" },
+                args: { action: "delete" },
+              },
+              {
+                type: "tool-approval-request",
+                approvalId: "approval1",
+                toolCallId: "call1",
+              },
+            ],
+          },
+        }),
+        baseMessageDoc({
+          _id: "msg2",
+          order: 1,
+          stepOrder: 2,
+          tool: true,
+          message: {
+            role: "tool",
+            content: [
+              {
+                type: "tool-approval-response",
+                approvalId: "approval1",
+                approved: true,
+              },
+            ],
+          },
+        }),
+        baseMessageDoc({
+          _id: "msg3",
+          order: 1,
+          stepOrder: 3,
+          tool: true,
+          message: {
+            role: "tool",
+            content: [
+              {
+                type: "tool-result",
+                toolCallId: "call1",
+                toolName: "dangerousTool",
+                output: {
+                  type: "json",
+                  value: { deleted: true },
+                },
+              },
+            ],
+          },
+        }),
+      ];
+
+      const uiMessages = toUIMessages(messages);
+
+      expect(uiMessages).toHaveLength(1);
+      const toolPart = uiMessages[0].parts.find(
+        (p) => p.type === "tool-dangerousTool",
+      ) as any;
+      expect(toolPart).toBeDefined();
+      // After tool-result, state should be output-available
+      expect(toolPart.state).toBe("output-available");
+      expect(toolPart.output).toEqual({ deleted: true });
+      // approval should still be preserved from earlier
+      expect(toolPart.approval).toEqual({
+        id: "approval1",
+        approved: true,
+        reason: undefined,
+      });
+    });
+  });
 });

From d0a161c93b9e888357d23f1572552c3bbd2a43d8 Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sun, 18 Jan 2026 01:17:40 -0500
Subject: [PATCH 22/26] Updated `serializeContent` to include cases for
 `tool-approval-request` and `tool-approval-response`.

---
 src/mapping.test.ts | 48 +++++++++++++++++++++++++++++++++++++++++++++
 src/mapping.ts      | 18 +++++++++++++++++
 2 files changed, 66 insertions(+)

diff --git a/src/mapping.test.ts b/src/mapping.test.ts
index f730a775..c802b468 100644
--- a/src/mapping.test.ts
+++ b/src/mapping.test.ts
@@ -209,4 +209,52 @@ describe("mapping", () => {
     const { fileIds } = await serializeContent(ctx, component, content);
     expect(fileIds).toBeUndefined();
   });
+
+  test("tool-approval-request is preserved after serialization", async () => {
+    const approvalRequest = {
+      type: "tool-approval-request" as const,
+      approvalId: "approval-123",
+      toolCallId: "tool-call-456",
+    };
+    const { content } = await serializeContent(
+      {} as ActionCtx,
+      {} as AgentComponent,
+      [approvalRequest],
+    );
+    expect(content).toHaveLength(1);
+    expect((content as unknown[])[0]).toMatchObject(approvalRequest);
+  });
+
+  test("tool-approval-response with approved: true is preserved", async () => {
+    const approvalResponse = {
+      type: "tool-approval-response" as const,
+      approvalId: "approval-123",
+      approved: true,
+      reason: "User approved",
+    };
+    const { content } = await serializeContent(
+      {} as ActionCtx,
+      {} as AgentComponent,
+      [approvalResponse],
+    );
+    expect(content).toHaveLength(1);
+    expect((content as unknown[])[0]).toMatchObject(approvalResponse);
+  });
+
+  test("tool-approval-response with approved: false is preserved", async () => {
+    const approvalResponse = {
+      type: "tool-approval-response" as const,
+      approvalId: "approval-123",
+      approved: false,
+      reason: "User denied",
+      providerExecuted: false,
+    };
+    const { content } = await serializeContent(
+      {} as ActionCtx,
+      {} as AgentComponent,
+      [approvalResponse],
+    );
+    expect(content).toHaveLength(1);
+    expect((content as unknown[])[0]).toMatchObject(approvalResponse);
+  });
 });
diff --git a/src/mapping.ts b/src/mapping.ts
index c2d179c0..cdfd6806 100644
--- a/src/mapping.ts
+++ b/src/mapping.ts
@@ -387,6 +387,24 @@ export async function serializeContent(
         case "source": {
           return part satisfies Infer<typeof vSourcePart>;
         }
+        case "tool-approval-request": {
+          return {
+            type: part.type,
+            approvalId: part.approvalId,
+            toolCallId: part.toolCallId,
+            ...metadata,
+          } satisfies Infer<typeof vToolApprovalRequest>;
+        }
+        case "tool-approval-response": {
+          return {
+            type: part.type,
+            approvalId: part.approvalId,
+            approved: part.approved,
+            reason: part.reason,
+            providerExecuted: part.providerExecuted,
+            ...metadata,
+          } satisfies Infer<typeof vToolApprovalResponse>;
+        }
         default:
           return null;
       }

From c9c54cdf40816775ca45c5b909625ef42709c359 Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sun, 18 Jan 2026 20:40:31 -0500
Subject: [PATCH 23/26] Refactor to ensure the tool call IS present when the
 SDK runs `collectToolApprovals`. Without the fix, the tool call was being
 filtered out because it had no tool-result, even though it had an approval
 response - which caused the SDK to fail at line 91 in
 `ai/src/generate-text/collect-tool-approvals.ts`.

---
 src/client/search.test.ts | 164 ++++++++++++++++++++++++++++++++++++++
 src/client/search.ts      |  51 ++++++++++--
 2 files changed, 210 insertions(+), 5 deletions(-)

diff --git a/src/client/search.test.ts b/src/client/search.test.ts
index 3a9b9b86..a3c1c034 100644
--- a/src/client/search.test.ts
+++ b/src/client/search.test.ts
@@ -236,6 +236,170 @@ describe("search.ts", () => {
       expect(result[0]._id).toBe("0");
       expect(result[1]._id).toBe("3");
     });
+
+    it("should keep tool calls with approval responses (but no tool-result yet)", () => {
+      const messages: MessageDoc[] = [
+        {
+          _id: "1",
+          message: {
+            role: "assistant",
+            content: [
+              { type: "text", text: "I'll run the dangerous tool" },
+              {
+                type: "tool-call",
+                toolCallId: "call_123",
+                toolName: "dangerousTool",
+                input: { action: "delete" },
+                args: { action: "delete" },
+              },
+              {
+                type: "tool-approval-request",
+                toolCallId: "call_123",
+                approvalId: "approval_456",
+              },
+            ],
+          },
+          order: 1,
+        } as MessageDoc,
+        {
+          _id: "2",
+          message: {
+            role: "tool",
+            content: [
+              {
+                type: "tool-approval-response",
+                approvalId: "approval_456",
+                approved: true,
+              },
+            ],
+          },
+          order: 2,
+        } as MessageDoc,
+      ];
+
+      const result = filterOutOrphanedToolMessages(messages);
+      expect(result).toHaveLength(2);
+      // The assistant message should still contain the tool-call
+      expect(result[0]._id).toBe("1");
+      const assistantContent = result[0].message?.content;
+      expect(Array.isArray(assistantContent)).toBe(true);
+      if (Array.isArray(assistantContent)) {
+        const toolCall = assistantContent.find((p) => p.type === "tool-call");
+        expect(toolCall).toBeDefined();
+        expect(toolCall?.toolCallId).toBe("call_123");
+      }
+      // The tool message with approval response should be kept
+      expect(result[1]._id).toBe("2");
+    });
+
+    it("should filter out tool calls with approval request but NO approval response", () => {
+      const messages: MessageDoc[] = [
+        {
+          _id: "1",
+          message: {
+            role: "assistant",
+            content: [
+              { type: "text", text: "I'll run the dangerous tool" },
+              {
+                type: "tool-call",
+                toolCallId: "call_123",
+                toolName: "dangerousTool",
+                input: { action: "delete" },
+                args: { action: "delete" },
+              },
+              {
+                type: "tool-approval-request",
+                toolCallId: "call_123",
+                approvalId: "approval_456",
+              },
+            ],
+          },
+          order: 1,
+        } as MessageDoc,
+        // No approval response provided
+      ];
+
+      const result = filterOutOrphanedToolMessages(messages);
+      expect(result).toHaveLength(1);
+      // The assistant message should have the tool-call filtered out
+      const assistantContent = result[0].message?.content;
+      expect(Array.isArray(assistantContent)).toBe(true);
+      if (Array.isArray(assistantContent)) {
+        // Text and approval-request should remain, but tool-call should be filtered
+        expect(assistantContent).toHaveLength(2);
+        expect(assistantContent.find((p) => p.type === "text")).toBeDefined();
+        expect(
+          assistantContent.find((p) => p.type === "tool-approval-request"),
+        ).toBeDefined();
+        expect(
+          assistantContent.find((p) => p.type === "tool-call"),
+        ).toBeUndefined();
+      }
+    });
+
+    it("should handle mix of tool calls with results and with approvals", () => {
+      const messages: MessageDoc[] = [
+        {
+          _id: "1",
+          message: {
+            role: "assistant",
+            content: [
+              {
+                type: "tool-call",
+                toolCallId: "call_with_result",
+                toolName: "safeTool",
+                input: {},
+                args: {},
+              },
+              {
+                type: "tool-call",
+                toolCallId: "call_with_approval",
+                toolName: "dangerousTool",
+                input: {},
+                args: {},
+              },
+              {
+                type: "tool-approval-request",
+                toolCallId: "call_with_approval",
+                approvalId: "approval_789",
+              },
+            ],
+          },
+          order: 1,
+        } as MessageDoc,
+        {
+          _id: "2",
+          message: {
+            role: "tool",
+            content: [
+              {
+                type: "tool-result",
+                toolCallId: "call_with_result",
+                result: "success",
+              },
+              {
+                type: "tool-approval-response",
+                approvalId: "approval_789",
+                approved: true,
+              },
+            ],
+          },
+          order: 2,
+        } as MessageDoc,
+      ];
+
+      const result = filterOutOrphanedToolMessages(messages);
+      expect(result).toHaveLength(2);
+      // Both tool calls should be kept
+      const assistantContent = result[0].message?.content;
+      expect(Array.isArray(assistantContent)).toBe(true);
+      if (Array.isArray(assistantContent)) {
+        const toolCalls = assistantContent.filter(
+          (p) => p.type === "tool-call",
+        );
+        expect(toolCalls).toHaveLength(2);
+      }
+    });
   });
 
   describe("fetchContextMessages", () => {
diff --git a/src/client/search.ts b/src/client/search.ts
index 5c970932..ba1e91ad 100644
--- a/src/client/search.ts
+++ b/src/client/search.ts
@@ -231,12 +231,19 @@ export async function fetchRecentAndSearchMessages(
 
 /**
  * Filter out tool messages that don't have both a tool call and response.
+ * For the approval workflow, tool calls with approval responses (but no tool-results yet)
+ * should also be kept.
  * @param docs The messages to filter.
  * @returns The filtered messages.
  */
 export function filterOutOrphanedToolMessages(docs: MessageDoc[]) {
   const toolCallIds = new Set<string>();
   const toolResultIds = new Set<string>();
+  // Track approval workflow: toolCallId → approvalId
+  const approvalRequestsByToolCallId = new Map<string, string>();
+  // Track which approvalIds have responses
+  const approvalResponseIds = new Set<string>();
+
   const result: MessageDoc[] = [];
   for (const doc of docs) {
     if (doc.message && Array.isArray(doc.message.content)) {
@@ -245,17 +252,43 @@ export function filterOutOrphanedToolMessages(docs: MessageDoc[]) {
           toolCallIds.add(content.toolCallId);
         } else if (content.type === "tool-result") {
           toolResultIds.add(content.toolCallId);
+        } else if (content.type === "tool-approval-request") {
+          const approvalRequest = content as {
+            type: "tool-approval-request";
+            toolCallId: string;
+            approvalId: string;
+          };
+          approvalRequestsByToolCallId.set(
+            approvalRequest.toolCallId,
+            approvalRequest.approvalId,
+          );
+        } else if (content.type === "tool-approval-response") {
+          const approvalResponse = content as {
+            type: "tool-approval-response";
+            approvalId: string;
+          };
+          approvalResponseIds.add(approvalResponse.approvalId);
         }
       }
     }
   }
+
+  // Helper: check if tool call has a corresponding approval response
+  const hasApprovalResponse = (toolCallId: string) => {
+    const approvalId = approvalRequestsByToolCallId.get(toolCallId);
+    return approvalId !== undefined && approvalResponseIds.has(approvalId);
+  };
+
   for (const doc of docs) {
     if (
       doc.message?.role === "assistant" &&
       Array.isArray(doc.message.content)
     ) {
       const content = doc.message.content.filter(
-        (p) => p.type !== "tool-call" || toolResultIds.has(p.toolCallId),
+        (p) =>
+          p.type !== "tool-call" ||
+          toolResultIds.has(p.toolCallId) ||
+          hasApprovalResponse(p.toolCallId),
       );
       if (content.length) {
         result.push({
@@ -305,7 +338,10 @@ export async function embedMessages(
     userId: string | undefined;
     threadId: string | undefined;
     agentName?: string;
-  } & Pick<Config, "usageHandler" | "textEmbeddingModel" | "embeddingModel" | "callSettings">,
+  } & Pick<
+    Config,
+    "usageHandler" | "textEmbeddingModel" | "embeddingModel" | "callSettings"
+  >,
   messages: (ModelMessage | Message)[],
 ): Promise<
   | {
@@ -315,7 +351,8 @@ export async function embedMessages(
     }
   | undefined
 > {
-  const textEmbeddingModel = options.embeddingModel ?? options.textEmbeddingModel;
+  const textEmbeddingModel =
+    options.embeddingModel ?? options.textEmbeddingModel;
   if (!textEmbeddingModel) {
     return undefined;
   }
@@ -374,7 +411,10 @@ export async function embedMany(
     abortSignal?: AbortSignal;
     headers?: Record<string, string>;
     agentName?: string;
-  } & Pick<Config, "usageHandler" | "textEmbeddingModel" | "embeddingModel" | "callSettings">,
+  } & Pick<
+    Config,
+    "usageHandler" | "textEmbeddingModel" | "embeddingModel" | "callSettings"
+  >,
 ): Promise<{ embeddings: number[][] }> {
   const {
     userId,
@@ -442,7 +482,8 @@ export async function generateAndSaveEmbeddings(
   } & Pick<Config, "usageHandler" | "callSettings">,
   messages: MessageDoc[],
 ) {
-  const effectiveEmbeddingModel = args.embeddingModel ?? args.textEmbeddingModel;
+  const effectiveEmbeddingModel =
+    args.embeddingModel ?? args.textEmbeddingModel;
   if (!effectiveEmbeddingModel) {
     throw new Error(
       "an embeddingModel (or textEmbeddingModel) is required to generate and save embeddings",

From 47c478045de7eb40e12d3c63cede1f063a909553 Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sun, 18 Jan 2026 21:08:11 -0500
Subject: [PATCH 24/26] Refactor GetEmbedding type to support optional
 embeddingModel and improve deprecation handling.

---
 src/client/search.ts | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/src/client/search.ts b/src/client/search.ts
index ba1e91ad..e3a73dc4 100644
--- a/src/client/search.ts
+++ b/src/client/search.ts
@@ -36,14 +36,20 @@ const DEFAULT_VECTOR_SCORE_THRESHOLD = 0.0;
 // the 8k token limit for some models.
 const MAX_EMBEDDING_TEXT_LENGTH = 10_000;
 
-export type GetEmbedding = (text: string) => Promise<{
-  embedding: number[];
-  /**
-   * @deprecated Use embeddingModel instead.
-   */
-  textEmbeddingModel?: string | EmbeddingModel;
-  embeddingModel: string | EmbeddingModel;
-}>;
+export type GetEmbedding = (text: string) => Promise<
+  | {
+      embedding: number[];
+      /** @deprecated Use embeddingModel instead. */
+      textEmbeddingModel: string | EmbeddingModel;
+      embeddingModel?: string | EmbeddingModel;
+    }
+  | {
+      embedding: number[];
+      /** @deprecated Use embeddingModel instead. */
+      textEmbeddingModel?: string | EmbeddingModel;
+      embeddingModel: string | EmbeddingModel;
+    }
+>;
 
 /**
  * Fetch the context messages for a thread.

From c1abfc3ffaef0a85f74d5262a49a502173c39ae9 Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sun, 18 Jan 2026 21:36:21 -0500
Subject: [PATCH 25/26] Fix streaming error after tool approval by suppressing
 orphaned tool-result errors since stored messages have the complete data.

---
 src/deltas.test.ts | 43 +++++++++++++++++++++++++++++++++++++++++++
 src/deltas.ts      | 31 +++++++++++++++++++++++++------
 2 files changed, 68 insertions(+), 6 deletions(-)

diff --git a/src/deltas.test.ts b/src/deltas.test.ts
index e39f5573..6be75868 100644
--- a/src/deltas.test.ts
+++ b/src/deltas.test.ts
@@ -156,6 +156,49 @@ describe("UIMessageChunks", () => {
   });
 });
 
+describe("UIMessageChunks - continuation stream", () => {
+  it("gracefully handles tool-result without tool-call in continuation stream after approval", async () => {
+    // This simulates what happens after tool approval:
+    // Stream A: tool-call, tool-approval-request -> finishes
+    // User approves
+    // Stream B: tool-result (referencing tool-call from Stream A) -> this test
+    //
+    // The AI SDK's readUIMessageStream expects tool-call before tool-result,
+    // but they're in different streams. The onError handler should gracefully
+    // ignore this error since stored messages provide the fallback.
+    const uiMessage = blankUIMessage(
+      {
+        streamId: "continuation-stream",
+        status: "streaming",
+        order: 1,
+        stepOrder: 0,
+        format: "UIMessageChunk",
+        agentName: "agent1",
+      },
+      "thread1",
+    );
+
+    // Send a tool-result without the corresponding tool-call in this stream
+    // This would normally throw "No tool invocation found" error
+    const updatedMessage = await updateFromUIMessageChunks(uiMessage, [
+      { type: "start" },
+      { type: "start-step" },
+      {
+        type: "tool-output-available",
+        toolCallId: "call_from_previous_stream",
+        output: "Tool execution result",
+      },
+      { type: "finish-step" },
+      { type: "finish" },
+    ]);
+
+    // The message should NOT be marked as failed - the error should be suppressed
+    expect(updatedMessage.status).not.toBe("failed");
+    // The stream still processes (even if tool-output isn't reflected without tool-input)
+    expect(updatedMessage).toBeDefined();
+  });
+});
+
 describe("mergeDeltas", () => {
   it("merges a single text-delta into a message", () => {
     const streamId = "s1";
diff --git a/src/deltas.ts b/src/deltas.ts
index 15d20a6a..bfe58b73 100644
--- a/src/deltas.ts
+++ b/src/deltas.ts
@@ -66,22 +66,41 @@ export async function updateFromUIMessageChunks(
     },
   });
   let failed = false;
+  let suppressError = false;
   const messageStream = readUIMessageStream({
     message: uiMessage,
     stream: partsStream,
     onError: (e) => {
+      const errorMessage = e instanceof Error ? e.message : String(e);
+      // Tool invocation errors can be safely ignored when streaming continuation
+      // after tool approval - the stored messages have the complete tool context
+      if (errorMessage.toLowerCase().includes("no tool invocation found")) {
+        console.warn(
+          "Tool invocation not found in continuation stream - using stored messages",
+        );
+        suppressError = true;
+        return;
+      }
       failed = true;
       console.error("Error in stream", e);
     },
     terminateOnError: true,
   });
   let message = uiMessage;
-  for await (const messagePart of messageStream) {
-    assert(
-      messagePart.id === message.id,
-      `Expecting to only make one UIMessage in a stream`,
-    );
-    message = messagePart;
+  try {
+    for await (const messagePart of messageStream) {
+      assert(
+        messagePart.id === message.id,
+        `Expecting to only make one UIMessage in a stream`,
+      );
+      message = messagePart;
+    }
+  } catch (e) {
+    // If we've already handled this error in onError and marked it as suppressed,
+    // don't rethrow - the stored messages provide the fallback
+    if (!suppressError) {
+      throw e;
+    }
   }
   if (failed) {
     message.status = "failed";

From f07fdd58a3fac2efdbe329d70155e15587e9a1e4 Mon Sep 17 00:00:00 2001
From: Zac <2215540+zboyles@users.noreply.github.com>
Date: Sun, 18 Jan 2026 21:57:44 -0500
Subject: [PATCH 26/26] Silently suppress tool invocation errors in
 continuation stream after tool approval, as stored messages contain complete
 context.

---
 src/deltas.ts | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/deltas.ts b/src/deltas.ts
index bfe58b73..b62f2338 100644
--- a/src/deltas.ts
+++ b/src/deltas.ts
@@ -75,9 +75,8 @@ export async function updateFromUIMessageChunks(
       // Tool invocation errors can be safely ignored when streaming continuation
       // after tool approval - the stored messages have the complete tool context
       if (errorMessage.toLowerCase().includes("no tool invocation found")) {
-        console.warn(
-          "Tool invocation not found in continuation stream - using stored messages",
-        );
+        // Silently suppress - this is expected after tool approval when the
+        // continuation stream has tool-result without the original tool-call
         suppressError = true;
         return;
       }