apcore-js 0.5.0 → 0.7.0

package/dist/observability/tracing.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Tracing system: Span, SpanExporter implementations, and TracingMiddleware.
+ */
+import type { Context } from '../context.js';
+import { Middleware } from '../middleware/base.js';
+export interface Span {
+    traceId: string;
+    name: string;
+    startTime: number;
+    spanId: string;
+    parentSpanId: string | null;
+    attributes: Record<string, unknown>;
+    endTime: number | null;
+    status: string;
+    events: Array<Record<string, unknown>>;
+}
+export declare function createSpan(options: {
+    traceId: string;
+    name: string;
+    startTime: number;
+    spanId?: string;
+    parentSpanId?: string | null;
+    attributes?: Record<string, unknown>;
+}): Span;
+export interface SpanExporter {
+    export(span: Span): void;
+}
+export declare class StdoutExporter implements SpanExporter {
+    export(span: Span): void;
+}
+export declare class InMemoryExporter implements SpanExporter {
+    private _spans;
+    private _maxSpans;
+    constructor(maxSpans?: number);
+    export(span: Span): void;
+    getSpans(): Span[];
+    clear(): void;
+}
+export declare class OTLPExporter implements SpanExporter {
+    private _endpoint;
+    private _serviceName;
+    private _headers;
+    constructor(options?: {
+        endpoint?: string;
+        serviceName?: string;
+        headers?: Record<string, string>;
+    });
+    export(span: Span): void;
+}
+export declare class TracingMiddleware extends Middleware {
+    private _exporter;
+    private _samplingRate;
+    private _samplingStrategy;
+    constructor(exporter: SpanExporter, samplingRate?: number, samplingStrategy?: string);
+    /** Replace the span exporter used by this middleware. */
+    setExporter(exporter: SpanExporter): void;
+    private _shouldSample;
+    before(moduleId: string, _inputs: Record<string, unknown>, context: Context): null;
+    after(moduleId: string, _inputs: Record<string, unknown>, _output: Record<string, unknown>, context: Context): null;
+    onError(moduleId: string, _inputs: Record<string, unknown>, error: Error, context: Context): null;
+}
+//# sourceMappingURL=tracing.d.ts.map

package/dist/observability/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/observability/tracing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,GAAG,IAAI,CAYP;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED,qBAAa,cAAe,YAAW,YAAY;IACjD,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAIzB;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,GAAE,MAAe;IAIrC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQxB,QAAQ,IAAI,IAAI,EAAE;IAIlB,KAAK,IAAI,IAAI;CAGd;AAED,qBAAa,YAAa,YAAW,YAAY;IAC/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAyB;gBAE7B,OAAO,CAAC,EAAE;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC;IAMD,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAuCzB;AAID,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAS;gBAGhC,QAAQ,EAAE,YAAY,EACtB,YAAY,GAAE,MAAY,EAC1B,gBAAgB,GAAE,MAAe;IAcnC,yDAAyD;IACzD,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAOzC,OAAO,CAAC,aAAa;IAiBZ,MAAM,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,OAAO,GACf,IAAI;IAsBE,KAAK,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,OAAO,GACf,IAAI;IAgBE,OAAO,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,GACf,IAAI;CAkBR"}

package/dist/observability/tracing.js

@@ -0,0 +1,184 @@
+/**
+ * Tracing system: Span, SpanExporter implementations, and TracingMiddleware.
+ */
+import { Middleware } from '../middleware/base.js';
+import { randomHex } from '../utils/index.js';
+export function createSpan(options) {
+    return {
+        traceId: options.traceId,
+        name: options.name,
+        startTime: options.startTime,
+        spanId: options.spanId ?? randomHex(8),
+        parentSpanId: options.parentSpanId ?? null,
+        attributes: options.attributes ?? {},
+        endTime: null,
+        status: 'ok',
+        events: [],
+    };
+}
+export class StdoutExporter {
+    export(span) {
+        // Use console.info for universal compatibility (Node.js + browser)
+        console.info(JSON.stringify(span));
+    }
+}
+export class InMemoryExporter {
+    _spans = [];
+    _maxSpans;
+    constructor(maxSpans = 10_000) {
+        this._maxSpans = maxSpans;
+    }
+    export(span) {
+        if (this._spans.length >= this._maxSpans) {
+            // Drop oldest half to amortize the cost instead of O(n) shift per insert
+            this._spans = this._spans.slice(Math.floor(this._maxSpans / 2));
+        }
+        this._spans.push(span);
+    }
+    getSpans() {
+        return [...this._spans];
+    }
+    clear() {
+        this._spans = [];
+    }
+}
+export class OTLPExporter {
+    _endpoint;
+    _serviceName;
+    _headers;
+    constructor(options) {
+        this._endpoint = options?.endpoint ?? 'http://localhost:4318/v1/traces';
+        this._serviceName = options?.serviceName ?? 'apcore';
+        this._headers = options?.headers ?? {};
+    }
+    export(span) {
+        const payload = {
+            resourceSpans: [{
+                    resource: {
+                        attributes: [
+                            { key: 'service.name', value: { stringValue: this._serviceName } },
+                        ],
+                    },
+                    scopeSpans: [{
+                            scope: { name: 'apcore' },
+                            spans: [{
+                                    traceId: span.traceId,
+                                    spanId: span.spanId,
+                                    parentSpanId: span.parentSpanId ?? undefined,
+                                    name: span.name,
+                                    startTimeUnixNano: String(Math.round(span.startTime * 1_000_000_000)),
+                                    endTimeUnixNano: span.endTime ? String(Math.round(span.endTime * 1_000_000_000)) : undefined,
+                                    status: { code: span.status === 'ok' ? 1 : 2 },
+                                    attributes: Object.entries(span.attributes).map(([key, value]) => ({
+                                        key,
+                                        value: { stringValue: String(value) },
+                                    })),
+                                }],
+                        }],
+                }],
+        };
+        // Fire-and-forget POST
+        fetch(this._endpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this._headers,
+            },
+            body: JSON.stringify(payload),
+        }).catch(() => {
+            // Silently ignore network errors
+        });
+    }
+}
+const VALID_STRATEGIES = new Set(['full', 'proportional', 'error_first', 'off']);
+export class TracingMiddleware extends Middleware {
+    _exporter;
+    _samplingRate;
+    _samplingStrategy;
+    constructor(exporter, samplingRate = 1.0, samplingStrategy = 'full') {
+        super();
+        if (samplingRate < 0.0 || samplingRate > 1.0) {
+            throw new Error(`sampling_rate must be between 0.0 and 1.0, got ${samplingRate}`);
+        }
+        if (!VALID_STRATEGIES.has(samplingStrategy)) {
+            throw new Error(`sampling_strategy must be one of ${[...VALID_STRATEGIES].join(', ')}, got '${samplingStrategy}'`);
+        }
+        this._exporter = exporter;
+        this._samplingRate = samplingRate;
+        this._samplingStrategy = samplingStrategy;
+    }
+    /** Replace the span exporter used by this middleware. */
+    setExporter(exporter) {
+        if (!exporter || typeof exporter.export !== 'function') {
+            throw new Error('exporter must implement SpanExporter interface');
+        }
+        this._exporter = exporter;
+    }
+    _shouldSample(context) {
+        const existing = context.data['_tracing_sampled'];
+        if (typeof existing === 'boolean')
+            return existing;
+        let decision;
+        if (this._samplingStrategy === 'full') {
+            decision = true;
+        }
+        else if (this._samplingStrategy === 'off') {
+            decision = false;
+        }
+        else {
+            decision = Math.random() < this._samplingRate;
+        }
+        context.data['_tracing_sampled'] = decision;
+        return decision;
+    }
+    before(moduleId, _inputs, context) {
+        this._shouldSample(context);
+        const spansStack = context.data['_tracing_spans'] ?? [];
+        context.data['_tracing_spans'] = spansStack;
+        const parentSpanId = spansStack.length > 0 ? spansStack[spansStack.length - 1].spanId : null;
+        const span = createSpan({
+            traceId: context.traceId,
+            name: 'apcore.module.execute',
+            startTime: Date.now() / 1000,
+            parentSpanId,
+            attributes: {
+                moduleId,
+                method: 'execute',
+                callerId: context.callerId,
+            },
+        });
+        spansStack.push(span);
+        return null;
+    }
+    after(moduleId, _inputs, _output, context) {
+        const spansStack = context.data['_tracing_spans'] ?? [];
+        if (spansStack.length === 0)
+            return null;
+        const span = spansStack.pop();
+        span.endTime = Date.now() / 1000;
+        span.status = 'ok';
+        span.attributes['duration_ms'] = (span.endTime - span.startTime) * 1000;
+        span.attributes['success'] = true;
+        if (context.data['_tracing_sampled']) {
+            this._exporter.export(span);
+        }
+        return null;
+    }
+    onError(moduleId, _inputs, error, context) {
+        const spansStack = context.data['_tracing_spans'] ?? [];
+        if (spansStack.length === 0)
+            return null;
+        const span = spansStack.pop();
+        span.endTime = Date.now() / 1000;
+        span.status = 'error';
+        span.attributes['duration_ms'] = (span.endTime - span.startTime) * 1000;
+        span.attributes['success'] = false;
+        span.attributes['error_code'] = error['code'] ?? error.constructor.name;
+        const shouldExport = this._samplingStrategy === 'error_first' || context.data['_tracing_sampled'];
+        if (shouldExport) {
+            this._exporter.export(span);
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=tracing.js.map

package/dist/observability/tracing.js.map

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

package/dist/registry/dependencies.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Dependency resolution via Kahn's topological sort.
+ */
+import type { DependencyInfo } from './types.js';
+export declare function resolveDependencies(modules: Array<[string, DependencyInfo[]]>, knownIds?: Set<string> | null): string[];
+//# sourceMappingURL=dependencies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/registry/dependencies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,EAC1C,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,GAC5B,MAAM,EAAE,CAwDV"}

package/dist/registry/dependencies.js

@@ -0,0 +1,83 @@
+/**
+ * Dependency resolution via Kahn's topological sort.
+ */
+import { CircularDependencyError, ModuleLoadError } from '../errors.js';
+export function resolveDependencies(modules, knownIds) {
+    if (modules.length === 0)
+        return [];
+    const ids = knownIds ?? new Set(modules.map(([id]) => id));
+    // Build graph and in-degree
+    const graph = new Map();
+    const inDegree = new Map();
+    for (const [modId] of modules) {
+        inDegree.set(modId, 0);
+    }
+    for (const [moduleId, deps] of modules) {
+        for (const dep of deps) {
+            if (!ids.has(dep.moduleId)) {
+                if (dep.optional)
+                    continue;
+                throw new ModuleLoadError(moduleId, `Required dependency '${dep.moduleId}' not found`);
+            }
+            if (!graph.has(dep.moduleId))
+                graph.set(dep.moduleId, new Set());
+            graph.get(dep.moduleId).add(moduleId);
+            inDegree.set(moduleId, (inDegree.get(moduleId) ?? 0) + 1);
+        }
+    }
+    // Initialize queue with zero-in-degree nodes (sorted for determinism)
+    const queue = [...inDegree.entries()]
+        .filter(([, deg]) => deg === 0)
+        .map(([id]) => id)
+        .sort();
+    const loadOrder = [];
+    while (queue.length > 0) {
+        const modId = queue.shift();
+        loadOrder.push(modId);
+        const dependents = graph.get(modId);
+        if (dependents) {
+            for (const dependent of [...dependents].sort()) {
+                const newDeg = (inDegree.get(dependent) ?? 1) - 1;
+                inDegree.set(dependent, newDeg);
+                if (newDeg === 0) {
+                    queue.push(dependent);
+                }
+            }
+        }
+    }
+    // Check for cycles
+    if (loadOrder.length < modules.length) {
+        const ordered = new Set(loadOrder);
+        const remaining = new Set(modules.filter(([id]) => !ordered.has(id)).map(([id]) => id));
+        const cyclePath = extractCycle(modules, remaining);
+        throw new CircularDependencyError(cyclePath);
+    }
+    return loadOrder;
+}
+function extractCycle(modules, remaining) {
+    const depMap = new Map();
+    for (const [modId, deps] of modules) {
+        if (remaining.has(modId)) {
+            depMap.set(modId, deps.filter((d) => remaining.has(d.moduleId)).map((d) => d.moduleId));
+        }
+    }
+    const start = remaining.values().next().value;
+    const visited = [start];
+    const visitedSet = new Set([start]);
+    let current = start;
+    while (true) {
+        const nexts = depMap.get(current) ?? [];
+        if (nexts.length === 0)
+            break;
+        const nxt = nexts[0];
+        if (visitedSet.has(nxt)) {
+            const idx = visited.indexOf(nxt);
+            return [...visited.slice(idx), nxt];
+        }
+        visited.push(nxt);
+        visitedSet.add(nxt);
+        current = nxt;
+    }
+    return [...remaining, remaining.values().next().value];
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/registry/dependencies.js.map

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

package/dist/registry/entry-point.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Entry point resolution for discovered module files.
+ */
+export declare function snakeToPascal(name: string): string;
+export declare function resolveEntryPoint(filePath: string, meta?: Record<string, unknown> | null): Promise<unknown>;
+//# sourceMappingURL=entry-point.d.ts.map

package/dist/registry/entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.d.ts","sourceRoot":"","sources":["../../src/registry/entry-point.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAeD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACpC,OAAO,CAAC,OAAO,CAAC,CAmClB"}

package/dist/registry/entry-point.js

@@ -0,0 +1,55 @@
+/**
+ * Entry point resolution for discovered module files.
+ */
+import { ModuleLoadError } from '../errors.js';
+export function snakeToPascal(name) {
+    if (!name)
+        return '';
+    return name.split('_').map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join('');
+}
+function isModuleClass(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const record = obj;
+    return (record['inputSchema'] != null &&
+        typeof record['inputSchema'] === 'object' &&
+        record['outputSchema'] != null &&
+        typeof record['outputSchema'] === 'object' &&
+        typeof record['description'] === 'string' &&
+        typeof record['execute'] === 'function');
+}
+export async function resolveEntryPoint(filePath, meta) {
+    let loaded;
+    try {
+        loaded = await import(filePath);
+    }
+    catch (e) {
+        throw new ModuleLoadError(filePath, `Failed to import module: ${e}`);
+    }
+    // Meta override mode
+    if (meta && 'entry_point' in meta) {
+        const className = meta['entry_point'].split(':').pop();
+        const cls = loaded[className];
+        if (cls == null) {
+            throw new ModuleLoadError(filePath, `Entry point class '${className}' not found`);
+        }
+        return cls;
+    }
+    // Auto-infer: look for default export first, then named exports
+    if (loaded['default'] && isModuleClass(loaded['default'])) {
+        return loaded['default'];
+    }
+    const candidates = [];
+    for (const [, value] of Object.entries(loaded)) {
+        if (isModuleClass(value)) {
+            candidates.push(value);
+        }
+    }
+    if (candidates.length === 1)
+        return candidates[0];
+    if (candidates.length === 0) {
+        throw new ModuleLoadError(filePath, 'No Module subclass found in file');
+    }
+    throw new ModuleLoadError(filePath, 'Ambiguous entry point: multiple Module subclasses found');
+}
+//# sourceMappingURL=entry-point.js.map

package/dist/registry/entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.js","sourceRoot":"","sources":["../../src/registry/entry-point.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,aAAa,CAAC,GAAY;IACjC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,MAAM,GAAG,GAA8B,CAAC;IAC9C,OAAO,CACL,MAAM,CAAC,aAAa,CAAC,IAAI,IAAI;QAC7B,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,QAAQ;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,IAAI;QAC9B,OAAO,MAAM,CAAC,cAAc,CAAC,KAAK,QAAQ;QAC1C,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,QAAQ;QACzC,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,UAAU,CACxC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,IAAqC;IAErC,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CAAC,QAAQ,EAAE,4BAA4B,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;QAClC,MAAM,SAAS,GAAI,IAAI,CAAC,aAAa,CAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;QACpE,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,eAAe,CAAC,QAAQ,EAAE,sBAAsB,SAAS,aAAa,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gEAAgE;IAChE,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,UAAU,GAAc,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,eAAe,CAAC,QAAQ,EAAE,kCAAkC,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,IAAI,eAAe,CAAC,QAAQ,EAAE,yDAAyD,CAAC,CAAC;AACjG,CAAC"}

package/{src/registry/index.ts → dist/registry/index.d.ts}

@@ -7,3 +7,4 @@ export { scanExtensions, scanMultiRoot } from './scanner.js';
 export { resolveEntryPoint, snakeToPascal } from './entry-point.js';
 export { loadMetadata, parseDependencies, mergeModuleMetadata, loadIdMap } from './metadata.js';
 export { getSchema, exportSchema, getAllSchemas, exportAllSchemas } from './schema-export.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,8 @@
+export { Registry } from './registry.js';
+export { validateModule } from './validation.js';
+export { resolveDependencies } from './dependencies.js';
+export { scanExtensions, scanMultiRoot } from './scanner.js';
+export { resolveEntryPoint, snakeToPascal } from './entry-point.js';
+export { loadMetadata, parseDependencies, mergeModuleMetadata, loadIdMap } from './metadata.js';
+export { getSchema, exportSchema, getAllSchemas, exportAllSchemas } from './schema-export.js';
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/metadata.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Metadata and ID map loading for the registry system.
+ */
+import type { DependencyInfo } from './types.js';
+export declare function loadMetadata(metaPath: string): Record<string, unknown>;
+export declare function parseDependencies(depsRaw: Array<Record<string, unknown>>): DependencyInfo[];
+export declare function mergeModuleMetadata(moduleObj: Record<string, unknown>, meta: Record<string, unknown>): Record<string, unknown>;
+export declare function loadIdMap(idMapPath: string): Record<string, Record<string, unknown>>;
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/registry/metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBtE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,cAAc,EAAE,CAiB3F;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoCpF"}

package/dist/registry/metadata.js

@@ -0,0 +1,105 @@
+/**
+ * Metadata and ID map loading for the registry system.
+ */
+import yaml from 'js-yaml';
+import { ConfigError, ConfigNotFoundError } from '../errors.js';
+// Lazy-load Node.js built-in modules for browser compatibility
+let _nodeFs = null;
+try {
+    _nodeFs = await import('node:fs');
+}
+catch { /* browser environment */ }
+export function loadMetadata(metaPath) {
+    const { existsSync, readFileSync } = _nodeFs;
+    if (!existsSync(metaPath))
+        return {};
+    const content = readFileSync(metaPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = yaml.load(content);
+    }
+    catch (e) {
+        throw new ConfigError(`Invalid YAML in metadata file: ${metaPath}`);
+    }
+    if (parsed === null || parsed === undefined)
+        return {};
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new ConfigError(`Metadata file must be a YAML mapping: ${metaPath}`);
+    }
+    return parsed;
+}
+export function parseDependencies(depsRaw) {
+    if (!depsRaw || depsRaw.length === 0)
+        return [];
+    const result = [];
+    for (const dep of depsRaw) {
+        const moduleId = dep['module_id'];
+        if (!moduleId) {
+            console.warn(`[apcore:metadata] Dependency entry missing 'module_id', skipping`);
+            continue;
+        }
+        result.push({
+            moduleId,
+            version: dep['version'] ?? null,
+            optional: dep['optional'] ?? false,
+        });
+    }
+    return result;
+}
+export function mergeModuleMetadata(moduleObj, meta) {
+    const codeDesc = moduleObj['description'] ?? '';
+    const codeName = moduleObj['name'] ?? null;
+    const codeTags = moduleObj['tags'] ?? [];
+    const codeVersion = moduleObj['version'] ?? '1.0.0';
+    const codeAnnotations = moduleObj['annotations'] ?? null;
+    const codeExamples = moduleObj['examples'] ?? [];
+    const codeMetadata = moduleObj['metadata'] ?? {};
+    const codeDocs = moduleObj['documentation'] ?? null;
+    const yamlMetadata = meta['metadata'] ?? {};
+    const mergedMetadata = { ...codeMetadata, ...yamlMetadata };
+    return {
+        description: meta['description'] || codeDesc,
+        name: meta['name'] || codeName,
+        tags: meta['tags'] != null ? meta['tags'] : codeTags || [],
+        version: meta['version'] || codeVersion,
+        annotations: meta['annotations'] != null ? meta['annotations'] : codeAnnotations,
+        examples: meta['examples'] != null ? meta['examples'] : codeExamples || [],
+        metadata: mergedMetadata,
+        documentation: meta['documentation'] || codeDocs,
+    };
+}
+export function loadIdMap(idMapPath) {
+    const { existsSync, readFileSync } = _nodeFs;
+    if (!existsSync(idMapPath)) {
+        throw new ConfigNotFoundError(idMapPath);
+    }
+    const content = readFileSync(idMapPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = yaml.load(content);
+    }
+    catch (e) {
+        throw new ConfigError(`Invalid YAML in ID map file: ${idMapPath}`);
+    }
+    if (typeof parsed !== 'object' || parsed === null || !('mappings' in parsed)) {
+        throw new ConfigError("ID map must contain a 'mappings' list");
+    }
+    const mappings = parsed['mappings'];
+    if (!Array.isArray(mappings)) {
+        throw new ConfigError("ID map must contain a 'mappings' list");
+    }
+    const result = {};
+    for (const entry of mappings) {
+        const filePath = entry['file'];
+        if (!filePath) {
+            console.warn(`[apcore:metadata] ID map entry missing 'file' field, skipping`);
+            continue;
+        }
+        result[filePath] = {
+            id: entry['id'] ?? filePath,
+            class: entry['class'] ?? null,
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/registry/metadata.js.map

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