starbridge 0.1.3 → 0.1.4-rc.3

package/README.md

@@ -72,7 +72,7 @@ question; steps 1 and 3 say when it asks more. A rerun repairs only what is miss
 4. It installs and starts the background service, `starbridge agent`, as a systemd user unit, a
    launchd agent, or on Windows a Scheduled Task that starts at logon without administrator
    rights and logs to `%LOCALAPPDATA%\starbridge\agent.log`.
-5. It uploads a first quota snapshot, then offers to send a test question to your phone and
+5. It uploads a first quota snapshot, then offers to send a test question to your devices and
    prints your answer.
 
 [Permission prompts](#permission-prompts) stay in the terminal unless you turn them on with
@@ -110,7 +110,9 @@ and asks your devices to revoke the machine. It deletes the keys only when you s
 ### Check a download
 
 The scripts and `starbridge update` install a binary only if its hash is in the release's
-`SHA256SUMS` and the release key signed `SHA256SUMS.minisig`. `install.ps1` checks the signature
+`SHA256SUMS` and the release key signed `SHA256SUMS.minisig`. `install.sh` checks the signature
+with minisign, else OpenSSL 3, else Python 3, which every RHEL 8 has for dnf; with none of them it
+stops and gives the command that installs minisign. `install.ps1` checks the signature
 with minisign's own Windows build, pinned by its hash, since Windows has no Ed25519 check. The key is also in
 [`minisign.pub`](minisign.pub):
 
@@ -170,10 +172,10 @@ starbridge ask --question "Merge #12 now?" \
 - Anywhere else, the agent waits for it with `starbridge wait <id> --timeout 5m`, which exits
   with code 2 when the time runs out.
 
-To check the path to your phone yourself, ask and wait in one command:
+To check the path to your devices yourself, ask and wait in one command:
 
 ```bash
-starbridge ask --question "Does this reach my phone?" --option Yes --option No --wait
+starbridge ask --question "Does this reach me?" --option Yes --option No --wait
 ```
 
 When the agent runs out of other work, `starbridge waiting <id>` shows "Waiting for you" on
@@ -232,7 +234,7 @@ To upload without the service:
 starbridge quota push --provider claude --provider codex
 ```
 
-### Quiet the phone while you're here
+### Quiet your other devices while you're here
 
 On a desktop or laptop you work at, turn on presence:
 
@@ -242,9 +244,9 @@ starbridge config presence on
 
 While this machine's screen is unlocked and had keyboard or mouse input in the last minute,
 notifications on your other devices wait for the time set in Starbridge's Settings (30 s by
-default) and come only if the question is still open, so one you answer here doesn't buzz your
-phone. The question itself shows everywhere at once. The machine reads its lock and idle time
-itself and tells the server only yes or no. It works on macOS, Windows, and Linux under GNOME
+default) and come only if the question is still open, so one you answer here doesn't buzz them.
+The question itself shows everywhere at once. The machine reads its lock and idle time itself
+and tells the server only yes or no. It works on macOS, Windows, and Linux under GNOME
 or X11 with `xprintidle`; a machine with no screen sends nothing.
 
 ### Permission prompts

package/dist/starbridge.js

@@ -10203,6 +10203,7 @@ var PermissionAnswer = object({
   if (a.behavior === "allow" && a.message !== undefined)
     ctx.addIssue({ code: "custom", message: "message is for a deny" });
 });
+var SETTLED_REASON_MAX = 120;
 var Settled = object({
   v: literal(1),
   id: Id,
@@ -10214,7 +10215,8 @@ var Settled = object({
   choice: string2().max(100).optional(),
   text: string2().max(4000).optional(),
   dir: DirectoryHead.optional(),
-  behavior: _enum(["allow", "deny"]).optional()
+  behavior: _enum(["allow", "deny"]).optional(),
+  reason: string2().min(1).max(SETTLED_REASON_MAX).regex(/^[^\r\n]*$/, "one line").optional()
 }).refine((s) => s.device !== undefined || s.choice === undefined && s.text === undefined, {
   message: "choice and text come only with a device's outcome"
 }).refine((s) => s.choice === undefined || s.text === undefined, {
@@ -14368,6 +14370,7 @@ function checkJoined(dir, me) {
   if (!entry?.active || entry.member.role !== me.role || entry.member.boxPk !== me.boxPk || entry.member.signPk !== me.signPk)
     throw new ProtocolError("unknown-member", "the directory does not hold my keys");
 }
+var CHECK_CONFIRM_MS = 10 * 60000;
 function checkInput(entries, id) {
   const nul = new Uint8Array([0]);
   for (const e of entries) {
@@ -14426,7 +14429,10 @@ function publicKeys(keys) {
 // ../packages/protocol/src/notifications.ts
 var NotifyState = _enum(["on", "off", "blocked"]);
 var DeviceNotifications = object({ state: NotifyState });
-var NotificationStates = object({ devices: record(string2(), NotifyState) });
+var NotificationStates = object({
+  devices: record(string2(), NotifyState),
+  clients: record(string2(), string2()).optional()
+});
 var AppSignedIn = object({ signedIn: boolean2() });
 // ../packages/protocol/src/pace.ts
 var MIN_ELAPSED_FRACTION = 0.05;
@@ -14649,7 +14655,7 @@ function processAlive(pid) {
 // package.json
 var package_default = {
   name: "starbridge",
-  version: "0.1.3",
+  version: "0.1.4-rc.3",
   description: "Post decisions to your Starbridge devices and upload quota windows from CodexBar",
   license: "MIT",
   repository: {
@@ -16123,7 +16129,7 @@ function needsHello(ctx, id) {
   markConversation(ctx, id);
   return false;
 }
-var NUDGE = "Starbridge sends this session's permission prompts and questions to the owner's phone once it has run a starbridge command. Before anything else, run `starbridge hello` once.";
+var NUDGE = "Starbridge sends this session's permission prompts and questions to the owner's devices once it has run a starbridge command. Before anything else, run `starbridge hello` once.";
 function hookPreInvocation(ctx, text, opts) {
   if (opts.agent !== "antigravity")
     throw new UsageError(`--agent: antigravity (got ${opts.agent ?? "nothing"})`);
@@ -16538,6 +16544,12 @@ function sourceFor(input, ctx, machine) {
     ...r.sessionLinks.length > 0 ? { links: r.sessionLinks } : {}
   };
 }
+function typedBreaks(context) {
+  if (/[\r\n]/.test(context))
+    return context;
+  return context.split(/(`[^`]+`)/).map((part, i) => i % 2 === 1 ? part : part.replace(/(?<!\\)\\n/g, `
+`)).join("");
+}
 function buildDecision(input, ctx, machine, to) {
   if (!input.question)
     throw new UsageError("ask needs --question");
@@ -16731,16 +16743,33 @@ async function settle2(ctx, opts) {
   if (opts.outcome !== undefined && opts.outcome !== "elsewhere" && opts.outcome !== "withdrawn")
     throw new UsageError("--outcome is elsewhere or withdrawn");
   const outcome = opts.outcome;
+  const { reason } = opts;
+  if (reason !== undefined)
+    checkReason(reason);
   if (id) {
     const asked = ctx.store.state().asked[id];
     if (!asked)
       throw new UsageError(`${id} is not a decision this machine asked`);
+    const withdrawn = (outcome ?? (asked.answerIn ? "elsewhere" : "withdrawn")) === "withdrawn";
+    if (withdrawn && reason === undefined)
+      throw new UsageError(`say why you withdraw it, in one short line: --reason 'Fixed it myself after rereading the logs'`);
+    if (!withdrawn && reason !== undefined)
+      throw new UsageError("--reason is for --outcome withdrawn");
     const s = session(ctx);
-    await settleOne(ctx, s, await refreshDirectory(ctx, s), id, outcome);
+    await settleOne(ctx, s, await refreshDirectory(ctx, s), id, outcome, false, reason);
     return 0;
   }
+  if (reason !== undefined && outcome !== "withdrawn")
+    throw new UsageError("--reason is for --outcome withdrawn");
   return settleMany(ctx, opts, outcome);
 }
+function pickerReason(outcome) {
+  return outcome === "withdrawn" ? { reason: "Its answer could no longer reach the agent" } : {};
+}
+function checkReason(reason) {
+  if (!reason.trim() || /[\r\n]/.test(reason) || reason.length > SETTLED_REASON_MAX)
+    throw new UsageError(`--reason is one line of at most ${SETTLED_REASON_MAX} characters`);
+}
 async function settleMany(ctx, opts, outcome) {
   const st = ctx.store.state();
   const open = Object.entries(st.asked).filter(([id, a]) => (!a.settled || a.unposted) && !a.revoked && !st.answers[id]).filter(([, a]) => opts.all || a.session === opts.session).map(([id]) => id);
@@ -16761,7 +16790,7 @@ async function settleMany(ctx, opts, outcome) {
         return 130;
       }
       try {
-        if (await settleOne(ctx, s, dir, id, outcome, true))
+        if (await settleOne(ctx, s, dir, id, outcome, true, opts.reason))
           done++;
         break;
       } catch (e) {
@@ -16778,7 +16807,7 @@ async function settleMany(ctx, opts, outcome) {
   ctx.out(`Settled ${done} decision${done === 1 ? "" : "s"}.`);
   return 0;
 }
-async function settleOne(ctx, s, dir, id, outcomeOpt, bulk = false) {
+async function settleOne(ctx, s, dir, id, outcomeOpt, bulk = false, reason) {
   const asked = ctx.store.state().asked[id];
   if (!asked || asked.revoked)
     return false;
@@ -16803,6 +16832,7 @@ async function settleOne(ctx, s, dir, id, outcomeOpt, bulk = false) {
     to: to.map((d) => d.id),
     at: iso2(ctx.now()),
     outcome,
+    ...reason !== undefined && outcome === "withdrawn" ? { reason } : {},
     dir: signedHead(dir)
   };
   try {
@@ -17636,7 +17666,7 @@ import { existsSync as existsSync6, mkdirSync as mkdirSync7, readFileSync as rea
 import { dirname as dirname5, join as join11 } from "node:path";
 
 // ../plugin/hooks/rule.md
-var rule_default = "I am often away from this terminal and may not read your final message for hours. Reach me through the `starbridge` skill, not here, when you need a decision that is mine, and before you end a turn on work that waits on me, such as a PR to review or merge, or a failure only I can fix. In Claude Code, a quick question may use AskUserQuestion instead, since it reaches my devices too. Decide everything else yourself and keep working. Ask here only when `starbridge` fails. Write each card to be read in seconds on a phone, as the skill says.\n\nRun a command that blocks me (takes over the screen, keyboard or session, or holds a device I use), or that my instructions ask you to report, whole through `starbridge run`.\n";
+var rule_default = "I am often away from this terminal and may not read your final message for hours. Reach me through the `starbridge` skill, not here, when you need a decision that is mine, and before you end a turn on work that waits on me, such as a PR to review or merge, or a failure only I can fix. In Claude Code, a quick question may use AskUserQuestion instead, since it reaches my devices too. Decide everything else yourself and keep working. Ask here only when `starbridge` fails. Write each card to be read in seconds on a phone, as the skill says. When I answer one of your open cards here instead, withdraw it, saying why in a few words: `starbridge settle <id> --outcome withdrawn --reason 'You answered in the terminal'`.\n\nRun a command that blocks me (takes over the screen, keyboard or session, or holds a device I use), or that my instructions ask you to report, whole through `starbridge run`.\n";
 
 // ../plugin/skills/starbridge/SKILL.md
 var SKILL_default = `---
@@ -17714,7 +17744,8 @@ starbridge ask \\
 \`\`\`
 
 Quote text in single quotes, since double quotes expand \`$\` and backticks,
-and write apostrophes as ’. Other flags: \`--image\` (up to 4 PNG or JPEG),
+and write apostrophes as ’. Break lines inside the quotes with real line
+breaks, as above, never \`\\n\`: bash and zsh pass it on as typed. Other flags: \`--image\` (up to 4 PNG or JPEG),
 \`--link\` (up to 4 HTTPS URLs), \`--waiting\` (only the answer unblocks you), \`--answer-in\`. \`ask\` prints the decision id (\`d_Xk3…\`) and how the
 answer comes back.
 
@@ -17751,6 +17782,13 @@ if it leaves the choice open. Act on the answer at once. Post again only when
 the outcome changes what they would do (the merge failed); otherwise say it
 in your final message.
 
+A card still open that no longer needs an answer (the owner answered in the
+terminal, or you found it yourself) stays in their inbox until you take it
+back, before you act: \`starbridge settle <id> --outcome withdrawn --reason
+'…'\`. The reason shows in their History: one short line, 120 characters at
+most, such as \`'You answered in the terminal'\` or \`'Fixed it myself after
+rereading the logs'\`.
+
 ## Answers in an artifact
 
 When you built a claude.ai artifact whose buttons send the pick to this
@@ -17759,8 +17797,6 @@ arrives, run \`starbridge settle <id>\`, then act; a card answered in Starbridge
 needs no settle. When the owner taps Done on the card instead, you get
 \`Answer to <id> (…): answered on its page; read the answer there\`: the card is
 closed, so read the pick on the page and act, with no settle. An artifact only to look at goes in \`--link\`, with options.
-\`starbridge settle <id> --outcome withdrawn\` takes back a card you no longer
-need.
 
 ## Report a run
 
@@ -18550,7 +18586,7 @@ function pickerOpen(st, session) {
   return Object.entries(st.asked).filter(([id, a]) => a.picker === session && !a.settled && !st.answers[id]).map(([id]) => id);
 }
 async function settlePicker(ctx, session, outcome) {
-  await Promise.all(pickerOpen(ctx.store.state(), session).map((id) => settle2({ ...ctx, signal: undefined }, { id, outcome }).catch((e) => ctx.err(`starbridge: could not settle ${id}: ${e.message}`))));
+  await Promise.all(pickerOpen(ctx.store.state(), session).map((id) => settle2({ ...ctx, signal: undefined }, { id, outcome, ...pickerReason(outcome) }).catch((e) => ctx.err(`starbridge: could not settle ${id}: ${e.message}`))));
 }
 async function racePicker(ctx, outer, hook, waitText) {
   const questions = pickerQuestions(hook.tool_input);
@@ -18686,7 +18722,7 @@ async function hookQuestion(outer, stdin, opts) {
       return 0;
     }
     const outcome = outer.signal?.aborted ? "elsewhere" : "withdrawn";
-    await Promise.all(ids.map((id) => id ? settle2({ ...ctx, signal: undefined }, { id, outcome }).catch((e) => ctx.err(`starbridge: could not settle ${id}: ${e.message}`)) : undefined));
+    await Promise.all(ids.map((id) => id ? settle2({ ...ctx, signal: undefined }, { id, outcome, ...pickerReason(outcome) }).catch((e) => ctx.err(`starbridge: could not settle ${id}: ${e.message}`)) : undefined));
   } catch (e) {
     ctx.err(`starbridge: question not sent: ${e.message}`);
   } finally {
@@ -19036,7 +19072,7 @@ import { configDir } from "./poller.ts";
 
 /** The agent API revision this mod speaks, sent in the \`starbridge-api\` header. */
 export const API = 1;
-export const VERSION = "0.1.3";
+export const VERSION = "0.1.4-rc.3";
 const CLIENT = \`starbridge-mod/\${VERSION}\`;
 
 /** Event types this mod submits; others are skipped and left unconfirmed, as the API asks. */
@@ -23041,7 +23077,7 @@ async function ask2(ctx, hook, questions, signal) {
   if (picked.every((p) => p !== undefined) && !stop.aborted)
     return picked;
   const outcome = signal.aborted ? "elsewhere" : "withdrawn";
-  await Promise.all(ids.map((id) => id ? settle2({ ...ctx, signal: undefined }, { id, outcome }).catch((e) => ctx.err(`starbridge: could not settle ${id}: ${e.message}`)) : undefined));
+  await Promise.all(ids.map((id) => id ? settle2({ ...ctx, signal: undefined }, { id, outcome, ...pickerReason(outcome) }).catch((e) => ctx.err(`starbridge: could not settle ${id}: ${e.message}`)) : undefined));
   return;
 }
 
@@ -23897,7 +23933,6 @@ function addedAt(entries, id) {
     }
   }
 }
-var CONFIRM_MS = 10 * 60000;
 var waitingFile = (ctx) => join14(ctx.store.dir, "pair-waiting");
 var answerFile = (ctx, code) => join14(ctx.store.dir, `pair-answer.${code}`);
 function writeWhole(path, text) {
@@ -23935,7 +23970,7 @@ async function confirmCheck(ctx, code, name) {
       typed.push(l);
   }) : undefined;
   try {
-    const until = ctx.now().getTime() + CONFIRM_MS;
+    const until = ctx.now().getTime() + CHECK_CONFIRM_MS;
     for (;; ) {
       if (ctx.signal?.aborted || ctx.now().getTime() > until)
         return;
@@ -24548,14 +24583,14 @@ import {
 import { dirname as dirname8, join as join16 } from "node:path";
 // src/setup/codexbar-pin.json
 var codexbar_pin_default = {
-  version: "0.73.0",
+  version: "0.74.0",
   sha256: {
-    "macos-arm64": "cd8f853779f8faec003f53d5fc2a1614aef577ec9f603cbd58a9559b54e159b9",
-    "macos-x86_64": "19e7059de688e62be98790bc10198257f5d326e4a3f4191183c23106eb91780a",
-    "linux-aarch64": "ae6f9be046b09dc9d17210b661c25e2ee8a0150edb047b917d9eb17c295c7094",
-    "linux-x86_64": "a84f556c7ecebc8e606e0a34ee0d121626f72d7afc1e3adf5746410bc10f9611",
-    "linux-musl-aarch64": "a4007dfa6577a436eaeb6b46601982c69548c6e20730b3eb9133d4266d5ea92b",
-    "linux-musl-x86_64": "75fd9cfc00784eef8badd6e76f4f74cbdf7c13db0b7f9ca6e105ddb793e6e8f8"
+    "macos-arm64": "9aab1b9229f5d1d77de21b99aa887a60a47921bfd9b66e4b941a0e8a9d6e38e8",
+    "macos-x86_64": "4d239b7412683f1eb529d55b851fe922bb462527850b767d6c9b89ba14be3fdb",
+    "linux-aarch64": "46dc3b259b1df48b3fd6f337c754dd60dbece6772d7840cdc9514ab4977a0007",
+    "linux-x86_64": "fac8b2c474e4e37a2b067224437cb182693411ebf639441cd0facbb57bf086b1",
+    "linux-musl-aarch64": "9dab39f1197d9ccc501d1f678234cf15f94e8b84aa7349ba87103a5866dd793b",
+    "linux-musl-x86_64": "e7b0bdc6d6931a4e6fd5ce4037e1125a073ec6cf38cd72f1b3bd8aeecfde51f5"
   }
 };
 
@@ -25479,7 +25514,7 @@ async function setup(sys, opts) {
     section(ctx, "Test");
   if (upload)
     await firstUpload(ctx, upload);
-  if (machine && !opts.yes && await prompt.confirm("  Send a test decision to your phone?", true))
+  if (machine && !opts.yes && await prompt.confirm("  Send a test decision to your devices?", true))
     await testDecision(ctx, machine.name);
   section(ctx, failed.length === 0 ? "Starbridge is set up." : `Setup is done, but ${failed.length === 1 ? "one step" : `${failed.length} steps`} failed.`);
   for (const line of await otherCopies(sys))
@@ -25489,7 +25524,7 @@ async function setup(sys, opts) {
   for (const line of commandTable([
     ["Check it", "starbridge status"],
     ...permissionsEnabled(ctx) ? [] : [["Send permission prompts", "starbridge config permissions on"]],
-    ...ctx.store.agentConfig().presence?.enabled || !["desktop", "laptop"].includes(ctx.store.agentConfig().machineKind ?? "") ? [] : [["Quiet the phone while here", "starbridge config presence on"]],
+    ...ctx.store.agentConfig().presence?.enabled || !["desktop", "laptop"].includes(ctx.store.agentConfig().machineKind ?? "") ? [] : [["Quiet other devices while here", "starbridge config presence on"]],
     ["Remove from one agent", `starbridge uninstall --agent ${one}`],
     ["Remove everything", "starbridge uninstall"]
   ]))
@@ -25781,7 +25816,7 @@ async function testDecision(ctx, name) {
     session: ""
   };
   const opts = { wait: true, timeout: "10m" };
-  ctx.out("  Sent. Answer it on your phone or the web page (Ctrl-C skips)…");
+  ctx.out("  Sent. Answer it on any of your devices (Ctrl-C skips)…");
   let id;
   const asking = {
     ...ctx,
@@ -25809,7 +25844,7 @@ async function testDecision(ctx, name) {
   if (code !== EXIT_INTERRUPTED || !id)
     return;
   try {
-    await settle2(ctx, { id, outcome: "withdrawn" });
+    await settle2(ctx, { id, outcome: "withdrawn", reason: "Skipped in starbridge setup" });
     ctx.out("– Skipped");
   } catch (e) {
     ctx.out(`– Skipped, but the card stays open on your devices: ${e.message}`);
@@ -26254,11 +26289,12 @@ var HELP = `starbridge: post decisions to your devices, report runs, upload quot
       Show the owner that you are now blocked on the decision ("Waiting for you", which
       notifies them once more), or back to working on other things.
 
-  starbridge settle <decision id> [--outcome elsewhere|withdrawn]
+  starbridge settle <decision id> [--outcome elsewhere|withdrawn] [--reason <text>]
   starbridge settle --session <id> | --all [--yes] [--outcome elsewhere|withdrawn]
       Close a decision without a Starbridge answer: answered on its --answer-in page
       (elsewhere, the default for those) or no longer needed (withdrawn). Devices move it
-      out of the inbox. --session closes every open decision that session asked, --all every
+      out of the inbox. A withdrawal says why in --reason, one short line of at most 120
+      characters that History shows: --reason 'Fixed it myself after rereading the logs'. --session closes every open decision that session asked, --all every
       one this machine asked, after asking (--yes skips the question), at the pace the
       server allows: a looping agent's thousands take over an hour.
 
@@ -26313,7 +26349,7 @@ var HELP = `starbridge: post decisions to your devices, report runs, upload quot
       starbridge plugin's permission hook exits at once. presence: while this machine's
       screen is unlocked and had keyboard or mouse input in the last minute, notifications
       on your other devices wait a few seconds, so a question you answer here doesn't buzz
-      your phone; the server hears only yes or no. Off by default. machine-kind: the icon
+      them; the server hears only yes or no. Off by default. machine-kind: the icon
       devices show, detected by setup.
 
   starbridge hook permission --agent claude-code|pi|opencode|antigravity [--wait 570s]
@@ -26465,7 +26501,7 @@ async function run2(argv, ctx) {
         const input = {
           ...fromJson,
           ...v.question !== undefined ? { question: v.question } : {},
-          ...v.context !== undefined ? { context: v.context } : {},
+          ...v.context !== undefined ? { context: typedBreaks(v.context) } : {},
           ...v["context-file"] !== undefined ? { context: readText5(v["context-file"]) } : {},
           ...v.option !== undefined ? { options: v.option } : {},
           ...v.recommended !== undefined ? { recommended: v.recommended } : {},
@@ -26490,6 +26526,7 @@ async function run2(argv, ctx) {
           allowPositionals: true,
           options: {
             outcome: { type: "string" },
+            reason: { type: "string" },
             session: { type: "string" },
             all: { type: "boolean" },
             yes: { type: "boolean", short: "y" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starbridge",
-  "version": "0.1.3",
+  "version": "0.1.4-rc.3",
   "description": "Post decisions to your Starbridge devices and upload quota windows from CodexBar",
   "license": "MIT",
   "repository": {