@paigy/harness 0.3.36 → 0.3.38

package/dist/main.js

@@ -8680,10 +8680,47 @@ function claudeConversation() {
   if (!envSession("CLAUDE_CODE_SESSION_ID") || process.env.CLAUDE_CODE_CHILD_SESSION) return void 0;
   const dir = envSession("CLAUDE_CONFIG_DIR") ?? join(homedir(), ".claude");
   for (const pid of ancestors()) {
+    let text;
     try {
-      const { sessionId: sessionId2 } = JSON.parse(readFileSync(join(dir, "sessions", `${pid}.json`), "utf8"));
-      return typeof sessionId2 === "string" && sessionId2.trim() ? sessionId2 : void 0;
+      text = readFileSync(join(dir, "sessions", `${pid}.json`), "utf8");
     } catch {
+      continue;
+    }
+    const record = parseSessionRecord(text);
+    if (!record) continue;
+    return typeof record.sessionId === "string" && record.sessionId.trim() ? record.sessionId : void 0;
+  }
+  return void 0;
+}
+function parseSessionRecord(text) {
+  const object = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+  try {
+    return object(JSON.parse(text));
+  } catch {
+  }
+  let depth = 0;
+  let start = -1;
+  let quoted = false;
+  let escaped = false;
+  for (let i = 0; i < text.length; i += 1) {
+    const c = text[i];
+    if (quoted) {
+      if (escaped) escaped = false;
+      else if (c === "\\") escaped = true;
+      else if (c === '"') quoted = false;
+    } else if (c === '"') quoted = true;
+    else if (c === "{") {
+      if (depth === 0) start = i;
+      depth += 1;
+    } else if (c === "}" && depth > 0) {
+      depth -= 1;
+      if (depth === 0) {
+        try {
+          return object(JSON.parse(text.slice(start, i + 1)));
+        } catch {
+          return void 0;
+        }
+      }
     }
   }
   return void 0;
@@ -9923,10 +9960,12 @@ var zodToJsonSchema = (schema, options) => {
 };
 var OPTIONS_MIN = 2;
 var OPTIONS_MAX = 6;
+var OPTION_LABEL_MAX = 50;
+var OPTION_HINT_MAX = 200;
 var OptionSchema = external_exports.object({
   id: external_exports.string(),
   label: external_exports.string(),
-  hint: external_exports.string().max(500).describe("Optional short projection of consequence or action if this option is chosen (e.g. 'Reruns test suite', 'Merges to main').").optional(),
+  hint: external_exports.string().max(500).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   // .describe() flows into the MCP contact JSON schema (zodToJsonSchema), so
   // the constraints below are what an agent reads when deciding to use these.
   html: external_exports.string().max(16384).describe(
@@ -9940,8 +9979,10 @@ var OptionInputSchema = external_exports.object({
   id: external_exports.string().trim().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/).optional().describe(
     `Optional: this option's own id, which answers name it by (selectedOptionIds). Give every option one, or none: without them the options are numbered "1", "2", \u2026 in order.`
   ),
-  label: external_exports.string().trim().min(1).max(1e3),
-  hint: OptionSchema.shape.hint,
+  // SHORT CHOICES (owner, 2026-10-07: "options label should be maybe max 50 characters and the hint 200"):
+  // a label is one choice the person reads, or hears on a call; a hint says its consequence in a line.
+  label: external_exports.string().trim().min(1).max(OPTION_LABEL_MAX, `option_label_too_long: an option's label is at most ${OPTION_LABEL_MAX} characters; say the choice, and put its consequence in the hint.`).describe(`The choice, at most ${OPTION_LABEL_MAX} characters, standing on its own.`),
+  hint: external_exports.string().max(OPTION_HINT_MAX, `option_hint_too_long: an option's hint is at most ${OPTION_HINT_MAX} characters.`).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   htmlPreview: OptionSchema.shape.html,
   imgUrl: OptionSchema.shape.image
 }).strict();
@@ -10043,15 +10084,48 @@ var UpdateInputSchema = external_exports.object({
   message: external_exports.string().trim().min(1).describe(`The one point, at most ${ASK_MAX} characters; the context goes in units.`),
   goalIds: external_exports.array(external_exports.string().uuid()).min(1).max(10).describe("The Goals it is about, each one that exists: the one it is mainly about first."),
   units,
+  // A REPORT KEEPS ITS TAP (#2799, #3260; owner, 2026-10-08, settling #2776: "keep the reports open
+  // until the user acknowledges them"). A report asks nothing, so it opens no Question -- but it
+  // still waits to be acknowledged, and it carries the ONE tap that closes it. Never a decision: the
+  // tap lands as a contribution, the person's own words on the Goal, because there is no Question
+  // for it to answer.
+  //
+  // AND ITS WORDS ARE WRITTEN FOR THIS REPORT (owner, 2026-10-08, Goal 3c12d3c6: "Agent
+  // acknowledgments vary (e.g. 'sounds good, I will test later') instead of always 'got it'"). `Got
+  // it` and `Noted` say only that a card was cleared, where "Sounds good, I'll test later" says the
+  // work was RECEIVED and not verified -- the distinction a session spent an hour recovering from a
+  // call transcript on 2026-10-07, having read "not quite" as a defect report when it meant *not
+  // tested yet*. The words are worth writing because the agent reads them back.
+  //
+  // ONE STRING, NOT A LIST (owner, 2026-10-08 15:47, Goal 31a1e2ac, asked whether an agent should
+  // write up to four of them: "just on the cards, but it should be more like just they should only
+  // get one basically string value that they can enter that replaces got it"). A report has exactly
+  // one way to close, so the only thing an agent writes is what that button SAYS. #3260's 1..6
+  // `options` and this field are one job: the list is deleted, not deprecated (ONE JOB, ONE
+  // MECHANISM). It rides the door as the report's single stored option (`storedOption`,
+  // `apps/api/src/goal/router.ts`), so no reader below the door learns a second shape.
+  reply: external_exports.string().trim().min(1).describe(
+    `What this report's button says instead of "Got it", at most ${OPTION_LABEL_MAX} characters, written in THEIR voice for THIS report ("Sounds good, I'll test later") -- the care you give a question's options, so what they tap tells you whether they verified your work or only received it. One tap sends exactly these words back to you. Words that would CHANGE what happens next are a question, not a reply to a report: it still asks nothing and still owes you no answer. Left out, the button says "Got it", as every card did.`
+  ).optional(),
   userExplicitlyRequested
-}).strict().superRefine((u, ctx) => refuseOverCaps(u.message, u.units, "message", ctx));
+}).strict().superRefine((u, ctx) => {
+  refuseOverCaps(u.message, u.units, "message", ctx);
+  if (u.reply && u.reply.length > OPTION_LABEL_MAX) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      path: ["reply"],
+      params: { refusal: "reply_too_long", length: u.reply.length, cap: OPTION_LABEL_MAX },
+      message: `reply_too_long: the reply is ${u.reply.length} characters; the cap is ${OPTION_LABEL_MAX}. It is a button's words, so say it in a breath.`
+    });
+  }
+});
 var questionFields = {
   question: external_exports.string().trim().min(1).describe(
     `ONE question, in at most ${ASK_MAX} characters, and only what is needed to answer it; the context goes in units. Several questions are several objects, one each: an answer settles the one question it was given, so a person who answers the part of a bundled question that interested them settles nothing and is asked again. Separate questions cost nothing: ANY contact for a person already on a call JOINS that call, so several arrive as one call.`
   ),
   goalId: external_exports.string().uuid().describe("The Goal the question is about, which must exist (create it with manage_goals first). Its answer comes back there."),
   units,
-  options: external_exports.array(OptionInputSchema).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own."),
+  options: external_exports.array(OptionInputSchema).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own, at most 50 characters; a hint, at most 200."),
   // HOW THE OPTIONS ARE ANSWERED, SAID BY THE AGENT (owner, 2026-10-02: "one and many makes sense";
   // brain_prompts.md §1: structured agent questions need no model). The app draws all three.
   pickMode: external_exports.enum(["one", "many", "rank"]).optional().describe(
@@ -10128,6 +10202,8 @@ QUESTIONS: one question per object; several questions are several objects in one
 
 CUT A LONG MESSAGE BEFORE YOU SEND IT: a question, an update's message or an answer is the one point, in at most ${ASK_MAX} characters; everything else it needs goes in 'units', up to ${UNITS_MAX} {title, body} in reading order, one idea each, every title at most ${UNIT_TITLE_MAX} characters and every body at most ${UNIT_BODY_MAX}. The person sees the main text and the titles, and opens a unit to read its body. Over a cap is refused by name (ask_too_long, too_many_units, unit_title_too_long, unit_body_too_long) and nothing is sent.
 
+GIVE A REPORT ITS REPLY: an update takes \`reply\` too, one line the person can tap instead of typing, written in THEIR voice for THAT report ("Sounds good, I'll test later") \u2014 the same care you give a question's options. It is what their button says instead of "Got it", and what they tap is what you read back, which tells you whether they verified your work or only received it. One line, because a report has one way to close, and it may not change what happens next: a reply that would is a question. Nothing is owed on it either way, and a report that writes none offers "Got it".
+
 UPDATES ask nothing, so no answer is owed and none should be awaited. An update reaches the person only when they asked you for it (userExplicitlyRequested), when it answers something they said, or once its Goal is done; any other is recorded as the Goal's progress and nobody is notified. So when the work is finished, mark the Goal done first (manage_goals), then send one update saying what is done and anything they need to do or check. On a Goal whose report card is still open, an update that reaches them is added to that card, with no new push. If the person is already on a call, anything that reaches them joins that call, with no ring.
 
 RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of what is addressed to you (not a history page): \`question\`, a Question you owe (answer it in answers, with its questionId); \`update\`, something new on one of your Goals (a reply, an answer: read it with get_goal); \`instruction\`, a request or note sent to you. \`hasMore\` says more are waiting. Reading acknowledges nothing: once you have handled events, confirm their eventIds with contact({ackEventIds}), and the next batch can come. contact({}) waits up to about 45 seconds for something to arrive; contact({wait:false}) returns at once. It also lists work given to you that nobody has started (\`assigned\`; your first write to it starts it) and your work gone quiet (\`stalled\`).`;
@@ -10171,7 +10247,8 @@ var UpdateGoalSchema = external_exports.object({
 }).strict();
 var changedGoal = external_exports.string().uuid().describe("The Goal to change, as a read shows it.");
 var goalTitle = external_exports.string().trim().min(1).max(80).describe("The Goal's short display name: one to five words, how a person refers to it out loud.");
-var goalOutcome = external_exports.string().trim().min(1).max(1e4).describe("The full desired result. There is no third description field.");
+var GOAL_OUTCOME_MAX = 500;
+var goalOutcome = external_exports.string().trim().min(1).max(GOAL_OUTCOME_MAX, `outcome_too_long: a Goal's outcome is one paragraph, at most ${GOAL_OUTCOME_MAX} characters; split the rest into child Goals (create with parentGoalId).`).describe(`The desired result, one paragraph of at most ${GOAL_OUTCOME_MAX} characters. More than that is more work: create child Goals under it (parentGoalId). There is no third description field.`);
 var CreateChange = external_exports.object({
   kind: external_exports.literal("create"),
   title: goalTitle,
@@ -10197,7 +10274,7 @@ var DependencyChange = external_exports.object({
   goalId: changedGoal,
   dependsOnGoalId: external_exports.string().uuid().describe("The Goal it waits on."),
   action: external_exports.enum(["start", "complete"]).describe("What waits: starting goalId, or completing it."),
-  reason: external_exports.string().trim().min(1).max(2e3).optional().describe("Why, as an explanation, never as policy.")
+  reason: external_exports.string().trim().min(1).max(250).optional().describe("Why, at most 250 characters, as an explanation, never as policy.")
 }).strict();
 var read = { revision: external_exports.number().int().positive().optional() };
 var GoalChangeSchema = external_exports.discriminatedUnion("kind", [
@@ -10221,7 +10298,7 @@ var ManageGoalsSchema = external_exports.object({
 var ManageGoalsToolSchema = external_exports.object({
   changes: external_exports.array(external_exports.discriminatedUnion("kind", [CreateChange, EditChange, StateChange, AssignChange, DeferChange, MoveChange, DependencyChange])).min(1).max(50).describe("The changes, applied in order, each on its own.")
 }).strict().superRefine((v, ctx) => editNames(v.changes, ctx));
-var MANAGE_GOALS_DESCRIPTION = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls; edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
+var MANAGE_GOALS_DESCRIPTION = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls (an outcome is one paragraph, at most 500 characters: split more into child Goals with parentGoalId); edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
 var GetGoalSchema = external_exports.object({
   goalId: external_exports.string().uuid(),
   /** Every entry in full. Without it the read carries the person's words, open questions and your
@@ -10239,7 +10316,7 @@ var SearchToolSchema = external_exports.object({
   goalId: external_exports.string().uuid().optional(),
   limit: external_exports.number().int().min(1).max(20).optional()
 }).strict();
-var SEARCH_DESCRIPTION = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and Answers (found by their Question or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, its Questions' Answers, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (an Answer carries its Question, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
+var SEARCH_DESCRIPTION = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and replies -- the person's answers, acknowledgements and deferrals (type answer; found by their summary, by the question or report they reply to, or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, the replies to its items, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (a reply carries its kind -- answered, acknowledged or deferred -- whether it is closed (a deferral is not), its summary in under ten words, its question or report, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
 var CheckActivitySchema = external_exports.object({}).strict();
 var FEEDBACK_TEXT_MAX = 5e4;
 var SendFeedbackSchema = external_exports.object({
@@ -10302,6 +10379,7 @@ var QuestionChangeSchema = external_exports.union([
   external_exports.object({
     kind: external_exports.literal("create"),
     text: external_exports.string().min(1),
+    summary: external_exports.string().optional(),
     answererId: participant,
     goal: ResultRefSchema.optional(),
     blocks: external_exports.array(external_exports.object({ question: ResultRefSchema }).strict()),
@@ -10352,12 +10430,12 @@ var BrainSearchSchema = external_exports.object({
 }).strict();
 var BrainResultSchema = external_exports.object({
   messages: external_exports.array(BrainMessageSchema),
-  entries: external_exports.array(external_exports.object({ key, sources: external_exports.array(SourceSchema).min(1), goals: external_exports.array(ResultRefSchema) }).strict()),
+  entries: external_exports.array(external_exports.object({ key, sources: external_exports.array(SourceSchema).min(1), goals: external_exports.array(ResultRefSchema), summary: external_exports.string().optional() }).strict()),
   questions: external_exports.array(external_exports.object({ key, entryKeys: external_exports.array(key), change: QuestionChangeSchema }).strict()),
   answers: external_exports.array(external_exports.object({
     question: ResultRefSchema,
     entryKeys: external_exports.array(key).min(1),
-    summary: external_exports.string().min(1),
+    summary: external_exports.string(),
     selectedOptionIds: external_exports.array(external_exports.string().min(1)).optional()
   }).strict()),
   goals: external_exports.array(external_exports.object({ key, entryKeys: external_exports.array(key), change: BrainGoalChangeSchema }).strict()),
@@ -10402,12 +10480,15 @@ var TalkerReplySchema = external_exports.object({
   messages: external_exports.array(external_exports.object({ key: str2, to: str2, text: str2, about: strs2, blocks: str2 }).strict()),
   /** What the call does next: listen, hold (the person asked for a moment) or end (they asked to). */
   then: external_exports.enum(["listen", "hold", "end"]),
-  /** Items the person's words settle: the item's handle, the chosen option IDs, the line handles. */
-  answers: external_exports.array(external_exports.object({ item: str2, options: strs2, lines: strs2 }).strict()),
-  /** The line handles that hold a new instruction from the person. */
+  /** The person's replies to items (replies, owner 2026-10-07): the item's handle, the chosen option
+   *  IDs, the line handles, how they replied in under ten words (keeping any condition), and `defer`:
+   *  "" when their words settle the item, else what a reply that puts it off waits for -- "call" (the
+   *  end of this call), a question's handle (that question's answer) or an ISO time. */
+  replies: external_exports.array(external_exports.object({ item: str2, options: strs2, lines: strs2, summary: str2, defer: str2 }).strict()),
+  /** The line handles that tell the talker how to run this call; they last until it ends and reach no agent. */
   instruction: strs2,
-  /** The line handles that ask for new work, a change to existing work, or a standing rule: the filer
-   *  reads only these (3e). */
+  /** The line handles the filer acts on, and the only ones it reads (3e): new work, a change to existing
+   *  work, feedback on Paigy, anything said to an agent, and any rule meant to outlast the call. */
   file: strs2,
   /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
   need: external_exports.object({ kind: external_exports.enum(["search", "item", "agent", ""]), text: str2 }).strict(),
@@ -10420,8 +10501,9 @@ var TALKER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
 var str3 = external_exports.string();
 var strs3 = external_exports.array(external_exports.string());
 var FilerReplySchema = external_exports.object({
-  /** Which Goals each new line goes on: a line's handle and Goal handles (or keys of new Goals). */
-  filed: external_exports.array(external_exports.object({ line: str3, goals: strs3 }).strict()),
+  /** Which Goals each new line goes on: a line's handle, Goal handles (or keys of new Goals), and what
+   *  the line says in at most ten words. */
+  filed: external_exports.array(external_exports.object({ line: str3, goals: strs3, summary: str3 }).strict()),
   goals: external_exports.array(external_exports.object({
     op: external_exports.enum(["create", "edit", "complete", "cancel", "reopen", "assign", "defer", "move", "block", "unblock"]),
     key: str3,
@@ -10440,6 +10522,7 @@ var FilerReplySchema = external_exports.object({
     key: str3,
     question: str3,
     text: str3,
+    summary: str3,
     to: str3,
     goal: str3,
     options: external_exports.array(external_exports.object({ id: str3, label: str3 }).strict()),
@@ -10453,6 +10536,60 @@ var FilerReplySchema = external_exports.object({
 var FILER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema(FilerReplySchema, { $refStrategy: "none" })
 );
+var ExplainerReplySchema = external_exports.object({
+  /** The explanation, as sentences, spoken in order. */
+  say: external_exports.array(external_exports.string()),
+  /** Questions to an agent about gaps in what it read: the agent's handle and the question. */
+  followUps: external_exports.array(external_exports.object({ to: external_exports.string(), text: external_exports.string() }).strict())
+}).strict();
+var EXPLAINER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema(ExplainerReplySchema, { $refStrategy: "none" })
+);
+var DISTILLER_DEFECTS = [
+  "reasked",
+  // a question put to the person again after they answered it
+  "unsupported",
+  // a fact stated that nothing in the input supports
+  "unsaid",
+  // an agent's answer arrived during the call and was never said
+  "skipped",
+  // an agenda item never put to the person
+  "unsaved",
+  // something the person answered or asked for did not save, was refused or dropped
+  "ignored",
+  // the person asked or said something and was never answered (the critic's ignored_a_question)
+  "promised",
+  // said it did or would do something, and nothing shows it done (the critic's broken_promise)
+  "dropped"
+  // something it had to say never played and was never said later (owner, 2026-10-08, call 65433a9d)
+];
+var DistillerReplySchema = external_exports.object({
+  defects: external_exports.array(external_exports.object({
+    kind: external_exports.enum(DISTILLER_DEFECTS),
+    /** The handles of the lines it shows in. */
+    lines: external_exports.array(external_exports.string()),
+    /** The handle of the record it concerns, or "". */
+    about: external_exports.string(),
+    /** One plain sentence, in words, never handles: it is what the feedback row keeps. */
+    why: external_exports.string()
+  }).strict())
+}).strict();
+var DISTILLER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema(DistillerReplySchema, { $refStrategy: "none" })
+);
+var TIDY_AUDIENCES = ["talker", "filer", "agents"];
+var TidyReplySchema = external_exports.object({
+  lessons: external_exports.array(external_exports.object({
+    lesson: external_exports.string(),
+    op: external_exports.enum(["keep", "revise", "withdraw"]),
+    text: external_exports.string(),
+    for: external_exports.enum([...TIDY_AUDIENCES, ""]),
+    into: external_exports.string()
+  }).strict())
+}).strict();
+var TIDY_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema(TidyReplySchema, { $refStrategy: "none" })
+);
 function entryUnit(entry) {
   if (entry.kind !== "contribution" || !entry.aboutId) return null;
   const plain = entry.content && "plain" in entry.content ? entry.content.plain : null;
@@ -10462,6 +10599,8 @@ function entryUnit(entry) {
 }
 var LIVE_MS = 3 * 6e4;
 var WORKING_MS = 60 * 6e4;
+var WORKING_TIER_MS = 2 * 60 * 6e4;
+var RECENT_TIER_MS = 24 * 60 * 6e4;
 var ContextSchema = external_exports.object({
   title: external_exports.string().min(1).describe("One-line headline of what you need (required, non-empty)."),
   description: external_exports.array(external_exports.string().min(1)).describe(
@@ -10806,6 +10945,10 @@ var AgendaTurnSchema = external_exports.object({
    *  so "who said that" survives the call, and it rides PER TURN because a coalesced call
    *  speaks for several agents — the turn is the only place that knows which. */
   agentId: external_exports.string().optional(),
+  /** ITS QUESTION IS ON THE TABLE (#3292): a talker line about a question the person owes. The walk tells
+   *  the phone (`asking`, so the agenda goes gold and its options show) without treating the line as a
+   *  question turn — the talker owns re-asking and the waits, so `question` stays null. */
+  onTable: external_exports.boolean().optional(),
   select: SelectShapeSchema.optional(),
   options: external_exports.array(OptionSchema.omit({ id: true })).optional(),
   /* `pace` STOOD HERE (#826). A turn could carry seconds and the model chose them. The walk
@@ -10880,9 +11023,16 @@ var InboxItemSchema = external_exports.object({
     /** ITS OPTIONS, WHEN THERE IS SOMETHING TO SEE (owner, 2026-09-25: "Yes, add it"): the options
      *  its need offers, exactly as its own card carries them, present only when one of them has a
      *  preview (`html` or `image`). The call screen opens them from the agenda row, so a preview is
-     *  never re-sent as a second card to be seen mid-call. Words-only options are absent — the bot
-     *  says those, and the list stays small (an `html` is up to 16 KB). */
-    options: external_exports.array(OptionSchema).optional()
+     *  never re-sent as a second card to be seen mid-call. Words-only options are `choices`. */
+    options: external_exports.array(OptionSchema).optional(),
+    /** ITS OPTIONS WHEN THEY ARE WORDS (owner, 2026-10-02, on a call: "whenever there are pre-made
+     *  options … now for a checklist, we should also show them on the screen"; design C, 2026-10-08):
+     *  numbered chips above the call's controls, so a checklist is never only something read aloud. A
+     *  field of its own so `options` keeps meaning "previews": a phone on an older bundle opens the
+     *  preview layout for any `options`, and must see exactly what it did. */
+    choices: external_exports.array(OptionSchema).optional(),
+    /** HOW MANY MAY BE PICKED, beside its `choices`: one, any (`many`) or an order (`rank`). */
+    select: external_exports.enum(["one", "many", "rank"]).optional()
   })).optional(),
   visuals: external_exports.array(VisualSchema).optional(),
   /** The connected agent's name (the single pairing name — user-typed, or the
@@ -11142,7 +11292,7 @@ var ConnectionSummarySchema = external_exports.object({
    *  desktop app while open. Null = never seen; stale = offline. */
   lastSeenAt: external_exports.string().datetime().nullable().optional(),
   /** WORKING, NOT JUST CONNECTED (owner, 2026-09-30): the last time the agent itself acted on one of
-   *  its Goals — took its lease or recorded an operation (`tokens.last_worked_at`). Within
+   *  its Goals — wrote on one or recorded an operation (`tokens.last_worked_at`). Within
    *  `WORKING_MS` it is working; otherwise it is connected but idle. Null = not seen working yet. */
   lastWorkedAt: external_exports.string().datetime().nullable().optional(),
   /** The oldest of its Goals that is `ready` for it — work handed to it that nobody has started.
@@ -11319,7 +11469,11 @@ var QueueItemSchema = external_exports.object({
     from: external_exports.enum(["person", "agent"]),
     said: external_exports.string(),
     at: external_exports.string(),
-    entryId: external_exports.string()
+    entryId: external_exports.string(),
+    /** ITS SUMMARY IN AT MOST TEN WORDS (owner, 2026-10-08: "the same switch to the more summarized sources
+     *  at the work tab top level screen too"): what the talker or filer wrote on the Entry; absent when
+     *  none was. The Work row reads it before `said`. */
+    summary: external_exports.string().optional()
   }).nullable().optional(),
   /** WHEN THIS PERSON LAST PUT A HAND ON IT THEMSELVES (owner, Paigy Goal 16d18f51, 2026-09-30):
    *  the newest Entry on the Goal they wrote, of any kind — a line they added, a reply to a note, an
@@ -11340,7 +11494,7 @@ var QueueItemSchema = external_exports.object({
    *
    *  IT IS THE PAYLOAD'S OWN HASH, NEVER A STAMP ON THE WORK. Nothing here reasons about which
    *  writes change which field — the comparison is over the bytes the phone is holding, so a fact
-   *  the row shows that no `updated_at` moves for (a lease lapsing, a dependency's state, a
+   *  the row shows that no `updated_at` moves for (`active` lapsing, a dependency's state, a
    *  sibling appearing in `childGoalIds`) cannot go unnoticed. Optional because a hand-built
    *  queue (a fixture, the demo) spells none, and a row with no rev is simply always re-sent. */
   rev: external_exports.string().optional()
@@ -11656,17 +11810,43 @@ var CallRecapSchema = external_exports.object({
     title: external_exports.string(),
     owner: external_exports.string(),
     state: external_exports.string(),
+    /** Whether the call put it to the person. An item it carried and never said has no row on the
+     *  review (owner, 2026-10-08: "why do we get the third one when it didn't happen in the call?"). */
+    presented: external_exports.boolean(),
     questions: external_exports.array(external_exports.object({ id: external_exports.string().uuid(), state: external_exports.string(), title: external_exports.string() })),
-    /** `words` is always what they SAID, verbatim — the record, never replaced. `headline` is
-     *  their answer on one line when the call's read wrote one (owner, 2026-10-01: "render them
-     *  summarized like a pre-made option is"), so the row scans like a chosen option and their
-     *  own words stay under it. Absent on every line stored before the read wrote them, and on
-     *  anything that is not an answer. */
+    /** `words` is always what they SAID, verbatim — the record, never replaced. `summary` is what
+     *  the line says in ten words (owner, 2026-10-07): the filer's, or the talker's for the answer it
+     *  gave, so the row scans like a chosen option and their own words stay under it. Absent when
+     *  neither wrote one. */
     /** `about` is the request the line answered (its question), null for words that answered none —
      *  the key the screen groups on, so one question is one row however many times it was answered. */
-    lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), headline: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
+    /** `reply` is the reply the line makes up (an answer, an ok, a deferral), so one reply is one row
+     *  however many lines it cites; `at` is the call lines it came from, so a filed line an answer already
+     *  said is not drawn again (owner, 2026-10-07: "fix them all"); `replyKind` says which replies are answers. */
+    lines: external_exports.array(external_exports.object({
+      entryId: external_exports.string().uuid(),
+      words: external_exports.string(),
+      summary: external_exports.string().optional(),
+      about: external_exports.string().nullable().optional(),
+      reply: external_exports.string().nullable().optional(),
+      replyKind: external_exports.string().nullable().optional(),
+      at: external_exports.array(external_exports.number()).optional()
+    }))
   })),
   unfiled: external_exports.array(external_exports.object({ lineId: external_exports.string().uuid(), words: external_exports.string(), atMs: external_exports.number() })),
+  /** THE PUBLIC TRANSCRIPT — every line said on the call, in the order it was said, and WHO SAID IT
+   *  (owner, 2026-10-08: "the public view should only have the lines and who said them, and that's
+   *  it"; `docs/brain/phase-three/modular.md` build step 3). `speaker` is the role: "user" is the
+   *  person, "agent" an agent speaking, named in `agent`. The timeline's action lines are ours, not
+   *  theirs, and are not here; nor is a sealed line, which the server has no words for. It stands
+   *  BESIDE `topics` and `unfiled` — what the call did with the words — never instead of them. */
+  said: external_exports.array(external_exports.object({
+    lineId: external_exports.string().uuid(),
+    speaker: external_exports.enum(["user", "agent"]),
+    agent: external_exports.object({ id: external_exports.string().nullable(), name: external_exports.string().nullable() }).nullable(),
+    words: external_exports.string(),
+    atMs: external_exports.number()
+  })),
   more: external_exports.object({ lines: external_exports.number(), entries: external_exports.number(), topics: external_exports.number() })
 });
 function sessionSlot(sessionId2) {
@@ -12221,7 +12401,8 @@ var CATALOG = [
     authProbe: ["claude", "auth", "status"],
     loginHint: "Run `claude` once in a terminal and sign in.",
     installCli: "curl -fsSL https://claude.ai/install.sh | bash",
-    installAdapter: "npm install -g @agentclientprotocol/claude-agent-acp"
+    installAdapter: "npm install -g @agentclientprotocol/claude-agent-acp",
+    models: ["claude-3-5-sonnet-20241022", "claude-3-5-haiku-20241022", "claude-3-opus-20240229"]
   },
   {
     name: "codex",
@@ -12231,7 +12412,8 @@ var CATALOG = [
     authProbe: ["codex", "login", "status"],
     loginHint: "Run `codex login` to authenticate.",
     installCli: "curl -fsSL https://chatgpt.com/codex/install.sh | sh",
-    installAdapter: "npm install -g @agentclientprotocol/codex-acp"
+    installAdapter: "npm install -g @agentclientprotocol/codex-acp",
+    models: ["gpt-4o", "gpt-4o-mini", "o1", "o1-mini"]
   },
   {
     name: "agy",
@@ -12241,7 +12423,8 @@ var CATALOG = [
     adapter: "paigy-agy-acp",
     authProbe: ["agy", "help"],
     loginHint: "Install and set up Antigravity (`agy`).",
-    installCli: "curl -fsSL https://antigravity.dev/install.sh | bash"
+    installCli: "curl -fsSL https://antigravity.dev/install.sh | bash",
+    models: ["gemini-1.5-pro", "gemini-1.5-flash", "gemini-2.0-pro-exp"]
   }
 ];
 function probeDirs(home = homedir3()) {
@@ -12277,7 +12460,7 @@ function runProbe(argv) {
 function detect(entry, deps = {}) {
   const find = deps.which ?? which;
   const probe = deps.probe ?? runProbe;
-  const base = { name: entry.name, label: entry.label };
+  const base = { name: entry.name, label: entry.label, models: entry.models };
   const cliPath = find(entry.cli);
   if (!cliPath) return { ...base, status: "missing", hint: `${entry.label} is not installed.`, install: entry.installCli };
   const adapterPath = entry.adapter ? find(entry.adapter) : null;
@@ -12997,10 +13180,14 @@ function localHolderPids(deps = {}) {
     if (!/^\d+\.json$/.test(file)) continue;
     let row;
     try {
-      row = JSON.parse(read3(join6(dir, file)));
+      row = parseSessionRecord(read3(join6(dir, file)));
     } catch {
       continue;
     }
+    if (!row) {
+      deps.unreadable?.(file);
+      continue;
+    }
     const pid = typeof row.pid === "number" ? row.pid : Number(file.slice(0, -5));
     if (typeof row.sessionId !== "string" || !row.sessionId.trim() || !Number.isInteger(pid) || pid <= 0) continue;
     if (!holds(pid, row.procStart, check)) continue;
@@ -13042,10 +13229,14 @@ function localHolders(deps = {}) {
     if (!/^\d+\.json$/.test(file)) continue;
     let row;
     try {
-      row = JSON.parse(read3(join6(dir, file)));
+      row = parseSessionRecord(read3(join6(dir, file)));
     } catch {
       continue;
     }
+    if (!row) {
+      deps.unreadable?.(file);
+      continue;
+    }
     const pid = typeof row.pid === "number" ? row.pid : Number(file.slice(0, -5));
     if (typeof row.sessionId !== "string" || !row.sessionId.trim() || !Number.isInteger(pid) || pid <= 0) continue;
     const slot = sessionSlot(row.sessionId);
@@ -14457,10 +14648,12 @@ var zodToJsonSchema2 = (schema, options) => {
 // ../../packages/schema/dist/index.js
 var OPTIONS_MIN2 = 2;
 var OPTIONS_MAX2 = 6;
+var OPTION_LABEL_MAX2 = 50;
+var OPTION_HINT_MAX2 = 200;
 var OptionSchema2 = external_exports.object({
   id: external_exports.string(),
   label: external_exports.string(),
-  hint: external_exports.string().max(500).describe("Optional short projection of consequence or action if this option is chosen (e.g. 'Reruns test suite', 'Merges to main').").optional(),
+  hint: external_exports.string().max(500).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX2} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   // .describe() flows into the MCP contact JSON schema (zodToJsonSchema), so
   // the constraints below are what an agent reads when deciding to use these.
   html: external_exports.string().max(16384).describe(
@@ -14474,8 +14667,10 @@ var OptionInputSchema2 = external_exports.object({
   id: external_exports.string().trim().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/).optional().describe(
     `Optional: this option's own id, which answers name it by (selectedOptionIds). Give every option one, or none: without them the options are numbered "1", "2", \u2026 in order.`
   ),
-  label: external_exports.string().trim().min(1).max(1e3),
-  hint: OptionSchema2.shape.hint,
+  // SHORT CHOICES (owner, 2026-10-07: "options label should be maybe max 50 characters and the hint 200"):
+  // a label is one choice the person reads, or hears on a call; a hint says its consequence in a line.
+  label: external_exports.string().trim().min(1).max(OPTION_LABEL_MAX2, `option_label_too_long: an option's label is at most ${OPTION_LABEL_MAX2} characters; say the choice, and put its consequence in the hint.`).describe(`The choice, at most ${OPTION_LABEL_MAX2} characters, standing on its own.`),
+  hint: external_exports.string().max(OPTION_HINT_MAX2, `option_hint_too_long: an option's hint is at most ${OPTION_HINT_MAX2} characters.`).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX2} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   htmlPreview: OptionSchema2.shape.html,
   imgUrl: OptionSchema2.shape.image
 }).strict();
@@ -14577,15 +14772,48 @@ var UpdateInputSchema2 = external_exports.object({
   message: external_exports.string().trim().min(1).describe(`The one point, at most ${ASK_MAX2} characters; the context goes in units.`),
   goalIds: external_exports.array(external_exports.string().uuid()).min(1).max(10).describe("The Goals it is about, each one that exists: the one it is mainly about first."),
   units: units2,
+  // A REPORT KEEPS ITS TAP (#2799, #3260; owner, 2026-10-08, settling #2776: "keep the reports open
+  // until the user acknowledges them"). A report asks nothing, so it opens no Question -- but it
+  // still waits to be acknowledged, and it carries the ONE tap that closes it. Never a decision: the
+  // tap lands as a contribution, the person's own words on the Goal, because there is no Question
+  // for it to answer.
+  //
+  // AND ITS WORDS ARE WRITTEN FOR THIS REPORT (owner, 2026-10-08, Goal 3c12d3c6: "Agent
+  // acknowledgments vary (e.g. 'sounds good, I will test later') instead of always 'got it'"). `Got
+  // it` and `Noted` say only that a card was cleared, where "Sounds good, I'll test later" says the
+  // work was RECEIVED and not verified -- the distinction a session spent an hour recovering from a
+  // call transcript on 2026-10-07, having read "not quite" as a defect report when it meant *not
+  // tested yet*. The words are worth writing because the agent reads them back.
+  //
+  // ONE STRING, NOT A LIST (owner, 2026-10-08 15:47, Goal 31a1e2ac, asked whether an agent should
+  // write up to four of them: "just on the cards, but it should be more like just they should only
+  // get one basically string value that they can enter that replaces got it"). A report has exactly
+  // one way to close, so the only thing an agent writes is what that button SAYS. #3260's 1..6
+  // `options` and this field are one job: the list is deleted, not deprecated (ONE JOB, ONE
+  // MECHANISM). It rides the door as the report's single stored option (`storedOption`,
+  // `apps/api/src/goal/router.ts`), so no reader below the door learns a second shape.
+  reply: external_exports.string().trim().min(1).describe(
+    `What this report's button says instead of "Got it", at most ${OPTION_LABEL_MAX2} characters, written in THEIR voice for THIS report ("Sounds good, I'll test later") -- the care you give a question's options, so what they tap tells you whether they verified your work or only received it. One tap sends exactly these words back to you. Words that would CHANGE what happens next are a question, not a reply to a report: it still asks nothing and still owes you no answer. Left out, the button says "Got it", as every card did.`
+  ).optional(),
   userExplicitlyRequested: userExplicitlyRequested2
-}).strict().superRefine((u, ctx) => refuseOverCaps2(u.message, u.units, "message", ctx));
+}).strict().superRefine((u, ctx) => {
+  refuseOverCaps2(u.message, u.units, "message", ctx);
+  if (u.reply && u.reply.length > OPTION_LABEL_MAX2) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      path: ["reply"],
+      params: { refusal: "reply_too_long", length: u.reply.length, cap: OPTION_LABEL_MAX2 },
+      message: `reply_too_long: the reply is ${u.reply.length} characters; the cap is ${OPTION_LABEL_MAX2}. It is a button's words, so say it in a breath.`
+    });
+  }
+});
 var questionFields2 = {
   question: external_exports.string().trim().min(1).describe(
     `ONE question, in at most ${ASK_MAX2} characters, and only what is needed to answer it; the context goes in units. Several questions are several objects, one each: an answer settles the one question it was given, so a person who answers the part of a bundled question that interested them settles nothing and is asked again. Separate questions cost nothing: ANY contact for a person already on a call JOINS that call, so several arrive as one call.`
   ),
   goalId: external_exports.string().uuid().describe("The Goal the question is about, which must exist (create it with manage_goals first). Its answer comes back there."),
   units: units2,
-  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own."),
+  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own, at most 50 characters; a hint, at most 200."),
   // HOW THE OPTIONS ARE ANSWERED, SAID BY THE AGENT (owner, 2026-10-02: "one and many makes sense";
   // brain_prompts.md §1: structured agent questions need no model). The app draws all three.
   pickMode: external_exports.enum(["one", "many", "rank"]).optional().describe(
@@ -14662,6 +14890,8 @@ QUESTIONS: one question per object; several questions are several objects in one
 
 CUT A LONG MESSAGE BEFORE YOU SEND IT: a question, an update's message or an answer is the one point, in at most ${ASK_MAX2} characters; everything else it needs goes in 'units', up to ${UNITS_MAX2} {title, body} in reading order, one idea each, every title at most ${UNIT_TITLE_MAX2} characters and every body at most ${UNIT_BODY_MAX2}. The person sees the main text and the titles, and opens a unit to read its body. Over a cap is refused by name (ask_too_long, too_many_units, unit_title_too_long, unit_body_too_long) and nothing is sent.
 
+GIVE A REPORT ITS REPLY: an update takes \`reply\` too, one line the person can tap instead of typing, written in THEIR voice for THAT report ("Sounds good, I'll test later") \u2014 the same care you give a question's options. It is what their button says instead of "Got it", and what they tap is what you read back, which tells you whether they verified your work or only received it. One line, because a report has one way to close, and it may not change what happens next: a reply that would is a question. Nothing is owed on it either way, and a report that writes none offers "Got it".
+
 UPDATES ask nothing, so no answer is owed and none should be awaited. An update reaches the person only when they asked you for it (userExplicitlyRequested), when it answers something they said, or once its Goal is done; any other is recorded as the Goal's progress and nobody is notified. So when the work is finished, mark the Goal done first (manage_goals), then send one update saying what is done and anything they need to do or check. On a Goal whose report card is still open, an update that reaches them is added to that card, with no new push. If the person is already on a call, anything that reaches them joins that call, with no ring.
 
 RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of what is addressed to you (not a history page): \`question\`, a Question you owe (answer it in answers, with its questionId); \`update\`, something new on one of your Goals (a reply, an answer: read it with get_goal); \`instruction\`, a request or note sent to you. \`hasMore\` says more are waiting. Reading acknowledges nothing: once you have handled events, confirm their eventIds with contact({ackEventIds}), and the next batch can come. contact({}) waits up to about 45 seconds for something to arrive; contact({wait:false}) returns at once. It also lists work given to you that nobody has started (\`assigned\`; your first write to it starts it) and your work gone quiet (\`stalled\`).`;
@@ -14705,7 +14935,8 @@ var UpdateGoalSchema2 = external_exports.object({
 }).strict();
 var changedGoal2 = external_exports.string().uuid().describe("The Goal to change, as a read shows it.");
 var goalTitle2 = external_exports.string().trim().min(1).max(80).describe("The Goal's short display name: one to five words, how a person refers to it out loud.");
-var goalOutcome2 = external_exports.string().trim().min(1).max(1e4).describe("The full desired result. There is no third description field.");
+var GOAL_OUTCOME_MAX2 = 500;
+var goalOutcome2 = external_exports.string().trim().min(1).max(GOAL_OUTCOME_MAX2, `outcome_too_long: a Goal's outcome is one paragraph, at most ${GOAL_OUTCOME_MAX2} characters; split the rest into child Goals (create with parentGoalId).`).describe(`The desired result, one paragraph of at most ${GOAL_OUTCOME_MAX2} characters. More than that is more work: create child Goals under it (parentGoalId). There is no third description field.`);
 var CreateChange2 = external_exports.object({
   kind: external_exports.literal("create"),
   title: goalTitle2,
@@ -14731,7 +14962,7 @@ var DependencyChange2 = external_exports.object({
   goalId: changedGoal2,
   dependsOnGoalId: external_exports.string().uuid().describe("The Goal it waits on."),
   action: external_exports.enum(["start", "complete"]).describe("What waits: starting goalId, or completing it."),
-  reason: external_exports.string().trim().min(1).max(2e3).optional().describe("Why, as an explanation, never as policy.")
+  reason: external_exports.string().trim().min(1).max(250).optional().describe("Why, at most 250 characters, as an explanation, never as policy.")
 }).strict();
 var read2 = { revision: external_exports.number().int().positive().optional() };
 var GoalChangeSchema2 = external_exports.discriminatedUnion("kind", [
@@ -14755,7 +14986,7 @@ var ManageGoalsSchema2 = external_exports.object({
 var ManageGoalsToolSchema2 = external_exports.object({
   changes: external_exports.array(external_exports.discriminatedUnion("kind", [CreateChange2, EditChange2, StateChange2, AssignChange2, DeferChange2, MoveChange2, DependencyChange2])).min(1).max(50).describe("The changes, applied in order, each on its own.")
 }).strict().superRefine((v, ctx) => editNames2(v.changes, ctx));
-var MANAGE_GOALS_DESCRIPTION2 = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls; edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
+var MANAGE_GOALS_DESCRIPTION2 = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls (an outcome is one paragraph, at most 500 characters: split more into child Goals with parentGoalId); edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
 var GetGoalSchema2 = external_exports.object({
   goalId: external_exports.string().uuid(),
   /** Every entry in full. Without it the read carries the person's words, open questions and your
@@ -14773,7 +15004,7 @@ var SearchToolSchema2 = external_exports.object({
   goalId: external_exports.string().uuid().optional(),
   limit: external_exports.number().int().min(1).max(20).optional()
 }).strict();
-var SEARCH_DESCRIPTION2 = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and Answers (found by their Question or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, its Questions' Answers, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (an Answer carries its Question, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
+var SEARCH_DESCRIPTION2 = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and replies -- the person's answers, acknowledgements and deferrals (type answer; found by their summary, by the question or report they reply to, or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, the replies to its items, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (a reply carries its kind -- answered, acknowledged or deferred -- whether it is closed (a deferral is not), its summary in under ten words, its question or report, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
 var CheckActivitySchema2 = external_exports.object({}).strict();
 var FEEDBACK_TEXT_MAX2 = 5e4;
 var SendFeedbackSchema2 = external_exports.object({
@@ -14836,6 +15067,7 @@ var QuestionChangeSchema2 = external_exports.union([
   external_exports.object({
     kind: external_exports.literal("create"),
     text: external_exports.string().min(1),
+    summary: external_exports.string().optional(),
     answererId: participant2,
     goal: ResultRefSchema2.optional(),
     blocks: external_exports.array(external_exports.object({ question: ResultRefSchema2 }).strict()),
@@ -14886,12 +15118,12 @@ var BrainSearchSchema2 = external_exports.object({
 }).strict();
 var BrainResultSchema2 = external_exports.object({
   messages: external_exports.array(BrainMessageSchema2),
-  entries: external_exports.array(external_exports.object({ key: key2, sources: external_exports.array(SourceSchema2).min(1), goals: external_exports.array(ResultRefSchema2) }).strict()),
+  entries: external_exports.array(external_exports.object({ key: key2, sources: external_exports.array(SourceSchema2).min(1), goals: external_exports.array(ResultRefSchema2), summary: external_exports.string().optional() }).strict()),
   questions: external_exports.array(external_exports.object({ key: key2, entryKeys: external_exports.array(key2), change: QuestionChangeSchema2 }).strict()),
   answers: external_exports.array(external_exports.object({
     question: ResultRefSchema2,
     entryKeys: external_exports.array(key2).min(1),
-    summary: external_exports.string().min(1),
+    summary: external_exports.string(),
     selectedOptionIds: external_exports.array(external_exports.string().min(1)).optional()
   }).strict()),
   goals: external_exports.array(external_exports.object({ key: key2, entryKeys: external_exports.array(key2), change: BrainGoalChangeSchema2 }).strict()),
@@ -14936,12 +15168,15 @@ var TalkerReplySchema2 = external_exports.object({
   messages: external_exports.array(external_exports.object({ key: str22, to: str22, text: str22, about: strs22, blocks: str22 }).strict()),
   /** What the call does next: listen, hold (the person asked for a moment) or end (they asked to). */
   then: external_exports.enum(["listen", "hold", "end"]),
-  /** Items the person's words settle: the item's handle, the chosen option IDs, the line handles. */
-  answers: external_exports.array(external_exports.object({ item: str22, options: strs22, lines: strs22 }).strict()),
-  /** The line handles that hold a new instruction from the person. */
+  /** The person's replies to items (replies, owner 2026-10-07): the item's handle, the chosen option
+   *  IDs, the line handles, how they replied in under ten words (keeping any condition), and `defer`:
+   *  "" when their words settle the item, else what a reply that puts it off waits for -- "call" (the
+   *  end of this call), a question's handle (that question's answer) or an ISO time. */
+  replies: external_exports.array(external_exports.object({ item: str22, options: strs22, lines: strs22, summary: str22, defer: str22 }).strict()),
+  /** The line handles that tell the talker how to run this call; they last until it ends and reach no agent. */
   instruction: strs22,
-  /** The line handles that ask for new work, a change to existing work, or a standing rule: the filer
-   *  reads only these (3e). */
+  /** The line handles the filer acts on, and the only ones it reads (3e): new work, a change to existing
+   *  work, feedback on Paigy, anything said to an agent, and any rule meant to outlast the call. */
   file: strs22,
   /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
   need: external_exports.object({ kind: external_exports.enum(["search", "item", "agent", ""]), text: str22 }).strict(),
@@ -14954,8 +15189,9 @@ var TALKER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
 var str32 = external_exports.string();
 var strs32 = external_exports.array(external_exports.string());
 var FilerReplySchema2 = external_exports.object({
-  /** Which Goals each new line goes on: a line's handle and Goal handles (or keys of new Goals). */
-  filed: external_exports.array(external_exports.object({ line: str32, goals: strs32 }).strict()),
+  /** Which Goals each new line goes on: a line's handle, Goal handles (or keys of new Goals), and what
+   *  the line says in at most ten words. */
+  filed: external_exports.array(external_exports.object({ line: str32, goals: strs32, summary: str32 }).strict()),
   goals: external_exports.array(external_exports.object({
     op: external_exports.enum(["create", "edit", "complete", "cancel", "reopen", "assign", "defer", "move", "block", "unblock"]),
     key: str32,
@@ -14974,6 +15210,7 @@ var FilerReplySchema2 = external_exports.object({
     key: str32,
     question: str32,
     text: str32,
+    summary: str32,
     to: str32,
     goal: str32,
     options: external_exports.array(external_exports.object({ id: str32, label: str32 }).strict()),
@@ -14987,6 +15224,60 @@ var FilerReplySchema2 = external_exports.object({
 var FILER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema2(FilerReplySchema2, { $refStrategy: "none" })
 );
+var ExplainerReplySchema2 = external_exports.object({
+  /** The explanation, as sentences, spoken in order. */
+  say: external_exports.array(external_exports.string()),
+  /** Questions to an agent about gaps in what it read: the agent's handle and the question. */
+  followUps: external_exports.array(external_exports.object({ to: external_exports.string(), text: external_exports.string() }).strict())
+}).strict();
+var EXPLAINER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(ExplainerReplySchema2, { $refStrategy: "none" })
+);
+var DISTILLER_DEFECTS2 = [
+  "reasked",
+  // a question put to the person again after they answered it
+  "unsupported",
+  // a fact stated that nothing in the input supports
+  "unsaid",
+  // an agent's answer arrived during the call and was never said
+  "skipped",
+  // an agenda item never put to the person
+  "unsaved",
+  // something the person answered or asked for did not save, was refused or dropped
+  "ignored",
+  // the person asked or said something and was never answered (the critic's ignored_a_question)
+  "promised",
+  // said it did or would do something, and nothing shows it done (the critic's broken_promise)
+  "dropped"
+  // something it had to say never played and was never said later (owner, 2026-10-08, call 65433a9d)
+];
+var DistillerReplySchema2 = external_exports.object({
+  defects: external_exports.array(external_exports.object({
+    kind: external_exports.enum(DISTILLER_DEFECTS2),
+    /** The handles of the lines it shows in. */
+    lines: external_exports.array(external_exports.string()),
+    /** The handle of the record it concerns, or "". */
+    about: external_exports.string(),
+    /** One plain sentence, in words, never handles: it is what the feedback row keeps. */
+    why: external_exports.string()
+  }).strict())
+}).strict();
+var DISTILLER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(DistillerReplySchema2, { $refStrategy: "none" })
+);
+var TIDY_AUDIENCES2 = ["talker", "filer", "agents"];
+var TidyReplySchema2 = external_exports.object({
+  lessons: external_exports.array(external_exports.object({
+    lesson: external_exports.string(),
+    op: external_exports.enum(["keep", "revise", "withdraw"]),
+    text: external_exports.string(),
+    for: external_exports.enum([...TIDY_AUDIENCES2, ""]),
+    into: external_exports.string()
+  }).strict())
+}).strict();
+var TIDY_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(TidyReplySchema2, { $refStrategy: "none" })
+);
 function entryWords(entry) {
   const content = entry.content;
   if (content && "sealed" in content) return "";
@@ -15006,6 +15297,8 @@ function entryWords(entry) {
 }
 var LIVE_MS2 = 3 * 6e4;
 var WORKING_MS2 = 60 * 6e4;
+var WORKING_TIER_MS2 = 2 * 60 * 6e4;
+var RECENT_TIER_MS2 = 24 * 60 * 6e4;
 var ContextSchema2 = external_exports.object({
   title: external_exports.string().min(1).describe("One-line headline of what you need (required, non-empty)."),
   description: external_exports.array(external_exports.string().min(1)).describe(
@@ -15350,6 +15643,10 @@ var AgendaTurnSchema2 = external_exports.object({
    *  so "who said that" survives the call, and it rides PER TURN because a coalesced call
    *  speaks for several agents — the turn is the only place that knows which. */
   agentId: external_exports.string().optional(),
+  /** ITS QUESTION IS ON THE TABLE (#3292): a talker line about a question the person owes. The walk tells
+   *  the phone (`asking`, so the agenda goes gold and its options show) without treating the line as a
+   *  question turn — the talker owns re-asking and the waits, so `question` stays null. */
+  onTable: external_exports.boolean().optional(),
   select: SelectShapeSchema2.optional(),
   options: external_exports.array(OptionSchema2.omit({ id: true })).optional(),
   /* `pace` STOOD HERE (#826). A turn could carry seconds and the model chose them. The walk
@@ -15424,9 +15721,16 @@ var InboxItemSchema2 = external_exports.object({
     /** ITS OPTIONS, WHEN THERE IS SOMETHING TO SEE (owner, 2026-09-25: "Yes, add it"): the options
      *  its need offers, exactly as its own card carries them, present only when one of them has a
      *  preview (`html` or `image`). The call screen opens them from the agenda row, so a preview is
-     *  never re-sent as a second card to be seen mid-call. Words-only options are absent — the bot
-     *  says those, and the list stays small (an `html` is up to 16 KB). */
-    options: external_exports.array(OptionSchema2).optional()
+     *  never re-sent as a second card to be seen mid-call. Words-only options are `choices`. */
+    options: external_exports.array(OptionSchema2).optional(),
+    /** ITS OPTIONS WHEN THEY ARE WORDS (owner, 2026-10-02, on a call: "whenever there are pre-made
+     *  options … now for a checklist, we should also show them on the screen"; design C, 2026-10-08):
+     *  numbered chips above the call's controls, so a checklist is never only something read aloud. A
+     *  field of its own so `options` keeps meaning "previews": a phone on an older bundle opens the
+     *  preview layout for any `options`, and must see exactly what it did. */
+    choices: external_exports.array(OptionSchema2).optional(),
+    /** HOW MANY MAY BE PICKED, beside its `choices`: one, any (`many`) or an order (`rank`). */
+    select: external_exports.enum(["one", "many", "rank"]).optional()
   })).optional(),
   visuals: external_exports.array(VisualSchema2).optional(),
   /** The connected agent's name (the single pairing name — user-typed, or the
@@ -15686,7 +15990,7 @@ var ConnectionSummarySchema2 = external_exports.object({
    *  desktop app while open. Null = never seen; stale = offline. */
   lastSeenAt: external_exports.string().datetime().nullable().optional(),
   /** WORKING, NOT JUST CONNECTED (owner, 2026-09-30): the last time the agent itself acted on one of
-   *  its Goals — took its lease or recorded an operation (`tokens.last_worked_at`). Within
+   *  its Goals — wrote on one or recorded an operation (`tokens.last_worked_at`). Within
    *  `WORKING_MS` it is working; otherwise it is connected but idle. Null = not seen working yet. */
   lastWorkedAt: external_exports.string().datetime().nullable().optional(),
   /** The oldest of its Goals that is `ready` for it — work handed to it that nobody has started.
@@ -15863,7 +16167,11 @@ var QueueItemSchema2 = external_exports.object({
     from: external_exports.enum(["person", "agent"]),
     said: external_exports.string(),
     at: external_exports.string(),
-    entryId: external_exports.string()
+    entryId: external_exports.string(),
+    /** ITS SUMMARY IN AT MOST TEN WORDS (owner, 2026-10-08: "the same switch to the more summarized sources
+     *  at the work tab top level screen too"): what the talker or filer wrote on the Entry; absent when
+     *  none was. The Work row reads it before `said`. */
+    summary: external_exports.string().optional()
   }).nullable().optional(),
   /** WHEN THIS PERSON LAST PUT A HAND ON IT THEMSELVES (owner, Paigy Goal 16d18f51, 2026-09-30):
    *  the newest Entry on the Goal they wrote, of any kind — a line they added, a reply to a note, an
@@ -15884,7 +16192,7 @@ var QueueItemSchema2 = external_exports.object({
    *
    *  IT IS THE PAYLOAD'S OWN HASH, NEVER A STAMP ON THE WORK. Nothing here reasons about which
    *  writes change which field — the comparison is over the bytes the phone is holding, so a fact
-   *  the row shows that no `updated_at` moves for (a lease lapsing, a dependency's state, a
+   *  the row shows that no `updated_at` moves for (`active` lapsing, a dependency's state, a
    *  sibling appearing in `childGoalIds`) cannot go unnoticed. Optional because a hand-built
    *  queue (a fixture, the demo) spells none, and a row with no rev is simply always re-sent. */
   rev: external_exports.string().optional()
@@ -16198,17 +16506,43 @@ var CallRecapSchema2 = external_exports.object({
     title: external_exports.string(),
     owner: external_exports.string(),
     state: external_exports.string(),
+    /** Whether the call put it to the person. An item it carried and never said has no row on the
+     *  review (owner, 2026-10-08: "why do we get the third one when it didn't happen in the call?"). */
+    presented: external_exports.boolean(),
     questions: external_exports.array(external_exports.object({ id: external_exports.string().uuid(), state: external_exports.string(), title: external_exports.string() })),
-    /** `words` is always what they SAID, verbatim — the record, never replaced. `headline` is
-     *  their answer on one line when the call's read wrote one (owner, 2026-10-01: "render them
-     *  summarized like a pre-made option is"), so the row scans like a chosen option and their
-     *  own words stay under it. Absent on every line stored before the read wrote them, and on
-     *  anything that is not an answer. */
+    /** `words` is always what they SAID, verbatim — the record, never replaced. `summary` is what
+     *  the line says in ten words (owner, 2026-10-07): the filer's, or the talker's for the answer it
+     *  gave, so the row scans like a chosen option and their own words stay under it. Absent when
+     *  neither wrote one. */
     /** `about` is the request the line answered (its question), null for words that answered none —
      *  the key the screen groups on, so one question is one row however many times it was answered. */
-    lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), headline: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
+    /** `reply` is the reply the line makes up (an answer, an ok, a deferral), so one reply is one row
+     *  however many lines it cites; `at` is the call lines it came from, so a filed line an answer already
+     *  said is not drawn again (owner, 2026-10-07: "fix them all"); `replyKind` says which replies are answers. */
+    lines: external_exports.array(external_exports.object({
+      entryId: external_exports.string().uuid(),
+      words: external_exports.string(),
+      summary: external_exports.string().optional(),
+      about: external_exports.string().nullable().optional(),
+      reply: external_exports.string().nullable().optional(),
+      replyKind: external_exports.string().nullable().optional(),
+      at: external_exports.array(external_exports.number()).optional()
+    }))
   })),
   unfiled: external_exports.array(external_exports.object({ lineId: external_exports.string().uuid(), words: external_exports.string(), atMs: external_exports.number() })),
+  /** THE PUBLIC TRANSCRIPT — every line said on the call, in the order it was said, and WHO SAID IT
+   *  (owner, 2026-10-08: "the public view should only have the lines and who said them, and that's
+   *  it"; `docs/brain/phase-three/modular.md` build step 3). `speaker` is the role: "user" is the
+   *  person, "agent" an agent speaking, named in `agent`. The timeline's action lines are ours, not
+   *  theirs, and are not here; nor is a sealed line, which the server has no words for. It stands
+   *  BESIDE `topics` and `unfiled` — what the call did with the words — never instead of them. */
+  said: external_exports.array(external_exports.object({
+    lineId: external_exports.string().uuid(),
+    speaker: external_exports.enum(["user", "agent"]),
+    agent: external_exports.object({ id: external_exports.string().nullable(), name: external_exports.string().nullable() }).nullable(),
+    words: external_exports.string(),
+    atMs: external_exports.number()
+  })),
   more: external_exports.object({ lines: external_exports.number(), entries: external_exports.number(), topics: external_exports.number() })
 });
 
@@ -16610,7 +16944,8 @@ function startSession(opts) {
   if (!existsSync4(cwd)) {
     queueMicrotask(() => opts.onEvent({ kind: "error", message: `workspace does not exist: ${cwd}` }));
   }
-  const codexConfig = opts.harness === "codex" ? JSON.parse(process.env.CODEX_CONFIG || "{}") : null;
+  let codexConfig = opts.harness === "codex" ? JSON.parse(process.env.CODEX_CONFIG || "{}") : null;
+  if (opts.model && opts.harness === "codex") codexConfig = { ...codexConfig, model: opts.model };
   if (codexConfig) {
     const key3 = "mcp_servers.paigy.env_vars";
     const configPath = join9(process.env.CODEX_HOME || join9(homedir9(), ".codex"), "config.toml");
@@ -16636,6 +16971,8 @@ function startSession(opts) {
       PATH: [process.env.PATH, ...probeDirs()].filter(Boolean).join(delimiter3),
       ...opts.token ? { PAIGY_TOKEN: opts.token } : {},
       ...opts.instance ? { PAIGY_INSTANCE_ID: opts.instance } : {},
+      ...opts.model && opts.harness === "claude" ? { CLAUDE_MODEL_CONFIG: JSON.stringify({ provider: "anthropic", model: opts.model }) } : {},
+      ...opts.model && opts.harness === "agy" ? { AGY_MODEL_CONFIG: JSON.stringify({ model: opts.model }) } : {},
       ...codexConfig ? { CODEX_CONFIG: JSON.stringify(codexConfig) } : {},
       ...opts.session ?? opts.resume ? { PAIGY_SESSION_ID: opts.session ?? opts.resume } : {},
       // A PUMP DRIVES THIS PROCESS (2026-09-22, #2265): every run `runHarness` starts has the
@@ -17604,7 +17941,7 @@ var claimedRun = (sessionId2) => {
   const slot = sessionSlot(sessionId2);
   return { slot, key: runKey(slot) };
 };
-var launchRun = (spec) => ({ session: spec.sessionId });
+var launchRun = (spec) => ({ session: spec.sessionId, model: spec.model });
 var BOUND_ELSEWHERE_MS = 10 * 6e4;
 var boundElsewhere = /* @__PURE__ */ new Map();
 var BOUND_SKIP = "is bound to the session it was paired in, which this host cannot name \u2014 run `paigy-harness handoff` as it, in its folder, to record it";
@@ -17713,7 +18050,7 @@ function startHost(opts) {
     });
     void heartbeat({
       version: VERSION,
-      harnesses: detectAll().map((a) => ({ name: a.name, label: a.label, status: a.status })),
+      harnesses: detectAll().map((a) => ({ name: a.name, label: a.label, status: a.status, models: a.models })),
       workspaces: listWorkspaces(opts.wsDeps),
       // The repos inside them, so a session started for work on one opens IN it (Goal 26982211).
       repos: listRepos(opts.wsDeps)
@@ -17805,9 +18142,14 @@ function startHost(opts) {
   let lastPresence = /* @__PURE__ */ new Map();
   async function evidence() {
     const presence = await presenceMap();
-    lastHolders = localHolders();
+    lastHolders = localHolders({ unreadable: (file) => {
+      if (unreadable.has(file)) return;
+      unreadable.add(file);
+      opts.log(`\u25CC session record ${file} has no object in it \u2014 the process it names reads as not running here`);
+    } });
     return { presence, holders: lastHolders };
   }
+  const unreadable = /* @__PURE__ */ new Set();
   let lastHolders = /* @__PURE__ */ new Map();
   async function wakeSlot(slot, { presence, holders }, cause = "sweep") {
     {