@thurstonsand/pi-agent-switchboard 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 ## [Unreleased]
 
+## [0.12.0] - 2026-11-05
+
+Schema v10: update swb and the pi line together.
+
+### Changed
+
+- swb's tools and their arguments take names that say what the agent is choosing, all in snake_case: `session_reachable` is `session_list`, `session_ask` is `session_recall`, and `session_schedules` splits into `session_list_schedules` and `session_unschedule`. `session_launch`'s `goal` is `briefing`; `requestResponse` is `report_back`; a schedule's `label` is `schedule_label`; `swb_update_session`'s `force` is `cancel_turns` and `deleteWorktree` is `delete_worktree`; and the reader's `recall_read` takes `tool_output: trimmed | whole` in place of `body: preview | full`.
+- The CLI follows: `swb reachable` is `swb list`, `swb schedules` is `swb list-schedules`, `--request-response` is `--report-back`, and `--label` is `--schedule-label`.
+- swb's e2e runs pi-sessions 0.23.0, which takes the same names for its own tools.
+
+### Fixed
+
+- A Claude Code session that snoozes itself until its next message, or archives itself, mid-turn stays that way. Its tool call could land before swb recorded the turn's start, and that record then counted as the next prompt, ending the snooze or undoing the archive.
+- A working session no longer moves to Inactive when its turn outlasts `inactive_after`. Resolving a long-held attention prompt could hide the session and switch the Stage away before its reply landed, leaving that reply Unseen.
+- Codex errors no longer go unmarked when its transcript writes lag behind its live status. swb records the error when Codex reports it, before settling the turn, instead of checking a history entry that may not yet contain it.
+- Claude Code on a machine with managed settings takes a title set through swb with its next prompt, as everywhere else, and a conversation swb resumed in its Project root says so, to you and to the model. Its built-in `cc-plugin-sec-default` mod skipped the line's last two classic hooks, which carried both, and posted a notice for each; the line now hands them over through command hooks, which that mod leaves alone.
+- In Claude Code, `session_recall` returns as soon as its reader starts, and the reader's answer arrives as a message once it's done, as a subagent's does. A Claude Code session in auto mode no longer gets the answer twice: Claude Code made the reader report through SubagentHandback, which posted the answer beside the tool's result.
+
+## [0.11.0] - 2026-11-03
+
+Schema v9: update swb and the pi line together.
+
+### Added
+
+- `u` in the roster, and `M-a u` from the agent, marks a session Unseen: its `●` shows at once, and holds for as long as the session stays on the Stage, through any turns it takes, and after you move on. Only coming back to it from another session, for the second a Visit takes, clears it; `u` again takes the mark off. Snoozed and archived sessions can't be marked.
+- `[` and `]` in the roster step back and forward through the sessions you visited, as a browser's back and forward do, and `‹ ›` at the end of the legend does the same with a click. From the agent, `M-a [` and `M-a ]` focus the session there, waking it. A Visit counts as it does for Unseen, a second with the agent focused, so moving the cursor over a session doesn't. A new Deck reaches back through every earlier Visit. Archived sessions are passed over; snoozed ones aren't.
+
+### Changed
+
+- An idle session nobody is viewing now stops after an hour by default, not 30 minutes, matching Claude Code's hour-long prompt cache. `reap_after` still sets it.
+- The Deck lists its sessions sooner. It used to ask git, one directory at a time, about every directory any session ever ran in, archived ones included, before showing any; it now asks only about open sessions below their Project's root, all at once, and asks the harnesses what they offer after the list is up. A Deck opened when swb's tmux servers were down also no longer leaves its Stage blank for an extra 0.2 s.
+
+### Fixed
+
+- `?` shows every key again. Its popup had a fixed size the list outgrew, so its first keys scrolled off the top, and on a Deck under 37 rows it didn't open at all. It now fits the list, short of the Deck's own size, and when the Deck is too short it scrolls by `j`/`k`, `↑`/`↓`, `space` and PgUp/PgDn, or the wheel, saying how much lies above and below.
+
 ## [0.10.0] - 2026-11-02
 
 ### Added

package/index.js

@@ -5,10 +5,11 @@ import { dirname as dirname4, join as join3 } from "node:path";
 import { Text } from "@earendil-works/pi-tui";
 
 // packages/shared/src/index.ts
-import { execFileSync } from "node:child_process";
+import { execFile, execFileSync } from "node:child_process";
 import { existsSync as existsSync2, readFileSync, realpathSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname as dirname2, join } from "node:path";
+import { promisify } from "node:util";
 
 // packages/shared/src/db.ts
 import { closeSync, existsSync, linkSync, mkdirSync, openSync, unlinkSync } from "node:fs";
@@ -89,7 +90,7 @@ class Db {
 }
 
 // packages/shared/src/index.ts
-var SCHEMA_VERSION = 8;
+var SCHEMA_VERSION = 10;
 var VIEWS = ["agent", "editor", "split"];
 var HARNESSES = ["pi", "claude", "codex"];
 var SNOOZE_PRESETS = ["one_hour", "one_day", "monday", "next_message"];
@@ -140,25 +141,34 @@ function pidAlive(pid) {
     return error.code === "EPERM";
   }
 }
+var GIT_TIMEOUT_MS = 5000;
 function git(cwd, ...args) {
   try {
-    return execFileSync("git", ["-C", cwd, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 5000 }).trim();
+    return execFileSync("git", ["-C", cwd, ...args], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: GIT_TIMEOUT_MS
+    }).trim();
   } catch {
     return null;
   }
 }
+var execFileAsync = promisify(execFile);
 function projectRoot(cwd) {
   const common = git(cwd, "rev-parse", "--path-format=absolute", "--git-common-dir");
   return common ? dirname2(common) : cwd;
 }
-function linkedWorktree(cwd) {
-  const result = git(cwd, "rev-parse", "--path-format=absolute", "--show-toplevel", "--git-dir", "--git-common-dir");
+var WORKTREE_QUERY = ["rev-parse", "--path-format=absolute", "--show-toplevel", "--git-dir", "--git-common-dir"];
+function worktreeFrom(result) {
   if (!result)
     return null;
   const [path, dir, common] = result.split(`
 `);
   return dir !== common ? { path, common } : null;
 }
+function linkedWorktree(cwd) {
+  return worktreeFrom(git(cwd, ...WORKTREE_QUERY));
+}
 function branch(cwd) {
   const name = git(cwd, "rev-parse", "--abbrev-ref", "HEAD");
   return name === "HEAD" ? git(cwd, "rev-parse", "--short", "HEAD") : name;
@@ -299,14 +309,14 @@ function harnessName(harness) {
   return HARNESS_NAMES[harness];
 }
 function pendingFor(db, targetId) {
-  return db.all(`SELECT id, kind, source_id, target_id, body, request_response, created_at, schedule_id, scheduled_for FROM messages
+  return db.all(`SELECT id, kind, source_id, target_id, body, report_back, created_at, schedule_id, scheduled_for FROM messages
 			 WHERE target_id = ? AND delivered_at IS NULL AND cancelled_at IS NULL ORDER BY created_at, rowid`, targetId).map((row) => ({
     id: row.id,
     kind: row.kind,
     sourceId: row.source_id,
     targetId: row.target_id,
     body: row.body,
-    requestResponse: row.request_response === 1,
+    reportBack: row.report_back === 1,
     createdAt: row.created_at,
     scheduleId: row.schedule_id,
     scheduledFor: row.scheduled_for
@@ -336,9 +346,9 @@ function frame(db, m, now = Date.now()) {
     if (m.scheduleId)
       when += ` (schedule: ${m.scheduleId})`;
   }
-  const reply = m.requestResponse ? `
+  const reply = m.reportBack ? `
 
-Response requested: reply with session_send_message to session ${m.sourceId}.` : "";
+Report back: reply with session_send_message to session ${m.sourceId}.` : "";
   return `Message from session "${from.title}" (session: ${m.sourceId}${who})${when}:
 
 ${m.body}${reply}`;
@@ -348,12 +358,12 @@ ${m.body}${reply}`;
 import { Type } from "typebox";
 import { Value } from "typebox/value";
 var session = Type.String({ description: "The session's id." });
-var requestResponse = Type.Boolean({ description: "Whether it should reply to you." });
+var reportBack = Type.Boolean({ description: "Whether it should reply to you." });
 var TOOLS = {
-  session_reachable: {
-    label: "Reachable sessions",
+  session_list: {
+    label: "Sessions",
     description: "List every open session but this one, in any project or harness.",
-    guidelines: ["Call session_reachable only for an id you don't already have."],
+    guidelines: ["Call session_list only for an id you don't already have."],
     parameters: Type.Object({}),
     readOnly: true
   },
@@ -364,13 +374,13 @@ var TOOLS = {
     parameters: Type.Object({
       session,
       message: Type.String({ description: "Self-contained: the recipient doesn't see this conversation." }),
-      requestResponse
+      report_back: reportBack
     }),
     readOnly: false
   },
   session_launch: {
     label: "Launch",
-    description: "Start a new session on one of the presets below. With at or cron and a label, as session_schedule takes them, launch later instead, or anew each time the cron fires.",
+    description: "Start a new session on one of the presets below. With at or cron and a schedule_label, as session_schedule takes them, launch later instead, or anew each time the cron fires.",
     guidelines: [
       "Launch a new session when the work is independent of this one, belongs to another directory, or the user asks. For part of this work you need back this turn, use your harness's own subagents, if it has them.",
       "Omit session_launch's preset fields to run what this session runs; otherwise pass the fields of the preset whose note fits the work."
@@ -380,18 +390,18 @@ var TOOLS = {
       model: Type.Optional(Type.String()),
       effort: Type.Optional(Type.String()),
       agent: Type.Optional(Type.String()),
-      goal: Type.String({
-        description: "Its first message: a self-contained briefing of the objective, context, constraints, and what done means."
+      briefing: Type.String({
+        description: "Its first message, self-contained: the objective, context, constraints, and what done means."
       }),
       cwd: Type.Optional(Type.String({ description: "Defaults to this session's." })),
       title: Type.String({ description: "Short, for the roster." }),
       group: Type.Optional(Type.Union([Type.String(), Type.Null()], {
         description: "Omit for this session's Group within its Project, or pass a Group's name, in any Project; null for none."
       })),
-      requestResponse: Type.Boolean({ description: "Whether it reports back when done." }),
+      report_back: Type.Boolean({ description: "Whether it reports back when done." }),
       at: Type.Optional(Type.String()),
       cron: Type.Optional(Type.String()),
-      label: Type.Optional(Type.String())
+      schedule_label: Type.Optional(Type.String())
     }),
     readOnly: false
   },
@@ -399,7 +409,7 @@ var TOOLS = {
     label: "Schedule",
     description: "Schedule a message, once or on a cron, to this session or another. session_launch launches on a schedule.",
     guidelines: [
-      "Schedule only when the user asks to remind, follow up, check back, or repeat something. To wait on another session, set requestResponse on your message instead.",
+      "Schedule only when the user asks to remind, follow up, check back, or repeat something. To wait on another session, set report_back on your message instead.",
       "Write a scheduled message as instructions for when it fires: what to check, what to do with each outcome, and, if recurring, when to unschedule."
     ],
     parameters: Type.Object({
@@ -408,20 +418,25 @@ var TOOLS = {
         description: 'Once: an ISO 8601 time, local unless it has an offset ("2026-10-23T15:00"), or a duration from now ("PT2H").'
       })),
       cron: Type.Optional(Type.String({ description: 'Recurring: 5-field cron in local time ("57 8 * * 1-5" is weekdays at 8:57am).' })),
-      label: Type.String({ description: 'When it runs, in plain words ("Weekdays, 8:57 AM").' }),
+      schedule_label: Type.String({ description: 'When it runs, in plain words ("Weekdays, 8:57 AM").' }),
       session: Type.Optional(Type.String({ description: "The recipient's id; omit for this session." })),
-      requestResponse: Type.Optional(requestResponse),
+      report_back: Type.Optional(reportBack),
       snooze: Type.Optional(Type.Boolean({ description: "Snooze the recipient until it fires; only when the user asks." }))
     }),
     readOnly: false
   },
-  session_schedules: {
+  session_list_schedules: {
     label: "Schedules",
-    description: "List the schedules this session set or receives, or cancel one.",
+    description: "List the schedules this session set or receives.",
+    guidelines: [],
+    parameters: Type.Object({}),
+    readOnly: true
+  },
+  session_unschedule: {
+    label: "Unschedule",
+    description: "Cancel a pending schedule set on this session.",
     guidelines: ["Unschedule only when the user asks, or when the schedule's stated completion condition is met."],
-    parameters: Type.Object({
-      unschedule: Type.Optional(Type.String({ description: "A pending schedule's id, to cancel it." }))
-    }),
+    parameters: Type.Object({ schedule: Type.String({ description: "The schedule's id." }) }),
     readOnly: false
   },
   swb_update_session: {
@@ -429,18 +444,18 @@ var TOOLS = {
     description: "Archive, snooze, group, retitle, or reload a session, or cancel its turn: this one unless you name another.",
     guidelines: [
       "Archive a session only when the user asks or you started it and drove it to completion. Snooze or unsnooze a session, or cancel another's turn, only when the user asks.",
-      "Group sessions when the user asks or to keep sessions you started for one piece of work together, reusing a Group session_reachable lists.",
+      "Group sessions when the user asks or to keep sessions you started for one piece of work together, reusing a Group session_list lists.",
       "Retitle a session when the user asks or its title no longer fits its work.",
       "Reload a session when the user asks or after changing what it reads only at startup (AGENTS.md, CLAUDE.md, settings, extensions, plugins, skills, MCP servers)."
     ],
     parameters: Type.Object({
       session: Type.Optional(session),
       archived: Type.Optional(Type.Boolean({ description: "false unarchives." })),
-      deleteWorktree: Type.Optional(Type.Boolean({
+      delete_worktree: Type.Optional(Type.Boolean({
         description: "With archived true, for this session only: delete its linked worktree, keeping the branch and conversations. With family true, archive its descendants too, but delete only this worktree. Only when the user asks. Refuses modified or untracked files, locked worktrees, scheduled launches into it, or open/live sessions using it outside the selected family. Ignored files are deleted. Conversations whose directory is gone resume in the Project root, or fail clearly if that is gone too. Call last, then end your turn."
       })),
       family: Type.Optional(Type.Boolean({ description: "With archived: every open session it started, and theirs, too." })),
-      force: Type.Optional(Type.Boolean({ description: "With archived: also those mid-turn, blocked, cut off, or errored, cancelling their turns." })),
+      cancel_turns: Type.Optional(Type.Boolean({ description: "With archived: also archive those mid-turn, blocked, cut off, or errored, cancelling their turns." })),
       cancel: Type.Optional(Type.Boolean({ description: "Stop another session's running turn." })),
       group: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "The Group to move it into, in its Project; null takes it out." })),
       title: Type.Optional(Type.String()),
@@ -458,7 +473,7 @@ var TOOLS = {
     description: "Search other sessions' conversations, open or archived, subagents included. Lists matches best first, with passages.",
     guidelines: [
       'In session_search, plain words must all appear, as words or their starts; "phrases" match exactly; OR, -word, and parentheses narrow. Filters: harness:pi|claude|codex, project:NAME, file:PATH (read or changed), after: and before: (a date, an ISO 8601 time, or a duration ago like P7D), archived:yes|no. Filters alone list recent sessions.',
-      "Question a session_search hit with session_ask."
+      "Question a session_search hit with session_recall."
     ],
     parameters: Type.Object({
       query: Type.String({ description: 'Such as "redirect loop" file:src/auth.ts after:P14D.' }),
@@ -466,10 +481,10 @@ var TOOLS = {
     }),
     readOnly: true
   },
-  session_ask: {
-    label: "Ask session",
+  session_recall: {
+    label: "Recall session",
     description: "Ask about another session's conversation, open or archived. A reader with its own context answers, keeping the transcript out of yours.",
-    guidelines: ["Ask session_ask focused questions, not for a recap. To ask a session still at work, message it instead."],
+    guidelines: ["Ask session_recall focused questions, not for a recap. To ask a session still at work, message it instead."],
     parameters: Type.Object({ session, question: Type.String({ description: "Self-contained." }) }),
     readOnly: true
   },
@@ -496,15 +511,15 @@ var READER_TOOLS = {
   },
   recall_read: {
     label: "Read session",
-    description: "Read the session's entries in order, from one ref along its branch: prompts, replies, tool calls and their results, summaries, and how a turn ended. Long results are cut in preview; full reads them whole.",
+    description: "Read the session's entries in order, from one ref along its branch: prompts, replies, tool calls and their results, summaries, and how a turn ended. trimmed cuts long ones short; whole reads them whole.",
     guidelines: [],
     parameters: Type.Object({
       ref: Type.Optional(Type.String({ description: "The entry to start at, or its first few characters; the session's first by default." })),
       to: Type.Optional(Type.String({ description: "The entry to stop at, later on the same branch." })),
       before: Type.Optional(Type.Integer({ minimum: 0, maximum: 100, description: "Entries to include before ref." })),
       after: Type.Optional(Type.Integer({ minimum: 0, maximum: 500, description: "Entries to read after ref; as many as fit by default." })),
-      body: Type.Optional(Type.Enum(["preview", "full"], {
-        description: "preview (the default) cuts tool calls and results short; full reads them whole."
+      tool_output: Type.Optional(Type.Enum(["trimmed", "whole"], {
+        description: "trimmed (the default) cuts tool calls, their results, and harness context short; whole reads them whole."
       }))
     }),
     readOnly: true
@@ -522,7 +537,7 @@ Rules:
 - End with your answer as your final message: self-contained, with the files that matter by absolute path.`;
 var ALL = { ...TOOLS, ...READER_TOOLS };
 function toolParameters(name, worktree) {
-  return name === "swb_update_session" && !worktree ? Type.Omit(TOOLS.swb_update_session.parameters, ["deleteWorktree"]) : TOOLS[name].parameters;
+  return name === "swb_update_session" && !worktree ? Type.Omit(TOOLS.swb_update_session.parameters, ["delete_worktree"]) : TOOLS[name].parameters;
 }
 
 // packages/shared/src/trace.ts
@@ -846,12 +861,12 @@ ${details.body}`, 0, 0);
   };
   const self = (ctx) => ctx.sessionManager.getSessionId();
   const titleOf2 = (id) => typeof id === "string" ? titleOf(connect(), id) ?? id : "";
-  tool("session_reachable", () => "", (_args, ctx) => swb(proc.launch.bin, ["reachable", "--from", self(ctx)]));
+  tool("session_list", () => "", (_args, ctx) => swb(proc.launch.bin, ["list", "--from", self(ctx)]));
   tool("session_search", (args) => String(args.query ?? ""), (args, ctx, _toolCallId, signal) => swb(proc.launch.bin, ["search", "--from", self(ctx), ...args.limit ? ["--limit", String(args.limit)] : []], args.query, signal));
-  tool("session_ask", (args) => titleOf2(args.session), async (args, ctx, _toolCallId, signal) => {
+  tool("session_recall", (args) => titleOf2(args.session), async (args, ctx, _toolCallId, signal) => {
     signal?.throwIfAborted();
     if (!ctx.model)
-      throw new Error("No active model is available for session_ask");
+      throw new Error("No active model is available for session_recall");
     const first = await swb(proc.launch.bin, ["recall", "begin", args.session], JSON.stringify({ question: args.question }), signal);
     const { createAgentSession, DefaultResourceLoader, defineTool, getAgentDir, ModelRuntime, SessionManager } = await import("@earendil-works/pi-coding-agent");
     const modelRuntime = Reflect.get(ctx.modelRegistry, "runtime");
@@ -930,17 +945,8 @@ ${details.body}`, 0, 0);
       }
     }
   });
-  tool("session_send_message", (args) => titleOf2(args.session), (args, ctx, toolCallId) => swb(proc.launch.bin, [
-    "send",
-    "--from",
-    self(ctx),
-    "--to",
-    args.session,
-    "--request-id",
-    toolCallId,
-    ...args.requestResponse ? ["--request-response"] : []
-  ], args.message));
-  tool("session_launch", (args) => `${[args.harness, args.agent, args.model].filter(Boolean).join(" ") || "default"} · ${args.title}${args.label ? ` · ${args.label}` : ""}`, (args, ctx, toolCallId) => swb(proc.launch.bin, [
+  tool("session_send_message", (args) => titleOf2(args.session), (args, ctx, toolCallId) => swb(proc.launch.bin, ["send", "--from", self(ctx), "--to", args.session, "--request-id", toolCallId, ...args.report_back ? ["--report-back"] : []], args.message));
+  tool("session_launch", (args) => `${[args.harness, args.agent, args.model].filter(Boolean).join(" ") || "default"} · ${args.title}${args.schedule_label ? ` · ${args.schedule_label}` : ""}`, (args, ctx, toolCallId) => swb(proc.launch.bin, [
     "launch",
     ...["harness", "model", "effort", "agent"].flatMap((k) => args[k] ? [`--${k}`, args[k]] : []),
     "--from",
@@ -950,31 +956,34 @@ ${details.body}`, 0, 0);
     "--title",
     args.title,
     ...groupFlags(args.group),
-    ...args.requestResponse ? ["--request-response"] : [],
-    ...["at", "cron", "label"].flatMap((k) => args[k] !== undefined ? [`--${k}`, args[k]] : []),
+    ...args.report_back ? ["--report-back"] : [],
+    ...args.at !== undefined ? ["--at", args.at] : [],
+    ...args.cron !== undefined ? ["--cron", args.cron] : [],
+    ...args.schedule_label !== undefined ? ["--schedule-label", args.schedule_label] : [],
     "--request-id",
     toolCallId
-  ], args.goal));
-  tool("session_schedule", (args) => `${args.session ? titleOf2(args.session) : "this session"} · ${args.label}${args.snooze ? " · snooze" : ""}`, (args, ctx, toolCallId) => swb(proc.launch.bin, [
+  ], args.briefing));
+  tool("session_schedule", (args) => `${args.session ? titleOf2(args.session) : "this session"} · ${args.schedule_label}${args.snooze ? " · snooze" : ""}`, (args, ctx, toolCallId) => swb(proc.launch.bin, [
     "schedule",
     "--from",
     self(ctx),
-    "--label",
-    args.label,
+    "--schedule-label",
+    args.schedule_label,
     "--request-id",
     toolCallId,
     ...args.at !== undefined ? ["--at", args.at] : [],
     ...args.cron !== undefined ? ["--cron", args.cron] : [],
     ...args.session !== undefined ? ["--to", args.session] : [],
-    ...args.requestResponse ? ["--request-response"] : [],
+    ...args.report_back ? ["--report-back"] : [],
     ...args.snooze ? ["--snooze"] : []
   ], args.message));
-  tool("session_schedules", (args) => args.unschedule ? `unschedule ${args.unschedule}` : "", (args, ctx) => swb(proc.launch.bin, args.unschedule ? ["unschedule", args.unschedule, "--from", self(ctx)] : ["schedules", "--from", self(ctx)]));
+  tool("session_list_schedules", () => "", (_args, ctx) => swb(proc.launch.bin, ["list-schedules", "--from", self(ctx)]));
+  tool("session_unschedule", (args) => String(args.schedule ?? ""), (args, ctx) => swb(proc.launch.bin, ["unschedule", args.schedule, "--from", self(ctx)]));
   tool("swb_show_session", (args) => `${titleOf2(args.session)}${args.view ? ` · ${args.view}` : ""}`, (args, ctx) => swb(proc.launch.bin, ["show", args.session, "--from", self(ctx), ...args.view ? ["--view", args.view] : []]));
   const snoozeText = (snooze) => typeof snooze === "string" ? snooze : snooze.until;
   tool("swb_update_session", (args) => {
     const parts = [
-      args.archived === true ? `archive${args.family ? " family" : ""}${args.force ? " · force" : ""}` : "",
+      args.archived === true ? `archive${args.family ? " family" : ""}${args.cancel_turns ? " · cancel turns" : ""}` : "",
       args.archived === false ? "unarchive" : "",
       args.cancel ? "cancel turn" : "",
       args.snooze !== undefined ? `snooze ${snoozeText(args.snooze)}` : "",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@thurstonsand/pi-agent-switchboard",
-	"version": "0.10.0",
+	"version": "0.12.0",
 	"type": "module",
 	"description": "Records managed pi sessions for Agent Switchboard (swb)",
 	"license": "MIT",