starbridge 0.1.3 → 0.1.4-rc.2

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.2",
   description: "Post decisions to your Starbridge devices and upload quota windows from CodexBar",
   license: "MIT",
   repository: {
@@ -16731,16 +16737,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 +16784,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 +16801,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 +16826,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 +17660,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 = `---
@@ -17751,6 +17775,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 +17790,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 +18579,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 +18715,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 +19065,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.2";
 const CLIENT = \`starbridge-mod/\${VERSION}\`;
 
 /** Event types this mod submits; others are skipped and left unconfirmed, as the API asks. */
@@ -23041,7 +23070,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 +23926,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 +23963,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 +24576,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"
   }
 };
 
@@ -25809,7 +25837,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 +26282,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.
 
@@ -26490,6 +26519,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.2",
   "description": "Post decisions to your Starbridge devices and upload quota windows from CodexBar",
   "license": "MIT",
   "repository": {