arp-tui 0.0.9 → 0.0.11

package/dist/index.js

@@ -2229,6 +2229,14 @@ function createStore(opts) {
     pendingAttentionAck = null;
     set({ mode: "attention_level", attentionDraft: "", error: null });
   }
+  function noteHandoffIneligible() {
+    set({ error: "that attention item wasn't raised by an agent" });
+  }
+  function noteHandoffExit(code) {
+    set({ error: code === 0 ? null : `handoff exited with code ${code}` });
+    void refreshChannelAttention();
+    void pollAttention();
+  }
   function beginAttentionAck(all) {
     if (state.attentionBusy) return;
     if (all) pendingAttentionAck = "all";
@@ -2627,6 +2635,7 @@ function createStore(opts) {
     else if (state.connection !== "connected") ws.reconnectNow();
   }
   async function init() {
+    if (initialized) return;
     if (!creds || !creds.token && !clerkSupplier) {
       enterTokenPrompt("no token found \u2014 paste a fresh one to connect");
       return;
@@ -2784,6 +2793,8 @@ function createStore(opts) {
     moveAttentionSelection,
     beginAttentionRaise,
     beginAttentionAck,
+    noteHandoffIneligible,
+    noteHandoffExit,
     setAttentionDraft,
     submitAttentionInput,
     jumpNextActive: () => {
@@ -2796,6 +2807,207 @@ function createStore(opts) {
   };
 }
 
+// src/api/bridgeProcess.ts
+import { spawn as spawn2 } from "child_process";
+var DEFAULT_BRIDGE_CMD = "npx -y @snowyroad/braid";
+var ENROLL_TIMEOUT_MS = 12e4;
+var STATUS_TIMEOUT_MS = 6e4;
+var STDERR_TAIL_CHARS = 600;
+function resolveBridgeCmd(flag, env = process.env) {
+  return flag ?? env["ARP_TUI_BRIDGE_CMD"] ?? DEFAULT_BRIDGE_CMD;
+}
+function splitCmd(cmd) {
+  return cmd.trim().split(/\s+/).filter(Boolean);
+}
+function enrollArgv(bridgeCmd2, opts) {
+  return [
+    ...splitCmd(bridgeCmd2),
+    "enroll",
+    "--invite-stdin",
+    "--json",
+    ...opts?.provider ? ["--provider", opts.provider] : [],
+    ...opts?.model ? ["--model", opts.model] : []
+  ];
+}
+function startArgv(bridgeCmd2, name, provider, model) {
+  return [
+    ...splitCmd(bridgeCmd2),
+    "start",
+    name,
+    ...provider ? ["--provider", provider] : [],
+    ...model ? ["--model", model] : []
+  ];
+}
+function statusArgv(bridgeCmd2) {
+  return [...splitCmd(bridgeCmd2), "status", "--json"];
+}
+function enrollAgent(opts) {
+  const [cmd, ...argv] = enrollArgv(opts.bridgeCmd, { provider: opts.provider, model: opts.model });
+  if (!cmd) {
+    return Promise.resolve({ ok: false, exitCode: null, message: "empty bridge command", stderrTail: "" });
+  }
+  return new Promise((resolve) => {
+    const child = spawn2(cmd, argv, { stdio: ["pipe", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    let settled = false;
+    const timeoutMs = opts.timeoutMs ?? ENROLL_TIMEOUT_MS;
+    const finish = (r) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      resolve(r);
+    };
+    const timer = setTimeout(() => {
+      finish({
+        ok: false,
+        exitCode: null,
+        message: `bridge enrollment timed out after ${Math.round(timeoutMs / 1e3)}s`,
+        stderrTail: tail(stderr)
+      });
+      child.kill("SIGKILL");
+    }, timeoutMs);
+    child.on("error", (err) => {
+      finish({
+        ok: false,
+        exitCode: null,
+        message: `could not run the bridge (${cmd}): ${sanitizeForTty(err.message)}`,
+        stderrTail: ""
+      });
+    });
+    child.stdout.setEncoding("utf8");
+    child.stdout.on("data", (d) => stdout += d);
+    child.stderr.setEncoding("utf8");
+    child.stderr.on("data", (d) => stderr += d);
+    child.stdin.on("error", () => {
+    });
+    child.stdin.write(opts.connectBlob);
+    child.stdin.end();
+    child.on("close", (code) => {
+      if (code !== 0) {
+        finish({
+          ok: false,
+          exitCode: code,
+          message: `bridge enroll exited ${code ?? "on a signal"}`,
+          stderrTail: tail(stderr)
+        });
+        return;
+      }
+      const receipt = parseReceipt(stdout);
+      if (!receipt) {
+        finish({
+          ok: false,
+          exitCode: 0,
+          message: "the bridge exited 0 but printed no parseable enrollment receipt",
+          stderrTail: tail(stderr)
+        });
+        return;
+      }
+      finish({ ok: true, receipt });
+    });
+  });
+}
+function tail(stderr) {
+  return sanitizeForTty(stderr).trim().slice(-STDERR_TAIL_CHARS);
+}
+function parseReceipt(stdout) {
+  const lines = stdout.split("\n").map((l) => l.trim()).filter(Boolean);
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const line = lines[i];
+    if (!line.startsWith("{")) continue;
+    try {
+      const data = JSON.parse(line);
+      if (data && typeof data === "object" && data["ok"] === true && typeof data["agentName"] === "string" && typeof data["agentUuid"] === "string") {
+        return {
+          ok: true,
+          agentName: data["agentName"],
+          agentUuid: data["agentUuid"],
+          relayUrl: typeof data["relayUrl"] === "string" ? data["relayUrl"] : "",
+          keystoreFile: typeof data["keystoreFile"] === "string" ? data["keystoreFile"] : ""
+        };
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function fetchLocalPosture(opts) {
+  const [cmd, ...argv] = statusArgv(opts.bridgeCmd);
+  if (!cmd) return Promise.resolve(null);
+  return new Promise((resolve) => {
+    const child = spawn2(cmd, argv, { stdio: ["pipe", "pipe", "pipe"] });
+    let stdout = "";
+    let settled = false;
+    const finish = (r) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      resolve(r);
+    };
+    const timer = setTimeout(() => {
+      finish(null);
+      child.kill("SIGKILL");
+    }, opts.timeoutMs ?? STATUS_TIMEOUT_MS);
+    child.on("error", () => finish(null));
+    child.stdout.setEncoding("utf8");
+    child.stdout.on("data", (d) => stdout += d);
+    child.stderr.resume();
+    child.stdin.on("error", () => {
+    });
+    child.stdin.end();
+    child.on("close", (code) => {
+      if (code !== 0) {
+        finish(null);
+        return;
+      }
+      const agents = parseStatusAgents(stdout);
+      finish(agents?.find((a) => a.name === opts.agentName) ?? null);
+    });
+  });
+}
+function parseStatusAgents(stdout) {
+  const lines = stdout.split("\n").map((l) => l.trim()).filter(Boolean);
+  for (let i = lines.length - 1; i >= 0; i--) {
+    if (!lines[i].startsWith("{")) continue;
+    for (const candidate of [lines[i], lines.slice(i).join("\n")]) {
+      try {
+        const data = JSON.parse(candidate);
+        if (data && typeof data === "object" && Array.isArray(data.agents)) {
+          return data.agents.filter(
+            (a) => !!a && typeof a === "object" && typeof a.name === "string"
+          );
+        }
+      } catch {
+      }
+    }
+  }
+  return null;
+}
+function startAgentProcess(opts) {
+  const [cmd, ...argv] = startArgv(opts.bridgeCmd, opts.name, opts.provider, opts.model);
+  if (!cmd) return Promise.resolve(1);
+  return new Promise((resolve) => {
+    const child = spawn2(cmd, argv, { stdio: "inherit" });
+    child.on("error", () => resolve(1));
+    child.on("close", (code) => resolve(code ?? 1));
+  });
+}
+function handoffArgv(bridgeCmd2, agent, channelId) {
+  return [...splitCmd(bridgeCmd2), "handoff", agent, "--channel", channelId];
+}
+function runHandoffProcess(opts) {
+  const [cmd, ...argv] = handoffArgv(opts.bridgeCmd, opts.agent, opts.channelId);
+  if (!cmd) return Promise.resolve(1);
+  return new Promise((resolve) => {
+    const child = spawn2(cmd, argv, { stdio: "inherit" });
+    child.on("error", () => resolve(1));
+    child.on("close", (code) => resolve(code ?? 1));
+  });
+}
+function handoffTarget(item) {
+  return item?.raisedByType === "bot" && item.raisedBy ? item.raisedBy : null;
+}
+
 // src/ui/ActivityLine.tsx
 import { Text } from "ink";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -2958,7 +3170,7 @@ function AttentionPanel({
       ": ",
       sanitizeForTty(draft),
       "\u258C"
-    ] }) : /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: busy ? "working\u2026" : "j/k select \xB7 r raise \xB7 x ack selected \xB7 X ack all \xB7 Esc close" })
+    ] }) : /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: busy ? "working\u2026" : "j/k select \xB7 r raise \xB7 x ack selected \xB7 X ack all \xB7 h take over agent \xB7 Esc close" })
   ] });
 }
 
@@ -3365,7 +3577,7 @@ var ACTIVITY_SETTLE_MS2 = 4e3;
 function cleanInput(input) {
   return input.replace(/\r\n|[\r\n]/g, " ").replace(/[\x00-\x1f\x7f]/g, "");
 }
-function App({ store: store2 }) {
+function App({ store: store2, onHandoff: onHandoff2 }) {
   const { exit } = useApp();
   const { isRawModeSupported } = useStdin();
   const interactive = isRawModeSupported === true;
@@ -3421,6 +3633,12 @@ function App({ store: store2 }) {
         else if (input === "r") store2.beginAttentionRaise();
         else if (input === "x") store2.beginAttentionAck(false);
         else if (input === "X") store2.beginAttentionAck(true);
+        else if (input === "h") {
+          const item = s.channelAttention[s.attentionSelected];
+          const agent = handoffTarget(item);
+          if (!agent || !item) store2.noteHandoffIneligible();
+          else onHandoff2(agent, item.channelId);
+        }
         return;
       }
       if (s.mode === "switcher") {
@@ -3615,192 +3833,6 @@ unknown profile command "${args2.sub}".`);
   }
 }
 
-// src/api/bridgeProcess.ts
-import { spawn as spawn2 } from "child_process";
-var DEFAULT_BRIDGE_CMD = "npx -y @snowyroad/braid";
-var ENROLL_TIMEOUT_MS = 12e4;
-var STATUS_TIMEOUT_MS = 6e4;
-var STDERR_TAIL_CHARS = 600;
-function resolveBridgeCmd(flag, env = process.env) {
-  return flag ?? env["ARP_TUI_BRIDGE_CMD"] ?? DEFAULT_BRIDGE_CMD;
-}
-function splitCmd(cmd) {
-  return cmd.trim().split(/\s+/).filter(Boolean);
-}
-function enrollArgv(bridgeCmd, opts) {
-  return [
-    ...splitCmd(bridgeCmd),
-    "enroll",
-    "--invite-stdin",
-    "--json",
-    ...opts?.provider ? ["--provider", opts.provider] : [],
-    ...opts?.model ? ["--model", opts.model] : []
-  ];
-}
-function startArgv(bridgeCmd, name, provider, model) {
-  return [
-    ...splitCmd(bridgeCmd),
-    "start",
-    name,
-    ...provider ? ["--provider", provider] : [],
-    ...model ? ["--model", model] : []
-  ];
-}
-function statusArgv(bridgeCmd) {
-  return [...splitCmd(bridgeCmd), "status", "--json"];
-}
-function enrollAgent(opts) {
-  const [cmd, ...argv] = enrollArgv(opts.bridgeCmd, { provider: opts.provider, model: opts.model });
-  if (!cmd) {
-    return Promise.resolve({ ok: false, exitCode: null, message: "empty bridge command", stderrTail: "" });
-  }
-  return new Promise((resolve) => {
-    const child = spawn2(cmd, argv, { stdio: ["pipe", "pipe", "pipe"] });
-    let stdout = "";
-    let stderr = "";
-    let settled = false;
-    const timeoutMs = opts.timeoutMs ?? ENROLL_TIMEOUT_MS;
-    const finish = (r) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      resolve(r);
-    };
-    const timer = setTimeout(() => {
-      finish({
-        ok: false,
-        exitCode: null,
-        message: `bridge enrollment timed out after ${Math.round(timeoutMs / 1e3)}s`,
-        stderrTail: tail(stderr)
-      });
-      child.kill("SIGKILL");
-    }, timeoutMs);
-    child.on("error", (err) => {
-      finish({
-        ok: false,
-        exitCode: null,
-        message: `could not run the bridge (${cmd}): ${sanitizeForTty(err.message)}`,
-        stderrTail: ""
-      });
-    });
-    child.stdout.setEncoding("utf8");
-    child.stdout.on("data", (d) => stdout += d);
-    child.stderr.setEncoding("utf8");
-    child.stderr.on("data", (d) => stderr += d);
-    child.stdin.on("error", () => {
-    });
-    child.stdin.write(opts.connectBlob);
-    child.stdin.end();
-    child.on("close", (code) => {
-      if (code !== 0) {
-        finish({
-          ok: false,
-          exitCode: code,
-          message: `bridge enroll exited ${code ?? "on a signal"}`,
-          stderrTail: tail(stderr)
-        });
-        return;
-      }
-      const receipt = parseReceipt(stdout);
-      if (!receipt) {
-        finish({
-          ok: false,
-          exitCode: 0,
-          message: "the bridge exited 0 but printed no parseable enrollment receipt",
-          stderrTail: tail(stderr)
-        });
-        return;
-      }
-      finish({ ok: true, receipt });
-    });
-  });
-}
-function tail(stderr) {
-  return sanitizeForTty(stderr).trim().slice(-STDERR_TAIL_CHARS);
-}
-function parseReceipt(stdout) {
-  const lines = stdout.split("\n").map((l) => l.trim()).filter(Boolean);
-  for (let i = lines.length - 1; i >= 0; i--) {
-    const line = lines[i];
-    if (!line.startsWith("{")) continue;
-    try {
-      const data = JSON.parse(line);
-      if (data && typeof data === "object" && data["ok"] === true && typeof data["agentName"] === "string" && typeof data["agentUuid"] === "string") {
-        return {
-          ok: true,
-          agentName: data["agentName"],
-          agentUuid: data["agentUuid"],
-          relayUrl: typeof data["relayUrl"] === "string" ? data["relayUrl"] : "",
-          keystoreFile: typeof data["keystoreFile"] === "string" ? data["keystoreFile"] : ""
-        };
-      }
-    } catch {
-    }
-  }
-  return null;
-}
-function fetchLocalPosture(opts) {
-  const [cmd, ...argv] = statusArgv(opts.bridgeCmd);
-  if (!cmd) return Promise.resolve(null);
-  return new Promise((resolve) => {
-    const child = spawn2(cmd, argv, { stdio: ["pipe", "pipe", "pipe"] });
-    let stdout = "";
-    let settled = false;
-    const finish = (r) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      resolve(r);
-    };
-    const timer = setTimeout(() => {
-      finish(null);
-      child.kill("SIGKILL");
-    }, opts.timeoutMs ?? STATUS_TIMEOUT_MS);
-    child.on("error", () => finish(null));
-    child.stdout.setEncoding("utf8");
-    child.stdout.on("data", (d) => stdout += d);
-    child.stderr.resume();
-    child.stdin.on("error", () => {
-    });
-    child.stdin.end();
-    child.on("close", (code) => {
-      if (code !== 0) {
-        finish(null);
-        return;
-      }
-      const agents = parseStatusAgents(stdout);
-      finish(agents?.find((a) => a.name === opts.agentName) ?? null);
-    });
-  });
-}
-function parseStatusAgents(stdout) {
-  const lines = stdout.split("\n").map((l) => l.trim()).filter(Boolean);
-  for (let i = lines.length - 1; i >= 0; i--) {
-    if (!lines[i].startsWith("{")) continue;
-    for (const candidate of [lines[i], lines.slice(i).join("\n")]) {
-      try {
-        const data = JSON.parse(candidate);
-        if (data && typeof data === "object" && Array.isArray(data.agents)) {
-          return data.agents.filter(
-            (a) => !!a && typeof a === "object" && typeof a.name === "string"
-          );
-        }
-      } catch {
-      }
-    }
-  }
-  return null;
-}
-function startAgentProcess(opts) {
-  const [cmd, ...argv] = startArgv(opts.bridgeCmd, opts.name, opts.provider, opts.model);
-  if (!cmd) return Promise.resolve(1);
-  return new Promise((resolve) => {
-    const child = spawn2(cmd, argv, { stdio: "inherit" });
-    child.on("error", () => resolve(1));
-    child.on("close", (code) => resolve(code ?? 1));
-  });
-}
-
 // src/commands/agent.ts
 import readline from "readline/promises";
 var AGENT_USAGE = `usage: braid agent <add|status|reissue|revoke|remove> <name> [options]
@@ -3821,7 +3853,10 @@ var AGENT_USAGE = `usage: braid agent <add|status|reissue|revoke|remove> <name>
                       also ARP_TUI_BRIDGE_CMD env)
   --yes               skip the confirmation prompt (required with --json on
                       revoke/remove)
-  --json              machine-readable result on stdout`;
+  --json              machine-readable result on stdout
+
+  deeper per-agent knobs (--tools, --auth, --scope, --fallback-model, sandbox
+  widenings, \u2026) belong to the bridge \u2014 see: ${DEFAULT_BRIDGE_CMD} --help`;
 async function promptOnTty(question) {
   if (!process.stdin.isTTY || !process.stderr.isTTY) return null;
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
@@ -3995,7 +4030,7 @@ async function enrollAndMaybeStart(args2, deps, opts) {
 async function runAgentAdd(instance2, args2, deps) {
   const name = requireName2(args2, deps);
   if (!name) return 1;
-  const bridgeCmd = resolveBridgeCmd(args2.bridgeCmd, deps.env);
+  const bridgeCmd2 = resolveBridgeCmd(args2.bridgeCmd, deps.env);
   const creds = await ensureSignedIn(deps);
   const rest = oneShotRest(instance2, creds);
   let invite;
@@ -4009,7 +4044,7 @@ async function runAgentAdd(instance2, args2, deps) {
   }
   deps.err(`\u2713 ${sanitizeLabel(name)} created on Braid \u2014 enrolling on this machine\u2026`);
   return enrollAndMaybeStart(args2, deps, {
-    bridgeCmd,
+    bridgeCmd: bridgeCmd2,
     connectBlob: invite.connectBlob,
     successLine: (n) => `\u2714 ${n} is enrolled with Braid`
   });
@@ -4066,7 +4101,7 @@ async function runAgentStatus(instance2, args2, deps) {
 async function runAgentReissue(instance2, args2, deps) {
   const name = requireName2(args2, deps);
   if (!name) return 1;
-  const bridgeCmd = resolveBridgeCmd(args2.bridgeCmd, deps.env);
+  const bridgeCmd2 = resolveBridgeCmd(args2.bridgeCmd, deps.env);
   const creds = await ensureSignedIn(deps);
   const rest = oneShotRest(instance2, creds);
   const agent = await findMyAgent(rest, name, args2, deps);
@@ -4082,7 +4117,7 @@ async function runAgentReissue(instance2, args2, deps) {
   }
   deps.err(`\u2713 fresh credential minted \u2014 re-enrolling ${sanitizeLabel(name)} on this machine\u2026`);
   return enrollAndMaybeStart(args2, deps, {
-    bridgeCmd,
+    bridgeCmd: bridgeCmd2,
     connectBlob: invite.connectBlob,
     successLine: (n) => `\u2714 ${n} reconnected to Braid`
   });
@@ -5142,4 +5177,13 @@ if (credentials?.tokenType === "dev-jwt" && credentials.token && !credentials.cl
   );
 }
 var store = createStore({ instance, credentials });
-render(/* @__PURE__ */ jsx13(App, { store }));
+var bridgeCmd = resolveBridgeCmd(args.bridgeCmd, process.env);
+var onHandoff = (agent, channelId) => {
+  void (async () => {
+    inkInstance.unmount();
+    const code = await runHandoffProcess({ bridgeCmd, agent, channelId });
+    store.noteHandoffExit(code);
+    inkInstance = render(/* @__PURE__ */ jsx13(App, { store, onHandoff }));
+  })();
+};
+var inkInstance = render(/* @__PURE__ */ jsx13(App, { store, onHandoff }));

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "arp-tui",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "arp-tui",
-      "version": "0.0.9",
+      "version": "0.0.11",
       "license": "SEE LICENSE IN LICENSE.md",
       "dependencies": {
         "ink": "^5.2.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arp-tui",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "Human-facing terminal client for Agent Relay Protocol. Tail channels and post messages from your terminal.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "SnowyRoad",