@ai-sdk-tool/parser 3.0.0-canary.1 → 3.0.0-canary.2

package/dist/index.d.cts

@@ -121,7 +121,72 @@ interface JsonMixOptions {
 }
 declare const jsonMixProtocol: ({ toolCallStart, toolCallEnd, toolResponseStart, toolResponseEnd, }?: JsonMixOptions) => ToolCallProtocol;
 
-declare const morphXmlProtocol: () => ToolCallProtocol;
+/**
+ * Heuristic Engine for XML Tool-Call Parsing
+ *
+ * Pluggable pipeline for text normalization, repair, and object coercion.
+ *
+ * Phases:
+ * 1. pre-parse: Text normalization before initial parse
+ * 2. fallback-reparse: Text repair when initial parse fails
+ * 3. post-parse: Object repair/coercion after successful parse
+ */
+type HeuristicPhase = "pre-parse" | "fallback-reparse" | "post-parse";
+interface IntermediateCall {
+    toolName: string;
+    schema: unknown;
+    rawSegment: string;
+    parsed: unknown | null;
+    errors: unknown[];
+    meta?: Record<string, unknown>;
+}
+interface HeuristicResult {
+    rawSegment?: string;
+    parsed?: unknown;
+    reparse?: boolean;
+    stop?: boolean;
+    warnings?: string[];
+}
+interface ToolCallHeuristic$1 {
+    id: string;
+    phase: HeuristicPhase;
+    applies(ctx: IntermediateCall): boolean;
+    run(ctx: IntermediateCall): HeuristicResult;
+}
+interface PipelineConfig$1 {
+    preParse?: ToolCallHeuristic$1[];
+    fallbackReparse?: ToolCallHeuristic$1[];
+    postParse?: ToolCallHeuristic$1[];
+}
+interface HeuristicEngineOptions {
+    parse: (xml: string, schema: unknown) => unknown;
+    onError?: (message: string, metadata?: Record<string, unknown>) => void;
+    maxReparses?: number;
+}
+declare function applyHeuristicPipeline(ctx: IntermediateCall, config: PipelineConfig$1, options: HeuristicEngineOptions): IntermediateCall;
+declare function createIntermediateCall(toolName: string, rawSegment: string, schema: unknown): IntermediateCall;
+declare function mergePipelineConfigs(...configs: PipelineConfig$1[]): PipelineConfig$1;
+
+/**
+ * Default heuristics for XML tool-call parsing.
+ * Modular, reusable versions of normalization/repair logic from morph-xml-protocol.
+ */
+
+declare const normalizeCloseTagsHeuristic: ToolCallHeuristic$1;
+declare const escapeInvalidLtHeuristic: ToolCallHeuristic$1;
+declare const balanceTagsHeuristic: ToolCallHeuristic$1;
+declare const dedupeShellStringTagsHeuristic: ToolCallHeuristic$1;
+declare const repairAgainstSchemaHeuristic: ToolCallHeuristic$1;
+declare const defaultPipelineConfig: PipelineConfig$1;
+
+type PipelineConfig = PipelineConfig$1;
+type ToolCallHeuristic = ToolCallHeuristic$1;
+interface MorphXmlProtocolOptions {
+    heuristics?: ToolCallHeuristic[];
+    pipeline?: PipelineConfig;
+    maxReparses?: number;
+}
+declare const morphXmlProtocol: (protocolOptions?: MorphXmlProtocolOptions) => ToolCallProtocol;
 
 declare function createToolMiddleware({ protocol, toolSystemPromptTemplate, placement, }: {
     protocol: ToolCallProtocol | (() => ToolCallProtocol);
@@ -332,4 +397,4 @@ declare const gemmaToolMiddleware: _ai_sdk_provider.LanguageModelV3Middleware;
 declare const hermesToolMiddleware: _ai_sdk_provider.LanguageModelV3Middleware;
 declare const morphXmlToolMiddleware: _ai_sdk_provider.LanguageModelV3Middleware;
 
-export { type DebugLevel, type OnErrorFn, type ParseOptions as RJSONParseOptions, type ToolCallMiddlewareProviderOptions, createDynamicIfThenElseSchema, createToolMiddleware, decodeOriginalTools, encodeOriginalTools, escapeRegExp, extractOnErrorOption, extractToolNamesFromOriginalTools, gemmaToolMiddleware, getDebugLevel, getPotentialStartIndex, hasInputProperty, hermesToolMiddleware, isToolCallContent, isToolChoiceActive, isToolResultPart, jsonMixProtocol, logParseFailure, logParsedChunk, logParsedSummary, logRawChunk, morphXmlProtocol, morphXmlToolMiddleware, originalToolsSchema, parse as parseRJSON, stringify as stringifyRJSON, transform as transformRJSON };
+export { type DebugLevel, type HeuristicEngineOptions, type HeuristicPhase, type HeuristicResult, type IntermediateCall, type MorphXmlProtocolOptions, type OnErrorFn, type PipelineConfig$1 as PipelineConfig, type ParseOptions as RJSONParseOptions, type ToolCallHeuristic$1 as ToolCallHeuristic, type ToolCallMiddlewareProviderOptions, applyHeuristicPipeline, balanceTagsHeuristic, createDynamicIfThenElseSchema, createIntermediateCall, createToolMiddleware, decodeOriginalTools, dedupeShellStringTagsHeuristic, defaultPipelineConfig, encodeOriginalTools, escapeInvalidLtHeuristic, escapeRegExp, extractOnErrorOption, extractToolNamesFromOriginalTools, gemmaToolMiddleware, getDebugLevel, getPotentialStartIndex, hasInputProperty, hermesToolMiddleware, isToolCallContent, isToolChoiceActive, isToolResultPart, jsonMixProtocol, logParseFailure, logParsedChunk, logParsedSummary, logRawChunk, mergePipelineConfigs, morphXmlProtocol, morphXmlToolMiddleware, normalizeCloseTagsHeuristic, originalToolsSchema, parse as parseRJSON, repairAgainstSchemaHeuristic, stringify as stringifyRJSON, transform as transformRJSON };

package/dist/index.d.ts

@@ -121,7 +121,72 @@ interface JsonMixOptions {
 }
 declare const jsonMixProtocol: ({ toolCallStart, toolCallEnd, toolResponseStart, toolResponseEnd, }?: JsonMixOptions) => ToolCallProtocol;
 
-declare const morphXmlProtocol: () => ToolCallProtocol;
+/**
+ * Heuristic Engine for XML Tool-Call Parsing
+ *
+ * Pluggable pipeline for text normalization, repair, and object coercion.
+ *
+ * Phases:
+ * 1. pre-parse: Text normalization before initial parse
+ * 2. fallback-reparse: Text repair when initial parse fails
+ * 3. post-parse: Object repair/coercion after successful parse
+ */
+type HeuristicPhase = "pre-parse" | "fallback-reparse" | "post-parse";
+interface IntermediateCall {
+    toolName: string;
+    schema: unknown;
+    rawSegment: string;
+    parsed: unknown | null;
+    errors: unknown[];
+    meta?: Record<string, unknown>;
+}
+interface HeuristicResult {
+    rawSegment?: string;
+    parsed?: unknown;
+    reparse?: boolean;
+    stop?: boolean;
+    warnings?: string[];
+}
+interface ToolCallHeuristic$1 {
+    id: string;
+    phase: HeuristicPhase;
+    applies(ctx: IntermediateCall): boolean;
+    run(ctx: IntermediateCall): HeuristicResult;
+}
+interface PipelineConfig$1 {
+    preParse?: ToolCallHeuristic$1[];
+    fallbackReparse?: ToolCallHeuristic$1[];
+    postParse?: ToolCallHeuristic$1[];
+}
+interface HeuristicEngineOptions {
+    parse: (xml: string, schema: unknown) => unknown;
+    onError?: (message: string, metadata?: Record<string, unknown>) => void;
+    maxReparses?: number;
+}
+declare function applyHeuristicPipeline(ctx: IntermediateCall, config: PipelineConfig$1, options: HeuristicEngineOptions): IntermediateCall;
+declare function createIntermediateCall(toolName: string, rawSegment: string, schema: unknown): IntermediateCall;
+declare function mergePipelineConfigs(...configs: PipelineConfig$1[]): PipelineConfig$1;
+
+/**
+ * Default heuristics for XML tool-call parsing.
+ * Modular, reusable versions of normalization/repair logic from morph-xml-protocol.
+ */
+
+declare const normalizeCloseTagsHeuristic: ToolCallHeuristic$1;
+declare const escapeInvalidLtHeuristic: ToolCallHeuristic$1;
+declare const balanceTagsHeuristic: ToolCallHeuristic$1;
+declare const dedupeShellStringTagsHeuristic: ToolCallHeuristic$1;
+declare const repairAgainstSchemaHeuristic: ToolCallHeuristic$1;
+declare const defaultPipelineConfig: PipelineConfig$1;
+
+type PipelineConfig = PipelineConfig$1;
+type ToolCallHeuristic = ToolCallHeuristic$1;
+interface MorphXmlProtocolOptions {
+    heuristics?: ToolCallHeuristic[];
+    pipeline?: PipelineConfig;
+    maxReparses?: number;
+}
+declare const morphXmlProtocol: (protocolOptions?: MorphXmlProtocolOptions) => ToolCallProtocol;
 
 declare function createToolMiddleware({ protocol, toolSystemPromptTemplate, placement, }: {
     protocol: ToolCallProtocol | (() => ToolCallProtocol);
@@ -332,4 +397,4 @@ declare const gemmaToolMiddleware: _ai_sdk_provider.LanguageModelV3Middleware;
 declare const hermesToolMiddleware: _ai_sdk_provider.LanguageModelV3Middleware;
 declare const morphXmlToolMiddleware: _ai_sdk_provider.LanguageModelV3Middleware;
 
-export { type DebugLevel, type OnErrorFn, type ParseOptions as RJSONParseOptions, type ToolCallMiddlewareProviderOptions, createDynamicIfThenElseSchema, createToolMiddleware, decodeOriginalTools, encodeOriginalTools, escapeRegExp, extractOnErrorOption, extractToolNamesFromOriginalTools, gemmaToolMiddleware, getDebugLevel, getPotentialStartIndex, hasInputProperty, hermesToolMiddleware, isToolCallContent, isToolChoiceActive, isToolResultPart, jsonMixProtocol, logParseFailure, logParsedChunk, logParsedSummary, logRawChunk, morphXmlProtocol, morphXmlToolMiddleware, originalToolsSchema, parse as parseRJSON, stringify as stringifyRJSON, transform as transformRJSON };
+export { type DebugLevel, type HeuristicEngineOptions, type HeuristicPhase, type HeuristicResult, type IntermediateCall, type MorphXmlProtocolOptions, type OnErrorFn, type PipelineConfig$1 as PipelineConfig, type ParseOptions as RJSONParseOptions, type ToolCallHeuristic$1 as ToolCallHeuristic, type ToolCallMiddlewareProviderOptions, applyHeuristicPipeline, balanceTagsHeuristic, createDynamicIfThenElseSchema, createIntermediateCall, createToolMiddleware, decodeOriginalTools, dedupeShellStringTagsHeuristic, defaultPipelineConfig, encodeOriginalTools, escapeInvalidLtHeuristic, escapeRegExp, extractOnErrorOption, extractToolNamesFromOriginalTools, gemmaToolMiddleware, getDebugLevel, getPotentialStartIndex, hasInputProperty, hermesToolMiddleware, isToolCallContent, isToolChoiceActive, isToolResultPart, jsonMixProtocol, logParseFailure, logParsedChunk, logParsedSummary, logRawChunk, mergePipelineConfigs, morphXmlProtocol, morphXmlToolMiddleware, normalizeCloseTagsHeuristic, originalToolsSchema, parse as parseRJSON, repairAgainstSchemaHeuristic, stringify as stringifyRJSON, transform as transformRJSON };

package/dist/index.js

@@ -1,8 +1,14 @@
 import {
+  applyHeuristicPipeline,
+  balanceTagsHeuristic,
   createDynamicIfThenElseSchema,
+  createIntermediateCall,
   createToolMiddleware,
   decodeOriginalTools,
+  dedupeShellStringTagsHeuristic,
+  defaultPipelineConfig,
   encodeOriginalTools,
+  escapeInvalidLtHeuristic,
   escapeRegExp,
   extractOnErrorOption,
   extractToolNamesFromOriginalTools,
@@ -19,18 +25,27 @@ import {
   logParsedChunk,
   logParsedSummary,
   logRawChunk,
+  mergePipelineConfigs,
   morphXmlProtocol,
   morphXmlToolMiddleware,
+  normalizeCloseTagsHeuristic,
   originalToolsSchema,
   parse,
+  repairAgainstSchemaHeuristic,
   stringify,
   transform
-} from "./chunk-L4X363EL.js";
+} from "./chunk-LB5ALTRD.js";
 export {
+  applyHeuristicPipeline,
+  balanceTagsHeuristic,
   createDynamicIfThenElseSchema,
+  createIntermediateCall,
   createToolMiddleware,
   decodeOriginalTools,
+  dedupeShellStringTagsHeuristic,
+  defaultPipelineConfig,
   encodeOriginalTools,
+  escapeInvalidLtHeuristic,
   escapeRegExp,
   extractOnErrorOption,
   extractToolNamesFromOriginalTools,
@@ -47,10 +62,13 @@ export {
   logParsedChunk,
   logParsedSummary,
   logRawChunk,
+  mergePipelineConfigs,
   morphXmlProtocol,
   morphXmlToolMiddleware,
+  normalizeCloseTagsHeuristic,
   originalToolsSchema,
   parse as parseRJSON,
+  repairAgainstSchemaHeuristic,
   stringify as stringifyRJSON,
   transform as transformRJSON
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk-tool/parser",
-  "version": "3.0.0-canary.1",
+  "version": "3.0.0-canary.2",
   "description": "AI SDK middleware for tool call parsing",
   "type": "module",
   "repository": {