@rejacky/opencode-insights 0.1.5 → 0.1.6

package/README.md

@@ -24,6 +24,37 @@ Make sure that directory is on your `PATH`, then run the CLI directly:
 opencode-insights doctor
 ```
 
+## Update
+
+`opencode plugin` does not re-install or upgrade already-cached packages. To update to the latest version, clear the cached copy and reinstall:
+
+```bash
+rm -rf ~/.cache/opencode/packages/node_modules/@rejacky/opencode-insights
+opencode plugin @rejacky/opencode-insights --global
+```
+
+Then restart OpenCode.
+
+You can also run the latest published version directly via `npx` without reinstalling:
+
+```bash
+npx -y -p @rejacky/opencode-insights opencode-insights doctor
+```
+
+## Preview
+
+![opencode-insights TUI](assets/tui.png)
+
+Inspect captured sessions with the web viewer:
+
+```bash
+opencode-insights open
+```
+
+OpenCode Insights viewer listening at http://127.0.0.1:8765
+
+![opencode-insights web viewer](assets/insights.png)
+
 ## Uninstall
 
 Remove this plugin from `opencode.json` / `opencode.jsonc`, remove it from `tui.json`, and delete the local Insights database files:
@@ -56,12 +87,6 @@ After uninstalling, restart OpenCode. Packages installed with `opencode plugin .
 ~/.cache/opencode/packages
 ```
 
-For this machine, that expands to:
-
-```text
-/Users/zyao/.cache/opencode/packages
-```
-
 The `uninstall` command removes plugin config entries and local Insights data; it does not remove cached OpenCode package directories automatically.
 
 ## What You Get
@@ -193,56 +218,3 @@ You can override storage and retention in `opencode.json` or `opencode.jsonc`:
 This plugin intentionally does not redact anything. It stores data locally exactly as OpenCode exposes it to plugin hooks and events.
 
 Captured data can include prompts, system messages, provider metadata, API keys exposed inside hook payloads, tool arguments, headers, reasoning text, and response events. Use it only on machines where local full-fidelity capture is acceptable.
-
-## Request Context Capture
-
-Request-context capture is enabled by default. The plugin records OpenCode's `chat.headers`, `experimental.chat.messages.transform`, and `experimental.chat.system.transform` hooks so the viewer can show provider headers, transformed conversation messages, and system prompt content when OpenCode exposes them. The `experimental.chat.*` names are OpenCode hook names; no `experimental` plugin option is required.
-
-## Captured Hooks
-
-The viewer labels OpenCode hook records as `HOOK` because they are not raw HTTP requests.
-
-Common hook rows:
-
-- `HOOK title`: OpenCode title-generation model call, usually only on the first turn.
-- `HOOK build`: Main assistant response model-call hook.
-- `HOOK messages.transform`: Final conversation messages OpenCode prepared before model execution.
-- `HOOK system.transform`: System prompt strings OpenCode prepared before model execution.
-
-Hook payload meaning:
-
-- `payload.input`: Context OpenCode passed into the plugin hook.
-- `payload.output`: Value returned by the hook, such as model settings or transformed messages.
-- `headers.output.headers`: Headers returned by the headers hook.
-- Response text is captured from OpenCode event stream rows such as `message.part.delta` and `message.part.updated`.
-
-The plugin reconstructs a logical LLM request from hooks and events. It does not capture the final provider HTTP body unless OpenCode exposes a lower-level transport hook in the future.
-
-## SQLite Queries
-
-Count captured rows:
-
-```bash
-sqlite3 ~/.opencode-insights/insights.sqlite \
-  "select kind, count(*) from captures group by kind order by kind;"
-```
-
-Find text in captured payloads:
-
-```bash
-sqlite3 ~/.opencode-insights/insights.sqlite "
-select datetime(timestamp/1000,'unixepoch','localtime') as time,
-       kind,
-       session_id,
-       message_id,
-       substr(payload_json, 1, 1200) as preview
-from captures
-where payload_json like '%search text%'
-order by timestamp desc
-limit 20;
-"
-```
-
-## Development
-
-Development and publish notes live in [DEVELOPMENT.md](./DEVELOPMENT.md).

package/dist/{capture-B6sM1QQA.d.ts → capture-Dy799i3Z.d.ts}

@@ -43,6 +43,7 @@ interface SqliteDb {
     close(): void;
 }
 declare function openDatabase(path: string): Promise<SqliteDb | undefined>;
+declare function extractEventType(payload: Record<string, unknown>): string | null;
 declare class SqliteCaptureStore implements CaptureStore {
     private readonly path;
     private readonly retentionMs;
@@ -57,4 +58,4 @@ declare class SqliteCaptureStore implements CaptureStore {
 declare function createCaptureStore(options?: InsightsOptions): CaptureStore;
 declare function resolveRetentionDays(value: unknown): number;
 
-export { type CaptureRecord as C, type InsightsOptions as I, JsonlCaptureStore as J, SqliteCaptureStore as S, type CaptureKind as a, type CaptureStore as b, type SqliteDb as c, createCaptureStore as d, defaultDataDir as e, normalizeChatMessageCapture as f, normalizeChatParamsCapture as g, normalizeEventCapture as h, normalizeExperimentalChatMessagesTransformCapture as i, normalizeExperimentalChatSystemTransformCapture as j, normalizeToolCapture as k, resolveRetentionDays as l, normalizeChatHeadersCapture as n, openDatabase as o, resolveCapturePath as r };
+export { type CaptureRecord as C, type InsightsOptions as I, JsonlCaptureStore as J, SqliteCaptureStore as S, type CaptureKind as a, type CaptureStore as b, type SqliteDb as c, createCaptureStore as d, defaultDataDir as e, extractEventType as f, normalizeChatMessageCapture as g, normalizeChatParamsCapture as h, normalizeEventCapture as i, normalizeExperimentalChatMessagesTransformCapture as j, normalizeExperimentalChatSystemTransformCapture as k, normalizeToolCapture as l, resolveRetentionDays as m, normalizeChatHeadersCapture as n, openDatabase as o, resolveCapturePath as r };

package/dist/{chunk-PBX4AJCR.js → chunk-XCHFXQIL.js}

@@ -235,6 +235,10 @@ async function openDatabase(path) {
   }
   return void 0;
 }
+function extractEventType(payload) {
+  const event = isRecord(payload.event) ? payload.event : {};
+  return typeof event.type === "string" ? event.type : null;
+}
 var SqliteCaptureStore = class {
   constructor(path, retentionMs = retentionMsFromDays(DEFAULT_RETENTION_DAYS)) {
     this.path = path;
@@ -263,12 +267,29 @@ var SqliteCaptureStore = class {
         message_id text,
         provider_id text,
         model_id text,
+        event_type text,
         payload_json text not null
       )`
     );
     this.db.run(`create index if not exists captures_timestamp_idx on captures(timestamp)`);
     this.db.run(`create index if not exists captures_session_idx on captures(session_id)`);
     this.db.run(`create index if not exists captures_kind_timestamp_idx on captures(kind, timestamp)`);
+    this.db.run(`create index if not exists captures_kind_type_ts_idx on captures(kind, event_type, timestamp)`);
+    const existingColumns = db.all("select name from pragma_table_info('captures') where name = 'event_type'");
+    if (existingColumns.length === 0) {
+      try {
+        db.run(`alter table captures add column event_type text`);
+      } catch {
+      }
+    }
+    try {
+      db.run(`update captures set event_type = json_extract(payload_json, '$.event.type') where kind = 'event' and event_type is null`);
+    } catch {
+    }
+    try {
+      db.run(`pragma journal_mode = wal`);
+    } catch {
+    }
     this.pruneExpired();
     this.db.sync();
   }
@@ -289,10 +310,11 @@ var SqliteCaptureStore = class {
       }
       this.db = db;
     }
+    const eventType = record.kind === "event" ? extractEventType(record.payload) : null;
     this.db.run(
       `insert into captures (
-        id, kind, timestamp, session_id, message_id, provider_id, model_id, payload_json
-      ) values (?, ?, ?, ?, ?, ?, ?, ?)`,
+        id, kind, timestamp, session_id, message_id, provider_id, model_id, event_type, payload_json
+      ) values (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
       record.id,
       record.kind,
       record.timestamp,
@@ -300,6 +322,7 @@ var SqliteCaptureStore = class {
       record.messageID ?? null,
       record.providerID ?? null,
       record.modelID ?? null,
+      eventType,
       JSON.stringify(record.payload)
     );
     this.pruneExpired();
@@ -344,6 +367,7 @@ export {
   normalizeToolCapture,
   JsonlCaptureStore,
   openDatabase,
+  extractEventType,
   SqliteCaptureStore,
   createCaptureStore,
   resolveRetentionDays

package/dist/cli.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { C as CaptureRecord } from './capture-B6sM1QQA.js';
+import { C as CaptureRecord } from './capture-Dy799i3Z.js';
 
 type HistoryMessage = {
     id: string;

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   openDatabase,
   resolveCapturePath
-} from "./chunk-PBX4AJCR.js";
+} from "./chunk-XCHFXQIL.js";
 
 // src/cli.ts
 import { execFile as execFile2 } from "child_process";
@@ -259,12 +259,20 @@ function buildRequestHistory(records) {
     requests: requests.sort((a, b) => b.timestamp - a.timestamp)
   };
 }
+function ensureEventTypeColumn(db) {
+  const existing = db.all("select name from pragma_table_info('captures') where name = 'event_type'");
+  if (existing.length === 0) {
+    db.run(`alter table captures add column event_type text`);
+  }
+  db.run(`update captures set event_type = json_extract(payload_json, '$.event.type') where kind = 'event' and event_type is null`);
+}
 async function readSqliteCaptures(path, limit) {
   if (!existsSync(path)) return void 0;
   try {
     const db = await openDatabase(path);
     if (!db) return readSqliteCapturesWithCli(path, limit);
     try {
+      ensureEventTypeColumn(db);
       const rows = db.all(recentCaptureSql(Math.max(1, limit)));
       return dedupeRows(rows).map(rowToCapture);
     } finally {
@@ -274,24 +282,31 @@ async function readSqliteCaptures(path, limit) {
     return readSqliteCapturesWithCli(path, limit);
   }
 }
-async function readSqliteCapturesWithCli(path, limit) {
-  if (!existsSync(path)) return void 0;
+async function runSqlite3Json(path, sql) {
   try {
-    const { stdout } = await execFileAsync("sqlite3", ["-json", path, recentCaptureSql(Math.max(1, Math.trunc(limit)))], {
+    const { stdout } = await execFileAsync("sqlite3", ["-json", path, sql], {
       maxBuffer: 128 * 1024 * 1024
     });
-    if (!stdout.trim()) return [];
-    return dedupeRows(JSON.parse(stdout)).map(rowToCapture);
+    return stdout;
   } catch {
     return void 0;
   }
 }
+async function readSqliteCapturesWithCli(path, limit) {
+  if (!existsSync(path)) return void 0;
+  await runSqlite3Json(path, "alter table captures add column event_type text");
+  await runSqlite3Json(path, "update captures set event_type = json_extract(payload_json, '$.event.type') where kind = 'event' and event_type is null");
+  const stdout = await runSqlite3Json(path, recentCaptureSql(Math.max(1, Math.trunc(limit))));
+  if (!stdout?.trim()) return [];
+  return dedupeRows(JSON.parse(stdout)).map(rowToCapture);
+}
 async function readSqliteViewerCaptures(path, limit) {
   if (!existsSync(path)) return void 0;
   try {
     const db = await openDatabase(path);
     if (!db) return readSqliteViewerCapturesWithCli(path, limit);
     try {
+      ensureEventTypeColumn(db);
       const rows = db.all(viewerCaptureSql(Math.max(1, limit)));
       return dedupeRows(rows).map(rowToCapture);
     } finally {
@@ -303,15 +318,11 @@ async function readSqliteViewerCaptures(path, limit) {
 }
 async function readSqliteViewerCapturesWithCli(path, limit) {
   if (!existsSync(path)) return void 0;
-  try {
-    const { stdout } = await execFileAsync("sqlite3", ["-json", path, viewerCaptureSql(Math.max(1, Math.trunc(limit)))], {
-      maxBuffer: 128 * 1024 * 1024
-    });
-    if (!stdout.trim()) return [];
-    return dedupeRows(JSON.parse(stdout)).map(rowToCapture);
-  } catch {
-    return void 0;
-  }
+  await runSqlite3Json(path, "alter table captures add column event_type text");
+  await runSqlite3Json(path, "update captures set event_type = json_extract(payload_json, '$.event.type') where kind = 'event' and event_type is null");
+  const stdout = await runSqlite3Json(path, viewerCaptureSql(Math.max(1, Math.trunc(limit))));
+  if (!stdout?.trim()) return [];
+  return dedupeRows(JSON.parse(stdout)).map(rowToCapture);
 }
 function recentCaptureSql(limit) {
   return `select id, kind, timestamp, session_id, message_id, provider_id, model_id, payload_json
@@ -331,7 +342,7 @@ function recentCaptureSql(limit) {
           or id in (
             select id from captures
             where kind = 'event'
-              and json_extract(payload_json, '$.event.type') in (
+              and event_type in (
                 'message.updated',
                 'message.part.updated',
                 'message.part.delta',
@@ -359,7 +370,7 @@ function viewerCaptureSql(limit) {
           or id in (
             select id from captures
             where kind = 'event'
-              and json_extract(payload_json, '$.event.type') in (
+              and event_type in (
                 'message.updated',
                 'message.part.updated',
                 'message.part.delta',

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Plugin } from '@opencode-ai/plugin';
 import { TuiPlugin } from '@opencode-ai/plugin/tui';
-export { a as CaptureKind, C as CaptureRecord, b as CaptureStore, I as InsightsOptions, J as JsonlCaptureStore, S as SqliteCaptureStore, c as SqliteDb, d as createCaptureStore, e as defaultDataDir, n as normalizeChatHeadersCapture, f as normalizeChatMessageCapture, g as normalizeChatParamsCapture, h as normalizeEventCapture, i as normalizeExperimentalChatMessagesTransformCapture, j as normalizeExperimentalChatSystemTransformCapture, k as normalizeToolCapture, o as openDatabase, r as resolveCapturePath, l as resolveRetentionDays } from './capture-B6sM1QQA.js';
+export { a as CaptureKind, C as CaptureRecord, b as CaptureStore, I as InsightsOptions, J as JsonlCaptureStore, S as SqliteCaptureStore, c as SqliteDb, d as createCaptureStore, e as defaultDataDir, f as extractEventType, n as normalizeChatHeadersCapture, g as normalizeChatMessageCapture, h as normalizeChatParamsCapture, i as normalizeEventCapture, j as normalizeExperimentalChatMessagesTransformCapture, k as normalizeExperimentalChatSystemTransformCapture, l as normalizeToolCapture, o as openDatabase, r as resolveCapturePath, m as resolveRetentionDays } from './capture-Dy799i3Z.js';
 
 type StreamSample = {
     at: number;

package/dist/index.js

@@ -19,6 +19,7 @@ import {
   SqliteCaptureStore,
   createCaptureStore,
   defaultDataDir,
+  extractEventType,
   normalizeChatHeadersCapture,
   normalizeChatMessageCapture,
   normalizeChatParamsCapture,
@@ -29,7 +30,7 @@ import {
   openDatabase,
   resolveCapturePath,
   resolveRetentionDays
-} from "./chunk-PBX4AJCR.js";
+} from "./chunk-XCHFXQIL.js";
 
 // src/cli-shim.ts
 import { existsSync } from "fs";
@@ -141,6 +142,7 @@ export {
   src_default as default,
   defaultDataDir,
   estimateStreamTokens,
+  extractEventType,
   getSubagentItems,
   getSubagentSidebarModel,
   id,

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@rejacky/opencode-insights",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "OpenCode plugin for local request capture, TPS metrics, and subagent status visibility.",
   "type": "module",
   "author": "opencode-insights contributors",