@bivy/bivy 0.10.1-staging.284 → 0.10.1-staging.286

package/bin/bivy.mjs

@@ -922,9 +922,10 @@ async function resolveRunSpec(agentId, extraArgs) {
   return { spec: { agent: id, label: agent.label, command, args: [...(agent.args ?? []), ...extraArgs] } };
 }
 
-// Pull bivy's own `--name`/`--model` flags (space or `=` form) out of the run
-// args so they aren't blindly forwarded. Only honored before a `--` separator,
-// past which everything is the raw command the user asked to run.
+// Pull bivy's own run flags out of the args so they aren't blindly forwarded.
+// Only honored before a `--` separator, past which everything is the raw command
+// the user asked to run. `--chat` selects the governed app-session path instead
+// of the native PTY path; `--no-open` keeps that path headless after creation.
 // Does a token look like a git remote (URL, scp-style, owner/repo, or a path)
 // rather than an agent id? Lets `--clone <remote>` disambiguate from bare
 // `--clone` (= current folder's repo) without a required `=`.
@@ -936,10 +937,14 @@ function looksLikeRemote(value) {
 function extractRunFlags(args) {
   const rest = [];
   let name, model, node, workspace;
+  let chat = false;
+  let noOpen = false;
   let clone; // undefined = no clone; true = current repo; string = explicit remote
   for (let i = 0; i < args.length; i++) {
     const a = args[i];
     if (a === "--") { rest.push(...args.slice(i)); break; }
+    if (a === "--chat") { chat = true; continue; }
+    if (a === "--no-open") { noOpen = true; continue; }
     if (a === "--name" && args[i + 1] !== undefined) { name = args[++i]; continue; }
     if (a.startsWith("--name=")) { name = a.slice("--name=".length); continue; }
     if (a === "--model" && args[i + 1] !== undefined) { model = args[++i]; continue; }
@@ -952,7 +957,7 @@ function extractRunFlags(args) {
     if (a === "--clone") { clone = looksLikeRemote(args[i + 1]) ? args[++i] : true; continue; }
     rest.push(a);
   }
-  return { name: name?.trim() || undefined, model: model?.trim() || undefined, node: node?.trim() || undefined, workspace: workspace?.trim() || undefined, clone, rest };
+  return { name: name?.trim() || undefined, model: model?.trim() || undefined, node: node?.trim() || undefined, workspace: workspace?.trim() || undefined, chat, noOpen, clone, rest };
 }
 
 // A safe-ish workspace dir name from a remote or path (basename minus .git).
@@ -1730,7 +1735,7 @@ async function cmdExec(args = []) {
 function cmdCompletions(args = []) {
   const shell = (args[0] || "").toLowerCase();
   const commands = [
-    "run", "sessions", "ls", "resume", "promote", "rename", "nodes", "agent", "agents", "agents:install", "shim", "takeover", "token", "exec",
+    "run", "runs", "sessions", "ls", "resume", "promote", "rename", "nodes", "agent", "agents", "agents:install", "shim", "takeover", "token", "exec",
     "send", "attach", "kill", "setup", "start", "stop", "restart", "status", "doctor", "diagnostics", "logs", "login",
     "update", "update:log", "audit", "automation", "config", "plugin", "open", "service", "secrets", "voice", "link", "relay:setup",
     "github:connect", "github:app-create", "github:app-connect", "github:app-sync", "prune", "uninstall", "help", "version",
@@ -1793,12 +1798,67 @@ complete -c bivy -n '__fish_seen_subcommand_from run' -a '${agents.join(" ")}'`)
 // flag on top of it.
 async function cmdRun(args = []) {
   if (!(await ensureDeps())) process.exit(1);
-  const { name, model, node, workspace, clone, rest } = extractRunFlags(args);
+  const { name, model, node, workspace, chat, noOpen, clone, rest } = extractRunFlags(args);
   // Bare `bivy` (empty rest) resolves to the configured default agent; an
   // explicit `bivy run <agent>` keeps that agent verbatim.
   const [agentIdArg, ...extraArgs] = rest;
   const agentId = agentIdArg || resolveDefaultAgent();
 
+  if (chat) {
+    if (node) {
+      console.error(c.red("--chat currently starts a governed session on this node; it can't be combined with --node."));
+      process.exit(1);
+      return;
+    }
+    if (agentId === "--" || extraArgs.length) {
+      console.error(c.red("--chat starts a governed agent integration and does not accept native agent arguments or the raw '-- <command>' form."));
+      process.exit(1);
+      return;
+    }
+    let requestedWorkspace;
+    try { requestedWorkspace = resolveWorkspaceDir({ clone, workspace }); }
+    catch (error) { console.error(c.red(error?.message || String(error))); process.exit(1); return; }
+    const config = loadConfig();
+    // Preserve `bivy run`'s cwd contract: from inside a git checkout, a chat run
+    // targets that checkout; elsewhere it uses the node's configured workspace.
+    const sessionWorkspace = requestedWorkspace || defaultRunWorkspace(config);
+    if (!(await ensureNodeRunning(config))) {
+      console.error(c.red(`Could not start the Bivy node at ${url(config)}.`));
+      process.exit(1);
+      return;
+    }
+    try {
+      const created = await localApi(config, "/api/session", {
+        method: "POST",
+        body: JSON.stringify({ agent: agentId, ...(model ? { model: { provider: "", id: model } } : {}), ...(sessionWorkspace ? { workspace: sessionWorkspace } : {}) }),
+      });
+      if (name) {
+        await localApi(config, "/api/sessions/rename", {
+          method: "POST",
+          body: JSON.stringify({ sessionId: created.id, name }),
+        });
+      }
+      const sessionPath = `/sessions/${encodeURIComponent(created.id)}`;
+      const remote = await openRemoteApp({ open: !noOpen, remotePath: sessionPath });
+      console.log(c.green(`Started chat session ${created.id} (${created.agentName || created.runtimeId || agentId}).`));
+      if (remote && (noOpen || !canOpenBrowser())) console.log(`Open it in the Bivy app: ${c.cyan(remote.openUrl)}`);
+      else if (!remote) {
+        console.log(c.yellow("Remote app access is not configured on this node."));
+        console.log(`Run ${c.cyan("bivy relay:setup")}, then open session ${c.cyan(created.id)} in the app.`);
+      }
+      return;
+    } catch (error) {
+      console.error(c.red(`Could not start chat session: ${error?.message || String(error)}`));
+      process.exit(1);
+      return;
+    }
+  }
+  if (noOpen) {
+    console.error(c.red("--no-open is only valid together with --chat."));
+    process.exit(1);
+    return;
+  }
+
   // A cloned/explicit workspace lives on THIS machine, so it only applies to the
   // local node. For a remote --node run the checkout would need to be made there.
   if (node && (clone !== undefined || workspace)) {
@@ -4518,7 +4578,8 @@ ${c.bold("bivy")} — Bivy node CLI
   ${c.cyan("bivy send <id>")} "..."  Send a prompt to an existing session and stream the reply
   ${c.cyan("bivy kill <id>")}    Stop a session/terminal (--delete also removes a saved session)
   ${c.cyan("bivy prune")}         Delete old sessions/workspaces/worktrees (--keep N, --older-than 7d, --dry-run)
-  ${c.cyan("bivy exec")} "<prompt>"  One-shot headless run: prints the answer to stdout (pipe-friendly)
+  ${c.cyan("bivy exec")} "<prompt>"  One-shot headless session: prints the answer to stdout (pipe-friendly)
+  ${c.cyan("bivy runs start")} "<instructions>"  Queue a one-off unattended Run with checks and a Receipt
   ${c.cyan("bivy automation")}  list | trigger | init | validate | plan | test | apply
   ${c.cyan("bivy config")}      init | validate | show | get | set | explain (typed node config)
   ${c.cyan("bivy plugin")}      init | validate | doctor | test | install | list | remove
@@ -4573,9 +4634,10 @@ async function main() {
       // args (including its own --help) pass straight through to it — e.g.
       // 'bivy run claude --help' must show Claude's help, not bivy's.
       if (args[0] === "-h" || args[0] === "--help") {
-        console.log(`Usage: bivy run <agent> [--name <label>] [--model <model>] [--node <name>] [--clone [remote]] [--workspace <dir>] | -- <command>
+        console.log(`Usage: bivy run <agent> [--chat [--no-open]] [--name <label>] [--model <model>] [--node <name>] [--clone [remote]] [--workspace <dir>] | -- <command>
 
 Run a native agent (real CLI/TUI) as a relay-visible session.
+Use --chat to start the governed session used by the app instead; --no-open prints its URL without launching a browser.
 Agents: ${[...AGENT_INTEGRATIONS.keys()].join(", ")}, or -- <command> for anything else.
 An agent's own --help passes through, e.g. 'bivy run claude --help'.`);
         break;
@@ -4637,6 +4699,17 @@ An agent's own --help passes through, e.g. 'bivy run claude --help'.`);
     case "completion":
       cmdCompletions(args);
       break;
+    case "runs": {
+      if (!(await ensureDeps())) process.exit(1);
+      const [action, ...runArgs] = args;
+      if (!action || ["-h", "--help", "help"].includes(action)) {
+        console.log('Usage: bivy runs start "<instructions>" [--name <title>] [--repo <owner/name>] [--agent <id>] [--model <id>] [--approval <mode>] [--sandbox <tier>] [--max-attempts <n>] [--json]\n\nStart a one-off unattended Run. Unlike `bivy run`, this queues governed background work with checks, evidence, and a Receipt.');
+        break;
+      }
+      if (action !== "start" && action !== "create") { console.error(c.red(`Unknown runs action: ${action}`)); process.exit(1); break; }
+      process.exit(await run(nodeBin, [...nodeScriptArgs(automationEntry), "start-run", ...runArgs], { cwd: process.cwd(), env: process.env }));
+      break;
+    }
     case "automation":
     case "automations": {
       if (!(await ensureDeps())) process.exit(1);

package/dist/automation-cli.js

@@ -30,6 +30,11 @@ Commands:
   test [path] --event <file>  Simulate an event and explain the first match
   apply [path] [--prune]      Encrypt instructions and reconcile the control plane
 
+One-off Run flags (used by 'bivy runs start'):
+  --name <title>  --repo <owner/name>  --agent <id>  --model <id>
+  --approval <mode>  --sandbox <tier>  --max-attempts <1-10>  --json
+  Pass '-' as the instructions to read them from stdin.
+
 Default path: ${DEFAULT_AUTOMATION_CONFIG_PATH}
 List, trigger, and apply require an enrolled node ('bivy setup'). Instructions
 are encrypted on this machine before upload; the control plane receives
@@ -175,6 +180,57 @@ async function main() {
         }
         return;
     }
+    if (command === "start-run") {
+        if (args.includes("-h") || args.includes("--help"))
+            usage();
+        const valuedFlags = new Set(["--name", "--repo", "--agent", "--model", "--approval", "--sandbox", "--max-attempts"]);
+        const positional = [];
+        for (let i = 0; i < args.length; i += 1) {
+            const arg = args[i];
+            if (valuedFlags.has(arg)) {
+                i += 1;
+                continue;
+            }
+            if (arg.startsWith("--") && arg.includes("="))
+                continue;
+            if (arg === "--json")
+                continue;
+            positional.push(arg);
+        }
+        let instructions = positional.join(" ").trim();
+        if (instructions === "-")
+            instructions = fs.readFileSync(0, "utf8").trim();
+        if (!instructions)
+            throw new Error("instructions are required (or pass '-' to read stdin)");
+        const appDir = appDataDir();
+        const relay = relayConfig(appDir);
+        const identity = NodeIdentity.load(appDir);
+        const pairing = PairingStore.load(appDir, relay.e2eKey);
+        const approvalMode = value(args, "--approval") ?? "risky";
+        const sandbox = value(args, "--sandbox") ?? "workspace-write";
+        const maxAttempts = Number(value(args, "--max-attempts") ?? 2);
+        const title = (value(args, "--name") ?? instructions.split(/\r?\n/, 1)[0] ?? "One-off Run").slice(0, 120);
+        const created = await request(relay, "/node/automation-runs", {
+            method: "POST",
+            body: JSON.stringify({
+                title,
+                body: `bivy-room-v1:${identity.nodeId}:${seal(pairing.roomKey(), instructions)}`,
+                repo: value(args, "--repo"),
+                runtimeId: value(args, "--agent"),
+                model: value(args, "--model"),
+                approvalMode,
+                sandbox,
+                maxAttempts,
+            }),
+        });
+        if (args.includes("--json"))
+            console.log(JSON.stringify(created, null, 2));
+        else {
+            console.log(`Queued Run ${created.id} on ${identity.name}.`);
+            console.log(`Status: ${created.status}`);
+        }
+        return;
+    }
     if (command === "init") {
         const file = configPath(args);
         if (fs.existsSync(file) && !args.includes("--force"))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bivy/bivy",
-  "version": "0.10.1-staging.284",
+  "version": "0.10.1-staging.286",
   "type": "module",
   "license": "AGPL-3.0-only",
   "description": "Run coding agents on machines you own. Open-source, self-hostable agent workspace.",