@providerprotocol/ai 0.0.6 → 0.0.8

package/src/providers/openai/types.ts

@@ -1,3 +1,61 @@
+// ============================================
+// Audio Configuration Types
+// ============================================
+
+/**
+ * Audio output configuration for Chat Completions
+ */
+export interface OpenAIAudioConfig {
+  /** Audio format */
+  format: 'wav' | 'aac' | 'mp3' | 'flac' | 'opus' | 'pcm16';
+  /** Voice to use for audio generation */
+  voice:
+    | 'alloy'
+    | 'ash'
+    | 'ballad'
+    | 'coral'
+    | 'echo'
+    | 'sage'
+    | 'shimmer'
+    | 'verse'
+    | 'marin'
+    | 'cedar';
+}
+
+// ============================================
+// Web Search Configuration Types
+// ============================================
+
+/**
+ * User location for web search context
+ * Requires type: 'approximate' with location fields at the same level
+ */
+export interface OpenAIWebSearchUserLocation {
+  /** Location type - must be 'approximate' */
+  type: 'approximate';
+  /** City name */
+  city?: string;
+  /** ISO 3166-1 country code (e.g., "US") */
+  country?: string;
+  /** Region/state name */
+  region?: string;
+  /** IANA timezone (e.g., "America/New_York") */
+  timezone?: string;
+}
+
+/**
+ * Web search options for Chat Completions API
+ */
+export interface OpenAIWebSearchOptions {
+  /**
+   * Context size for search results
+   * Controls how much context from web results to include
+   */
+  search_context_size?: 'low' | 'medium' | 'high';
+  /** User location for localizing search results */
+  user_location?: OpenAIWebSearchUserLocation | null;
+}
+
 /**
  * OpenAI Chat Completions API parameters
  * These are passed through to the /v1/chat/completions endpoint
@@ -33,10 +91,10 @@ export interface OpenAICompletionsParams {
   /** Number of top logprobs to return (0-20) */
   top_logprobs?: number;
 
-  /** Seed for deterministic sampling (beta) */
+  /** Seed for deterministic sampling (beta, deprecated) */
   seed?: number;
 
-  /** User identifier for abuse detection */
+  /** User identifier (deprecated, use safety_identifier or prompt_cache_key) */
   user?: string;
 
   /** Logit bias map */
@@ -52,12 +110,12 @@ export interface OpenAICompletionsParams {
   reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
 
   /** Service tier */
-  service_tier?: 'auto' | 'default' | 'flex' | 'priority';
+  service_tier?: 'auto' | 'default' | 'flex' | 'scale' | 'priority';
 
   /** Store completion for distillation */
   store?: boolean;
 
-  /** Metadata key-value pairs */
+  /** Metadata key-value pairs (max 16, keys max 64 chars, values max 512 chars) */
   metadata?: Record<string, string>;
 
   /** Response format for structured output */
@@ -74,7 +132,7 @@ export interface OpenAICompletionsParams {
 
   /**
    * Stable identifier for caching similar requests
-   * Used to optimize cache hit rates
+   * Used to optimize cache hit rates (replaces user field)
    */
   prompt_cache_key?: string;
 
@@ -82,13 +140,50 @@ export interface OpenAICompletionsParams {
    * Retention policy for prompt cache
    * Set to "24h" to enable extended prompt caching up to 24 hours
    */
-  prompt_cache_retention?: '24h';
+  prompt_cache_retention?: 'in-memory' | '24h';
 
   /**
    * Stable identifier for abuse detection
    * Recommend hashing username or email address
    */
   safety_identifier?: string;
+
+  /**
+   * Output modalities to generate
+   * Default: ["text"]. Use ["text", "audio"] for audio-capable models
+   */
+  modalities?: Array<'text' | 'audio'>;
+
+  /**
+   * Audio output configuration
+   * Required when modalities includes "audio"
+   */
+  audio?: OpenAIAudioConfig | null;
+
+  /**
+   * Web search configuration
+   * Enables the model to search the web for up-to-date information
+   */
+  web_search_options?: OpenAIWebSearchOptions;
+}
+
+/**
+ * Prompt template reference for Responses API
+ */
+export interface OpenAIPromptTemplate {
+  /** Prompt template ID */
+  id: string;
+  /** Variables to fill into the template */
+  variables?: Record<string, string>;
+}
+
+/**
+ * Conversation reference for Responses API
+ * Items from this conversation are prepended to input_items
+ */
+export interface OpenAIConversation {
+  /** Conversation ID */
+  id: string;
 }
 
 /**
@@ -105,35 +200,108 @@ export interface OpenAIResponsesParams {
   /** Top-p (nucleus) sampling (0.0 - 1.0) */
   top_p?: number;
 
+  /** Number of top logprobs to return (0-20) */
+  top_logprobs?: number;
+
   /** Whether to enable parallel tool calls */
   parallel_tool_calls?: boolean;
 
-  /** Reasoning configuration */
+  /** Reasoning configuration (for gpt-5 and o-series models) */
   reasoning?: {
     effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
-    summary?: string;
+    /** Include summary of reasoning */
+    summary?: 'auto' | 'concise' | 'detailed';
   };
 
   /** Service tier */
-  service_tier?: 'auto' | 'default' | 'flex' | 'priority';
+  service_tier?: 'auto' | 'default' | 'flex' | 'scale' | 'priority';
 
   /** Truncation strategy */
   truncation?: 'auto' | 'disabled';
 
-  /** Fields to include in output */
+  /**
+   * Fields to include in output
+   * Supported values:
+   * - 'web_search_call.action.sources': Include web search sources
+   * - 'code_interpreter_call.outputs': Include code execution outputs
+   * - 'computer_call_output.output.image_url': Include computer call images
+   * - 'file_search_call.results': Include file search results
+   * - 'message.input_image.image_url': Include input image URLs
+   * - 'message.output_text.logprobs': Include logprobs with messages
+   * - 'reasoning.encrypted_content': Include encrypted reasoning tokens
+   */
   include?: string[];
 
-  /** Background processing */
+  /** Background processing - run response asynchronously */
   background?: boolean;
 
-  /** Continue from a previous response */
+  /** Continue from a previous response (cannot use with conversation) */
   previous_response_id?: string;
 
+  /**
+   * Conversation context - items prepended to input_items
+   * Cannot be used with previous_response_id
+   */
+  conversation?: string | OpenAIConversation;
+
   /** Store response for continuation */
   store?: boolean;
 
-  /** Metadata key-value pairs */
+  /** Metadata key-value pairs (max 16, keys max 64 chars, values max 512 chars) */
   metadata?: Record<string, string>;
+
+  /**
+   * Maximum total calls to built-in tools in a response
+   * Applies across all built-in tool calls, not per tool
+   */
+  max_tool_calls?: number;
+
+  /**
+   * Reference to a prompt template and its variables
+   */
+  prompt?: OpenAIPromptTemplate;
+
+  /**
+   * Stable identifier for caching similar requests
+   * Used to optimize cache hit rates (replaces user field)
+   */
+  prompt_cache_key?: string;
+
+  /**
+   * Retention policy for prompt cache
+   * Set to "24h" to enable extended prompt caching up to 24 hours
+   */
+  prompt_cache_retention?: 'in-memory' | '24h';
+
+  /**
+   * Stable identifier for abuse detection
+   * Recommend hashing username or email address
+   */
+  safety_identifier?: string;
+
+  /** User identifier (deprecated, use safety_identifier or prompt_cache_key) */
+  user?: string;
+
+  /**
+   * Built-in tools for the Responses API
+   * Use the tool helper constructors: tools.webSearch(), tools.imageGeneration(), etc.
+   *
+   * @example
+   * ```ts
+   * import { tools } from 'provider-protocol/openai';
+   *
+   * const model = llm({
+   *   model: openai('gpt-4o'),
+   *   params: {
+   *     tools: [
+   *       tools.webSearch(),
+   *       tools.imageGeneration({ quality: 'high' }),
+   *     ],
+   *   },
+   * });
+   * ```
+   */
+  tools?: OpenAIBuiltInTool[];
 }
 
 /**
@@ -210,6 +378,12 @@ export interface OpenAICompletionsRequest {
   prompt_cache_retention?: string;
   /** Stable identifier for abuse detection */
   safety_identifier?: string;
+  /** Output modalities (text, audio) */
+  modalities?: Array<'text' | 'audio'>;
+  /** Audio output configuration */
+  audio?: OpenAIAudioConfig | null;
+  /** Web search configuration */
+  web_search_options?: OpenAIWebSearchOptions;
 }
 
 /**
@@ -422,8 +596,9 @@ export interface OpenAIResponsesRequest {
   max_output_tokens?: number;
   temperature?: number;
   top_p?: number;
+  top_logprobs?: number;
   stream?: boolean;
-  tools?: OpenAIResponsesTool[];
+  tools?: OpenAIResponsesToolUnion[];
   tool_choice?: OpenAIResponsesToolChoice;
   parallel_tool_calls?: boolean;
   text?: OpenAIResponsesTextConfig;
@@ -432,12 +607,26 @@ export interface OpenAIResponsesRequest {
   metadata?: Record<string, string>;
   reasoning?: {
     effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
-    summary?: string;
+    summary?: 'auto' | 'concise' | 'detailed';
   };
   service_tier?: string;
   include?: string[];
   background?: boolean;
   previous_response_id?: string;
+  /** Conversation context (cannot use with previous_response_id) */
+  conversation?: string | OpenAIConversation;
+  /** Maximum total calls to built-in tools */
+  max_tool_calls?: number;
+  /** Prompt template reference */
+  prompt?: OpenAIPromptTemplate;
+  /** Stable identifier for caching (replaces user) */
+  prompt_cache_key?: string;
+  /** Retention policy for prompt cache */
+  prompt_cache_retention?: 'in-memory' | '24h';
+  /** Stable identifier for abuse detection */
+  safety_identifier?: string;
+  /** User identifier (deprecated) */
+  user?: string;
 }
 
 /**
@@ -573,7 +762,9 @@ export interface OpenAIResponsesResponse {
 
 export type OpenAIResponsesOutputItem =
   | OpenAIResponsesMessageOutput
-  | OpenAIResponsesFunctionCallOutput;
+  | OpenAIResponsesFunctionCallOutput
+  | OpenAIResponsesImageGenerationOutput
+  | OpenAIResponsesWebSearchOutput;
 
 export interface OpenAIResponsesMessageOutput {
   type: 'message';
@@ -592,6 +783,19 @@ export interface OpenAIResponsesFunctionCallOutput {
   status: 'completed' | 'in_progress';
 }
 
+export interface OpenAIResponsesImageGenerationOutput {
+  type: 'image_generation_call';
+  id: string;
+  result?: string;
+  status: 'completed' | 'in_progress';
+}
+
+export interface OpenAIResponsesWebSearchOutput {
+  type: 'web_search_call';
+  id: string;
+  status: 'completed' | 'in_progress';
+}
+
 export type OpenAIResponsesOutputContent =
   | { type: 'output_text'; text: string; annotations?: unknown[] }
   | { type: 'refusal'; refusal: string };
@@ -732,3 +936,293 @@ export interface OpenAIResponseErrorEvent {
     message: string;
   };
 }
+
+// ============================================
+// Built-in Tools for Responses API
+// ============================================
+
+/**
+ * Web search tool for Responses API
+ * Enables the model to search the web for up-to-date information
+ */
+export interface OpenAIWebSearchTool {
+  type: 'web_search';
+  /**
+   * Context size for search results
+   * Controls how much context from web results to include
+   */
+  search_context_size?: 'low' | 'medium' | 'high';
+  /** User location for localizing search results */
+  user_location?: OpenAIWebSearchUserLocation | null;
+}
+
+/**
+ * File search tool for Responses API
+ * Enables the model to search through uploaded files
+ */
+export interface OpenAIFileSearchTool {
+  type: 'file_search';
+  /** File search configuration */
+  file_search?: {
+    /** Vector store IDs to search */
+    vector_store_ids: string[];
+    /** Maximum number of results to return */
+    max_num_results?: number;
+    /** Ranking options for search results */
+    ranking_options?: {
+      /** Ranker to use */
+      ranker?: 'auto' | 'default_2024_08_21';
+      /** Score threshold (0-1) */
+      score_threshold?: number;
+    };
+    /** Filters to apply */
+    filters?: Record<string, unknown>;
+  };
+}
+
+/**
+ * Code interpreter container configuration
+ */
+export interface OpenAICodeInterpreterContainer {
+  /** Container type - 'auto' creates a new container */
+  type: 'auto';
+  /** Memory limit for the container (e.g., '1g', '4g') */
+  memory_limit?: string;
+  /** File IDs to make available in the container */
+  file_ids?: string[];
+}
+
+/**
+ * Code interpreter tool for Responses API
+ * Allows the model to write and run Python code
+ */
+export interface OpenAICodeInterpreterTool {
+  type: 'code_interpreter';
+  /** Code interpreter configuration */
+  code_interpreter?: {
+    /** Container configuration */
+    container: string | OpenAICodeInterpreterContainer;
+  };
+}
+
+/**
+ * Computer tool environment configuration
+ */
+export interface OpenAIComputerEnvironment {
+  /** Environment type */
+  type: 'browser' | 'mac' | 'windows' | 'linux' | 'ubuntu';
+}
+
+/**
+ * Computer tool for Responses API
+ * Enables the model to interact with computer interfaces
+ */
+export interface OpenAIComputerTool {
+  type: 'computer';
+  /** Computer tool configuration */
+  computer?: {
+    /** Display width in pixels */
+    display_width: number;
+    /** Display height in pixels */
+    display_height: number;
+    /** Environment configuration */
+    environment?: OpenAIComputerEnvironment;
+  };
+}
+
+/**
+ * Image generation tool for Responses API
+ */
+export interface OpenAIImageGenerationTool {
+  type: 'image_generation';
+  /** Background transparency */
+  background?: 'transparent' | 'opaque' | 'auto';
+  /** Input image formats supported */
+  input_image_mask?: boolean;
+  /** Model to use for generation */
+  model?: string;
+  /** Moderation level */
+  moderation?: 'auto' | 'low';
+  /** Output compression */
+  output_compression?: number;
+  /** Output format */
+  output_format?: 'png' | 'jpeg' | 'webp';
+  /** Partial images during streaming */
+  partial_images?: number;
+  /** Image quality */
+  quality?: 'auto' | 'high' | 'medium' | 'low';
+  /** Image size */
+  size?: 'auto' | '1024x1024' | '1024x1536' | '1536x1024';
+}
+
+/**
+ * MCP (Model Context Protocol) server configuration
+ */
+export interface OpenAIMcpServerConfig {
+  /** Server URL */
+  url: string;
+  /** Server name for identification */
+  name?: string;
+  /** Tool configuration for the server */
+  tool_configuration?: {
+    /** Allowed tools from this server */
+    allowed_tools?: string[] | { type: 'all' };
+  };
+  /** Headers to send with requests */
+  headers?: Record<string, string>;
+  /** Allowed resources */
+  allowed_resources?: string[];
+  /** Require approval for tool calls */
+  require_approval?: 'always' | 'never' | { type: 'except'; tools: string[] };
+}
+
+/**
+ * MCP tool for Responses API
+ * Enables connections to MCP servers
+ */
+export interface OpenAIMcpTool {
+  type: 'mcp';
+  /** MCP server configurations */
+  mcp?: {
+    /** Server configuration */
+    server: OpenAIMcpServerConfig;
+  };
+}
+
+/**
+ * Union type for all Responses API built-in tools
+ */
+export type OpenAIBuiltInTool =
+  | OpenAIWebSearchTool
+  | OpenAIFileSearchTool
+  | OpenAICodeInterpreterTool
+  | OpenAIComputerTool
+  | OpenAIImageGenerationTool
+  | OpenAIMcpTool;
+
+/**
+ * Combined tool type for Responses API (built-in or function)
+ */
+export type OpenAIResponsesToolUnion = OpenAIResponsesTool | OpenAIBuiltInTool;
+
+// ============================================
+// Tool Helper Constructors
+// ============================================
+
+/**
+ * Helper to create a web search tool
+ * Note: Configuration options are passed at the top level, not nested
+ */
+export function webSearchTool(options?: {
+  search_context_size?: 'low' | 'medium' | 'high';
+  user_location?: OpenAIWebSearchUserLocation | null;
+}): OpenAIWebSearchTool {
+  if (options) {
+    return {
+      type: 'web_search',
+      ...options,
+    } as OpenAIWebSearchTool;
+  }
+  return { type: 'web_search' };
+}
+
+/**
+ * Helper to create a file search tool
+ */
+export function fileSearchTool(options: {
+  vector_store_ids: string[];
+  max_num_results?: number;
+  ranking_options?: {
+    ranker?: 'auto' | 'default_2024_08_21';
+    score_threshold?: number;
+  };
+  filters?: Record<string, unknown>;
+}): OpenAIFileSearchTool {
+  return {
+    type: 'file_search',
+    file_search: options,
+  };
+}
+
+/**
+ * Helper to create a code interpreter tool
+ */
+export function codeInterpreterTool(options?: {
+  container?: string | OpenAICodeInterpreterContainer;
+}): OpenAICodeInterpreterTool {
+  return {
+    type: 'code_interpreter',
+    ...(options?.container && { code_interpreter: { container: options.container } }),
+  };
+}
+
+/**
+ * Helper to create a computer tool
+ */
+export function computerTool(options: {
+  display_width: number;
+  display_height: number;
+  environment?: OpenAIComputerEnvironment;
+}): OpenAIComputerTool {
+  return {
+    type: 'computer',
+    computer: options,
+  };
+}
+
+/**
+ * Helper to create an image generation tool
+ * Note: Configuration options are passed at the top level, not nested
+ */
+export function imageGenerationTool(options?: {
+  background?: 'transparent' | 'opaque' | 'auto';
+  model?: string;
+  quality?: 'auto' | 'high' | 'medium' | 'low';
+  size?: 'auto' | '1024x1024' | '1024x1536' | '1536x1024';
+  output_format?: 'png' | 'jpeg' | 'webp';
+}): OpenAIImageGenerationTool {
+  if (options) {
+    return {
+      type: 'image_generation',
+      ...options,
+    };
+  }
+  return { type: 'image_generation' };
+}
+
+/**
+ * Helper to create an MCP tool
+ */
+export function mcpTool(options: {
+  url: string;
+  name?: string;
+  allowed_tools?: string[] | { type: 'all' };
+  headers?: Record<string, string>;
+  require_approval?: 'always' | 'never' | { type: 'except'; tools: string[] };
+}): OpenAIMcpTool {
+  const { url, name, allowed_tools, headers, require_approval } = options;
+  return {
+    type: 'mcp',
+    mcp: {
+      server: {
+        url,
+        name,
+        ...(allowed_tools && { tool_configuration: { allowed_tools } }),
+        headers,
+        require_approval,
+      },
+    },
+  };
+}
+
+/**
+ * Namespace for tool helper constructors
+ */
+export const tools = {
+  webSearch: webSearchTool,
+  fileSearch: fileSearchTool,
+  codeInterpreter: codeInterpreterTool,
+  computer: computerTool,
+  imageGeneration: imageGenerationTool,
+  mcp: mcpTool,
+};

package/src/types/messages.ts

@@ -2,9 +2,11 @@ import { generateId } from '../utils/id.ts';
 import type {
   ContentBlock,
   TextBlock,
+  ImageBlock,
+  AudioBlock,
+  VideoBlock,
   UserContent,
   AssistantContent,
-  isTextBlock,
 } from './content.ts';
 import type { ToolCall, ToolResult } from './tool.ts';
 
@@ -65,6 +67,27 @@ export abstract class Message {
       .map((block) => block.text)
       .join('\n\n');
   }
+
+  /**
+   * Convenience accessor for image content blocks
+   */
+  get images(): ImageBlock[] {
+    return this.getContent().filter((block): block is ImageBlock => block.type === 'image');
+  }
+
+  /**
+   * Convenience accessor for audio content blocks
+   */
+  get audio(): AudioBlock[] {
+    return this.getContent().filter((block): block is AudioBlock => block.type === 'audio');
+  }
+
+  /**
+   * Convenience accessor for video content blocks
+   */
+  get video(): VideoBlock[] {
+    return this.getContent().filter((block): block is VideoBlock => block.type === 'video');
+  }
 }
 
 /**

package/dist/chunk-QUUX4G7U.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/id.ts","../src/types/messages.ts"],"sourcesContent":["/**\n * Generate a unique ID\n * Uses crypto.randomUUID if available, falls back to a simple implementation\n */\nexport function generateId(): string {\n  if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n    return crypto.randomUUID();\n  }\n\n  // Fallback for environments without crypto.randomUUID\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Generate a short ID (for tool call IDs, etc.)\n */\nexport function generateShortId(prefix = ''): string {\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n  let result = prefix;\n  for (let i = 0; i < 12; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n","import { generateId } from '../utils/id.ts';\nimport type {\n  ContentBlock,\n  TextBlock,\n  UserContent,\n  AssistantContent,\n  isTextBlock,\n} from './content.ts';\nimport type { ToolCall, ToolResult } from './tool.ts';\n\n/**\n * Message type discriminator\n */\nexport type MessageType = 'user' | 'assistant' | 'tool_result';\n\n/**\n * Provider-namespaced metadata\n * Each provider uses its own namespace\n */\nexport interface MessageMetadata {\n  [provider: string]: Record<string, unknown> | undefined;\n}\n\n/**\n * Options for message construction\n */\nexport interface MessageOptions {\n  id?: string;\n  metadata?: MessageMetadata;\n}\n\n/**\n * Base message class\n * All messages inherit from this\n */\nexport abstract class Message {\n  /** Unique message identifier */\n  readonly id: string;\n\n  /** Timestamp */\n  readonly timestamp: Date;\n\n  /** Provider-specific metadata, namespaced by provider */\n  readonly metadata?: MessageMetadata;\n\n  /** Message type discriminator */\n  abstract readonly type: MessageType;\n\n  /** Raw content - implemented by subclasses */\n  protected abstract getContent(): ContentBlock[];\n\n  constructor(options?: MessageOptions) {\n    this.id = options?.id ?? generateId();\n    this.timestamp = new Date();\n    this.metadata = options?.metadata;\n  }\n\n  /**\n   * Convenience accessor for text content\n   * Concatenates all text blocks with '\\n\\n'\n   */\n  get text(): string {\n    return this.getContent()\n      .filter((block): block is TextBlock => block.type === 'text')\n      .map((block) => block.text)\n      .join('\\n\\n');\n  }\n}\n\n/**\n * User input message\n */\nexport class UserMessage extends Message {\n  readonly type = 'user' as const;\n  readonly content: UserContent[];\n\n  /**\n   * @param content - String (converted to TextBlock) or array of content blocks\n   */\n  constructor(content: string | UserContent[], options?: MessageOptions) {\n    super(options);\n    if (typeof content === 'string') {\n      this.content = [{ type: 'text', text: content }];\n    } else {\n      this.content = content;\n    }\n  }\n\n  protected getContent(): ContentBlock[] {\n    return this.content;\n  }\n}\n\n/**\n * Assistant response message\n * May contain text, media, and/or tool calls\n */\nexport class AssistantMessage extends Message {\n  readonly type = 'assistant' as const;\n  readonly content: AssistantContent[];\n\n  /** Tool calls requested by the model (if any) */\n  readonly toolCalls?: ToolCall[];\n\n  /**\n   * @param content - String (converted to TextBlock) or array of content blocks\n   * @param toolCalls - Tool calls requested by the model\n   * @param options - Message ID and metadata\n   */\n  constructor(\n    content: string | AssistantContent[],\n    toolCalls?: ToolCall[],\n    options?: MessageOptions\n  ) {\n    super(options);\n    if (typeof content === 'string') {\n      this.content = [{ type: 'text', text: content }];\n    } else {\n      this.content = content;\n    }\n    this.toolCalls = toolCalls;\n  }\n\n  protected getContent(): ContentBlock[] {\n    return this.content;\n  }\n\n  /** Check if this message requests tool execution */\n  get hasToolCalls(): boolean {\n    return this.toolCalls !== undefined && this.toolCalls.length > 0;\n  }\n}\n\n/**\n * Result of tool execution (sent back to model)\n */\nexport class ToolResultMessage extends Message {\n  readonly type = 'tool_result' as const;\n  readonly results: ToolResult[];\n\n  /**\n   * @param results - Array of tool execution results\n   * @param options - Message ID and metadata\n   */\n  constructor(results: ToolResult[], options?: MessageOptions) {\n    super(options);\n    this.results = results;\n  }\n\n  protected getContent(): ContentBlock[] {\n    // Tool results don't have traditional content blocks\n    // Return text representations of results\n    return this.results.map((result) => ({\n      type: 'text' as const,\n      text:\n        typeof result.result === 'string'\n          ? result.result\n          : JSON.stringify(result.result),\n    }));\n  }\n}\n\n/**\n * Type guard for UserMessage\n */\nexport function isUserMessage(msg: Message): msg is UserMessage {\n  return msg.type === 'user';\n}\n\n/**\n * Type guard for AssistantMessage\n */\nexport function isAssistantMessage(msg: Message): msg is AssistantMessage {\n  return msg.type === 'assistant';\n}\n\n/**\n * Type guard for ToolResultMessage\n */\nexport function isToolResultMessage(msg: Message): msg is ToolResultMessage {\n  return msg.type === 'tool_result';\n}\n"],"mappings":";AAIO,SAAS,aAAqB;AACnC,MAAI,OAAO,WAAW,eAAe,OAAO,YAAY;AACtD,WAAO,OAAO,WAAW;AAAA,EAC3B;AAGA,SAAO,uCAAuC,QAAQ,SAAS,CAAC,MAAM;AACpE,UAAM,IAAK,KAAK,OAAO,IAAI,KAAM;AACjC,UAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,WAAO,EAAE,SAAS,EAAE;AAAA,EACtB,CAAC;AACH;;;ACoBO,IAAe,UAAf,MAAuB;AAAA;AAAA,EAEnB;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA,EAQT,YAAY,SAA0B;AACpC,SAAK,KAAK,SAAS,MAAM,WAAW;AACpC,SAAK,YAAY,oBAAI,KAAK;AAC1B,SAAK,WAAW,SAAS;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,OAAe;AACjB,WAAO,KAAK,WAAW,EACpB,OAAO,CAAC,UAA8B,MAAM,SAAS,MAAM,EAC3D,IAAI,CAAC,UAAU,MAAM,IAAI,EACzB,KAAK,MAAM;AAAA,EAChB;AACF;AAKO,IAAM,cAAN,cAA0B,QAAQ;AAAA,EAC9B,OAAO;AAAA,EACP;AAAA;AAAA;AAAA;AAAA,EAKT,YAAY,SAAiC,SAA0B;AACrE,UAAM,OAAO;AACb,QAAI,OAAO,YAAY,UAAU;AAC/B,WAAK,UAAU,CAAC,EAAE,MAAM,QAAQ,MAAM,QAAQ,CAAC;AAAA,IACjD,OAAO;AACL,WAAK,UAAU;AAAA,IACjB;AAAA,EACF;AAAA,EAEU,aAA6B;AACrC,WAAO,KAAK;AAAA,EACd;AACF;AAMO,IAAM,mBAAN,cAA+B,QAAQ;AAAA,EACnC,OAAO;AAAA,EACP;AAAA;AAAA,EAGA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,YACE,SACA,WACA,SACA;AACA,UAAM,OAAO;AACb,QAAI,OAAO,YAAY,UAAU;AAC/B,WAAK,UAAU,CAAC,EAAE,MAAM,QAAQ,MAAM,QAAQ,CAAC;AAAA,IACjD,OAAO;AACL,WAAK,UAAU;AAAA,IACjB;AACA,SAAK,YAAY;AAAA,EACnB;AAAA,EAEU,aAA6B;AACrC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,eAAwB;AAC1B,WAAO,KAAK,cAAc,UAAa,KAAK,UAAU,SAAS;AAAA,EACjE;AACF;AAKO,IAAM,oBAAN,cAAgC,QAAQ;AAAA,EACpC,OAAO;AAAA,EACP;AAAA;AAAA;AAAA;AAAA;AAAA,EAMT,YAAY,SAAuB,SAA0B;AAC3D,UAAM,OAAO;AACb,SAAK,UAAU;AAAA,EACjB;AAAA,EAEU,aAA6B;AAGrC,WAAO,KAAK,QAAQ,IAAI,CAAC,YAAY;AAAA,MACnC,MAAM;AAAA,MACN,MACE,OAAO,OAAO,WAAW,WACrB,OAAO,SACP,KAAK,UAAU,OAAO,MAAM;AAAA,IACpC,EAAE;AAAA,EACJ;AACF;AAKO,SAAS,cAAc,KAAkC;AAC9D,SAAO,IAAI,SAAS;AACtB;AAKO,SAAS,mBAAmB,KAAuC;AACxE,SAAO,IAAI,SAAS;AACtB;AAKO,SAAS,oBAAoB,KAAwC;AAC1E,SAAO,IAAI,SAAS;AACtB;","names":[]}