@anh3d0nic/qwen-code-termux-ice 21.0.1 → 21.2.0

package/core-dist/src/utils/safeJsonParse.test.js

@@ -0,0 +1,112 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { safeJsonParse } from './safeJsonParse.js';
+describe('safeJsonParse', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('valid JSON parsing', () => {
+        it('should parse valid JSON correctly', () => {
+            const validJson = '{"name": "test", "value": 123}';
+            const result = safeJsonParse(validJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+        });
+        it('should parse valid JSON arrays', () => {
+            const validArray = '["item1", "item2", "item3"]';
+            const result = safeJsonParse(validArray);
+            expect(result).toEqual(['item1', 'item2', 'item3']);
+        });
+        it('should parse valid JSON with nested objects', () => {
+            const validNested = '{"config": {"paths": ["testlogs/*.py"], "options": {"recursive": true}}}';
+            const result = safeJsonParse(validNested);
+            expect(result).toEqual({
+                config: {
+                    paths: ['testlogs/*.py'],
+                    options: { recursive: true },
+                },
+            });
+        });
+    });
+    describe('malformed JSON with jsonrepair fallback', () => {
+        it('should handle malformed JSON with single quotes', () => {
+            const malformedJson = "{'name': 'test', 'value': 123}";
+            const result = safeJsonParse(malformedJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+        });
+        it('should handle malformed JSON with unquoted keys', () => {
+            const malformedJson = '{name: "test", value: 123}';
+            const result = safeJsonParse(malformedJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+        });
+        it('should handle malformed JSON with trailing commas', () => {
+            const malformedJson = '{"name": "test", "value": 123,}';
+            const result = safeJsonParse(malformedJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+        });
+        it('should handle malformed JSON with comments', () => {
+            const malformedJson = '{"name": "test", // comment\n "value": 123}';
+            const result = safeJsonParse(malformedJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+        });
+    });
+    describe('fallback behavior', () => {
+        it('should return fallback value for empty string', () => {
+            const emptyString = '';
+            const fallback = { default: 'value' };
+            const result = safeJsonParse(emptyString, fallback);
+            expect(result).toEqual(fallback);
+        });
+        it('should return fallback value for null input', () => {
+            const nullInput = null;
+            const fallback = { default: 'value' };
+            const result = safeJsonParse(nullInput, fallback);
+            expect(result).toEqual(fallback);
+        });
+        it('should return fallback value for undefined input', () => {
+            const undefinedInput = undefined;
+            const fallback = { default: 'value' };
+            const result = safeJsonParse(undefinedInput, fallback);
+            expect(result).toEqual(fallback);
+        });
+        it('should return empty object as default fallback', () => {
+            const invalidJson = 'invalid json';
+            const result = safeJsonParse(invalidJson);
+            // jsonrepair returns the original string for completely invalid JSON
+            expect(result).toEqual('invalid json');
+        });
+        it('should return custom fallback when parsing fails', () => {
+            const invalidJson = 'invalid json';
+            const customFallback = { error: 'parsing failed', data: null };
+            const result = safeJsonParse(invalidJson, customFallback);
+            // jsonrepair returns the original string for completely invalid JSON
+            expect(result).toEqual('invalid json');
+        });
+    });
+    describe('type safety', () => {
+        it('should preserve generic type when parsing valid JSON', () => {
+            const validJson = '{"name": "test", "value": 123}';
+            const result = safeJsonParse(validJson);
+            expect(result).toEqual({ name: 'test', value: 123 });
+            // TypeScript should infer the correct type
+            expect(typeof result.name).toBe('string');
+            expect(typeof result.value).toBe('number');
+        });
+        it('should return fallback type when parsing fails', () => {
+            const invalidJson = 'invalid json';
+            const fallback = { error: 'fallback' };
+            const result = safeJsonParse(invalidJson, fallback);
+            // jsonrepair returns the original string for completely invalid JSON
+            expect(result).toEqual('invalid json');
+            // TypeScript should preserve the fallback type
+            expect(typeof result).toBe('string');
+        });
+    });
+});
+//# sourceMappingURL=safeJsonParse.test.js.map

package/core-dist/src/utils/safeJsonParse.test.js.map

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

package/core-dist/src/utils/safeJsonStringify.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Safely stringifies an object to JSON, handling circular references by replacing them with [Circular].
+ *
+ * @param obj - The object to stringify
+ * @param space - Optional space parameter for formatting (defaults to no formatting)
+ * @returns JSON string with circular references replaced by [Circular]
+ */
+export declare function safeJsonStringify(obj: unknown, space?: string | number): string;

package/core-dist/src/utils/safeJsonStringify.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Safely stringifies an object to JSON, handling circular references by replacing them with [Circular].
+ *
+ * @param obj - The object to stringify
+ * @param space - Optional space parameter for formatting (defaults to no formatting)
+ * @returns JSON string with circular references replaced by [Circular]
+ */
+export function safeJsonStringify(obj, space) {
+    const seen = new WeakSet();
+    return JSON.stringify(obj, (key, value) => {
+        if (typeof value === 'object' && value !== null) {
+            if (seen.has(value)) {
+                return '[Circular]';
+            }
+            seen.add(value);
+        }
+        return value;
+    }, space);
+}
+//# sourceMappingURL=safeJsonStringify.js.map

package/core-dist/src/utils/safeJsonStringify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeJsonStringify.js","sourceRoot":"","sources":["../../../src/utils/safeJsonStringify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAY,EACZ,KAAuB;IAEvB,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC,SAAS,CACnB,GAAG,EACH,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACb,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpB,OAAO,YAAY,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,EACD,KAAK,CACN,CAAC;AACJ,CAAC"}

package/core-dist/src/utils/safeJsonStringify.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/core-dist/src/utils/safeJsonStringify.test.js

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { safeJsonStringify } from './safeJsonStringify.js';
+describe('safeJsonStringify', () => {
+    it('should stringify normal objects without issues', () => {
+        const obj = { name: 'test', value: 42 };
+        const result = safeJsonStringify(obj);
+        expect(result).toBe('{"name":"test","value":42}');
+    });
+    it('should handle circular references by replacing them with [Circular]', () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const obj = { name: 'test' };
+        obj.circular = obj; // Create circular reference
+        const result = safeJsonStringify(obj);
+        expect(result).toBe('{"name":"test","circular":"[Circular]"}');
+    });
+    it('should handle complex circular structures like HttpsProxyAgent', () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const agent = {
+            sockets: {},
+            options: { host: 'example.com' },
+        };
+        agent.sockets['example.com'] = [{ agent }];
+        const result = safeJsonStringify(agent);
+        expect(result).toContain('[Circular]');
+        expect(result).toContain('example.com');
+    });
+    it('should respect the space parameter for formatting', () => {
+        const obj = { name: 'test', value: 42 };
+        const result = safeJsonStringify(obj, 2);
+        expect(result).toBe('{\n  "name": "test",\n  "value": 42\n}');
+    });
+    it('should handle circular references with formatting', () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const obj = { name: 'test' };
+        obj.circular = obj;
+        const result = safeJsonStringify(obj, 2);
+        expect(result).toBe('{\n  "name": "test",\n  "circular": "[Circular]"\n}');
+    });
+    it('should handle arrays with circular references', () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const arr = [{ id: 1 }];
+        arr[0].parent = arr; // Create circular reference
+        const result = safeJsonStringify(arr);
+        expect(result).toBe('[{"id":1,"parent":"[Circular]"}]');
+    });
+    it('should handle null and undefined values', () => {
+        expect(safeJsonStringify(null)).toBe('null');
+        expect(safeJsonStringify(undefined)).toBe(undefined);
+    });
+    it('should handle primitive values', () => {
+        expect(safeJsonStringify('test')).toBe('"test"');
+        expect(safeJsonStringify(42)).toBe('42');
+        expect(safeJsonStringify(true)).toBe('true');
+    });
+});
+//# sourceMappingURL=safeJsonStringify.test.js.map

package/core-dist/src/utils/safeJsonStringify.test.js.map

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

package/core-dist/src/utils/schemaConverter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Utility for converting JSON Schemas to be compatible with different LLM providers.
+ * Specifically focuses on downgrading modern JSON Schema (Draft 7/2020-12) to
+ * OpenAPI 3.0 compatible Schema Objects, which is required for Google Gemini API.
+ */
+export type SchemaComplianceMode = 'auto' | 'openapi_30';
+/**
+ * Converts a JSON Schema to be compatible with the specified compliance mode.
+ */
+export declare function convertSchema(schema: Record<string, unknown>, mode?: SchemaComplianceMode): Record<string, unknown>;

package/core-dist/src/utils/schemaConverter.js

@@ -0,0 +1,109 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Converts a JSON Schema to be compatible with the specified compliance mode.
+ */
+export function convertSchema(schema, mode = 'auto') {
+    if (mode === 'openapi_30') {
+        return toOpenAPI30(schema);
+    }
+    // Default ('auto') mode now does nothing.
+    return schema;
+}
+/**
+ * Converts Modern JSON Schema to OpenAPI 3.0 Schema Object.
+ * Attempts to preserve semantics where possible through transformations.
+ */
+function toOpenAPI30(schema) {
+    const convert = (obj) => {
+        if (typeof obj !== 'object' || obj === null) {
+            return obj;
+        }
+        if (Array.isArray(obj)) {
+            return obj.map(convert);
+        }
+        const source = obj;
+        const target = {};
+        // 1. Type Handling
+        if (Array.isArray(source['type'])) {
+            const types = source['type'];
+            // Handle ["string", "null"] pattern common in modern schemas
+            if (types.length === 2 && types.includes('null')) {
+                target['type'] = types.find((t) => t !== 'null');
+                target['nullable'] = true;
+            }
+            else {
+                // Fallback for other unions: take the first non-null type
+                // OpenAPI 3.0 doesn't support type arrays.
+                // Ideal fix would be anyOf, but simple fallback is safer for now.
+                target['type'] = types[0];
+            }
+        }
+        else if (source['type'] !== undefined) {
+            target['type'] = source['type'];
+        }
+        // 2. Const Handling (Draft 6+) -> Enum (OpenAPI 3.0)
+        if (source['const'] !== undefined) {
+            target['enum'] = [source['const']];
+            delete target['const'];
+        }
+        // 3. Exclusive Limits (Draft 6+ number) -> (Draft 4 boolean)
+        // exclusiveMinimum: 10 -> minimum: 10, exclusiveMinimum: true
+        if (typeof source['exclusiveMinimum'] === 'number') {
+            target['minimum'] = source['exclusiveMinimum'];
+            target['exclusiveMinimum'] = true;
+        }
+        if (typeof source['exclusiveMaximum'] === 'number') {
+            target['maximum'] = source['exclusiveMaximum'];
+            target['exclusiveMaximum'] = true;
+        }
+        // 4. Array Items (Tuple -> Single Schema)
+        // OpenAPI 3.0 items must be a schema object, not an array of schemas
+        if (Array.isArray(source['items'])) {
+            // Tuple support is tricky.
+            // Best effort: Use the first item's schema as a generic array type
+            // or convert to an empty object (any type) if mixed.
+            // For now, we'll strip it to allow validation to pass (accepts any items)
+            // This matches the legacy behavior but is explicit.
+            // Ideally, we could use `oneOf` on the items if we wanted to be stricter.
+            delete target['items'];
+        }
+        else if (typeof source['items'] === 'object' &&
+            source['items'] !== null) {
+            target['items'] = convert(source['items']);
+        }
+        // 5. Enum Stringification
+        // Gemini strictly requires enums to be strings
+        if (Array.isArray(source['enum'])) {
+            target['enum'] = source['enum'].map(String);
+        }
+        // 6. Recursively process other properties
+        for (const [key, value] of Object.entries(source)) {
+            // Skip fields we've already handled or want to remove
+            if (key === 'type' ||
+                key === 'const' ||
+                key === 'exclusiveMinimum' ||
+                key === 'exclusiveMaximum' ||
+                key === 'items' ||
+                key === 'enum' ||
+                key === '$schema' ||
+                key === '$id' ||
+                key === 'default' || // Optional: Gemini sometimes complains about defaults conflicting with types
+                key === 'dependencies' ||
+                key === 'patternProperties') {
+                continue;
+            }
+            target[key] = convert(value);
+        }
+        // Preserve default if it doesn't conflict (simple pass-through)
+        // if (source['default'] !== undefined) {
+        //   target['default'] = source['default'];
+        // }
+        return target;
+    };
+    return convert(schema);
+}
+//# sourceMappingURL=schemaConverter.js.map

package/core-dist/src/utils/schemaConverter.js.map

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

package/core-dist/src/utils/schemaConverter.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/core-dist/src/utils/schemaConverter.test.js

@@ -0,0 +1,106 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { convertSchema } from './schemaConverter.js';
+describe('convertSchema', () => {
+    describe('mode: auto (default)', () => {
+        it('should preserve type arrays', () => {
+            const input = { type: ['string', 'null'] };
+            expect(convertSchema(input, 'auto')).toEqual(input);
+        });
+        it('should preserve items array (tuples)', () => {
+            const input = {
+                type: 'array',
+                items: [{ type: 'string' }, { type: 'number' }],
+            };
+            expect(convertSchema(input, 'auto')).toEqual(input);
+        });
+        it('should preserve mixed enums', () => {
+            const input = { enum: [1, 2, '3'] };
+            expect(convertSchema(input, 'auto')).toEqual(input);
+        });
+        it('should preserve unsupported keywords', () => {
+            const input = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                exclusiveMinimum: 10,
+                type: 'number',
+            };
+            expect(convertSchema(input, 'auto')).toEqual(input);
+        });
+    });
+    describe('mode: openapi_30 (strict)', () => {
+        it('should convert type arrays to nullable', () => {
+            const input = { type: ['string', 'null'] };
+            const expected = { type: 'string', nullable: true };
+            expect(convertSchema(input, 'openapi_30')).toEqual(expected);
+        });
+        it('should fallback to first type for non-nullable arrays', () => {
+            const input = { type: ['string', 'number'] };
+            const expected = { type: 'string' };
+            expect(convertSchema(input, 'openapi_30')).toEqual(expected);
+        });
+        it('should convert const to enum', () => {
+            const input = { const: 'foo' };
+            const expected = { enum: ['foo'] };
+            expect(convertSchema(input, 'openapi_30')).toEqual(expected);
+        });
+        it('should convert exclusiveMinimum number to boolean', () => {
+            const input = { type: 'number', exclusiveMinimum: 10 };
+            const expected = {
+                type: 'number',
+                minimum: 10,
+                exclusiveMinimum: true,
+            };
+            expect(convertSchema(input, 'openapi_30')).toEqual(expected);
+        });
+        it('should convert nested objects recursively', () => {
+            const input = {
+                type: 'object',
+                properties: {
+                    prop1: { type: ['integer', 'null'], exclusiveMaximum: 5 },
+                },
+            };
+            const expected = {
+                type: 'object',
+                properties: {
+                    prop1: {
+                        type: 'integer',
+                        nullable: true,
+                        maximum: 5,
+                        exclusiveMaximum: true,
+                    },
+                },
+            };
+            expect(convertSchema(input, 'openapi_30')).toEqual(expected);
+        });
+        it('should stringify enums', () => {
+            const input = { enum: [1, 2, '3'] };
+            const expected = { enum: ['1', '2', '3'] };
+            expect(convertSchema(input, 'openapi_30')).toEqual(expected);
+        });
+        it('should remove tuple items (array of schemas)', () => {
+            const input = {
+                type: 'array',
+                items: [{ type: 'string' }, { type: 'number' }],
+            };
+            const expected = { type: 'array' };
+            expect(convertSchema(input, 'openapi_30')).toEqual(expected);
+        });
+        it('should remove unsupported keywords', () => {
+            const input = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                $id: '#foo',
+                type: 'string',
+                default: 'bar',
+                dependencies: { foo: ['bar'] },
+                patternProperties: { '^foo': { type: 'string' } },
+            };
+            const expected = { type: 'string' };
+            expect(convertSchema(input, 'openapi_30')).toEqual(expected);
+        });
+    });
+});
+//# sourceMappingURL=schemaConverter.test.js.map

package/core-dist/src/utils/schemaConverter.test.js.map

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

package/core-dist/src/utils/schemaValidator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Simple utility to validate objects against JSON Schemas.
+ * Supports both draft-07 (default) and draft-2020-12 schemas.
+ */
+export declare class SchemaValidator {
+    /**
+     * Returns null if the data conforms to the schema described by schema (or if schema
+     *  is null). Otherwise, returns a string describing the error.
+     */
+    static validate(schema: unknown | undefined, data: unknown): string | null;
+}

package/core-dist/src/utils/schemaValidator.js

@@ -0,0 +1,123 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import AjvPkg, {} from 'ajv';
+// Ajv2020 is the documented way to use draft-2020-12: https://ajv.js.org/json-schema.html#draft-2020-12
+// eslint-disable-next-line import/no-internal-modules
+import Ajv2020Pkg from 'ajv/dist/2020.js';
+import * as addFormats from 'ajv-formats';
+import { createDebugLogger } from './debugLogger.js';
+// Ajv's ESM/CJS interop: use 'any' for compatibility as recommended by Ajv docs
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const AjvClass = AjvPkg.default || AjvPkg;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const Ajv2020Class = Ajv2020Pkg.default || Ajv2020Pkg;
+const debugLogger = createDebugLogger('SchemaValidator');
+const ajvOptions = {
+    // See: https://ajv.js.org/options.html#strict-mode-options
+    // strictSchema defaults to true and prevents use of JSON schemas that
+    // include unrecognized keywords. The JSON schema spec specifically allows
+    // for the use of non-standard keywords and the spec-compliant behavior
+    // is to ignore those keywords. Note that setting this to false also
+    // allows use of non-standard or custom formats (the unknown format value
+    // will be logged but the schema will still be considered valid).
+    strictSchema: false,
+};
+// Draft-07 validator (default)
+const ajvDefault = new AjvClass(ajvOptions);
+// Draft-2020-12 validator for MCP servers using rmcp
+const ajv2020 = new Ajv2020Class(ajvOptions);
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const addFormatsFunc = addFormats.default || addFormats;
+addFormatsFunc(ajvDefault);
+addFormatsFunc(ajv2020);
+// Canonical draft-2020-12 meta-schema URI (used by rmcp MCP servers)
+const DRAFT_2020_12_SCHEMA = 'https://json-schema.org/draft/2020-12/schema';
+/**
+ * Returns the appropriate validator based on schema's $schema field.
+ */
+function getValidator(schema) {
+    if (typeof schema === 'object' &&
+        schema !== null &&
+        '$schema' in schema &&
+        schema.$schema === DRAFT_2020_12_SCHEMA) {
+        return ajv2020;
+    }
+    return ajvDefault;
+}
+/**
+ * Simple utility to validate objects against JSON Schemas.
+ * Supports both draft-07 (default) and draft-2020-12 schemas.
+ */
+export class SchemaValidator {
+    /**
+     * Returns null if the data conforms to the schema described by schema (or if schema
+     *  is null). Otherwise, returns a string describing the error.
+     */
+    static validate(schema, data) {
+        if (!schema) {
+            return null;
+        }
+        if (typeof data !== 'object' || data === null) {
+            return 'Value of params must be an object';
+        }
+        const anySchema = schema;
+        const validator = getValidator(anySchema);
+        // Try to compile and validate; skip validation if schema can't be compiled.
+        // This handles schemas using JSON Schema versions AJV doesn't support
+        // (e.g., draft-2019-09, future versions).
+        // This matches LenientJsonSchemaValidator behavior in mcp-client.ts.
+        let validate;
+        try {
+            validate = validator.compile(anySchema);
+        }
+        catch (error) {
+            // Schema compilation failed (unsupported version, invalid $ref, etc.)
+            // Skip validation rather than blocking tool usage.
+            debugLogger.warn(`Failed to compile schema (${schema?.['$schema'] ?? '<no $schema>'}): ${error instanceof Error ? error.message : String(error)}. ` +
+                'Skipping parameter validation.');
+            return null;
+        }
+        let valid = validate(data);
+        if (!valid && validate.errors) {
+            // Coerce string boolean values ("true"/"false") to actual booleans
+            fixBooleanValues(data);
+            valid = validate(data);
+            if (!valid && validate.errors) {
+                return validator.errorsText(validate.errors, { dataVar: 'params' });
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Coerces string boolean values to actual booleans.
+ * This handles cases where LLMs return "true"/"false" strings instead of boolean values,
+ * which is common with self-hosted LLMs.
+ *
+ * Converts:
+ * - "true", "True", "TRUE" -> true
+ * - "false", "False", "FALSE" -> false
+ */
+function fixBooleanValues(data) {
+    for (const key of Object.keys(data)) {
+        if (!(key in data))
+            continue;
+        const value = data[key];
+        if (typeof value === 'object' && value !== null) {
+            fixBooleanValues(value);
+        }
+        else if (typeof value === 'string') {
+            const lower = value.toLowerCase();
+            if (lower === 'true') {
+                data[key] = true;
+            }
+            else if (lower === 'false') {
+                data[key] = false;
+            }
+        }
+    }
+}
+//# sourceMappingURL=schemaValidator.js.map

package/core-dist/src/utils/schemaValidator.js.map

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