agentglow 0.2.11 → 0.3.0

package/README.md

@@ -86,7 +86,7 @@ import dynamic from "next/dynamic";
 const AgentScene = dynamic(() => import("agentglow").then((m) => m.AgentScene), { ssr: false });
 
 export default function Live() {
-  return <AgentScene theme="subway" source="http://localhost:8100" style={{ height: "80vh" }} />;
+  return <AgentScene theme="orbit" source="http://localhost:8100" style={{ height: "80vh" }} />;
 }
 ```
 
@@ -141,27 +141,14 @@ backoff on its own. Changing `scope`, `run` or `token` reconnects and clears the
 |-----------|---------|
 | `orbit`   | Agents orbit a graph galaxy. Runs are rings and MCP servers are satellites. |
 | `neural`  | A living brain. Agents fire as neurons and messages pulse along synapses. |
-| `subway`  | A neon transit map. Each run is a line and each agent is a train. |
-| `city`    | A night city. Agents rise as skyscrapers in run districts. |
-| `ocean`   | Bioluminescent jellyfish drift on run currents over a coral graph. |
-| `circuit` | Agent chips sit on run buses, wired to a memory bank and MCP I/O ports. |
-| `tunnel`  | A time warp. Runs are lanes and gates, and agents are ships. |
 | `flow`    | A murmuration. Agents condense as eddies out of the current. |
-| `hive`    | A glowing honeycomb. Agents are bees; subagents fly out as workers. |
-| `forest`  | A moonlit forest. Agents grow as trees, subagents as saplings, LLM calls as fireflies. |
 | `constellation` | A night sky. Delegation draws constellation lines between agent stars. |
-| `factory` | A neon factory floor. Agents are machines; work rides conveyor belts. |
-| `airport` | A radar scope. Agents are flights; handoffs are flight paths. |
-| `mycelium`| A glowing fungal network. Agents bloom as mushrooms on spreading threads. |
 | `atom`    | An atom. Agents are electrons; subagents orbit their parent. |
 
 | | | |
 |:-:|:-:|:-:|
-| ![neural](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/neural.jpg) **neural** | ![hive](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/hive.jpg) **hive** | ![constellation](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/constellation.jpg) **constellation** |
-| ![orbit](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/orbit.jpg) **orbit** | ![forest](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/forest.jpg) **forest** | ![mycelium](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/mycelium.jpg) **mycelium** |
-| ![atom](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/atom.jpg) **atom** | ![airport](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/airport.jpg) **airport** | ![factory](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/factory.jpg) **factory** |
-| ![city](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/city.jpg) **city** | ![ocean](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/ocean.jpg) **ocean** | ![subway](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/subway.jpg) **subway** |
-| ![circuit](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/circuit.jpg) **circuit** | ![tunnel](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/tunnel.jpg) **tunnel** | ![flow](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/flow.jpg) **flow** |
+| ![neural](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/neural.jpg) **neural** | ![constellation](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/constellation.jpg) **constellation** | ![orbit](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/orbit.jpg) **orbit** |
+| ![atom](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/atom.jpg) **atom** | ![flow](https://raw.githubusercontent.com/Nideesh1/agentglow/main/docs/media/flow.jpg) **flow** | |
 
 ## Layout
 

package/cli/agentglow.mjs

@@ -31,6 +31,9 @@ const HELP = `agentglow ${VERSION}: watch Claude Code agents in 3D
   npx agentglow stop                  stop the background server
   npx agentglow remove                undo setup: remove the hooks and stop the server
   npx agentglow claude [-- <args>]    try it without installing: one claude session with AgentGlow
+  npx agentglow setup --capture-prompts
+                                      also show your prompts next to Claude's replies in the agent panel
+                                      (off by default; local server only, secrets redacted)
 
 
 More: npx agentglow start [--background] [--port N]   (serve = start in the foreground)
@@ -61,6 +64,7 @@ function parseArgs(argv) {
     else if (a === "--uninstall") o.uninstall = true;
     else if (a === "--remove") o.remove = true;
     else if (a === "--no-autostart") o.autostart = false;
+    else if (a === "--capture-prompts") o.capturePrompts = true;
     else if (a === "--background" || a === "-b") o.background = true;
     else if (a === "--quiet" || a === "-q") o.quiet = true;
     else if (a === "-h" || a === "--help") o.help = true;
@@ -141,6 +145,9 @@ async function cmdSetup(o) {
   const remote = remoteUrl();
   const port = o.port;
   const base = remote || baseUrl({ port });
+  // Opt-in: the local server keeps the user's prompt text (login item env + SessionStart command + started server)
+  if (o.capturePrompts && !remote) process.env.AGENTGLOW_CAPTURE_PROMPTS = "1";
+  const capturePrompts = process.env.AGENTGLOW_CAPTURE_PROMPTS === "1";
   // The AgentGlow Claude Code plugin brings the same hooks + server start; adding ours too would post every event twice.
   const plugin = pluginIdsIn(file);
   if (plugin.length) {
@@ -151,7 +158,7 @@ async function cmdSetup(o) {
   if (!remote && !plugin.length) {
     const script = installCliCopy({ srcCliDir: here, version: VERSION });
     startCommand = startHookCommand({
-      port, version: VERSION, node: nodeForHook(), script, cacheDir: process.env.AGENTGLOW_CACHE_DIR,
+      port, version: VERSION, node: nodeForHook(), script, cacheDir: process.env.AGENTGLOW_CACHE_DIR, capturePrompts,
     });
   }
   const r = installSettingsFile(file, base, { startCommand, hooks: !plugin.length, extra: remote ? {} : { port } });
@@ -184,6 +191,14 @@ async function cmdSetup(o) {
       return 1;
     }
   }
+  if (o.capturePrompts && remote) console.log("--capture-prompts is for a local server only; ignored with AGENTGLOW_URL.");
+  else if (capturePrompts) {
+    const h = await fetchText(localBase(port) + "/live/health", 2000);
+    let on = false;
+    try { on = JSON.parse(h?.body || "{}").prompts === true; } catch { /* not ours */ }
+    console.log(on ? "Prompts: captured (local only)."
+      : `Prompts: the running server was started without capture; restart it: npx agentglow stop${portFlag(port)} && npx agentglow start --background${portFlag(port)}`);
+  }
   if (o.open) openBrowser(view);
   console.log(`\nDone. Just run \`claude\` as usual. View: ${view}  Undo: npx agentglow remove`);
   return 0;
@@ -194,11 +209,14 @@ async function cmdSetup(o) {
 function installLoginItem(port) {
   const script = installCliCopy({ srcCliDir: here, version: VERSION });
   const node = nodeForHook() || process.execPath;
-  const command = startHookCommand({ port, version: VERSION, node, script, cacheDir: process.env.AGENTGLOW_CACHE_DIR });
+  const command = startHookCommand({
+    port, version: VERSION, node, script, cacheDir: process.env.AGENTGLOW_CACHE_DIR,
+    capturePrompts: process.env.AGENTGLOW_CAPTURE_PROMPTS === "1",
+  });
   // macOS/Linux: the supervisor runs the server in the foreground (argv, no shell); Windows keeps the shell command
   const argv = [node, script, "start", "--port", String(port)];
   const env = { PATH: loginPath({ node }), HOME: os.homedir() };
-  for (const k of ["AGENTGLOW_CACHE_DIR", "AGENTGLOW_API_KEY", "AGENTGLOW_INGEST_KEY", "AGENTGLOW_SECRET", "AGENTGLOW_PY_SPEC"]) {
+  for (const k of ["AGENTGLOW_CACHE_DIR", "AGENTGLOW_API_KEY", "AGENTGLOW_INGEST_KEY", "AGENTGLOW_SECRET", "AGENTGLOW_PY_SPEC", "AGENTGLOW_CAPTURE_PROMPTS"]) {
     if (process.env[k]) env[k] = process.env[k];
   }
   try {
@@ -331,6 +349,7 @@ async function cmdStatus(o) {
   console.log(`hooks:   ${hooksLine}`);
   if (installed && plugin.length) console.log(`warning: hooks are in ${file} AND the plugin is enabled, so events post twice. Run \`npx agentglow remove\` or disable the plugin.`);
   if (hasAutostart()) console.log(`login:   server starts at login and restarts on crash`);
+  if (health?.prompts) console.log(`prompts: captured (local only)`);
   if (health?.ok) console.log(`view:    ${base}/neural`);
   return 0;
 }

package/cli/lib/server.mjs

@@ -2,7 +2,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { spawn, spawnSync } from "node:child_process";
-import { probe } from "./net.mjs";
+import { fetchText, probe } from "./net.mjs";
 import { cacheDir, findRunner } from "./uv.mjs";
 
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
@@ -19,10 +19,21 @@ export function pySpecs(version, env = process.env) {
   return /^\d+\.\d+\.\d+$/.test(version || "") ? [`agentglow==${version}`, "agentglow"] : ["agentglow"];
 }
 
-export function serveArgv(runner, spec, port) {
+/**
+ * Launch attempts in order: the pinned spec, the same pin again with uv's cached PyPI index refreshed (a version
+ * published after uv last fetched the index is otherwise "not found"), then the latest agentglow.
+ */
+export function pyAttempts(version, env = process.env) {
+  const [first, ...rest] = pySpecs(version, env);
+  const pinned = /^agentglow==/.test(first);
+  return [{ spec: first }, ...(pinned ? [{ spec: first, refresh: true }] : []), ...rest.map((spec) => ({ spec }))];
+}
+
+export function serveArgv(runner, spec, port, { refresh = false } = {}) {
   // a local checkout (AGENTGLOW_PY_SPEC=/path/to/backend): run it editable, uvx otherwise serves a stale cached build
   const local = /^(\/|\.|~|[A-Za-z]:[\\/])/.test(spec);
-  return [...runner.args, ...(local ? ["--with-editable", spec] : []), "--from", spec,
+  return [...runner.args, ...(refresh ? ["--refresh-package", "agentglow"] : []),
+    ...(local ? ["--with-editable", spec] : []), "--from", spec,
     "agentglow", "serve", "--host", "127.0.0.1", "--port", String(port)];
 }
 
@@ -37,6 +48,22 @@ export function readPid(port) {
   } catch { return null; }
 }
 
+/** What to log when attempt i failed and attempt i + 1 (if any) comes next. */
+export function retryNote(attempts, i, version) {
+  const { spec } = attempts[i], next = attempts[i + 1];
+  if (!next) return `${spec} failed to start, giving up`;
+  if (next.refresh) return `${spec} failed to start, refreshing uv's cached PyPI index and retrying`;
+  return `${spec} failed to start, falling back to the latest agentglow on PyPI` +
+    (version ? ` (this CLI expects ${version}, the server may be older)` : "");
+}
+
+/** After a fallback start: say which server version is running when it is not the one this CLI expects. */
+async function noteVersion(port, version, log) {
+  let v = "";
+  try { v = JSON.parse((await fetchText(localBase(port) + "/live/health", 2000))?.body || "{}").version || ""; } catch { /* unknown */ }
+  if (v !== version) log(`  WARNING: running agentglow server ${v || "?"}, expected ${version}. Restart it once ${version} is on PyPI.`);
+}
+
 function tail(file, n = 15) {
   try { return fs.readFileSync(file, "utf8").trimEnd().split("\n").slice(-n).join("\n"); } catch { return ""; }
 }
@@ -50,9 +77,10 @@ export async function startBackground({ port, version, log = console.error, time
       "First run downloads Python + agentglow, about 30-60s ...");
   const logPath = logFile(port);
   let lastErr = "";
-  for (const spec of pySpecs(version)) {
+  const attempts = pyAttempts(version);
+  for (const [i, { spec, refresh }] of attempts.entries()) {
     const fd = fs.openSync(logPath, "w");
-    const child = spawn(runner.cmd, serveArgv(runner, spec, port), {
+    const child = spawn(runner.cmd, serveArgv(runner, spec, port, { refresh }), {
       detached: true, stdio: ["ignore", fd, fd], windowsHide: true,
       env: { ...process.env, PYTHONUNBUFFERED: "1" },
     });
@@ -65,7 +93,10 @@ export async function startBackground({ port, version, log = console.error, time
     const t0 = Date.now();
     let noted = false;
     while (Date.now() - t0 < timeoutMs) {
-      if ((await probe(localBase(port), 1500)) === "agentglow") return { pid: child.pid, started: true };
+      if ((await probe(localBase(port), 1500)) === "agentglow") {
+        if (spec !== attempts[0].spec) await noteVersion(port, version, log);
+        return { pid: child.pid, started: true };
+      }
       if (exited !== null) break;
       if (!noted && Date.now() - t0 > 15000) { log("  still preparing the Python environment ..."); noted = true; }
       await sleep(500);
@@ -77,7 +108,7 @@ export async function startBackground({ port, version, log = console.error, time
     }
     fs.rmSync(pidFile(port), { force: true });
     lastErr = tail(logPath) || lastErr;
-    log(`  ${spec} failed to start, ${spec === "agentglow" ? "giving up" : "retrying with the latest agentglow"} ...`);
+    log(`  ${retryNote(attempts, i, version)} ...`);
   }
   throw new Error(`AgentGlow server failed to start. Log: ${logPath}\n${lastErr}`);
 }
@@ -166,12 +197,12 @@ export function removeCliCopies() {
 /** Run the server in the foreground (stdio inherited). Resolves with its exit code. */
 export async function serveForeground({ port, version, log = console.error }) {
   const runner = await findRunner({ log });
-  const specs = pySpecs(version);
+  const attempts = pyAttempts(version);
   let stopping = false;
-  for (const [i, spec] of specs.entries()) {
+  for (const [i, { spec, refresh }] of attempts.entries()) {
     const t0 = Date.now();
     const code = await new Promise((resolve) => {
-      const child = spawn(runner.cmd, serveArgv(runner, spec, port), { stdio: "inherit" });
+      const child = spawn(runner.cmd, serveArgv(runner, spec, port, { refresh }), { stdio: "inherit" });
       // A requested stop (Ctrl-C, `launchctl stop`, `systemctl stop`) must exit 0, or a supervisor with
       // "restart unless it exited successfully" (launchd KeepAlive/SuccessfulExit) would bring it right back.
       const fwd = (sig) => () => { stopping = true; child.kill(sig); };
@@ -184,10 +215,10 @@ export async function serveForeground({ port, version, log = console.error }) {
         resolve(stopping ? 0 : (c ?? (sig ? 130 : 1)));
       });
     });
-    // a pinned version missing on PyPI fails fast; fall back to latest once
+    // a pinned version missing from uv's index fails fast: refresh the index once, then fall back to latest
     if (stopping) return 0;
-    if (code !== 0 && i < specs.length - 1 && Date.now() - t0 < 30000) {
-      log(`${spec} failed, retrying with the latest agentglow ...`);
+    if (code !== 0 && i < attempts.length - 1 && Date.now() - t0 < 30000) {
+      log(`${retryNote(attempts, i, version)} ...`);
       continue;
     }
     return code;

package/cli/lib/settings.mjs

@@ -74,13 +74,13 @@ const shq = (s) => `"${String(s).replace(/(["\\$`])/g, "\\$1")}"`;
  * Shell command for the SessionStart hook that makes sure the local server runs. Prints nothing (SessionStart stdout
  * would land in Claude's context) and always exits 0. Calls the CLI copy in the cache directly (~30 ms) and falls
  * back to the pinned npm version through npx (~0.5 s when cached). Windows without Git Bash runs it in PowerShell,
- * so there it is npx only.
+ * so there it is npx only. `capturePrompts` (setup --capture-prompts) starts the server with AGENTGLOW_CAPTURE_PROMPTS=1.
  */
-export function startHookCommand({ port, version, node, script, cacheDir: dir, platform = process.platform }) {
+export function startHookCommand({ port, version, node, script, cacheDir: dir, capturePrompts = false, platform = process.platform }) {
   const args = `${START_MARK} --port ${port}`;
   const npx = `npx -y agentglow${version ? `@${version}` : ""} ${args}`;
   if (platform === "win32" || !node || !script) return npx;
-  const env = dir ? `AGENTGLOW_CACHE_DIR=${shq(dir)} ` : "";
+  const env = (capturePrompts ? "AGENTGLOW_CAPTURE_PROMPTS=1 " : "") + (dir ? `AGENTGLOW_CACHE_DIR=${shq(dir)} ` : "");
   return `${env}${shq(node)} ${shq(script)} ${args} || ${env}${npx}`;
 }