@bivy/bivy 0.16.14-staging.1 → 0.16.14-staging.2

package/bin/bivy.mjs

@@ -5040,7 +5040,7 @@ ${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 session: prints the answer to stdout (pipe-friendly)
+  ${c.cyan("bivy exec")} "<prompt>"  One-shot headless session: prints the answer to stdout (pipe-friendly; --agent/--model/--name/--workspace/--session/--json)
   ${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)

package/dist/exec.js

@@ -7,15 +7,23 @@
 //
 //   bivy exec "summarize README.md"
 //   bivy exec --agent claude "what does src/server.ts do?"
+//   bivy exec --workspace /path/to/repo --name "nightly audit" "…"
 //   bivy exec --session <ref> "and now add a test"      # continue a session
 //   echo "explain this" | bivy exec -                    # prompt from stdin
+//
+// A turn that ends without any assistant text because the agent FAILED (e.g. an
+// unauthenticated CLI) exits non-zero with the error on stderr, rather than
+// reporting a silent empty success.
 import { WebSocket } from "ws";
 const err = (s) => process.stderr.write(s);
 function parseArgs(argv) {
     let url = process.env.BIVY_URL || `http://localhost:${process.env.PORT || "4317"}`;
     let token = process.env.BIVY_DEVICE_TOKEN || undefined;
     let agent;
+    let model;
     let session;
+    let name;
+    let workspace;
     let json = false;
     let timeoutMs = Number(process.env.BIVY_EXEC_TIMEOUT_MS) || 10 * 60 * 1000;
     const prompt = [];
@@ -33,10 +41,22 @@ function parseArgs(argv) {
             agent = argv[++i];
         else if (arg.startsWith("--agent="))
             agent = arg.slice("--agent=".length);
+        else if ((arg === "-m" || arg === "--model") && argv[i + 1])
+            model = argv[++i];
+        else if (arg.startsWith("--model="))
+            model = arg.slice("--model=".length);
         else if (arg === "--session" && argv[i + 1])
             session = argv[++i];
         else if (arg.startsWith("--session="))
             session = arg.slice("--session=".length);
+        else if ((arg === "-n" || arg === "--name") && argv[i + 1])
+            name = argv[++i];
+        else if (arg.startsWith("--name="))
+            name = arg.slice("--name=".length);
+        else if ((arg === "-w" || arg === "--workspace") && argv[i + 1])
+            workspace = argv[++i];
+        else if (arg.startsWith("--workspace="))
+            workspace = arg.slice("--workspace=".length);
         else if (arg === "--json")
             json = true;
         else if (arg === "--timeout" && argv[i + 1])
@@ -44,7 +64,7 @@ function parseArgs(argv) {
         else
             prompt.push(arg);
     }
-    return { url: url.replace(/\/+$/, ""), token, agent, session, prompt: prompt.join(" "), json, timeoutMs };
+    return { url: url.replace(/\/+$/, ""), token, agent, model, session, name, workspace, prompt: prompt.join(" "), json, timeoutMs };
 }
 function authHeaders(token) {
     return { "content-type": "application/json", ...(token ? { authorization: `Bearer ${token}` } : {}) };
@@ -116,7 +136,17 @@ async function main() {
         else {
             const created = await api(args.url, args.token, "/api/session", {
                 method: "POST",
-                body: JSON.stringify(args.agent ? { agent: args.agent } : {}),
+                body: JSON.stringify({
+                    ...(args.agent ? { agent: args.agent } : {}),
+                    // Mirror the `bivy-model:` directive path: an empty provider lets the
+                    // server resolve the id against the session's catalog (the same
+                    // setModel("", id) form). Passing the id verbatim keeps ids that embed
+                    // a provider slash (e.g. `opencode/gpt-5.6-sol`) intact.
+                    ...(args.model ? { model: { provider: "", id: args.model } } : {}),
+                    // Explicit, user-chosen name (kept verbatim; suppresses auto-naming).
+                    ...(args.name ? { name: args.name } : {}),
+                    ...(args.workspace ? { workspace: args.workspace } : {}),
+                }),
             });
             sessionId = created.id;
         }
@@ -130,6 +160,9 @@ async function main() {
     const socket = new WebSocket(wsUrl(args.url, args.token));
     let answer = "";
     let settled = false;
+    // Last stderr the agent surfaced (auth failures, crashes). Carried so a turn
+    // that ends with no assistant text can explain WHY instead of printing empty.
+    let lastStderr = "";
     const finish = (code, errorText) => {
         if (settled)
             return;
@@ -192,9 +225,28 @@ async function main() {
                 if (text)
                     answer = text; // events carry the full message text so far
             }
+            else if (ev.type === "tool_execution_update" && ev.toolName === "agent_output") {
+                const input = (ev.input || {});
+                if (input.stream === "stderr" && typeof input.output === "string" && input.output.trim()) {
+                    lastStderr = input.output.trim();
+                }
+            }
             else if (ev.type === "agent_end") {
                 clearTimeout(timer);
-                finish(0);
+                // A turn can end without any assistant text because the agent FAILED
+                // (e.g. an unauthenticated CLI that printed to stderr and exited
+                // non-zero). Printing an empty answer with exit 0 would report a silent
+                // false success to a script. Surface the failure instead: prefer an
+                // explicit error string, then the last stderr line, then the exit code.
+                const errText = typeof ev.error === "string" && ev.error.trim() ? ev.error.trim() : undefined;
+                const code = typeof ev.code === "number" ? ev.code : undefined;
+                const failed = !!errText || (code !== undefined && code !== 0);
+                if (!answer.trim() && failed) {
+                    finish(1, errText || lastStderr || `The agent produced no output (exit code ${code ?? "unknown"}).`);
+                }
+                else {
+                    finish(0);
+                }
             }
         }
         else if (type === "session.error") {

package/dist/server.js

@@ -8372,10 +8372,7 @@ async function createWorkspaceSession(workspace, opts = {}) {
         return createGitWorkspaceSession(workspace, parsed, opts);
     }
     const record = await createSession(workspace, undefined, { runtimeId: opts.runtimeId, sandbox: opts.sandbox, makeActive: opts.makeActive });
-    if (opts.title) {
-        record.session.setName(`Session ${record.id.slice(0, 8)}`);
-        persistSessionMetadata(record);
-    }
+    applyInitialSessionName(record, opts);
     return record;
 }
 async function createGitWorkspaceSession(repoDir, parsed, opts = {}) {
@@ -8395,11 +8392,26 @@ async function createGitWorkspaceSession(repoDir, parsed, opts = {}) {
         sandbox: opts.sandbox,
         makeActive: opts.makeActive,
     });
+    applyInitialSessionName(record, opts);
+    return record;
+}
+/**
+ * Set a freshly created session's name before its first turn. An explicit,
+ * user-chosen name (`opts.explicitName`) is kept verbatim so the first-turn
+ * auto-namer leaves it alone; otherwise a raw first message (`opts.title`) only
+ * pins a placeholder so that auto-namer can refine it from the message.
+ */
+function applyInitialSessionName(record, opts) {
+    const explicit = opts.explicitName?.trim();
+    if (explicit) {
+        record.session.setName(explicit);
+        persistSessionMetadata(record);
+        return;
+    }
     if (opts.title) {
         record.session.setName(`Session ${record.id.slice(0, 8)}`);
         persistSessionMetadata(record);
     }
-    return record;
 }
 /**
  * Resolve the GitHub repo a session's worktree branch belongs to, for both
@@ -10069,6 +10081,9 @@ app.post("/api/session", async (req, res, next) => {
         // relay `session.new` repo path. Takes precedence over a manual workspace path.
         const repoInput = typeof req.body?.repo === "string" ? req.body.repo.trim() : "";
         const title = typeof req.body?.title === "string" ? req.body.title : undefined;
+        // An explicit, user-chosen session name (e.g. `bivy exec --name`). Kept
+        // verbatim, unlike `title` (a raw first message that only seeds auto-naming).
+        const explicitName = typeof req.body?.name === "string" && req.body.name.trim() ? req.body.name.trim() : undefined;
         const requestId = typeof req.body?.requestId === "string" ? req.body.requestId : undefined;
         // Validate the workspace before entering the dedupe path so a bad path still
         // returns a 400 (rather than being cached as a rejected creation).
@@ -10108,8 +10123,8 @@ app.post("/api/session", async (req, res, next) => {
             // session this request already created rather than spawning a duplicate.
             session = await dedupeSessionNew(requestId, async () => {
                 const rec = parsed
-                    ? await createRepoSession(parsed, { title, runtimeId: agentFrom(req.body ?? {}), branch: branchFrom(req.body ?? {}) })
-                    : await createWorkspaceSession(workspace, { title, runtimeId: agentFrom(req.body ?? {}), branch: branchFrom(req.body ?? {}) });
+                    ? await createRepoSession(parsed, { title, explicitName, runtimeId: agentFrom(req.body ?? {}), branch: branchFrom(req.body ?? {}) })
+                    : await createWorkspaceSession(workspace, { title, explicitName, runtimeId: agentFrom(req.body ?? {}), branch: branchFrom(req.body ?? {}) });
                 // Bind the composer's chosen model to the new session before its first turn.
                 await applyRequestedModel(rec, modelFrom(req.body ?? {}));
                 return rec;

package/package.json

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