tool-output-guard 0.3.0

package/dist/__tests__/validation/zod-validator.test.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const zod_1 = require("zod");
+const zod_validator_1 = require("../../validation/zod-validator");
+const UserSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    age: zod_1.z.number(),
+    email: zod_1.z.string().email().optional(),
+});
+(0, vitest_1.describe)('validateWithZod', () => {
+    (0, vitest_1.it)('returns success: true for valid data', () => {
+        const result = (0, zod_validator_1.validateWithZod)({ name: 'Alice', age: 30 }, UserSchema);
+        (0, vitest_1.expect)(result.success).toBe(true);
+        if (result.success) {
+            (0, vitest_1.expect)(result.data).toEqual({ name: 'Alice', age: 30 });
+        }
+    });
+    (0, vitest_1.it)('returns success: true with warnings: [] for valid data', () => {
+        const result = (0, zod_validator_1.validateWithZod)({ name: 'Bob', age: 25 }, UserSchema);
+        (0, vitest_1.expect)(result.success).toBe(true);
+        if (result.success) {
+            (0, vitest_1.expect)(result.warnings).toEqual([]);
+        }
+    });
+    (0, vitest_1.it)('returns success: false for wrong type', () => {
+        const result = (0, zod_validator_1.validateWithZod)({ name: 42, age: 30 }, UserSchema);
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            (0, vitest_1.expect)(result.violations.length).toBeGreaterThan(0);
+            const v = result.violations[0];
+            (0, vitest_1.expect)(v.code).toBe('WRONG_TYPE');
+            (0, vitest_1.expect)(v.path).toContain('name');
+        }
+    });
+    (0, vitest_1.it)('returns success: false for missing required field', () => {
+        const result = (0, zod_validator_1.validateWithZod)({ age: 30 }, UserSchema);
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            (0, vitest_1.expect)(result.violations.length).toBeGreaterThan(0);
+            const nameMissing = result.violations.find((v) => v.path.includes('name'));
+            (0, vitest_1.expect)(nameMissing).toBeDefined();
+        }
+    });
+    (0, vitest_1.it)('maps path correctly for nested schema', () => {
+        const schema = zod_1.z.object({ user: zod_1.z.object({ name: zod_1.z.string() }) });
+        const result = (0, zod_validator_1.validateWithZod)({ user: { name: 42 } }, schema);
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            const v = result.violations[0];
+            (0, vitest_1.expect)(v.path).toContain('user');
+            (0, vitest_1.expect)(v.path).toContain('name');
+        }
+    });
+    (0, vitest_1.it)('handles enum mismatch', () => {
+        const schema = zod_1.z.object({ status: zod_1.z.enum(['active', 'inactive']) });
+        const result = (0, zod_validator_1.validateWithZod)({ status: 'pending' }, schema);
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            const v = result.violations[0];
+            (0, vitest_1.expect)(v.code).toBe('ENUM_MISMATCH');
+        }
+    });
+    (0, vitest_1.it)('handles number constraint violation (too_big)', () => {
+        const schema = zod_1.z.object({ score: zod_1.z.number().max(100) });
+        const result = (0, zod_validator_1.validateWithZod)({ score: 150 }, schema);
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            const v = result.violations[0];
+            (0, vitest_1.expect)(v.code).toBe('CONSTRAINT_VIOLATION');
+        }
+    });
+    (0, vitest_1.it)('handles number constraint violation (too_small)', () => {
+        const schema = zod_1.z.object({ score: zod_1.z.number().min(0) });
+        const result = (0, zod_validator_1.validateWithZod)({ score: -5 }, schema);
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            const v = result.violations[0];
+            (0, vitest_1.expect)(v.code).toBe('CONSTRAINT_VIOLATION');
+        }
+    });
+    (0, vitest_1.it)('handles string pattern mismatch', () => {
+        const schema = zod_1.z.object({ code: zod_1.z.string().regex(/^[A-Z]+$/) });
+        const result = (0, zod_validator_1.validateWithZod)({ code: 'abc123' }, schema);
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            const v = result.violations[0];
+            (0, vitest_1.expect)(v.code).toBe('PATTERN_MISMATCH');
+        }
+    });
+    (0, vitest_1.it)('handles array path index', () => {
+        const schema = zod_1.z.object({ items: zod_1.z.array(zod_1.z.string()) });
+        const result = (0, zod_validator_1.validateWithZod)({ items: ['a', 42, 'c'] }, schema);
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            const v = result.violations[0];
+            (0, vitest_1.expect)(v.path).toContain('[1]');
+        }
+    });
+    (0, vitest_1.it)('collects multiple violations', () => {
+        const result = (0, zod_validator_1.validateWithZod)({ name: 42, age: 'old' }, UserSchema);
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            (0, vitest_1.expect)(result.violations.length).toBeGreaterThanOrEqual(2);
+        }
+    });
+    (0, vitest_1.it)('violations have non-empty messages', () => {
+        const result = (0, zod_validator_1.validateWithZod)({}, UserSchema);
+        (0, vitest_1.expect)(result.success).toBe(false);
+        if (!result.success) {
+            for (const v of result.violations) {
+                (0, vitest_1.expect)(v.message.length).toBeGreaterThan(0);
+                (0, vitest_1.expect)(v.llmMessage.length).toBeGreaterThan(0);
+            }
+        }
+    });
+});
+//# sourceMappingURL=zod-validator.test.js.map

package/dist/__tests__/validation/zod-validator.test.js.map

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

package/dist/__tests__/violations/violations.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=violations.test.d.ts.map

package/dist/__tests__/violations/violations.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"violations.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/violations/violations.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/violations/violations.test.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_1 = require("../../violations/index");
+(0, vitest_1.describe)('buildPath', () => {
+    (0, vitest_1.it)('returns $ for empty parts', () => {
+        (0, vitest_1.expect)((0, index_1.buildPath)([])).toBe('$');
+    });
+    (0, vitest_1.it)('formats a single string key', () => {
+        (0, vitest_1.expect)((0, index_1.buildPath)(['name'])).toBe('$.name');
+    });
+    (0, vitest_1.it)('formats a numeric index', () => {
+        (0, vitest_1.expect)((0, index_1.buildPath)([0])).toBe('$[0]');
+    });
+    (0, vitest_1.it)('formats nested object path', () => {
+        (0, vitest_1.expect)((0, index_1.buildPath)(['user', 'address', 'street'])).toBe('$.user.address.street');
+    });
+    (0, vitest_1.it)('formats mixed path with array index', () => {
+        (0, vitest_1.expect)((0, index_1.buildPath)(['items', 0, 'name'])).toBe('$.items[0].name');
+    });
+    (0, vitest_1.it)('formats deep nested path', () => {
+        (0, vitest_1.expect)((0, index_1.buildPath)(['a', 'b', 2, 'c'])).toBe('$.a.b[2].c');
+    });
+});
+(0, vitest_1.describe)('buildViolation', () => {
+    (0, vitest_1.it)('builds a violation with all required fields', () => {
+        const v = (0, index_1.buildViolation)('WRONG_TYPE', '$.name', 'Expected string, got number', 'number', 'string');
+        (0, vitest_1.expect)(v.code).toBe('WRONG_TYPE');
+        (0, vitest_1.expect)(v.path).toBe('$.name');
+        (0, vitest_1.expect)(v.message).toBe('Expected string, got number');
+        (0, vitest_1.expect)(v.received).toBe('number');
+        (0, vitest_1.expect)(v.expected).toBe('string');
+        (0, vitest_1.expect)(v.severity).toBe('error');
+    });
+    (0, vitest_1.it)('defaults severity to error', () => {
+        const v = (0, index_1.buildViolation)('MISSING_REQUIRED', '$.field', 'Missing field');
+        (0, vitest_1.expect)(v.severity).toBe('error');
+    });
+    (0, vitest_1.it)('accepts warning severity', () => {
+        const v = (0, index_1.buildViolation)('COERCED', '$.field', 'Coerced value', 'string', 'number', 'warning');
+        (0, vitest_1.expect)(v.severity).toBe('warning');
+    });
+    (0, vitest_1.it)('stores receivedValue and coercedValue', () => {
+        const v = (0, index_1.buildViolation)('COERCED', '$.x', 'Coerced', 'string', 'number', 'warning', '42', 42);
+        (0, vitest_1.expect)(v.receivedValue).toBe('42');
+        (0, vitest_1.expect)(v.coercedValue).toBe(42);
+    });
+    (0, vitest_1.it)('generates a non-empty llmMessage', () => {
+        const v = (0, index_1.buildViolation)('WRONG_TYPE', '$.name', 'Expected string', 'number', 'string');
+        (0, vitest_1.expect)(typeof v.llmMessage).toBe('string');
+        (0, vitest_1.expect)(v.llmMessage.length).toBeGreaterThan(0);
+    });
+    (0, vitest_1.it)('llmMessage references the path', () => {
+        const v = (0, index_1.buildViolation)('MISSING_REQUIRED', '$.address', 'Missing field');
+        (0, vitest_1.expect)(v.llmMessage).toContain('$.address');
+    });
+    (0, vitest_1.it)('handles ENUM_MISMATCH code', () => {
+        const v = (0, index_1.buildViolation)('ENUM_MISMATCH', '$.status', 'Invalid enum', 'pending', 'active | inactive');
+        (0, vitest_1.expect)(v.code).toBe('ENUM_MISMATCH');
+        (0, vitest_1.expect)(v.llmMessage).toContain('active | inactive');
+    });
+});
+(0, vitest_1.describe)('formatViolationMessage', () => {
+    (0, vitest_1.it)('includes severity, path, code, and message', () => {
+        const v = (0, index_1.buildViolation)('WRONG_TYPE', '$.name', 'Expected string, got number', 'number', 'string');
+        const msg = (0, index_1.formatViolationMessage)(v);
+        (0, vitest_1.expect)(msg).toContain('[ERROR]');
+        (0, vitest_1.expect)(msg).toContain('$.name');
+        (0, vitest_1.expect)(msg).toContain('WRONG_TYPE');
+        (0, vitest_1.expect)(msg).toContain('Expected string, got number');
+    });
+    (0, vitest_1.it)('uses uppercase severity', () => {
+        const v = (0, index_1.buildViolation)('COERCED', '$.x', 'Coerced', 'string', 'number', 'warning');
+        (0, vitest_1.expect)((0, index_1.formatViolationMessage)(v)).toContain('[WARNING]');
+    });
+});
+(0, vitest_1.describe)('formatViolationsForLLM', () => {
+    (0, vitest_1.it)('returns a no-violation message for empty array', () => {
+        (0, vitest_1.expect)((0, index_1.formatViolationsForLLM)([])).toBe('No violations found.');
+    });
+    (0, vitest_1.it)('includes violation count in the output', () => {
+        const violations = [
+            (0, index_1.buildViolation)('WRONG_TYPE', '$.a', 'Bad type', 'number', 'string'),
+            (0, index_1.buildViolation)('MISSING_REQUIRED', '$.b', 'Missing'),
+        ];
+        const msg = (0, index_1.formatViolationsForLLM)(violations);
+        (0, vitest_1.expect)(msg).toContain('2 violation(s)');
+    });
+    (0, vitest_1.it)('includes each violation llmMessage numbered', () => {
+        const v = (0, index_1.buildViolation)('MISSING_REQUIRED', '$.name', 'Missing required field');
+        const msg = (0, index_1.formatViolationsForLLM)([v]);
+        (0, vitest_1.expect)(msg).toContain('1.');
+        (0, vitest_1.expect)(msg).toContain(v.llmMessage);
+    });
+    (0, vitest_1.it)('ends with a fix suggestion', () => {
+        const v = (0, index_1.buildViolation)('WRONG_TYPE', '$.x', 'Bad', 'string', 'number');
+        const msg = (0, index_1.formatViolationsForLLM)([v]);
+        (0, vitest_1.expect)(msg).toContain('Please fix');
+    });
+});
+//# sourceMappingURL=violations.test.js.map

package/dist/__tests__/violations/violations.test.js.map

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

package/dist/create-guard.d.ts

@@ -0,0 +1,3 @@
+import type { Guard, GuardOptions } from './types';
+export declare function createGuard<T>(schema: unknown, options?: GuardOptions<T>): Guard<T>;
+//# sourceMappingURL=create-guard.d.ts.map

package/dist/create-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-guard.d.ts","sourceRoot":"","sources":["../src/create-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAoB,MAAM,SAAS,CAAC;AAIrE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAkCnF"}

package/dist/create-guard.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGuard = createGuard;
+const index_1 = require("./validation/index");
+const index_2 = require("./strategies/index");
+function createGuard(schema, options) {
+    function validate(value) {
+        return (0, index_1.validateOutput)(value, schema);
+    }
+    function wrap(toolFn) {
+        return async (args) => {
+            const raw = await toolFn(args);
+            const preprocessed = (0, index_2.preprocessForStrategy)(raw, schema, options ?? {});
+            const result = (0, index_1.validateOutput)(preprocessed, schema);
+            if (result.success) {
+                if (options?.onValidationPass) {
+                    options.onValidationPass(result.data);
+                }
+                return result.data;
+            }
+            if (options?.onValidationFail) {
+                options.onValidationFail(result.violations);
+            }
+            return (0, index_2.applyStrategy)(result, preprocessed, schema, options ?? {});
+        };
+    }
+    return {
+        validate,
+        wrap,
+        schema,
+        options: options ?? {},
+    };
+}
+//# sourceMappingURL=create-guard.js.map

package/dist/create-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-guard.js","sourceRoot":"","sources":["../src/create-guard.ts"],"names":[],"mappings":";;AAIA,kCAkCC;AArCD,8CAAoD;AACpD,8CAA0E;AAE1E,SAAgB,WAAW,CAAI,MAAe,EAAE,OAAyB;IACvE,SAAS,QAAQ,CAAC,KAAc;QAC9B,OAAO,IAAA,sBAAc,EAAI,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS,IAAI,CACX,MAAyC;QAEzC,OAAO,KAAK,EAAE,IAAW,EAAc,EAAE;YACvC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,GAAG,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;YACvE,MAAM,MAAM,GAAG,IAAA,sBAAc,EAAI,YAAY,EAAE,MAAM,CAAC,CAAC;YAEvD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAI,OAAO,EAAE,gBAAgB,EAAE,CAAC;oBAC9B,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACxC,CAAC;gBACD,OAAO,MAAM,CAAC,IAAI,CAAC;YACrB,CAAC;YAED,IAAI,OAAO,EAAE,gBAAgB,EAAE,CAAC;gBAC9B,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC9C,CAAC;YAED,OAAO,IAAA,qBAAa,EAAI,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ;QACR,IAAI;QACJ,MAAM;QACN,OAAO,EAAE,OAAO,IAAI,EAAE;KACvB,CAAC;AACJ,CAAC"}

package/dist/detection/index.d.ts

@@ -0,0 +1,10 @@
+export type SchemaType = 'zod' | 'typebox' | 'json-schema';
+export interface DetectedSchema {
+    type: SchemaType;
+    schema: unknown;
+}
+export declare function detectSchema(schema: unknown): DetectedSchema;
+export { isZodSchema } from './zod';
+export { isTypeBoxSchema } from './typebox';
+export { isJSONSchema } from './json-schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/detection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/detection/index.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,aAAa,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAID,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAoB5D;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/detection/index.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJSONSchema = exports.isTypeBoxSchema = exports.isZodSchema = void 0;
+exports.detectSchema = detectSchema;
+const zod_1 = require("./zod");
+const typebox_1 = require("./typebox");
+const json_schema_1 = require("./json-schema");
+const cache = new WeakMap();
+function detectSchema(schema) {
+    if (typeof schema !== 'object' || schema === null) {
+        throw new TypeError('Cannot detect schema type: schema must be a non-null object');
+    }
+    const cached = cache.get(schema);
+    if (cached)
+        return cached;
+    let result;
+    if ((0, zod_1.isZodSchema)(schema)) {
+        result = { type: 'zod', schema };
+    }
+    else if ((0, typebox_1.isTypeBoxSchema)(schema)) {
+        result = { type: 'typebox', schema };
+    }
+    else if ((0, json_schema_1.isJSONSchema)(schema)) {
+        result = { type: 'json-schema', schema };
+    }
+    else {
+        throw new TypeError('Cannot detect schema type: schema does not match Zod, TypeBox, or JSON Schema format');
+    }
+    cache.set(schema, result);
+    return result;
+}
+var zod_2 = require("./zod");
+Object.defineProperty(exports, "isZodSchema", { enumerable: true, get: function () { return zod_2.isZodSchema; } });
+var typebox_2 = require("./typebox");
+Object.defineProperty(exports, "isTypeBoxSchema", { enumerable: true, get: function () { return typebox_2.isTypeBoxSchema; } });
+var json_schema_2 = require("./json-schema");
+Object.defineProperty(exports, "isJSONSchema", { enumerable: true, get: function () { return json_schema_2.isJSONSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/detection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/detection/index.ts"],"names":[],"mappings":";;;AAaA,oCAoBC;AAjCD,+BAAoC;AACpC,uCAA4C;AAC5C,+CAA6C;AAS7C,MAAM,KAAK,GAAG,IAAI,OAAO,EAA0B,CAAC;AAEpD,SAAgB,YAAY,CAAC,MAAe;IAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,SAAS,CAAC,6DAA6D,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAgB,CAAC,CAAC;IAC3C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,MAAsB,CAAC;IAC3B,IAAI,IAAA,iBAAW,EAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;SAAM,IAAI,IAAA,yBAAe,EAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;SAAM,IAAI,IAAA,0BAAY,EAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,SAAS,CAAC,sFAAsF,CAAC,CAAC;IAC9G,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAgB,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6BAAoC;AAA3B,kGAAA,WAAW,OAAA;AACpB,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AACxB,6CAA6C;AAApC,2GAAA,YAAY,OAAA"}

package/dist/detection/json-schema.d.ts

@@ -0,0 +1,2 @@
+export declare function isJSONSchema(schema: unknown): boolean;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/detection/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/detection/json-schema.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAIrD"}

package/dist/detection/json-schema.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJSONSchema = isJSONSchema;
+function isJSONSchema(schema) {
+    if (typeof schema !== 'object' || schema === null)
+        return false;
+    const s = schema;
+    return '$schema' in s || 'type' in s || 'properties' in s || 'items' in s || 'allOf' in s || 'anyOf' in s || 'oneOf' in s;
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/detection/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../src/detection/json-schema.ts"],"names":[],"mappings":";;AAAA,oCAIC;AAJD,SAAgB,YAAY,CAAC,MAAe;IAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,CAAC,GAAG,MAAiC,CAAC;IAC5C,OAAO,SAAS,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;AAC5H,CAAC"}

package/dist/detection/typebox.d.ts

@@ -0,0 +1,2 @@
+export declare function isTypeBoxSchema(schema: unknown): boolean;
+//# sourceMappingURL=typebox.d.ts.map

package/dist/detection/typebox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typebox.d.ts","sourceRoot":"","sources":["../../src/detection/typebox.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAMxD"}

package/dist/detection/typebox.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTypeBoxSchema = isTypeBoxSchema;
+const TypeBoxKind = Symbol.for('TypeBox.Kind');
+function isTypeBoxSchema(schema) {
+    return (typeof schema === 'object' &&
+        schema !== null &&
+        TypeBoxKind in schema);
+}
+//# sourceMappingURL=typebox.js.map

package/dist/detection/typebox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typebox.js","sourceRoot":"","sources":["../../src/detection/typebox.ts"],"names":[],"mappings":";;AAEA,0CAMC;AARD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAE/C,SAAgB,eAAe,CAAC,MAAe;IAC7C,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,WAAW,IAAK,MAAiB,CAClC,CAAC;AACJ,CAAC"}

package/dist/detection/zod.d.ts

@@ -0,0 +1,2 @@
+export declare function isZodSchema(schema: unknown): boolean;
+//# sourceMappingURL=zod.d.ts.map

package/dist/detection/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/detection/zod.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAQpD"}

package/dist/detection/zod.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isZodSchema = isZodSchema;
+function isZodSchema(schema) {
+    return (typeof schema === 'object' &&
+        schema !== null &&
+        '_def' in schema &&
+        'safeParse' in schema &&
+        typeof schema.safeParse === 'function');
+}
+//# sourceMappingURL=zod.js.map

package/dist/detection/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/detection/zod.ts"],"names":[],"mappings":";;AAAA,kCAQC;AARD,SAAgB,WAAW,CAAC,MAAe;IACzC,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,MAAM,IAAI,MAAM;QAChB,WAAW,IAAI,MAAM;QACrB,OAAQ,MAAkC,CAAC,SAAS,KAAK,UAAU,CACpE,CAAC;AACJ,CAAC"}

package/dist/guard-tools.d.ts

@@ -0,0 +1,3 @@
+import type { GuardToolsOptions } from './types';
+export declare function guardTools<T extends Record<string, unknown>>(toolMap: Record<string, (...args: unknown[]) => Promise<unknown>>, schemaMap: Record<string, unknown>, options?: GuardToolsOptions<T>): Record<string, (...args: unknown[]) => Promise<unknown>>;
+//# sourceMappingURL=guard-tools.d.ts.map

package/dist/guard-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-tools.d.ts","sourceRoot":"","sources":["../src/guard-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGjD,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,EACjE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAsB1D"}

package/dist/guard-tools.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guardTools = guardTools;
+const guard_1 = require("./guard");
+function guardTools(toolMap, schemaMap, options) {
+    const result = {};
+    for (const [toolName, toolFn] of Object.entries(toolMap)) {
+        const schema = schemaMap[toolName];
+        if (!schema) {
+            // No schema for this tool — pass through unchanged
+            result[toolName] = toolFn;
+            continue;
+        }
+        const toolSpecificOptions = options?.toolOptions?.[toolName];
+        const mergedOptions = {
+            ...options,
+            ...toolSpecificOptions,
+            toolName,
+        };
+        result[toolName] = (0, guard_1.guard)(toolFn, schema, mergedOptions);
+    }
+    return result;
+}
+//# sourceMappingURL=guard-tools.js.map

package/dist/guard-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-tools.js","sourceRoot":"","sources":["../src/guard-tools.ts"],"names":[],"mappings":";;AAGA,gCA0BC;AA5BD,mCAAgC;AAEhC,SAAgB,UAAU,CACxB,OAAiE,EACjE,SAAkC,EAClC,OAA8B;IAE9B,MAAM,MAAM,GAA6D,EAAE,CAAC;IAE5E,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,mDAAmD;YACnD,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,mBAAmB,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC7D,MAAM,aAAa,GAAG;YACpB,GAAG,OAAO;YACV,GAAG,mBAAmB;YACtB,QAAQ;SACT,CAAC;QAEF,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAA,aAAK,EAAC,MAAM,EAAE,MAAM,EAAE,aAA2C,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/guard.d.ts

@@ -0,0 +1,3 @@
+import type { GuardOptions } from './types';
+export declare function guard<T>(toolFn: (...args: unknown[]) => Promise<unknown>, schema: unknown, options?: GuardOptions<T>): (...args: unknown[]) => Promise<T>;
+//# sourceMappingURL=guard.d.ts.map

package/dist/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../src/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI5C,wBAAgB,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAChD,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAoBpC"}

package/dist/guard.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guard = guard;
+const index_1 = require("./validation/index");
+const index_2 = require("./strategies/index");
+function guard(toolFn, schema, options) {
+    return async (...args) => {
+        const raw = await toolFn(...args);
+        // Some strategies (strip-extra) preprocess the output before validation
+        const preprocessed = (0, index_2.preprocessForStrategy)(raw, schema, options ?? {});
+        const result = (0, index_1.validateOutput)(preprocessed, schema);
+        if (result.success) {
+            if (options?.onValidationPass) {
+                options.onValidationPass(result.data);
+            }
+            return result.data;
+        }
+        if (options?.onValidationFail) {
+            options.onValidationFail(result.violations);
+        }
+        return (0, index_2.applyStrategy)(result, preprocessed, schema, options ?? {});
+    };
+}
+//# sourceMappingURL=guard.js.map

package/dist/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../src/guard.ts"],"names":[],"mappings":";;AAIA,sBAwBC;AA3BD,8CAAoD;AACpD,8CAA0E;AAE1E,SAAgB,KAAK,CACnB,MAAgD,EAChD,MAAe,EACf,OAAyB;IAEzB,OAAO,KAAK,EAAE,GAAG,IAAe,EAAc,EAAE;QAC9C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QAClC,wEAAwE;QACxE,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,GAAG,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,IAAA,sBAAc,EAAI,YAAY,EAAE,MAAM,CAAC,CAAC;QAEvD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,OAAO,EAAE,gBAAgB,EAAE,CAAC;gBAC9B,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QAED,IAAI,OAAO,EAAE,gBAAgB,EAAE,CAAC;YAC9B,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,IAAA,qBAAa,EAAI,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { ViolationSeverity, ViolationCode, Violation, ValidationResult, LLMValidationError, FailureStrategy, CoercionConfig, GuardOptions, Guard, GuardToolsOptions, } from './types';
+export { ValidationError } from './types';
+export { detectSchema, isZodSchema, isTypeBoxSchema, isJSONSchema } from './detection/index';
+export type { SchemaType, DetectedSchema } from './detection/index';
+export { guard } from './guard';
+export { validate } from './validate';
+export { createGuard } from './create-guard';
+export { guardTools } from './guard-tools';
+export { validateOutput } from './validation/index';
+export { buildViolation, buildPath, formatViolationMessage, formatViolationsForLLM, } from './violations/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAC7D,kBAAkB,EAAE,eAAe,EAAE,cAAc,EACnD,YAAY,EAAE,KAAK,EAAE,iBAAiB,GACvC,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7F,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,SAAS,EACT,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatViolationsForLLM = exports.formatViolationMessage = exports.buildPath = exports.buildViolation = exports.validateOutput = exports.guardTools = exports.createGuard = exports.validate = exports.guard = exports.isJSONSchema = exports.isTypeBoxSchema = exports.isZodSchema = exports.detectSchema = exports.ValidationError = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return types_1.ValidationError; } });
+var index_1 = require("./detection/index");
+Object.defineProperty(exports, "detectSchema", { enumerable: true, get: function () { return index_1.detectSchema; } });
+Object.defineProperty(exports, "isZodSchema", { enumerable: true, get: function () { return index_1.isZodSchema; } });
+Object.defineProperty(exports, "isTypeBoxSchema", { enumerable: true, get: function () { return index_1.isTypeBoxSchema; } });
+Object.defineProperty(exports, "isJSONSchema", { enumerable: true, get: function () { return index_1.isJSONSchema; } });
+var guard_1 = require("./guard");
+Object.defineProperty(exports, "guard", { enumerable: true, get: function () { return guard_1.guard; } });
+var validate_1 = require("./validate");
+Object.defineProperty(exports, "validate", { enumerable: true, get: function () { return validate_1.validate; } });
+var create_guard_1 = require("./create-guard");
+Object.defineProperty(exports, "createGuard", { enumerable: true, get: function () { return create_guard_1.createGuard; } });
+var guard_tools_1 = require("./guard-tools");
+Object.defineProperty(exports, "guardTools", { enumerable: true, get: function () { return guard_tools_1.guardTools; } });
+var index_2 = require("./validation/index");
+Object.defineProperty(exports, "validateOutput", { enumerable: true, get: function () { return index_2.validateOutput; } });
+var index_3 = require("./violations/index");
+Object.defineProperty(exports, "buildViolation", { enumerable: true, get: function () { return index_3.buildViolation; } });
+Object.defineProperty(exports, "buildPath", { enumerable: true, get: function () { return index_3.buildPath; } });
+Object.defineProperty(exports, "formatViolationMessage", { enumerable: true, get: function () { return index_3.formatViolationMessage; } });
+Object.defineProperty(exports, "formatViolationsForLLM", { enumerable: true, get: function () { return index_3.formatViolationsForLLM; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAKA,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AACxB,2CAA6F;AAApF,qGAAA,YAAY,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,qGAAA,YAAY,OAAA;AAGjE,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AACnB,4CAAoD;AAA3C,uGAAA,cAAc,OAAA;AACvB,4CAK4B;AAJ1B,uGAAA,cAAc,OAAA;AACd,kGAAA,SAAS,OAAA;AACT,+GAAA,sBAAsB,OAAA;AACtB,+GAAA,sBAAsB,OAAA"}

package/dist/strategies/index.d.ts

@@ -0,0 +1,4 @@
+import type { GuardOptions, ValidationResult } from '../types';
+export declare function preprocessForStrategy<T>(output: unknown, schema: unknown, options: GuardOptions<T>): unknown;
+export declare function applyStrategy<T>(validationResult: ValidationResult<T>, output: unknown, schema: unknown, options: GuardOptions<T>): T;
+//# sourceMappingURL=index.d.ts.map

package/dist/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,gBAAgB,EAAa,MAAM,UAAU,CAAC;AAkJ3F,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,OAAO,CAMT;AAED,wBAAgB,aAAa,CAAC,CAAC,EAC7B,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,EACrC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,CAAC,CAuFH"}