apcore-js 0.5.0 → 0.6.0

package/dist/registry/scanner.js

@@ -0,0 +1,164 @@
+/**
+ * Directory scanner for discovering TypeScript/JavaScript extension modules.
+ */
+import { ConfigError, ConfigNotFoundError } from '../errors.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 SKIP_DIR_NAMES = new Set(['node_modules', '__pycache__']);
+const VALID_EXTENSIONS = new Set(['.ts', '.js']);
+const SKIP_SUFFIXES = ['.d.ts', '.test.ts', '.test.js', '.spec.ts', '.spec.js'];
+function existsAndIsDir(p) {
+    try {
+        return _nodeFs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function scanExtensions(root, maxDepth = 8, followSymlinks = false) {
+    const { readdirSync, statSync, lstatSync, realpathSync } = _nodeFs;
+    const { resolve, relative, join, extname, basename, sep } = _nodePath;
+    const rootResolved = resolve(root);
+    if (!existsAndIsDir(rootResolved)) {
+        throw new ConfigNotFoundError(rootResolved);
+    }
+    const visitedRealPaths = new Set([realpathSync(rootResolved)]);
+    const results = [];
+    const seenIds = new Map();
+    const seenIdsLower = new Map();
+    function scanDir(dirPath, depth) {
+        if (depth > maxDepth) {
+            console.warn(`[apcore:scanner] Max depth ${maxDepth} exceeded at: ${dirPath}`);
+            return;
+        }
+        let entries;
+        try {
+            entries = readdirSync(dirPath);
+        }
+        catch {
+            console.warn(`[apcore:scanner] Cannot read directory: ${dirPath}`);
+            return;
+        }
+        for (const name of entries) {
+            if (name.startsWith('.') || name.startsWith('_'))
+                continue;
+            if (SKIP_DIR_NAMES.has(name))
+                continue;
+            const entryPath = join(dirPath, name);
+            let lstat;
+            try {
+                lstat = lstatSync(entryPath);
+            }
+            catch {
+                console.warn(`[apcore:scanner] Cannot stat entry: ${entryPath}`);
+                continue;
+            }
+            const isSymlink = lstat.isSymbolicLink();
+            let isDir;
+            let isFile;
+            if (isSymlink) {
+                if (!followSymlinks)
+                    continue;
+                const real = realpathSync(entryPath);
+                if (visitedRealPaths.has(real))
+                    continue;
+                visitedRealPaths.add(real);
+                // Resolve the symlink target to check if it's a dir or file
+                let targetStat;
+                try {
+                    targetStat = statSync(entryPath);
+                }
+                catch {
+                    console.warn(`[apcore:scanner] Cannot resolve symlink target: ${entryPath}`);
+                    continue;
+                }
+                isDir = targetStat.isDirectory();
+                isFile = targetStat.isFile();
+            }
+            else {
+                isDir = lstat.isDirectory();
+                isFile = lstat.isFile();
+            }
+            if (isDir) {
+                scanDir(entryPath, depth + 1);
+            }
+            else if (isFile) {
+                const ext = extname(name);
+                if (!VALID_EXTENSIONS.has(ext))
+                    continue;
+                if (SKIP_SUFFIXES.some((s) => name.endsWith(s)))
+                    continue;
+                const rel = relative(rootResolved, entryPath);
+                const canonicalId = rel
+                    .replace(new RegExp(`\\${sep}`, 'g'), '.')
+                    .replace(/\.(ts|js)$/, '');
+                if (seenIds.has(canonicalId)) {
+                    console.warn(`[apcore:scanner] Duplicate module ID '${canonicalId}', skipping: ${entryPath}`);
+                    continue;
+                }
+                const lowerId = canonicalId.toLowerCase();
+                if (seenIdsLower.has(lowerId) && seenIdsLower.get(lowerId) !== canonicalId) {
+                    console.warn(`[apcore:scanner] Case collision: '${canonicalId}' vs '${seenIdsLower.get(lowerId)}'`);
+                }
+                // Check for companion metadata file
+                const stem = basename(entryPath, ext);
+                const metaPath = join(dirPath, stem + '_meta.yaml');
+                let metaPathResult = null;
+                try {
+                    if (statSync(metaPath).isFile())
+                        metaPathResult = metaPath;
+                }
+                catch {
+                    // no meta file
+                }
+                seenIds.set(canonicalId, entryPath);
+                seenIdsLower.set(lowerId, canonicalId);
+                results.push({
+                    filePath: entryPath,
+                    canonicalId,
+                    metaPath: metaPathResult,
+                    namespace: null,
+                });
+            }
+        }
+    }
+    scanDir(rootResolved, 1);
+    return results;
+}
+export function scanMultiRoot(roots, maxDepth = 8, followSymlinks = false) {
+    const { basename } = _nodePath;
+    const allResults = [];
+    const seenNamespaces = new Set();
+    const resolved = [];
+    for (const entry of roots) {
+        const rootPath = entry['root'];
+        const namespace = entry['namespace'] || basename(rootPath);
+        if (seenNamespaces.has(namespace)) {
+            throw new ConfigError(`Duplicate namespace: '${namespace}'`);
+        }
+        seenNamespaces.add(namespace);
+        resolved.push([rootPath, namespace]);
+    }
+    for (const [rootPath, namespace] of resolved) {
+        const modules = scanExtensions(rootPath, maxDepth, followSymlinks);
+        for (const m of modules) {
+            allResults.push({
+                filePath: m.filePath,
+                canonicalId: `${namespace}.${m.canonicalId}`,
+                metaPath: m.metaPath,
+                namespace,
+            });
+        }
+    }
+    return allResults;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/registry/scanner.js.map

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

package/dist/registry/schema-export.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Schema query and export functions for the registry system.
+ */
+import type { Registry } from './registry.js';
+export declare function getSchema(registry: Registry, moduleId: string): Record<string, unknown> | null;
+export declare function exportSchema(registry: Registry, moduleId: string, format?: string, strict?: boolean, compact?: boolean, profile?: string | null): string;
+export declare function getAllSchemas(registry: Registry): Record<string, Record<string, unknown>>;
+export declare function exportAllSchemas(registry: Registry, format?: string, strict?: boolean, compact?: boolean, profile?: string | null): string;
+//# sourceMappingURL=schema-export.d.ts.map

package/dist/registry/schema-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-export.d.ts","sourceRoot":"","sources":["../../src/registry/schema-export.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA8B9F;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAe,EACvB,MAAM,GAAE,OAAe,EACvB,OAAO,GAAE,OAAe,EACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,MAAM,CAoBR;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CASzF;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,MAAM,GAAE,MAAe,EACvB,MAAM,GAAE,OAAe,EACvB,OAAO,GAAE,OAAe,EACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,MAAM,CAiBR"}

package/dist/registry/schema-export.js

@@ -0,0 +1,132 @@
+/**
+ * Schema query and export functions for the registry system.
+ */
+import yaml from 'js-yaml';
+import { InvalidInputError, ModuleNotFoundError } from '../errors.js';
+import { deepCopy } from '../utils/index.js';
+import { SchemaExporter } from '../schema/exporter.js';
+import { stripExtensions, toStrictSchema } from '../schema/strict.js';
+import { ExportProfile } from '../schema/types.js';
+export function getSchema(registry, moduleId) {
+    const module = registry.get(moduleId);
+    if (module === null)
+        return null;
+    const mod = module;
+    // TypeBox schemas are already JSON Schema
+    const inputSchemaDict = mod['inputSchema'] ?? {};
+    const outputSchemaDict = mod['outputSchema'] ?? {};
+    const annotations = mod['annotations'];
+    let annotationsDict = null;
+    if (annotations) {
+        annotationsDict = { ...annotations };
+    }
+    const examplesRaw = mod['examples'] ?? [];
+    const examplesList = examplesRaw.map((ex) => ({ ...ex }));
+    return {
+        module_id: moduleId,
+        name: mod['name'] ?? null,
+        description: mod['description'] ?? '',
+        version: mod['version'] ?? '1.0.0',
+        tags: [...(mod['tags'] ?? [])],
+        input_schema: inputSchemaDict,
+        output_schema: outputSchemaDict,
+        annotations: annotationsDict,
+        examples: examplesList,
+    };
+}
+export function exportSchema(registry, moduleId, format = 'json', strict = false, compact = false, profile) {
+    const schemaDict = getSchema(registry, moduleId);
+    if (schemaDict === null) {
+        throw new ModuleNotFoundError(moduleId);
+    }
+    if (profile != null) {
+        return exportWithProfile(registry, moduleId, schemaDict, profile, format);
+    }
+    const result = deepCopy(schemaDict);
+    if (strict) {
+        result['input_schema'] = toStrictSchema(result['input_schema']);
+        result['output_schema'] = toStrictSchema(result['output_schema']);
+    }
+    else if (compact) {
+        applyCompact(result);
+    }
+    return serialize(result, format);
+}
+export function getAllSchemas(registry) {
+    const result = {};
+    for (const moduleId of registry.moduleIds) {
+        const schema = getSchema(registry, moduleId);
+        if (schema !== null) {
+            result[moduleId] = schema;
+        }
+    }
+    return result;
+}
+export function exportAllSchemas(registry, format = 'json', strict = false, compact = false, profile) {
+    const allSchemas = getAllSchemas(registry);
+    if (strict || compact) {
+        for (const [moduleId, schema] of Object.entries(allSchemas)) {
+            const result = deepCopy(schema);
+            if (strict) {
+                result['input_schema'] = toStrictSchema(result['input_schema']);
+                result['output_schema'] = toStrictSchema(result['output_schema']);
+            }
+            else if (compact) {
+                applyCompact(result);
+            }
+            allSchemas[moduleId] = result;
+        }
+    }
+    return serialize(allSchemas, format);
+}
+function exportWithProfile(registry, moduleId, schemaDict, profile, format) {
+    const schemaDef = {
+        moduleId,
+        description: schemaDict['description'],
+        inputSchema: schemaDict['input_schema'],
+        outputSchema: schemaDict['output_schema'],
+        definitions: {},
+        version: schemaDict['version'] ?? '1.0.0',
+    };
+    const module = registry.get(moduleId);
+    const annotations = module ? module['annotations'] : undefined;
+    const examples = module ? module['examples'] ?? [] : [];
+    const name = module ? module['name'] : undefined;
+    const validProfiles = new Set(Object.values(ExportProfile));
+    if (!validProfiles.has(profile)) {
+        throw new InvalidInputError(`Invalid export profile: '${profile}'. Must be one of: ${[...validProfiles].join(', ')}`);
+    }
+    const exported = new SchemaExporter().export(schemaDef, profile, annotations, examples, name);
+    return serialize(exported, format);
+}
+function applyCompact(schemaDict) {
+    const desc = schemaDict['description'];
+    if (desc) {
+        schemaDict['description'] = truncateDescription(desc);
+    }
+    stripExtensions(schemaDict['input_schema'] ?? {});
+    stripExtensions(schemaDict['output_schema'] ?? {});
+    delete schemaDict['documentation'];
+    delete schemaDict['examples'];
+}
+function truncateDescription(description) {
+    const dotSpace = description.indexOf('. ');
+    const newline = description.indexOf('\n');
+    const candidates = [];
+    if (dotSpace >= 0)
+        candidates.push(dotSpace + 1);
+    if (newline >= 0)
+        candidates.push(newline);
+    if (candidates.length > 0) {
+        const cut = Math.min(...candidates);
+        return description.slice(0, cut).trimEnd();
+    }
+    return description;
+}
+function serialize(data, format) {
+    if (format === 'yaml') {
+        return yaml.dump(data, { flowLevel: -1 });
+    }
+    return JSON.stringify(data, null, 2);
+}
+//# sourceMappingURL=schema-export.js.map

package/dist/registry/schema-export.js.map

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

package/dist/registry/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Registry types: ModuleDescriptor, DiscoveredModule, DependencyInfo.
+ */
+import type { ModuleAnnotations, ModuleExample } from '../module.js';
+export interface ModuleDescriptor {
+    moduleId: string;
+    name: string | null;
+    description: string;
+    documentation: string | null;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+    version: string;
+    tags: string[];
+    annotations: ModuleAnnotations | null;
+    examples: ModuleExample[];
+    metadata: Record<string, unknown>;
+}
+export interface DiscoveredModule {
+    filePath: string;
+    canonicalId: string;
+    metaPath: string | null;
+    namespace: string | null;
+}
+export interface DependencyInfo {
+    moduleId: string;
+    version: string | null;
+    optional: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/registry/types.js

@@ -0,0 +1,5 @@
+/**
+ * Registry types: ModuleDescriptor, DiscoveredModule, DependencyInfo.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/registry/types.js.map

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

package/dist/registry/validation.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Module validation for the registry system.
+ *
+ * In TypeScript, modules use TypeBox TSchema (which are plain objects) instead of
+ * Pydantic BaseModel classes. Duck-type checks validate that the module has
+ * inputSchema, outputSchema, description, and execute.
+ */
+export declare function validateModule(moduleOrClass: unknown): string[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/registry/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/registry/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,cAAc,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,EAAE,CA6B/D"}

package/dist/registry/validation.js

@@ -0,0 +1,33 @@
+/**
+ * Module validation for the registry system.
+ *
+ * In TypeScript, modules use TypeBox TSchema (which are plain objects) instead of
+ * Pydantic BaseModel classes. Duck-type checks validate that the module has
+ * inputSchema, outputSchema, description, and execute.
+ */
+export function validateModule(moduleOrClass) {
+    const errors = [];
+    const obj = moduleOrClass;
+    // Check inputSchema
+    const inputSchema = obj['inputSchema'] ?? obj.constructor?.['inputSchema'];
+    if (inputSchema == null || typeof inputSchema !== 'object') {
+        errors.push('Missing or invalid inputSchema: must be a TSchema object');
+    }
+    // Check outputSchema
+    const outputSchema = obj['outputSchema'] ?? obj.constructor?.['outputSchema'];
+    if (outputSchema == null || typeof outputSchema !== 'object') {
+        errors.push('Missing or invalid outputSchema: must be a TSchema object');
+    }
+    // Check description
+    const description = obj['description'];
+    if (!description || typeof description !== 'string') {
+        errors.push('Missing or empty description');
+    }
+    // Check execute
+    const execute = obj['execute'];
+    if (execute == null || typeof execute !== 'function') {
+        errors.push('Missing execute method');
+    }
+    return errors;
+}
+//# sourceMappingURL=validation.js.map

package/dist/registry/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/registry/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,cAAc,CAAC,aAAsB;IACnD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,aAAwC,CAAC;IAErD,oBAAoB;IACpB,MAAM,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC,IAAK,GAAG,CAAC,WAAkD,EAAE,CAAC,aAAa,CAAC,CAAC;IACnH,IAAI,WAAW,IAAI,IAAI,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IAC1E,CAAC;IAED,qBAAqB;IACrB,MAAM,YAAY,GAAG,GAAG,CAAC,cAAc,CAAC,IAAK,GAAG,CAAC,WAAkD,EAAE,CAAC,cAAc,CAAC,CAAC;IACtH,IAAI,YAAY,IAAI,IAAI,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC3E,CAAC;IAED,oBAAoB;IACpB,MAAM,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;IACvC,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IAED,gBAAgB;IAChB,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/B,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/schema/annotations.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Annotation conflict resolution — merge YAML and code metadata.
+ */
+import type { ModuleAnnotations, ModuleExample } from '../module.js';
+export declare function mergeAnnotations(yamlAnnotations: Record<string, unknown> | null | undefined, codeAnnotations: ModuleAnnotations | null | undefined): ModuleAnnotations;
+export declare function mergeExamples(yamlExamples: Array<Record<string, unknown>> | null | undefined, codeExamples: ModuleExample[] | null | undefined): ModuleExample[];
+export declare function mergeMetadata(yamlMetadata: Record<string, unknown> | null | undefined, codeMetadata: Record<string, unknown> | null | undefined): Record<string, unknown>;
+//# sourceMappingURL=annotations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/schema/annotations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAYrE,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3D,eAAe,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GACpD,iBAAiB,CAqBnB;AAED,wBAAgB,aAAa,CAC3B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/D,YAAY,EAAE,aAAa,EAAE,GAAG,IAAI,GAAG,SAAS,GAC/C,aAAa,EAAE,CAWjB;AAED,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACxD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACvD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/schema/annotations.js

@@ -0,0 +1,52 @@
+/**
+ * Annotation conflict resolution — merge YAML and code metadata.
+ */
+import { DEFAULT_ANNOTATIONS } from '../module.js';
+const ANNOTATION_FIELDS = [
+    'readonly',
+    'destructive',
+    'idempotent',
+    'requiresApproval',
+    'openWorld',
+    'streaming',
+];
+export function mergeAnnotations(yamlAnnotations, codeAnnotations) {
+    const values = {};
+    for (const f of ANNOTATION_FIELDS) {
+        values[f] = DEFAULT_ANNOTATIONS[f];
+    }
+    if (codeAnnotations != null) {
+        for (const f of ANNOTATION_FIELDS) {
+            values[f] = codeAnnotations[f];
+        }
+    }
+    if (yamlAnnotations != null) {
+        for (const [key, val] of Object.entries(yamlAnnotations)) {
+            if (ANNOTATION_FIELDS.includes(key)) {
+                values[key] = val;
+            }
+        }
+    }
+    return values;
+}
+export function mergeExamples(yamlExamples, codeExamples) {
+    if (yamlExamples != null) {
+        return yamlExamples.map((d) => ({
+            title: d['title'],
+            inputs: d['inputs'] ?? {},
+            output: d['output'] ?? {},
+            description: d['description'],
+        }));
+    }
+    if (codeExamples != null)
+        return codeExamples;
+    return [];
+}
+export function mergeMetadata(yamlMetadata, codeMetadata) {
+    const result = codeMetadata != null ? { ...codeMetadata } : {};
+    if (yamlMetadata != null) {
+        Object.assign(result, yamlMetadata);
+    }
+    return result;
+}
+//# sourceMappingURL=annotations.js.map

package/dist/schema/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/schema/annotations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,iBAAiB,GAA2C;IAChE,UAAU;IACV,aAAa;IACb,YAAY;IACZ,kBAAkB;IAClB,WAAW;IACX,WAAW;CACZ,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAC9B,eAA2D,EAC3D,eAAqD;IAErD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;YAClC,MAAM,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YACzD,IAAK,iBAAuC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3D,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAsC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,YAA+D,EAC/D,YAAgD;IAEhD,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAW;YAC3B,MAAM,EAAG,CAAC,CAAC,QAAQ,CAA6B,IAAI,EAAE;YACtD,MAAM,EAAG,CAAC,CAAC,QAAQ,CAA6B,IAAI,EAAE;YACtD,WAAW,EAAE,CAAC,CAAC,aAAa,CAAuB;SACpD,CAAC,CAAC,CAAC;IACN,CAAC;IACD,IAAI,YAAY,IAAI,IAAI;QAAE,OAAO,YAAY,CAAC;IAC9C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,YAAwD,EACxD,YAAwD;IAExD,MAAM,MAAM,GAAG,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/schema/exporter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SchemaExporter — converts schemas to platform-specific export formats.
+ */
+import type { ModuleAnnotations, ModuleExample } from '../module.js';
+import { ExportProfile, type SchemaDefinition } from './types.js';
+export declare class SchemaExporter {
+    export(schemaDef: SchemaDefinition, profile: ExportProfile, annotations?: ModuleAnnotations | null, examples?: ModuleExample[] | null, name?: string | null): Record<string, unknown>;
+    exportMcp(schemaDef: SchemaDefinition, annotations?: ModuleAnnotations | null, name?: string | null): Record<string, unknown>;
+    exportOpenai(schemaDef: SchemaDefinition): Record<string, unknown>;
+    exportAnthropic(schemaDef: SchemaDefinition, examples?: ModuleExample[] | null): Record<string, unknown>;
+    exportGeneric(schemaDef: SchemaDefinition): Record<string, unknown>;
+}
+//# sourceMappingURL=exporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../src/schema/exporter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElE,qBAAa,cAAc;IACzB,MAAM,CACJ,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,aAAa,EACtB,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,EACtC,QAAQ,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,EACjC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAa1B,SAAS,CACP,SAAS,EAAE,gBAAgB,EAC3B,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,EACtC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAc1B,YAAY,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAelE,eAAe,CACb,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAe1B,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASpE"}

package/dist/schema/exporter.js

@@ -0,0 +1,71 @@
+/**
+ * SchemaExporter — converts schemas to platform-specific export formats.
+ */
+import { deepCopy } from '../utils/index.js';
+import { applyLlmDescriptions, stripExtensions, toStrictSchema } from './strict.js';
+import { ExportProfile } from './types.js';
+export class SchemaExporter {
+    export(schemaDef, profile, annotations, examples, name) {
+        if (profile === ExportProfile.MCP) {
+            return this.exportMcp(schemaDef, annotations, name);
+        }
+        if (profile === ExportProfile.OpenAI) {
+            return this.exportOpenai(schemaDef);
+        }
+        if (profile === ExportProfile.Anthropic) {
+            return this.exportAnthropic(schemaDef, examples);
+        }
+        return this.exportGeneric(schemaDef);
+    }
+    exportMcp(schemaDef, annotations, name) {
+        return {
+            name: name ?? schemaDef.moduleId,
+            description: schemaDef.description,
+            inputSchema: schemaDef.inputSchema,
+            annotations: {
+                readOnlyHint: annotations?.readonly ?? false,
+                destructiveHint: annotations?.destructive ?? false,
+                idempotentHint: annotations?.idempotent ?? false,
+                openWorldHint: annotations?.openWorld ?? true,
+            },
+        };
+    }
+    exportOpenai(schemaDef) {
+        const schema = deepCopy(schemaDef.inputSchema);
+        applyLlmDescriptions(schema);
+        const strictSchema = toStrictSchema(schema);
+        return {
+            type: 'function',
+            function: {
+                name: schemaDef.moduleId.replace(/\./g, '_'),
+                description: schemaDef.description,
+                parameters: strictSchema,
+                strict: true,
+            },
+        };
+    }
+    exportAnthropic(schemaDef, examples) {
+        const schema = deepCopy(schemaDef.inputSchema);
+        applyLlmDescriptions(schema);
+        stripExtensions(schema);
+        const result = {
+            name: schemaDef.moduleId.replace(/\./g, '_'),
+            description: schemaDef.description,
+            input_schema: schema,
+        };
+        if (examples && examples.length > 0) {
+            result['input_examples'] = examples.map((ex) => ex.inputs);
+        }
+        return result;
+    }
+    exportGeneric(schemaDef) {
+        return {
+            module_id: schemaDef.moduleId,
+            description: schemaDef.description,
+            input_schema: schemaDef.inputSchema,
+            output_schema: schemaDef.outputSchema,
+            definitions: schemaDef.definitions,
+        };
+    }
+}
+//# sourceMappingURL=exporter.js.map

package/dist/schema/exporter.js.map

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

package/dist/schema/index.d.ts

@@ -0,0 +1,9 @@
+export { SchemaStrategy, ExportProfile, validationResultToError } from './types.js';
+export type { SchemaDefinition, ResolvedSchema, SchemaValidationErrorDetail, SchemaValidationResult, LLMExtensions, } from './types.js';
+export { RefResolver } from './ref-resolver.js';
+export { toStrictSchema, applyLlmDescriptions, stripExtensions } from './strict.js';
+export { mergeAnnotations, mergeExamples, mergeMetadata } from './annotations.js';
+export { SchemaLoader, jsonSchemaToTypeBox } from './loader.js';
+export { SchemaValidator } from './validator.js';
+export { SchemaExporter } from './exporter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACpF,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,2BAA2B,EAC3B,sBAAsB,EACtB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/{src/schema/index.ts → dist/schema/index.js}

@@ -1,14 +1,8 @@
 export { SchemaStrategy, ExportProfile, validationResultToError } from './types.js';
-export type {
-  SchemaDefinition,
-  ResolvedSchema,
-  SchemaValidationErrorDetail,
-  SchemaValidationResult,
-  LLMExtensions,
-} from './types.js';
 export { RefResolver } from './ref-resolver.js';
 export { toStrictSchema, applyLlmDescriptions, stripExtensions } from './strict.js';
 export { mergeAnnotations, mergeExamples, mergeMetadata } from './annotations.js';
 export { SchemaLoader, jsonSchemaToTypeBox } from './loader.js';
 export { SchemaValidator } from './validator.js';
 export { SchemaExporter } from './exporter.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAQpF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}