@kindgi/schema 0.0.0-bootstrap.0 → 0.1.0

package/dist/registry.d.ts

@@ -0,0 +1,86 @@
+import type { Result } from '@kindgi/types';
+import type { SchemaError } from './errors.js';
+/**
+ * A registry of loaded and compiled JSON Schemas, keyed by `$id`.
+ *
+ * The registry pre-compiles a validator for every schema at construction time,
+ * so `validate()` is a hot-path operation with no per-call compilation cost.
+ * Cross-schema `$ref`s (e.g. pack manifest → tool schema) are resolved
+ * automatically because all schemas are registered before compilation.
+ */
+export interface SpecRegistry {
+    /**
+     * Validate `data` against the schema with the given `$id`.
+     *
+     * The generic `T` is a caller-asserted type — the runtime does not verify
+     * it beyond schema conformance. Consumers pair the `$id` with a manually
+     * maintained TypeScript type (or, later, a codegen'd one).
+     *
+     * @example
+     * const r = registry.validate<Flow>('https://kindgi.com/schemas/v1/flow.schema.json', input);
+     * if (r.kind === 'ok') { runOnGraph(r.value); }
+     */
+    validate<T = unknown>(id: string, data: unknown): Result<T, SchemaError>;
+    /** Retrieve the raw parsed schema JSON registered at `$id`. */
+    getSchema(id: string): Result<unknown, SchemaError>;
+    /** Return every registered schema `$id` in insertion order. */
+    ids(): readonly string[];
+}
+/**
+ * Build a SpecRegistry from an array of already-parsed schema documents.
+ *
+ * All schemas are registered with the Ajv instance FIRST (so cross-schema
+ * `$ref`s can resolve), then validators are compiled and cached.
+ *
+ * Returns `err` on the first failure — this is fail-fast on purpose. If a
+ * spec is broken, downstream validators are meaningless.
+ */
+export declare function createSpecRegistry(schemas: readonly unknown[]): Result<SpecRegistry, SchemaError>;
+/**
+ * A compiled inline JSON Schema. Unlike `SpecRegistry`, which stores schemas
+ * addressed by `$id`, this represents a single anonymous schema (e.g. a loop
+ * node's `outputSchema`) whose validator has already been compiled.
+ *
+ * Callers compile once (at flow load time) and validate many times (each
+ * loop iteration).
+ */
+export interface CompiledInlineSchema {
+    /**
+     * Validate `data`. Returns the original value on success (typed as `T`
+     * for caller convenience — the runtime does not verify the T assertion
+     * beyond schema conformance).
+     */
+    validate<T = unknown>(data: unknown): Result<T, ValidationErrorLike>;
+    /** The raw schema JSON, for round-tripping or debugging. */
+    readonly source: unknown;
+}
+/**
+ * Structural shape of a validation failure, decoupled from the `SchemaError`
+ * discriminated union (which requires an `id`). Consumers that want to
+ * surface an inline-schema validation failure typically wrap this in their
+ * own domain error.
+ */
+export interface ValidationErrorLike {
+    readonly code: 'validation-error';
+    readonly message: string;
+    readonly errors: readonly unknown[];
+}
+/**
+ * Compile a single anonymous JSON Schema (draft 2020-12) into a reusable
+ * validator. Returns `err` if the schema itself is malformed (Ajv rejects
+ * it), which is how the flow loader surfaces `LoopOutputSchemaError` and
+ * similar load-time diagnostics.
+ *
+ * Design note: this is intentionally decoupled from `SpecRegistry` — inline
+ * schemas don't have a `$id` and don't need cross-schema `$ref` resolution.
+ */
+export declare function compileInlineSchema(schema: unknown): Result<CompiledInlineSchema, SchemaError>;
+/**
+ * Load a SpecRegistry from a directory of `*.schema.json` files.
+ *
+ * Reads every `*.schema.json` in the directory (non-recursive), parses each,
+ * and delegates to `createSpecRegistry`. Files are loaded in sorted order for
+ * deterministic behavior across environments.
+ */
+export declare function loadSpecRegistry(dir: string): Promise<Result<SpecRegistry, SchemaError>>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAY/C;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAEzE,+DAA+D;IAC/D,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAEpD,+DAA+D;IAC/D,GAAG,IAAI,SAAS,MAAM,EAAE,CAAC;CAC1B;AA2ED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,CAiEjG;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IACrE,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,oBAAoB,EAAE,WAAW,CAAC,CA0C9F;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAmD9F"}

package/dist/registry.js

@@ -0,0 +1,261 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import * as addFormatsModule from 'ajv-formats';
+// Ajv 8's `/dist/2020` entry exports the Ajv2020 class as a named export.
+// The named-import form is stable across ESM/CJS/bundler interop; the default form is not.
+import { Ajv2020 } from 'ajv/dist/2020.js';
+const addFormatsRaw = addFormatsModule;
+const addFormats = typeof addFormatsRaw === 'function'
+    ? addFormatsRaw
+    : addFormatsRaw.default;
+function notFound(id) {
+    return {
+        code: 'schema-not-found',
+        message: `No schema registered with $id: ${id}`,
+        id,
+    };
+}
+function makeRegistry(state) {
+    return {
+        validate(id, data) {
+            const validator = state.validators.get(id);
+            if (validator === undefined) {
+                return { kind: 'err', error: notFound(id) };
+            }
+            if (validator(data)) {
+                return { kind: 'ok', value: data };
+            }
+            return {
+                kind: 'err',
+                error: {
+                    code: 'validation-error',
+                    message: `Data does not validate against ${id}`,
+                    id,
+                    errors: validator.errors ?? [],
+                },
+            };
+        },
+        getSchema(id) {
+            const schema = state.schemas.get(id);
+            if (schema === undefined) {
+                return { kind: 'err', error: notFound(id) };
+            }
+            return { kind: 'ok', value: schema };
+        },
+        ids() {
+            return Array.from(state.schemas.keys());
+        },
+    };
+}
+function extractId(schema) {
+    if (typeof schema !== 'object' || schema === null || !('$id' in schema)) {
+        return {
+            kind: 'err',
+            error: {
+                code: 'schema-compile-error',
+                message: 'Schema is missing top-level $id',
+                id: '<unknown>',
+                cause: schema,
+            },
+        };
+    }
+    const id = schema.$id;
+    if (typeof id !== 'string' || id.length === 0) {
+        return {
+            kind: 'err',
+            error: {
+                code: 'schema-compile-error',
+                message: 'Schema $id is not a non-empty string',
+                id: String(id),
+                cause: schema,
+            },
+        };
+    }
+    return { kind: 'ok', value: id };
+}
+/**
+ * Build a SpecRegistry from an array of already-parsed schema documents.
+ *
+ * All schemas are registered with the Ajv instance FIRST (so cross-schema
+ * `$ref`s can resolve), then validators are compiled and cached.
+ *
+ * Returns `err` on the first failure — this is fail-fast on purpose. If a
+ * spec is broken, downstream validators are meaningless.
+ */
+export function createSpecRegistry(schemas) {
+    const ajv = new Ajv2020({
+        strict: true,
+        allErrors: true,
+        allowUnionTypes: false,
+    });
+    addFormats(ajv);
+    const schemaMap = new Map();
+    // Pass 1: register every schema so $refs can resolve during compilation.
+    for (const schema of schemas) {
+        const idResult = extractId(schema);
+        if (idResult.kind === 'err') {
+            return idResult;
+        }
+        const id = idResult.value;
+        try {
+            ajv.addSchema(schema, id);
+            schemaMap.set(id, schema);
+        }
+        catch (cause) {
+            return {
+                kind: 'err',
+                error: {
+                    code: 'schema-compile-error',
+                    message: `Failed to register schema with $id ${id}`,
+                    id,
+                    cause,
+                },
+            };
+        }
+    }
+    // Pass 2: compile validators, now that cross-refs resolve.
+    const validators = new Map();
+    for (const id of schemaMap.keys()) {
+        let validator;
+        try {
+            validator = ajv.getSchema(id);
+        }
+        catch (cause) {
+            return {
+                kind: 'err',
+                error: {
+                    code: 'schema-compile-error',
+                    message: `Failed to compile validator for $id ${id}`,
+                    id,
+                    cause,
+                },
+            };
+        }
+        if (validator === undefined) {
+            return {
+                kind: 'err',
+                error: {
+                    code: 'schema-compile-error',
+                    message: `Ajv did not return a validator for $id ${id}`,
+                    id,
+                    cause: null,
+                },
+            };
+        }
+        validators.set(id, validator);
+    }
+    return { kind: 'ok', value: makeRegistry({ schemas: schemaMap, validators }) };
+}
+/**
+ * Compile a single anonymous JSON Schema (draft 2020-12) into a reusable
+ * validator. Returns `err` if the schema itself is malformed (Ajv rejects
+ * it), which is how the flow loader surfaces `LoopOutputSchemaError` and
+ * similar load-time diagnostics.
+ *
+ * Design note: this is intentionally decoupled from `SpecRegistry` — inline
+ * schemas don't have a `$id` and don't need cross-schema `$ref` resolution.
+ */
+export function compileInlineSchema(schema) {
+    const ajv = new Ajv2020({
+        strict: true,
+        allErrors: true,
+        allowUnionTypes: false,
+    });
+    addFormats(ajv);
+    let validator;
+    try {
+        validator = ajv.compile(schema);
+    }
+    catch (cause) {
+        return {
+            kind: 'err',
+            error: {
+                code: 'schema-compile-error',
+                message: `Inline schema failed to compile: ${cause?.message ?? String(cause)}`,
+                id: '<inline>',
+                cause,
+            },
+        };
+    }
+    return {
+        kind: 'ok',
+        value: {
+            source: schema,
+            validate(data) {
+                if (validator(data)) {
+                    return { kind: 'ok', value: data };
+                }
+                return {
+                    kind: 'err',
+                    error: {
+                        code: 'validation-error',
+                        message: 'Data does not validate against inline schema',
+                        errors: validator.errors ?? [],
+                    },
+                };
+            },
+        },
+    };
+}
+/**
+ * Load a SpecRegistry from a directory of `*.schema.json` files.
+ *
+ * Reads every `*.schema.json` in the directory (non-recursive), parses each,
+ * and delegates to `createSpecRegistry`. Files are loaded in sorted order for
+ * deterministic behavior across environments.
+ */
+export async function loadSpecRegistry(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch (cause) {
+        return {
+            kind: 'err',
+            error: {
+                code: 'schema-load-error',
+                message: `Cannot read specs directory: ${dir}`,
+                path: dir,
+                cause,
+            },
+        };
+    }
+    const files = entries.filter((n) => n.endsWith('.schema.json')).sort();
+    const schemas = [];
+    for (const file of files) {
+        const fullPath = join(dir, file);
+        let raw;
+        try {
+            raw = await readFile(fullPath, 'utf-8');
+        }
+        catch (cause) {
+            return {
+                kind: 'err',
+                error: {
+                    code: 'schema-load-error',
+                    message: `Cannot read schema file: ${fullPath}`,
+                    path: fullPath,
+                    cause,
+                },
+            };
+        }
+        try {
+            schemas.push(JSON.parse(raw));
+        }
+        catch (cause) {
+            return {
+                kind: 'err',
+                error: {
+                    code: 'schema-parse-error',
+                    message: `Invalid JSON in schema file: ${fullPath}`,
+                    path: fullPath,
+                    cause,
+                },
+            };
+        }
+    }
+    return createSpecRegistry(schemas);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,30 @@
+import type { Result, SchemaMajor, Semver } from '@kindgi/types';
+import type { SchemaError } from './errors.js';
+/** Parsed version information from a schema's `$id` and `$comment`. */
+export interface SchemaVersion {
+    /** Major version, parsed from the `$id` URL path segment (e.g. `v1` → 1). */
+    readonly major: SchemaMajor;
+    /** Full semver, parsed from `$comment: "schema-version: X.Y.Z"`. */
+    readonly semver: Semver;
+}
+/**
+ * Extract the schema version from a schema document.
+ *
+ * Requires BOTH:
+ *   - A `$id` matching `https://kindgi.com/schemas/v<N>/<name>.schema.json`.
+ *   - A `$comment: "schema-version: X.Y.Z"` line (semver, with optional prerelease).
+ *
+ * The major version comes from `$id`; the full semver comes from `$comment`.
+ * A mismatch between them (e.g. `$id` says `v2` but comment says `1.0.0`) is
+ * NOT detected here — that's a separate lint responsibility.
+ *
+ * @example
+ * // SPECS_SCHEMAS_DIR from '@kindgi/specs'
+ * const schema = JSON.parse(await readFile(join(SPECS_SCHEMAS_DIR, 'flow.schema.json'), 'utf-8'));
+ * const result = versionOf(schema);
+ * if (result.kind === 'ok') {
+ *   console.log(result.value.major, result.value.semver);
+ * }
+ */
+export declare function versionOf(schema: unknown): Result<SchemaVersion, SchemaError>;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AASD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,aAAa,EAAE,WAAW,CAAC,CAmD7E"}

package/dist/version.js

@@ -0,0 +1,70 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+const ID_PATTERN = /^https:\/\/kindgi\.com\/schemas\/v(\d+)\/([a-z][a-z0-9-]*)\.schema\.json$/;
+const COMMENT_PATTERN = /^schema-version: (\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?)$/;
+function compileError(id, message, cause = null) {
+    return { code: 'schema-compile-error', message, id, cause };
+}
+/**
+ * Extract the schema version from a schema document.
+ *
+ * Requires BOTH:
+ *   - A `$id` matching `https://kindgi.com/schemas/v<N>/<name>.schema.json`.
+ *   - A `$comment: "schema-version: X.Y.Z"` line (semver, with optional prerelease).
+ *
+ * The major version comes from `$id`; the full semver comes from `$comment`.
+ * A mismatch between them (e.g. `$id` says `v2` but comment says `1.0.0`) is
+ * NOT detected here — that's a separate lint responsibility.
+ *
+ * @example
+ * // SPECS_SCHEMAS_DIR from '@kindgi/specs'
+ * const schema = JSON.parse(await readFile(join(SPECS_SCHEMAS_DIR, 'flow.schema.json'), 'utf-8'));
+ * const result = versionOf(schema);
+ * if (result.kind === 'ok') {
+ *   console.log(result.value.major, result.value.semver);
+ * }
+ */
+export function versionOf(schema) {
+    if (typeof schema !== 'object' || schema === null) {
+        return { kind: 'err', error: compileError('<unknown>', 'Schema is not an object', schema) };
+    }
+    const s = schema;
+    if (typeof s.$id !== 'string' || s.$id.length === 0) {
+        return { kind: 'err', error: compileError('<unknown>', 'Schema $id is missing or empty') };
+    }
+    const idMatch = ID_PATTERN.exec(s.$id);
+    if (idMatch === null) {
+        return {
+            kind: 'err',
+            error: compileError(s.$id, `Schema $id does not match https://kindgi.com/schemas/v<N>/<name>.schema.json: ${s.$id}`),
+        };
+    }
+    const majorStr = idMatch[1];
+    if (majorStr === undefined) {
+        // Regex guarantees the capture, but TS narrowing requires the check.
+        return { kind: 'err', error: compileError(s.$id, 'Unreachable: $id regex captured no major') };
+    }
+    const major = Number(majorStr);
+    if (typeof s.$comment !== 'string') {
+        return {
+            kind: 'err',
+            error: compileError(s.$id, 'Schema $comment is missing (expected `schema-version: X.Y.Z`)'),
+        };
+    }
+    const commentMatch = COMMENT_PATTERN.exec(s.$comment);
+    if (commentMatch === null) {
+        return {
+            kind: 'err',
+            error: compileError(s.$id, `Schema $comment does not match \`schema-version: X.Y.Z\`: ${s.$comment}`),
+        };
+    }
+    const semverStr = commentMatch[1];
+    if (semverStr === undefined) {
+        return {
+            kind: 'err',
+            error: compileError(s.$id, 'Unreachable: $comment regex captured no semver'),
+        };
+    }
+    return { kind: 'ok', value: { major, semver: semverStr } };
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAcjC,MAAM,UAAU,GAAG,2EAA2E,CAAC;AAC/F,MAAM,eAAe,GAAG,0EAA0E,CAAC;AAEnG,SAAS,YAAY,CAAC,EAAU,EAAE,OAAe,EAAE,QAAiB,IAAI;IACtE,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,MAAe;IACvC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,WAAW,EAAE,yBAAyB,EAAE,MAAM,CAAC,EAAE,CAAC;IAC9F,CAAC;IACD,MAAM,CAAC,GAAG,MAA+C,CAAC;IAE1D,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,WAAW,EAAE,gCAAgC,CAAC,EAAE,CAAC;IAC7F,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,YAAY,CACjB,CAAC,CAAC,GAAG,EACL,iFAAiF,CAAC,CAAC,GAAG,EAAE,CACzF;SACF,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,qEAAqE;QACrE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,0CAA0C,CAAC,EAAE,CAAC;IACjG,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAgB,CAAC;IAE9C,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,+DAA+D,CAAC;SAC5F,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,YAAY,CACjB,CAAC,CAAC,GAAG,EACL,6DAA6D,CAAC,CAAC,QAAQ,EAAE,CAC1E;SACF,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,gDAAgD,CAAC;SAC7E,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAmB,EAAE,EAAE,CAAC;AACvE,CAAC"}

package/dist/zod.d.ts

@@ -0,0 +1,154 @@
+import type { Result } from '@kindgi/types';
+import type { InvalidZodConversionError } from './errors.js';
+/**
+ * Wire-authoritative JSON Schema shape. Matches the JsonSchema alias used by
+ * `@kindgi/tools` and `@kindgi/guardrails` — a Draft 2020-12 object
+ * with `type`, `properties`, etc. Kept as `Readonly<Record<string, unknown>>`
+ * here to avoid importing any consumer type.
+ */
+export type JSONSchemaObject = Readonly<Record<string, unknown>>;
+/**
+ * Structural shape of a Zod v4 schema. We deliberately avoid importing
+ * `zod` at type-position here so `@kindgi/schema` keeps zero runtime OR
+ * peer dependency on Zod — the utils compile even in a workspace that
+ * never installs `zod`. Downstream packages that DO peer-depend on `zod`
+ * import `z.ZodType` themselves and pass instances through this alias.
+ *
+ * Zod v4 schemas carry `_zod` (internals) + `~standard` (Standard Schema
+ * spec adapter) at the type-level; both properties are stable across
+ * Zod v4's minor releases.
+ */
+export interface ZodLikeSchema {
+    readonly _zod: unknown;
+    readonly '~standard': unknown;
+}
+/**
+ * The alternate authoring input accepted at framework boundaries. Callers
+ * pass either a JSON Schema object (Draft 2020-12) or a Zod v4 schema.
+ *
+ * Non-TS consumers see no change — the framework converts Zod to JSON
+ * Schema at author time via `toJSONSchema`, and the wire form is always
+ * JSON Schema.
+ */
+export type AnySchema = JSONSchemaObject | ZodLikeSchema;
+/**
+ * Structural detection. Returns true iff `value` looks like a Zod v4
+ * schema — `_zod` property present AND `~standard` present. Purely
+ * structural: never imports from `zod` at runtime, so the check is safe
+ * even when zod is not installed at all.
+ *
+ * The check is deliberately narrow — a JSON Schema object never has a
+ * `_zod` property, so the two authoring surfaces cannot collide.
+ */
+export declare function isZodSchema(value: unknown): value is ZodLikeSchema;
+/**
+ * Structural detection for a JSON Schema object. Cheap heuristic — accepts
+ * any object that isn't a Zod schema. JSON Schema validity (Draft 2020-12
+ * compilability) is checked separately by each consumer via Ajv.
+ */
+export declare function isJsonSchemaObject(value: unknown): value is JSONSchemaObject;
+/**
+ * Author-time detection: how to interpret an `AnySchema` value. Used by
+ * downstream packages when they need to route on the authoring surface —
+ * for example, to preserve the original Zod schema for TS `z.infer<...>`
+ * while caching the converted JSON Schema for wire use.
+ */
+export type SchemaKind = 'zod' | 'json-schema';
+/** Return `'zod'` for Zod schemas, `'json-schema'` for JSON Schema objects. */
+export declare function schemaKindOf(value: AnySchema): SchemaKind;
+/**
+ * Which side of a schema a JSON Schema describes:
+ *
+ *   - `input` — what a caller may send. A field with a `.default()` is
+ *     optional (the default fills it). Tool inputs, guardrail config.
+ *   - `output` — what parsing produces. A defaulted field is always
+ *     present. Tool outputs, an agent's typed answer.
+ *
+ * Every conversion names one: they differ exactly where Zod defaults,
+ * so the wrong one silently requires fields callers may leave out.
+ */
+export type SchemaIo = 'input' | 'output';
+/**
+ * Convert an `AnySchema` to its authoritative JSON Schema wire form.
+ *
+ * - Zod schema → calls `z.toJSONSchema(schema, { io })` (Zod v4 native —
+ *   no third-party `zod-to-json-schema` dependency).
+ * - JSON Schema object → returned as-is.
+ * - Anything else → `err`.
+ *
+ * Conversion failures (unrepresentable Zod types like `.transform()`,
+ * cycles without a registry, function schemas) surface as
+ * `InvalidZodConversionError` with the underlying cause preserved. No
+ * throws escape.
+ *
+ * Zod is imported dynamically the first time a Zod schema flows through:
+ * a workspace that never uses Zod never pays the import cost, and one
+ * that hasn't installed the peer dep gets a clean typed error instead of
+ * a module-resolution crash.
+ */
+export declare function toJSONSchema(schema: AnySchema, io: SchemaIo): Promise<Result<JSONSchemaObject, InvalidZodConversionError>>;
+/**
+ * Synchronous variant — for defineTool / defineGuardrail sites that must
+ * stay sync. Requires the caller to have already resolved the converter
+ * (via `loadZodConverter()`) at package init. When Zod is not installed
+ * but a Zod schema is passed, returns `err` with `peer-dep-missing`
+ * distinguishable by its `cause`.
+ */
+export declare function toJSONSchemaSync(schema: AnySchema, converter: ZodConverter | undefined, io: SchemaIo): Result<JSONSchemaObject, InvalidZodConversionError>;
+/**
+ * A resolved handle on `z.toJSONSchema`. Passed to `toJSONSchemaSync`
+ * from consumers that eagerly loaded the peer dep once at package init.
+ */
+export type ZodConverter = (schema: ZodLikeSchema, params?: {
+    readonly io?: SchemaIo;
+}) => JSONSchemaObject;
+/** A problem `parseWithSchema` found, as the schema reported it. */
+export interface SchemaIssue {
+    readonly message: string;
+    readonly path?: readonly unknown[];
+}
+/**
+ * Parse a value with a Zod schema through its Standard Schema interface
+ * (`'~standard'.validate`): the parsed value — defaults filled,
+ * transforms and refinements applied — or the issues. What a handler
+ * typed with `z.infer` of the schema expects to receive.
+ */
+export declare function parseWithSchema(schema: ZodLikeSchema, value: unknown): Promise<{
+    readonly kind: 'ok';
+    readonly value: unknown;
+} | {
+    readonly kind: 'err';
+    readonly issues: readonly SchemaIssue[];
+}>;
+/**
+ * Load `z.toJSONSchema` from the `zod` peer dependency. Returns
+ * `undefined` when zod is not installed — callers decide whether that's
+ * an error or a silent no-op (JSON-Schema-only workspaces are legitimate).
+ *
+ * The result is cached — repeat calls resolve synchronously after the
+ * first.
+ */
+export declare function loadZodConverter(): Promise<ZodConverter | undefined>;
+/**
+ * Synchronous variant of `loadZodConverter`. Uses Node's `createRequire`
+ * so sync authoring surfaces (`defineTool`, `defineGuardrail`) can stay
+ * sync even on their first Zod-authored call. Falls back cleanly when
+ * `zod` isn't installed: returns `undefined` and callers surface the
+ * missing peer dep as a typed error at the boundary.
+ *
+ * Runtime: Node ≥18 (both CJS and ESM entry points to zod resolve
+ * through the same `createRequire` handle). No behavior change for
+ * workspaces that never author with Zod — the first sync call to
+ * `loadZodConverterSync` returns `undefined` cheaply.
+ */
+export declare function loadZodConverterSync(): ZodConverter | undefined;
+/**
+ * Test-only: reset the cached converter so tests can exercise both the
+ * peer-dep-present and peer-dep-missing branches. Not part of the public
+ * API — callers outside this package must not depend on this being
+ * present.
+ *
+ * @internal
+ */
+export declare function __resetZodConverterCacheForTests(): void;
+//# sourceMappingURL=zod.d.ts.map

package/dist/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAO7D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAIlE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAI5E;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,aAAa,CAAC;AAE/C,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAEzD;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,QAAQ,GACX,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,CAAC,CAmB9D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,YAAY,GAAG,SAAS,EACnC,EAAE,EAAE,QAAQ,GACX,MAAM,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,CA6BrD;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,MAAM,EAAE,aAAa,EACrB,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAA;CAAE,KAChC,gBAAgB,CAAC;AAEtB,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,OAAO,GACb,OAAO,CACN;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,CACpE,CAkBA;AAID;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAc1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,YAAY,GAAG,SAAS,CAc/D;AAmBD;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}