@principal-ai/subsystems-core 0.29.0

package/dist/parsers/OtlpTraceParser.d.ts

@@ -0,0 +1,131 @@
+/**
+ * OTLP Trace Parser
+ *
+ * Extracts structured data from OTLP traces for scope-based matching.
+ *
+ * Responsibilities:
+ * - Extract resources (service info, attributes)
+ * - Extract scopes (instrumentation libraries)
+ * - Map spans to their scopes
+ * - Extract span events
+ * - Convert OTLP timestamps and IDs to usable formats
+ */
+import type { OtelExportTraceServiceRequest, OtelSpanEvent, OtelKeyValue } from '../types/otel';
+import type { TraceResource } from '../types/registered-trace';
+/**
+ * Extracted span information
+ */
+export interface ExtractedSpan {
+    spanId: string;
+    spanName: string;
+    parentSpanId?: string;
+    traceId: string;
+    startTime: number;
+    endTime: number;
+    duration: number;
+    attributes: Record<string, unknown>;
+    events: ExtractedEvent[];
+    status: {
+        code: number;
+        message?: string;
+    };
+    scopeName: string;
+}
+/**
+ * Extracted event information
+ */
+export interface ExtractedEvent {
+    name: string;
+    timestamp: number;
+    attributes: Record<string, unknown>;
+}
+/**
+ * Parser for OTLP traces
+ */
+export declare class OtlpTraceParser {
+    /**
+     * Extract all resources from OTLP trace
+     *
+     * Returns array of resources, each with their scopes and span mappings.
+     */
+    extractResources(otlpData: OtelExportTraceServiceRequest): TraceResource[];
+    /**
+     * Extract single resource
+     */
+    private extractResource;
+    /**
+     * Extract service identifier for routing
+     *
+     * Priority: dev.server.url > service.name
+     */
+    private extractServiceIdentifier;
+    /**
+     * Extract all scopes from scopeSpans
+     */
+    private extractScopes;
+    /**
+     * Get all spans for a specific scope
+     */
+    getSpansForScope(otlpData: OtelExportTraceServiceRequest, scopeName: string): ExtractedSpan[];
+    /**
+     * Extract span information
+     */
+    private extractSpan;
+    /**
+     * Extract events from span
+     */
+    extractEvents(events: OtelSpanEvent[]): ExtractedEvent[];
+    /**
+     * Extract basic trace information
+     */
+    extractTraceInfo(otlpData: OtelExportTraceServiceRequest): {
+        traceId: string;
+        name: string;
+        startTime: number;
+        endTime: number;
+        duration: number;
+        spanCount: number;
+        hasErrors: boolean;
+    };
+    /**
+     * Extract trace ID
+     */
+    private extractTraceId;
+    /**
+     * Extract trace name (root span name)
+     */
+    private extractTraceName;
+    /**
+     * Extract time range across all spans
+     */
+    private extractTimeRange;
+    /**
+     * Count total spans
+     */
+    private countSpans;
+    /**
+     * Detect if any span has errors
+     */
+    private detectErrors;
+    /**
+     * Get all spans from trace (flattened)
+     */
+    private getAllSpans;
+    /**
+     * Convert OTLP attributes to simple key-value record
+     */
+    convertAttributes(attrs: OtelKeyValue[]): Record<string, unknown>;
+    /**
+     * Extract value from OTLP AnyValue
+     */
+    private extractAttributeValue;
+    /**
+     * Convert nanoseconds to milliseconds
+     */
+    private nanoToMillis;
+    /**
+     * Check if trace is in local development mode
+     */
+    isLocalDevelopment(otlpData: OtelExportTraceServiceRequest): boolean;
+}
+//# sourceMappingURL=OtlpTraceParser.d.ts.map

package/dist/parsers/OtlpTraceParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtlpTraceParser.d.ts","sourceRoot":"","sources":["../../src/parsers/OtlpTraceParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,6BAA6B,EAI7B,aAAa,EACb,YAAY,EAEb,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,6BAA6B,GAAG,aAAa,EAAE;IAW1E;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAQhC;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,gBAAgB,CACd,QAAQ,EAAE,6BAA6B,EACvC,SAAS,EAAE,MAAM,GAChB,aAAa,EAAE;IAgBlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,cAAc,EAAE;IAQxD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,6BAA6B,GAAG;QACzD,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;KACpB;IAkBD;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAajE;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,6BAA6B,GAAG,OAAO;CA4BrE"}

package/dist/parsers/OtlpTraceParser.js

@@ -0,0 +1,310 @@
+"use strict";
+/**
+ * OTLP Trace Parser
+ *
+ * Extracts structured data from OTLP traces for scope-based matching.
+ *
+ * Responsibilities:
+ * - Extract resources (service info, attributes)
+ * - Extract scopes (instrumentation libraries)
+ * - Map spans to their scopes
+ * - Extract span events
+ * - Convert OTLP timestamps and IDs to usable formats
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OtlpTraceParser = void 0;
+/**
+ * Parser for OTLP traces
+ */
+class OtlpTraceParser {
+    /**
+     * Extract all resources from OTLP trace
+     *
+     * Returns array of resources, each with their scopes and span mappings.
+     */
+    extractResources(otlpData) {
+        const resources = [];
+        for (const resourceSpan of otlpData.resourceSpans || []) {
+            const resource = this.extractResource(resourceSpan);
+            resources.push(resource);
+        }
+        return resources;
+    }
+    /**
+     * Extract single resource
+     */
+    extractResource(resourceSpan) {
+        const attributes = this.convertAttributes(resourceSpan.resource.attributes);
+        // Extract service identifier (for routing)
+        const serviceIdentifier = this.extractServiceIdentifier(attributes);
+        // Extract service name
+        const serviceName = attributes['service.name'] || 'unknown';
+        // Extract all scopes within this resource
+        const scopes = this.extractScopes(resourceSpan.scopeSpans || []);
+        return {
+            serviceIdentifier,
+            serviceName,
+            attributes,
+            scopes,
+        };
+    }
+    /**
+     * Extract service identifier for routing
+     *
+     * Priority: dev.server.url > service.name
+     */
+    extractServiceIdentifier(attributes) {
+        return (attributes['dev.server.url'] ||
+            attributes['service.name'] ||
+            'unknown');
+    }
+    /**
+     * Extract all scopes from scopeSpans
+     */
+    extractScopes(scopeSpans) {
+        const scopes = [];
+        for (const scopeSpan of scopeSpans) {
+            const scope = scopeSpan.scope;
+            if (!scope)
+                continue;
+            // Extract span IDs for this scope
+            const spanIds = scopeSpan.spans?.map((span) => span.spanId) || [];
+            scopes.push({
+                scope: {
+                    name: scope.name,
+                    version: scope.version || '0.0.0',
+                    attributes: scope.attributes
+                        ? this.convertAttributes(scope.attributes)
+                        : undefined,
+                    schemaUrl: scopeSpan.schemaUrl,
+                },
+                spanIds,
+            });
+        }
+        return scopes;
+    }
+    /**
+     * Get all spans for a specific scope
+     */
+    getSpansForScope(otlpData, scopeName) {
+        const spans = [];
+        for (const resourceSpan of otlpData.resourceSpans || []) {
+            for (const scopeSpan of resourceSpan.scopeSpans || []) {
+                if (scopeSpan.scope?.name === scopeName) {
+                    for (const span of scopeSpan.spans || []) {
+                        spans.push(this.extractSpan(span, scopeName));
+                    }
+                }
+            }
+        }
+        return spans;
+    }
+    /**
+     * Extract span information
+     */
+    extractSpan(span, scopeName) {
+        const startTime = this.nanoToMillis(span.startTimeUnixNano);
+        const endTime = this.nanoToMillis(span.endTimeUnixNano);
+        return {
+            spanId: span.spanId,
+            spanName: span.name,
+            parentSpanId: span.parentSpanId,
+            traceId: span.traceId,
+            startTime,
+            endTime,
+            duration: endTime - startTime,
+            attributes: this.convertAttributes(span.attributes),
+            events: this.extractEvents(span.events || []),
+            status: {
+                code: span.status.code,
+                message: span.status.message,
+            },
+            scopeName,
+        };
+    }
+    /**
+     * Extract events from span
+     */
+    extractEvents(events) {
+        return events.map((event) => ({
+            name: event.name,
+            timestamp: this.nanoToMillis(event.timeUnixNano),
+            attributes: this.convertAttributes(event.attributes || []),
+        }));
+    }
+    /**
+     * Extract basic trace information
+     */
+    extractTraceInfo(otlpData) {
+        const traceId = this.extractTraceId(otlpData);
+        const name = this.extractTraceName(otlpData);
+        const { startTime, endTime } = this.extractTimeRange(otlpData);
+        const spanCount = this.countSpans(otlpData);
+        const hasErrors = this.detectErrors(otlpData);
+        return {
+            traceId,
+            name,
+            startTime,
+            endTime,
+            duration: endTime - startTime,
+            spanCount,
+            hasErrors,
+        };
+    }
+    /**
+     * Extract trace ID
+     */
+    extractTraceId(otlpData) {
+        const firstSpan = otlpData.resourceSpans?.[0]?.scopeSpans?.[0]?.spans?.[0];
+        return firstSpan?.traceId || 'unknown';
+    }
+    /**
+     * Extract trace name (root span name)
+     */
+    extractTraceName(otlpData) {
+        // Find root span (no parentSpanId) or use first span
+        const allSpans = this.getAllSpans(otlpData);
+        const rootSpan = allSpans.find((s) => !s.parentSpanId) || allSpans[0];
+        return rootSpan?.name || 'Unknown Trace';
+    }
+    /**
+     * Extract time range across all spans
+     */
+    extractTimeRange(otlpData) {
+        let minStart = Number.MAX_SAFE_INTEGER;
+        let maxEnd = 0;
+        for (const resourceSpan of otlpData.resourceSpans || []) {
+            for (const scopeSpan of resourceSpan.scopeSpans || []) {
+                for (const span of scopeSpan.spans || []) {
+                    const start = this.nanoToMillis(span.startTimeUnixNano);
+                    const end = this.nanoToMillis(span.endTimeUnixNano);
+                    if (start < minStart)
+                        minStart = start;
+                    if (end > maxEnd)
+                        maxEnd = end;
+                }
+            }
+        }
+        return {
+            startTime: minStart === Number.MAX_SAFE_INTEGER ? Date.now() : minStart,
+            endTime: maxEnd || Date.now(),
+        };
+    }
+    /**
+     * Count total spans
+     */
+    countSpans(otlpData) {
+        let count = 0;
+        for (const resourceSpan of otlpData.resourceSpans || []) {
+            for (const scopeSpan of resourceSpan.scopeSpans || []) {
+                count += scopeSpan.spans?.length || 0;
+            }
+        }
+        return count;
+    }
+    /**
+     * Detect if any span has errors
+     */
+    detectErrors(otlpData) {
+        for (const resourceSpan of otlpData.resourceSpans || []) {
+            for (const scopeSpan of resourceSpan.scopeSpans || []) {
+                for (const span of scopeSpan.spans || []) {
+                    if (span.status.code === 2) {
+                        // ERROR
+                        return true;
+                    }
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Get all spans from trace (flattened)
+     */
+    getAllSpans(otlpData) {
+        const spans = [];
+        for (const resourceSpan of otlpData.resourceSpans || []) {
+            for (const scopeSpan of resourceSpan.scopeSpans || []) {
+                spans.push(...(scopeSpan.spans || []));
+            }
+        }
+        return spans;
+    }
+    /**
+     * Convert OTLP attributes to simple key-value record
+     */
+    convertAttributes(attrs) {
+        const result = {};
+        for (const attr of attrs || []) {
+            const value = this.extractAttributeValue(attr.value);
+            if (value !== undefined) {
+                result[attr.key] = value;
+            }
+        }
+        return result;
+    }
+    /**
+     * Extract value from OTLP AnyValue
+     */
+    extractAttributeValue(value) {
+        if (value.stringValue !== undefined)
+            return value.stringValue;
+        if (value.intValue !== undefined)
+            return value.intValue;
+        if (value.doubleValue !== undefined)
+            return value.doubleValue;
+        if (value.boolValue !== undefined)
+            return value.boolValue;
+        // Handle complex types
+        if (value.arrayValue) {
+            return value.arrayValue.values.map((v) => this.extractAttributeValue(v));
+        }
+        if (value.kvlistValue) {
+            const obj = {};
+            for (const kv of value.kvlistValue.values) {
+                obj[kv.key] = this.extractAttributeValue(kv.value);
+            }
+            return obj;
+        }
+        if (value.bytesValue) {
+            return value.bytesValue;
+        }
+        return undefined;
+    }
+    /**
+     * Convert nanoseconds to milliseconds
+     */
+    nanoToMillis(nanos) {
+        if (!nanos)
+            return 0;
+        const nanosNum = typeof nanos === 'string' ? parseInt(nanos, 10) : nanos;
+        return Math.floor(nanosNum / 1000000);
+    }
+    /**
+     * Check if trace is in local development mode
+     */
+    isLocalDevelopment(otlpData) {
+        const resources = this.extractResources(otlpData);
+        for (const resource of resources) {
+            // Check for dev.mode flag
+            if (resource.attributes?.['dev.mode'] === true) {
+                return true;
+            }
+            // Check for dev workspace path
+            if (resource.attributes?.['dev.workspace.path']) {
+                return true;
+            }
+            // Check for dev version patterns in scopes
+            for (const { scope } of resource.scopes) {
+                if (scope.version?.includes('-dev') ||
+                    scope.version?.includes('-local') ||
+                    scope.version === '0.0.0-dev') {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+}
+exports.OtlpTraceParser = OtlpTraceParser;
+//# sourceMappingURL=OtlpTraceParser.js.map

package/dist/parsers/OtlpTraceParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtlpTraceParser.js","sourceRoot":"","sources":["../../src/parsers/OtlpTraceParser.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AA0CH;;GAEG;AACH,MAAa,eAAe;IAC1B;;;;OAIG;IACH,gBAAgB,CAAC,QAAuC;QACtD,MAAM,SAAS,GAAoB,EAAE,CAAC;QAEtC,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,IAAI,EAAE,EAAE;YACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YACpD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;SAC1B;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,YAAmC;QACzD,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE5E,2CAA2C;QAC3C,MAAM,iBAAiB,GAAG,IAAI,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC;QAEpE,uBAAuB;QACvB,MAAM,WAAW,GAAI,UAAU,CAAC,cAAc,CAAY,IAAI,SAAS,CAAC;QAExE,0CAA0C;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAEjE,OAAO;YACL,iBAAiB;YACjB,WAAW;YACX,UAAU;YACV,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,wBAAwB,CAAC,UAAmC;QAClE,OAAO,CACJ,UAAU,CAAC,gBAAgB,CAAY;YACvC,UAAU,CAAC,cAAc,CAAY;YACtC,SAAS,CACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CACnB,UAA4B;QAE5B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAE3C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE;YAClC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;YAC9B,IAAI,CAAC,KAAK;gBAAE,SAAS;YAErB,kCAAkC;YAClC,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAElE,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,OAAO;oBACjC,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC1B,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC;wBAC1C,CAAC,CAAC,SAAS;oBACb,SAAS,EAAE,SAAS,CAAC,SAAS;iBAC/B;gBACD,OAAO;aACR,CAAC,CAAC;SACJ;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,QAAuC,EACvC,SAAiB;QAEjB,MAAM,KAAK,GAAoB,EAAE,CAAC;QAElC,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,IAAI,EAAE,EAAE;YACvD,KAAK,MAAM,SAAS,IAAI,YAAY,CAAC,UAAU,IAAI,EAAE,EAAE;gBACrD,IAAI,SAAS,CAAC,KAAK,EAAE,IAAI,KAAK,SAAS,EAAE;oBACvC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,IAAI,EAAE,EAAE;wBACxC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;qBAC/C;iBACF;aACF;SACF;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAkB,EAAE,SAAiB;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAExD,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS;YACT,OAAO;YACP,QAAQ,EAAE,OAAO,GAAG,SAAS;YAC7B,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC;YACnD,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;YAC7C,MAAM,EAAE;gBACN,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;gBACtB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;aAC7B;YACD,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,MAAuB;QACnC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC;YAChD,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;SAC3D,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAAuC;QAStD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAE9C,OAAO;YACL,OAAO;YACP,IAAI;YACJ,SAAS;YACT,OAAO;YACP,QAAQ,EAAE,OAAO,GAAG,SAAS;YAC7B,SAAS;YACT,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,QAAuC;QAC5D,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,OAAO,SAAS,EAAE,OAAO,IAAI,SAAS,CAAC;IACzC,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,QAAuC;QAC9D,qDAAqD;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC;QACtE,OAAO,QAAQ,EAAE,IAAI,IAAI,eAAe,CAAC;IAC3C,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,QAAuC;QAI9D,IAAI,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACvC,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,IAAI,EAAE,EAAE;YACvD,KAAK,MAAM,SAAS,IAAI,YAAY,CAAC,UAAU,IAAI,EAAE,EAAE;gBACrD,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,IAAI,EAAE,EAAE;oBACxC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;oBACxD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;oBACpD,IAAI,KAAK,GAAG,QAAQ;wBAAE,QAAQ,GAAG,KAAK,CAAC;oBACvC,IAAI,GAAG,GAAG,MAAM;wBAAE,MAAM,GAAG,GAAG,CAAC;iBAChC;aACF;SACF;QAED,OAAO;YACL,SAAS,EAAE,QAAQ,KAAK,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ;YACvE,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE;SAC9B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,QAAuC;QACxD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,IAAI,EAAE,EAAE;YACvD,KAAK,MAAM,SAAS,IAAI,YAAY,CAAC,UAAU,IAAI,EAAE,EAAE;gBACrD,KAAK,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;aACvC;SACF;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,QAAuC;QAC1D,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,IAAI,EAAE,EAAE;YACvD,KAAK,MAAM,SAAS,IAAI,YAAY,CAAC,UAAU,IAAI,EAAE,EAAE;gBACrD,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,IAAI,EAAE,EAAE;oBACxC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE;wBAC1B,QAAQ;wBACR,OAAO,IAAI,CAAC;qBACb;iBACF;aACF;SACF;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,QAAuC;QACzD,MAAM,KAAK,GAAmB,EAAE,CAAC;QACjC,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,IAAI,EAAE,EAAE;YACvD,KAAK,MAAM,SAAS,IAAI,YAAY,CAAC,UAAU,IAAI,EAAE,EAAE;gBACrD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;aACxC;SACF;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,KAAqB;QACrC,MAAM,MAAM,GAA4B,EAAE,CAAC;QAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrD,IAAI,KAAK,KAAK,SAAS,EAAE;gBACvB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;aAC1B;SACF;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,KAAmB;QAC/C,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC,WAAW,CAAC;QAC9D,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC,WAAW,CAAC;QAC9D,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC,SAAS,CAAC;QAE1D,uBAAuB;QACvB,IAAI,KAAK,CAAC,UAAU,EAAE;YACpB,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;SAC1E;QAED,IAAI,KAAK,CAAC,WAAW,EAAE;YACrB,MAAM,GAAG,GAA4B,EAAE,CAAC;YACxC,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE;gBACzC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;aACpD;YACD,OAAO,GAAG,CAAC;SACZ;QAED,IAAI,KAAK,CAAC,UAAU,EAAE;YACpB,OAAO,KAAK,CAAC,UAAU,CAAC;SACzB;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,KAAsB;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC;QACrB,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACzE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,QAAuC;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAElD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;YAChC,0BAA0B;YAC1B,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE;gBAC9C,OAAO,IAAI,CAAC;aACb;YAED,+BAA+B;YAC/B,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,oBAAoB,CAAC,EAAE;gBAC/C,OAAO,IAAI,CAAC;aACb;YAED,2CAA2C;YAC3C,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,MAAM,EAAE;gBACvC,IACE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC;oBAC/B,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC;oBACjC,KAAK,CAAC,OAAO,KAAK,WAAW,EAC7B;oBACA,OAAO,IAAI,CAAC;iBACb;aACF;SACF;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAxVD,0CAwVC"}

package/dist/registry/CompositeRegistry.d.ts

@@ -0,0 +1,71 @@
+/**
+ * CompositeRegistry - Routes between local and remote registries
+ *
+ * Decision logic:
+ * 1. Check if scope is in local development mode
+ * 2. If yes → use LocalRegistry
+ * 3. If no → use RemoteRegistry
+ *
+ * This is the main registry implementation that should be used in production.
+ */
+import type { FileTree } from '@principal-ai/repository-abstraction';
+import type { StoryboardRegistryInterface, ScopeLookupResult } from '../types/registered-trace';
+import type { LocalRegistry } from './LocalRegistry';
+import type { RemoteRegistry } from './RemoteRegistry';
+/**
+ * Composite registry that routes to local or remote
+ */
+export declare class CompositeRegistry implements StoryboardRegistryInterface {
+    private localRegistry;
+    private remoteRegistry;
+    constructor(localRegistry: LocalRegistry, remoteRegistry: RemoteRegistry);
+    lookupByScope(scope: {
+        name: string;
+        version: string;
+    }, resource: {
+        attributes?: Record<string, unknown>;
+    }): Promise<ScopeLookupResult>;
+    /**
+     * Determine if this scope is in local development mode
+     */
+    private isLocalDevelopment;
+    listScopes(): Promise<Array<{
+        name: string;
+        versions: string[];
+    }>>;
+    supportsHotReload(): boolean;
+    /**
+     * Get the local registry (for workspace management)
+     */
+    getLocalRegistry(): LocalRegistry;
+    /**
+     * Get the remote registry (for cache management, etc.)
+     */
+    getRemoteRegistry(): RemoteRegistry;
+    /**
+     * Register a local workspace (convenience method)
+     */
+    registerWorkspace(fileTree: FileTree): Promise<string[]>;
+    /**
+     * Unregister a local workspace (convenience method)
+     */
+    unregisterWorkspace(scopeName: string): void;
+    /**
+     * Get list of registered local workspaces
+     */
+    getRegisteredWorkspaces(): Array<{
+        scopeName: string;
+        fileTreeSha: string;
+    }>;
+    /**
+     * Invalidate cache for a workspace (convenience method)
+     *
+     * Call this when .principal-views files change to trigger rebuild.
+     */
+    invalidateCache(scopeName: string): void;
+    /**
+     * Cleanup: destroy local registry watchers
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=CompositeRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/CompositeRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,2BAA2B;IAEjE,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,cAAc;gBADd,aAAa,EAAE,aAAa,EAC5B,cAAc,EAAE,cAAc;IAGlC,aAAa,CACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACxC,QAAQ,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACjD,OAAO,CAAC,iBAAiB,CAAC;IAY7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuBpB,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAmBxE,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;OAEG;IACH,iBAAiB,IAAI,cAAc;IAInC;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI9D;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACH,uBAAuB,IAAI,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAI5E;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/registry/CompositeRegistry.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * CompositeRegistry - Routes between local and remote registries
+ *
+ * Decision logic:
+ * 1. Check if scope is in local development mode
+ * 2. If yes → use LocalRegistry
+ * 3. If no → use RemoteRegistry
+ *
+ * This is the main registry implementation that should be used in production.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompositeRegistry = void 0;
+/**
+ * Composite registry that routes to local or remote
+ */
+class CompositeRegistry {
+    constructor(localRegistry, remoteRegistry) {
+        this.localRegistry = localRegistry;
+        this.remoteRegistry = remoteRegistry;
+    }
+    async lookupByScope(scope, resource) {
+        // Check if this is local development
+        if (this.isLocalDevelopment(resource, scope)) {
+            console.log('[CompositeRegistry] Using LocalRegistry for:', scope.name);
+            return this.localRegistry.lookupByScope(scope, resource);
+        }
+        // Use remote registry for published libraries/services
+        console.log('[CompositeRegistry] Using RemoteRegistry for:', scope.name);
+        return this.remoteRegistry.lookupByScope(scope, resource);
+    }
+    /**
+     * Determine if this scope is in local development mode
+     */
+    isLocalDevelopment(resource, scope) {
+        // Check for dev.mode flag
+        if (resource.attributes?.['dev.mode'] === true) {
+            console.log('[CompositeRegistry] Dev mode detected (dev.mode=true)');
+            return true;
+        }
+        // Check for dev version patterns
+        if (scope.version?.includes('-dev') ||
+            scope.version?.includes('-local') ||
+            scope.version === '0.0.0-dev') {
+            console.log('[CompositeRegistry] Dev mode detected (dev version pattern):', scope.version);
+            return true;
+        }
+        return false;
+    }
+    async listScopes() {
+        // Combine scopes from both registries
+        const localScopes = await this.localRegistry.listScopes();
+        const remoteScopes = await this.remoteRegistry.listScopes();
+        // Merge, preferring local for conflicts
+        const scopeMap = new Map();
+        for (const scope of remoteScopes) {
+            scopeMap.set(scope.name, scope);
+        }
+        for (const scope of localScopes) {
+            scopeMap.set(scope.name, scope); // Local overrides remote
+        }
+        return Array.from(scopeMap.values());
+    }
+    supportsHotReload() {
+        return this.localRegistry.supportsHotReload();
+    }
+    /**
+     * Get the local registry (for workspace management)
+     */
+    getLocalRegistry() {
+        return this.localRegistry;
+    }
+    /**
+     * Get the remote registry (for cache management, etc.)
+     */
+    getRemoteRegistry() {
+        return this.remoteRegistry;
+    }
+    /**
+     * Register a local workspace (convenience method)
+     */
+    async registerWorkspace(fileTree) {
+        return this.localRegistry.registerWorkspace(fileTree);
+    }
+    /**
+     * Unregister a local workspace (convenience method)
+     */
+    unregisterWorkspace(scopeName) {
+        this.localRegistry.unregisterWorkspace(scopeName);
+    }
+    /**
+     * Get list of registered local workspaces
+     */
+    getRegisteredWorkspaces() {
+        return this.localRegistry.getRegisteredWorkspaces();
+    }
+    /**
+     * Invalidate cache for a workspace (convenience method)
+     *
+     * Call this when .principal-views files change to trigger rebuild.
+     */
+    invalidateCache(scopeName) {
+        this.localRegistry.invalidateCache(scopeName);
+    }
+    /**
+     * Cleanup: destroy local registry watchers
+     */
+    destroy() {
+        this.localRegistry.destroy();
+    }
+}
+exports.CompositeRegistry = CompositeRegistry;
+//# sourceMappingURL=CompositeRegistry.js.map

package/dist/registry/CompositeRegistry.js.map

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