@principal-ai/subsystems-core 0.29.0 → 0.30.0

package/dist/parsers/OtlpTraceParser.js

@@ -1,310 +0,0 @@
-"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

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

package/dist/registry/CompositeRegistry.d.ts

@@ -1,71 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,113 +0,0 @@
-"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

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

package/dist/registry/EventRegistry.d.ts

@@ -1,79 +0,0 @@
-/**
- * EventRegistry - indexes events across library and canvases
- *
- * Provides a centralized registry for looking up where events are defined,
- * enabling improved validation error messages with actionable suggestions.
- */
-import type { ComponentLibrary } from '../types/library';
-import type { ExtendedCanvas, PVEventSchema } from '../types/canvas';
-/**
- * Describes where an event is defined
- */
-export interface EventSource {
-    /** Whether the event is defined in the library or a canvas */
-    type: 'library' | 'canvas';
-    /** Path to the source file (library.yaml path or canvas path) */
-    path: string;
-    /** The full event schema if available */
-    eventSchema?: PVEventSchema;
-}
-/**
- * EventRegistry indexes all events across a library and set of canvases.
- *
- * Build order (priority):
- * 1. Library eventSchemas (the intended sharing mechanism)
- * 2. Canvas inline events (pv.event)
- * 3. Canvas eventRefs (pv.eventRef) - these reference library schemas
- *
- * Usage:
- * ```typescript
- * const registry = EventRegistry.build(library, canvases, libraryPath);
- * const sources = registry.findEvent('cleanup.started');
- * if (sources.length > 0) {
- *   // Event found - provide helpful error message
- * }
- * ```
- */
-export declare class EventRegistry {
-    private events;
-    private constructor();
-    /**
-     * Build an EventRegistry from a library and set of canvases.
-     *
-     * @param library - The component library (may be undefined)
-     * @param canvases - Map of canvas path to parsed canvas
-     * @param libraryPath - Path to the library file (for error messages)
-     * @returns A populated EventRegistry
-     */
-    static build(library: ComponentLibrary | undefined, canvases: Map<string, ExtendedCanvas>, libraryPath?: string): EventRegistry;
-    /**
-     * Add an event source to the registry
-     */
-    private addEvent;
-    /**
-     * Find all sources where an event is defined.
-     * Returns library sources first, then canvas sources.
-     *
-     * @param eventName - The event name to look up
-     * @returns Array of EventSource objects, empty if not found
-     */
-    findEvent(eventName: string): EventSource[];
-    /**
-     * Check if an event exists anywhere in the registry.
-     *
-     * @param eventName - The event name to check
-     * @returns true if the event is defined somewhere
-     */
-    hasEvent(eventName: string): boolean;
-    /**
-     * Get all known event names in the registry.
-     *
-     * @returns Array of event names, sorted alphabetically
-     */
-    getAllEventNames(): string[];
-    /**
-     * Get the count of registered events.
-     */
-    get size(): number;
-}
-//# sourceMappingURL=EventRegistry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"EventRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/EventRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA6B;IAE3C,OAAO;IAIP;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CACV,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACrC,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa;IA6EhB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAShB;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE;IAU3C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}