@taewooopark/agent-blackbox 0.44.0 → 0.45.0

package/dist/cli.js

@@ -1107,8 +1107,9 @@ function removeManagedBlock(content) {
 // apps/daemon/dist/cli.js
 import { spawn as spawn2 } from "node:child_process";
 import { existsSync } from "node:fs";
+import { homedir as homedir2 } from "node:os";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-import { dirname as dirname4, resolve } from "node:path";
+import { dirname as dirname5, join as join6, resolve } from "node:path";
 
 // apps/daemon/dist/dashboardServer.js
 import { createReadStream } from "node:fs";
@@ -1179,7 +1180,7 @@ async function startDashboardServer(options) {
 
 // apps/daemon/dist/index.js
 import { readFileSync } from "node:fs";
-import { dirname as dirname3, join as join5 } from "node:path";
+import { dirname as dirname4, join as join5 } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // packages/storage/src/ndjson.ts
@@ -1917,10 +1918,39 @@ function isNodeError(error) {
 }
 
 // apps/daemon/dist/initOpenCode.js
-import { mkdir as mkdir3, readFile as readFile4, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join4 } from "node:path";
+import { mkdir as mkdir3, readFile as readFile4, rm as rm2, writeFile as writeFile2 } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname as dirname3, join as join4 } from "node:path";
 var defaultAdapterPackage = "@agent-blackbox/opencode-adapter";
 var defaultDaemonUrl = "http://127.0.0.1:47831";
+function globalOpenCodeDir() {
+  const xdg = process.env.XDG_CONFIG_HOME;
+  return xdg && xdg.length > 0 ? join4(xdg, "opencode") : join4(homedir(), ".config", "opencode");
+}
+function globalRecorderPath() {
+  return join4(globalOpenCodeDir(), "plugins", "agent-blackbox.js");
+}
+async function installGlobalRecorder(options) {
+  if (!await pathExists(options.pluginBundlePath)) {
+    throw new Error("Self-contained recorder bundle not found. Use the published npx package, or build it from source with `npm run build:cli`.");
+  }
+  const pluginPath = globalRecorderPath();
+  const bundle = (await readFile4(options.pluginBundlePath, "utf8")).replaceAll("__ABB_DAEMON_URL__", options.daemonUrl);
+  await mkdir3(dirname3(pluginPath), { recursive: true });
+  await writeFile2(pluginPath, bundle, "utf8");
+  return { pluginPath };
+}
+async function uninstallGlobalRecorder() {
+  const pluginPath = globalRecorderPath();
+  try {
+    await rm2(pluginPath);
+    return { pluginPath, removed: true };
+  } catch (error) {
+    if (isNodeError2(error) && error.code === "ENOENT")
+      return { pluginPath, removed: false };
+    throw error;
+  }
+}
 async function initOpenCodeProject(options) {
   const adapterPackage = options.adapterPackage ?? defaultAdapterPackage;
   const adapterImport = inferAdapterImport(adapterPackage);
@@ -1998,7 +2028,7 @@ function isNodeError2(error) {
 
 // apps/daemon/dist/index.js
 function resolvePackageVersion() {
-  let dir = dirname3(fileURLToPath(import.meta.url));
+  let dir = dirname4(fileURLToPath(import.meta.url));
   for (let i = 0; i < 6; i += 1) {
     try {
       const pkg = JSON.parse(readFileSync(join5(dir, "package.json"), "utf8"));
@@ -2006,7 +2036,7 @@ function resolvePackageVersion() {
         return pkg.version;
     } catch {
     }
-    const parent = dirname3(dir);
+    const parent = dirname4(dir);
     if (parent === dir)
       break;
     dir = parent;
@@ -2020,11 +2050,15 @@ function describeDaemon() {
 
 // apps/daemon/dist/cli.js
 var args = process.argv.slice(2);
-var cliDir = dirname4(fileURLToPath2(import.meta.url));
+var cliDir = dirname5(fileURLToPath2(import.meta.url));
 var repoRoot = resolve(cliDir, "../../..");
 var firstExisting = (paths) => paths.find((p) => existsSync(p));
 var dashboardDistDir = firstExisting([resolve(cliDir, "dashboard"), resolve(repoRoot, "apps/dashboard/dist")]) ?? resolve(repoRoot, "apps/dashboard/dist");
 var pluginBundlePath = firstExisting([resolve(cliDir, "agent-blackbox.plugin.mjs")]);
+function globalDataDir() {
+  const xdg = process.env.XDG_DATA_HOME;
+  return xdg && xdg.length > 0 ? join6(xdg, "agent-blackbox") : join6(homedir2(), ".local", "share", "agent-blackbox");
+}
 void main(args);
 async function main(argv) {
   if (argv.includes("--version") || argv.includes("-v")) {
@@ -2041,12 +2075,41 @@ async function main(argv) {
     return;
   }
   if (command === "up") {
-    const projectDir = resolve(readFlag(argv, "--project") ?? process.cwd());
+    const projectFlag = readFlag(argv, "--project");
+    const global = projectFlag === void 0;
     const port = Number(readFlag(argv, "--port") ?? "47831");
     const uiPort = Number(readFlag(argv, "--ui-port") ?? "5173");
     const daemonUrl = `http://127.0.0.1:${port}`;
-    const adapterPackage = readFlag(argv, "--adapter-package") ?? `file:${resolve(repoRoot, "packages/opencode-adapter")}`;
     const suggest = readSuggestConfig(argv);
+    let daemon;
+    if (global) {
+      if (!pluginBundlePath) {
+        throw new Error("Global install needs the self-contained recorder bundle. Use the published npx package, or `npm run build:cli` then `node packages/cli/dist/cli.js up`.\n(Or scope to one project with: agent-blackbox up --project <dir>.)");
+      }
+      const { pluginPath } = await installGlobalRecorder({ daemonUrl, pluginBundlePath });
+      const dataDir = globalDataDir();
+      const eventsFile = join6(dataDir, "events.ndjson");
+      daemon = await startTraceDaemon({ projectDir: dataDir, port, eventsFile, suggest });
+      const ui2 = await startDashboardServer({ distDir: dashboardDistDir, port: uiPort, daemonUrl });
+      const dashboardUrl2 = `http://127.0.0.1:${ui2.port}`;
+      console.log(`\u2713 Global OpenCode recorder installed: ${pluginPath}`);
+      console.log(`\u2713 Agent-Blackbox is up (recording all OpenCode sessions)`);
+      console.log(`  Dashboard:  ${dashboardUrl2}`);
+      console.log(`  Daemon API: ${daemonUrl}  (trace: ${daemon.eventsFile})`);
+      console.log(`  Suggestions: ${suggest.mode}${suggest.model ? ` (${suggest.model})` : ""}`);
+      console.log("");
+      if (!argv.includes("--no-open"))
+        openInBrowser(dashboardUrl2);
+      console.log("Now use OpenCode however you already do \u2014 the dashboard fills in live:");
+      console.log("  opencode                 # in any folder (terminal), or");
+      console.log("  the OpenCode desktop app # open any project");
+      console.log("");
+      console.log("Stop recording any time with:  agent-blackbox uninstall");
+      console.log("Press Ctrl+C to stop the daemon + dashboard.");
+      return;
+    }
+    const projectDir = resolve(projectFlag);
+    const adapterPackage = readFlag(argv, "--adapter-package") ?? `file:${resolve(repoRoot, "packages/opencode-adapter")}`;
     try {
       const result = await initOpenCodeProject({
         projectDir,
@@ -2064,7 +2127,7 @@ async function main(argv) {
         throw error;
       }
     }
-    const daemon = await startTraceDaemon({ projectDir, port, suggest });
+    daemon = await startTraceDaemon({ projectDir, port, suggest });
     const ui = await startDashboardServer({ distDir: dashboardDistDir, port: uiPort, daemonUrl });
     const dashboardUrl = `http://127.0.0.1:${ui.port}`;
     console.log("");
@@ -2076,11 +2139,29 @@ async function main(argv) {
     if (!argv.includes("--no-open"))
       openInBrowser(dashboardUrl);
     console.log("Now run your agent in that project, e.g.:");
-    console.log(`  AGENT_BLACKBOX_DAEMON_URL=${daemonUrl} opencode run --dir ${projectDir} "Read the code, run tests, summarize."`);
+    console.log(`  opencode    # in ${projectDir} (the project-local recorder streams here)`);
     console.log("");
     console.log("Press Ctrl+C to stop.");
     return;
   }
+  if (command === "install") {
+    const port = Number(readFlag(argv, "--port") ?? "47831");
+    const daemonUrl = `http://127.0.0.1:${port}`;
+    if (!pluginBundlePath) {
+      throw new Error("Global install needs the self-contained recorder bundle. Use the published npx package, or `npm run build:cli` first.");
+    }
+    const { pluginPath } = await installGlobalRecorder({ daemonUrl, pluginBundlePath });
+    console.log(`\u2713 Global OpenCode recorder installed: ${pluginPath}`);
+    console.log(`  Every OpenCode session (any folder, terminal, or the app) now streams to ${daemonUrl}.`);
+    console.log(`  Start the dashboard with:  agent-blackbox up`);
+    console.log(`  Remove with:               agent-blackbox uninstall`);
+    return;
+  }
+  if (command === "uninstall") {
+    const { pluginPath, removed } = await uninstallGlobalRecorder();
+    console.log(removed ? `\u2713 Removed global OpenCode recorder: ${pluginPath}` : `Nothing to remove \u2014 ${pluginPath} is not present.`);
+    return;
+  }
   if (command === "replay") {
     const eventsFile = argv[1];
     if (!eventsFile) {
@@ -2138,8 +2219,11 @@ function printHelp() {
   console.log(describeDaemon());
   console.log("");
   console.log("Usage:");
-  console.log("  agent-blackbox up [--project <dir>] [--port <port>] [--ui-port <port>]   # plugin + daemon + dashboard, one command");
-  console.log("       [--suggest auto|free|off|ollama|opencode|openai-compat] [--suggest-model <id>] [--suggest-base-url <url>] [--optimize] [--no-open]");
+  console.log("  agent-blackbox up                       # GLOBAL: record every OpenCode session (any folder / the app) + daemon + dashboard");
+  console.log("  agent-blackbox up --project <dir>        # scope the recorder to one project instead");
+  console.log("       [--port <port>] [--ui-port <port>] [--suggest auto|free|off|ollama|opencode|openai-compat] [--suggest-model <id>] [--optimize] [--no-open]");
+  console.log("  agent-blackbox install [--port <port>]   # install the global recorder only (no daemon)");
+  console.log("  agent-blackbox uninstall                 # remove the global recorder");
   console.log("  agent-blackbox daemon [--project <dir>] [--port <port>]");
   console.log("  agent-blackbox init-opencode [--project <dir>] [--daemon-url <url>] [--adapter-package <specifier>] [--force] [--optimize]");
   console.log("  agent-blackbox optimize [--project <dir>] [--apply | --check | --revert]   # write/measure/rollback AGENTS.md efficiency memory");

package/package.json

@@ -1,13 +1,26 @@
 {
   "name": "@taewooopark/agent-blackbox",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "description": "Local-first flight recorder + context-efficiency profiler for coding agents (OpenCode). Run with npx.",
   "type": "module",
   "license": "MIT",
-  "repository": { "type": "git", "url": "git+https://github.com/TaewoooPark/Agent-Blackbox.git" },
-  "bin": { "agent-blackbox": "dist/cli.js" },
-  "files": ["dist"],
-  "engines": { "node": ">=20" },
-  "dependencies": { "ws": "^8.21.0" },
-  "scripts": { "bundle": "node build.mjs" }
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TaewoooPark/Agent-Blackbox.git"
+  },
+  "bin": {
+    "agent-blackbox": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "ws": "^8.21.0"
+  },
+  "scripts": {
+    "bundle": "node build.mjs"
+  }
 }