@principal-ai/principal-view-core 0.28.8 → 0.28.10

package/dist/opencode/pipeline.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectRepositories = exports.accumulateEvents = exports.normalizeEventsWithAdapter = exports.normalizeEvents = exports.opencodeRowsToUniversalEvents = exports.NodePathNormalizationAdapter = void 0;
+const agent_monitoring_1 = require("@principal-ai/agent-monitoring");
+const node_path_adapter_1 = require("./node-path-adapter");
+Object.defineProperty(exports, "NodePathNormalizationAdapter", { enumerable: true, get: function () { return node_path_adapter_1.NodePathNormalizationAdapter; } });
+/**
+ * Convert raw opencode event rows into universal events. Handles both string
+ * (SQLite TEXT, unparsed) and already-parsed object `data` payloads.
+ */
+function opencodeRowsToUniversalEvents(rows) {
+    const processor = new agent_monitoring_1.V1EventBridgeProcessor();
+    return rows.map((row) => processor.normalize({
+        type: row.type,
+        data: typeof row.data === "string"
+            ? JSON.parse(row.data)
+            : row.data,
+        id: row.id,
+        aggregateId: row.aggregateId,
+        seq: row.seq,
+    }));
+}
+exports.opencodeRowsToUniversalEvents = opencodeRowsToUniversalEvents;
+/** Normalize raw universal events into repo-normalized universal events. */
+async function normalizeEvents(events, workingDirectory = "", knownRoots) {
+    const { normalized } = await normalizeEventsWithAdapter(events, workingDirectory, knownRoots);
+    return normalized;
+}
+exports.normalizeEvents = normalizeEvents;
+/**
+ * Like `normalizeEvents`, but also returns the adapter so callers can inspect
+ * `adapter.newlyDiscovered` for auto-registration of newly found git roots.
+ */
+async function normalizeEventsWithAdapter(events, workingDirectory = "", knownRoots) {
+    const adapter = new node_path_adapter_1.NodePathNormalizationAdapter(knownRoots);
+    const service = new agent_monitoring_1.PathNormalizationService(adapter);
+    const normalized = await service.normalizePathsBatch(events, workingDirectory);
+    return { normalized, adapter };
+}
+exports.normalizeEventsWithAdapter = normalizeEventsWithAdapter;
+/** Compute the accumulated agent-session event rows for a normalized session. */
+function accumulateEvents(normalizedEvents, sessionTitle = "") {
+    const accState = (0, agent_monitoring_1.createAccumulatedState)(sessionTitle);
+    return normalizedEvents.map((normalizedEvent) => ({
+        normalized: normalizedEvent,
+        accumulated: (0, agent_monitoring_1.eventOp)(accState, normalizedEvent),
+    }));
+}
+exports.accumulateEvents = accumulateEvents;
+/** Collect the distinct repositories referenced across a normalized session. */
+function collectRepositories(normalizedEvents) {
+    const byRoot = new Map();
+    // Event-level repository context uses the RepositoryInfo shape (key: `root`).
+    const putEventRepo = (root, repo) => {
+        byRoot.set(root, {
+            root,
+            remoteUrl: repo.remoteUrl,
+            owner: repo.owner,
+            repo: repo.repo,
+            branch: repo.branch,
+            headCommit: repo.headCommit,
+        });
+    };
+    // Per-file repository uses the NormalizedPathInfo shape (key: `gitRoot`, no
+    // branch/headCommit). Normalize into the RepositoryInfo shape.
+    const putFileRepo = (root, repo) => {
+        const existing = byRoot.get(root);
+        byRoot.set(root, {
+            root,
+            remoteUrl: repo.remoteUrl ?? existing?.remoteUrl,
+            owner: repo.owner ?? existing?.owner,
+            repo: repo.repo ?? existing?.repo,
+            branch: existing?.branch,
+            headCommit: existing?.headCommit,
+        });
+    };
+    for (const event of normalizedEvents) {
+        if (event.repository?.root)
+            putEventRepo(event.repository.root, event.repository);
+        for (const file of event.files ?? []) {
+            const fileRepo = file.repository;
+            if (fileRepo?.gitRoot) {
+                putFileRepo(fileRepo.gitRoot, fileRepo);
+            }
+        }
+    }
+    return Array.from(byRoot.values());
+}
+exports.collectRepositories = collectRepositories;
+//# sourceMappingURL=pipeline.js.map

package/dist/opencode/pipeline.js.map

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

package/dist/opencode/types.d.ts

@@ -0,0 +1,39 @@
+export interface OpenCodeRawEvent {
+    id: string;
+    aggregateId: string;
+    seq: number;
+    type: string;
+    data: Record<string, unknown>;
+}
+export interface OpenCodeSessionEvents {
+    sessionId: string;
+    events: OpenCodeRawEvent[];
+    hasMore: boolean;
+}
+export interface OpenCodeEventRetriever {
+    readAggregate(sessionId: string, options?: {
+        after?: number;
+        limit?: number;
+    }): OpenCodeSessionEvents;
+}
+export interface OpenCodeStoreOptions {
+    dbPath?: string;
+}
+export interface SessionSummary {
+    id: string;
+    title: string;
+    slug: string;
+    createdAt: string;
+    durationMs: number;
+    eventCount: number;
+    isFinished: boolean;
+    children: SessionSummary[];
+}
+export interface SessionListResult {
+    groups: Array<{
+        parent: SessionSummary;
+        children: SessionSummary[];
+    }>;
+    standalone: SessionSummary[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/opencode/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,gBAAgB,EAAE,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,qBAAqB,CAAA;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,cAAc,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,cAAc,CAAA;QACtB,QAAQ,EAAE,cAAc,EAAE,CAAA;KAC3B,CAAC,CAAA;IACF,UAAU,EAAE,cAAc,EAAE,CAAA;CAC7B"}

package/dist/opencode/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/opencode/types.js.map

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

package/dist/storage/topic-types.d.ts

@@ -116,6 +116,14 @@ export interface DraftTopic {
     description?: string;
     /** Ordered list of LOCAL trail ids — foreign keys into the local trail store. */
     trailIds: string[];
+    /**
+     * Repositories this topic is about, as PURL strings (e.g.
+     * `pkg:github/owner/repo`). The topic's own source of truth for "which repos"
+     * — portable and machine-independent, matching `WorkspaceMembership.repositoryId`.
+     * Machine-local clone paths stay a workspace-membership concern and never
+     * appear here, so this round-trips across machines on publish/fetch.
+     */
+    repos?: string[];
     /** ISO 8601. */
     createdAt: string;
     /** ISO 8601. */
@@ -145,6 +153,12 @@ export interface PublishedTopic {
     description: string;
     /** Ordered list of REMOTE trail ids. */
     trailIds: string[];
+    /**
+     * Repositories this topic is about, as PURL strings (e.g.
+     * `pkg:github/owner/repo`). Travels with the topic across the wire so a
+     * received shared topic carries its repos; preserved on publish/fetch.
+     */
+    repos?: string[];
     /** ISO 8601. */
     createdAt: string;
     /** ISO 8601. */

package/dist/storage/topic-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"topic-types.d.ts","sourceRoot":"","sources":["../../src/storage/topic-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,KAAK,EACD,aAAa,GACb,SAAS,GACT,QAAQ,GACR,SAAS,GACT,cAAc,GACd,YAAY,GACZ,WAAW,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,SAAS,CAAC,EAAE;QACV,gEAAgE;QAChE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,oDAAoD;QACpD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,wEAAwE;QACxE,GAAG,CAAC,EAAE;YACJ,IAAI,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;YACjD,8CAA8C;YAC9C,KAAK,EAAE,MAAM,CAAC;YACd,wCAAwC;YACxC,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mFAAmF;IACnF,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,YAAY,CAAC;IACxB,uEAAuE;IACvE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8DAA8D;IAC9D,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,YAAY,CAAC;IACxB,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,iBAAiB,GAC5B,cAAc,CAkBhB"}
+{"version":3,"file":"topic-types.d.ts","sourceRoot":"","sources":["../../src/storage/topic-types.ts"],"names":[],"mappings":"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"}

package/dist/storage/topic-types.js

@@ -48,6 +48,7 @@ function publishedFromDraft(draft, projection) {
         title: draft.title,
         description,
         trailIds: projection.trailIds,
+        ...(draft.repos !== undefined ? { repos: draft.repos } : {}),
         createdAt: draft.createdAt,
         updatedAt: draft.updatedAt,
         createdBy: projection.createdBy,

package/dist/storage/topic-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"topic-types.js","sourceRoot":"","sources":["../../src/storage/topic-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAkKH;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAChC,KAAiB,EACjB,UAA6B;IAE7B,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;QAC5B,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,CAAC,EAAE,4DAA4D,CAC9E,CAAC;KACH;IACD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW;QACX,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,UAAU,EAAE,UAAU,CAAC,UAAU;KAClC,CAAC;AACJ,CAAC;AArBD,gDAqBC"}
+{"version":3,"file":"topic-types.js","sourceRoot":"","sources":["../../src/storage/topic-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAgLH;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAChC,KAAiB,EACjB,UAA6B;IAE7B,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;QAC5B,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,CAAC,EAAE,4DAA4D,CAC9E,CAAC;KACH;IACD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW;QACX,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,UAAU,EAAE,UAAU,CAAC,UAAU;KAClC,CAAC;AACJ,CAAC;AAtBD,gDAsBC"}

package/dist/storage/topicStore.d.ts

@@ -69,7 +69,7 @@ export interface MigrationResult {
  * `trailIds` are not updatable here — use the trail-membership methods for
  * `trailIds`, and `id`/`createdAt` are immutable.
  */
-export type TopicUpdate = Partial<Pick<DraftTopic, 'title' | 'description' | 'status' | 'createdBy' | 'assets'>>;
+export type TopicUpdate = Partial<Pick<DraftTopic, 'title' | 'description' | 'status' | 'createdBy' | 'assets' | 'repos'>>;
 /**
  * Fields a caller may set when creating a topic. `id`, `createdAt`,
  * `updatedAt` are filled in when omitted; passing `id` lets a caller control

package/dist/storage/topicStore.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principal-ai/principal-view-core",
-  "version": "0.28.8",
+  "version": "0.28.10",
   "description": "Core logic and types for graph-based principal view framework",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,6 +16,12 @@
       "import": "./dist/node.js",
       "require": "./dist/node.js",
       "default": "./dist/node.js"
+    },
+    "./pipeline": {
+      "types": "./dist/opencode/pipeline.d.ts",
+      "import": "./dist/opencode/pipeline.js",
+      "require": "./dist/opencode/pipeline.js",
+      "default": "./dist/opencode/pipeline.js"
     }
   },
   "files": [
@@ -42,7 +48,9 @@
     "@opentelemetry/resources": "2.2.0",
     "@opentelemetry/sdk-trace-base": "2.2.0",
     "@opentelemetry/semantic-conventions": "1.38.0",
+    "@principal-ai/agent-monitoring": "^0.3.31",
     "@principal-ai/repository-abstraction": "^0.5.7",
+    "better-sqlite3": "^13.0.0",
     "date-fns": "3.0.0",
     "handlebars": "^4.7.8",
     "js-yaml": "4.1.0",
@@ -54,6 +62,7 @@
   "devDependencies": {
     "@principal-ai/codebase-composition": "^0.2.43",
     "@principal-ai/principal-view-core": "0.24.10",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/handlebars": "^4.1.0",
     "@types/jest": "30.0.0",
     "@types/js-yaml": "4.0.9",

package/src/agent-sessions/fixture.ts

@@ -0,0 +1,225 @@
+import path from "node:path";
+import {
+  accumulateToAgentSessionEvents,
+  type AgentSessionEvent,
+  type NormalizedPathInfo,
+  type RepoNormalizedUniversalAgentSessionEvent,
+} from "@principal-ai/agent-monitoring";
+
+/**
+ * Frozen File City agent-session fixture generation.
+ *
+ * Reproduces the shape the file-city-panel fixture loaders consume
+ * (`{ generatedFrom, session, events }`): repo-normalized universal events are
+ * accumulated into agent-session events, then layer item paths (repo-relative
+ * displayPaths) are rewritten back to absolute paths with a per-repo
+ * files/edits manifest. The result is a static snapshot — no pipeline runs at
+ * story time.
+ */
+
+export interface AgentSessionFixtureMeta {
+  sessionName: string;
+  sessionTask: string;
+  workingDirectory: string;
+  createdAt?: string;
+}
+
+export interface AgentSessionFixtureRepo {
+  repo: string;
+  root: string;
+  files: number;
+  edits: number;
+}
+
+export interface AgentSessionFixtureSummary {
+  sessionId: string;
+  agent: string;
+  sessionName: string;
+  sessionTask: string;
+  workingDirectory: string;
+  rawEventCount: number;
+  agentEventCount: number;
+  repos: AgentSessionFixtureRepo[];
+  /** Distinct model ids the session used, in first-use order. */
+  models?: string[];
+}
+
+export interface FixtureLayerItem {
+  path: string;
+  type: "file" | "directory";
+  renderStrategy?: "border" | "fill" | "glow" | "pattern" | "cover" | "icon" | "custom";
+}
+
+export interface FixtureHighlightLayer {
+  id: string;
+  name: string;
+  enabled: boolean;
+  color: string;
+  opacity?: number;
+  borderWidth?: number;
+  priority: number;
+  dynamic?: boolean;
+  items: FixtureLayerItem[];
+}
+
+export interface FixtureAgentSessionEvent {
+  id: string;
+  timestamp: number;
+  sessionId: string;
+  sessionName: string;
+  sessionColor: string;
+  operation: AgentSessionEvent["operation"];
+  files: string[];
+  dependencies: string[];
+  description: string;
+  layers: FixtureHighlightLayer[];
+  contextTokens?: number;
+  subagentType?: string;
+  childSessionId?: string;
+  toolName?: string;
+}
+
+export interface AgentSessionFixture {
+  generatedFrom: string;
+  session: AgentSessionFixtureSummary;
+  events: FixtureAgentSessionEvent[];
+}
+
+function repoLabel(nf: { repository?: { gitRoot?: string; repo?: string } }): string {
+  if (nf.repository?.repo) return nf.repository.repo;
+  if (nf.repository?.gitRoot) return path.basename(nf.repository.gitRoot);
+  return "";
+}
+
+function repoRoot(nf: { repository?: { gitRoot?: string } }): string {
+  return nf.repository?.gitRoot ?? "";
+}
+
+/**
+ * Extract a model id from a model value — agents set it inconsistently
+ * (opencode stores `{ providerID, modelID }`-shaped objects, cline / grok /
+ * pi store a plain string id).
+ */
+function modelIdOf(value: unknown): string | undefined {
+  if (typeof value === "string" && value.length > 0) return value;
+  if (value && typeof value === "object") {
+    const o = value as Record<string, unknown>;
+    for (const key of ["modelID", "id"]) {
+      if (typeof o[key] === "string" && (o[key] as string).length > 0) {
+        return o[key] as string;
+      }
+    }
+  }
+  return undefined;
+}
+
+/** Pull the model id from one event — normalized `data.model` first, then the
+ *  raw opencode `info` blob (the bridge only copies `info.model` onto
+ *  normalized events when the session's created event carried it). */
+function eventModelId(e: RepoNormalizedUniversalAgentSessionEvent): string | undefined {
+  const direct = modelIdOf(e.data?.["model"]);
+  if (direct) return direct;
+  const raw = e.raw as { data?: { info?: { model?: unknown } } } | undefined;
+  return modelIdOf(raw?.data?.info?.model);
+}
+
+/** Distinct model ids across a session's events, in first-seen order. */
+function collectModels(events: RepoNormalizedUniversalAgentSessionEvent[]): string[] {
+  const seen = new Set<string>();
+  const models: string[] = [];
+  for (const e of events) {
+    const id = eventModelId(e);
+    if (id && !seen.has(id)) {
+      seen.add(id);
+      models.push(id);
+    }
+  }
+  return models;
+}
+
+export function buildAgentSessionFixture(options: {
+  agent: string;
+  sessionId: string;
+  sessionMeta: AgentSessionFixtureMeta;
+  normalizedEvents: RepoNormalizedUniversalAgentSessionEvent[];
+  rawEventCount?: number;
+}): AgentSessionFixture {
+  const { agent, sessionId, sessionMeta, normalizedEvents, rawEventCount } = options;
+  const sessionName = sessionMeta.sessionName || "opencode";
+  const agentEvents = accumulateToAgentSessionEvents(normalizedEvents, sessionName);
+
+  // Rewrite layer item paths (repo-relative displayPath) back to absolute
+  // paths. Layer snapshots reflect accumulated state across events, so build a
+  // global displayPath -> absolutePath map from every event's files/dependencies.
+  const repoBreakdown = new Map<string, { root: string; files: Set<string>; edits: Set<string> }>();
+  const displayToAbs = new Map<string, string>();
+
+  for (const e of agentEvents) {
+    for (const f of [...e.files, ...e.dependencies]) {
+      if (typeof f === "object" && f && "displayPath" in f) {
+        const nf = f as NormalizedPathInfo;
+        if (nf.displayPath && !displayToAbs.has(nf.displayPath)) {
+          displayToAbs.set(nf.displayPath, nf.absolutePath);
+        }
+        const label = repoLabel(nf);
+        if (!repoBreakdown.has(label)) {
+          repoBreakdown.set(label, { root: repoRoot(nf), files: new Set(), edits: new Set() });
+        }
+        repoBreakdown.get(label)!.files.add(nf.absolutePath);
+        if (!repoBreakdown.get(label)!.root) repoBreakdown.get(label)!.root = repoRoot(nf);
+      }
+    }
+  }
+
+  const events: FixtureAgentSessionEvent[] = agentEvents.map((e) => {
+    const files = e.files.map((f) =>
+      typeof f === "string" ? f : (f as NormalizedPathInfo).absolutePath,
+    );
+    const dependencies = e.dependencies.map((f) =>
+      typeof f === "string" ? f : (f as NormalizedPathInfo).absolutePath,
+    );
+
+    if (e.operation === "editing") {
+      for (const f of files) {
+        const label = [...repoBreakdown.entries()].find(([, v]) => v.files.has(f))?.[0] ?? "";
+        if (!repoBreakdown.has(label)) {
+          repoBreakdown.set(label, { root: "", files: new Set(), edits: new Set() });
+        }
+        repoBreakdown.get(label)!.edits.add(f);
+      }
+    }
+
+    const layers = e.layers.map((l) => ({
+      ...l,
+      items: l.items.map((item) => {
+        const abs = item.path.startsWith("/") ? item.path : displayToAbs.get(item.path) ?? item.path;
+        return { ...item, path: abs };
+      }),
+    }));
+
+    return { ...e, files, dependencies, layers };
+  });
+
+  const session: AgentSessionFixtureSummary = {
+    sessionId,
+    agent,
+    sessionName,
+    sessionTask: sessionMeta.sessionTask,
+    workingDirectory: sessionMeta.workingDirectory,
+    rawEventCount: rawEventCount ?? normalizedEvents.length,
+    agentEventCount: events.length,
+    repos: [...repoBreakdown.entries()].map(([repo, v]) => ({
+      repo,
+      root: v.root,
+      files: v.files.size,
+      edits: v.edits.size,
+    })),
+    models: collectModels(normalizedEvents),
+  };
+
+  return {
+    generatedFrom: `${agent} session ${sessionId}`,
+    session,
+    events,
+  };
+}

package/src/agent-sessions/index.ts

@@ -0,0 +1,10 @@
+export { buildAgentSessionFixture } from "./fixture";
+export type {
+  AgentSessionFixture,
+  AgentSessionFixtureMeta,
+  AgentSessionFixtureRepo,
+  AgentSessionFixtureSummary,
+  FixtureAgentSessionEvent,
+  FixtureHighlightLayer,
+  FixtureLayerItem,
+} from "./fixture";

package/src/index.ts

@@ -549,6 +549,7 @@ export type {
 // Use '@principal-ai/principal-view-core/node' for Node.js-specific functionality:
 //
 // - EventProcessor, ValidationEngine, ConfigurationValidator (Node.js processing)
+// - OpenCodeEventStore, OpenCodeEventRetriever (opencode event reading)
 // - GraphInstrumentationHelper (Node.js utilities)
 // - PathMatcher, GraphConverter (Node.js utilities)
 // - EventValidator, createValidatedEmitter (Node.js telemetry)

package/src/node.ts

@@ -138,6 +138,37 @@ export { LibraryLoader } from './LibraryLoader';
 export { EventRegistry } from './registry/EventRegistry';
 export type { EventSource } from './registry/EventRegistry';
 
+// Export opencode event retrieval (Node.js only - SQLite)
+export { OpenCodeEventStore, defaultOpenCodeDBPath } from './opencode/OpenCodeEventStore';
+export type { OpenCodeRawEvent, OpenCodeSessionEvents, OpenCodeEventRetriever, OpenCodeStoreOptions, SessionSummary, SessionListResult } from './opencode/types';
+
+// Export shared, agent-agnostic session listing/fetch/normalization (Node.js only)
+export { listAgentSessions, detectAgent, fetchRawEvents } from './opencode/agent-sessions';
+export type { AgentSessionSummary, AgentSessionMeta, SupportedSessionAgent } from './opencode/agent-sessions';
+
+// Export the frozen-fixture generator (Node.js only — runs git walk-up)
+export { buildAgentSessionFixture } from './agent-sessions/fixture';
+export type {
+  AgentSessionFixture,
+  AgentSessionFixtureMeta,
+  AgentSessionFixtureRepo,
+  AgentSessionFixtureSummary,
+  FixtureAgentSessionEvent,
+  FixtureHighlightLayer,
+  FixtureLayerItem,
+} from './agent-sessions/fixture';
+
+// Export the pure, runtime-agnostic session pipeline (no SQLite dependency)
+export {
+  NodePathNormalizationAdapter,
+  normalizeEvents,
+  normalizeEventsWithAdapter,
+  accumulateEvents,
+  collectRepositories,
+  opencodeRowsToUniversalEvents,
+} from './opencode/pipeline';
+export type { OpenCodeEventRow } from './opencode/pipeline';
+
 // Re-export FileSystemAdapter from repository-abstraction
 export type { FileSystemAdapter } from '@principal-ai/repository-abstraction';
 export { InMemoryFileSystemAdapter } from '@principal-ai/repository-abstraction';

package/src/opencode/EVENT_MAPPING.md

@@ -0,0 +1,82 @@
+# opencode V1 Event → NormalizedEventType Mapping
+
+## Event-Level Mapping
+
+| V1 event type | Suggested NormalizedEventType | Notes |
+|---|---|---|
+| `session.created.1` | `session-start` | Carries `SessionInfo` (directory, agent, model, title) |
+| `session.updated.1` | `session-update` | Metadata/title/status changes mid-session |
+| `session.deleted.1` | `session-end` | Not observed in local instance; may be rare |
+| `message.updated.1` (role=user) | `user-prompt-submit` | Carries prompt text, format, agent config, system prompt |
+| `message.updated.1` (role=assistant) | `message-display` | Carries message metadata, cost, tokens, error info |
+| `message.removed.1` | `message-removed` | Rare (4 instances across 368 sessions) |
+
+## Part-Level Mapping (`message.part.updated.1`)
+
+Each `message.part.updated.1` event carries a single `Part` discriminated by `type`. Below is the per-variant mapping.
+
+### tool — Tool call state machine
+
+A single tool call produces **4 separate `part.updated` events** as it transitions. Each maps to a distinct normalized event type to preserve full temporal fidelity for visualization.
+
+| Tool state | Suggested NormalizedEventType | Carrier fields |
+|---|---|---|
+| `pending` | `pre-tool-use` | `tool`, `callID`, `state.input`, `state.raw` |
+| `running` | `tool-executing` | `tool`, `callID`, `state.title`, `state.time.start`, `state.metadata` |
+| `completed` | `post-tool-use` | `tool`, `callID`, `state.output`, `state.title`, `state.time.start/end`, `state.attachments` |
+| `error` | `post-tool-use-failure` | `tool`, `callID`, `state.error`, `state.time.start/end` |
+
+All four carry `callID` for correlation. A visualization can group them by `callID` to show a single tool call expanding through its lifecycle.
+
+### text — Text output
+
+| Part variant | Suggested NormalizedEventType | Carrier fields |
+|---|---|---|
+| `text` | `notification` | `text`, optional `time.start`/`time.end`, `synthetic`, `ignored`, `metadata` |
+
+### reasoning — Model reasoning text
+
+| Part variant | Suggested NormalizedEventType | Carrier fields |
+|---|---|---|
+| `reasoning` | `model-reasoning` | `text`, `time.start`/`time.end`, `metadata` |
+
+### step-start / step-finish — Model thinking step boundaries
+
+| Part variant | Suggested NormalizedEventType | Carrier fields |
+|---|---|---|
+| `step-start` | `step-start` | Optional `snapshot` |
+| `step-finish` | `step-finish` | `reason` (e.g. `"tool-calls"`, `"stop"`), `cost`, `tokens{input,output,reasoning,cache}`, optional `snapshot` |
+
+`step-finish` is the richest source for token/cost accounting. The `reason` field indicates what ended the step.
+
+### patch — File edits
+
+| Part variant | Suggested NormalizedEventType | Carrier fields |
+|---|---|---|
+| `patch` | `file-changed` | `hash`, `files[]` (list of affected file paths) |
+
+### compaction — Context window compression
+
+| Part variant | Suggested NormalizedEventType | Carrier fields |
+|---|---|---|
+| `compaction` | `post-compact` | `auto` (boolean), optional `overflow`, optional `tail_start_id` |
+
+## NormalizedEventType additions needed
+
+Mapping at full fidelity requires adding these new types to the `NormalizedEventType` union in `AgentEventTypes.ts`:
+
+```
+"session-update"       // session.updated.1
+"message-removed"      // message.removed.1
+"tool-executing"       // tool part with state=running
+"model-reasoning"      // reasoning part
+"step-start"           // step-start part
+"step-finish"          // step-finish part (carries cost+tokens)
+"post-tool-use-failure" // already exists
+"file-changed"         // already exists
+"post-compact"         // already exists
+```
+
+## Fixture reference
+
+`__fixtures__/event-shapes.json` contains one representative sample of each of the 15 shapes listed above, extracted from a local opencode instance. Each entry is a full `EventV2.Payload` with the complete `data` blob intact.