@quilltap/plugin-utils 1.0.0

package/dist/tools/index.d.ts

@@ -0,0 +1,236 @@
+import { ToolCallRequest, UniversalTool, AnthropicToolDefinition, GoogleToolDefinition } from '@quilltap/plugin-types';
+export { AnthropicToolDefinition, GoogleToolDefinition, OpenAIToolDefinition, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool } from '@quilltap/plugin-types';
+
+/**
+ * Tool Call Parsers
+ *
+ * Provider-specific parsers for extracting tool calls from LLM responses.
+ * Each parser converts from a provider's native format to the standardized
+ * ToolCallRequest format.
+ *
+ * @module @quilltap/plugin-utils/tools/parsers
+ */
+
+/**
+ * Supported tool call response formats
+ */
+type ToolCallFormat = 'openai' | 'anthropic' | 'google' | 'auto';
+/**
+ * Parse OpenAI format tool calls from LLM response
+ *
+ * Extracts tool calls from OpenAI/Grok API responses which return
+ * tool_calls in the message object.
+ *
+ * Expected response structures:
+ * - `response.tool_calls` (direct)
+ * - `response.choices[0].message.tool_calls` (nested)
+ *
+ * @param response - The raw response from provider API
+ * @returns Array of parsed tool call requests
+ *
+ * @example
+ * ```typescript
+ * const response = await openai.chat.completions.create({...});
+ * const toolCalls = parseOpenAIToolCalls(response);
+ * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]
+ * ```
+ */
+declare function parseOpenAIToolCalls(response: unknown): ToolCallRequest[];
+/**
+ * Parse Anthropic format tool calls from LLM response
+ *
+ * Extracts tool calls from Anthropic API responses which return
+ * tool_use blocks in the content array.
+ *
+ * Expected response structure:
+ * - `response.content` array with `{ type: 'tool_use', name, input }`
+ *
+ * @param response - The raw response from provider API
+ * @returns Array of parsed tool call requests
+ *
+ * @example
+ * ```typescript
+ * const response = await anthropic.messages.create({...});
+ * const toolCalls = parseAnthropicToolCalls(response);
+ * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]
+ * ```
+ */
+declare function parseAnthropicToolCalls(response: unknown): ToolCallRequest[];
+/**
+ * Parse Google Gemini format tool calls from LLM response
+ *
+ * Extracts tool calls from Google Gemini API responses which return
+ * functionCall objects in the parts array.
+ *
+ * Expected response structure:
+ * - `response.candidates[0].content.parts` array with `{ functionCall: { name, args } }`
+ *
+ * @param response - The raw response from provider API
+ * @returns Array of parsed tool call requests
+ *
+ * @example
+ * ```typescript
+ * const response = await gemini.generateContent({...});
+ * const toolCalls = parseGoogleToolCalls(response);
+ * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]
+ * ```
+ */
+declare function parseGoogleToolCalls(response: unknown): ToolCallRequest[];
+/**
+ * Detect the format of a tool call response
+ *
+ * Analyzes the response structure to determine which provider format it uses.
+ *
+ * @param response - The raw response from a provider API
+ * @returns The detected format, or null if unrecognized
+ */
+declare function detectToolCallFormat(response: unknown): ToolCallFormat | null;
+/**
+ * Parse tool calls with auto-detection or explicit format
+ *
+ * A unified parser that can either auto-detect the response format
+ * or use a specified format. This is useful when you're not sure
+ * which provider's response you're handling.
+ *
+ * @param response - The raw response from a provider API
+ * @param format - The format to use: 'openai', 'anthropic', 'google', or 'auto'
+ * @returns Array of parsed tool call requests
+ *
+ * @example
+ * ```typescript
+ * // Auto-detect format
+ * const toolCalls = parseToolCalls(response, 'auto');
+ *
+ * // Or specify format explicitly
+ * const toolCalls = parseToolCalls(response, 'openai');
+ * ```
+ */
+declare function parseToolCalls(response: unknown, format?: ToolCallFormat): ToolCallRequest[];
+/**
+ * Check if a response contains tool calls
+ *
+ * Quick check to determine if a response has any tool calls
+ * without fully parsing them.
+ *
+ * @param response - The raw response from a provider API
+ * @returns True if the response contains tool calls
+ */
+declare function hasToolCalls(response: unknown): boolean;
+
+/**
+ * Tool Format Converters
+ *
+ * Utilities for converting between different provider tool formats.
+ * The universal format (OpenAI-style) serves as the baseline for all conversions.
+ *
+ * @module @quilltap/plugin-utils/tools/converters
+ */
+
+/**
+ * Convert OpenAI/Universal format tool to Anthropic format
+ *
+ * Anthropic uses a tool_use format with:
+ * - name: string
+ * - description: string
+ * - input_schema: JSON schema object
+ *
+ * @param tool - Universal tool in OpenAI format
+ * @returns Tool formatted for Anthropic's tool_use
+ *
+ * @example
+ * ```typescript
+ * const anthropicTool = convertToAnthropicFormat(universalTool);
+ * // Returns: {
+ * //   name: 'search_web',
+ * //   description: 'Search the web',
+ * //   input_schema: {
+ * //     type: 'object',
+ * //     properties: { query: { type: 'string' } },
+ * //     required: ['query']
+ * //   }
+ * // }
+ * ```
+ */
+declare function convertToAnthropicFormat(tool: UniversalTool): AnthropicToolDefinition;
+/**
+ * Convert OpenAI/Universal format tool to Google Gemini format
+ *
+ * Google uses a function calling format with:
+ * - name: string
+ * - description: string
+ * - parameters: JSON schema object
+ *
+ * @param tool - Universal tool in OpenAI format
+ * @returns Tool formatted for Google's functionCall
+ *
+ * @example
+ * ```typescript
+ * const googleTool = convertToGoogleFormat(universalTool);
+ * // Returns: {
+ * //   name: 'search_web',
+ * //   description: 'Search the web',
+ * //   parameters: {
+ * //     type: 'object',
+ * //     properties: { query: { type: 'string' } },
+ * //     required: ['query']
+ * //   }
+ * // }
+ * ```
+ */
+declare function convertToGoogleFormat(tool: UniversalTool): GoogleToolDefinition;
+/**
+ * Convert Anthropic format tool to Universal/OpenAI format
+ *
+ * @param tool - Anthropic format tool
+ * @returns Tool in universal OpenAI format
+ */
+declare function convertFromAnthropicFormat(tool: AnthropicToolDefinition): UniversalTool;
+/**
+ * Convert Google format tool to Universal/OpenAI format
+ *
+ * @param tool - Google format tool
+ * @returns Tool in universal OpenAI format
+ */
+declare function convertFromGoogleFormat(tool: GoogleToolDefinition): UniversalTool;
+/**
+ * Apply prompt/description length limit to a tool
+ *
+ * Modifies a tool's description if it exceeds maxBytes, appending a warning
+ * that the description was truncated. This is useful for providers with
+ * strict token limits.
+ *
+ * @param tool - Tool object (any format) with a description property
+ * @param maxBytes - Maximum bytes allowed for description (including warning)
+ * @returns Modified tool with truncated description if needed
+ *
+ * @example
+ * ```typescript
+ * const limitedTool = applyDescriptionLimit(tool, 500);
+ * // If description > 500 bytes, truncates and adds warning
+ * ```
+ */
+declare function applyDescriptionLimit<T extends {
+    description: string;
+}>(tool: T, maxBytes: number): T;
+/**
+ * Target format for tool conversion
+ */
+type ToolConvertTarget = 'openai' | 'anthropic' | 'google';
+/**
+ * Convert a universal tool to a specific provider format
+ *
+ * @param tool - Universal tool in OpenAI format
+ * @param target - Target provider format
+ * @returns Tool in the target format
+ */
+declare function convertToolTo(tool: UniversalTool, target: ToolConvertTarget): UniversalTool | AnthropicToolDefinition | GoogleToolDefinition;
+/**
+ * Convert multiple tools to a specific provider format
+ *
+ * @param tools - Array of universal tools
+ * @param target - Target provider format
+ * @returns Array of tools in the target format
+ */
+declare function convertToolsTo(tools: UniversalTool[], target: ToolConvertTarget): Array<UniversalTool | AnthropicToolDefinition | GoogleToolDefinition>;
+
+export { type ToolCallFormat, type ToolConvertTarget, applyDescriptionLimit, convertFromAnthropicFormat, convertFromGoogleFormat, convertToAnthropicFormat, convertToGoogleFormat, convertToolTo, convertToolsTo, detectToolCallFormat, hasToolCalls, parseAnthropicToolCalls, parseGoogleToolCalls, parseOpenAIToolCalls, parseToolCalls };

package/dist/tools/index.js

@@ -0,0 +1,266 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tools/index.ts
+var tools_exports = {};
+__export(tools_exports, {
+  applyDescriptionLimit: () => applyDescriptionLimit,
+  convertFromAnthropicFormat: () => convertFromAnthropicFormat,
+  convertFromGoogleFormat: () => convertFromGoogleFormat,
+  convertToAnthropicFormat: () => convertToAnthropicFormat,
+  convertToGoogleFormat: () => convertToGoogleFormat,
+  convertToolTo: () => convertToolTo,
+  convertToolsTo: () => convertToolsTo,
+  detectToolCallFormat: () => detectToolCallFormat,
+  hasToolCalls: () => hasToolCalls,
+  parseAnthropicToolCalls: () => parseAnthropicToolCalls,
+  parseGoogleToolCalls: () => parseGoogleToolCalls,
+  parseOpenAIToolCalls: () => parseOpenAIToolCalls,
+  parseToolCalls: () => parseToolCalls
+});
+module.exports = __toCommonJS(tools_exports);
+
+// src/tools/parsers.ts
+function parseOpenAIToolCalls(response) {
+  const toolCalls = [];
+  try {
+    const resp = response;
+    let toolCallsArray = resp?.tool_calls;
+    if (!toolCallsArray) {
+      const choices = resp?.choices;
+      toolCallsArray = choices?.[0]?.message?.tool_calls;
+    }
+    if (toolCallsArray && Array.isArray(toolCallsArray) && toolCallsArray.length > 0) {
+      for (const toolCall of toolCallsArray) {
+        const tc = toolCall;
+        if (tc.type === "function" && tc.function) {
+          toolCalls.push({
+            name: tc.function.name,
+            arguments: JSON.parse(tc.function.arguments || "{}")
+          });
+        }
+      }
+    }
+  } catch (error) {
+    console.error("[plugin-utils] Error parsing OpenAI tool calls:", error);
+  }
+  return toolCalls;
+}
+function parseAnthropicToolCalls(response) {
+  const toolCalls = [];
+  try {
+    const resp = response;
+    if (!resp?.content || !Array.isArray(resp.content)) {
+      return toolCalls;
+    }
+    for (const block of resp.content) {
+      const b = block;
+      if (b.type === "tool_use" && b.name) {
+        toolCalls.push({
+          name: b.name,
+          arguments: b.input || {}
+        });
+      }
+    }
+  } catch (error) {
+    console.error("[plugin-utils] Error parsing Anthropic tool calls:", error);
+  }
+  return toolCalls;
+}
+function parseGoogleToolCalls(response) {
+  const toolCalls = [];
+  try {
+    const resp = response;
+    const candidates = resp?.candidates;
+    const parts = candidates?.[0]?.content?.parts;
+    if (!parts || !Array.isArray(parts)) {
+      return toolCalls;
+    }
+    for (const part of parts) {
+      const p = part;
+      if (p.functionCall) {
+        toolCalls.push({
+          name: p.functionCall.name,
+          arguments: p.functionCall.args || {}
+        });
+      }
+    }
+  } catch (error) {
+    console.error("[plugin-utils] Error parsing Google tool calls:", error);
+  }
+  return toolCalls;
+}
+function detectToolCallFormat(response) {
+  if (!response || typeof response !== "object") {
+    return null;
+  }
+  const resp = response;
+  if (resp.tool_calls && Array.isArray(resp.tool_calls)) {
+    return "openai";
+  }
+  const choices = resp.choices;
+  if (choices?.[0]?.message?.tool_calls) {
+    return "openai";
+  }
+  if (resp.content && Array.isArray(resp.content)) {
+    const hasToolUse = resp.content.some(
+      (block) => block.type === "tool_use"
+    );
+    if (hasToolUse) {
+      return "anthropic";
+    }
+  }
+  const candidates = resp.candidates;
+  if (candidates?.[0]?.content?.parts) {
+    const hasFunctionCall = candidates[0].content.parts.some((part) => part.functionCall);
+    if (hasFunctionCall) {
+      return "google";
+    }
+  }
+  return null;
+}
+function parseToolCalls(response, format = "auto") {
+  let actualFormat = format;
+  if (format === "auto") {
+    actualFormat = detectToolCallFormat(response);
+    if (!actualFormat) {
+      return [];
+    }
+  }
+  switch (actualFormat) {
+    case "openai":
+      return parseOpenAIToolCalls(response);
+    case "anthropic":
+      return parseAnthropicToolCalls(response);
+    case "google":
+      return parseGoogleToolCalls(response);
+    default:
+      return [];
+  }
+}
+function hasToolCalls(response) {
+  const format = detectToolCallFormat(response);
+  return format !== null;
+}
+
+// src/tools/converters.ts
+function convertToAnthropicFormat(tool) {
+  return {
+    name: tool.function.name,
+    description: tool.function.description,
+    input_schema: {
+      type: "object",
+      properties: tool.function.parameters.properties,
+      required: tool.function.parameters.required
+    }
+  };
+}
+function convertToGoogleFormat(tool) {
+  return {
+    name: tool.function.name,
+    description: tool.function.description,
+    parameters: {
+      type: "object",
+      properties: tool.function.parameters.properties,
+      required: tool.function.parameters.required
+    }
+  };
+}
+function convertFromAnthropicFormat(tool) {
+  return {
+    type: "function",
+    function: {
+      name: tool.name,
+      description: tool.description ?? "",
+      parameters: {
+        type: "object",
+        properties: tool.input_schema.properties,
+        required: tool.input_schema.required ?? []
+      }
+    }
+  };
+}
+function convertFromGoogleFormat(tool) {
+  return {
+    type: "function",
+    function: {
+      name: tool.name,
+      description: tool.description,
+      parameters: {
+        type: "object",
+        properties: tool.parameters.properties,
+        required: tool.parameters.required
+      }
+    }
+  };
+}
+function applyDescriptionLimit(tool, maxBytes) {
+  if (!tool || !tool.description) {
+    return tool;
+  }
+  const warningText = " [Note: description truncated due to length limit]";
+  const maxDescBytes = maxBytes - Buffer.byteLength(warningText);
+  if (maxDescBytes <= 0) {
+    console.warn("[plugin-utils] Length limit too small for warning text:", maxBytes);
+    return tool;
+  }
+  const descBytes = Buffer.byteLength(tool.description);
+  if (descBytes > maxBytes) {
+    let truncated = tool.description;
+    while (Buffer.byteLength(truncated) > maxDescBytes && truncated.length > 0) {
+      truncated = truncated.slice(0, -1);
+    }
+    return {
+      ...tool,
+      description: truncated + warningText
+    };
+  }
+  return tool;
+}
+function convertToolTo(tool, target) {
+  switch (target) {
+    case "anthropic":
+      return convertToAnthropicFormat(tool);
+    case "google":
+      return convertToGoogleFormat(tool);
+    case "openai":
+    default:
+      return tool;
+  }
+}
+function convertToolsTo(tools, target) {
+  return tools.map((tool) => convertToolTo(tool, target));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyDescriptionLimit,
+  convertFromAnthropicFormat,
+  convertFromGoogleFormat,
+  convertToAnthropicFormat,
+  convertToGoogleFormat,
+  convertToolTo,
+  convertToolsTo,
+  detectToolCallFormat,
+  hasToolCalls,
+  parseAnthropicToolCalls,
+  parseGoogleToolCalls,
+  parseOpenAIToolCalls,
+  parseToolCalls
+});
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tools/index.ts","../../src/tools/parsers.ts","../../src/tools/converters.ts"],"sourcesContent":["/**\n * Tool Utilities\n *\n * Exports all tool-related utilities for parsing and converting\n * tool calls between different LLM provider formats.\n *\n * @module @quilltap/plugin-utils/tools\n */\n\n// Re-export types\nexport type {\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n} from './types';\n\n// Export parsers\nexport {\n  parseToolCalls,\n  parseOpenAIToolCalls,\n  parseAnthropicToolCalls,\n  parseGoogleToolCalls,\n  detectToolCallFormat,\n  hasToolCalls,\n} from './parsers';\n\nexport type { ToolCallFormat } from './parsers';\n\n// Export converters\nexport {\n  convertToAnthropicFormat,\n  convertToGoogleFormat,\n  convertFromAnthropicFormat,\n  convertFromGoogleFormat,\n  convertToolTo,\n  convertToolsTo,\n  applyDescriptionLimit,\n} from './converters';\n\nexport type { ToolConvertTarget } from './converters';\n","/**\n * Tool Call Parsers\n *\n * Provider-specific parsers for extracting tool calls from LLM responses.\n * Each parser converts from a provider's native format to the standardized\n * ToolCallRequest format.\n *\n * @module @quilltap/plugin-utils/tools/parsers\n */\n\nimport type { ToolCallRequest } from '@quilltap/plugin-types';\n\n/**\n * Supported tool call response formats\n */\nexport type ToolCallFormat = 'openai' | 'anthropic' | 'google' | 'auto';\n\n/**\n * Parse OpenAI format tool calls from LLM response\n *\n * Extracts tool calls from OpenAI/Grok API responses which return\n * tool_calls in the message object.\n *\n * Expected response structures:\n * - `response.tool_calls` (direct)\n * - `response.choices[0].message.tool_calls` (nested)\n *\n * @param response - The raw response from provider API\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * const response = await openai.chat.completions.create({...});\n * const toolCalls = parseOpenAIToolCalls(response);\n * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]\n * ```\n */\nexport function parseOpenAIToolCalls(response: unknown): ToolCallRequest[] {\n  const toolCalls: ToolCallRequest[] = [];\n\n  try {\n    const resp = response as Record<string, unknown>;\n\n    // Handle direct tool_calls array\n    let toolCallsArray = resp?.tool_calls as unknown[] | undefined;\n\n    // Check nested structure from streaming responses\n    if (!toolCallsArray) {\n      const choices = resp?.choices as\n        | Array<{ message?: { tool_calls?: unknown[] } }>\n        | undefined;\n      toolCallsArray = choices?.[0]?.message?.tool_calls;\n    }\n\n    if (toolCallsArray && Array.isArray(toolCallsArray) && toolCallsArray.length > 0) {\n      for (const toolCall of toolCallsArray) {\n        const tc = toolCall as {\n          type?: string;\n          function?: { name: string; arguments: string };\n        };\n\n        if (tc.type === 'function' && tc.function) {\n          toolCalls.push({\n            name: tc.function.name,\n            arguments: JSON.parse(tc.function.arguments || '{}'),\n          });\n        }\n      }\n    }\n  } catch (error) {\n    // Log error but don't throw - return empty array\n    console.error('[plugin-utils] Error parsing OpenAI tool calls:', error);\n  }\n\n  return toolCalls;\n}\n\n/**\n * Parse Anthropic format tool calls from LLM response\n *\n * Extracts tool calls from Anthropic API responses which return\n * tool_use blocks in the content array.\n *\n * Expected response structure:\n * - `response.content` array with `{ type: 'tool_use', name, input }`\n *\n * @param response - The raw response from provider API\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * const response = await anthropic.messages.create({...});\n * const toolCalls = parseAnthropicToolCalls(response);\n * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]\n * ```\n */\nexport function parseAnthropicToolCalls(response: unknown): ToolCallRequest[] {\n  const toolCalls: ToolCallRequest[] = [];\n\n  try {\n    const resp = response as Record<string, unknown>;\n\n    if (!resp?.content || !Array.isArray(resp.content)) {\n      return toolCalls;\n    }\n\n    for (const block of resp.content) {\n      const b = block as { type?: string; name?: string; input?: Record<string, unknown> };\n\n      if (b.type === 'tool_use' && b.name) {\n        toolCalls.push({\n          name: b.name,\n          arguments: b.input || {},\n        });\n      }\n    }\n  } catch (error) {\n    console.error('[plugin-utils] Error parsing Anthropic tool calls:', error);\n  }\n\n  return toolCalls;\n}\n\n/**\n * Parse Google Gemini format tool calls from LLM response\n *\n * Extracts tool calls from Google Gemini API responses which return\n * functionCall objects in the parts array.\n *\n * Expected response structure:\n * - `response.candidates[0].content.parts` array with `{ functionCall: { name, args } }`\n *\n * @param response - The raw response from provider API\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * const response = await gemini.generateContent({...});\n * const toolCalls = parseGoogleToolCalls(response);\n * // Returns: [{ name: 'search_web', arguments: { query: 'hello' } }]\n * ```\n */\nexport function parseGoogleToolCalls(response: unknown): ToolCallRequest[] {\n  const toolCalls: ToolCallRequest[] = [];\n\n  try {\n    const resp = response as Record<string, unknown>;\n    const candidates = resp?.candidates as\n      | Array<{ content?: { parts?: unknown[] } }>\n      | undefined;\n    const parts = candidates?.[0]?.content?.parts;\n\n    if (!parts || !Array.isArray(parts)) {\n      return toolCalls;\n    }\n\n    for (const part of parts) {\n      const p = part as {\n        functionCall?: { name: string; args?: Record<string, unknown> };\n      };\n\n      if (p.functionCall) {\n        toolCalls.push({\n          name: p.functionCall.name,\n          arguments: p.functionCall.args || {},\n        });\n      }\n    }\n  } catch (error) {\n    console.error('[plugin-utils] Error parsing Google tool calls:', error);\n  }\n\n  return toolCalls;\n}\n\n/**\n * Detect the format of a tool call response\n *\n * Analyzes the response structure to determine which provider format it uses.\n *\n * @param response - The raw response from a provider API\n * @returns The detected format, or null if unrecognized\n */\nexport function detectToolCallFormat(response: unknown): ToolCallFormat | null {\n  if (!response || typeof response !== 'object') {\n    return null;\n  }\n\n  const resp = response as Record<string, unknown>;\n\n  // OpenAI format: has tool_calls directly or in choices[0].message\n  if (resp.tool_calls && Array.isArray(resp.tool_calls)) {\n    return 'openai';\n  }\n\n  const choices = resp.choices as Array<{ message?: { tool_calls?: unknown[] } }> | undefined;\n  if (choices?.[0]?.message?.tool_calls) {\n    return 'openai';\n  }\n\n  // Anthropic format: has content array with tool_use type\n  if (resp.content && Array.isArray(resp.content)) {\n    const hasToolUse = (resp.content as Array<{ type?: string }>).some(\n      (block) => block.type === 'tool_use'\n    );\n    if (hasToolUse) {\n      return 'anthropic';\n    }\n  }\n\n  // Google format: has candidates[0].content.parts with functionCall\n  const candidates = resp.candidates as\n    | Array<{ content?: { parts?: Array<{ functionCall?: unknown }> } }>\n    | undefined;\n  if (candidates?.[0]?.content?.parts) {\n    const hasFunctionCall = candidates[0].content.parts.some((part) => part.functionCall);\n    if (hasFunctionCall) {\n      return 'google';\n    }\n  }\n\n  return null;\n}\n\n/**\n * Parse tool calls with auto-detection or explicit format\n *\n * A unified parser that can either auto-detect the response format\n * or use a specified format. This is useful when you're not sure\n * which provider's response you're handling.\n *\n * @param response - The raw response from a provider API\n * @param format - The format to use: 'openai', 'anthropic', 'google', or 'auto'\n * @returns Array of parsed tool call requests\n *\n * @example\n * ```typescript\n * // Auto-detect format\n * const toolCalls = parseToolCalls(response, 'auto');\n *\n * // Or specify format explicitly\n * const toolCalls = parseToolCalls(response, 'openai');\n * ```\n */\nexport function parseToolCalls(\n  response: unknown,\n  format: ToolCallFormat = 'auto'\n): ToolCallRequest[] {\n  let actualFormat: ToolCallFormat | null = format;\n\n  if (format === 'auto') {\n    actualFormat = detectToolCallFormat(response);\n    if (!actualFormat) {\n      return [];\n    }\n  }\n\n  switch (actualFormat) {\n    case 'openai':\n      return parseOpenAIToolCalls(response);\n    case 'anthropic':\n      return parseAnthropicToolCalls(response);\n    case 'google':\n      return parseGoogleToolCalls(response);\n    default:\n      return [];\n  }\n}\n\n/**\n * Check if a response contains tool calls\n *\n * Quick check to determine if a response has any tool calls\n * without fully parsing them.\n *\n * @param response - The raw response from a provider API\n * @returns True if the response contains tool calls\n */\nexport function hasToolCalls(response: unknown): boolean {\n  const format = detectToolCallFormat(response);\n  return format !== null;\n}\n","/**\n * Tool Format Converters\n *\n * Utilities for converting between different provider tool formats.\n * The universal format (OpenAI-style) serves as the baseline for all conversions.\n *\n * @module @quilltap/plugin-utils/tools/converters\n */\n\nimport type {\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n} from '@quilltap/plugin-types';\n\n/**\n * Convert OpenAI/Universal format tool to Anthropic format\n *\n * Anthropic uses a tool_use format with:\n * - name: string\n * - description: string\n * - input_schema: JSON schema object\n *\n * @param tool - Universal tool in OpenAI format\n * @returns Tool formatted for Anthropic's tool_use\n *\n * @example\n * ```typescript\n * const anthropicTool = convertToAnthropicFormat(universalTool);\n * // Returns: {\n * //   name: 'search_web',\n * //   description: 'Search the web',\n * //   input_schema: {\n * //     type: 'object',\n * //     properties: { query: { type: 'string' } },\n * //     required: ['query']\n * //   }\n * // }\n * ```\n */\nexport function convertToAnthropicFormat(tool: UniversalTool): AnthropicToolDefinition {\n  return {\n    name: tool.function.name,\n    description: tool.function.description,\n    input_schema: {\n      type: 'object',\n      properties: tool.function.parameters.properties,\n      required: tool.function.parameters.required,\n    },\n  };\n}\n\n/**\n * Convert OpenAI/Universal format tool to Google Gemini format\n *\n * Google uses a function calling format with:\n * - name: string\n * - description: string\n * - parameters: JSON schema object\n *\n * @param tool - Universal tool in OpenAI format\n * @returns Tool formatted for Google's functionCall\n *\n * @example\n * ```typescript\n * const googleTool = convertToGoogleFormat(universalTool);\n * // Returns: {\n * //   name: 'search_web',\n * //   description: 'Search the web',\n * //   parameters: {\n * //     type: 'object',\n * //     properties: { query: { type: 'string' } },\n * //     required: ['query']\n * //   }\n * // }\n * ```\n */\nexport function convertToGoogleFormat(tool: UniversalTool): GoogleToolDefinition {\n  return {\n    name: tool.function.name,\n    description: tool.function.description,\n    parameters: {\n      type: 'object',\n      properties: tool.function.parameters.properties,\n      required: tool.function.parameters.required,\n    },\n  };\n}\n\n/**\n * Convert Anthropic format tool to Universal/OpenAI format\n *\n * @param tool - Anthropic format tool\n * @returns Tool in universal OpenAI format\n */\nexport function convertFromAnthropicFormat(tool: AnthropicToolDefinition): UniversalTool {\n  return {\n    type: 'function',\n    function: {\n      name: tool.name,\n      description: tool.description ?? '',\n      parameters: {\n        type: 'object',\n        properties: tool.input_schema.properties,\n        required: tool.input_schema.required ?? [],\n      },\n    },\n  };\n}\n\n/**\n * Convert Google format tool to Universal/OpenAI format\n *\n * @param tool - Google format tool\n * @returns Tool in universal OpenAI format\n */\nexport function convertFromGoogleFormat(tool: GoogleToolDefinition): UniversalTool {\n  return {\n    type: 'function',\n    function: {\n      name: tool.name,\n      description: tool.description,\n      parameters: {\n        type: 'object',\n        properties: tool.parameters.properties,\n        required: tool.parameters.required,\n      },\n    },\n  };\n}\n\n/**\n * Apply prompt/description length limit to a tool\n *\n * Modifies a tool's description if it exceeds maxBytes, appending a warning\n * that the description was truncated. This is useful for providers with\n * strict token limits.\n *\n * @param tool - Tool object (any format) with a description property\n * @param maxBytes - Maximum bytes allowed for description (including warning)\n * @returns Modified tool with truncated description if needed\n *\n * @example\n * ```typescript\n * const limitedTool = applyDescriptionLimit(tool, 500);\n * // If description > 500 bytes, truncates and adds warning\n * ```\n */\nexport function applyDescriptionLimit<T extends { description: string }>(\n  tool: T,\n  maxBytes: number\n): T {\n  if (!tool || !tool.description) {\n    return tool;\n  }\n\n  const warningText = ' [Note: description truncated due to length limit]';\n  const maxDescBytes = maxBytes - Buffer.byteLength(warningText);\n\n  if (maxDescBytes <= 0) {\n    console.warn('[plugin-utils] Length limit too small for warning text:', maxBytes);\n    return tool;\n  }\n\n  const descBytes = Buffer.byteLength(tool.description);\n\n  if (descBytes > maxBytes) {\n    // Truncate description to fit within the byte limit\n    let truncated = tool.description;\n    while (Buffer.byteLength(truncated) > maxDescBytes && truncated.length > 0) {\n      truncated = truncated.slice(0, -1);\n    }\n\n    return {\n      ...tool,\n      description: truncated + warningText,\n    };\n  }\n\n  return tool;\n}\n\n/**\n * Target format for tool conversion\n */\nexport type ToolConvertTarget = 'openai' | 'anthropic' | 'google';\n\n/**\n * Convert a universal tool to a specific provider format\n *\n * @param tool - Universal tool in OpenAI format\n * @param target - Target provider format\n * @returns Tool in the target format\n */\nexport function convertToolTo(\n  tool: UniversalTool,\n  target: ToolConvertTarget\n): UniversalTool | AnthropicToolDefinition | GoogleToolDefinition {\n  switch (target) {\n    case 'anthropic':\n      return convertToAnthropicFormat(tool);\n    case 'google':\n      return convertToGoogleFormat(tool);\n    case 'openai':\n    default:\n      return tool;\n  }\n}\n\n/**\n * Convert multiple tools to a specific provider format\n *\n * @param tools - Array of universal tools\n * @param target - Target provider format\n * @returns Array of tools in the target format\n */\nexport function convertToolsTo(\n  tools: UniversalTool[],\n  target: ToolConvertTarget\n): Array<UniversalTool | AnthropicToolDefinition | GoogleToolDefinition> {\n  return tools.map((tool) => convertToolTo(tool, target));\n}\n"],"mappings":"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","names":[]}