@quilltap/plugin-utils 1.4.1 → 1.5.1

package/dist/tools/index.d.mts

@@ -1,246 +1,109 @@
-import { ToolCallRequest, AnthropicToolDefinition, UniversalTool, GoogleToolDefinition, OpenAIToolDefinition } from '@quilltap/plugin-types';
+import { ToolCallRequest } from '@quilltap/plugin-types';
 export { AnthropicToolDefinition, GoogleToolDefinition, OpenAIToolDefinition, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool } from '@quilltap/plugin-types';
+export { T as ToolCallFormat, a as ToolConvertTarget, b as applyDescriptionLimit, c as convertFromAnthropicFormat, d as convertFromGoogleFormat, e as convertOpenAIToAnthropicFormat, f as convertOpenAIToGoogleFormat, g as convertToAnthropicFormat, h as convertToGoogleFormat, i as convertToolTo, j as convertToolsTo, k as detectToolCallFormat, l as hasToolCalls, p as parseAnthropicToolCalls, m as parseGoogleToolCalls, n as parseOpenAIToolCalls, o as parseToolCalls } from '../converters-BPYo8xdH.mjs';
 
 /**
- * Tool Call Parsers
+ * Text-Based 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.
+ * Utility functions for parsing spontaneous XML-style tool calls from LLM
+ * text responses. These are for models that emit tool-call-like markup in
+ * their output instead of using native function calling APIs.
  *
- * @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)
+ * Provider plugins import and compose these utilities to implement their
+ * `hasTextToolMarkers`, `parseTextToolCalls`, and `stripTextToolMarkers` methods.
  *
- * @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' } }]
- * ```
+ * @module @quilltap/plugin-utils/tools/text-parsers
  */
-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
+ * Parsed text-based tool call from LLM output
  */
-
+interface ParsedTextTool {
+    /** The tool name */
+    toolName: string;
+    /** Arguments extracted from the markup */
+    arguments: Record<string, unknown>;
+    /** The full matched markup text (for stripping) */
+    fullMatch: string;
+    /** Start index in the original text */
+    startIndex: number;
+    /** End index in the original text */
+    endIndex: number;
+    /** Which format was detected */
+    format: 'deepseek' | 'claude' | 'generic' | 'function_call' | 'tool_use';
+}
 /**
- * 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 or OpenAI tool definition
- * @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']
- * //   }
- * // }
- * ```
+ * Normalize a tool name from hallucinated markup to the canonical name.
+ * Returns the original name if no alias is found (passes through unknown tools).
  */
-declare function convertToAnthropicFormat(tool: UniversalTool | OpenAIToolDefinition): AnthropicToolDefinition;
+declare function normalizeToolName(name: string): string;
 /**
- * Convert OpenAI/Universal format tool to Google Gemini format
+ * Convert a ParsedTextTool to the standard ToolCallRequest format.
  *
- * Google uses a function calling format with:
- * - name: string
- * - description: string
- * - parameters: JSON schema object
- *
- * @param tool - Universal tool or OpenAI tool definition
- * @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']
- * //   }
- * // }
- * ```
+ * For well-known tools, normalizes argument names (e.g., "search" → "query").
+ * For unknown tools, passes arguments through as-is.
  */
-declare function convertToGoogleFormat(tool: UniversalTool | OpenAIToolDefinition): GoogleToolDefinition;
+declare function convertToToolCallRequest(parsed: ParsedTextTool): ToolCallRequest;
 /**
- * Convert Anthropic format tool to Universal/OpenAI format
- *
- * @param tool - Anthropic format tool
- * @returns Tool in universal OpenAI format
+ * Parse `<function_calls><invoke name="...">` format (DeepSeek and Claude-style)
  */
-declare function convertFromAnthropicFormat(tool: AnthropicToolDefinition): UniversalTool;
+declare function parseFunctionCallsFormat(response: string): ParsedTextTool[];
 /**
- * Convert Google format tool to Universal/OpenAI format
- *
- * @param tool - Google format tool
- * @returns Tool in universal OpenAI format
+ * Parse `<tool_call>` format (generic XML)
  */
-declare function convertFromGoogleFormat(tool: GoogleToolDefinition): UniversalTool;
+declare function parseToolCallFormat(response: string): ParsedTextTool[];
 /**
- * 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
- * ```
+ * Parse `<function_call name="...">` format
  */
-declare function applyDescriptionLimit<T extends {
-    description: string;
-}>(tool: T, maxBytes: number): T;
+declare function parseFunctionCallFormat(response: string): ParsedTextTool[];
 /**
- * Target format for tool conversion
+ * Parse `<tool_use>` format (Gemini and others)
+ *
+ * Handles multiple sub-formats:
+ * - Bare JSON: `<tool_use>{"name":"fn","input":{...}}</tool_use>`
+ * - XML children: `<tool_use><name>fn</name><arguments>...</arguments></tool_use>`
+ * - JSON in arguments: `<tool_use><name>fn</name><arguments>{"q":"v"}</arguments></tool_use>`
+ * - Attributed: `<tool_use name="fn"><arguments>...</arguments></tool_use>`
  */
-type ToolConvertTarget = 'openai' | 'anthropic' | 'google';
+declare function parseToolUseFormat(response: string): ParsedTextTool[];
 /**
- * Convert a universal tool to a specific provider format
+ * Parse all known XML tool call formats from response text.
+ * Deduplicates by position and sorts by start index.
  *
- * @param tool - Universal tool or OpenAI tool definition
- * @param target - Target provider format
- * @returns Tool in the target format
+ * Plugins can call this directly or compose individual format parsers
+ * for provider-specific behavior.
  */
-declare function convertToolTo(tool: UniversalTool | OpenAIToolDefinition, target: ToolConvertTarget): UniversalTool | OpenAIToolDefinition | AnthropicToolDefinition | GoogleToolDefinition;
+declare function parseAllXMLFormats(response: string): ParsedTextTool[];
 /**
- * Convert multiple tools to a specific provider format
- *
- * @param tools - Array of universal tools or OpenAI tool definitions
- * @param target - Target provider format
- * @returns Array of tools in the target format
+ * Convert parsed text tools to standard ToolCallRequest array.
+ * Convenience wrapper for plugins implementing parseTextToolCalls.
  */
-declare function convertToolsTo(tools: Array<UniversalTool | OpenAIToolDefinition>, target: ToolConvertTarget): Array<UniversalTool | OpenAIToolDefinition | AnthropicToolDefinition | GoogleToolDefinition>;
+declare function parseAllXMLAsToolCalls(response: string): ToolCallRequest[];
 /**
- * Alias for convertToAnthropicFormat
- * @deprecated Use convertToAnthropicFormat instead
+ * Check if text contains any of the known XML tool call patterns.
+ * Quick regex check before full parsing.
  */
-declare const convertOpenAIToAnthropicFormat: typeof convertToAnthropicFormat;
+declare function hasAnyXMLToolMarkers(response: string): boolean;
+/** Check for `<function_calls>` markers (DeepSeek/Claude-style) */
+declare function hasFunctionCallsMarkers(response: string): boolean;
+/** Check for `<tool_call>` markers (generic) */
+declare function hasToolCallMarkers(response: string): boolean;
+/** Check for `<function_call>` markers */
+declare function hasFunctionCallMarkers(response: string): boolean;
+/** Check for `<tool_use>` markers (Gemini-style) */
+declare function hasToolUseMarkers(response: string): boolean;
 /**
- * Alias for convertToGoogleFormat
- * @deprecated Use convertToGoogleFormat instead
+ * Strip all known XML tool call markers from text.
+ * Cleans up whitespace left behind.
  */
-declare const convertOpenAIToGoogleFormat: typeof convertToGoogleFormat;
+declare function stripAllXMLToolMarkers(response: string): string;
+/** Strip `<function_calls>` blocks */
+declare function stripFunctionCallsMarkers(response: string): string;
+/** Strip `<tool_call>` blocks */
+declare function stripToolCallMarkers(response: string): string;
+/** Strip `<function_call>` blocks */
+declare function stripFunctionCallMarkers(response: string): string;
+/** Strip `<tool_use>` blocks */
+declare function stripToolUseMarkers(response: string): string;
 
-export { type ToolCallFormat, type ToolConvertTarget, applyDescriptionLimit, convertFromAnthropicFormat, convertFromGoogleFormat, convertOpenAIToAnthropicFormat, convertOpenAIToGoogleFormat, convertToAnthropicFormat, convertToGoogleFormat, convertToolTo, convertToolsTo, detectToolCallFormat, hasToolCalls, parseAnthropicToolCalls, parseGoogleToolCalls, parseOpenAIToolCalls, parseToolCalls };
+export { type ParsedTextTool, convertToToolCallRequest as convertTextToolToRequest, hasAnyXMLToolMarkers, hasFunctionCallMarkers, hasFunctionCallsMarkers, hasToolCallMarkers, hasToolUseMarkers, normalizeToolName, parseAllXMLAsToolCalls, parseAllXMLFormats, parseFunctionCallFormat, parseFunctionCallsFormat, parseToolCallFormat, parseToolUseFormat, stripAllXMLToolMarkers, stripFunctionCallMarkers, stripFunctionCallsMarkers, stripToolCallMarkers, stripToolUseMarkers };

package/dist/tools/index.d.ts

@@ -1,246 +1,109 @@
-import { ToolCallRequest, AnthropicToolDefinition, UniversalTool, GoogleToolDefinition, OpenAIToolDefinition } from '@quilltap/plugin-types';
+import { ToolCallRequest } from '@quilltap/plugin-types';
 export { AnthropicToolDefinition, GoogleToolDefinition, OpenAIToolDefinition, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool } from '@quilltap/plugin-types';
+export { T as ToolCallFormat, a as ToolConvertTarget, b as applyDescriptionLimit, c as convertFromAnthropicFormat, d as convertFromGoogleFormat, e as convertOpenAIToAnthropicFormat, f as convertOpenAIToGoogleFormat, g as convertToAnthropicFormat, h as convertToGoogleFormat, i as convertToolTo, j as convertToolsTo, k as detectToolCallFormat, l as hasToolCalls, p as parseAnthropicToolCalls, m as parseGoogleToolCalls, n as parseOpenAIToolCalls, o as parseToolCalls } from '../converters-BPYo8xdH.js';
 
 /**
- * Tool Call Parsers
+ * Text-Based 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.
+ * Utility functions for parsing spontaneous XML-style tool calls from LLM
+ * text responses. These are for models that emit tool-call-like markup in
+ * their output instead of using native function calling APIs.
  *
- * @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)
+ * Provider plugins import and compose these utilities to implement their
+ * `hasTextToolMarkers`, `parseTextToolCalls`, and `stripTextToolMarkers` methods.
  *
- * @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' } }]
- * ```
+ * @module @quilltap/plugin-utils/tools/text-parsers
  */
-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
+ * Parsed text-based tool call from LLM output
  */
-
+interface ParsedTextTool {
+    /** The tool name */
+    toolName: string;
+    /** Arguments extracted from the markup */
+    arguments: Record<string, unknown>;
+    /** The full matched markup text (for stripping) */
+    fullMatch: string;
+    /** Start index in the original text */
+    startIndex: number;
+    /** End index in the original text */
+    endIndex: number;
+    /** Which format was detected */
+    format: 'deepseek' | 'claude' | 'generic' | 'function_call' | 'tool_use';
+}
 /**
- * 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 or OpenAI tool definition
- * @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']
- * //   }
- * // }
- * ```
+ * Normalize a tool name from hallucinated markup to the canonical name.
+ * Returns the original name if no alias is found (passes through unknown tools).
  */
-declare function convertToAnthropicFormat(tool: UniversalTool | OpenAIToolDefinition): AnthropicToolDefinition;
+declare function normalizeToolName(name: string): string;
 /**
- * Convert OpenAI/Universal format tool to Google Gemini format
+ * Convert a ParsedTextTool to the standard ToolCallRequest format.
  *
- * Google uses a function calling format with:
- * - name: string
- * - description: string
- * - parameters: JSON schema object
- *
- * @param tool - Universal tool or OpenAI tool definition
- * @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']
- * //   }
- * // }
- * ```
+ * For well-known tools, normalizes argument names (e.g., "search" → "query").
+ * For unknown tools, passes arguments through as-is.
  */
-declare function convertToGoogleFormat(tool: UniversalTool | OpenAIToolDefinition): GoogleToolDefinition;
+declare function convertToToolCallRequest(parsed: ParsedTextTool): ToolCallRequest;
 /**
- * Convert Anthropic format tool to Universal/OpenAI format
- *
- * @param tool - Anthropic format tool
- * @returns Tool in universal OpenAI format
+ * Parse `<function_calls><invoke name="...">` format (DeepSeek and Claude-style)
  */
-declare function convertFromAnthropicFormat(tool: AnthropicToolDefinition): UniversalTool;
+declare function parseFunctionCallsFormat(response: string): ParsedTextTool[];
 /**
- * Convert Google format tool to Universal/OpenAI format
- *
- * @param tool - Google format tool
- * @returns Tool in universal OpenAI format
+ * Parse `<tool_call>` format (generic XML)
  */
-declare function convertFromGoogleFormat(tool: GoogleToolDefinition): UniversalTool;
+declare function parseToolCallFormat(response: string): ParsedTextTool[];
 /**
- * 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
- * ```
+ * Parse `<function_call name="...">` format
  */
-declare function applyDescriptionLimit<T extends {
-    description: string;
-}>(tool: T, maxBytes: number): T;
+declare function parseFunctionCallFormat(response: string): ParsedTextTool[];
 /**
- * Target format for tool conversion
+ * Parse `<tool_use>` format (Gemini and others)
+ *
+ * Handles multiple sub-formats:
+ * - Bare JSON: `<tool_use>{"name":"fn","input":{...}}</tool_use>`
+ * - XML children: `<tool_use><name>fn</name><arguments>...</arguments></tool_use>`
+ * - JSON in arguments: `<tool_use><name>fn</name><arguments>{"q":"v"}</arguments></tool_use>`
+ * - Attributed: `<tool_use name="fn"><arguments>...</arguments></tool_use>`
  */
-type ToolConvertTarget = 'openai' | 'anthropic' | 'google';
+declare function parseToolUseFormat(response: string): ParsedTextTool[];
 /**
- * Convert a universal tool to a specific provider format
+ * Parse all known XML tool call formats from response text.
+ * Deduplicates by position and sorts by start index.
  *
- * @param tool - Universal tool or OpenAI tool definition
- * @param target - Target provider format
- * @returns Tool in the target format
+ * Plugins can call this directly or compose individual format parsers
+ * for provider-specific behavior.
  */
-declare function convertToolTo(tool: UniversalTool | OpenAIToolDefinition, target: ToolConvertTarget): UniversalTool | OpenAIToolDefinition | AnthropicToolDefinition | GoogleToolDefinition;
+declare function parseAllXMLFormats(response: string): ParsedTextTool[];
 /**
- * Convert multiple tools to a specific provider format
- *
- * @param tools - Array of universal tools or OpenAI tool definitions
- * @param target - Target provider format
- * @returns Array of tools in the target format
+ * Convert parsed text tools to standard ToolCallRequest array.
+ * Convenience wrapper for plugins implementing parseTextToolCalls.
  */
-declare function convertToolsTo(tools: Array<UniversalTool | OpenAIToolDefinition>, target: ToolConvertTarget): Array<UniversalTool | OpenAIToolDefinition | AnthropicToolDefinition | GoogleToolDefinition>;
+declare function parseAllXMLAsToolCalls(response: string): ToolCallRequest[];
 /**
- * Alias for convertToAnthropicFormat
- * @deprecated Use convertToAnthropicFormat instead
+ * Check if text contains any of the known XML tool call patterns.
+ * Quick regex check before full parsing.
  */
-declare const convertOpenAIToAnthropicFormat: typeof convertToAnthropicFormat;
+declare function hasAnyXMLToolMarkers(response: string): boolean;
+/** Check for `<function_calls>` markers (DeepSeek/Claude-style) */
+declare function hasFunctionCallsMarkers(response: string): boolean;
+/** Check for `<tool_call>` markers (generic) */
+declare function hasToolCallMarkers(response: string): boolean;
+/** Check for `<function_call>` markers */
+declare function hasFunctionCallMarkers(response: string): boolean;
+/** Check for `<tool_use>` markers (Gemini-style) */
+declare function hasToolUseMarkers(response: string): boolean;
 /**
- * Alias for convertToGoogleFormat
- * @deprecated Use convertToGoogleFormat instead
+ * Strip all known XML tool call markers from text.
+ * Cleans up whitespace left behind.
  */
-declare const convertOpenAIToGoogleFormat: typeof convertToGoogleFormat;
+declare function stripAllXMLToolMarkers(response: string): string;
+/** Strip `<function_calls>` blocks */
+declare function stripFunctionCallsMarkers(response: string): string;
+/** Strip `<tool_call>` blocks */
+declare function stripToolCallMarkers(response: string): string;
+/** Strip `<function_call>` blocks */
+declare function stripFunctionCallMarkers(response: string): string;
+/** Strip `<tool_use>` blocks */
+declare function stripToolUseMarkers(response: string): string;
 
-export { type ToolCallFormat, type ToolConvertTarget, applyDescriptionLimit, convertFromAnthropicFormat, convertFromGoogleFormat, convertOpenAIToAnthropicFormat, convertOpenAIToGoogleFormat, convertToAnthropicFormat, convertToGoogleFormat, convertToolTo, convertToolsTo, detectToolCallFormat, hasToolCalls, parseAnthropicToolCalls, parseGoogleToolCalls, parseOpenAIToolCalls, parseToolCalls };
+export { type ParsedTextTool, convertToToolCallRequest as convertTextToolToRequest, hasAnyXMLToolMarkers, hasFunctionCallMarkers, hasFunctionCallsMarkers, hasToolCallMarkers, hasToolUseMarkers, normalizeToolName, parseAllXMLAsToolCalls, parseAllXMLFormats, parseFunctionCallFormat, parseFunctionCallsFormat, parseToolCallFormat, parseToolUseFormat, stripAllXMLToolMarkers, stripFunctionCallMarkers, stripFunctionCallsMarkers, stripToolCallMarkers, stripToolUseMarkers };