agents 0.0.0-4768b8d → 0.0.0-48849be

package/dist/ai-chat-v5-migration-BSiGZmYU.js

@@ -0,0 +1,155 @@
+//#region src/ai-chat-v5-migration.ts
+/**
+* Tool call state mapping for v4 to v5 migration
+*/
+const STATE_MAP = {
+	"partial-call": "input-streaming",
+	call: "input-available",
+	result: "output-available",
+	error: "output-error"
+};
+/**
+* Checks if a message is already in the UIMessage format (has parts array)
+*/
+function isUIMessage(message) {
+	return typeof message === "object" && message !== null && "parts" in message && Array.isArray(message.parts);
+}
+/**
+* Type guard to check if a message is in legacy format (content as string)
+*/
+function isLegacyMessage(message) {
+	return typeof message === "object" && message !== null && "role" in message && "content" in message && typeof message.role === "string" && typeof message.content === "string";
+}
+/**
+* Type guard to check if a message has corrupted array content format
+* Detects: {role: "user", content: [{type: "text", text: "..."}]}
+*/
+function isCorruptArrayMessage(message) {
+	return typeof message === "object" && message !== null && "role" in message && "content" in message && typeof message.role === "string" && Array.isArray(message.content) && !("parts" in message);
+}
+/**
+* Automatic message transformer following the blog post pattern
+* Handles comprehensive migration from AI SDK v4 to v5 format
+* @param message - Message in any legacy format
+* @param index - Index for ID generation fallback
+* @returns UIMessage in v5 format
+*/
+function autoTransformMessage(message, index = 0) {
+	if (isUIMessage(message)) return message;
+	const parts = [];
+	if (message.reasoning) parts.push({
+		type: "reasoning",
+		text: message.reasoning
+	});
+	if (message.toolInvocations && Array.isArray(message.toolInvocations)) message.toolInvocations.forEach((inv) => {
+		if (typeof inv === "object" && inv !== null && "toolName" in inv) {
+			const invObj = inv;
+			parts.push({
+				type: `tool-${invObj.toolName}`,
+				toolCallId: invObj.toolCallId,
+				state: STATE_MAP[invObj.state] || "input-available",
+				input: invObj.args,
+				output: invObj.result !== void 0 ? invObj.result : null
+			});
+		}
+	});
+	if (message.parts && Array.isArray(message.parts)) message.parts.forEach((part) => {
+		if (typeof part === "object" && part !== null && "type" in part) {
+			const partObj = part;
+			if (partObj.type === "file") parts.push({
+				type: "file",
+				url: partObj.url || (partObj.data ? `data:${partObj.mimeType || partObj.mediaType};base64,${partObj.data}` : void 0),
+				mediaType: partObj.mediaType || partObj.mimeType,
+				filename: partObj.filename
+			});
+		}
+	});
+	if (Array.isArray(message.content)) message.content.forEach((item) => {
+		if (typeof item === "object" && item !== null && "text" in item) {
+			const itemObj = item;
+			parts.push({
+				type: itemObj.type || "text",
+				text: itemObj.text || ""
+			});
+		}
+	});
+	if (!parts.length && message.content !== void 0) parts.push({
+		type: "text",
+		text: typeof message.content === "string" ? message.content : JSON.stringify(message.content)
+	});
+	if (!parts.length) parts.push({
+		type: "text",
+		text: typeof message === "string" ? message : JSON.stringify(message)
+	});
+	return {
+		id: message.id || `msg-${index}`,
+		role: message.role === "data" ? "system" : message.role || "user",
+		parts
+	};
+}
+/**
+* Legacy single message migration for backward compatibility
+*/
+function migrateToUIMessage(message) {
+	return autoTransformMessage(message);
+}
+/**
+* Automatic message transformer for arrays following the blog post pattern
+* @param messages - Array of messages in any format
+* @returns Array of UIMessages in v5 format
+*/
+function autoTransformMessages(messages) {
+	return messages.map((msg, i) => autoTransformMessage(msg, i));
+}
+/**
+* Migrates an array of messages to UIMessage format (legacy compatibility)
+* @param messages - Array of messages in old or new format
+* @returns Array of UIMessages in the new format
+*/
+function migrateMessagesToUIFormat(messages) {
+	return autoTransformMessages(messages);
+}
+/**
+* Checks if any messages in an array need migration
+* @param messages - Array of messages to check
+* @returns true if any messages are not in proper UIMessage format
+*/
+function needsMigration(messages) {
+	return messages.some((message) => {
+		if (isUIMessage(message)) return false;
+		if (isCorruptArrayMessage(message)) return true;
+		if (isLegacyMessage(message)) return true;
+		return true;
+	});
+}
+/**
+* Analyzes the corruption types in a message array for debugging
+* @param messages - Array of messages to analyze
+* @returns Statistics about corruption types found
+*/
+function analyzeCorruption(messages) {
+	const stats = {
+		total: messages.length,
+		clean: 0,
+		legacyString: 0,
+		corruptArray: 0,
+		unknown: 0,
+		examples: {}
+	};
+	for (const message of messages) if (isUIMessage(message)) stats.clean++;
+	else if (isCorruptArrayMessage(message)) {
+		stats.corruptArray++;
+		if (!stats.examples.corruptArray) stats.examples.corruptArray = message;
+	} else if (isLegacyMessage(message)) {
+		stats.legacyString++;
+		if (!stats.examples.legacyString) stats.examples.legacyString = message;
+	} else {
+		stats.unknown++;
+		if (!stats.examples.unknown) stats.examples.unknown = message;
+	}
+	return stats;
+}
+
+//#endregion
+export { migrateMessagesToUIFormat as a, isUIMessage as i, autoTransformMessage as n, migrateToUIMessage as o, autoTransformMessages as r, needsMigration as s, analyzeCorruption as t };
+//# sourceMappingURL=ai-chat-v5-migration-BSiGZmYU.js.map

package/dist/ai-chat-v5-migration-BSiGZmYU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-chat-v5-migration-BSiGZmYU.js","names":["parts: TransformMessagePart[]"],"sources":["../src/ai-chat-v5-migration.ts"],"sourcesContent":["import type { UIMessage } from \"ai\";\n\n/**\n * AI SDK v5 Migration following https://jhak.im/blog/ai-sdk-migration-handling-previously-saved-messages\n * Using exact types from the official AI SDK documentation\n */\n\n/**\n * AI SDK v5 Message Part types reference (from official AI SDK documentation)\n *\n * The migration logic below transforms legacy messages to match these official AI SDK v5 formats:\n * - TextUIPart: { type: \"text\", text: string, state?: \"streaming\" | \"done\" }\n * - ReasoningUIPart: { type: \"reasoning\", text: string, state?: \"streaming\" | \"done\", providerMetadata?: Record<string, unknown> }\n * - FileUIPart: { type: \"file\", mediaType: string, filename?: string, url: string }\n * - ToolUIPart: { type: `tool-${string}`, toolCallId: string, state: \"input-streaming\" | \"input-available\" | \"output-available\" | \"output-error\", input?: Record<string, unknown>, output?: unknown, errorText?: string, providerExecuted?: boolean }\n */\n\n/**\n * Tool invocation from v4 format\n */\ntype ToolInvocation = {\n  toolCallId: string;\n  toolName: string;\n  args: Record<string, unknown>;\n  result?: unknown;\n  state: \"partial-call\" | \"call\" | \"result\" | \"error\";\n};\n\n/**\n * Legacy part from v4 format\n */\ntype LegacyPart = {\n  type: string;\n  text?: string;\n  url?: string;\n  data?: string;\n  mimeType?: string;\n  mediaType?: string;\n  filename?: string;\n};\n\n/**\n * Legacy message format from AI SDK v4\n */\nexport type LegacyMessage = {\n  id?: string;\n  role: string;\n  content: string;\n  reasoning?: string;\n  toolInvocations?: ToolInvocation[];\n  parts?: LegacyPart[];\n  [key: string]: unknown;\n};\n\n/**\n * Corrupt content item\n */\ntype CorruptContentItem = {\n  type: string;\n  text: string;\n};\n\n/**\n * Corrupted message format - has content as array instead of parts\n */\nexport type CorruptArrayMessage = {\n  id?: string;\n  role: string;\n  content: CorruptContentItem[];\n  reasoning?: string;\n  toolInvocations?: ToolInvocation[];\n  [key: string]: unknown;\n};\n\n/**\n * Union type for messages that could be in any format\n */\nexport type MigratableMessage = LegacyMessage | CorruptArrayMessage | UIMessage;\n\n/**\n * Tool call state mapping for v4 to v5 migration\n */\nconst STATE_MAP = {\n  \"partial-call\": \"input-streaming\",\n  call: \"input-available\",\n  result: \"output-available\",\n  error: \"output-error\"\n} as const;\n\n/**\n * Checks if a message is already in the UIMessage format (has parts array)\n */\nexport function isUIMessage(message: unknown): message is UIMessage {\n  return (\n    typeof message === \"object\" &&\n    message !== null &&\n    \"parts\" in message &&\n    Array.isArray((message as { parts: unknown }).parts)\n  );\n}\n\n/**\n * Type guard to check if a message is in legacy format (content as string)\n */\nfunction isLegacyMessage(message: unknown): message is LegacyMessage {\n  return (\n    typeof message === \"object\" &&\n    message !== null &&\n    \"role\" in message &&\n    \"content\" in message &&\n    typeof (message as { role: unknown }).role === \"string\" &&\n    typeof (message as { content: unknown }).content === \"string\"\n  );\n}\n\n/**\n * Type guard to check if a message has corrupted array content format\n * Detects: {role: \"user\", content: [{type: \"text\", text: \"...\"}]}\n */\nfunction isCorruptArrayMessage(\n  message: unknown\n): message is CorruptArrayMessage {\n  return (\n    typeof message === \"object\" &&\n    message !== null &&\n    \"role\" in message &&\n    \"content\" in message &&\n    typeof (message as { role: unknown }).role === \"string\" &&\n    Array.isArray((message as { content: unknown }).content) &&\n    !(\"parts\" in message) // Ensure it's not already a UIMessage\n  );\n}\n\n/**\n * Internal message part type for transformation\n */\ntype TransformMessagePart = {\n  type: string;\n  text?: string;\n  toolCallId?: string;\n  state?: string;\n  input?: Record<string, unknown>;\n  output?: unknown;\n  url?: string;\n  mediaType?: string;\n  errorText?: string;\n  filename?: string;\n};\n\n/**\n * Input message that could be in any format - using unknown for flexibility\n */\ntype InputMessage = {\n  id?: string;\n  role?: string;\n  content?: unknown;\n  reasoning?: string;\n  toolInvocations?: unknown[];\n  parts?: unknown[];\n  [key: string]: unknown;\n};\n\n/**\n * Automatic message transformer following the blog post pattern\n * Handles comprehensive migration from AI SDK v4 to v5 format\n * @param message - Message in any legacy format\n * @param index - Index for ID generation fallback\n * @returns UIMessage in v5 format\n */\nexport function autoTransformMessage(\n  message: InputMessage,\n  index = 0\n): UIMessage {\n  // Already in v5 format\n  if (isUIMessage(message)) {\n    return message;\n  }\n\n  const parts: TransformMessagePart[] = [];\n\n  // Handle reasoning transformation\n  if (message.reasoning) {\n    parts.push({\n      type: \"reasoning\",\n      text: message.reasoning\n    });\n  }\n\n  // Handle tool invocations transformation\n  if (message.toolInvocations && Array.isArray(message.toolInvocations)) {\n    message.toolInvocations.forEach((inv: unknown) => {\n      if (typeof inv === \"object\" && inv !== null && \"toolName\" in inv) {\n        const invObj = inv as ToolInvocation;\n        parts.push({\n          type: `tool-${invObj.toolName}`,\n          toolCallId: invObj.toolCallId,\n          state:\n            STATE_MAP[invObj.state as keyof typeof STATE_MAP] ||\n            \"input-available\",\n          input: invObj.args,\n          output: invObj.result !== undefined ? invObj.result : null\n        });\n      }\n    });\n  }\n\n  // Handle file parts transformation\n  if (message.parts && Array.isArray(message.parts)) {\n    message.parts.forEach((part: unknown) => {\n      if (typeof part === \"object\" && part !== null && \"type\" in part) {\n        const partObj = part as LegacyPart;\n        if (partObj.type === \"file\") {\n          parts.push({\n            type: \"file\",\n            url:\n              partObj.url ||\n              (partObj.data\n                ? `data:${partObj.mimeType || partObj.mediaType};base64,${partObj.data}`\n                : undefined),\n            mediaType: partObj.mediaType || partObj.mimeType,\n            filename: partObj.filename\n          });\n        }\n      }\n    });\n  }\n\n  // Handle corrupt array format: {role: \"user\", content: [{type: \"text\", text: \"...\"}]}\n  if (Array.isArray(message.content)) {\n    message.content.forEach((item: unknown) => {\n      if (typeof item === \"object\" && item !== null && \"text\" in item) {\n        const itemObj = item as CorruptContentItem;\n        parts.push({\n          type: itemObj.type || \"text\",\n          text: itemObj.text || \"\"\n        });\n      }\n    });\n  }\n\n  // Fallback: convert plain content to text part\n  if (!parts.length && message.content !== undefined) {\n    parts.push({\n      type: \"text\",\n      text:\n        typeof message.content === \"string\"\n          ? message.content\n          : JSON.stringify(message.content)\n    });\n  }\n\n  // If still no parts, create a default text part\n  if (!parts.length) {\n    parts.push({\n      type: \"text\",\n      text: typeof message === \"string\" ? message : JSON.stringify(message)\n    });\n  }\n\n  return {\n    id: message.id || `msg-${index}`,\n    role:\n      message.role === \"data\"\n        ? \"system\"\n        : (message.role as \"user\" | \"assistant\" | \"system\") || \"user\",\n    parts: parts as UIMessage[\"parts\"]\n  };\n}\n\n/**\n * Legacy single message migration for backward compatibility\n */\nexport function migrateToUIMessage(message: MigratableMessage): UIMessage {\n  return autoTransformMessage(message as InputMessage);\n}\n\n/**\n * Automatic message transformer for arrays following the blog post pattern\n * @param messages - Array of messages in any format\n * @returns Array of UIMessages in v5 format\n */\nexport function autoTransformMessages(messages: unknown[]): UIMessage[] {\n  return messages.map((msg, i) => autoTransformMessage(msg as InputMessage, i));\n}\n\n/**\n * Migrates an array of messages to UIMessage format (legacy compatibility)\n * @param messages - Array of messages in old or new format\n * @returns Array of UIMessages in the new format\n */\nexport function migrateMessagesToUIFormat(\n  messages: MigratableMessage[]\n): UIMessage[] {\n  return autoTransformMessages(messages as InputMessage[]);\n}\n\n/**\n * Checks if any messages in an array need migration\n * @param messages - Array of messages to check\n * @returns true if any messages are not in proper UIMessage format\n */\nexport function needsMigration(messages: unknown[]): boolean {\n  return messages.some((message) => {\n    // If it's already a UIMessage, no migration needed\n    if (isUIMessage(message)) {\n      return false;\n    }\n\n    // Check for corrupt array format specifically\n    if (isCorruptArrayMessage(message)) {\n      return true;\n    }\n\n    // Check for legacy string format\n    if (isLegacyMessage(message)) {\n      return true;\n    }\n\n    // Any other format needs migration\n    return true;\n  });\n}\n\n/**\n * Analyzes the corruption types in a message array for debugging\n * @param messages - Array of messages to analyze\n * @returns Statistics about corruption types found\n */\nexport function analyzeCorruption(messages: unknown[]): {\n  total: number;\n  clean: number;\n  legacyString: number;\n  corruptArray: number;\n  unknown: number;\n  examples: {\n    legacyString?: unknown;\n    corruptArray?: unknown;\n    unknown?: unknown;\n  };\n} {\n  const stats = {\n    total: messages.length,\n    clean: 0,\n    legacyString: 0,\n    corruptArray: 0,\n    unknown: 0,\n    examples: {} as {\n      legacyString?: unknown;\n      corruptArray?: unknown;\n      unknown?: unknown;\n    }\n  };\n\n  for (const message of messages) {\n    if (isUIMessage(message)) {\n      stats.clean++;\n    } else if (isCorruptArrayMessage(message)) {\n      stats.corruptArray++;\n      if (!stats.examples.corruptArray) {\n        stats.examples.corruptArray = message;\n      }\n    } else if (isLegacyMessage(message)) {\n      stats.legacyString++;\n      if (!stats.examples.legacyString) {\n        stats.examples.legacyString = message;\n      }\n    } else {\n      stats.unknown++;\n      if (!stats.examples.unknown) {\n        stats.examples.unknown = message;\n      }\n    }\n  }\n\n  return stats;\n}\n"],"mappings":"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"}

package/dist/ai-chat-v5-migration.d.ts

@@ -0,0 +1,155 @@
+import { UIMessage } from "ai";
+
+//#region src/ai-chat-v5-migration.d.ts
+
+/**
+ * AI SDK v5 Migration following https://jhak.im/blog/ai-sdk-migration-handling-previously-saved-messages
+ * Using exact types from the official AI SDK documentation
+ */
+/**
+ * AI SDK v5 Message Part types reference (from official AI SDK documentation)
+ *
+ * The migration logic below transforms legacy messages to match these official AI SDK v5 formats:
+ * - TextUIPart: { type: "text", text: string, state?: "streaming" | "done" }
+ * - ReasoningUIPart: { type: "reasoning", text: string, state?: "streaming" | "done", providerMetadata?: Record<string, unknown> }
+ * - FileUIPart: { type: "file", mediaType: string, filename?: string, url: string }
+ * - ToolUIPart: { type: `tool-${string}`, toolCallId: string, state: "input-streaming" | "input-available" | "output-available" | "output-error", input?: Record<string, unknown>, output?: unknown, errorText?: string, providerExecuted?: boolean }
+ */
+/**
+ * Tool invocation from v4 format
+ */
+type ToolInvocation = {
+  toolCallId: string;
+  toolName: string;
+  args: Record<string, unknown>;
+  result?: unknown;
+  state: "partial-call" | "call" | "result" | "error";
+};
+/**
+ * Legacy part from v4 format
+ */
+type LegacyPart = {
+  type: string;
+  text?: string;
+  url?: string;
+  data?: string;
+  mimeType?: string;
+  mediaType?: string;
+  filename?: string;
+};
+/**
+ * Legacy message format from AI SDK v4
+ */
+type LegacyMessage = {
+  id?: string;
+  role: string;
+  content: string;
+  reasoning?: string;
+  toolInvocations?: ToolInvocation[];
+  parts?: LegacyPart[];
+  [key: string]: unknown;
+};
+/**
+ * Corrupt content item
+ */
+type CorruptContentItem = {
+  type: string;
+  text: string;
+};
+/**
+ * Corrupted message format - has content as array instead of parts
+ */
+type CorruptArrayMessage = {
+  id?: string;
+  role: string;
+  content: CorruptContentItem[];
+  reasoning?: string;
+  toolInvocations?: ToolInvocation[];
+  [key: string]: unknown;
+};
+/**
+ * Union type for messages that could be in any format
+ */
+type MigratableMessage = LegacyMessage | CorruptArrayMessage | UIMessage;
+/**
+ * Checks if a message is already in the UIMessage format (has parts array)
+ */
+declare function isUIMessage(message: unknown): message is UIMessage;
+/**
+ * Input message that could be in any format - using unknown for flexibility
+ */
+type InputMessage = {
+  id?: string;
+  role?: string;
+  content?: unknown;
+  reasoning?: string;
+  toolInvocations?: unknown[];
+  parts?: unknown[];
+  [key: string]: unknown;
+};
+/**
+ * Automatic message transformer following the blog post pattern
+ * Handles comprehensive migration from AI SDK v4 to v5 format
+ * @param message - Message in any legacy format
+ * @param index - Index for ID generation fallback
+ * @returns UIMessage in v5 format
+ */
+declare function autoTransformMessage(
+  message: InputMessage,
+  index?: number
+): UIMessage;
+/**
+ * Legacy single message migration for backward compatibility
+ */
+declare function migrateToUIMessage(message: MigratableMessage): UIMessage;
+/**
+ * Automatic message transformer for arrays following the blog post pattern
+ * @param messages - Array of messages in any format
+ * @returns Array of UIMessages in v5 format
+ */
+declare function autoTransformMessages(messages: unknown[]): UIMessage[];
+/**
+ * Migrates an array of messages to UIMessage format (legacy compatibility)
+ * @param messages - Array of messages in old or new format
+ * @returns Array of UIMessages in the new format
+ */
+declare function migrateMessagesToUIFormat(
+  messages: MigratableMessage[]
+): UIMessage[];
+/**
+ * Checks if any messages in an array need migration
+ * @param messages - Array of messages to check
+ * @returns true if any messages are not in proper UIMessage format
+ */
+declare function needsMigration(messages: unknown[]): boolean;
+/**
+ * Analyzes the corruption types in a message array for debugging
+ * @param messages - Array of messages to analyze
+ * @returns Statistics about corruption types found
+ */
+declare function analyzeCorruption(messages: unknown[]): {
+  total: number;
+  clean: number;
+  legacyString: number;
+  corruptArray: number;
+  unknown: number;
+  examples: {
+    legacyString?: unknown;
+    corruptArray?: unknown;
+    unknown?: unknown;
+  };
+};
+//#endregion
+export {
+  CorruptArrayMessage,
+  LegacyMessage,
+  MigratableMessage,
+  analyzeCorruption,
+  autoTransformMessage,
+  autoTransformMessages,
+  isUIMessage,
+  migrateMessagesToUIFormat,
+  migrateToUIMessage,
+  needsMigration
+};
+//# sourceMappingURL=ai-chat-v5-migration.d.ts.map

package/dist/ai-chat-v5-migration.js

@@ -0,0 +1,3 @@
+import { a as migrateMessagesToUIFormat, i as isUIMessage, n as autoTransformMessage, o as migrateToUIMessage, r as autoTransformMessages, s as needsMigration, t as analyzeCorruption } from "./ai-chat-v5-migration-BSiGZmYU.js";
+
+export { analyzeCorruption, autoTransformMessage, autoTransformMessages, isUIMessage, migrateMessagesToUIFormat, migrateToUIMessage, needsMigration };

package/dist/ai-react.d.ts

@@ -1,60 +1,89 @@
-import * as ai from 'ai';
-import { Message } from 'ai';
-import { useChat } from '@ai-sdk/react';
-import { useAgent } from './react.js';
-import 'partysocket';
-import 'partysocket/react';
-import './client.js';
+import "./client-ctTw3KHG.js";
+import "./mcp-BwPscEiF.js";
+import "./do-oauth-client-provider-UhQDpDb8.js";
+import "./index-BUle9RiP.js";
+import "./ai-types-DLtxDE4L.js";
+import "./index-BygUGrr9.js";
+import "./serializable-faDkMCai.js";
+import "./client-BAQA84dr.js";
+import { n as useAgent } from "./react-CMF2YDq6.js";
+import { UseChatOptions, useChat } from "@ai-sdk/react";
+import { ChatInit, UIMessage } from "ai";
 
+//#region src/ai-react.d.ts
+type AITool<Input = unknown, Output = unknown> = {
+  description?: string;
+  inputSchema?: unknown;
+  execute?: (input: Input) => Output | Promise<Output>;
+};
 type GetInitialMessagesOptions = {
-    agent: string;
-    name: string;
-    url: string;
+  agent: string;
+  name: string;
+  url: string;
 };
+type UseChatParams<M extends UIMessage = UIMessage> = ChatInit<M> &
+  UseChatOptions<M>;
 /**
  * Options for the useAgentChat hook
  */
-type UseAgentChatOptions<State> = Omit<Parameters<typeof useChat>[0] & {
-    /** Agent connection from useAgent */
-    agent: ReturnType<typeof useAgent<State>>;
-    getInitialMessages?: undefined | null | ((options: GetInitialMessagesOptions) => Promise<Message[]>);
-}, "fetch">;
+type UseAgentChatOptions<
+  State,
+  ChatMessage extends UIMessage = UIMessage
+> = Omit<UseChatParams<ChatMessage>, "fetch"> & {
+  /** Agent connection from useAgent */
+  agent: ReturnType<typeof useAgent<State>>;
+  getInitialMessages?:
+    | undefined
+    | null
+    | ((options: GetInitialMessagesOptions) => Promise<ChatMessage[]>);
+  /** Request credentials */
+  credentials?: RequestCredentials;
+  /** Request headers */
+  headers?: HeadersInit;
+  /**
+   * @description Whether to automatically resolve tool calls that do not require human interaction.
+   * @experimental
+   */
+  experimental_automaticToolResolution?: boolean;
+  /**
+   * @description Tools object for automatic detection of confirmation requirements.
+   * Tools without execute function will require confirmation.
+   */
+  tools?: Record<string, AITool<unknown, unknown>>;
+  /**
+   * @description Manual override for tools requiring confirmation.
+   * If not provided, will auto-detect from tools object.
+   */
+  toolsRequiringConfirmation?: string[];
+  /**
+   * When true (default), automatically sends the next message only after
+   * all pending confirmation-required tool calls have been resolved.
+   * @default true
+   */
+  autoSendAfterAllConfirmationsResolved?: boolean;
+};
 /**
  * React hook for building AI chat interfaces using an Agent
  * @param options Chat options including the agent connection
  * @returns Chat interface controls and state with added clearHistory method
  */
-declare function useAgentChat<State = unknown>(options: UseAgentChatOptions<State>): {
-    /**
-     * Set the chat messages and synchronize with the Agent
-     * @param messages New messages to set
-     */
-    setMessages: (messages: Message[]) => void;
-    /**
-     * Clear chat history on both client and Agent
-     */
-    clearHistory: () => void;
-    messages: ai.UIMessage[];
-    error: undefined | Error;
-    append: (message: Message | ai.CreateMessage, chatRequestOptions?: ai.ChatRequestOptions) => Promise<string | null | undefined>;
-    reload: (chatRequestOptions?: ai.ChatRequestOptions) => Promise<string | null | undefined>;
-    stop: () => void;
-    input: string;
-    setInput: React.Dispatch<React.SetStateAction<string>>;
-    handleInputChange: (e: React.ChangeEvent<HTMLInputElement> | React.ChangeEvent<HTMLTextAreaElement>) => void;
-    handleSubmit: (event?: {
-        preventDefault?: () => void;
-    }, chatRequestOptions?: ai.ChatRequestOptions) => void;
-    metadata?: Object;
-    isLoading: boolean;
-    status: "submitted" | "streaming" | "ready" | "error";
-    data?: ai.JSONValue[];
-    setData: (data: ai.JSONValue[] | undefined | ((data: ai.JSONValue[] | undefined) => ai.JSONValue[] | undefined)) => void;
-    id: string;
-    addToolResult: ({ toolCallId, result, }: {
-        toolCallId: string;
-        result: any;
-    }) => void;
+/**
+ * Automatically detects which tools require confirmation based on their configuration.
+ * Tools require confirmation if they have no execute function AND are not server-executed.
+ * @param tools - Record of tool name to tool definition
+ * @returns Array of tool names that require confirmation
+ */
+declare function detectToolsRequiringConfirmation(
+  tools?: Record<string, AITool<unknown, unknown>>
+): string[];
+declare function useAgentChat<
+  State = unknown,
+  ChatMessage extends UIMessage = UIMessage
+>(
+  options: UseAgentChatOptions<State, ChatMessage>
+): ReturnType<typeof useChat<ChatMessage>> & {
+  clearHistory: () => void;
 };
-
-export { useAgentChat };
+//#endregion
+export { AITool, detectToolsRequiringConfirmation, useAgentChat };
+//# sourceMappingURL=ai-react.d.ts.map