agents 0.0.0-f913299 → 0.0.0-fac1fe8

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

@@ -0,0 +1,152 @@
+import { UIMessage } from "ai";
+
+/**
+ * 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;
+  };
+};
+
+export {
+  type CorruptArrayMessage,
+  type LegacyMessage,
+  type MigratableMessage,
+  analyzeCorruption,
+  autoTransformMessage,
+  autoTransformMessages,
+  isUIMessage,
+  migrateMessagesToUIFormat,
+  migrateToUIMessage,
+  needsMigration
+};

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

@@ -0,0 +1,19 @@
+import {
+  analyzeCorruption,
+  autoTransformMessage,
+  autoTransformMessages,
+  isUIMessage,
+  migrateMessagesToUIFormat,
+  migrateToUIMessage,
+  needsMigration
+} from "./chunk-UJVEAURM.js";
+export {
+  analyzeCorruption,
+  autoTransformMessage,
+  autoTransformMessages,
+  isUIMessage,
+  migrateMessagesToUIFormat,
+  migrateToUIMessage,
+  needsMigration
+};
+//# sourceMappingURL=ai-chat-v5-migration.js.map

package/dist/ai-react.d.ts

@@ -1,86 +1,92 @@
-import * as ai from "ai";
-import { Message } from "ai";
-import { useChat } from "@ai-sdk/react";
+import { UseChatOptions, useChat } from "@ai-sdk/react";
+import { UIMessage, ChatInit } from "ai";
 import { useAgent } from "./react.js";
 import "partysocket";
 import "partysocket/react";
+import "./index.js";
+import "cloudflare:workers";
+import "@modelcontextprotocol/sdk/client/index.js";
+import "@modelcontextprotocol/sdk/types.js";
+import "partyserver";
+import "./client-CvaJdLQA.js";
+import "zod";
+import "@modelcontextprotocol/sdk/shared/protocol.js";
+import "@modelcontextprotocol/sdk/client/sse.js";
+import "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import "./mcp/do-oauth-client-provider.js";
+import "@modelcontextprotocol/sdk/client/auth.js";
+import "@modelcontextprotocol/sdk/shared/auth.js";
+import "./observability/index.js";
+import "./ai-types.js";
 import "./client.js";
+import "./serializable.js";
 
+type AITool<Input = unknown, Output = unknown> = {
+  description?: string;
+  inputSchema?: unknown;
+  execute?: (input: Input) => Output | Promise<Output>;
+};
 type GetInitialMessagesOptions = {
   agent: string;
   name: string;
   url: string;
 };
+type UseChatParams<M extends UIMessage = UIMessage> = ChatInit<M> &
+  UseChatOptions<M>;
 /**
  * Options for the useAgentChat hook
  */
-type UseAgentChatOptions = Omit<
-  Parameters<typeof useChat>[0] & {
-    /** Agent connection from useAgent */
-    agent: ReturnType<typeof useAgent>;
-    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[];
+};
 /**
  * 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(options: UseAgentChatOptions): {
-  /**
-   * 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
-   */
+/**
+ * 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;
-  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;
 };
 
-export { useAgentChat };
+export { type AITool, detectToolsRequiringConfirmation, useAgentChat };