apcore-toolkit 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.4.0] - 2026-03-25
+
+### Added
+
+- **`DisplayResolver`** — sparse `binding.yaml` overlay that resolves surface-facing alias, description, guidance, tags, and documentation into `metadata["display"]` for CLI, MCP, and A2A consumers. Ported from Python with full feature parity.
+  - Resolution chain: surface-specific override > `display` default > binding-level field > scanner value.
+  - MCP alias auto-sanitization and 64-char limit enforcement.
+  - CLI alias validation with fallback on pattern mismatch.
+  - `suggested_alias` fallback from `ScannedModule.metadata`.
+  - Match-count logging via `console.info`/`console.warn`.
+  - Supports single YAML files, directories of `*.binding.yaml` files, and pre-parsed data.
+
 ## [0.3.1] - 2026-03-22
 
 ### Changed

package/README.md

@@ -151,6 +151,7 @@ const dicts = modulesToDicts(modules); // batch conversion
 | `runVerifierChain()` | Run verifier chain, short-circuit on first failure |
 | `Enhancer` | Pluggable interface for metadata enhancement |
 | `AIEnhancer` | SLM-based metadata enhancement for scanned modules |
+| `DisplayResolver` | Sparse binding.yaml overlay — resolves alias, description, guidance, tags into `metadata["display"]` |
 | `VERSION` | Package version string |
 
 ## Documentation

package/dist/display-resolver.d.ts

@@ -0,0 +1,69 @@
+/**
+ * DisplayResolver — sparse binding.yaml display overlay.
+ *
+ * Resolves surface-facing presentation fields (alias, description, guidance)
+ * for each ScannedModule by merging:
+ *   surface-specific override > display default > binding-level > scanner value
+ *
+ * The resolved fields are stored in ScannedModule.metadata["display"] and
+ * travel through RegistryWriter into FunctionModule.metadata["display"],
+ * where CLI/MCP/A2A surfaces read them at render time.
+ */
+import type { ScannedModule } from './types.js';
+/** Surface-specific resolved display fields. */
+export interface SurfaceDisplay {
+    alias: string;
+    description: string;
+    guidance: string | null;
+}
+/** Full resolved display metadata. */
+export interface DisplayMetadata {
+    alias: string;
+    description: string;
+    documentation: string | null;
+    guidance: string | null;
+    tags: string[];
+    cli: SurfaceDisplay;
+    mcp: SurfaceDisplay;
+    a2a: SurfaceDisplay;
+}
+/** Options for {@link DisplayResolver.resolve}. */
+export interface DisplayResolveOptions {
+    /**
+     * Path to a single `.binding.yaml` file or a directory containing
+     * `*.binding.yaml` files. Ignored when `bindingData` is provided.
+     */
+    bindingPath?: string;
+    /**
+     * Pre-parsed binding YAML content as an object (`{ bindings: [...] }`)
+     * or a `moduleId → entry` map. Takes precedence over `bindingPath`.
+     */
+    bindingData?: Record<string, unknown>;
+}
+/**
+ * Resolves display overlay fields for a list of ScannedModules.
+ *
+ * @example
+ * ```ts
+ * const resolver = new DisplayResolver();
+ * const resolved = resolver.resolve(scannedModules, {
+ *   bindingPath: './bindings/',
+ * });
+ * ```
+ */
+export declare class DisplayResolver {
+    /**
+     * Apply display overlay to a list of ScannedModules.
+     *
+     * @param modules - ScannedModule instances from a framework scanner.
+     * @param options - Optional binding path or pre-parsed binding data.
+     * @returns New ScannedModule list with `metadata["display"]` populated.
+     */
+    resolve(modules: ScannedModule[], options?: DisplayResolveOptions): ScannedModule[];
+    private _buildBindingMap;
+    private _parseBindingData;
+    private _loadBindingFiles;
+    private _resolveOne;
+    private _validateAliases;
+}
+//# sourceMappingURL=display-resolver.d.ts.map

package/dist/display-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-resolver.d.ts","sourceRoot":"","sources":["../src/display-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOhD,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,cAAc,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAKD;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,aAAa,EAAE;IA0BnF,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,WAAW;IAsEnB,OAAO,CAAC,gBAAgB;CAiCzB"}

package/dist/display-resolver.js

@@ -0,0 +1,195 @@
+/**
+ * DisplayResolver — sparse binding.yaml display overlay.
+ *
+ * Resolves surface-facing presentation fields (alias, description, guidance)
+ * for each ScannedModule by merging:
+ *   surface-specific override > display default > binding-level > scanner value
+ *
+ * The resolved fields are stored in ScannedModule.metadata["display"] and
+ * travel through RegistryWriter into FunctionModule.metadata["display"],
+ * where CLI/MCP/A2A surfaces read them at render time.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as yaml from 'js-yaml';
+import { cloneModule } from './types.js';
+const MCP_ALIAS_MAX = 64;
+const MCP_ALIAS_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_-]*$/;
+const CLI_ALIAS_PATTERN = /^[a-z][a-z0-9_-]*$/;
+/**
+ * Resolves display overlay fields for a list of ScannedModules.
+ *
+ * @example
+ * ```ts
+ * const resolver = new DisplayResolver();
+ * const resolved = resolver.resolve(scannedModules, {
+ *   bindingPath: './bindings/',
+ * });
+ * ```
+ */
+export class DisplayResolver {
+    /**
+     * Apply display overlay to a list of ScannedModules.
+     *
+     * @param modules - ScannedModule instances from a framework scanner.
+     * @param options - Optional binding path or pre-parsed binding data.
+     * @returns New ScannedModule list with `metadata["display"]` populated.
+     */
+    resolve(modules, options) {
+        const bindingPath = options?.bindingPath ?? null;
+        const bindingData = options?.bindingData ?? null;
+        const bindingMap = this._buildBindingMap(bindingPath, bindingData);
+        if (Object.keys(bindingMap).length > 0) {
+            const matched = modules.filter((mod) => mod.moduleId in bindingMap).length;
+            console.info(`DisplayResolver: ${matched}/${modules.length} modules matched binding entries.`);
+            if (matched === 0) {
+                console.warn(`DisplayResolver: binding map loaded ${Object.keys(bindingMap).length} entries but none matched ` +
+                    'any scanned module_id — check binding.yaml module_id values.');
+            }
+        }
+        return modules.map((mod) => this._resolveOne(mod, bindingMap));
+    }
+    // ------------------------------------------------------------------
+    // Internal helpers
+    // ------------------------------------------------------------------
+    _buildBindingMap(bindingPath, bindingData) {
+        if (bindingData != null) {
+            return this._parseBindingData(bindingData);
+        }
+        if (bindingPath != null) {
+            return this._loadBindingFiles(bindingPath);
+        }
+        return {};
+    }
+    _parseBindingData(data) {
+        // Accept either { bindings: [...] } or a direct moduleId → entry map
+        if ('bindings' in data) {
+            const bindings = data['bindings'] ?? [];
+            const result = {};
+            for (const entry of bindings) {
+                const id = entry['module_id'];
+                if (id != null) {
+                    result[id] = entry;
+                }
+            }
+            return result;
+        }
+        // Already a map
+        const result = {};
+        for (const [k, v] of Object.entries(data)) {
+            if (v != null && typeof v === 'object' && !Array.isArray(v)) {
+                result[k] = v;
+            }
+        }
+        return result;
+    }
+    _loadBindingFiles(bindingPath) {
+        const result = {};
+        let files = [];
+        try {
+            const stat = fs.statSync(bindingPath);
+            if (stat.isFile()) {
+                files = [bindingPath];
+            }
+            else if (stat.isDirectory()) {
+                files = fs
+                    .readdirSync(bindingPath)
+                    .filter((f) => f.endsWith('.binding.yaml'))
+                    .sort()
+                    .map((f) => path.join(bindingPath, f));
+            }
+        }
+        catch {
+            console.warn(`DisplayResolver: binding path not found: ${bindingPath}`);
+            return {};
+        }
+        for (const f of files) {
+            try {
+                const content = fs.readFileSync(f, 'utf-8');
+                const data = yaml.load(content) ?? {};
+                Object.assign(result, this._parseBindingData(data));
+            }
+            catch (exc) {
+                console.warn(`DisplayResolver: failed to load ${f}: ${exc}`);
+            }
+        }
+        return result;
+    }
+    _resolveOne(mod, bindingMap) {
+        const entry = bindingMap[mod.moduleId] ?? {};
+        const displayCfg = entry['display'] ?? {};
+        const bindingDesc = entry['description'];
+        const bindingDocs = entry['documentation'];
+        const suggestedAlias = mod.metadata?.['suggested_alias'] ?? null;
+        // -- Resolve cross-surface defaults --
+        const defaultAlias = displayCfg['alias'] || suggestedAlias || mod.moduleId;
+        const defaultDescription = displayCfg['description'] || bindingDesc || mod.description;
+        const defaultDocumentation = displayCfg['documentation'] || bindingDocs || mod.documentation || null;
+        const defaultGuidance = displayCfg['guidance'] || null;
+        const resolvedTags = displayCfg['tags'] ?? entry['tags'] ?? [...mod.tags];
+        // -- Resolve per-surface fields --
+        const resolveSurface = (key) => {
+            const sc = displayCfg[key] ?? {};
+            const aliasExplicit = Boolean(sc['alias']);
+            return {
+                surface: {
+                    alias: sc['alias'] || defaultAlias,
+                    description: sc['description'] || defaultDescription,
+                    guidance: sc['guidance'] || defaultGuidance,
+                },
+                aliasExplicit,
+            };
+        };
+        const { surface: cliSurface, aliasExplicit: cliAliasExplicit } = resolveSurface('cli');
+        const { surface: mcpSurface } = resolveSurface('mcp');
+        const { surface: a2aSurface } = resolveSurface('a2a');
+        // Auto-sanitize MCP alias: replace non-[a-zA-Z0-9_-] chars with _,
+        // then prepend _ if the result starts with a digit.
+        const rawMcpAlias = mcpSurface.alias;
+        let sanitized = rawMcpAlias.replace(/[^a-zA-Z0-9_-]/g, '_');
+        if (sanitized.length > 0 && /^\d/.test(sanitized)) {
+            sanitized = '_' + sanitized;
+        }
+        mcpSurface.alias = sanitized;
+        if (sanitized !== rawMcpAlias) {
+            console.debug(`Module '${mod.moduleId}': MCP alias auto-sanitized '${rawMcpAlias}' → '${sanitized}'.`);
+        }
+        const display = {
+            alias: defaultAlias,
+            description: defaultDescription,
+            documentation: defaultDocumentation,
+            guidance: defaultGuidance,
+            tags: resolvedTags,
+            cli: cliSurface,
+            mcp: mcpSurface,
+            a2a: a2aSurface,
+        };
+        // -- Validate aliases --
+        this._validateAliases(display, mod.moduleId, cliAliasExplicit);
+        const newMetadata = { ...mod.metadata, display };
+        return cloneModule(mod, { metadata: newMetadata });
+    }
+    _validateAliases(display, moduleId, cliAliasExplicit) {
+        // MCP: MUST enforce 64-char hard limit (alias was already auto-sanitized)
+        const mcpAlias = display.mcp.alias;
+        if (mcpAlias.length > MCP_ALIAS_MAX) {
+            throw new Error(`Module '${moduleId}': MCP alias '${mcpAlias}' exceeds ` +
+                `${MCP_ALIAS_MAX}-character hard limit (OpenAI spec). ` +
+                'Set display.mcp.alias to a shorter value.');
+        }
+        if (!MCP_ALIAS_PATTERN.test(mcpAlias)) {
+            throw new Error(`Module '${moduleId}': MCP alias '${mcpAlias}' does not match ` +
+                'required pattern ^[a-zA-Z_][a-zA-Z0-9_-]*$.');
+        }
+        // CLI: only validate user-explicitly-set aliases
+        if (cliAliasExplicit) {
+            const cliAlias = display.cli.alias;
+            if (!CLI_ALIAS_PATTERN.test(cliAlias)) {
+                console.warn(`Module '${moduleId}': CLI alias '${cliAlias}' does not match shell-safe pattern ` +
+                    `^[a-z][a-z0-9_-]*$ — falling back to default alias '${display.alias}'.`);
+                display.cli.alias = display.alias;
+            }
+        }
+    }
+}
+//# sourceMappingURL=display-resolver.js.map

package/dist/display-resolver.js.map

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

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export { toMarkdown } from './formatting/index.js';
 export { flattenParams } from './flatten-params.js';
 export { AIEnhancer } from './ai-enhancer.js';
 export type { AIEnhancerOptions, Enhancer } from './ai-enhancer.js';
+export { DisplayResolver } from './display-resolver.js';
+export type { DisplayResolveOptions, DisplayMetadata, SurfaceDisplay, } from './display-resolver.js';
 export { YAMLWriter } from './output/yaml-writer.js';
 export { TypeScriptWriter } from './output/typescript-writer.js';
 export { RegistryWriter } from './output/registry-writer.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAK/B,eAAO,MAAM,OAAO,EAAE,MAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAK/B,eAAO,MAAM,OAAO,EAAE,MAAqB,CAAC"}

package/dist/index.js

@@ -7,6 +7,7 @@ export { resolveTarget } from './resolve-target.js';
 export { toMarkdown } from './formatting/index.js';
 export { flattenParams } from './flatten-params.js';
 export { AIEnhancer } from './ai-enhancer.js';
+export { DisplayResolver } from './display-resolver.js';
 export { YAMLWriter } from './output/yaml-writer.js';
 export { TypeScriptWriter } from './output/typescript-writer.js';
 export { RegistryWriter } from './output/registry-writer.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAwB,CAAC;AAChE,MAAM,CAAC,MAAM,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAwB,CAAC;AAChE,MAAM,CAAC,MAAM,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apcore-toolkit",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Shared scanner, schema extraction, and output toolkit for apcore framework adapters",
   "type": "module",
   "main": "./dist/index.js",
@@ -50,7 +50,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "apcore-js": "^0.13.0",
+    "apcore-js": ">=0.14.0",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {