@ai-sdk-tool/parser 3.1.2 → 3.2.0

package/dist/index.d.cts

@@ -1,65 +1,8 @@
+export * from '@ai-sdk-tool/rjson';
 import * as _ai_sdk_provider from '@ai-sdk/provider';
 import { LanguageModelV3FunctionTool, LanguageModelV3ToolCall, LanguageModelV3Content, LanguageModelV3StreamPart, LanguageModelV3ProviderTool, JSONSchema7, LanguageModelV3, LanguageModelV3Middleware, LanguageModelV3Prompt, SharedV3ProviderOptions } from '@ai-sdk/provider';
 import { ToolResultPart } from '@ai-sdk/provider-utils';
 
-/**
- * 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;
-
 interface TCMProtocol {
     formatTools({ tools, toolSystemPromptTemplate, }: {
         tools: LanguageModelV3FunctionTool[];
@@ -94,12 +37,14 @@ interface JsonProtocolOptions {
 }
 declare const jsonProtocol: ({ toolCallStart, toolCallEnd, }?: JsonProtocolOptions) => TCMProtocol;
 
-type PipelineConfig = PipelineConfig$1;
-type ToolCallHeuristic = ToolCallHeuristic$1;
 interface XmlProtocolOptions {
-    heuristics?: ToolCallHeuristic[];
-    pipeline?: PipelineConfig;
-    maxReparses?: number;
+    parseOptions?: {
+        repair?: boolean;
+        maxReparses?: number;
+        onError?: (message: string, metadata?: Record<string, unknown>) => void;
+        noChildNodes?: string[];
+        [key: string]: unknown;
+    };
 }
 declare const xmlProtocol: (protocolOptions?: XmlProtocolOptions) => TCMCoreProtocol;
 
@@ -198,113 +143,6 @@ declare function isToolChoiceActive(params: {
 
 declare function escapeRegExp(literal: string): string;
 
-/**
- * Options for configuring JSON parsing behavior
- */
-interface ParseOptions {
-    /**
-     * Enable relaxed JSON syntax parsing (unquoted keys, single quotes, trailing commas, comments)
-     * @default true
-     */
-    relaxed?: boolean;
-    /**
-     * Collect parsing warnings instead of throwing immediately. Implies tolerant mode.
-     * At the end of parsing, if warnings exist, throws with warning details.
-     * @default false
-     */
-    warnings?: boolean;
-    /**
-     * Continue parsing when encountering recoverable errors, collecting warnings.
-     * In strict mode (false), throws immediately on first error.
-     * @default false
-     */
-    tolerant?: boolean;
-    /**
-     * Allow duplicate object keys in JSON.
-     * - true: Allow duplicates (uses last value, like native JSON.parse)
-     * - false: Reject duplicates with error (enforces JSON specification)
-     * @default false
-     */
-    duplicate?: boolean;
-    /**
-     * Optional reviver function to transform parsed values (same as JSON.parse reviver)
-     * @param key - The object key or array index
-     * @param value - The parsed value
-     * @returns The transformed value
-     */
-    reviver?: (key: string, value: unknown) => unknown;
-}
-/**
- * Transform relaxed JSON syntax to standard JSON string
- *
- * Converts relaxed JSON features (unquoted keys, single quotes, trailing commas, comments)
- * into valid standard JSON syntax that can be parsed by native JSON.parse().
- *
- * @param text - The relaxed JSON string to transform
- * @returns A standard JSON string
- *
- * @example
- * ```typescript
- * transform('{key: "value", trailing: "comma",}')
- * // Returns: '{"key": "value", "trailing": "comma"}'
- *
- * transform("{'single': 'quotes'}")
- * // Returns: '{"single": "quotes"}'
- * ```
- */
-declare function transform(text: string): string;
-/**
- * Parse a JSON string with enhanced features beyond standard JSON.parse()
- *
- * Supports both strict JSON and relaxed JSON syntax with configurable error handling
- * and duplicate key validation.
- *
- * @param text - The JSON string to parse
- * @param optsOrReviver - Either a ParseOptions object for configuration, or a reviver function (like JSON.parse)
- *
- * @returns The parsed JavaScript value
- *
- * @throws {SyntaxError} When parsing fails in strict mode, or when warnings are collected in tolerant mode
- *
- * @example
- * ```typescript
- * // Standard JSON parsing
- * parse('{"key": "value"}')
- *
- * // Relaxed JSON with unquoted keys and trailing commas
- * parse('{key: "value", trailing: "comma",}', { relaxed: true })
- *
- * // Strict duplicate key validation
- * parse('{"key": 1, "key": 2}', { duplicate: false }) // throws error
- *
- * // Allow duplicates (uses last value)
- * parse('{"key": 1, "key": 2}', { duplicate: true }) // returns {key: 2}
- *
- * // Tolerant mode with warning collection
- * parse('malformed json', { tolerant: true, warnings: true })
- * ```
- */
-declare function parse(text: string, optsOrReviver?: ParseOptions | ((key: string, value: unknown) => unknown)): unknown;
-/**
- * Convert JavaScript value to JSON string with sorted object keys
- *
- * Similar to JSON.stringify but with consistent key ordering (sorted alphabetically).
- * Handles undefined values by converting them to null.
- *
- * @param obj - The value to convert to JSON string
- * @returns A JSON string representation
- *
- * @example
- * ```typescript
- * stringify({z: 1, a: 2, m: 3})
- * // Returns: '{"a":2,"m":3,"z":1}' (keys sorted)
- *
- * stringify({key: undefined})
- * // Returns: '{"key":null}' (undefined becomes null)
- * ```
- */
-declare function stringify(obj: unknown): string;
-
 declare function isToolResultPart(content: unknown): content is ToolResultPart;
 declare function hasInputProperty(obj: unknown): obj is {
     input?: unknown;
@@ -423,4 +261,4 @@ declare function transformParams({ params, protocol, toolSystemPromptTemplate, t
     toolChoice: undefined;
 };
 
-export { type DebugLevel, type HeuristicEngineOptions, type HeuristicPhase, type HeuristicResult, type IntermediateCall, type OnErrorFn, type ParseOptions, type PipelineConfig$1 as PipelineConfig, type TCMCoreProtocol, type TCMProtocol, type ToolCallHeuristic$1 as ToolCallHeuristic, type ToolCallMiddlewareProviderOptions, type XmlProtocolOptions, type YamlProtocolOptions, applyHeuristicPipeline, balanceTagsHeuristic, createDynamicIfThenElseSchema, createIntermediateCall, createToolMiddleware, decodeOriginalTools, dedupeShellStringTagsHeuristic, defaultPipelineConfig, encodeOriginalTools, escapeInvalidLtHeuristic, escapeRegExp, extractOnErrorOption, extractToolNamesFromOriginalTools, getDebugLevel, getPotentialStartIndex, hasInputProperty, hermesToolMiddleware, isProtocolFactory, isTCMProtocolFactory, isToolChoiceActive, isToolResultPart, jsonProtocol, logParseFailure, logParsedChunk, logParsedSummary, logRawChunk, mergePipelineConfigs, normalizeCloseTagsHeuristic, originalToolsSchema, parse, repairAgainstSchemaHeuristic, stringify, toolChoiceStream, transform, transformParams, wrapGenerate, wrapStream, xmlProtocol, xmlToolMiddleware, yamlProtocol, yamlToolMiddleware };
+export { type DebugLevel, type OnErrorFn, type TCMCoreProtocol, type TCMProtocol, type ToolCallMiddlewareProviderOptions, type XmlProtocolOptions, type YamlProtocolOptions, createDynamicIfThenElseSchema, createToolMiddleware, decodeOriginalTools, encodeOriginalTools, escapeRegExp, extractOnErrorOption, extractToolNamesFromOriginalTools, getDebugLevel, getPotentialStartIndex, hasInputProperty, hermesToolMiddleware, isProtocolFactory, isTCMProtocolFactory, isToolChoiceActive, isToolResultPart, jsonProtocol, logParseFailure, logParsedChunk, logParsedSummary, logRawChunk, originalToolsSchema, toolChoiceStream, transformParams, wrapGenerate, wrapStream, xmlProtocol, xmlToolMiddleware, yamlProtocol, yamlToolMiddleware };

package/dist/index.d.ts

@@ -1,65 +1,8 @@
+export * from '@ai-sdk-tool/rjson';
 import * as _ai_sdk_provider from '@ai-sdk/provider';
 import { LanguageModelV3FunctionTool, LanguageModelV3ToolCall, LanguageModelV3Content, LanguageModelV3StreamPart, LanguageModelV3ProviderTool, JSONSchema7, LanguageModelV3, LanguageModelV3Middleware, LanguageModelV3Prompt, SharedV3ProviderOptions } from '@ai-sdk/provider';
 import { ToolResultPart } from '@ai-sdk/provider-utils';
 
-/**
- * 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;
-
 interface TCMProtocol {
     formatTools({ tools, toolSystemPromptTemplate, }: {
         tools: LanguageModelV3FunctionTool[];
@@ -94,12 +37,14 @@ interface JsonProtocolOptions {
 }
 declare const jsonProtocol: ({ toolCallStart, toolCallEnd, }?: JsonProtocolOptions) => TCMProtocol;
 
-type PipelineConfig = PipelineConfig$1;
-type ToolCallHeuristic = ToolCallHeuristic$1;
 interface XmlProtocolOptions {
-    heuristics?: ToolCallHeuristic[];
-    pipeline?: PipelineConfig;
-    maxReparses?: number;
+    parseOptions?: {
+        repair?: boolean;
+        maxReparses?: number;
+        onError?: (message: string, metadata?: Record<string, unknown>) => void;
+        noChildNodes?: string[];
+        [key: string]: unknown;
+    };
 }
 declare const xmlProtocol: (protocolOptions?: XmlProtocolOptions) => TCMCoreProtocol;
 
@@ -198,113 +143,6 @@ declare function isToolChoiceActive(params: {
 
 declare function escapeRegExp(literal: string): string;
 
-/**
- * Options for configuring JSON parsing behavior
- */
-interface ParseOptions {
-    /**
-     * Enable relaxed JSON syntax parsing (unquoted keys, single quotes, trailing commas, comments)
-     * @default true
-     */
-    relaxed?: boolean;
-    /**
-     * Collect parsing warnings instead of throwing immediately. Implies tolerant mode.
-     * At the end of parsing, if warnings exist, throws with warning details.
-     * @default false
-     */
-    warnings?: boolean;
-    /**
-     * Continue parsing when encountering recoverable errors, collecting warnings.
-     * In strict mode (false), throws immediately on first error.
-     * @default false
-     */
-    tolerant?: boolean;
-    /**
-     * Allow duplicate object keys in JSON.
-     * - true: Allow duplicates (uses last value, like native JSON.parse)
-     * - false: Reject duplicates with error (enforces JSON specification)
-     * @default false
-     */
-    duplicate?: boolean;
-    /**
-     * Optional reviver function to transform parsed values (same as JSON.parse reviver)
-     * @param key - The object key or array index
-     * @param value - The parsed value
-     * @returns The transformed value
-     */
-    reviver?: (key: string, value: unknown) => unknown;
-}
-/**
- * Transform relaxed JSON syntax to standard JSON string
- *
- * Converts relaxed JSON features (unquoted keys, single quotes, trailing commas, comments)
- * into valid standard JSON syntax that can be parsed by native JSON.parse().
- *
- * @param text - The relaxed JSON string to transform
- * @returns A standard JSON string
- *
- * @example
- * ```typescript
- * transform('{key: "value", trailing: "comma",}')
- * // Returns: '{"key": "value", "trailing": "comma"}'
- *
- * transform("{'single': 'quotes'}")
- * // Returns: '{"single": "quotes"}'
- * ```
- */
-declare function transform(text: string): string;
-/**
- * Parse a JSON string with enhanced features beyond standard JSON.parse()
- *
- * Supports both strict JSON and relaxed JSON syntax with configurable error handling
- * and duplicate key validation.
- *
- * @param text - The JSON string to parse
- * @param optsOrReviver - Either a ParseOptions object for configuration, or a reviver function (like JSON.parse)
- *
- * @returns The parsed JavaScript value
- *
- * @throws {SyntaxError} When parsing fails in strict mode, or when warnings are collected in tolerant mode
- *
- * @example
- * ```typescript
- * // Standard JSON parsing
- * parse('{"key": "value"}')
- *
- * // Relaxed JSON with unquoted keys and trailing commas
- * parse('{key: "value", trailing: "comma",}', { relaxed: true })
- *
- * // Strict duplicate key validation
- * parse('{"key": 1, "key": 2}', { duplicate: false }) // throws error
- *
- * // Allow duplicates (uses last value)
- * parse('{"key": 1, "key": 2}', { duplicate: true }) // returns {key: 2}
- *
- * // Tolerant mode with warning collection
- * parse('malformed json', { tolerant: true, warnings: true })
- * ```
- */
-declare function parse(text: string, optsOrReviver?: ParseOptions | ((key: string, value: unknown) => unknown)): unknown;
-/**
- * Convert JavaScript value to JSON string with sorted object keys
- *
- * Similar to JSON.stringify but with consistent key ordering (sorted alphabetically).
- * Handles undefined values by converting them to null.
- *
- * @param obj - The value to convert to JSON string
- * @returns A JSON string representation
- *
- * @example
- * ```typescript
- * stringify({z: 1, a: 2, m: 3})
- * // Returns: '{"a":2,"m":3,"z":1}' (keys sorted)
- *
- * stringify({key: undefined})
- * // Returns: '{"key":null}' (undefined becomes null)
- * ```
- */
-declare function stringify(obj: unknown): string;
-
 declare function isToolResultPart(content: unknown): content is ToolResultPart;
 declare function hasInputProperty(obj: unknown): obj is {
     input?: unknown;
@@ -423,4 +261,4 @@ declare function transformParams({ params, protocol, toolSystemPromptTemplate, t
     toolChoice: undefined;
 };
 
-export { type DebugLevel, type HeuristicEngineOptions, type HeuristicPhase, type HeuristicResult, type IntermediateCall, type OnErrorFn, type ParseOptions, type PipelineConfig$1 as PipelineConfig, type TCMCoreProtocol, type TCMProtocol, type ToolCallHeuristic$1 as ToolCallHeuristic, type ToolCallMiddlewareProviderOptions, type XmlProtocolOptions, type YamlProtocolOptions, applyHeuristicPipeline, balanceTagsHeuristic, createDynamicIfThenElseSchema, createIntermediateCall, createToolMiddleware, decodeOriginalTools, dedupeShellStringTagsHeuristic, defaultPipelineConfig, encodeOriginalTools, escapeInvalidLtHeuristic, escapeRegExp, extractOnErrorOption, extractToolNamesFromOriginalTools, getDebugLevel, getPotentialStartIndex, hasInputProperty, hermesToolMiddleware, isProtocolFactory, isTCMProtocolFactory, isToolChoiceActive, isToolResultPart, jsonProtocol, logParseFailure, logParsedChunk, logParsedSummary, logRawChunk, mergePipelineConfigs, normalizeCloseTagsHeuristic, originalToolsSchema, parse, repairAgainstSchemaHeuristic, stringify, toolChoiceStream, transform, transformParams, wrapGenerate, wrapStream, xmlProtocol, xmlToolMiddleware, yamlProtocol, yamlToolMiddleware };
+export { type DebugLevel, type OnErrorFn, type TCMCoreProtocol, type TCMProtocol, type ToolCallMiddlewareProviderOptions, type XmlProtocolOptions, type YamlProtocolOptions, createDynamicIfThenElseSchema, createToolMiddleware, decodeOriginalTools, encodeOriginalTools, escapeRegExp, extractOnErrorOption, extractToolNamesFromOriginalTools, getDebugLevel, getPotentialStartIndex, hasInputProperty, hermesToolMiddleware, isProtocolFactory, isTCMProtocolFactory, isToolChoiceActive, isToolResultPart, jsonProtocol, logParseFailure, logParsedChunk, logParsedSummary, logRawChunk, originalToolsSchema, toolChoiceStream, transformParams, wrapGenerate, wrapStream, xmlProtocol, xmlToolMiddleware, yamlProtocol, yamlToolMiddleware };

package/dist/index.js

@@ -1,14 +1,8 @@
 import {
-  applyHeuristicPipeline,
-  balanceTagsHeuristic,
   createDynamicIfThenElseSchema,
-  createIntermediateCall,
   createToolMiddleware,
   decodeOriginalTools,
-  dedupeShellStringTagsHeuristic,
-  defaultPipelineConfig,
   encodeOriginalTools,
-  escapeInvalidLtHeuristic,
   escapeRegExp,
   extractOnErrorOption,
   extractToolNamesFromOriginalTools,
@@ -25,14 +19,8 @@ import {
   logParsedChunk,
   logParsedSummary,
   logRawChunk,
-  mergePipelineConfigs,
-  normalizeCloseTagsHeuristic,
   originalToolsSchema,
-  parse,
-  repairAgainstSchemaHeuristic,
-  stringify,
   toolChoiceStream,
-  transform,
   transformParams,
   wrapGenerate,
   wrapStream,
@@ -40,18 +28,12 @@ import {
   xmlToolMiddleware,
   yamlProtocol,
   yamlToolMiddleware
-} from "./chunk-TQT6XSP7.js";
+} from "./chunk-PIUBQRFC.js";
 export {
-  applyHeuristicPipeline,
-  balanceTagsHeuristic,
   createDynamicIfThenElseSchema,
-  createIntermediateCall,
   createToolMiddleware,
   decodeOriginalTools,
-  dedupeShellStringTagsHeuristic,
-  defaultPipelineConfig,
   encodeOriginalTools,
-  escapeInvalidLtHeuristic,
   escapeRegExp,
   extractOnErrorOption,
   extractToolNamesFromOriginalTools,
@@ -68,14 +50,8 @@ export {
   logParsedChunk,
   logParsedSummary,
   logRawChunk,
-  mergePipelineConfigs,
-  normalizeCloseTagsHeuristic,
   originalToolsSchema,
-  parse,
-  repairAgainstSchemaHeuristic,
-  stringify,
   toolChoiceStream,
-  transform,
   transformParams,
   wrapGenerate,
   wrapStream,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk-tool/parser",
-  "version": "3.1.2",
+  "version": "3.2.0",
   "description": "AI SDK middleware for tool call parsing",
   "type": "module",
   "repository": {
@@ -30,18 +30,20 @@
     "access": "public"
   },
   "dependencies": {
-    "@ai-sdk/provider": "3.0.2",
-    "@ai-sdk/provider-utils": "4.0.4",
-    "yaml": "^2.7.0",
-    "@ai-sdk-tool/rxml": "0.1.2"
+    "@ai-sdk/provider": "3.0.4",
+    "@ai-sdk/provider-utils": "4.0.8",
+    "yaml": "^2.8.2",
+    "@ai-sdk-tool/schema-coerce": "0.1.0",
+    "@ai-sdk-tool/rjson": "0.1.0",
+    "@ai-sdk-tool/rxml": "0.2.0"
   },
   "devDependencies": {
-    "@ai-sdk/openai-compatible": "2.0.4",
-    "@types/node": "^25.0.3",
-    "ai": "6.0.23",
+    "@ai-sdk/openai-compatible": "2.0.13",
+    "@types/node": "^25.0.9",
+    "ai": "6.0.38",
     "tsup": "^8.5.1",
     "zod": "^4.3.5",
-    "@ai-sdkx/tsconfig": "0.0.1"
+    "@ai-sdk-tool/tsconfig": "0.0.1"
   },
   "keywords": [],
   "author": "",