@rejacky/opencode-insights 0.1.2 → 0.1.3

package/README.md

@@ -4,49 +4,13 @@ Local OpenCode observability for live TPS, subagent status, and full-fidelity re
 
 ## Install
 
-Install from your OpenCode config/package directory:
+Install globally with OpenCode's plugin manager:
 
 ```bash
-cd ~/.config/opencode
-npm i @rejacky/opencode-insights
-npx opencode-insights configure
-```
-
-Restart OpenCode after configuring the plugin.
-
-`opencode-insights configure` updates two config files because OpenCode loads server plugins and TUI plugins separately:
-
-```json
-// ~/.config/opencode/opencode.json or opencode.jsonc
-{
-  "plugin": ["@rejacky/opencode-insights"]
-}
+opencode plugin @rejacky/opencode-insights --global
 ```
 
-```json
-// ~/.config/opencode/tui.json
-{
-  "plugin": ["@rejacky/opencode-insights/tui"]
-}
-```
-
-Preview config changes without writing files:
-
-```bash
-npx opencode-insights configure --dry-run
-```
-
-OpenCode 1.17.14 loads `tui.json` for TUI plugins. It does not load `tui.jsonc`, so `configure` always writes the TUI plugin entry to `tui.json`.
-
-The TUI plugin value is the package export `@rejacky/opencode-insights/tui`, not an absolute `dist/tui.js` path.
-
-OpenCode resolves TUI plugin entries through module resolution, so this works after installing the package in your OpenCode config/package directory.
-
-Use a custom OpenCode config directory:
-
-```bash
-npx opencode-insights configure --config-dir ~/.config/opencode
-```
+Restart OpenCode after installing the plugin.
 
 ## Uninstall
 

package/dist/{chunk-N3MIWWYE.js → chunk-36ZNCLI3.js}

@@ -299,10 +299,9 @@ function extractSubagent(event) {
   const completedMs = numberFromPath(info.time, "completed");
   const explicitUpdatedMs = numberFromPath(info.time, "updated");
   const updatedMs = completedMs ?? explicitUpdatedMs ?? startedMs;
-  const infoStatus = asString(info.status);
-  const hasError = info.error !== void 0 || infoStatus === "error";
-  const status = hasError ? "error" : typeof completedMs === "number" || infoStatus === "idle" ? "done" : "running";
-  const terminalMs = typeof completedMs === "number" || infoStatus === "idle" ? updatedMs : status === "error" && typeof explicitUpdatedMs === "number" ? explicitUpdatedMs : void 0;
+  const hasError = info.error !== void 0 || asString(info.status) === "error";
+  const status = hasError ? "error" : typeof completedMs === "number" ? "done" : "running";
+  const terminalMs = typeof completedMs === "number" ? updatedMs : status === "error" && typeof explicitUpdatedMs === "number" ? explicitUpdatedMs : void 0;
   const endedAt = typeof terminalMs === "number" ? new Date(terminalMs).toISOString() : void 0;
   return {
     id,
@@ -324,11 +323,8 @@ function updateExistingSubagent(state, event) {
   const previous = state.children[sessionID];
   if (!previous) return void 0;
   const info = isRecord(evt.properties?.info) ? evt.properties.info : void 0;
-  const completedMs = numberFromPath(info?.time, "completed");
-  const messageCompleted = evt.type === "message.updated" && asString(info?.role) === "assistant" && typeof completedMs === "number";
-  const messageFailed = messageCompleted && info?.error !== void 0;
-  const status = messageFailed ? "error" : messageCompleted ? "done" : statusFromEvent(event) ?? previous.status;
-  const timestamp = messageCompleted ? new Date(completedMs).toISOString() : (/* @__PURE__ */ new Date()).toISOString();
+  const status = statusFromEvent(event) ?? previous.status;
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   const done = status === "done" || status === "error";
   return {
     ...previous,
@@ -342,11 +338,9 @@ function statusFromEvent(event) {
   if (!isRecord(event)) return void 0;
   const evt = event;
   if (evt.type === "session.error") return "error";
-  if (evt.type === "session.idle") return "done";
   if (evt.type === "session.status" && isRecord(evt.properties?.status)) {
     const statusType = asString(evt.properties.status.type);
     if (statusType === "busy" || statusType === "running") return "running";
-    if (statusType === "idle") return "done";
     if (statusType === "error") return "error";
   }
   return void 0;

package/dist/cli.d.ts

@@ -81,7 +81,7 @@ declare function summarizeSessions(sessions: ReturnType<typeof buildRequestHisto
 }[];
 declare function formatSessionSummary(rows: ReturnType<typeof summarizeSessions>): string;
 type JsonObject = Record<string, unknown>;
-declare function configureOpenCode(options: CliOptions): Promise<string>;
+declare function configureOpenCodeDebug(options: CliOptions): Promise<string>;
 declare function defaultOpenCodeConfigDir(): string;
 declare function resolveOpenCodeConfigPath(configDir: string): string;
 declare function stripJsonCommentsAndTrailingCommas(input: string): string;
@@ -89,4 +89,4 @@ declare function addUniquePlugin(config: JsonObject, plugin: string): boolean;
 declare function removePlugin(config: JsonObject, plugin: string): boolean;
 declare function uninstallOpenCode(options: CliOptions): Promise<string>;
 
-export { addUniquePlugin, configureOpenCode, defaultOpenCodeConfigDir, formatSessionSummary, parseOptions, removePlugin, resolveOpenCodeConfigPath, stripJsonCommentsAndTrailingCommas, summarizeSessions, uninstallOpenCode };
+export { addUniquePlugin, configureOpenCodeDebug, defaultOpenCodeConfigDir, formatSessionSummary, parseOptions, removePlugin, resolveOpenCodeConfigPath, stripJsonCommentsAndTrailingCommas, summarizeSessions, uninstallOpenCode };

package/dist/cli.js

@@ -7,7 +7,7 @@ import {
 import { execFile as execFile2 } from "child_process";
 import { existsSync as existsSync2, realpathSync } from "fs";
 import { mkdir, readFile as readFile2, rm, writeFile } from "fs/promises";
-import { dirname, join } from "path";
+import { dirname, join, resolve } from "path";
 import { homedir } from "os";
 import { pathToFileURL } from "url";
 import { promisify as promisify2 } from "util";
@@ -398,16 +398,16 @@ async function serveViewer(options = {}) {
     response.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
     response.end("Not found");
   });
-  await new Promise((resolve, reject) => {
+  await new Promise((resolve2, reject) => {
     server.once("error", reject);
     server.listen(port, host, () => {
       server.off("error", reject);
-      resolve();
+      resolve2();
     });
   });
   return {
     url: `http://${host}:${port}`,
-    close: () => new Promise((resolve) => server.close(() => resolve()))
+    close: () => new Promise((resolve2) => server.close(() => resolve2()))
   };
 }
 async function readHistory(options = {}) {
@@ -954,7 +954,8 @@ var execFileAsync2 = promisify2(execFile2);
 var DEFAULT_RECENT_LIMIT = 20;
 var DEFAULT_HISTORY_LIMIT = 5e3;
 var SERVER_PLUGIN_SPEC = "@rejacky/opencode-insights";
-var TUI_PLUGIN_SPEC = "@rejacky/opencode-insights";
+var TUI_PLUGIN_SPEC = SERVER_PLUGIN_SPEC;
+var SUBPATH_TUI_PLUGIN_SPEC = "@rejacky/opencode-insights/tui";
 async function main(argv) {
   const command = argv[2] ?? "recent";
   const options = parseOptions(argv.slice(3));
@@ -1034,8 +1035,8 @@ async function main(argv) {
 `);
     return;
   }
-  if (command === "configure") {
-    process.stdout.write(`${await configureOpenCode(options)}
+  if (command === "debug") {
+    process.stdout.write(`${await configureOpenCodeDebug(options)}
 `);
     return;
   }
@@ -1222,28 +1223,36 @@ async function vacuumDatabase(options) {
   await execFileAsync2("sqlite3", [dbPath, "vacuum;"]);
   return `Vacuumed ${dbPath}`;
 }
-async function configureOpenCode(options) {
+async function configureOpenCodeDebug(options) {
   const configDir = options.configDir ?? defaultOpenCodeConfigDir();
   const opencodePath = resolveOpenCodeConfigPath(configDir);
   const tuiPath = join(configDir, "tui.json");
+  const localServerEntry = resolve("dist/index.js");
+  const localTuiEntry = resolve("dist/tui.js");
+  if (!existsSync2(localServerEntry) || !existsSync2(localTuiEntry)) {
+    throw new Error("Missing dist output. Run npm run build before opencode-insights debug.");
+  }
   const opencodeConfig = await readJsonConfig(opencodePath, { plugin: [] });
   const tuiConfig = await readJsonConfig(tuiPath, { plugin: [] });
-  const opencodeChanged = addUniquePlugin(opencodeConfig, SERVER_PLUGIN_SPEC);
-  const tuiChanged = addUniquePlugin(tuiConfig, TUI_PLUGIN_SPEC);
+  setSinglePluginSpec(opencodeConfig, SERVER_PLUGIN_SPEC, localServerEntry);
+  setSinglePluginSpec(tuiConfig, TUI_PLUGIN_SPEC, localTuiEntry);
+  removePlugin(tuiConfig, SUBPATH_TUI_PLUGIN_SPEC);
   const lines = [
     `OpenCode config: ${opencodePath}`,
     `TUI config: ${tuiPath}`,
-    `Server plugin: ${opencodeChanged ? "added" : "already present"} (${SERVER_PLUGIN_SPEC})`,
-    `TUI plugin: ${tuiChanged ? "added" : "already present"} (${TUI_PLUGIN_SPEC})`
+    `Local server plugin: ${localServerEntry}`,
+    `Local TUI plugin: ${localTuiEntry}`,
+    `Server plugin: set local build output`,
+    `TUI plugin: set local build output`
   ];
   if (options.dryRun) {
     lines.push("Dry run: no files written.");
     return lines.join("\n");
   }
   await mkdir(configDir, { recursive: true });
-  if (opencodeChanged || !existsSync2(opencodePath)) await writeJsonConfig(opencodePath, opencodeConfig);
-  if (tuiChanged || !existsSync2(tuiPath)) await writeJsonConfig(tuiPath, tuiConfig);
-  lines.push("Configuration written. Restart OpenCode to load the plugin.");
+  await writeJsonConfig(opencodePath, opencodeConfig);
+  await writeJsonConfig(tuiPath, tuiConfig);
+  lines.push("Debug configuration written. Restart OpenCode to load the local build.");
   return lines.join("\n");
 }
 function defaultOpenCodeConfigDir() {
@@ -1332,6 +1341,19 @@ function removePlugin(config, plugin) {
 function isPluginEntry(entry, plugin) {
   return entry === plugin || Array.isArray(entry) && entry[0] === plugin;
 }
+function setSinglePluginSpec(config, previousPlugin, nextPlugin) {
+  const current = Array.isArray(config.plugin) ? config.plugin : [];
+  const next = current.filter((entry) => !isInsightsPluginEntry(entry, previousPlugin, nextPlugin));
+  config.plugin = [...next, nextPlugin];
+}
+function isInsightsPluginEntry(entry, packagePlugin, localPlugin) {
+  if (isPluginEntry(entry, packagePlugin) || isPluginEntry(entry, localPlugin) || isPluginEntry(entry, SUBPATH_TUI_PLUGIN_SPEC)) {
+    return true;
+  }
+  const spec = Array.isArray(entry) ? entry[0] : entry;
+  if (typeof spec !== "string") return false;
+  return /(?:^|[/@-])opencode-insights.*\.tgz$/u.test(spec) || /\/opencode-insights\/dist\/(?:index|tui)\.js$/u.test(spec);
+}
 async function uninstallOpenCode(options) {
   const configDir = options.configDir ?? defaultOpenCodeConfigDir();
   const opencodePath = resolveOpenCodeConfigPath(configDir);
@@ -1346,8 +1368,10 @@ async function uninstallOpenCode(options) {
   ];
   const opencodeResult = await removePluginFromConfig(opencodePath, SERVER_PLUGIN_SPEC, options);
   const tuiResult = await removePluginFromConfig(tuiPath, TUI_PLUGIN_SPEC, options);
+  const subpathTuiResult = await removePluginFromConfig(tuiPath, SUBPATH_TUI_PLUGIN_SPEC, options);
   lines.push(`Server plugin: ${opencodeResult}`);
   lines.push(`TUI plugin: ${tuiResult}`);
+  lines.push(`Subpath TUI plugin: ${subpathTuiResult}`);
   if (options.keepData) {
     lines.push("Data cleanup: skipped (--keep-data).");
   } else {
@@ -1387,7 +1411,7 @@ async function writeJsonConfig(path, config) {
 function usage() {
   return [
     "Usage:",
-    "  opencode-insights configure [--config-dir DIR] [--dry-run]",
+    "  opencode-insights debug [--config-dir DIR] [--dry-run]",
     "  opencode-insights uninstall [--config-dir DIR] [--db PATH] [--data-dir DIR] [--keep-data] [--dry-run]",
     "  opencode-insights recent [--db PATH] [--data-dir DIR] [--limit N] [--json]",
     "  opencode-insights sessions [--db PATH] [--data-dir DIR] [--limit N] [--json]",
@@ -1418,7 +1442,7 @@ if (isDirectRun()) {
 }
 export {
   addUniquePlugin,
-  configureOpenCode,
+  configureOpenCodeDebug,
   defaultOpenCodeConfigDir,
   formatSessionSummary,
   parseOptions,

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 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 createCaptureStore, d as defaultDataDir, n as normalizeChatHeadersCapture, e as normalizeChatMessageCapture, f as normalizeChatParamsCapture, g as normalizeEventCapture, h as normalizeExperimentalChatMessagesTransformCapture, i as normalizeExperimentalChatSystemTransformCapture, j as normalizeToolCapture, r as resolveCapturePath } from './capture-gQauLsdn.js';
 
 type StreamSample = {
@@ -102,10 +103,13 @@ declare function renderSubagentFooter(state: SubagentState, parentID: string, op
 
 declare const OpenCodeInsights: Plugin;
 declare const server: Plugin;
+declare const rootTui: TuiPlugin;
 declare const id = "opencode-insights";
+
 declare const _default: {
     id: string;
     server: Plugin;
+    tui: TuiPlugin;
 };
 
-export { type MessageTiming, type MetricsState, OpenCodeInsights, type SessionAverage, type StreamSample, type SubagentInfo, type SubagentSidebarModel, type SubagentSidebarRow, type SubagentState, type SubagentStatus, applySubagentEvent, createMetricsState, createSubagentState, _default as default, estimateStreamTokens, getSubagentItems, getSubagentSidebarModel, id, pruneStaleSubagents, recordAssistantDelta, recordAssistantMessage, recordToolActivity, renderMetricsText, renderSubagentFooter, renderSubagentSidebar, renderSubagentStatus, server };
+export { type MessageTiming, type MetricsState, OpenCodeInsights, type SessionAverage, type StreamSample, type SubagentInfo, type SubagentSidebarModel, type SubagentSidebarRow, type SubagentState, type SubagentStatus, applySubagentEvent, createMetricsState, createSubagentState, _default as default, estimateStreamTokens, getSubagentItems, getSubagentSidebarModel, id, pruneStaleSubagents, recordAssistantDelta, recordAssistantMessage, recordToolActivity, renderMetricsText, renderSubagentFooter, renderSubagentSidebar, renderSubagentStatus, server, rootTui as tui };

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   renderSubagentFooter,
   renderSubagentSidebar,
   renderSubagentStatus
-} from "./chunk-N3MIWWYE.js";
+} from "./chunk-36ZNCLI3.js";
 import {
   JsonlCaptureStore,
   SqliteCaptureStore,
@@ -73,8 +73,12 @@ var OpenCodeInsights = async (_input, options) => {
   };
 };
 var server = OpenCodeInsights;
+var rootTui = async (...args) => {
+  const mod = await import("./tui.js");
+  return mod.tui(...args);
+};
 var id = "opencode-insights";
-var src_default = { id, server };
+var src_default = { id, server, tui: rootTui };
 export {
   JsonlCaptureStore,
   OpenCodeInsights,
@@ -105,5 +109,6 @@ export {
   renderSubagentSidebar,
   renderSubagentStatus,
   resolveCapturePath,
-  server
+  server,
+  rootTui as tui
 };

package/dist/tui.js

@@ -8,11 +8,11 @@ import {
   recordToolActivity,
   renderMetricsText,
   renderSubagentFooter
-} from "./chunk-N3MIWWYE.js";
+} from "./chunk-36ZNCLI3.js";
 
 // src/tui.tsx
 import { createTextAttributes, StyledText } from "@opentui/core";
-import { onCleanup } from "solid-js";
+import { createSignal, onCleanup } from "solid-js";
 import { jsx } from "@opentui/solid/jsx-runtime";
 function isSessionID(value) {
   return typeof value === "string" && value.startsWith("ses");
@@ -21,7 +21,10 @@ function PromptRight(props) {
   let text;
   const sync = () => {
     if (!text) return;
-    text.content = props.text();
+    const content = props.text();
+    text.content = content;
+    text.visible = content.length > 0;
+    text.height = content.length > 0 ? "auto" : 0;
     props.api.renderer.requestRender();
   };
   const unsubscribe = props.subscribe(sync);
@@ -61,10 +64,18 @@ function ReactiveText(props) {
 }
 function SubagentSidebar(props) {
   let text;
+  const [collapsed, setCollapsed] = createSignal(false);
   const titleAttributes = createTextAttributes({ bold: true });
+  const toggle = () => {
+    setCollapsed((prev) => !prev);
+    props.api.renderer.requestRender();
+  };
   const sync = () => {
     if (!text) return;
-    text.content = renderSubagentStyledSidebar(props.state, props.sessionID, props.api, titleAttributes);
+    const model = getSubagentSidebarModel(props.state, props.sessionID);
+    text.visible = !!model;
+    text.height = model ? "auto" : 0;
+    text.content = model ? renderSubagentStyledSidebar(props.state, props.sessionID, props.api, titleAttributes, collapsed()) : "";
     props.api.renderer.requestRender();
   };
   const unsubscribe = props.subscribe(sync);
@@ -80,25 +91,31 @@ function SubagentSidebar(props) {
         text = ref;
         sync();
       },
+      onMouseDown: toggle,
       fg: props.api.theme.current.textMuted,
       children: ""
     }
   );
 }
-function renderSubagentStyledSidebar(state, sessionID, api, titleAttributes) {
+function renderSubagentStyledSidebar(state, sessionID, api, titleAttributes, collapsed) {
   const model = getSubagentSidebarModel(state, sessionID);
   if (!model) return "";
+  const indicator = collapsed ? "\u25B6 " : "\u25BC ";
   const chunks = [
-    textChunk(`${model.title}
+    textChunk(`${indicator}${model.title}
 `, api.theme.current.text, titleAttributes),
     textChunk(`${model.summary}
 `, api.theme.current.textMuted)
   ];
-  for (const [index, row] of model.rows.entries()) {
-    if (index > 0) chunks.push(textChunk("\n", api.theme.current.textMuted));
-    chunks.push(textChunk(`${row.title}
+  if (!collapsed) {
+    for (const [index, row] of model.rows.entries()) {
+      if (index > 0) chunks.push(textChunk("\n"));
+      const dotColor = row.status === "running" ? api.theme.current.success : row.status === "error" ? api.theme.current.error : api.theme.current.textMuted;
+      chunks.push(textChunk("\u2022 ", dotColor));
+      chunks.push(textChunk(`${row.title}
 `, api.theme.current.text));
-    chunks.push(textChunk(row.subtitle, api.theme.current.textMuted));
+      chunks.push(textChunk(row.subtitle, api.theme.current.textMuted));
+    }
   }
   return new StyledText(chunks);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@rejacky/opencode-insights",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "OpenCode plugin for local request capture, TPS metrics, and subagent status visibility.",
   "type": "module",
   "author": "opencode-insights contributors",
@@ -46,6 +46,7 @@
   },
   "scripts": {
     "build": "tsup",
+    "debug": "npm run build && node dist/cli.js debug",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
     "verify": "npm run typecheck && npm run test && npm run build",

package/DEVELOPMENT.md

@@ -1,124 +0,0 @@
-# Development
-
-Notes for maintaining and publishing `opencode-insights`.
-
-## Local Testing
-
-From this repo:
-
-```bash
-cd /Users/zyao/Desktop/opencode-insights
-npm install
-npm run verify
-npm pack
-```
-
-Install the packed plugin from your OpenCode config/package directory:
-
-```bash
-cd ~/.config/opencode
-npm i /Users/zyao/Desktop/opencode-insights/rejacky-opencode-insights-*.tgz
-npx opencode-insights configure
-```
-
-For local repo development without relying on the installed package binary:
-
-```bash
-node /Users/zyao/Desktop/opencode-insights/dist/cli.js configure --config-dir ~/.config/opencode
-```
-
-Restart OpenCode after reinstalling or rebuilding. Existing sessions will not gain missing events retroactively, so create a new session to test capture changes.
-
-## Faster Local Iteration
-
-Link instead of packing each time:
-
-```bash
-cd /Users/zyao/Desktop/opencode-insights
-npm link
-
-cd ~/.config/opencode
-npm link @rejacky/opencode-insights
-```
-
-After code changes:
-
-```bash
-cd /Users/zyao/Desktop/opencode-insights
-npm run build
-node /Users/zyao/Desktop/opencode-insights/dist/cli.js configure --config-dir ~/.config/opencode
-```
-
-## Verification
-
-Run all checks:
-
-```bash
-npm run verify
-```
-
-Individual commands:
-
-```bash
-npm run typecheck
-npm test
-npm run build
-```
-
-## Automated npm Publishing
-
-The repo publishes from GitHub Actions when `package.json` is pushed to `main` or `master` with a version that is not already on npm.
-
-One-time npm setup:
-
-1. Go to npm package settings for `@rejacky/opencode-insights`.
-2. Open the package publishing / trusted publishing settings.
-3. Add a trusted publisher for repository `Re-Jacky/opencode-insights`.
-4. Use workflow file `.github/workflows/publish.yml`.
-5. Keep the package public.
-
-No `NPM_TOKEN` secret is needed when npm trusted publishing is configured. The workflow uses GitHub OIDC plus `npm publish --provenance`.
-
-If GitHub Actions fails with `404 Not Found - PUT https://registry.npmjs.org/@rejacky%2fopencode-insights`, npm found the registry but rejected package write access. Check that the npm package's trusted publisher entry exactly matches the GitHub owner, repo, and workflow file path above. Also confirm the npm account configuring trusted publishing owns or has publish access to `@rejacky/opencode-insights`.
-
-Release flow:
-
-```bash
-git status
-npm version patch
-git push --follow-tags
-```
-
-Use `npm version minor` or `npm version major` for larger releases. The workflow will run verification first, skip publishing if that exact version already exists, and publish only unpublished versions.
-
-Manual fallback:
-
-```bash
-npm run verify
-npm pack --dry-run
-npm publish --access public --provenance
-```
-
-## Manual Publish Checklist
-
-Review package contents:
-
-```bash
-npm pack
-tar -tf rejacky-opencode-insights-0.1.1.tgz
-```
-
-Publish manually if GitHub Actions is unavailable:
-
-```bash
-npm login
-npm publish --access public --provenance
-```
-
-After publishing, users should be able to install from their OpenCode config/package directory with:
-
-```bash
-cd ~/.config/opencode
-npm i @rejacky/opencode-insights
-npx opencode-insights configure
-```