@principal-ai/subsystems-core 0.29.0

package/dist/node.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @principal-ai/subsystems-core/node
+ * Node.js-specific exports (require Node.js runtime)
+ *
+ * This entry point includes all functionality that depends on Node.js modules
+ * such as fs, path, glob, and other Node.js-only dependencies.
+ *
+ * The main entry point ('@principal-ai/subsystems-core') exports browser-safe
+ * functionality that works in any environment. Use this /node entry point when you
+ * need Node.js-specific utilities like buildFileTreeFromDirectory.
+ */
+export * from './types';
+export { TopicStore, PRINCIPAL_DIR, TOPICS_DIR, LEGACY_TOPICS_BLOB, } from './storage/topicStore';
+export type { TopicIndexEntry, TopicCreate, TopicUpdate, MigrationResult, } from './storage/topicStore';
+export { publishedFromDraft } from './storage/topic-types';
+export type { DraftTopic, PublishedTopic, PublishProjection, TopicStatus, TopicAsset, TopicCreator, } from './storage/topic-types';
+export { EventProcessor } from './EventProcessor';
+export type { ProcessingResult } from './EventProcessor';
+export { ValidationEngine } from './ValidationEngine';
+export { ConfigurationValidator } from './ConfigurationValidator';
+export type { ConfigurationValidationError, ConfigurationValidationResult, } from './ConfigurationValidator';
+export { GraphInstrumentationHelper } from './helpers/GraphInstrumentationHelper';
+export { PathBasedEventProcessor } from './PathBasedEventProcessor';
+export type { LogEntry } from './PathBasedEventProcessor';
+export { PathMatcher } from './utils/PathMatcher';
+export { GraphConverter } from './utils/GraphConverter';
+export * from './types/canvas';
+export { CanvasConverter } from './utils/CanvasConverter';
+export type { ReactFlowNode, ReactFlowEdge } from './utils/CanvasConverter';
+export { EventValidator, createValidatedEmitter, EventValidationError } from './telemetry/event-validator';
+export type { ValidationResult } from './telemetry/event-validator';
+export { analyzeCoverage } from './telemetry/coverage';
+export type { CoverageMetrics, FileInstrumentation, PackageCoverageMetrics, } from './telemetry/coverage';
+export { generateTypes, TypeScriptGenerator, generatorRegistry } from './codegen/type-generator';
+export type { CodegenOptions, CodegenResult, CodeGenerator } from './codegen/type-generator';
+export { traceToCanvas, traceToCanvasJson } from './utils/TraceToCanvas';
+export type { TraceSpan, TraceExport, TraceToCanvasOptions, TraceCanvasResult, } from './utils/TraceToCanvas';
+export { SessionManager } from './SessionManager';
+export type { SessionStatus, SessionResult, SessionMetadata, EventSession, CreateSessionOptions, EndSessionOptions, SessionChangeCallback, SessionManagerConfig, } from './SessionManager';
+export { EventRecorderService } from './EventRecorderService';
+export type { ProtocolMessageType, ProtocolMessage, SessionStartMessage, SessionEndMessage, LogMessage, LogBatchMessage, PingMessage, PongMessage, ErrorMessage, AckMessage, IncomingMessage, OutgoingMessage, RecordingMode, EventCallback, EventBatchCallback, ConnectionState, EventRecorderServiceConfig, } from './EventRecorderService';
+export { ConfigurationLoader } from './ConfigurationLoader';
+export type { ConfigurationFile, ConfigurationLoadResult } from './ConfigurationLoader';
+export { parseYaml, isYamlFile, getConfigNameFromFilename } from './utils/YamlParser';
+export type { YamlParseResult } from './utils/YamlParser';
+export { LibraryLoader } from './LibraryLoader';
+export { EventRegistry } from './registry/EventRegistry';
+export type { EventSource } from './registry/EventRegistry';
+export { OpenCodeEventStore, defaultOpenCodeDBPath } from './opencode/OpenCodeEventStore';
+export type { OpenCodeRawEvent, OpenCodeSessionEvents, OpenCodeEventRetriever, OpenCodeStoreOptions, SessionSummary, SessionListResult } from './opencode/types';
+export { listAgentSessions, detectAgent, fetchRawEvents } from './opencode/agent-sessions';
+export type { AgentSessionSummary, AgentSessionMeta, SupportedSessionAgent } from './opencode/agent-sessions';
+export { buildAgentSessionFixture } from './agent-sessions/fixture';
+export type { AgentSessionFixture, AgentSessionFixtureMeta, AgentSessionFixtureRepo, AgentSessionFixtureSummary, FixtureAgentSessionEvent, FixtureHighlightLayer, FixtureLayerItem, } from './agent-sessions/fixture';
+export { NodePathNormalizationAdapter, normalizeEvents, normalizeEventsWithAdapter, accumulateEvents, collectRepositories, opencodeRowsToUniversalEvents, } from './opencode/pipeline';
+export type { OpenCodeEventRow } from './opencode/pipeline';
+export type { FileSystemAdapter } from '@principal-ai/repository-abstraction';
+export { InMemoryFileSystemAdapter } from '@principal-ai/repository-abstraction';
+export * from './rules';
+export { renderWorkflow, parseTemplate, ParsedTemplate, selectScenario, getRequiredEvents, hasEventMatching, computeAggregates, getNestedValue, setNestedValue, createWorkflowValidator, WorkflowValidator, } from './workflow';
+export type { TemplateSegment, WorkflowTemplate, WorkflowScenario, ScenarioTemplate, LogTemplates, FormattingOptions, OtelEvent, OtelSignal, WorkflowContext, WorkflowResult, ScenarioMatchResult, SpanTreeNode, WorkflowValidationContext, WorkflowViolation, WorkflowValidationResult, } from './workflow';
+export { CanvasDiscovery } from './discovery/CanvasDiscovery';
+export type { DiscoveredCanvas, DiscoveredTestTrace, CanvasDiscoveryResult, DiscoveryOptions, CanvasType, TestTraceType, DiscoveredCanvasWithContent, DiscoveredTestTraceWithContent, CanvasDiscoveryResultWithContent, } from './discovery/types';
+export { LibraryDiscovery } from './discovery/LibraryDiscovery';
+export type { DiscoveredLibrary, LibraryDiscoveryResult, LibraryValidationError, LibraryValidationErrorType, } from './discovery/LibraryDiscovery';
+export { ExecutionValidator, createExecutionValidator } from './execution/ExecutionValidator';
+export type { ExecutionData, ValidationError, ExecutionValidationResult, } from './execution/ExecutionValidator';
+export { DashboardValidator, createDashboardValidator } from './dashboard';
+export type { DashboardValidationError, DashboardValidationResult, DashboardValidationContext, } from './dashboard';
+export { ExecutionLoader, createExecutionLoader } from './execution/ExecutionLoader';
+export type { ExecutionFile, ExecutionLoadResult, } from './execution/ExecutionLoader';
+export { ScopesCanvasValidator, ScopePathIndex, validateScopeNamespaceNesting, DEFAULT_SCOPE_COLOR, DRAFT_NODE_COLOR, getScopeNames, getScopeDefinition, getScopeColor, normalizeScopes, buildScopeColorMap, getAllScopeNames, } from './scopes';
+export type { ScopesCanvasValidationContext, ScopesCanvasValidationResult, ScopesCanvasViolation, ScopePathEntry, ScopePathMatch, ScopeEventsCanvasPair, ValidateScopeNamespaceNestingInput, NormalizedScope, } from './scopes';
+export { AuxiliaryManifestValidator, validateAreaScopeDisjoint, } from './auxiliary';
+export type { AuxiliaryManifestValidationContext, AuxiliaryManifestValidationResult, AuxiliaryManifestViolation, ValidateAreaScopeDisjointInput, } from './auxiliary';
+export { EventsCanvasValidator, ScopeEventsValidator, NamespacePathIndex, OtelEventPathsValidator, } from './events';
+export type { EventsCanvasValidationContext, EventsCanvasValidationResult, EventsCanvasViolation, ScopeEventsValidationContext, ScopeEventsValidationResult, ScopeEventsViolation, NamespacePathEntry, NamespacePathMatch, EventsCanvasInput, OtelCanvasInput, OtelEventPathsValidationContext, OtelEventPathsValidationResult, OtelEventPathsViolation, OtelEventPathsRuleId, } from './events';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

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

package/dist/node.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * @principal-ai/subsystems-core/node
+ * Node.js-specific exports (require Node.js runtime)
+ *
+ * This entry point includes all functionality that depends on Node.js modules
+ * such as fs, path, glob, and other Node.js-only dependencies.
+ *
+ * The main entry point ('@principal-ai/subsystems-core') exports browser-safe
+ * functionality that works in any environment. Use this /node entry point when you
+ * need Node.js-specific utilities like buildFileTreeFromDirectory.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeAggregates = exports.hasEventMatching = exports.getRequiredEvents = exports.selectScenario = exports.ParsedTemplate = exports.parseTemplate = exports.renderWorkflow = exports.InMemoryFileSystemAdapter = exports.opencodeRowsToUniversalEvents = exports.collectRepositories = exports.accumulateEvents = exports.normalizeEventsWithAdapter = exports.normalizeEvents = exports.NodePathNormalizationAdapter = exports.buildAgentSessionFixture = exports.fetchRawEvents = exports.detectAgent = exports.listAgentSessions = exports.defaultOpenCodeDBPath = exports.OpenCodeEventStore = exports.EventRegistry = exports.LibraryLoader = exports.getConfigNameFromFilename = exports.isYamlFile = exports.parseYaml = exports.ConfigurationLoader = exports.EventRecorderService = exports.SessionManager = exports.traceToCanvasJson = exports.traceToCanvas = exports.generatorRegistry = exports.TypeScriptGenerator = exports.generateTypes = exports.analyzeCoverage = exports.EventValidationError = exports.createValidatedEmitter = exports.EventValidator = exports.CanvasConverter = exports.GraphConverter = exports.PathMatcher = exports.PathBasedEventProcessor = exports.GraphInstrumentationHelper = exports.ConfigurationValidator = exports.ValidationEngine = exports.EventProcessor = exports.publishedFromDraft = exports.LEGACY_TOPICS_BLOB = exports.TOPICS_DIR = exports.PRINCIPAL_DIR = exports.TopicStore = void 0;
+exports.OtelEventPathsValidator = exports.NamespacePathIndex = exports.ScopeEventsValidator = exports.EventsCanvasValidator = exports.validateAreaScopeDisjoint = exports.AuxiliaryManifestValidator = exports.getAllScopeNames = exports.buildScopeColorMap = exports.normalizeScopes = exports.getScopeColor = exports.getScopeDefinition = exports.getScopeNames = exports.DRAFT_NODE_COLOR = exports.DEFAULT_SCOPE_COLOR = exports.validateScopeNamespaceNesting = exports.ScopePathIndex = exports.ScopesCanvasValidator = exports.createExecutionLoader = exports.ExecutionLoader = exports.createDashboardValidator = exports.DashboardValidator = exports.createExecutionValidator = exports.ExecutionValidator = exports.LibraryDiscovery = exports.CanvasDiscovery = exports.WorkflowValidator = exports.createWorkflowValidator = exports.setNestedValue = exports.getNestedValue = void 0;
+// Export all types (safe in all environments)
+__exportStar(require("./types"), exports);
+// File-per-topic store (~/.principal/topics) — node:fs only. The browser-safe
+// topic types it reads/writes are also re-exported here for node consumers.
+var topicStore_1 = require("./storage/topicStore");
+Object.defineProperty(exports, "TopicStore", { enumerable: true, get: function () { return topicStore_1.TopicStore; } });
+Object.defineProperty(exports, "PRINCIPAL_DIR", { enumerable: true, get: function () { return topicStore_1.PRINCIPAL_DIR; } });
+Object.defineProperty(exports, "TOPICS_DIR", { enumerable: true, get: function () { return topicStore_1.TOPICS_DIR; } });
+Object.defineProperty(exports, "LEGACY_TOPICS_BLOB", { enumerable: true, get: function () { return topicStore_1.LEGACY_TOPICS_BLOB; } });
+var topic_types_1 = require("./storage/topic-types");
+Object.defineProperty(exports, "publishedFromDraft", { enumerable: true, get: function () { return topic_types_1.publishedFromDraft; } });
+// Export core classes (Node.js processing)
+var EventProcessor_1 = require("./EventProcessor");
+Object.defineProperty(exports, "EventProcessor", { enumerable: true, get: function () { return EventProcessor_1.EventProcessor; } });
+var ValidationEngine_1 = require("./ValidationEngine");
+Object.defineProperty(exports, "ValidationEngine", { enumerable: true, get: function () { return ValidationEngine_1.ValidationEngine; } });
+var ConfigurationValidator_1 = require("./ConfigurationValidator");
+Object.defineProperty(exports, "ConfigurationValidator", { enumerable: true, get: function () { return ConfigurationValidator_1.ConfigurationValidator; } });
+// Export helpers
+var GraphInstrumentationHelper_1 = require("./helpers/GraphInstrumentationHelper");
+Object.defineProperty(exports, "GraphInstrumentationHelper", { enumerable: true, get: function () { return GraphInstrumentationHelper_1.GraphInstrumentationHelper; } });
+// Export path-based processing (Milestone 1 & 2)
+var PathBasedEventProcessor_1 = require("./PathBasedEventProcessor");
+Object.defineProperty(exports, "PathBasedEventProcessor", { enumerable: true, get: function () { return PathBasedEventProcessor_1.PathBasedEventProcessor; } });
+// Export path utilities
+var PathMatcher_1 = require("./utils/PathMatcher");
+Object.defineProperty(exports, "PathMatcher", { enumerable: true, get: function () { return PathMatcher_1.PathMatcher; } });
+var GraphConverter_1 = require("./utils/GraphConverter");
+Object.defineProperty(exports, "GraphConverter", { enumerable: true, get: function () { return GraphConverter_1.GraphConverter; } });
+// Export Canvas types and converter
+__exportStar(require("./types/canvas"), exports);
+var CanvasConverter_1 = require("./utils/CanvasConverter");
+Object.defineProperty(exports, "CanvasConverter", { enumerable: true, get: function () { return CanvasConverter_1.CanvasConverter; } });
+// Export telemetry event validation
+var event_validator_1 = require("./telemetry/event-validator");
+Object.defineProperty(exports, "EventValidator", { enumerable: true, get: function () { return event_validator_1.EventValidator; } });
+Object.defineProperty(exports, "createValidatedEmitter", { enumerable: true, get: function () { return event_validator_1.createValidatedEmitter; } });
+Object.defineProperty(exports, "EventValidationError", { enumerable: true, get: function () { return event_validator_1.EventValidationError; } });
+// Export telemetry coverage analysis (re-exported from main for convenience)
+var coverage_1 = require("./telemetry/coverage");
+Object.defineProperty(exports, "analyzeCoverage", { enumerable: true, get: function () { return coverage_1.analyzeCoverage; } });
+// Export code generation (Node.js only - file system operations)
+var type_generator_1 = require("./codegen/type-generator");
+Object.defineProperty(exports, "generateTypes", { enumerable: true, get: function () { return type_generator_1.generateTypes; } });
+Object.defineProperty(exports, "TypeScriptGenerator", { enumerable: true, get: function () { return type_generator_1.TypeScriptGenerator; } });
+Object.defineProperty(exports, "generatorRegistry", { enumerable: true, get: function () { return type_generator_1.generatorRegistry; } });
+// Export trace-to-canvas conversion
+var TraceToCanvas_1 = require("./utils/TraceToCanvas");
+Object.defineProperty(exports, "traceToCanvas", { enumerable: true, get: function () { return TraceToCanvas_1.traceToCanvas; } });
+Object.defineProperty(exports, "traceToCanvasJson", { enumerable: true, get: function () { return TraceToCanvas_1.traceToCanvasJson; } });
+// Export session management (Event Recording System)
+var SessionManager_1 = require("./SessionManager");
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return SessionManager_1.SessionManager; } });
+// Export event recorder service
+var EventRecorderService_1 = require("./EventRecorderService");
+Object.defineProperty(exports, "EventRecorderService", { enumerable: true, get: function () { return EventRecorderService_1.EventRecorderService; } });
+// Export configuration loading (Node.js only - file system)
+var ConfigurationLoader_1 = require("./ConfigurationLoader");
+Object.defineProperty(exports, "ConfigurationLoader", { enumerable: true, get: function () { return ConfigurationLoader_1.ConfigurationLoader; } });
+var YamlParser_1 = require("./utils/YamlParser");
+Object.defineProperty(exports, "parseYaml", { enumerable: true, get: function () { return YamlParser_1.parseYaml; } });
+Object.defineProperty(exports, "isYamlFile", { enumerable: true, get: function () { return YamlParser_1.isYamlFile; } });
+Object.defineProperty(exports, "getConfigNameFromFilename", { enumerable: true, get: function () { return YamlParser_1.getConfigNameFromFilename; } });
+// Export component library support (Node.js only - file system)
+var LibraryLoader_1 = require("./LibraryLoader");
+Object.defineProperty(exports, "LibraryLoader", { enumerable: true, get: function () { return LibraryLoader_1.LibraryLoader; } });
+// Export event registry (for cross-canvas event lookup)
+var EventRegistry_1 = require("./registry/EventRegistry");
+Object.defineProperty(exports, "EventRegistry", { enumerable: true, get: function () { return EventRegistry_1.EventRegistry; } });
+// Export opencode event retrieval (Node.js only - SQLite)
+var OpenCodeEventStore_1 = require("./opencode/OpenCodeEventStore");
+Object.defineProperty(exports, "OpenCodeEventStore", { enumerable: true, get: function () { return OpenCodeEventStore_1.OpenCodeEventStore; } });
+Object.defineProperty(exports, "defaultOpenCodeDBPath", { enumerable: true, get: function () { return OpenCodeEventStore_1.defaultOpenCodeDBPath; } });
+// Export shared, agent-agnostic session listing/fetch/normalization (Node.js only)
+var agent_sessions_1 = require("./opencode/agent-sessions");
+Object.defineProperty(exports, "listAgentSessions", { enumerable: true, get: function () { return agent_sessions_1.listAgentSessions; } });
+Object.defineProperty(exports, "detectAgent", { enumerable: true, get: function () { return agent_sessions_1.detectAgent; } });
+Object.defineProperty(exports, "fetchRawEvents", { enumerable: true, get: function () { return agent_sessions_1.fetchRawEvents; } });
+// Export the frozen-fixture generator (Node.js only — runs git walk-up)
+var fixture_1 = require("./agent-sessions/fixture");
+Object.defineProperty(exports, "buildAgentSessionFixture", { enumerable: true, get: function () { return fixture_1.buildAgentSessionFixture; } });
+// Export the pure, runtime-agnostic session pipeline (no SQLite dependency)
+var pipeline_1 = require("./opencode/pipeline");
+Object.defineProperty(exports, "NodePathNormalizationAdapter", { enumerable: true, get: function () { return pipeline_1.NodePathNormalizationAdapter; } });
+Object.defineProperty(exports, "normalizeEvents", { enumerable: true, get: function () { return pipeline_1.normalizeEvents; } });
+Object.defineProperty(exports, "normalizeEventsWithAdapter", { enumerable: true, get: function () { return pipeline_1.normalizeEventsWithAdapter; } });
+Object.defineProperty(exports, "accumulateEvents", { enumerable: true, get: function () { return pipeline_1.accumulateEvents; } });
+Object.defineProperty(exports, "collectRepositories", { enumerable: true, get: function () { return pipeline_1.collectRepositories; } });
+Object.defineProperty(exports, "opencodeRowsToUniversalEvents", { enumerable: true, get: function () { return pipeline_1.opencodeRowsToUniversalEvents; } });
+var repository_abstraction_1 = require("@principal-ai/repository-abstraction");
+Object.defineProperty(exports, "InMemoryFileSystemAdapter", { enumerable: true, get: function () { return repository_abstraction_1.InMemoryFileSystemAdapter; } });
+// Export rules engine (Node.js only - OpenTelemetry dependencies)
+__exportStar(require("./rules"), exports);
+// Export workflow template system (full system including Node.js validator)
+var workflow_1 = require("./workflow");
+Object.defineProperty(exports, "renderWorkflow", { enumerable: true, get: function () { return workflow_1.renderWorkflow; } });
+Object.defineProperty(exports, "parseTemplate", { enumerable: true, get: function () { return workflow_1.parseTemplate; } });
+Object.defineProperty(exports, "ParsedTemplate", { enumerable: true, get: function () { return workflow_1.ParsedTemplate; } });
+Object.defineProperty(exports, "selectScenario", { enumerable: true, get: function () { return workflow_1.selectScenario; } });
+Object.defineProperty(exports, "getRequiredEvents", { enumerable: true, get: function () { return workflow_1.getRequiredEvents; } });
+Object.defineProperty(exports, "hasEventMatching", { enumerable: true, get: function () { return workflow_1.hasEventMatching; } });
+Object.defineProperty(exports, "computeAggregates", { enumerable: true, get: function () { return workflow_1.computeAggregates; } });
+Object.defineProperty(exports, "getNestedValue", { enumerable: true, get: function () { return workflow_1.getNestedValue; } });
+Object.defineProperty(exports, "setNestedValue", { enumerable: true, get: function () { return workflow_1.setNestedValue; } });
+Object.defineProperty(exports, "createWorkflowValidator", { enumerable: true, get: function () { return workflow_1.createWorkflowValidator; } });
+Object.defineProperty(exports, "WorkflowValidator", { enumerable: true, get: function () { return workflow_1.WorkflowValidator; } });
+// Export canvas, workflow, and test trace discovery
+var CanvasDiscovery_1 = require("./discovery/CanvasDiscovery");
+Object.defineProperty(exports, "CanvasDiscovery", { enumerable: true, get: function () { return CanvasDiscovery_1.CanvasDiscovery; } });
+// Export library discovery
+var LibraryDiscovery_1 = require("./discovery/LibraryDiscovery");
+Object.defineProperty(exports, "LibraryDiscovery", { enumerable: true, get: function () { return LibraryDiscovery_1.LibraryDiscovery; } });
+// Export execution validation
+var ExecutionValidator_1 = require("./execution/ExecutionValidator");
+Object.defineProperty(exports, "ExecutionValidator", { enumerable: true, get: function () { return ExecutionValidator_1.ExecutionValidator; } });
+Object.defineProperty(exports, "createExecutionValidator", { enumerable: true, get: function () { return ExecutionValidator_1.createExecutionValidator; } });
+// Export dashboard validation
+var dashboard_1 = require("./dashboard");
+Object.defineProperty(exports, "DashboardValidator", { enumerable: true, get: function () { return dashboard_1.DashboardValidator; } });
+Object.defineProperty(exports, "createDashboardValidator", { enumerable: true, get: function () { return dashboard_1.createDashboardValidator; } });
+// Export execution loading (Node.js only - file system)
+var ExecutionLoader_1 = require("./execution/ExecutionLoader");
+Object.defineProperty(exports, "ExecutionLoader", { enumerable: true, get: function () { return ExecutionLoader_1.ExecutionLoader; } });
+Object.defineProperty(exports, "createExecutionLoader", { enumerable: true, get: function () { return ExecutionLoader_1.createExecutionLoader; } });
+// Export scopes module (canvas validation + scope utilities)
+var scopes_1 = require("./scopes");
+Object.defineProperty(exports, "ScopesCanvasValidator", { enumerable: true, get: function () { return scopes_1.ScopesCanvasValidator; } });
+Object.defineProperty(exports, "ScopePathIndex", { enumerable: true, get: function () { return scopes_1.ScopePathIndex; } });
+Object.defineProperty(exports, "validateScopeNamespaceNesting", { enumerable: true, get: function () { return scopes_1.validateScopeNamespaceNesting; } });
+Object.defineProperty(exports, "DEFAULT_SCOPE_COLOR", { enumerable: true, get: function () { return scopes_1.DEFAULT_SCOPE_COLOR; } });
+Object.defineProperty(exports, "DRAFT_NODE_COLOR", { enumerable: true, get: function () { return scopes_1.DRAFT_NODE_COLOR; } });
+Object.defineProperty(exports, "getScopeNames", { enumerable: true, get: function () { return scopes_1.getScopeNames; } });
+Object.defineProperty(exports, "getScopeDefinition", { enumerable: true, get: function () { return scopes_1.getScopeDefinition; } });
+Object.defineProperty(exports, "getScopeColor", { enumerable: true, get: function () { return scopes_1.getScopeColor; } });
+Object.defineProperty(exports, "normalizeScopes", { enumerable: true, get: function () { return scopes_1.normalizeScopes; } });
+Object.defineProperty(exports, "buildScopeColorMap", { enumerable: true, get: function () { return scopes_1.buildScopeColorMap; } });
+Object.defineProperty(exports, "getAllScopeNames", { enumerable: true, get: function () { return scopes_1.getAllScopeNames; } });
+// Export auxiliary module (manifest validation for non-OTEL project regions)
+var auxiliary_1 = require("./auxiliary");
+Object.defineProperty(exports, "AuxiliaryManifestValidator", { enumerable: true, get: function () { return auxiliary_1.AuxiliaryManifestValidator; } });
+Object.defineProperty(exports, "validateAreaScopeDisjoint", { enumerable: true, get: function () { return auxiliary_1.validateAreaScopeDisjoint; } });
+// Export events module (canvas validation)
+var events_1 = require("./events");
+Object.defineProperty(exports, "EventsCanvasValidator", { enumerable: true, get: function () { return events_1.EventsCanvasValidator; } });
+Object.defineProperty(exports, "ScopeEventsValidator", { enumerable: true, get: function () { return events_1.ScopeEventsValidator; } });
+Object.defineProperty(exports, "NamespacePathIndex", { enumerable: true, get: function () { return events_1.NamespacePathIndex; } });
+Object.defineProperty(exports, "OtelEventPathsValidator", { enumerable: true, get: function () { return events_1.OtelEventPathsValidator; } });
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/opencode/OpenCodeEventStore.d.ts

@@ -0,0 +1,25 @@
+import type { OpenCodeSessionEvents, OpenCodeEventRetriever, OpenCodeStoreOptions, SessionListResult } from "./types";
+export declare function defaultOpenCodeDBPath(): string;
+export declare class OpenCodeEventStore implements OpenCodeEventRetriever {
+    private db;
+    constructor(options?: OpenCodeStoreOptions);
+    getSessionMeta(sessionId: string): {
+        slug: string;
+        title: string;
+        directory: string;
+    };
+    readAggregate(sessionId: string, options?: {
+        after?: number;
+        limit?: number;
+    }): OpenCodeSessionEvents;
+    listSessionIds(limit?: number): string[];
+    listSessionsWithSummaries(limit?: number): SessionListResult;
+    /**
+     * opencode stores a placeholder title ("New session - <iso timestamp>") on
+     * sessions it never generated a title for. Surface the first real user prompt
+     * text instead so lists read as actual tasks.
+     */
+    firstUserPromptText(aggregateId: string): string;
+    close(): void;
+}
+//# sourceMappingURL=OpenCodeEventStore.d.ts.map

package/dist/opencode/OpenCodeEventStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenCodeEventStore.d.ts","sourceRoot":"","sources":["../../src/opencode/OpenCodeEventStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EAEpB,iBAAiB,EAClB,MAAM,SAAS,CAAA;AAEhB,wBAAgB,qBAAqB,IAAI,MAAM,CAK9C;AAED,qBAAa,kBAAmB,YAAW,sBAAsB;IAC/D,OAAO,CAAC,EAAE,CAAmB;gBAEjB,OAAO,CAAC,EAAE,oBAAoB;IAK1C,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;QACjC,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,CAAA;KAClB;IAkBD,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,qBAAqB;IAgCxB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAOxC,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB;IA2F5D;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAyBhD,KAAK,IAAI,IAAI;CAGd"}

package/dist/opencode/OpenCodeEventStore.js

@@ -0,0 +1,182 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenCodeEventStore = exports.defaultOpenCodeDBPath = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+function defaultOpenCodeDBPath() {
+    if (process.env.OPENCODE_DATA_DIR)
+        return `${process.env.OPENCODE_DATA_DIR}/opencode/opencode.db`;
+    const home = process.env.HOME || process.env.USERPROFILE || "/root";
+    const xdgData = process.env.XDG_DATA_HOME || `${home}/.local/share`;
+    return `${xdgData}/opencode/opencode.db`;
+}
+exports.defaultOpenCodeDBPath = defaultOpenCodeDBPath;
+class OpenCodeEventStore {
+    constructor(options) {
+        const path = options?.dbPath ?? defaultOpenCodeDBPath();
+        this.db = new better_sqlite3_1.default(path, { readonly: true });
+    }
+    getSessionMeta(sessionId) {
+        try {
+            const row = this.db
+                .prepare("SELECT slug, title, directory FROM session WHERE id = ?")
+                .get(sessionId);
+            if (row) {
+                return {
+                    slug: row.slug ?? "",
+                    title: row.title ?? "",
+                    directory: row.directory ?? "",
+                };
+            }
+        }
+        catch {
+            // session table may not exist in older DBs; fall through
+        }
+        return { slug: "", title: "", directory: "" };
+    }
+    readAggregate(sessionId, options) {
+        const after = options?.after ?? -1;
+        const limit = options?.limit ?? 1000;
+        const rows = this.db
+            .prepare("SELECT id, aggregate_id, seq, type, data FROM event WHERE aggregate_id = ? AND seq > ? ORDER BY seq ASC LIMIT ?")
+            .all(sessionId, after, limit + 1);
+        const page = rows.slice(0, limit);
+        const events = page.map((row) => ({
+            id: row.id,
+            aggregateId: row.aggregate_id,
+            seq: row.seq,
+            type: row.type,
+            data: typeof row.data === "string" ? JSON.parse(row.data) : row.data,
+        }));
+        return {
+            sessionId,
+            events,
+            hasMore: rows.length > limit,
+        };
+    }
+    listSessionIds(limit) {
+        const rows = this.db
+            .prepare("SELECT DISTINCT aggregate_id FROM event ORDER BY aggregate_id LIMIT ?")
+            .all(limit ?? 50);
+        return rows.map((r) => r.aggregate_id);
+    }
+    listSessionsWithSummaries(limit) {
+        const effectiveLimit = limit ?? 50;
+        const firstEvents = this.db
+            .prepare(`SELECT e.aggregate_id, e.data,
+          (SELECT COUNT(*) FROM event WHERE aggregate_id = e.aggregate_id) AS event_count,
+          (SELECT MAX(json_extract(e2.data, '$.info.time.created')) FROM event e2 WHERE e2.aggregate_id = e.aggregate_id) AS last_created
+        FROM event e
+        WHERE e.seq = (SELECT MIN(e2.seq) FROM event e2 WHERE e2.aggregate_id = e.aggregate_id)
+        ORDER BY COALESCE(json_extract(e.data, '$.info.time.created'), 0) DESC
+        LIMIT ?`)
+            .all(effectiveLimit);
+        const idToSummary = new Map();
+        for (const row of firstEvents) {
+            let title = row.aggregate_id.slice(0, 12);
+            let slug = "";
+            let createdAt = "";
+            let durationMs = 0;
+            try {
+                const parsed = JSON.parse(row.data);
+                const info = parsed["info"];
+                const rawTitle = info?.["title"];
+                if (typeof rawTitle === "string") {
+                    title = rawTitle;
+                }
+                const rawSlug = info?.["slug"];
+                if (typeof rawSlug === "string") {
+                    slug = rawSlug;
+                }
+                const rawTime = info?.["time"];
+                const rawCreated = rawTime?.["created"];
+                if (typeof rawCreated === "number") {
+                    createdAt = new Date(rawCreated).toISOString();
+                    if (typeof row.last_created === "number") {
+                        durationMs = row.last_created - rawCreated;
+                    }
+                }
+            }
+            catch {
+                // best-effort parse
+            }
+            if (title.startsWith("New session")) {
+                const promptText = this.firstUserPromptText(row.aggregate_id);
+                if (promptText)
+                    title = promptText;
+            }
+            idToSummary.set(row.aggregate_id, { id: row.aggregate_id, title, slug, createdAt, durationMs, eventCount: row.event_count, isFinished: false, children: [] });
+        }
+        const relations = this.db
+            .prepare(`SELECT DISTINCT
+          json_extract(data, '$.part.state.metadata.parentSessionId') AS parent_id,
+          json_extract(data, '$.part.state.metadata.sessionId') AS child_id,
+          json_extract(data, '$.part.state.status') AS status
+        FROM event
+        WHERE json_extract(data, '$.part.type') = 'tool'
+          AND json_extract(data, '$.part.tool') = 'task'
+          AND json_extract(data, '$.part.state.metadata.sessionId') IS NOT NULL`)
+            .all();
+        const childIds = new Set();
+        for (const rel of relations) {
+            if (!rel.parent_id || !rel.child_id)
+                continue;
+            const child = idToSummary.get(rel.child_id);
+            if (child && (rel.status === "completed" || rel.status === "error")) {
+                child.isFinished = true;
+            }
+            childIds.add(rel.child_id);
+            const parent = idToSummary.get(rel.parent_id);
+            if (parent && child) {
+                parent.children.push(child);
+            }
+        }
+        const groups = [];
+        const standalone = [];
+        for (const summary of idToSummary.values()) {
+            if (childIds.has(summary.id))
+                continue;
+            if (summary.children.length > 0) {
+                groups.push({ parent: { ...summary, children: [] }, children: summary.children });
+            }
+            else {
+                standalone.push(summary);
+            }
+        }
+        return { groups, standalone };
+    }
+    /**
+     * opencode stores a placeholder title ("New session - <iso timestamp>") on
+     * sessions it never generated a title for. Surface the first real user prompt
+     * text instead so lists read as actual tasks.
+     */
+    firstUserPromptText(aggregateId) {
+        const userMsg = this.db
+            .prepare(`SELECT json_extract(data, '$.info.id') AS id
+         FROM event
+         WHERE aggregate_id = ? AND type = 'message.updated.1'
+           AND json_extract(data, '$.info.role') = 'user'
+         ORDER BY seq ASC LIMIT 1`)
+            .get(aggregateId);
+        if (!userMsg?.id)
+            return "";
+        const part = this.db
+            .prepare(`SELECT json_extract(data, '$.part.text') AS text
+         FROM event
+         WHERE aggregate_id = ? AND type = 'message.part.updated.1'
+           AND json_extract(data, '$.part.messageID') = ?
+           AND json_extract(data, '$.part.type') = 'text'
+         ORDER BY seq ASC LIMIT 1`)
+            .get(aggregateId, userMsg.id);
+        if (typeof part?.text !== "string" || part.text === "")
+            return "";
+        return part.text.replace(/\s+/g, " ").trim();
+    }
+    close() {
+        this.db.close();
+    }
+}
+exports.OpenCodeEventStore = OpenCodeEventStore;
+//# sourceMappingURL=OpenCodeEventStore.js.map

package/dist/opencode/OpenCodeEventStore.js.map

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

package/dist/opencode/agent-sessions.d.ts

@@ -0,0 +1,46 @@
+import { type UniversalAgentSessionEvent } from "@principal-ai/agent-monitoring";
+import { NodePathNormalizationAdapter, accumulateEvents, collectRepositories, normalizeEvents, normalizeEventsWithAdapter } from "./pipeline";
+export { NodePathNormalizationAdapter, normalizeEvents, normalizeEventsWithAdapter, accumulateEvents, collectRepositories, };
+/**
+ * Shared, agent-agnostic session access: list + fetch across Cline, opencode,
+ * pi, Grok, and Codex, normalizing raw events into repo-aware universal events.
+ *
+ * This is the single source of truth for CLI and principal-studio session pulling.
+ * opencode listing delegates to `OpenCodeEventStore.listSessionsWithSummaries()`,
+ * which already builds parent/child groups and excludes subagent (child) sessions
+ * from the standalone list.
+ */
+export type SupportedSessionAgent = "cline" | "codex" | "cursor" | "opencode" | "pi" | "grok" | "unknown";
+export interface AgentSessionSummary {
+    agent: SupportedSessionAgent;
+    sessionId: string;
+    title: string;
+    createdAt: string;
+    eventCount: number;
+    isFinished: boolean;
+    parentID?: string;
+}
+export interface AgentSessionMeta {
+    sessionName: string;
+    sessionTask: string;
+    workingDirectory: string;
+    createdAt?: string;
+}
+/** List sessions from all supported agents. Top-level only by default. */
+export declare function listAgentSessions(options?: {
+    dbPath?: string;
+}): AgentSessionSummary[];
+/** Detect which agent a session id belongs to. */
+export declare function detectAgent(sessionId: string): "cline" | "opencode" | "pi" | "grok" | "codex" | "cursor";
+/**
+ * Fetch a session's raw universal events from the appropriate source.
+ */
+export declare function fetchRawEvents(sessionId: string, options?: {
+    agent?: "cline" | "codex" | "cursor" | "opencode" | "pi" | "grok";
+    dbPath?: string;
+}): {
+    agent: "cline" | "codex" | "cursor" | "opencode" | "pi" | "grok";
+    events: UniversalAgentSessionEvent[];
+    sessionMeta: AgentSessionMeta;
+};
+//# sourceMappingURL=agent-sessions.d.ts.map

package/dist/opencode/agent-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-sessions.d.ts","sourceRoot":"","sources":["../../src/opencode/agent-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,0BAA0B,EAChC,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,0BAA0B,EAE3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,GACpB,CAAC;AAEF;;;;;;;;GAQG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,OAAO,GACP,OAAO,GACP,QAAQ,GACR,UAAU,GACV,IAAI,GACJ,MAAM,GACN,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsJD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,mBAAmB,EAAE,CAqCvB;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,GAChB,OAAO,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAO3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL;IACD,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC;IACjE,MAAM,EAAE,0BAA0B,EAAE,CAAC;IACrC,WAAW,EAAE,gBAAgB,CAAC;CAC/B,CAkGA"}