toolroll 0.9.55 → 0.9.56

package/dist/{telegram-mate.js → telegram-lead.js}

@@ -1,11 +1,11 @@
 import { CHAT_ACTIONS, sharedActionAllowsChallenge, sharedActionPayload } from "./chat-actions.js";
-import { taskInCeiling, mirrorToTaskChat, couldNotAnswerText, channelRepos as telegramConversationRepos, resolveChannelMate as resolveTelegramMate, tooLongText, whichTaskText, replyContextFor, NO_PHONE_LINK, NO_TASK_LINK, proposalLink, confirmedLink, proposalPreview, proposalOutcomeText, handoffCardText, confirmedCardText } from "./chat-channel.js";
-export { channelRepos as telegramConversationRepos, resolveChannelMate as resolveTelegramMate, tooLongText, whichTaskText, replyContextFor, NO_PHONE_LINK, NO_TASK_LINK, proposalLink, confirmedLink, proposalPreview, proposalOutcomeText, handoffCardText, confirmedCardText, CHAT_ACTION_PARITY as TELEGRAM_ACTION_PARITY, parityGaps } from "./chat-channel.js";
+import { taskInCeiling, mirrorToTaskChat, couldNotAnswerText, channelRepos as telegramConversationRepos, resolveChannelLead as resolveTelegramLead, tooLongText, whichTaskText, replyContextFor, NO_PHONE_LINK, NO_TASK_LINK, proposalLink, confirmedLink, proposalPreview, proposalOutcomeText, handoffCardText, confirmedCardText } from "./chat-channel.js";
+export { channelRepos as telegramConversationRepos, resolveChannelLead as resolveTelegramLead, tooLongText, whichTaskText, replyContextFor, NO_PHONE_LINK, NO_TASK_LINK, proposalLink, confirmedLink, proposalPreview, proposalOutcomeText, handoffCardText, confirmedCardText, CHAT_ACTION_PARITY as TELEGRAM_ACTION_PARITY, parityGaps } from "./chat-channel.js";
 /**
  * The paired phone as one more way to use the same assistant.
  *
- * Transport only. An ordinary private Telegram message becomes a mate turn
- * through `runMateTurn` — the same saved thread, proposal rows, confirm
+ * Transport only. An ordinary private Telegram message becomes a lead turn
+ * through `runLeadTurn` — the same saved thread, proposal rows, confirm
  * doors and result actions the console and `toolroll chat` use —
  * and every act is still a card the operator confirms. This module owns
  * what is specific to the wire: proving the pairing (chat AND immutable
@@ -23,10 +23,10 @@ export { channelRepos as telegramConversationRepos, resolveChannelMate as resolv
  * the console and CLI state), and the door re-proves everything again.
  */
 import { createHash, randomBytes } from "node:crypto";
-import { MATE_MESSAGE_MAX_CHARS, mateFailureText, runMateTurn } from "./mate.js";
-import { confirmMateProposal, dismissMateProposal } from "./mate-doors.js";
+import { LEAD_MESSAGE_MAX_CHARS, leadFailureText, runLeadTurn } from "./lead.js";
+import { confirmLeadProposal, dismissLeadProposal } from "./lead-doors.js";
 import { ceilingDigestOf, verifyApproverStanding } from "./principal.js";
-import { MATE_ASK_OTHER } from "./store.js";
+import { LEAD_ASK_OTHER } from "./store.js";
 import { phoneText } from "./telegram-status.js";
 import { shapeReplyParts, telegramReply } from "./reply-shape.js";
 import { WARM_EMOJI, warmTurn } from "./chat-warmth.js";
@@ -112,7 +112,7 @@ export function askKeyboard(ask) {
     const rows = [];
     for (let at = 0; at < ask.options.length; at += 2)
         rows.push(ask.options.slice(at, at + 2).map((label, offset) => telegramButton(label.slice(0, 60), `ask:${ask.turn}:${at + offset}`)));
-    rows.push([telegramButton(MATE_ASK_OTHER, `ask:${ask.turn}:x`)]);
+    rows.push([telegramButton(LEAD_ASK_OTHER, `ask:${ask.turn}:x`)]);
     return rows;
 }
 /** Mint the card's tokens before the send, so a tap can never name a token that does not exist. */
@@ -151,7 +151,7 @@ export function applyProposalTap(store, binding, token, message, repos, options,
         ack("that button is stale — send /status to see what still waits");
         return { effects, confirmed: false, ignored: true };
     }
-    const proposal = store.getMateProposal(action.proposal);
+    const proposal = store.getLeadProposal(action.proposal);
     if (proposal === null) {
         store.consumeTelegramProposalAction(token, now);
         ack("that card no longer exists");
@@ -209,10 +209,10 @@ export function applyProposalTap(store, binding, token, message, repos, options,
             ack("that button was already used");
             return { effects, confirmed: false, ignored: true };
         }
-        const done = dismissMateProposal(store, who, proposal.id, now);
+        const done = dismissLeadProposal(store, who, proposal.id, now);
         store.consumeTelegramProposalActions(proposal.id, now);
         ack(done ? "dismissed" : "that proposal was already acted on");
-        edit(done ? "Dismissed." : proposalOutcomeText(store.getMateProposal(proposal.id) ?? proposal));
+        edit(done ? "Dismissed." : proposalOutcomeText(store.getLeadProposal(proposal.id) ?? proposal));
         return { effects, confirmed: false, ignored: !done };
     }
     if (action.phase === "cancel") {
@@ -273,7 +273,7 @@ export function applyProposalTap(store, binding, token, message, repos, options,
         ack(action.phase === "yes" ? "that confirmation expired — start again from Confirm" : "that button was already used");
         return { effects, confirmed: false, ignored: true };
     }
-    const outcome = confirmMateProposal(store, who, proposal.id, now, {
+    const outcome = confirmLeadProposal(store, who, proposal.id, now, {
         via: "telegram",
         evidenceRoot: options.evidenceRoot,
         confirm: action.phase === "yes",
@@ -405,7 +405,7 @@ async function runTelegramConversation(row, args) {
     const deliver = async (outcomeWord) => {
         // The row as it is NOW: the session was bound after this claim read it.
         const bound = store.getTelegramConversation(row.id)?.session ?? null;
-        const session = bound === null ? null : store.getMateSession(bound);
+        const session = bound === null ? null : store.getLeadSession(bound);
         if (session === null) {
             await notify("This conversation was restarted before my reply went out, so it wasn't sent. Nothing was changed. Send your message again.");
             finish({ state: "failed", outcome: "unsent:no-session" });
@@ -421,7 +421,7 @@ async function runTelegramConversation(row, args) {
                 continue;
             const now = clock();
             if (part.kind === "card") {
-                const proposal = part.proposal === null ? null : store.getMateProposal(part.proposal);
+                const proposal = part.proposal === null ? null : store.getLeadProposal(part.proposal);
                 if (proposal === null || proposal.state !== "pending") {
                     // Confirmed or dismissed from the console or the terminal before the card went out: moot, not lost.
                     if (!store.dropTelegramConversationPart(row.id, part.ordinal, owner, proposal === null ? "the proposal is gone" : `the proposal was already ${proposal.state}`, now))
@@ -523,7 +523,7 @@ async function runTelegramConversation(row, args) {
                 // A card's link is minted NOW, from the persisted proposal and the
                 // origin configured at this moment: a retry after the setting changed
                 // or went away carries the current truth, never a stored URL.
-                const proposal = part.kind === "card" && part.proposal !== null ? store.getMateProposal(part.proposal) : null;
+                const proposal = part.kind === "card" && part.proposal !== null ? store.getLeadProposal(part.proposal) : null;
                 const origin = proposal === null ? null : options.phoneOrigin?.() ?? null;
                 const wanted = proposal === null ? null : proposalLink(store, proposal, repos);
                 const keyboard = keyboardWith(part.keyboard, phoneLinkButton(origin, wanted));
@@ -597,11 +597,11 @@ async function runTelegramConversation(row, args) {
                 const now = clock();
                 const parts = shapeReplyParts(reply, PART_CAP, { asked: row.text, appOrigin: options.phoneOrigin?.() ?? null }, shaped => telegramReply(shaped).text.length).map((text, index) => ({ kind: "reply", text, replyTo: index === 0 ? row.messageId : null }));
                 // The lead's question to its owner: one tap per option, then "Something else".
-                const ask = store.mateAsk(turn);
+                const ask = store.leadAsk(turn);
                 if (ask !== null)
                     parts.push({ kind: "reply", text: phoneText(ask.question, 1_000), keyboard: askKeyboard(ask) });
                 // Only a turn that answered may have its selection sent: a failed or revoked turn's rows were deleted with its drafts, and the state is read again here.
-                const selected = store.getMateTurn(turn)?.state === "answered" ? store.listMateTurnEvidence(turn) : [];
+                const selected = store.getLeadTurn(turn)?.state === "answered" ? store.listLeadTurnEvidence(turn) : [];
                 for (const image of selected)
                     parts.push({ kind: "image", text: image.caption, taskId: image.taskId, run: image.run, artifact: image.artifact, sha256: image.sha256 });
                 for (const proposal of proposals) {
@@ -625,8 +625,8 @@ async function runTelegramConversation(row, args) {
     const recover = async (session, turnId, repos) => {
         // A turn that died past its deadline is swept to failed first, so a
         // restart reports the truth instead of waiting on a ghost.
-        store.sweepStaleMateTurns(clock());
-        const turn = store.getMateTurn(turnId);
+        store.sweepStaleLeadTurns(clock());
+        const turn = store.getLeadTurn(turnId);
         if (turn === null) {
             finish({ state: "failed", outcome: "replayed:missing" });
             report.refused++;
@@ -638,13 +638,13 @@ async function runTelegramConversation(row, args) {
             return;
         }
         if (turn.state !== "answered") {
-            await notify(mateFailureText(turn.failureReason));
+            await notify(leadFailureText(turn.failureReason));
             finish({ state: "failed", outcome: `replayed:${turn.failureReason ?? "failed"}` });
             report.refused++;
             return;
         }
-        const reply = store.listMateMessages(turn.thread, 200).find(one => one.turn === turn.id && one.role === "assistant")?.text ?? "(the reply text is no longer in the thread)";
-        const proposals = store.listMateProposals(turn.thread, ["pending"]).filter(one => one.turn === turn.id);
+        const reply = store.listLeadMessages(turn.thread, 200).find(one => one.turn === turn.id && one.role === "assistant")?.text ?? "(the reply text is no longer in the thread)";
+        const proposals = store.listLeadProposals(turn.thread, ["pending"]).filter(one => one.turn === turn.id);
         if (!plan(session, turnId, reply, proposals, repos) && store.listTelegramConversationParts(row.id).length === 0)
             return;
         await sendOrHandOff("replayed");
@@ -676,14 +676,14 @@ async function runTelegramConversation(row, args) {
     // 4. A session bound before an earlier dispatch: the receipt lives there,
     // whatever session is live today.
     if (row.session !== null) {
-        const receipt = store.mateRequestReceipt(row.session, row.request);
+        const receipt = store.leadRequestReceipt(row.session, row.request);
         if (receipt !== null) {
             await recover(row.session, receipt.turn, repos);
             return;
         }
     }
     // 5. The session and thread — shared with the console and the CLI.
-    const resolved = resolveTelegramMate(store, binding, repos, clock());
+    const resolved = resolveTelegramLead(store, binding, repos, clock());
     if (!resolved.ok && resolved.reason === "busy") {
         await requeue("busy");
         return;
@@ -722,7 +722,7 @@ async function runTelegramConversation(row, args) {
     });
     let outcome;
     try {
-        outcome = await runMateTurn({
+        outcome = await runLeadTurn({
             store, who, session, thread, config, key: null, message: row.text, requestId: row.request,
             ...(row.context === null ? {} : { context: row.context }),
             ...(options.subscriptionRunner === undefined ? {} : { subscriptionRunner: options.subscriptionRunner }),
@@ -733,7 +733,7 @@ async function runTelegramConversation(row, args) {
         clearInterval(heartbeat);
         warm.stop();
     }
-    const receipt = store.mateRequestReceipt(session.id, row.request);
+    const receipt = store.leadRequestReceipt(session.id, row.request);
     if (receipt !== null)
         store.bindTelegramConversationTurn(row.id, owner, session.id, receipt.turn);
     if (!outcome.ok && "refused" in outcome) {
@@ -761,7 +761,7 @@ async function runTelegramConversation(row, args) {
     if (row.taskId !== null)
         mirrorToTaskChat(store, who, row.taskId, "Telegram", row.text, outcome.reply, clock());
     // 7. The reply and its cards: durable first, then sent.
-    const proposals = store.listMateProposals(thread.id, ["pending"]).filter(one => one.turn === outcome.turn);
+    const proposals = store.listLeadProposals(thread.id, ["pending"]).filter(one => one.turn === outcome.turn);
     if (!plan(session.id, outcome.turn, outcome.reply, proposals, who.repos) && store.listTelegramConversationParts(row.id).length === 0)
         return;
     await sendOrHandOff("answered");

package/dist/telegram-status.js

@@ -39,7 +39,7 @@ export const PHONE_HELP = [
     "/task <name or number> — the same, by a word from its name",
     "/lead — back to talking about everything",
     "/status — what's happening across your projects",
-    "/team — team conversations; /team <number> to talk in one, /team off to leave",
+    // D5: /team (the central team service's conversations) is deprecated: it still answers this release, unlisted.
     "/help — this message",
     "",
     "To answer an agent's question, tap its buttons; reply to the question to add a note. Approvals that need your password, cancelling and publishing finish in the Toolroll console, and a console button only takes you there. The computer must be awake and connected to reply.",

package/dist/telegram-team.d.ts

@@ -7,7 +7,7 @@
  * per-chat cursor read on every bridge cycle. No model runs here.
  */
 import type { Store } from "./store.js";
-import { type InlineButton } from "./telegram-mate.js";
+import { type InlineButton } from "./telegram-lead.js";
 import type { TelegramTransport } from "./telegram.js";
 import type { TelegramMessage } from "./contracts/telegram-callback.js";
 export type TeamCommand = {

package/dist/telegram-team.js

@@ -1,8 +1,8 @@
 import { renderReply, shapeReplyParts } from "./reply-shape.js";
 import { TeamLeads } from "./team-leads.js";
 import { proposalPreview, tooLongText } from "./chat-channel.js";
-import { PART_CAP, mintCardTokens, phoneLinkButton, splitParts } from "./telegram-mate.js";
-import { MATE_MESSAGE_MAX_CHARS } from "./mate.js";
+import { PART_CAP, mintCardTokens, phoneLinkButton, splitParts } from "./telegram-lead.js";
+import { LEAD_MESSAGE_MAX_CHARS } from "./lead.js";
 import { phoneText } from "./telegram-status.js";
 /** `/team` lists, `/team <n>` chooses, `/team off` (or `private`) leaves. Any other slash text is not ours. */
 export function teamCommand(text) {
@@ -172,7 +172,7 @@ export function applyTeamInbound(input) {
         report.ignored++;
         return true;
     }
-    if (trimmed.length > MATE_MESSAGE_MAX_CHARS) {
+    if (trimmed.length > LEAD_MESSAGE_MAX_CHARS) {
         say(chatId, tooLongText(trimmed.length));
         report.chatRefused = (report.chatRefused ?? 0) + 1;
         return true;
@@ -255,7 +255,7 @@ export async function deliverTeamChats(store, botId, transport, clock, report, p
         const row = conversationRow(store, chat.conversation);
         if (row === null)
             continue;
-        const pending = store.handle.prepare(`SELECT m.id, m.role, m.text, m.turn, q.author, q.request_id, q.status FROM mate_message m
+        const pending = store.handle.prepare(`SELECT m.id, m.role, m.text, m.turn, q.author, q.request_id, q.status FROM lead_message m
       LEFT JOIN team_message q ON q.message = m.id WHERE m.thread = ? AND m.id > ? ORDER BY m.id LIMIT 20`).all(row.thread, chat.cursor);
         for (const message of pending) {
             const id = Number(message["id"]);
@@ -279,7 +279,7 @@ export async function deliverTeamChats(store, botId, transport, clock, report, p
             if (role === "assistant" && message["turn"] !== null) {
                 const turn = Number(message["turn"]);
                 const cardBinding = cardBindingFor(store, botId, chat, turn);
-                for (const proposal of store.listMateProposals(row.thread, ["pending"]).filter(one => one.turn === turn)) {
+                for (const proposal of store.listLeadProposals(row.thread, ["pending"]).filter(one => one.turn === turn)) {
                     const enrolled = await access();
                     if (enrolled === null) {
                         complete = false;

package/dist/telegram.d.ts

@@ -19,7 +19,7 @@
  * are one command.
  */
 import { type Store, type Notification } from "./store.js";
-import { type TelegramConversationOptions } from "./telegram-mate.js";
+import { type TelegramConversationOptions } from "./telegram-lead.js";
 /** Read the enrolled project list on demand. No callback means no task data,
  * never an implicit all-database ceiling. Shared by pass and embedded follower. */
 export type TelegramReadProjects = () => Promise<readonly string[]>;

package/dist/telegram.js

@@ -18,8 +18,7 @@
  * BotFather token plus `bridge telegram unpair` is the recovery, and both
  * are one command.
  */
-import { applyTelegramQuestionReply, applyTelegramQuestionTap, openQuestionOf, telegramQuestionButtons } from "./teammate-question.js";
-import { messageTeammate } from "./teammate-desk.js";
+import { applyTelegramQuestionReply, applyTelegramQuestionTap, openQuestionOf, telegramQuestionButtons } from "./subagent-question.js";
 import { acceptanceEvidenceText } from "./chat-acceptance.js";
 import { verifyApproverStanding } from "./principal.js";
 import { resultImageFileName, resultTaskLabel, verifyResultImage } from "./chat-evidence.js";
@@ -43,9 +42,9 @@ import { focusContextFor, taskInCeiling } from "./chat-channel.js";
 import { answersPrompt, applyDecideFeedback, applyDecideTap, decideFallbackLink, dropDecideTokens, hasLiveDecideTokens, linksFor, placeDecidePrompt, decideOffer, decideTargetOf, isDecideToken, mergedText, mintDecideButtons, offerFingerprint, openPromptFor, placeDecideTokens, recordChatMerge, retireDecideTokens } from "./chat-decide.js";
 import { mergePullRequest } from "./pull-request-flow.js";
 import { phoneCommand, phoneStatus, phoneTaskView, PHONE_CONSOLE_FOOTER, PHONE_HELP, notificationIdentity, phoneTaskChoices, resolvePhoneTask, phoneFocusText, phoneTaskListText, phoneText, PHONE_NO_MATCH, PHONE_BACK_TO_LEAD } from "./telegram-status.js";
-import { MATE_MESSAGE_MAX_CHARS } from "./mate.js";
+import { LEAD_MESSAGE_MAX_CHARS } from "./lead.js";
 import { envValue } from "./names.js";
-import { applyProposalTap, processTelegramConversations, phoneLinkButton, replyContextFor, telegramConversationRepos, telegramRequestId, tooLongText, whichTaskText, } from "./telegram-mate.js";
+import { applyProposalTap, processTelegramConversations, phoneLinkButton, replyContextFor, telegramConversationRepos, telegramRequestId, tooLongText, whichTaskText, } from "./telegram-lead.js";
 import { askOf, parseTelegramUpdate, pickOf, readTelegramButtonData, readTelegramUpdate, telegramButton } from "./contracts/telegram-callback.js";
 /** The environment name — and therefore the name the builder strips from agents (both names; see names.ts). */
 export { TELEGRAM_TOKEN_ENV as TOKEN_ENV, TELEGRAM_TOKEN_ENVS as TOKEN_ENVS } from "./names.js";
@@ -1246,7 +1245,7 @@ async function deliverOne(store, botId, binding, sender, notification, clock, ph
             parts = voiced.map(one => one.text);
             entities = voiced.map(one => one.entities);
         }
-        // A teammate's question (v93): its options and "Answer in words", for the person it asks.
+        // A subagent's question (v93): its options and "Answer in words", for the person it asks.
         const asked = flowKeys === null && choiceKeys === null ? openQuestionOf(store, notification.dedupeKey) : null;
         const questionKeys = asked === null ? null : telegramQuestionButtons(store, binding, asked, clock());
         const keys = flowKeys ?? choiceKeys ?? questionKeys;
@@ -1649,7 +1648,7 @@ function applyMessage(context, update, effects) {
         // assistant when a conversation is configured; otherwise silence.
         const binding = store.liveTelegramBindingFor(botId, String(from.id));
         // A reply to an Edit or Send back prompt (v86): the new draft, or the note it goes back with.
-        // A reply to a teammate's "Answer in words" prompt (v93): the answer.
+        // A reply to a subagent's "Answer in words" prompt (v93): the answer.
         const questionPrompt = binding !== null && message.reply_to_message !== undefined && String(chat.id) === binding.chatId
             ? store.telegramQuestionPrompt(binding.chatId, String(message.reply_to_message.message_id), clock()) : null;
         if (binding !== null && questionPrompt !== null) {
@@ -1694,27 +1693,7 @@ function applyMessage(context, update, effects) {
             });
             return;
         }
-        // A message to a teammate by name (v96), in the person's own chat: a card on its desk, and the answer comes back here.
-        if (binding !== null && message.reply_to_message === undefined && message.chat?.type === "private" && String(chat.id) === binding.chatId && store.accountOf(binding.approver)?.role === "approver") {
-            const repos = context.projects === null ? store.knownRepos().filter(repo => store.accountCanAccess(binding.approver, repo)) : telegramConversationRepos(store, binding.approver, context.projects);
-            const handed = messageTeammate(store, { who: binding.approver, repos, via: "Telegram" }, message.text ?? "", clock());
-            if (handed !== null) {
-                effects.push(async () => {
-                    let button = null;
-                    if (handed.link !== undefined) {
-                        try {
-                            button = phoneLinkButton(context.conversation?.phoneOrigin?.() ?? null, handed.link);
-                        }
-                        catch {
-                            button = null;
-                        }
-                    }
-                    await transport("sendMessage", { chat_id: binding.chatId, text: handed.said, link_preview_options: { is_disabled: true }, reply_parameters: { message_id: message.message_id },
-                        ...(button === null ? {} : { reply_markup: { inline_keyboard: [button] } }) });
-                });
-                return;
-            }
-        }
+        // D5: a message naming a subagent ("@rosa …") goes to the lead like any other, which asks the subagent with a card.
         const repliedDecision = binding !== null && message.reply_to_message !== undefined
             ? store.decisionForTelegramMessage(binding.id, binding.chatId, String(message.reply_to_message.message_id))
             : null;
@@ -1799,7 +1778,7 @@ function applyConversation(context, update, effects) {
         report.ignored++;
         return;
     }
-    if (text.length > MATE_MESSAGE_MAX_CHARS) {
+    if (text.length > LEAD_MESSAGE_MAX_CHARS) {
         say(tooLongText(text.length));
         report.chatRefused = (report.chatRefused ?? 0) + 1;
         return;
@@ -2150,7 +2129,7 @@ function applyCallback(context, update, effects) {
         editText(phoneFocusText(view.text), [[telegramButton("Back to the lead", "pick:lead")]]);
         return;
     }
-    // A teammate's question (v93): an option answers it; "Answer in words" asks for a reply.
+    // A subagent's question (v93): an option answers it; "Answer in words" asks for a reply.
     const questionAction = store.getTelegramQuestionAction(token);
     if (questionAction !== null) {
         if (questionAction.binding !== binding.id || questionAction.chatId !== tapChat || (questionAction.messageId !== null && questionAction.messageId !== String(message.message_id))) {
@@ -2247,7 +2226,7 @@ function applyCallback(context, update, effects) {
             return;
         }
         const turn = askTap.turn;
-        const found = store.getMateTurn(turn)?.approver === binding.approver ? store.mateAskState(turn, clock()) : { state: "expired" };
+        const found = store.getLeadTurn(turn)?.approver === binding.approver ? store.leadAskState(turn, clock()) : { state: "expired" };
         if (found.state !== "open") {
             const line = found.state === "answered" ? "That question was already answered." : "That question expired. Send your answer as a message.";
             ack(line);

package/dist/text-limits.d.ts

@@ -22,12 +22,12 @@ export declare const TEXT_LIMITS: {
     readonly flowRef: 60;
     /** A Message zone's message, or the comment an Update zone leaves. */
     readonly flowMessage: 1000;
-    /** Who decides a "Person decides" zone (a sign-in name), and the AI teammate who works a zone, as written. */
+    /** Who decides a "Person decides" zone (a sign-in name), and the subagent who works a zone, as written. */
     readonly flowDecider: 64;
-    readonly flowTeammate: 40;
+    readonly flowSubagent: 40;
     /** A Build zone's other project: its path. */
     readonly flowRepo: 1000;
-    /** A script's or teammate's answer, a choice's button, a Sort zone's answer and what it means, its question, and a score's level. */
+    /** A script's or subagent's answer, a choice's button, a Sort zone's answer and what it means, its question, and a score's level. */
     readonly flowAnswer: 40;
     readonly flowChoice: 40;
     readonly flowSortMeans: 200;
@@ -136,11 +136,11 @@ export declare const TEXT_LIMITS: {
     readonly decisionLabel: 120;
     readonly decisionConsequence: 500;
     readonly decisionAssignee: 120;
-    /** A teammate's turn (src/contracts/teammate-turn.ts): the answer it picks (and each option it offers), its question, its reason and what it remembers. */
-    readonly teammateAnswer: 60;
-    readonly teammateQuestion: 600;
-    readonly teammateReason: 400;
-    readonly teammateRemember: 300;
+    /** A subagent's turn (src/contracts/subagent-turn.ts): the answer it picks (and each option it offers), its question, its reason and what it remembers. */
+    readonly subagentAnswer: 60;
+    readonly subagentQuestion: 600;
+    readonly subagentReason: 400;
+    readonly subagentRemember: 300;
     /** The lead's tools and the MCP gateway (src/contracts/lead-tools.ts, gateway-tools.ts): a task's id as a tool names
      * it, a task's title and one path it touches, and a project's path as the gateway names it (an assignment brief or
      * project context, and the rest of the gateway). */
@@ -175,17 +175,17 @@ export declare const TEXT_LIMITS: {
     readonly actionUrl: 500;
     readonly actionSecret: 64;
     readonly actionAbout: 240;
-    /** A teammate change (propose_teammate): a soul section's title, a routine's schedule, a tool, an action, a limit's
+    /** A subagent change (propose_subagent): a soul section's title, a routine's schedule, a tool, an action, a limit's
      * field, a name, a soul file, a note, a choice and text. */
-    readonly teammateSection: 60;
-    readonly teammateSchedule: 80;
-    readonly teammateTool: 40;
-    readonly teammateAction: 64;
-    readonly teammateName: 40;
-    readonly teammateSoul: 12000;
-    readonly teammateNote: 300;
-    readonly teammateChoice: 60;
-    readonly teammateText: 2000;
+    readonly subagentSection: 60;
+    readonly subagentSchedule: 80;
+    readonly subagentTool: 40;
+    readonly subagentAction: 64;
+    readonly subagentName: 40;
+    readonly subagentSoul: 12000;
+    readonly subagentNote: 300;
+    readonly subagentChoice: 60;
+    readonly subagentText: 2000;
     /** A project knowledge reference id, a promise and why it is released, what the lead remembers (its text, a
      * decision's reason and source), a person's name, and a question to the owner with its options. */
     readonly knowledgeReference: 20;

package/dist/text-limits.js

@@ -22,12 +22,12 @@ export const TEXT_LIMITS = {
     flowRef: 60,
     /** A Message zone's message, or the comment an Update zone leaves. */
     flowMessage: 1_000,
-    /** Who decides a "Person decides" zone (a sign-in name), and the AI teammate who works a zone, as written. */
+    /** Who decides a "Person decides" zone (a sign-in name), and the subagent who works a zone, as written. */
     flowDecider: 64,
-    flowTeammate: 40,
+    flowSubagent: 40,
     /** A Build zone's other project: its path. */
     flowRepo: 1_000,
-    /** A script's or teammate's answer, a choice's button, a Sort zone's answer and what it means, its question, and a score's level. */
+    /** A script's or subagent's answer, a choice's button, a Sort zone's answer and what it means, its question, and a score's level. */
     flowAnswer: 40,
     flowChoice: 40,
     flowSortMeans: 200,
@@ -136,11 +136,11 @@ export const TEXT_LIMITS = {
     decisionLabel: 120,
     decisionConsequence: 500,
     decisionAssignee: 120,
-    /** A teammate's turn (src/contracts/teammate-turn.ts): the answer it picks (and each option it offers), its question, its reason and what it remembers. */
-    teammateAnswer: 60,
-    teammateQuestion: 600,
-    teammateReason: 400,
-    teammateRemember: 300,
+    /** A subagent's turn (src/contracts/subagent-turn.ts): the answer it picks (and each option it offers), its question, its reason and what it remembers. */
+    subagentAnswer: 60,
+    subagentQuestion: 600,
+    subagentReason: 400,
+    subagentRemember: 300,
     /** The lead's tools and the MCP gateway (src/contracts/lead-tools.ts, gateway-tools.ts): a task's id as a tool names
      * it, a task's title and one path it touches, and a project's path as the gateway names it (an assignment brief or
      * project context, and the rest of the gateway). */
@@ -175,17 +175,17 @@ export const TEXT_LIMITS = {
     actionUrl: 500,
     actionSecret: 64,
     actionAbout: 240,
-    /** A teammate change (propose_teammate): a soul section's title, a routine's schedule, a tool, an action, a limit's
+    /** A subagent change (propose_subagent): a soul section's title, a routine's schedule, a tool, an action, a limit's
      * field, a name, a soul file, a note, a choice and text. */
-    teammateSection: 60,
-    teammateSchedule: 80,
-    teammateTool: 40,
-    teammateAction: 64,
-    teammateName: 40,
-    teammateSoul: 12_000,
-    teammateNote: 300,
-    teammateChoice: 60,
-    teammateText: 2_000,
+    subagentSection: 60,
+    subagentSchedule: 80,
+    subagentTool: 40,
+    subagentAction: 64,
+    subagentName: 40,
+    subagentSoul: 12_000,
+    subagentNote: 300,
+    subagentChoice: 60,
+    subagentText: 2_000,
     /** A project knowledge reference id, a promise and why it is released, what the lead remembers (its text, a
      * decision's reason and source), a person's name, and a question to the owner with its options. */
     knowledgeReference: 20,

package/dist/toolroll-update.d.ts

@@ -137,6 +137,14 @@ export type TableDigest = {
         rows: number;
         found: number;
     };
+    compactedRuns?: {
+        run: number;
+        count: number;
+    }[];
+    summaries?: {
+        run: number;
+        hash: string;
+    }[];
 };
 /** Each saved table's columns, row count and last rowid; the append-only ones hashed (deploy-browser's rehearsal check).
  * Bounded: only the ledger and small tables are read row by row. */

package/dist/toolroll-update.js

@@ -35,7 +35,7 @@ import { processMayBeAlive } from "./process-liveness.js";
 import { assertCodingUpdateStopped, backupCodingCatalog, codingCatalogExists, releaseStaleCodingOwner, removeCodingUpdateGate } from "./coding-update.js";
 import { installLaunchdService, launchdPlist, stopLaunchdService, writeFileDurably } from "./daemon.js";
 import { NAME } from "./names.js";
-import { updateSafeSchema } from "./store.js";
+import { orphanKey, updateSafeSchema, V117_RENAMED_COLUMNS, V117_RENAMED_TABLES } from "./store.js";
 import { isNewer, REGISTRY } from "./releases.js";
 import { markNeverIndex } from "./never-index.js";
 import { readRuntimeUpdateJournal, RUNTIME_PHASES, RUNTIME_UPDATE_STEPS, stagedStartedAt, updaterStartingOf } from "./contracts/update-journal.js";
@@ -322,7 +322,8 @@ export function durableRename(temp, target) {
  * only when every saved value is null, or, with `carried`, when the receiving table gained exactly one receipt under
  * that destination per row holding a value, and as many non-null values per column as the dropped columns held.
  * `receives`: the only rows the table may gain are those receipts. `compacted`: rows may go only into summary rows,
- * whose `sum` grows by exactly as many. `retired`: a removed feature's table, which may go whole. `fromRoutines`: rows
+ * whose `sum` grows by exactly as many. `summarizes`: old summaries stay identical by run key; new ones account for
+ * that run's compacted witnesses, even below the previous maximum key. `retired`: a removed feature's table, which may go whole. `fromRoutines`: rows
  * kept as they were, and the only rows the table may gain are one per saved routine, moved into a scheduled flow (its
  * flow, or its schedule trigger naming that routine) — on only when the routine was approved and running. `moved`:
  * the table may go only when every row it had (or the ones `rows` counts) arrived in `into`: the rows there that
@@ -366,7 +367,7 @@ const HISTORY_RULES = {
     ...Object.fromEntries(Object.entries(CHAT_MOVES).map(([table, moved]) => [table, { moved }])),
     action_ledger: { appendOnly: true }, ledger_seal: { appendOnly: true }, ledger_checkpoint: { appendOnly: true },
     // v114: a finished run whose process witnesses have all exited keeps one summary row in place of them.
-    run_process: { compacted: { into: "run_process_summary", sum: "witnesses" } }, run_process_summary: { appendOnly: true },
+    run_process: { compacted: { into: "run_process_summary", sum: "witnesses" } }, run_process_summary: { summarizes: "run_process" },
     // v114: single-destination delivery columns may be dropped only once their values are legacy receipts.
     notification: { dropped: ["attempts", "last_attempt_at", "last_error", "delivered_at", "receipt", "claim_owner", "claim_expires_at"], carried: { into: "notification_delivery", destination: LEGACY_DESTINATION } },
     notification_delivery: { receives: LEGACY_DESTINATION },
@@ -377,11 +378,36 @@ const HISTORY_RULES = {
     fallback_config: { retired: true }, fallback_cycle: { retired: true }, fallback_transition: { retired: true },
     // v115: each routine becomes one scheduled flow and its schedule trigger.
     flow: { fromRoutines: "flow" }, flow_trigger: { fromRoutines: "trigger" },
+    // v117 (D5): the lead's and the subagents' tables keep every row under their new names (mate_* → lead_*, teammate* →
+    // subagent*); a column renamed in a table that keeps its name keeps its values under the new one.
+    ...Object.fromEntries(Object.entries(V117_RENAMED_TABLES).map(([old, now]) => [old, { moved: { into: now, where: "1" } }])),
+    ...Object.fromEntries(V117_RENAMED_COLUMNS.filter(([table]) => !Object.values(V117_RENAMED_TABLES).includes(table)).map(([table, from, to]) => [table, { renamed: { [from]: to } }])),
 };
 /** The tables a migration may remove whole (v115's removed features). */
 export const RETIRED_TABLES = Object.freeze(Object.keys(HISTORY_RULES).filter(name => HISTORY_RULES[name].retired));
 const tableColumns = (db, name) => db.prepare("PRAGMA table_info(" + quote(name) + ")").all().map(r => String(r["name"]));
 const plainValue = (_, v) => v instanceof Uint8Array ? Buffer.from(v).toString("hex") : typeof v === "bigint" ? String(v) : v;
+const rowHash = (row) => createHash("sha256").update(JSON.stringify(Object.values(row), plainValue)).digest("hex");
+const summaryRows = (db, name, columns) => db.prepare("SELECT " + columns.map(quote).join(",") + " FROM " + quote(name) + " ORDER BY run").iterate();
+/** Keep every saved summary byte-identical. A new key must replace all witnesses saved for that same run. */
+function keptSummaries(db, name, before, source) {
+    const saved = new Map(before?.summaries?.map(row => [row.run, row.hash]));
+    const witnesses = new Map(source?.compactedRuns?.map(row => [row.run, row.count]));
+    const from = HISTORY_RULES[name].summarizes, sum = HISTORY_RULES[from].compacted.sum;
+    const remaining = db.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name=?").get(from)
+        ? db.prepare("SELECT 1 FROM " + quote(from) + " WHERE run = ? LIMIT 1") : undefined;
+    for (const row of summaryRows(db, name, before?.columns ?? tableColumns(db, name))) {
+        const run = Number(row["run"]), hash = saved.get(run);
+        if (hash !== undefined) {
+            if (rowHash(row) !== hash)
+                return false;
+            saved.delete(run);
+        }
+        else if (!witnesses.has(run) || Number(row[sum]) !== witnesses.get(run) || !remaining || remaining.get(run))
+            return false;
+    }
+    return saved.size === 0;
+}
 /** Rows streamed into a sha256, never held together: through a rowid in rowid order, or a WITHOUT ROWID table whole. */
 function rowsHash(db, name, columns, through) {
     const select = "SELECT " + (through === undefined ? "" : 'rowid AS "rowid:", ') + columns.map(quote).join(",") + " FROM " + quote(name);
@@ -423,8 +449,13 @@ export function historySnapshot(db) {
             t.received = receipts(db, name, rule.receives, columns.filter(column => column !== "notification" && column !== "destination"));
         if (rule?.appendOnly || rule?.fromRoutines)
             t.hash = rowsHash(db, name, columns, t.last).hash;
-        if (rule?.compacted)
+        if (rule?.compacted) {
             t.summed = summed(db, rule.compacted);
+            t.compactedRuns = db.prepare("SELECT run, count(*) AS n FROM " + quote(name) + " GROUP BY run ORDER BY run").all()
+                .map(r => ({ run: Number(r["run"]), count: Number(r["n"]) }));
+        }
+        if (rule?.summarizes)
+            t.summaries = [...summaryRows(db, name, columns)].map(row => ({ run: Number(row["run"]), hash: rowHash(row) }));
         if (rule?.fromRoutines)
             t.routines = savedRoutines(db);
         if (rule?.moved)
@@ -500,7 +531,8 @@ export function changedHistory(db, before) {
             return move === undefined || t.moved === undefined || arrived(db, move) - t.moved.found !== t.moved.rows;
         }
         const rule = HISTORY_RULES[t.name], present = new Set(tableColumns(db, t.name));
-        if (t.columns.some(c => !present.has(c) && (!rule?.dropped?.includes(c) || (t.nonNull?.[c] !== 0 && !accounted(rule, t)))))
+        const kept = (c) => present.has(c) || (rule?.renamed?.[c] !== undefined && present.has(rule.renamed[c]));
+        if (t.columns.some(c => !kept(c) && (!rule?.dropped?.includes(c) || (t.nonNull?.[c] !== 0 && !accounted(rule, t)))))
             return true;
         const columns = t.columns.filter(c => present.has(c));
         if (!t.rowid) {
@@ -515,9 +547,13 @@ export function changedHistory(db, before) {
             const after = rowsHash(db, t.name, columns, t.last);
             return after.count !== t.count || after.hash !== t.hash;
         }
+        if (rule?.summarizes)
+            return !keptSummaries(db, t.name, t, before.find(one => one.name === rule.summarizes));
         const r = db.prepare("SELECT count(*) AS n, coalesce(max(rowid),0) AS last FROM " + quote(t.name)).get(), count = Number(r["n"]), last = Number(r["last"]);
         if (rule?.compacted)
-            return count > t.count || last > t.last || t.count - count !== summed(db, rule.compacted) - (t.summed ?? 0);
+            return count > t.count || last > t.last || t.count - count !== summed(db, rule.compacted) - (t.summed ?? 0)
+                // A newly created summary table has no digest of its own; check its keys here too.
+                || (!before.some(one => one.name === rule.compacted.into) && tables.has(rule.compacted.into) && !keptSummaries(db, rule.compacted.into, undefined, t));
         if (rule?.receives) {
             const added = gained.get(t.name)?.count ?? 0;
             return count - t.count !== added || (added > 0 && added !== owed.get(t.name)?.count) || last < t.last;
@@ -531,8 +567,9 @@ async function rehearse(j, system, source) {
     chmodSync(copy, 0o600);
     try {
         let db = new (sqlite().DatabaseSync)(copy, { readOnly: true });
-        // Rows already pointing nowhere before the update are the install's own; only ones the migration makes refuse.
-        const orphans = () => new Set([...db.prepare("PRAGMA foreign_key_check").iterate()].map(row => JSON.stringify(row)));
+        // Rows already pointing nowhere before the update are the install's own; only ones the migration makes refuse. (By
+        // today's table names: a renamed table's old orphan is the same row under its new name, orphanKey.)
+        const orphans = () => new Set([...db.prepare("PRAGMA foreign_key_check").iterate()].map(row => orphanKey(row)));
         const before = historySnapshot(db), orphaned = orphans();
         db.close();
         await system.rehearse(j.to.dist, copy);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolroll",
-  "version": "0.9.55",
+  "version": "0.9.56",
   "description": "A control plane for unattended coding agents — queue tasks, walk away, come back to pull requests. Agents build in leased worktrees, never touch your default branch, and interrupt you only for decisions that need a human.",
   "directories": {
     "doc": "docs"
@@ -17,7 +17,6 @@
     "prepublishOnly": "npm run typecheck && npm run build",
     "nul-scan": "node scripts/nul-scan.mjs",
     "proof-preflight": "node scripts/proof-preflight.mjs",
-    "fixture:v47": "node scripts/derive-v47-fixture.mjs",
     "build:desktop": "node scripts/build-desktop.mjs",
     "certify:restart": "npm run build && node scripts/restart-certification.mjs",
     "certify:launchd": "npm run build && node scripts/launchd-certification.mjs",