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

package/bin/bivy.mjs

@@ -1735,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",
@@ -4578,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
@@ -4698,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.285",
+  "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.",