apcore-js 0.5.0 → 0.6.0

package/dist/schema/loader.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SchemaLoader — primary entry point for the schema system.
+ *
+ * Uses TypeBox for schema representation. Since TypeBox schemas ARE JSON Schema,
+ * the conversion layer is minimal.
+ */
+import { type TSchema } from '@sinclair/typebox';
+import type { Config } from '../config.js';
+import type { ResolvedSchema, SchemaDefinition } from './types.js';
+export declare class SchemaLoader {
+    private _config;
+    private _schemasDir;
+    private _resolver;
+    private _schemaCache;
+    private _modelCache;
+    constructor(config: Config, schemasDir?: string | null);
+    load(moduleId: string): SchemaDefinition;
+    resolve(schemaDef: SchemaDefinition): [ResolvedSchema, ResolvedSchema];
+    getSchema(moduleId: string, nativeInputSchema?: TSchema | null, nativeOutputSchema?: TSchema | null): [ResolvedSchema, ResolvedSchema];
+    private _loadAndResolve;
+    private _wrapNative;
+    clearCache(): void;
+}
+/**
+ * Convert a JSON Schema dict to a TypeBox TSchema.
+ * Since TypeBox schemas ARE JSON Schema, this wraps the raw object
+ * so it can be used with Value.Check/Value.Decode.
+ */
+export declare function jsonSchemaToTypeBox(schema: Record<string, unknown>): TSchema;
+//# sourceMappingURL=loader.d.ts.map

package/dist/schema/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/schema/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AASnE,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,WAAW,CAA4D;gBAEnE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAYtD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAkDxC,OAAO,CAAC,SAAS,EAAE,gBAAgB,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC;IAsBtE,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,iBAAiB,CAAC,EAAE,OAAO,GAAG,IAAI,EAClC,kBAAkB,CAAC,EAAE,OAAO,GAAG,IAAI,GAClC,CAAC,cAAc,EAAE,cAAc,CAAC;IA0CnC,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,WAAW;IAoBnB,UAAU,IAAI,IAAI;CAKnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAkB5E"}

package/dist/schema/loader.js

@@ -0,0 +1,260 @@
+/**
+ * SchemaLoader — primary entry point for the schema system.
+ *
+ * Uses TypeBox for schema representation. Since TypeBox schemas ARE JSON Schema,
+ * the conversion layer is minimal.
+ */
+import { Type } from '@sinclair/typebox';
+import yaml from 'js-yaml';
+import { SchemaNotFoundError, SchemaParseError } from '../errors.js';
+import { RefResolver } from './ref-resolver.js';
+import { SchemaStrategy } from './types.js';
+// Lazy-load Node.js built-in modules for browser compatibility
+let _nodeFs = null;
+let _nodePath = null;
+try {
+    _nodeFs = await import('node:fs');
+}
+catch { /* browser environment */ }
+try {
+    _nodePath = await import('node:path');
+}
+catch { /* browser environment */ }
+export class SchemaLoader {
+    _config;
+    _schemasDir;
+    _resolver;
+    _schemaCache = new Map();
+    _modelCache = new Map();
+    constructor(config, schemasDir) {
+        const { resolve } = _nodePath;
+        this._config = config;
+        if (schemasDir != null) {
+            this._schemasDir = resolve(schemasDir);
+        }
+        else {
+            this._schemasDir = resolve(config.get('schema.root', './schemas'));
+        }
+        const maxDepth = config.get('schema.max_ref_depth', 32);
+        this._resolver = new RefResolver(this._schemasDir, maxDepth);
+    }
+    load(moduleId) {
+        const cached = this._schemaCache.get(moduleId);
+        if (cached)
+            return cached;
+        const { existsSync, readFileSync } = _nodeFs;
+        const { join } = _nodePath;
+        const filePath = join(this._schemasDir, moduleId.replace(/\./g, '/') + '.schema.yaml');
+        if (!existsSync(filePath)) {
+            throw new SchemaNotFoundError(moduleId);
+        }
+        let data;
+        try {
+            data = yaml.load(readFileSync(filePath, 'utf-8'));
+        }
+        catch (e) {
+            throw new SchemaParseError(`Invalid YAML in schema for '${moduleId}': ${e}`);
+        }
+        if (data === null || data === undefined || typeof data !== 'object' || Array.isArray(data)) {
+            throw new SchemaParseError(`Schema file for '${moduleId}' is empty or not a mapping`);
+        }
+        const dataObj = data;
+        for (const fieldName of ['input_schema', 'output_schema', 'description']) {
+            if (!(fieldName in dataObj)) {
+                throw new SchemaParseError(`Missing required field: ${fieldName} in schema for '${moduleId}'`);
+            }
+        }
+        const definitions = {
+            ...(dataObj['definitions'] ?? {}),
+            ...(dataObj['$defs'] ?? {}),
+        };
+        const sd = {
+            moduleId: dataObj['module_id'] ?? moduleId,
+            description: dataObj['description'],
+            inputSchema: dataObj['input_schema'],
+            outputSchema: dataObj['output_schema'],
+            errorSchema: dataObj['error_schema'] ?? null,
+            definitions,
+            version: dataObj['version'] ?? '1.0.0',
+            documentation: dataObj['documentation'] ?? null,
+            schemaUrl: dataObj['$schema'] ?? null,
+        };
+        this._schemaCache.set(moduleId, sd);
+        return sd;
+    }
+    resolve(schemaDef) {
+        const resolvedInput = this._resolver.resolve(schemaDef.inputSchema);
+        const resolvedOutput = this._resolver.resolve(schemaDef.outputSchema);
+        const inputSchema = jsonSchemaToTypeBox(resolvedInput);
+        const outputSchema = jsonSchemaToTypeBox(resolvedOutput);
+        const inputRs = {
+            jsonSchema: resolvedInput,
+            schema: inputSchema,
+            moduleId: schemaDef.moduleId,
+            direction: 'input',
+        };
+        const outputRs = {
+            jsonSchema: resolvedOutput,
+            schema: outputSchema,
+            moduleId: schemaDef.moduleId,
+            direction: 'output',
+        };
+        return [inputRs, outputRs];
+    }
+    getSchema(moduleId, nativeInputSchema, nativeOutputSchema) {
+        const cached = this._modelCache.get(moduleId);
+        if (cached)
+            return cached;
+        const strategyMap = {
+            yaml_first: SchemaStrategy.YamlFirst,
+            native_first: SchemaStrategy.NativeFirst,
+            yaml_only: SchemaStrategy.YamlOnly,
+        };
+        const rawStrategy = this._config.get('schema.strategy', 'yaml_first');
+        const strategy = strategyMap[rawStrategy] ?? SchemaStrategy.YamlFirst;
+        let result = null;
+        if (strategy === SchemaStrategy.YamlFirst) {
+            try {
+                result = this._loadAndResolve(moduleId);
+            }
+            catch (e) {
+                if (e instanceof SchemaNotFoundError && nativeInputSchema && nativeOutputSchema) {
+                    result = this._wrapNative(moduleId, nativeInputSchema, nativeOutputSchema);
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+        else if (strategy === SchemaStrategy.NativeFirst) {
+            if (nativeInputSchema && nativeOutputSchema) {
+                result = this._wrapNative(moduleId, nativeInputSchema, nativeOutputSchema);
+            }
+            else {
+                result = this._loadAndResolve(moduleId);
+            }
+        }
+        else if (strategy === SchemaStrategy.YamlOnly) {
+            result = this._loadAndResolve(moduleId);
+        }
+        if (result === null) {
+            throw new SchemaNotFoundError(moduleId);
+        }
+        this._modelCache.set(moduleId, result);
+        return result;
+    }
+    _loadAndResolve(moduleId) {
+        const cached = this._modelCache.get(moduleId);
+        if (cached)
+            return cached;
+        const sd = this.load(moduleId);
+        const result = this.resolve(sd);
+        this._modelCache.set(moduleId, result);
+        return result;
+    }
+    _wrapNative(moduleId, inputSchema, outputSchema) {
+        const inputRs = {
+            jsonSchema: inputSchema,
+            schema: inputSchema,
+            moduleId,
+            direction: 'input',
+        };
+        const outputRs = {
+            jsonSchema: outputSchema,
+            schema: outputSchema,
+            moduleId,
+            direction: 'output',
+        };
+        return [inputRs, outputRs];
+    }
+    clearCache() {
+        this._schemaCache.clear();
+        this._modelCache.clear();
+        this._resolver.clearCache();
+    }
+}
+/**
+ * Convert a JSON Schema dict to a TypeBox TSchema.
+ * Since TypeBox schemas ARE JSON Schema, this wraps the raw object
+ * so it can be used with Value.Check/Value.Decode.
+ */
+export function jsonSchemaToTypeBox(schema) {
+    const schemaType = schema['type'];
+    let result;
+    if (schemaType === 'object')
+        result = convertObjectSchema(schema);
+    else if (schemaType === 'array')
+        result = convertArraySchema(schema);
+    else if (schemaType === 'string')
+        result = convertStringSchema(schema);
+    else if (schemaType === 'integer')
+        result = convertNumericSchema(schema, Type.Integer);
+    else if (schemaType === 'number')
+        result = convertNumericSchema(schema, Type.Number);
+    else if (schemaType === 'boolean')
+        result = Type.Boolean();
+    else if (schemaType === 'null')
+        result = Type.Null();
+    else
+        result = convertCombinatorSchema(schema);
+    // Preserve JSON Schema metadata
+    if (typeof schema['description'] === 'string')
+        result['description'] = schema['description'];
+    if (typeof schema['title'] === 'string')
+        result['title'] = schema['title'];
+    return result;
+}
+function convertObjectSchema(schema) {
+    const properties = schema['properties'];
+    const required = new Set(schema['required'] ?? []);
+    if (properties) {
+        const typeboxProps = {};
+        for (const [name, propSchema] of Object.entries(properties)) {
+            const propType = jsonSchemaToTypeBox(propSchema);
+            typeboxProps[name] = required.has(name) ? propType : Type.Optional(propType);
+        }
+        return Type.Object(typeboxProps);
+    }
+    return Type.Record(Type.String(), Type.Unknown());
+}
+function convertArraySchema(schema) {
+    const items = schema['items'];
+    return items ? Type.Array(jsonSchemaToTypeBox(items)) : Type.Array(Type.Unknown());
+}
+function convertStringSchema(schema) {
+    const opts = {};
+    for (const key of ['minLength', 'maxLength', 'pattern', 'format']) {
+        if (key in schema)
+            opts[key] = schema[key];
+    }
+    return Type.String(opts);
+}
+function convertNumericSchema(schema, factory) {
+    const opts = {};
+    for (const key of ['minimum', 'maximum', 'exclusiveMinimum', 'exclusiveMaximum', 'multipleOf']) {
+        if (key in schema)
+            opts[key] = schema[key];
+    }
+    return factory(opts);
+}
+function convertCombinatorSchema(schema) {
+    if ('enum' in schema) {
+        const values = schema['enum'];
+        return Type.Union(values.map((v) => v === null ? Type.Null() : Type.Literal(v)));
+    }
+    if ('const' in schema) {
+        const value = schema['const'];
+        return value === null ? Type.Null() : Type.Literal(value);
+    }
+    if ('oneOf' in schema) {
+        return Type.Union(schema['oneOf'].map(jsonSchemaToTypeBox));
+    }
+    if ('anyOf' in schema) {
+        return Type.Union(schema['anyOf'].map(jsonSchemaToTypeBox));
+    }
+    if ('allOf' in schema) {
+        return Type.Intersect(schema['allOf'].map(jsonSchemaToTypeBox));
+    }
+    return Type.Unknown();
+}
+//# sourceMappingURL=loader.js.map

package/dist/schema/loader.js.map

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

package/dist/schema/ref-resolver.d.ts

@@ -0,0 +1,19 @@
+/**
+ * $ref resolution for JSON Schema documents following Algorithm A05.
+ */
+export declare class RefResolver {
+    private _schemasDir;
+    private _maxDepth;
+    private _fileCache;
+    constructor(schemasDir: string, maxDepth?: number);
+    resolve(schema: Record<string, unknown>, currentFile?: string | null): Record<string, unknown>;
+    resolveRef(refString: string, currentFile: string | null, visitedRefs?: Set<string>, depth?: number, siblingKeys?: Record<string, unknown> | null): unknown;
+    private _resolveNode;
+    private _parseRef;
+    private _assertWithinSchemasDir;
+    private _convertCanonicalToPath;
+    private _resolveJsonPointer;
+    private _loadFile;
+    clearCache(): void;
+}
+//# sourceMappingURL=ref-resolver.d.ts.map

package/dist/schema/ref-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-resolver.d.ts","sourceRoot":"","sources":["../../src/schema/ref-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAmD;gBAEzD,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW;IAMrD,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAW9F,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,KAAK,GAAE,MAAU,EACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC3C,OAAO;IAyCV,OAAO,CAAC,YAAY;IA+CpB,OAAO,CAAC,SAAS;IA0BjB,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,SAAS;IA4CjB,UAAU,IAAI,IAAI;CAGnB"}

package/dist/schema/ref-resolver.js

@@ -0,0 +1,212 @@
+/**
+ * $ref resolution for JSON Schema documents following Algorithm A05.
+ */
+import yaml from 'js-yaml';
+import { SchemaCircularRefError, SchemaNotFoundError, SchemaParseError } from '../errors.js';
+import { deepCopy } from '../utils/index.js';
+// Lazy-load Node.js built-in modules for browser compatibility
+let _nodeFs = null;
+let _nodePath = null;
+try {
+    _nodeFs = await import('node:fs');
+}
+catch { /* browser environment */ }
+try {
+    _nodePath = await import('node:path');
+}
+catch { /* browser environment */ }
+const INLINE_SENTINEL = '__inline__';
+export class RefResolver {
+    _schemasDir;
+    _maxDepth;
+    _fileCache = new Map();
+    constructor(schemasDir, maxDepth = 32) {
+        const { resolve } = _nodePath;
+        this._schemasDir = resolve(schemasDir);
+        this._maxDepth = maxDepth;
+    }
+    resolve(schema, currentFile) {
+        const result = deepCopy(schema);
+        this._fileCache.set(INLINE_SENTINEL, result);
+        try {
+            this._resolveNode(result, currentFile ?? null, new Set(), 0);
+        }
+        finally {
+            this._fileCache.delete(INLINE_SENTINEL);
+        }
+        return result;
+    }
+    resolveRef(refString, currentFile, visitedRefs, depth = 0, siblingKeys) {
+        const visited = visitedRefs ?? new Set();
+        if (visited.has(refString)) {
+            throw new SchemaCircularRefError(refString);
+        }
+        if (depth >= this._maxDepth) {
+            throw new SchemaCircularRefError(`Maximum reference depth ${this._maxDepth} exceeded resolving: ${refString}`);
+        }
+        visited.add(refString);
+        const [filePath, jsonPointer] = this._parseRef(refString, currentFile);
+        const document = this._loadFile(filePath);
+        const target = this._resolveJsonPointer(document, jsonPointer, refString);
+        let result = deepCopy(target);
+        if (siblingKeys && typeof result === 'object' && result !== null && !Array.isArray(result)) {
+            Object.assign(result, siblingKeys);
+        }
+        const effectiveFile = filePath === INLINE_SENTINEL ? currentFile : filePath;
+        if (typeof result === 'object' && result !== null && !Array.isArray(result)) {
+            const resultObj = result;
+            if ('$ref' in resultObj) {
+                const nestedRef = resultObj['$ref'];
+                delete resultObj['$ref'];
+                const nestedSiblings = Object.keys(resultObj).length > 0 ? { ...resultObj } : null;
+                result = this.resolveRef(nestedRef, effectiveFile, visited, depth + 1, nestedSiblings);
+            }
+        }
+        this._resolveNode(result, effectiveFile, visited, depth + 1);
+        return result;
+    }
+    _resolveNode(node, currentFile, visitedRefs, depth) {
+        if (typeof node === 'object' && node !== null && !Array.isArray(node)) {
+            const nodeObj = node;
+            if ('$ref' in nodeObj) {
+                const refString = nodeObj['$ref'];
+                const siblingKeys = {};
+                for (const [k, v] of Object.entries(nodeObj)) {
+                    if (k !== '$ref')
+                        siblingKeys[k] = v;
+                }
+                const resolved = this.resolveRef(refString, currentFile, new Set(visitedRefs), depth, Object.keys(siblingKeys).length > 0 ? siblingKeys : null);
+                // Clear and replace
+                for (const key of Object.keys(nodeObj))
+                    delete nodeObj[key];
+                if (typeof resolved === 'object' && resolved !== null && !Array.isArray(resolved)) {
+                    Object.assign(nodeObj, resolved);
+                }
+                else {
+                    return resolved;
+                }
+            }
+            else {
+                for (const key of Object.keys(nodeObj)) {
+                    const result = this._resolveNode(nodeObj[key], currentFile, visitedRefs, depth);
+                    if (result !== nodeObj[key]) {
+                        nodeObj[key] = result;
+                    }
+                }
+            }
+        }
+        else if (Array.isArray(node)) {
+            for (let i = 0; i < node.length; i++) {
+                const result = this._resolveNode(node[i], currentFile, visitedRefs, depth);
+                if (result !== node[i]) {
+                    node[i] = result;
+                }
+            }
+        }
+        return node;
+    }
+    _parseRef(refString, currentFile) {
+        const { resolve, dirname } = _nodePath;
+        if (refString.startsWith('#')) {
+            const pointer = refString.slice(1);
+            if (currentFile)
+                return [currentFile, pointer];
+            return [INLINE_SENTINEL, pointer];
+        }
+        if (refString.startsWith('apcore://')) {
+            return this._convertCanonicalToPath(refString);
+        }
+        if (refString.includes('#')) {
+            const [filePart, pointer] = refString.split('#', 2);
+            const base = currentFile ? dirname(currentFile) : this._schemasDir;
+            const resolvedPath = resolve(base, filePart);
+            this._assertWithinSchemasDir(resolvedPath, refString);
+            return [resolvedPath, pointer];
+        }
+        const base = currentFile ? dirname(currentFile) : this._schemasDir;
+        const resolvedPath = resolve(base, refString);
+        this._assertWithinSchemasDir(resolvedPath, refString);
+        return [resolvedPath, ''];
+    }
+    _assertWithinSchemasDir(resolvedPath, refString) {
+        if (!resolvedPath.startsWith(this._schemasDir + '/') && resolvedPath !== this._schemasDir) {
+            throw new SchemaNotFoundError(`Reference '${refString}' resolves outside schemas directory`);
+        }
+    }
+    _convertCanonicalToPath(uri) {
+        const { resolve } = _nodePath;
+        const remainder = uri.slice('apcore://'.length);
+        const parts = remainder.split('/');
+        const canonicalId = parts[0];
+        const pointerParts = parts.slice(1);
+        const fileRel = canonicalId.replace(/\./g, '/') + '.schema.yaml';
+        const filePath = resolve(this._schemasDir, fileRel);
+        const pointer = pointerParts.length > 0 ? '/' + pointerParts.join('/') : '';
+        return [filePath, pointer];
+    }
+    _resolveJsonPointer(document, pointer, refString) {
+        if (!pointer)
+            return document;
+        let segments = pointer.split('/');
+        if (segments.length > 0 && segments[0] === '') {
+            segments = segments.slice(1);
+        }
+        let current = document;
+        for (const rawSegment of segments) {
+            const segment = rawSegment.replace(/~1/g, '/').replace(/~0/g, '~');
+            if (typeof current === 'object' && current !== null && !Array.isArray(current)) {
+                const obj = current;
+                if (segment in obj) {
+                    current = obj[segment];
+                }
+                else {
+                    throw new SchemaNotFoundError(`${refString} (segment '${segment}' not found)`);
+                }
+            }
+            else {
+                throw new SchemaNotFoundError(`${refString} (segment '${segment}' not found)`);
+            }
+        }
+        return current;
+    }
+    _loadFile(filePath) {
+        if (filePath === INLINE_SENTINEL) {
+            return this._fileCache.get(INLINE_SENTINEL) ?? {};
+        }
+        const { resolve } = _nodePath;
+        const { existsSync, readFileSync } = _nodeFs;
+        const resolved = resolve(filePath);
+        const cached = this._fileCache.get(resolved);
+        if (cached !== undefined)
+            return cached;
+        if (!existsSync(resolved)) {
+            throw new SchemaNotFoundError(resolved);
+        }
+        const content = readFileSync(resolved, 'utf-8');
+        if (!content.trim()) {
+            this._fileCache.set(resolved, {});
+            return {};
+        }
+        let parsed;
+        try {
+            parsed = yaml.load(content);
+        }
+        catch (e) {
+            throw new SchemaParseError(`Invalid YAML in ${resolved}: ${e}`);
+        }
+        if (parsed === null || parsed === undefined) {
+            this._fileCache.set(resolved, {});
+            return {};
+        }
+        if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new SchemaParseError(`Schema file ${resolved} must be a YAML mapping, got ${typeof parsed}`);
+        }
+        const result = parsed;
+        this._fileCache.set(resolved, result);
+        return result;
+    }
+    clearCache() {
+        this._fileCache.clear();
+    }
+}
+//# sourceMappingURL=ref-resolver.js.map

package/dist/schema/ref-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-resolver.js","sourceRoot":"","sources":["../../src/schema/ref-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,+DAA+D;AAC/D,IAAI,OAAO,GAAoC,IAAI,CAAC;AACpD,IAAI,SAAS,GAAsC,IAAI,CAAC;AACxD,IAAI,CAAC;IAAC,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;AAC9E,IAAI,CAAC;IAAC,SAAS,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;AAElF,MAAM,eAAe,GAAG,YAAY,CAAC;AAErC,MAAM,OAAO,WAAW;IACd,WAAW,CAAS;IACpB,SAAS,CAAS;IAClB,UAAU,GAAyC,IAAI,GAAG,EAAE,CAAC;IAErE,YAAY,UAAkB,EAAE,WAAmB,EAAE;QACnD,MAAM,EAAE,OAAO,EAAE,GAAG,SAAU,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,OAAO,CAAC,MAA+B,EAAE,WAA2B;QAClE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,IAAI,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,UAAU,CACR,SAAiB,EACjB,WAA0B,EAC1B,WAAyB,EACzB,QAAgB,CAAC,EACjB,WAA4C;QAE5C,MAAM,OAAO,GAAG,WAAW,IAAI,IAAI,GAAG,EAAU,CAAC;QAEjD,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,sBAAsB,CAC9B,2BAA2B,IAAI,CAAC,SAAS,wBAAwB,SAAS,EAAE,CAC7E,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEvB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;QAE1E,IAAI,MAAM,GAAY,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEvC,IAAI,WAAW,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3F,MAAM,CAAC,MAAM,CAAC,MAAiC,EAAE,WAAW,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,aAAa,GAAG,QAAQ,KAAK,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE5E,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5E,MAAM,SAAS,GAAG,MAAiC,CAAC;YACpD,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC;gBACxB,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAW,CAAC;gBAC9C,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;gBACzB,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBACnF,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,YAAY,CAClB,IAAa,EACb,WAA0B,EAC1B,WAAwB,EACxB,KAAa;QAEb,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,OAAO,GAAG,IAA+B,CAAC;YAChD,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;gBACtB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAW,CAAC;gBAC5C,MAAM,WAAW,GAA4B,EAAE,CAAC;gBAChD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC7C,IAAI,CAAC,KAAK,MAAM;wBAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACvC,CAAC;gBACD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAC9B,SAAS,EACT,WAAW,EACX,IAAI,GAAG,CAAC,WAAW,CAAC,EACpB,KAAK,EACL,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CACzD,CAAC;gBACF,oBAAoB;gBACpB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;oBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC5D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAClF,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAmC,CAAC,CAAC;gBAC9D,CAAC;qBAAM,CAAC;oBACN,OAAO,QAAQ,CAAC;gBAClB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBACvC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;oBAChF,IAAI,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;oBACxB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;gBAC3E,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvB,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,SAAS,CAAC,SAAiB,EAAE,WAA0B;QAC7D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,SAAU,CAAC;QACxC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACnC,IAAI,WAAW;gBAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/C,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;YACnE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7C,IAAI,CAAC,uBAAuB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;YACtD,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;QACnE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,uBAAuB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QACtD,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAEO,uBAAuB,CAAC,YAAoB,EAAE,SAAiB;QACrE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,IAAI,YAAY,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1F,MAAM,IAAI,mBAAmB,CAC3B,cAAc,SAAS,sCAAsC,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,uBAAuB,CAAC,GAAW;QACzC,MAAM,EAAE,OAAO,EAAE,GAAG,SAAU,CAAC;QAC/B,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEpC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,cAAc,CAAC;QACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAEpD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IAEO,mBAAmB,CAAC,QAAiB,EAAE,OAAe,EAAE,SAAiB;QAC/E,IAAI,CAAC,OAAO;YAAE,OAAO,QAAQ,CAAC;QAE9B,IAAI,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAC9C,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,OAAO,GAAG,QAAQ,CAAC;QACvB,KAAK,MAAM,UAAU,IAAI,QAAQ,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACnE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/E,MAAM,GAAG,GAAG,OAAkC,CAAC;gBAC/C,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;oBACnB,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;gBACzB,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,mBAAmB,CAAC,GAAG,SAAS,cAAc,OAAO,cAAc,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,mBAAmB,CAAC,GAAG,SAAS,cAAc,OAAO,cAAc,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,SAAS,CAAC,QAAgB;QAChC,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QACpD,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,GAAG,SAAU,CAAC;QAC/B,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,OAAQ,CAAC;QAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QAExC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,gBAAgB,CAAC,mBAAmB,QAAQ,KAAK,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,gBAAgB,CACxB,eAAe,QAAQ,gCAAgC,OAAO,MAAM,EAAE,CACvE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAiC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,UAAU;QACR,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/schema/strict.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Strict mode conversion for JSON Schemas (Algorithm A23).
+ */
+export declare function toStrictSchema(schema: Record<string, unknown>): Record<string, unknown>;
+export declare function applyLlmDescriptions(node: unknown): void;
+export declare function stripExtensions(node: unknown): void;
+//# sourceMappingURL=strict.d.ts.map

package/dist/schema/strict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict.d.ts","sourceRoot":"","sources":["../../src/schema/strict.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKvF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CA8BxD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAwBnD"}