@principal-ai/principal-view-core 0.23.13 → 0.24.0

package/dist/index.d.ts

@@ -23,6 +23,7 @@ export type { TemplateSegment, TemplateContext, TemplateValue } from './workflow
 export { selectScenario, getRequiredEvents, hasEventMatching, computeAggregates, getNestedValue, setNestedValue, } from './workflow/scenario-matcher';
 export type { WorkflowTemplate, WorkflowScenario, WorkflowMode, ScenarioTemplate, FlowDirective, LogTemplates, FormattingOptions, OtelEvent, OtelSignal, WorkflowContext, WorkflowResult, ScenarioMatchResult, ScenarioMatchDetail, EnhancedScenarioMatchResult, WorkflowMatch, SpanTreeNode, } from './workflow/types';
 export type { OtelExportTraceServiceRequest, OtelResourceSpansData, OtelScopeSpans, OtelSpanData, OtelResourceData, OtelKeyValue, OtelAnyValue, OtelSpanEvent, OtelLink, OtelSpanStatus, OtelInstrumentationScope, TraceInfo, WorkflowMatchInfo, OtelAttributes, OtelAttributeValue, OtelLog, OtelSpan, OtelResource, OtelSeverity, OtelSeverityText, OtelSeverityNumber, } from './types/otel';
+export type { RegisteredTrace, RegistryLookupResult, StoryboardRegistryInterface, TraceRegistryMatcher, } from './types/registered-trace';
 export { getAttributeStringValue, findAttribute, getAttributeValue, flattenResourceAttributes, parseNanoTime, getSpanDuration, isErrorSeverity, isWarnSeverity, } from './types/otel';
 export type { VersionIdentifier, VersionSnapshot, RegisterVersionRequest, GetVersionResponse, VersionRegistry, } from './types/version-registry';
 export { InMemoryVersionRegistry, createInMemoryVersionRegistry } from './registry/VersionRegistry';

package/dist/index.d.ts.map

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

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkCH,mFAAmF;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,oCAAoC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,2CAA2C;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,iDAAiD;AACjD,mEAAmE;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,6BAA6B,CAAC;AAgDrC,+BAA+B;AAC/B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,cAAc,CAAC;AAUtB,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAEpG,qCAAqC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,mEAAmE;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAiB9D,uEAAuE;AACvE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAO9F,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOvD,gEAAgE;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,oEAAoE;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYlD,+CAA+C;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAqB9D,uFAAuF;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAehE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,aAAa,GACd,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,4FAA4F;AAC5F,mFAAmF;AACnF,EAAE;AACF,kFAAkF;AAClF,mDAAmD;AACnD,oDAAoD;AACpD,+DAA+D;AAC/D,0FAA0F;AAC1F,uDAAuD;AACvD,8CAA8C;AAC9C,qEAAqE;AACrE,gEAAgE;AAChE,EAAE;AACF,wGAAwG;AACxG,sGAAsG;AACtG,sEAAsE;AACtE,uEAAuE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkCH,mFAAmF;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,oCAAoC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,2CAA2C;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,iDAAiD;AACjD,mEAAmE;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,6BAA6B,CAAC;AAwDrC,+BAA+B;AAC/B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,cAAc,CAAC;AAUtB,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAEpG,qCAAqC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,mEAAmE;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAiB9D,uEAAuE;AACvE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAO9F,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOvD,gEAAgE;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,oEAAoE;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYlD,+CAA+C;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAqB9D,uFAAuF;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAehE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,aAAa,GACd,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,4FAA4F;AAC5F,mFAAmF;AACnF,EAAE;AACF,kFAAkF;AAClF,mDAAmD;AACnD,oDAAoD;AACpD,+DAA+D;AAC/D,0FAA0F;AAC1F,uDAAuD;AACvD,8CAA8C;AAC9C,qEAAqE;AACrE,gEAAgE;AAChE,EAAE;AACF,wGAAwG;AACxG,sGAAsG;AACtG,sEAAsE;AACtE,uEAAuE"}

package/dist/types/registered-trace.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Registry-aware trace types
+ *
+ * These types integrate trace data with storyboard registry lookups
+ * to provide complete matching, validation, and routing information.
+ */
+import type { OtelExportTraceServiceRequest } from './otel';
+/**
+ * Registry-aware trace with matching and routing information
+ *
+ * Replaces TraceInfo with a type that knows:
+ * - Whether it's matched to a registered storyboard
+ * - Which schema version should be used
+ * - Where it should be routed/displayed
+ * - Detailed span-to-node matching results
+ */
+export interface RegisteredTrace {
+    /** Unique trace ID */
+    traceId: string;
+    /** Trace name (typically root span name) */
+    name: string;
+    /** Start timestamp (milliseconds) */
+    startTime: number;
+    /** End timestamp (milliseconds) */
+    endTime: number;
+    /** Duration (milliseconds) */
+    duration: number;
+    /** Number of spans in this trace */
+    spanCount: number;
+    /** Service name from resource attributes */
+    serviceName: string;
+    /** Has any span with error status */
+    hasErrors: boolean;
+    /** Instrumentation scope that created this trace */
+    scope: {
+        /** Scope name (e.g., "checkout-instrumentation") */
+        name: string;
+        /** Scope version (e.g., "2.1.0") - used for schema matching */
+        version?: string;
+        /** Scope-level attributes */
+        attributes?: Record<string, unknown>;
+        /** OTLP schema URL */
+        schemaUrl?: string;
+    };
+    /** Registry matching status */
+    registryStatus: 'matched' | 'unmatched' | 'version-mismatch' | 'not-registered' | 'error';
+    /** Match information (if trace has pv.* attributes) */
+    matchInfo?: {
+        /** Storyboard ID from trace attributes */
+        storyboardId: string;
+        /** Storyboard name from trace attributes */
+        storyboardName: string;
+        /** Workflow ID (optional) */
+        workflowId?: string;
+        /** Workflow name (optional) */
+        workflowName?: string;
+        /** Scenario ID (optional) */
+        scenarioId?: string;
+        /** Scenario name (optional) */
+        scenarioName?: string;
+        /** Resolved schema version (from scope.version or pv.schema.version) */
+        schemaVersion?: string;
+    };
+    /** Registry lookup result */
+    registry?: {
+        /** Is the storyboard registered in the registry? */
+        isRegistered: boolean;
+        /** Registered storyboard ID (may differ from matchInfo.storyboardId) */
+        storyboardId?: string;
+        /** Resolved schema version (what version was actually used) */
+        resolvedVersion?: string;
+        /** Available versions in registry */
+        availableVersions?: string[];
+        /** Latest version in registry */
+        latestVersion?: string;
+        /** Is the resolved version the latest? */
+        isLatestVersion?: boolean;
+        /** Version match status */
+        versionStatus?: 'exact-match' | 'fallback-to-latest' | 'not-found' | 'deprecated';
+    };
+    /** Per-span matching results */
+    spanMatches: Array<{
+        /** Span ID */
+        spanId: string;
+        /** Span name */
+        spanName: string;
+        /** Matched canvas node IDs */
+        matchedNodeIds: string[];
+        /** Timestamp (milliseconds) */
+        timestamp: number;
+        /** Duration (milliseconds) */
+        duration: number;
+        /** Match confidence (optional) */
+        matchConfidence?: 'exact' | 'pattern' | 'wildcard';
+        /** Unmatched reason (if no nodes matched) */
+        unmatchedReason?: 'no-criteria' | 'no-match' | 'excluded';
+    }>;
+    /** Summary of matched nodes across all spans */
+    matchedNodesSummary: {
+        /** Total unique node IDs matched */
+        totalNodesMatched: number;
+        /** Node IDs that matched */
+        matchedNodeIds: string[];
+        /** Nodes in storyboard that didn't match any span */
+        unmatchedNodeIds: string[];
+        /** Coverage percentage (matched nodes / total nodes) */
+        coveragePercent: number;
+    };
+    /** Where should this trace be routed/displayed? */
+    routing: {
+        /** Source URL for routing (from dev.server.url or service.name) */
+        sourceUrl: string;
+        /** Suggested destination (which panel/view should display this) */
+        destination: 'trace-viewer' | 'storyboard-viewer' | 'scenario-viewer' | 'unmatched';
+        /** Routing params (what to open, what to highlight) */
+        params?: {
+            /** Storyboard to open */
+            storyboardId?: string;
+            /** Workflow to select */
+            workflowId?: string;
+            /** Scenario to show */
+            scenarioId?: string;
+            /** Nodes to highlight */
+            highlightNodeIds?: string[];
+            /** Schema version to use */
+            schemaVersion?: string;
+        };
+    };
+    /** Validation issues found during matching */
+    validationIssues?: Array<{
+        /** Issue severity */
+        level: 'error' | 'warning' | 'info';
+        /** Issue category */
+        category: 'registry' | 'version' | 'matching' | 'data';
+        /** Human-readable message */
+        message: string;
+        /** Affected span ID (if span-specific) */
+        spanId?: string;
+        /** Suggested fix */
+        suggestion?: string;
+    }>;
+    /** Reference to full OTLP data (if needed for details) */
+    otlpData?: OtelExportTraceServiceRequest;
+}
+/**
+ * Registry lookup result
+ */
+export interface RegistryLookupResult {
+    /** Is the storyboard registered? */
+    isRegistered: boolean;
+    /** Storyboard ID */
+    storyboardId?: string;
+    /** Resolved schema version */
+    resolvedVersion?: string;
+    /** Available versions */
+    availableVersions?: string[];
+    /** Latest version */
+    latestVersion?: string;
+    /** Is latest version? */
+    isLatestVersion?: boolean;
+    /** Version match status */
+    versionStatus?: 'exact-match' | 'fallback-to-latest' | 'not-found' | 'deprecated';
+}
+/**
+ * Interface for storyboard registry
+ *
+ * This is implemented by the main process and injected into the
+ * OTEL collector server for trace matching.
+ */
+export interface StoryboardRegistryInterface {
+    /**
+     * Look up a storyboard by ID and optional version
+     */
+    lookup(storyboardId: string, schemaVersion?: string): Promise<RegistryLookupResult>;
+    /**
+     * Get list of registered storyboard IDs
+     */
+    listStoryboards(): Promise<string[]>;
+    /**
+     * Check if a storyboard is registered
+     */
+    isRegistered(storyboardId: string): Promise<boolean>;
+}
+/**
+ * Interface for trace registry matcher
+ *
+ * Converts OTLP traces to RegisteredTrace with full registry information.
+ */
+export interface TraceRegistryMatcher {
+    /**
+     * Match a trace against the registry and enrich with routing info
+     */
+    matchTrace(otlpData: OtelExportTraceServiceRequest): Promise<RegisteredTrace>;
+    /**
+     * Resolve schema version for a trace
+     */
+    resolveSchemaVersion(storyboardId: string, scopeVersion?: string, scopeAttributes?: Record<string, unknown>): Promise<{
+        resolvedVersion?: string;
+        versionStatus: 'exact-match' | 'fallback-to-latest' | 'not-found';
+        availableVersions: string[];
+    }>;
+}
+//# sourceMappingURL=registered-trace.d.ts.map

package/dist/types/registered-trace.d.ts.map

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

package/dist/types/registered-trace.js

@@ -0,0 +1,8 @@
+/**
+ * Registry-aware trace types
+ *
+ * These types integrate trace data with storyboard registry lookups
+ * to provide complete matching, validation, and routing information.
+ */
+export {};
+//# sourceMappingURL=registered-trace.js.map

package/dist/types/registered-trace.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principal-ai/principal-view-core",
-  "version": "0.23.13",
+  "version": "0.24.0",
   "description": "Core logic and types for graph-based principal view framework",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/index.ts

@@ -114,6 +114,14 @@ export type {
   OtelSeverityNumber,
 } from './types/otel';
 
+// Export registry-aware trace types
+export type {
+  RegisteredTrace,
+  RegistryLookupResult,
+  StoryboardRegistryInterface,
+  TraceRegistryMatcher,
+} from './types/registered-trace';
+
 // Export OTEL helper functions
 export {
   getAttributeStringValue,

package/src/types/registered-trace.ts

@@ -0,0 +1,298 @@
+/**
+ * Registry-aware trace types
+ *
+ * These types integrate trace data with storyboard registry lookups
+ * to provide complete matching, validation, and routing information.
+ */
+
+import type { OtelExportTraceServiceRequest } from './otel';
+
+/**
+ * Registry-aware trace with matching and routing information
+ *
+ * Replaces TraceInfo with a type that knows:
+ * - Whether it's matched to a registered storyboard
+ * - Which schema version should be used
+ * - Where it should be routed/displayed
+ * - Detailed span-to-node matching results
+ */
+export interface RegisteredTrace {
+  // ============================================================================
+  // Core Trace Identity
+  // ============================================================================
+
+  /** Unique trace ID */
+  traceId: string;
+
+  /** Trace name (typically root span name) */
+  name: string;
+
+  /** Start timestamp (milliseconds) */
+  startTime: number;
+
+  /** End timestamp (milliseconds) */
+  endTime: number;
+
+  /** Duration (milliseconds) */
+  duration: number;
+
+  /** Number of spans in this trace */
+  spanCount: number;
+
+  /** Service name from resource attributes */
+  serviceName: string;
+
+  /** Has any span with error status */
+  hasErrors: boolean;
+
+  // ============================================================================
+  // Instrumentation Scope (for versioning)
+  // ============================================================================
+
+  /** Instrumentation scope that created this trace */
+  scope: {
+    /** Scope name (e.g., "checkout-instrumentation") */
+    name: string;
+
+    /** Scope version (e.g., "2.1.0") - used for schema matching */
+    version?: string;
+
+    /** Scope-level attributes */
+    attributes?: Record<string, unknown>;
+
+    /** OTLP schema URL */
+    schemaUrl?: string;
+  };
+
+  // ============================================================================
+  // Registry Matching Status
+  // ============================================================================
+
+  /** Registry matching status */
+  registryStatus: 'matched' | 'unmatched' | 'version-mismatch' | 'not-registered' | 'error';
+
+  /** Match information (if trace has pv.* attributes) */
+  matchInfo?: {
+    /** Storyboard ID from trace attributes */
+    storyboardId: string;
+
+    /** Storyboard name from trace attributes */
+    storyboardName: string;
+
+    /** Workflow ID (optional) */
+    workflowId?: string;
+
+    /** Workflow name (optional) */
+    workflowName?: string;
+
+    /** Scenario ID (optional) */
+    scenarioId?: string;
+
+    /** Scenario name (optional) */
+    scenarioName?: string;
+
+    /** Resolved schema version (from scope.version or pv.schema.version) */
+    schemaVersion?: string;
+  };
+
+  /** Registry lookup result */
+  registry?: {
+    /** Is the storyboard registered in the registry? */
+    isRegistered: boolean;
+
+    /** Registered storyboard ID (may differ from matchInfo.storyboardId) */
+    storyboardId?: string;
+
+    /** Resolved schema version (what version was actually used) */
+    resolvedVersion?: string;
+
+    /** Available versions in registry */
+    availableVersions?: string[];
+
+    /** Latest version in registry */
+    latestVersion?: string;
+
+    /** Is the resolved version the latest? */
+    isLatestVersion?: boolean;
+
+    /** Version match status */
+    versionStatus?: 'exact-match' | 'fallback-to-latest' | 'not-found' | 'deprecated';
+  };
+
+  // ============================================================================
+  // Span Matching Results
+  // ============================================================================
+
+  /** Per-span matching results */
+  spanMatches: Array<{
+    /** Span ID */
+    spanId: string;
+
+    /** Span name */
+    spanName: string;
+
+    /** Matched canvas node IDs */
+    matchedNodeIds: string[];
+
+    /** Timestamp (milliseconds) */
+    timestamp: number;
+
+    /** Duration (milliseconds) */
+    duration: number;
+
+    /** Match confidence (optional) */
+    matchConfidence?: 'exact' | 'pattern' | 'wildcard';
+
+    /** Unmatched reason (if no nodes matched) */
+    unmatchedReason?: 'no-criteria' | 'no-match' | 'excluded';
+  }>;
+
+  /** Summary of matched nodes across all spans */
+  matchedNodesSummary: {
+    /** Total unique node IDs matched */
+    totalNodesMatched: number;
+
+    /** Node IDs that matched */
+    matchedNodeIds: string[];
+
+    /** Nodes in storyboard that didn't match any span */
+    unmatchedNodeIds: string[];
+
+    /** Coverage percentage (matched nodes / total nodes) */
+    coveragePercent: number;
+  };
+
+  // ============================================================================
+  // Routing Information
+  // ============================================================================
+
+  /** Where should this trace be routed/displayed? */
+  routing: {
+    /** Source URL for routing (from dev.server.url or service.name) */
+    sourceUrl: string;
+
+    /** Suggested destination (which panel/view should display this) */
+    destination: 'trace-viewer' | 'storyboard-viewer' | 'scenario-viewer' | 'unmatched';
+
+    /** Routing params (what to open, what to highlight) */
+    params?: {
+      /** Storyboard to open */
+      storyboardId?: string;
+
+      /** Workflow to select */
+      workflowId?: string;
+
+      /** Scenario to show */
+      scenarioId?: string;
+
+      /** Nodes to highlight */
+      highlightNodeIds?: string[];
+
+      /** Schema version to use */
+      schemaVersion?: string;
+    };
+  };
+
+  // ============================================================================
+  // Validation Errors/Warnings
+  // ============================================================================
+
+  /** Validation issues found during matching */
+  validationIssues?: Array<{
+    /** Issue severity */
+    level: 'error' | 'warning' | 'info';
+
+    /** Issue category */
+    category: 'registry' | 'version' | 'matching' | 'data';
+
+    /** Human-readable message */
+    message: string;
+
+    /** Affected span ID (if span-specific) */
+    spanId?: string;
+
+    /** Suggested fix */
+    suggestion?: string;
+  }>;
+
+  // ============================================================================
+  // Raw Data Reference (for details view)
+  // ============================================================================
+
+  /** Reference to full OTLP data (if needed for details) */
+  otlpData?: OtelExportTraceServiceRequest;
+}
+
+/**
+ * Registry lookup result
+ */
+export interface RegistryLookupResult {
+  /** Is the storyboard registered? */
+  isRegistered: boolean;
+
+  /** Storyboard ID */
+  storyboardId?: string;
+
+  /** Resolved schema version */
+  resolvedVersion?: string;
+
+  /** Available versions */
+  availableVersions?: string[];
+
+  /** Latest version */
+  latestVersion?: string;
+
+  /** Is latest version? */
+  isLatestVersion?: boolean;
+
+  /** Version match status */
+  versionStatus?: 'exact-match' | 'fallback-to-latest' | 'not-found' | 'deprecated';
+}
+
+/**
+ * Interface for storyboard registry
+ *
+ * This is implemented by the main process and injected into the
+ * OTEL collector server for trace matching.
+ */
+export interface StoryboardRegistryInterface {
+  /**
+   * Look up a storyboard by ID and optional version
+   */
+  lookup(storyboardId: string, schemaVersion?: string): Promise<RegistryLookupResult>;
+
+  /**
+   * Get list of registered storyboard IDs
+   */
+  listStoryboards(): Promise<string[]>;
+
+  /**
+   * Check if a storyboard is registered
+   */
+  isRegistered(storyboardId: string): Promise<boolean>;
+}
+
+/**
+ * Interface for trace registry matcher
+ *
+ * Converts OTLP traces to RegisteredTrace with full registry information.
+ */
+export interface TraceRegistryMatcher {
+  /**
+   * Match a trace against the registry and enrich with routing info
+   */
+  matchTrace(otlpData: OtelExportTraceServiceRequest): Promise<RegisteredTrace>;
+
+  /**
+   * Resolve schema version for a trace
+   */
+  resolveSchemaVersion(
+    storyboardId: string,
+    scopeVersion?: string,
+    scopeAttributes?: Record<string, unknown>
+  ): Promise<{
+    resolvedVersion?: string;
+    versionStatus: 'exact-match' | 'fallback-to-latest' | 'not-found';
+    availableVersions: string[];
+  }>;
+}