@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

package/dist/src/__tests__/fixtures/provider-formatting-fixtures.d.ts

@@ -0,0 +1,140 @@
+export declare const TOOL_FORMATTER_FIXTURES: {
+    readonly capturedAt: "2026-06-08T23:45:10.324Z";
+    readonly anthropicToolDeclaration: readonly [{
+        readonly name: "read_file";
+        readonly description: "Read the contents of a file";
+        readonly input_schema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly file_path: {
+                    readonly type: "string";
+                    readonly description: "Path to the file";
+                };
+                readonly offset: {
+                    readonly type: "number";
+                    readonly description: "Line offset";
+                };
+            };
+            readonly required: readonly ["file_path"];
+        };
+    }, {
+        readonly name: "write_file";
+        readonly description: "Write content to a file";
+        readonly input_schema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly file_path: {
+                    readonly type: "string";
+                };
+                readonly content: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["file_path", "content"];
+        };
+    }];
+    readonly openAIToolDeclaration: readonly [{
+        readonly type: "function";
+        readonly function: {
+            readonly name: "read_file";
+            readonly description: "Read the contents of a file";
+            readonly parameters: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly file_path: {
+                        readonly type: "string";
+                        readonly description: "Path to the file";
+                    };
+                    readonly offset: {
+                        readonly type: "number";
+                        readonly description: "Line offset";
+                    };
+                };
+                readonly required: readonly ["file_path"];
+            };
+        };
+    }, {
+        readonly type: "function";
+        readonly function: {
+            readonly name: "write_file";
+            readonly description: "Write content to a file";
+            readonly parameters: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly file_path: {
+                        readonly type: "string";
+                    };
+                    readonly content: {
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["file_path", "content"];
+            };
+        };
+    }];
+    readonly toolIdNormalizationCases: readonly [{
+        readonly input: "call_abc123";
+        readonly openAI: "call_abc123";
+        readonly history: "hist_tool_abc123";
+        readonly anthropic: "toolu_abc123";
+    }, {
+        readonly input: "hist_tool_abc123";
+        readonly openAI: "call_abc123";
+        readonly history: "hist_tool_abc123";
+        readonly anthropic: "toolu_abc123";
+    }, {
+        readonly input: "toolu_abc123";
+        readonly openAI: "call_abc123";
+        readonly history: "hist_tool_abc123";
+        readonly anthropic: "toolu_abc123";
+    }, {
+        readonly input: "";
+        readonly openAI: "call_";
+        readonly history: "hist_tool_";
+        readonly anthropic: "toolu_empty";
+    }, {
+        readonly input: "call_with/special!chars";
+        readonly openAI: "call_withspecialchars";
+        readonly history: "hist_tool_withspecialchars";
+        readonly anthropic: "toolu_with-special-chars";
+    }];
+    readonly doubleEscapeCases: readonly [{
+        readonly input: "{\"key\": \"value\"}";
+        readonly shouldUseDoubleEscape_openai: false;
+        readonly shouldUseDoubleEscape_qwen: true;
+        readonly detection: {
+            readonly isDoubleEscaped: false;
+            readonly correctedValue: {
+                readonly key: "value";
+            };
+            readonly originalValue: "{\"key\": \"value\"}";
+            readonly detectionDetails: {};
+        };
+        readonly detectedInChunk: false;
+    }, {
+        readonly input: "\"{\\\"key\\\": \\\"value\\\"}\"";
+        readonly shouldUseDoubleEscape_qwen: true;
+        readonly detection: {
+            readonly isDoubleEscaped: true;
+            readonly correctedValue: {
+                readonly key: "value";
+            };
+            readonly originalValue: "\"{\\\"key\\\": \\\"value\\\"}\"";
+            readonly detectionDetails: {
+                readonly firstParse: "{\"key\": \"value\"}";
+                readonly secondParse: {
+                    readonly key: "value";
+                };
+            };
+        };
+        readonly detectedInChunk: false;
+    }, {
+        readonly input: "{\"count\": \"42\"}";
+        readonly processed_openai: {
+            readonly count: "42";
+        };
+        readonly processed_qwen: {
+            readonly count: "42";
+        };
+    }];
+};

package/dist/src/__tests__/fixtures/provider-formatting-fixtures.js

@@ -0,0 +1,157 @@
+export const TOOL_FORMATTER_FIXTURES = {
+    capturedAt: '2026-06-08T23:45:10.324Z',
+    anthropicToolDeclaration: [
+        {
+            name: 'read_file',
+            description: 'Read the contents of a file',
+            input_schema: {
+                type: 'object',
+                properties: {
+                    file_path: {
+                        type: 'string',
+                        description: 'Path to the file',
+                    },
+                    offset: {
+                        type: 'number',
+                        description: 'Line offset',
+                    },
+                },
+                required: ['file_path'],
+            },
+        },
+        {
+            name: 'write_file',
+            description: 'Write content to a file',
+            input_schema: {
+                type: 'object',
+                properties: {
+                    file_path: {
+                        type: 'string',
+                    },
+                    content: {
+                        type: 'string',
+                    },
+                },
+                required: ['file_path', 'content'],
+            },
+        },
+    ],
+    openAIToolDeclaration: [
+        {
+            type: 'function',
+            function: {
+                name: 'read_file',
+                description: 'Read the contents of a file',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        file_path: {
+                            type: 'string',
+                            description: 'Path to the file',
+                        },
+                        offset: {
+                            type: 'number',
+                            description: 'Line offset',
+                        },
+                    },
+                    required: ['file_path'],
+                },
+            },
+        },
+        {
+            type: 'function',
+            function: {
+                name: 'write_file',
+                description: 'Write content to a file',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        file_path: {
+                            type: 'string',
+                        },
+                        content: {
+                            type: 'string',
+                        },
+                    },
+                    required: ['file_path', 'content'],
+                },
+            },
+        },
+    ],
+    toolIdNormalizationCases: [
+        {
+            input: 'call_abc123',
+            openAI: 'call_abc123',
+            history: 'hist_tool_abc123',
+            anthropic: 'toolu_abc123',
+        },
+        {
+            input: 'hist_tool_abc123',
+            openAI: 'call_abc123',
+            history: 'hist_tool_abc123',
+            anthropic: 'toolu_abc123',
+        },
+        {
+            input: 'toolu_abc123',
+            openAI: 'call_abc123',
+            history: 'hist_tool_abc123',
+            anthropic: 'toolu_abc123',
+        },
+        {
+            input: '',
+            openAI: 'call_',
+            history: 'hist_tool_',
+            anthropic: 'toolu_empty',
+        },
+        {
+            input: 'call_with/special!chars',
+            openAI: 'call_withspecialchars',
+            history: 'hist_tool_withspecialchars',
+            anthropic: 'toolu_with-special-chars',
+        },
+    ],
+    doubleEscapeCases: [
+        {
+            input: '{"key": "value"}',
+            shouldUseDoubleEscape_openai: false,
+            shouldUseDoubleEscape_qwen: true,
+            detection: {
+                isDoubleEscaped: false,
+                correctedValue: {
+                    key: 'value',
+                },
+                originalValue: '{"key": "value"}',
+                detectionDetails: {},
+            },
+            detectedInChunk: false,
+        },
+        {
+            input: '"{\\"key\\": \\"value\\"}"',
+            shouldUseDoubleEscape_qwen: true,
+            detection: {
+                isDoubleEscaped: true,
+                correctedValue: {
+                    key: 'value',
+                },
+                originalValue: '"{\\"key\\": \\"value\\"}"',
+                detectionDetails: {
+                    firstParse: '{"key": "value"}',
+                    secondParse: {
+                        key: 'value',
+                    },
+                },
+            },
+            detectedInChunk: false,
+        },
+        {
+            input: '{"count": "42"}',
+            processed_openai: {
+                count: '42',
+            },
+            processed_qwen: {
+                count: '42',
+            },
+        },
+    ],
+};
+//# sourceMappingURL=provider-formatting-fixtures.js.map

package/dist/src/__tests__/fixtures/provider-formatting-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-formatting-fixtures.js","sourceRoot":"","sources":["../../../../src/__tests__/fixtures/provider-formatting-fixtures.ts"],"names":[],"mappings":"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"}

package/dist/src/__tests__/red-test-helpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P10
+ * @requirement:REQ-BEHAVIORAL-TDD
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ToolResult } from '../index.js';
+export interface ExecutableTool {
+    execute(...args: readonly unknown[]): Promise<ToolResult>;
+}
+export declare function executeToolForBehavioralAssertion(tool: ExecutableTool, ...args: readonly unknown[]): Promise<ToolResult>;

package/dist/src/__tests__/red-test-helpers.js

@@ -0,0 +1,18 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P10
+ * @requirement:REQ-BEHAVIORAL-TDD
+ */
+export async function executeToolForBehavioralAssertion(tool, ...args) {
+    try {
+        return await tool.execute(...args);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            llmContent: '',
+            returnDisplay: '',
+            error: { message },
+        };
+    }
+}
+//# sourceMappingURL=red-test-helpers.js.map

package/dist/src/__tests__/red-test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"red-test-helpers.js","sourceRoot":"","sources":["../../../src/__tests__/red-test-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,IAAoB,EACpB,GAAG,IAAwB;IAE3B,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,UAAU,EAAE,EAAE;YACd,aAAa,EAAE,EAAE;YACjB,KAAK,EAAE,EAAE,OAAO,EAAE;SACnB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/formatters/IToolFormatter.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P05
+ * @requirement:REQ-API-001, REQ-TEMPORARY-INTERFACES
+ */
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Package-local tool formatter interface.
+ *
+ * Defines the contract for converting tools between provider formats.
+ * This interface is self-contained with zero core dependencies.
+ *
+ * The types used here are simplified from core to avoid importing
+ * core-specific types. Implementations will bridge to core types
+ * via adapters.
+ */
+/** Supported tool serialization formats. */
+export type ToolFormat = 'openai' | 'anthropic' | 'deepseek' | 'qwen' | 'kimi' | 'mistral' | 'hermes' | 'xml' | 'llama' | 'gemma';
+/** An OpenAI-format function declaration. */
+export interface OpenAIFunction {
+    name: string;
+    description?: string;
+    parameters: object;
+}
+/** An OpenAI-format tool wrapper. */
+export interface OpenAITool {
+    type: 'function';
+    function: OpenAIFunction;
+}
+/** An OpenAI Responses API tool representation. */
+export interface ResponsesTool {
+    type: 'function';
+    name: string;
+    description?: string | null;
+    parameters: Record<string, unknown> | null;
+    strict: boolean | null;
+}
+/** A generic tool representation for formatter input. */
+export interface FormatterTool {
+    function: {
+        name: string;
+        description?: string;
+        parameters: Record<string, unknown>;
+    };
+}
+/** A tool call block produced by format parsing. */
+export interface ToolCallBlock {
+    type: 'tool_call';
+    id: string;
+    name: string;
+    description?: string;
+    parameters: unknown;
+}
+/**
+ * Interface for converting tools between provider formats.
+ *
+ * Implementations handle format-specific serialization while
+ * consuming the generic FormatterTool shape.
+ */
+export interface IToolFormatter {
+    /**
+     * Convert tools to the specified provider format.
+     * @param tools - Tools in generic format.
+     * @param format - Target provider format.
+     * @returns Tools in provider-specific format.
+     */
+    toProviderFormat(tools: FormatterTool[], format: ToolFormat): unknown;
+    /**
+     * Parse a raw provider tool call into tool call blocks.
+     * @param rawToolCall - Raw tool call from provider.
+     * @param format - Provider format of the raw call.
+     * @returns Parsed tool call blocks.
+     */
+    fromProviderFormat(rawToolCall: unknown, format: ToolFormat): ToolCallBlock[];
+    /**
+     * Convert tools to OpenAI Responses API format.
+     * @param tools - Tools in generic format.
+     * @returns Tools in Responses API format.
+     */
+    toResponsesTool(tools: FormatterTool[]): ResponsesTool[];
+}

package/dist/src/formatters/IToolFormatter.js

@@ -0,0 +1,6 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P05
+ * @requirement:REQ-API-001, REQ-TEMPORARY-INTERFACES
+ */
+export {};
+//# sourceMappingURL=IToolFormatter.js.map

package/dist/src/formatters/IToolFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IToolFormatter.js","sourceRoot":"","sources":["../../../src/formatters/IToolFormatter.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/formatters/ToolFormatter.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P05
+ * @requirement:REQ-API-001, REQ-TEMPORARY-INTERFACES
+ */
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Package-local tool formatter implementation.
+ *
+ * Converts tools between provider formats (OpenAI, Anthropic, etc.)
+ * using the self-contained IToolFormatter interface. Zero core dependencies.
+ */
+import type { IToolFormatter, ToolFormat, OpenAITool, ResponsesTool, FormatterTool, ToolCallBlock } from './IToolFormatter.js';
+/**
+ * Converts Gemini-format tool declarations to various provider formats.
+ *
+ * This implementation is self-contained with no core logger dependency.
+ * Logging is replaced with silent operation.
+ */
+export declare class ToolFormatter implements IToolFormatter {
+    /**
+     * Convert Gemini format tools directly to OpenAI format.
+     */
+    convertGeminiToOpenAI(geminiTools?: Array<{
+        functionDeclarations: Array<{
+            name: string;
+            description?: string;
+            parametersJsonSchema?: unknown;
+        }>;
+    }>): OpenAITool[] | undefined;
+    /**
+     * Convert Gemini format tools directly to Anthropic format.
+     */
+    convertGeminiToAnthropic(geminiTools?: Array<{
+        functionDeclarations: Array<{
+            name: string;
+            description?: string;
+            parametersJsonSchema?: unknown;
+        }>;
+    }>): Array<{
+        name: string;
+        description: string;
+        input_schema: {
+            type: 'object';
+            [key: string]: unknown;
+        };
+    }> | undefined;
+    /**
+     * Convert Gemini format tools to the specified provider format.
+     */
+    convertGeminiToFormat(geminiTools?: Array<{
+        functionDeclarations: Array<{
+            name: string;
+            description?: string;
+            parametersJsonSchema?: unknown;
+        }>;
+    }>, format?: ToolFormat): unknown;
+    /**
+     * Converts Gemini schema format to standard JSON Schema format.
+     */
+    convertGeminiSchemaToStandard(schema: unknown): unknown;
+    private convertSchemaProperties;
+    private convertSchemaItems;
+    private normalizeSchemaType;
+    private ensureRequiredForObjects;
+    private normalizeEnumValues;
+    private convertStringLengthConstraints;
+    toProviderFormat(tools: FormatterTool[], format: ToolFormat): unknown;
+    fromProviderFormat(rawToolCall: unknown, format: ToolFormat): ToolCallBlock[];
+    private fromOpenAIFormat;
+    private fromAnthropicFormat;
+    private fromTextParserFormat;
+    /**
+     * Handles streaming tool call accumulation for OpenAI-compatible providers.
+     */
+    accumulateStreamingToolCall(deltaToolCall: {
+        index?: number;
+        id?: string;
+        type?: string;
+        function?: {
+            name?: string;
+            arguments?: string;
+        };
+    }, accumulatedToolCalls: ToolCallBlock[], format: ToolFormat): void;
+    private accumulateOpenAIStreamingToolCall;
+    private accumulateStreamingArguments;
+    /**
+     * Formats tools for the OpenAI Responses API.
+     */
+    toResponsesTool(tools: FormatterTool[]): ResponsesTool[];
+}