agentbox-app 0.1.12 → 0.1.16

package/shared/shortcuts.mjs

@@ -93,6 +93,7 @@
 // touching it, so the row names no sections at all.
 
 import { NAME } from './product-name.mjs';
+import { chordOf, everyChord } from './key-caps.mjs';
 
 /** @type {import('./shortcuts.d.mts').ShortcutGroup[]} */
 export const SHORTCUTS = [
@@ -166,8 +167,8 @@ export const SHORTCUTS = [
     ],
   },
   {
-    // The one group that cannot be named by WHERE she is, because all four of
-    // its keys work both in the list and inside an open task. So it is named by
+    // The one group that cannot be named by WHERE she is, because all of its
+    // keys work both in the list and inside an open task. So it is named by
     // what the keys do, literally and in the order they are drawn.
     label: 'Closing, scheduling and undoing',
     keys: [
@@ -179,10 +180,16 @@ export const SHORTCUTS = [
       // the summary inside a thread and still meant the schedule picker in the
       // list, so this page taught one letter for two different things and an
       // office manager testing the app met both inside a minute. One meaning
-      // per letter: S is the summary, L is later.
-      { keys: ['L'], what: 'Put the task off until a time you pick.' },
+      // per letter: S is the summary, L is later. And the page says the word
+      // the key stands for, because that word is the action's name now
+      // (w-66e3ece93d): the ⌘K row, the picker and the toast all say Later.
+      { keys: ['L'], what: 'Later: put the task off until a time you pick.' },
       // focused branch and list switch: 'z' → undo
       { keys: ['Z'], what: 'Undo the last thing you did.' },
+      // opensTheToast(e.key, toast) above the focused branch → openToastRow.
+      // Z's other half: Z takes back what the toast announced, O goes into it.
+      // Only while a toast with somewhere to go is up (w-f0bfe32859).
+      { keys: ['O'], what: 'Open the task you just sent or answered, while its note is on screen.' },
       // (meta||ctrl) && 'a' && !inInput && !modal → tick the whole list
       { keys: ['⌘A'], what: 'Tick every task in the list. Press it again to untick.' },
     ],
@@ -193,10 +200,11 @@ export const SHORTCUTS = [
       // (meta||ctrl) && 'k' → the palette, above every other branch, and
       // forwarded from inside an open file by main.mjs as well.
       { keys: ['⌘K', 'Ctrl+K'], join: 'or', what: `The command bar: everything ${NAME} can do, by name.` },
-      // 'n' in both branches → setModal('compose'). C does the same and is
-      // left off: N is the default (w-fb9051e597).
+      // 'n' in both branches → setModal('compose').
       // "Threads", not tasks, since w-ec62ab6b38.
       { keys: ['N'], what: 'Start a new thread.' },
+      // cloudChord in the chords → toggleCloudRef: the cloud on or off.
+      { keys: ['⌘C'], what: 'Turn the cloud on or off, when no text is selected.' },
       // '/' above the focused branch → openSearch
       { keys: ['/'], what: 'Search your threads.' },
       // '\\' above the focused branch → togglePanel
@@ -219,18 +227,24 @@ export function everyKey(groups = SHORTCUTS) {
 // moves here has moved for every agent on its next run. The closing line is
 // the point: an agent's own saved memory is read before anything we hand it,
 // and on 2026-10-04 one said "press S" three days after S stopped scheduling.
+// And in the glyphs of the keyboard in front of them: an agent telling
+// somebody on Linux to "press ⌘K" names a key they do not have, which is the
+// same mistake as a stale memory.
 /** The keys as one block of plain text, for an agent's system prompt. */
-export function keysForAgents(groups = SHORTCUTS) {
+export function keysForAgents(groups = SHORTCUTS, { mac = true } = {}) {
   const lines = [
     `The keys in ${NAME}, the app this person reads you in, as they are today.`,
     'When you tell them to press something, use these. Keys have moved before,',
     'so a key you remember from an earlier session, a memory or a note that',
-    'disagrees with this list is out of date. Anything without a key is in ⌘K',
-    'by name.',
+    'disagrees with this list is out of date. Anything without a key is in',
+    `${chordOf('⌘K', mac)} by name.`,
   ];
   for (const g of groups) {
     lines.push('', `${g.label}:`);
-    for (const k of g.keys) lines.push(`- ${k.keys.join(k.join ? ` ${k.join} ` : ' ')}: ${k.what}`);
+    for (const k of g.keys) {
+      const keys = everyChord(k.keys, mac);
+      lines.push(`- ${keys.join(k.join && keys.length > 1 ? ` ${k.join} ` : ' ')}: ${k.what}`);
+    }
   }
   return lines.join('\n');
 }

package/shared/spawn-trouble.d.mts

@@ -8,3 +8,7 @@
 export function strandedTitle(count: number): string;
 /** The line in a thread where a run stopped, in our words; `raw` is the tool's own refusal. */
 export function runStoppedLine(raw: string): string;
+/** True when `text` is the app's own word that a run got nowhere. */
+export function saysARunGotNowhere(text: string | null | undefined): boolean;
+/** What one account's tile says when it cannot run; `dir` is its config folder, for the sign-in command. */
+export function accountSentence(cause: string, dir?: string | null): string;