@paigy/harness 0.3.29 → 0.3.31

package/dist/main.js

@@ -9975,7 +9975,20 @@ var AskInputSchema = external_exports.object({
   ask: external_exports.string().trim().min(1).max(1e4).describe(
     "ONE question, and only what is needed to answer it. Several questions are several asks in the array, one each: an answer settles the one ask it was given in the shape that ask declares, so a person who answers the part of a bundled ask that interested them settles nothing and is asked again. Paigy reads every ask once and takes a bundled one apart into its own cards anyway \u2014 each question a Question on the one Goal the ask lands on, never a Goal of its own \u2014 but the words it splits are its reading, not yours. News, progress and findings are their own contact; ANY contact for a person already on a call JOINS that call, whatever channel you asked for, so several arrive as one call."
   ),
-  options: external_exports.array(OptionInputSchema).min(1).max(6).optional()
+  options: external_exports.array(OptionInputSchema).min(1).max(6).optional(),
+  // A CHECKLIST WHEN THE CHOICES ARE INDEPENDENT (owner, 2026-10-02 01:44 UTC: "bring back the
+  // checklist mode of answering"). The answer shape was taken off this surface with the wire form
+  // (#575) on the promise that Paigy would derive it, and the Goal-scoped contact that replaced it
+  // only ever sends pick-one or words (`goal/intake.ts` `answerOf`): three independent fixes went out
+  // as "All three / 1 and 3 only / Just log it", which the person could not read without the text and
+  // could not answer as the ticks he wanted. "many" is the one shape an agent knows and the read does
+  // not: whether its own options exclude each other.
+  select: external_exports.enum(["one", "many"]).optional().describe(
+    'How the options are answered: "one" (default) to pick one, "many" to tick any number of them. Use "many" when the options are independent things they may want several of \u2014 never combinations of them like "all three" or "1 and 3". Ignored without options.'
+  ),
+  answers: external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/).optional().describe(
+    "Your reply answers a question the person asked you: the id the conversation shows for it (8 characters or whole). Their question closes with this reply as its answer, and any decision of yours it was holding back goes back to them. Needs parentId: the Goal the question is on. The reply is sent to them as it is; to also ask something new, send that as its own ask."
+  )
 }).strict();
 var StartContactSchema = external_exports.object({
   asks: external_exports.array(AskInputSchema).min(1).describe("The questions to pose, one per object. An ask with a parentId is filed on that Goal as it is; only an ask naming no Goal is placed in the tree by Paigy."),
@@ -9984,7 +9997,7 @@ var StartContactSchema = external_exports.object({
 }).strict();
 var ContactSchema = external_exports.union([StartContactSchema, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict()]);
 var CONTACT_SCHEMA = { type: "object", ...mcpInputSchema(ContactSchema) };
-var CONTACT_DESCRIPTION = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none is placed in the person's tree by Paigy. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. A bundled ask is taken apart into its own cards by Paigy's one intake read, every one on the Goal the ask lands on; separate pieces of work are separate asks. An ask with no options that is not blocking is a report, and a report is an UPDATE, never a claim on them: it reaches them and is listed apart from what waits on them, so no answer is owed and none should be awaited. On a Goal whose report card is still open it is added to that card, with no new push; one that only says where your work stands while under way is recorded as the Goal's progress, not sent (the result says so). Send options (or waiting:'hard') when you actually need an answer. If the person is already on a call, your contact joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.";
+var CONTACT_DESCRIPTION = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'select', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none is placed in the person's tree by Paigy. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. A bundled ask is taken apart into its own cards by Paigy's one intake read, every one on the Goal the ask lands on; separate pieces of work are separate asks. An ask with no options that is not blocking is a report, and a report is an UPDATE, never a claim on them: it reaches them and is listed apart from what waits on them, so no answer is owed and none should be awaited. On a Goal whose report card is still open it is added to that card, with no new push; one that only says where your work stands while under way is recorded as the Goal's progress, not sent (the result says so). Send options (or waiting:'hard') when you actually need an answer. Each option's label must stand on its own \u2014 the person may see only the labels \u2014 so never a label that points into your text ('All three', 'Option 2', '1 and 3 only'); when the options are independent and they may want several, pass select:'many' and they get a checklist. If the person is already on a call, your contact joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.";
 var CreateGoalSchema = external_exports.object({
   outcome: external_exports.string().trim().min(1).max(1e4),
   /** The work's NAME (#2115) — one to five words, how a person refers to it out loud ("the night
@@ -10040,11 +10053,11 @@ var GetGoalSchema = external_exports.object({
   history: external_exports.boolean().optional(),
   /** WHEN A READ HAS CONFUSED YOU. Adds `diagnosis`: every reader that already answers a question
    *  about this work, each answer attributed to the reader that gave it, and every disagreement
-   *  between two of them named. Off by default; `apps/api/src/goal/diagnose-design.md`. */
+   *  between two of them named. Off by default; `docs/model/goal/diagnose-design.md`. */
   diagnose: external_exports.boolean().optional()
 }).strict();
-var GET_GOAL_DESCRIPTION = "Read one Goal without claiming it: its outcome, state, revision, progress, blockers, the conversation on it (each question with its options and what was decided), `next`, the one step to take, and `more`, where to read further. The conversation carries everything the person said, every open question and your newest entry; your older entries are left out and counted \u2014 history: true reads every entry in full. Another account's Goals, and another agent's Goal that is not below one of yours, are not disclosed.\n\ndiagnose: true is for when a read has CONFUSED you \u2014 not for the working loop. It adds `diagnosis`, which asks every reader that already answers a question about your work and NAMES the reader behind every value, so you never guess which of two places to look: what state your work is really in (the stored `goals.state` beside the derived `goal_execution_state`, which can differ); whether anything is armed to ring and when (`ladder_candidates`, with the ladder's own last decision); whether a wake fired for you and what it did (durable `wake.*` events, beside when your process was last heard from); and what has reached you (`list_waiting` \u2014 review flags, unstarted work, open questions, the person's newest words). Read `diagnosis.disagreements` FIRST: each one is two readers giving different values for the same fact, with both values and both sources, and it never chooses between them \u2014 that is yours to do, from the Goal's own history. `diagnosis.looked` names every reader asked, including any that could not answer, so an empty answer is never confused with a broken one.";
-var UPDATE_GOAL_DESCRIPTION = `Update an owned Goal at an exact revision. State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. title is the work's name in one to five words, as a person would refer to it out loud (it is spoken on a call and heads every list); null clears it. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision. dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. state: done means the work was accomplished, and it can be reopened: when the person says it is not done ("it's not working"), set state: active on that same Goal instead of starting a new one; its parent reopens with it. state: done while children are still open records your part as done: the Goal waits and closes by itself when its last open child closes. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
+var GET_GOAL_DESCRIPTION = "Read one Goal without claiming it: its outcome, state, revision, progress, blockers, the conversation on it (each question with its options and what was decided), `next`, the one step to take, and `more`, where to read further. A question in that conversation reads `open` (nothing yet), `answered` (a choice was made, and `answer` carries it), `replied` (they said something and the read settled the question on their words \u2014 NO option of yours was chosen, and the words are the reply line beside it, so read that before you act), or `closed`. The conversation carries everything the person said, every open question and your newest entry; your older entries are left out and counted \u2014 history: true reads every entry in full. Another account's Goals, and another agent's Goal that is not below one of yours, are not disclosed.\n\ndiagnose: true is for when a read has CONFUSED you \u2014 not for the working loop. It adds `diagnosis`, which asks every reader that already answers a question about your work and NAMES the reader behind every value, so you never guess which of two places to look: what state your work is really in (the stored `goals.state` beside the derived `goal_execution_state`, which can differ); whether anything is armed to ring and when (`ladder_candidates`, with the ladder's own last decision); whether a wake fired for you and what it did (durable `wake.*` events, beside when your process was last heard from); and what has reached you (`list_waiting` \u2014 review flags, unstarted work, open questions, the person's newest words). Read `diagnosis.disagreements` FIRST: each one is two readers giving different values for the same fact, with both values and both sources, and it never chooses between them \u2014 that is yours to do, from the Goal's own history. `diagnosis.looked` names every reader asked, including any that could not answer, so an empty answer is never confused with a broken one.";
+var UPDATE_GOAL_DESCRIPTION = `Update an owned Goal at an exact revision. State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. A CONTACT ON THIS GOAL MOVES ITS REVISION: a question filed on a Goal is a change to it, so an update prepared before a contact and sent after it is refused as stale (409 goal_revision_conflict) \u2014 re-read the Goal, then write. title is the work's name in one to five words, as a person would refer to it out loud (it is spoken on a call and heads every list); null clears it. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision. dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. state: done means the work was accomplished, and it can be reopened: when the person says it is not done ("it's not working"), set state: active on that same Goal instead of starting a new one; its parent reopens with it. state: done while children are still open records your part as done: the Goal waits and closes by itself when its last open child closes. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
 var CLAIM_GOAL_DESCRIPTION = "Claim the oldest runnable or review-pending Goal you own, or pass goalId to claim that Goal. Another agent's Goal that has gone quiet for 3 days (check_replies lists them as stalledOthers) is taken over when you claim it, and becomes yours to finish or cancel. Returns the Goal as get_goal reads it, and creates or renews the execution lease.";
 var CHECK_REPLIES_DESCRIPTION = "What is waiting for you: your open Deliveries (a request the user started toward you, a handoff), one row each with its Goals, how many decisions are still open, and the newest words in brief; `assigned`, your Goals nobody has started yet, however they became yours (claim_goal({goalId}) starts one); and `review`, your Goals with something new on them \u2014 the user's answers and notes are Entries on the Goal, not Deliveries. A pure read with no arguments: nothing is consumed, acknowledged or claimed by reading it, so call it on startup, after a long wait, or whenever you want to know what is outstanding. To act on one, claim its Goal (claim_goal) or reread a Delivery in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true clears the Goal from `review` and closes the Deliveries addressed to you on it.";
 var CheckRepliesSchema = external_exports.object({}).strict();
@@ -10058,6 +10071,7 @@ var AGENT_TOOLS = [
 ];
 var AGENT_TOOL_NAMES = AGENT_TOOLS.map((t) => t.name);
 var LIVE_MS = 3 * 6e4;
+var WORKING_MS = 30 * 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(
@@ -10128,7 +10142,7 @@ var AttentionSchema = external_exports.object({
   points: external_exports.array(external_exports.string()).nullable(),
   /** Whether the ask blocks the sender — what lets arbitration escalate it on silence. */
   blocking: external_exports.boolean(),
-  /** Reserved (MODEL.md lists it): a response deadline. No row column yet — a later Phase 2
+  /** Reserved (docs/model/model.md lists it): a response deadline. No row column yet — a later Phase 2
    *  slice wires it; optional so today's rows/callers project cleanly. */
   deadline: external_exports.string().datetime().nullable().optional()
 });
@@ -10179,7 +10193,7 @@ var NotifyRequestFields = external_exports.object({
    *  derive agent-side before sealing, so the server only ever shapes plaintext). */
   // 10k, not a sentence budget. What the human hears is bounded by the BROKER — it splits
   // the ask into topics and gives each one at most three sentences and one question
-  // (broker/agenda-design.md) — not by a wire cap the agent has to pre-summarize under.
+  // (docs/brain/broker/agenda-design.md) — not by a wire cap the agent has to pre-summarize under.
   // Owner, 2026-07-28: "our actual limitation on how long something is to the user should
   // come from the broker splitting and summarizing." The cap that remains is a size guard.
   ask: external_exports.string().min(1).max(1e4).optional().describe(
@@ -10256,7 +10270,7 @@ var UserAnswerSchema = external_exports.discriminatedUnion("kind", [
   external_exports.object({ kind: external_exports.literal("clarify"), chunks: external_exports.array(external_exports.string()).min(1) }),
   external_exports.object({ kind: external_exports.literal("confirm"), approved: external_exports.boolean() }),
   external_exports.object({ kind: external_exports.literal("turns"), turns: external_exports.array(TurnSchema).min(1) }),
-  /** An auto-answer derived from the user's PAST decisions (broker/precedent-design.md §2):
+  /** An auto-answer derived from the user's PAST decisions (docs/brain/broker/precedent-design.md §2):
    *  delivered through the same settle/await path as a human answer, carrying the judge's
    *  derivation and the precedent ids it grew from. Always paired with a visible trail
    *  card the user can reply to — the broker never overrides the user. */
@@ -10305,7 +10319,7 @@ var AwaitItemSchema = external_exports.discriminatedUnion("type", [
      *  and now knows exactly which call to make. Absent when either half is missing —
      *  a sentence with a hole in it is worse than no sentence. */
     note: external_exports.string().optional(),
-    /** The call record rendered for THIS agent (`voice/record-design.md`): the words the
+    /** The call record rendered for THIS agent (`docs/brain/voice/record-design.md`): the words the
      *  shaped answer was mapped from, filtered to its own claims. There is no second list
      *  of labels beside it — the acts went 2026-09-04 and `intents` went with them (owner,
      *  2026-09-04): the agent reads the sentence and decides. */
@@ -10401,10 +10415,11 @@ var AgendaTurnSchema = external_exports.object({
   agentId: external_exports.string().optional(),
   select: SelectShapeSchema.optional(),
   options: external_exports.array(OptionSchema.omit({ id: true })).optional(),
-  /** Pacing (#826, owner 2026-08-03: "how fast we move through them ... are parameters"):
-   *  seconds the floor stays open after this turn speaks. Absent = the bot's defaults
-   *  (the beat for context, the answer window for asks). Clamped bot-side. */
-  pace: external_exports.number().positive().optional(),
+  /* `pace` STOOD HERE (#826). A turn could carry seconds and the model chose them. The walk
+     paces itself now — a short beat between the sentences of a turn, the longer one at its end
+     (owner, 2026-09-30: "remove the bot deciding pace") — and it does that where the words are
+     spoken, not where the plan is written, so nothing between the brain and the walk decides
+     anything. A caller's own `beat_s` tuning is what it used to override. */
   /** Whether the walk WAITS for an answer before moving on. Absent = derived as today
    *  (a question blocks, context flows). blocking:false on a question = ask and move
    *  on, the claim stays pending; blocking:true on context = hold for a reply. */
@@ -10439,7 +10454,7 @@ var InboxItemSchema = external_exports.object({
    *  instant the agent picks it up (#997). Absent = pre-trigger row; fall back to
    *  `createdAt`. */
   agentStateAt: external_exports.string().datetime().optional(),
-  /** THE QUESTIONS A CALL CARRIES — the call screen's agenda spine (walk/design.md §11, owner
+  /** THE QUESTIONS A CALL CARRIES — the call screen's agenda spine (docs/clients/app/walk/design.md §11, owner
    *  2026-09-22). One per DecisionNeed on the Call, in the Call's order, answered or open (a
    *  superseded or cancelled need is no longer a question anyone is asked). Present only on a
    *  Call's cards, and every card of that Call carries the same list: the call screen reads it
@@ -10500,7 +10515,7 @@ var InboxItemSchema = external_exports.object({
    *  off the same open list the card came from, so it clears when the Call does. A card is the
    *  backup for a call not taken; while the call has it, the call is where it is answered. */
   onCall: external_exports.literal(true).optional(),
-  /** THE RING, ON THE ITEM (walk/design.md §12 §17, #2251): the last ring on this card was
+  /** THE RING, ON THE ITEM (docs/clients/app/walk/design.md §12 §17, #2251): the last ring on this card was
    *  declined, and what the ladder will do next — read off the cron's own row, never computed
    *  on the phone. Present only while a `declined` receipt stands on the card's last Call.
    *  The ladder is ACCOUNT-WIDE (#2259): `anchorAt` and `step` are the account's position;
@@ -10531,7 +10546,7 @@ var InboxItemSchema = external_exports.object({
     "Labels for a select:'confirm' paige \u2014 'yesno' (Yes/No) or 'approve' (Approve/Deny). Ignored unless select is 'confirm'."
   ),
   /** Real downstream work is stuck behind this one — set by the agent, independent of
-   *  urgency (see the main README's "premier use case" + notify/states.md). Drives the
+   *  urgency (see the main README's "premier use case" + docs/delivery/notify/states.md). Drives the
    *  inbox's blocking badge and the extra confirm step before dismissing it. */
   blocking: external_exports.boolean().default(false),
   /** The user's locked-in answer; present only for replied items (GET /api/replied/:id). */
@@ -10605,9 +10620,17 @@ var UserSettingsSchema = external_exports.object({
     banner: external_exports.boolean(),
     push: external_exports.boolean()
   }),
+  /** LockedIn / Default / DateNight on screen; the stored words are unchanged on purpose —
+   *  they are an enum on a live column across every account, and the rename is a rename of
+   *  what people read (owner, 2026-09-30). */
   sessionMode: external_exports.enum(["default", "all_calls", "silent"]),
-  silentPush: external_exports.boolean(),
-  autoCallback: external_exports.boolean(),
+  /** `silentPush` lived here until #2813 and is now GONE, field and column both. It was kept as an
+   *  optional long after DateNight stopped reading it, on the theory that a phone on an older
+   *  bundle PATCHing the whole settings object would be REFUSED for sending a key we had stopped
+   *  wanting. That theory was wrong about this schema: these are plain `z.object`s with no
+   *  `.strict()` anywhere in this file, and zod STRIPS unknown keys rather than rejecting them, so
+   *  an old bundle's `silentPush` is accepted and ignored. Worth remembering before keeping the
+   *  next dead field for the same reason. */
   /** Opt-in (default false) to using your content to improve Paigy and train models. */
   improveConsent: external_exports.boolean(),
   missedCall: MissedCallSchema.default("backoff_standard"),
@@ -10618,12 +10641,16 @@ var UserSettingsSchema = external_exports.object({
    *  must not silently reset this privacy choice. Absent = leave unchanged on
    *  write, 'hosted' on read (see store.ts). */
   voiceMode: external_exports.enum(["hosted", "on_device"]).optional(),
-  /** Talk — after you answer, the next step is read aloud (walk/design.md §6). ALWAYS ON until
+  /** Talk — after you answer, the next step is read aloud (docs/clients/app/walk/design.md §6). ALWAYS ON until
    *  turned off (owner, 2026-09-18, #2249): a setting, not a per-walk toggle. Optional, NOT
    *  defaulted, for the same reason `voiceMode` is: a stale client PATCHing the full settings
    *  object must not silently turn it back on. Absent = leave unchanged on write, true on
    *  read (see store.ts). */
   talk: external_exports.boolean().optional(),
+  /** CALL DIAGNOSTICS (owner, 2026-10-01): the call report carries each listen and the bot's own
+   *  load timings. SERVER-SET, no UI — on for every account that existed on 2026-10-01, off for
+   *  newer ones (migration 20261001132859). Read-only here: the settings PATCH never writes it. */
+  callDiagnostics: external_exports.boolean().optional(),
   /** Per-user ring budget (#603): calls per rolling day before further calls
    *  degrade to banner. Absent = the global default (25). A number, never a
    *  bypass — every account keeps a ceiling. No UI; set per user for testing. */
@@ -10632,9 +10659,6 @@ var UserSettingsSchema = external_exports.object({
    *  slower speaker). No API-side semantics; the bot resolves each key with its
    *  own defaults. Set per user (no UI yet); absent = bot defaults. */
   voiceTuning: external_exports.record(external_exports.string(), external_exports.union([external_exports.number(), external_exports.string()])).optional(),
-  /** Opt-in to real-phone (PSTN) calls when the app can't ring. Optional, not
-   *  defaulted — an older client PATCHing the full object must not clobber it. */
-  pstnCalls: external_exports.boolean().optional(),
   /** The user's IANA timezone (e.g. "America/Bogota"), recorded by the app — it is the
    *  only party that knows it. REMINDERS are why it exists: "remind me at ten" becomes
    *  an absolute `due_at` only if we know whose ten. Optional and never defaulted, for
@@ -10678,7 +10702,7 @@ var ConnectionSummarySchema = external_exports.object({
   /** The credential kind: "device" = a paired machine (mint-only — it hosts and mints, it
    *  never talks); "agent" = an identity that sends. The roster and devices surfaces split
    *  on this. Optional/absent reads as "agent" (a row predating the kind column). See
-   *  apps/api/src/tokens/devices-vs-agents-design.md. */
+   *  docs/server/tokens/devices-vs-agents-design.md. */
   kind: external_exports.enum(["device", "agent"]).optional(),
   /** For an agent, the token id of the DEVICE that minted it — so agents group under their
    *  machine, and revoking a device cascades to them. Null on devices, and on unlinked
@@ -10696,7 +10720,7 @@ var ConnectionSummarySchema = external_exports.object({
    *  user on the agent's own page. null = no ceiling (today's behaviour for every
    *  connection). Android binds importance to a relationship rather than to each message,
    *  and that is the thing our roster could not say: "Marlow may always call me; Otto
-   *  never may" (navigation-design.md, gap 2). Clamped in `arbitrateLevel`, so it binds
+   *  never may" (docs/clients/app/party/navigation-design.md, gap 2). Clamped in `arbitrateLevel`, so it binds
    *  every surface at once and outranks even `sessionMode: all_calls` — a mode the user
    *  set once must not overrule a rule they set about one agent. */
   reach: NotifyLevelSchema.nullable().optional(),
@@ -10707,7 +10731,14 @@ var ConnectionSummarySchema = external_exports.object({
   /** Last presence heartbeat from a running agent process (POST /api/presence) — the
    *  desktop app while open. Null = never seen; stale = offline. */
   lastSeenAt: external_exports.string().datetime().nullable().optional(),
-  /** What a live desktop can run (companion.md §2.2), advertised on its heartbeat:
+  /** 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
+   *  `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.
+   *  With no work of its own for `WORKING_MS`, an agent sitting on this is not taking its work. */
+  oldestReadyAt: external_exports.string().datetime().nullable().optional(),
+  /** What a live desktop can run (docs/clients/desktop/companion.md §2.2), advertised on its heartbeat:
    *  harness availabilities + granted workspaces — the option set the phone's
    *  "new session" sheet offers. Absent for ordinary MCP agents. */
   runtime: external_exports.object({
@@ -10715,7 +10746,12 @@ var ConnectionSummarySchema = external_exports.object({
      *  shows its age here (`apps/desktop/src/update.ts`). */
     version: external_exports.string().optional(),
     harnesses: external_exports.array(external_exports.object({ name: external_exports.string(), label: external_exports.string(), status: external_exports.string() })).optional(),
-    workspaces: external_exports.array(external_exports.string()).optional()
+    workspaces: external_exports.array(external_exports.string()).optional(),
+    /** THE GIT REPOS IN THOSE FOLDERS (2026-10-01, Goal 26982211): each granted folder that is a
+     *  repo, and each repo directly inside one, with its `origin` remote. A session started for
+     *  work on `mauurda/paigy` opens in that repo rather than the folder above it, where the repo's
+     *  own AGENTS.md is never read (`workspaceForRepo`). Absent on hosts that predate it. */
+    repos: external_exports.array(external_exports.object({ path: external_exports.string(), remote: external_exports.string() })).optional()
   }).optional(),
   /** The tail of this agent's working log, when a harness is driving it — the agent page's
    *  live strip. Absent for anything the desktop harness isn't running (a hatched identity
@@ -10728,7 +10764,8 @@ var ConnectionSummarySchema = external_exports.object({
 });
 var LedgerItemSchema = external_exports.object({ id: external_exports.string(), parentId: external_exports.string(), title: external_exports.string(), createdAt: external_exports.string() });
 var AgentLedgerSchema = external_exports.object({
-  agent: external_exports.object({ id: external_exports.string(), name: external_exports.string(), revokedAt: external_exports.string().nullable() }),
+  /** Null when the agent has not named itself yet — never a placeholder (owner, 2026-10-01). */
+  agent: external_exports.object({ id: external_exports.string(), name: external_exports.string().nullable(), revokedAt: external_exports.string().nullable() }),
   /** Its own questions you have not answered. */
   asks: external_exports.array(LedgerItemSchema),
   /** Its questions you answered that nobody acted on — still owed to somebody. */
@@ -10798,7 +10835,7 @@ var QueueQuestionSchema = external_exports.object({
    *  for a settled question whose reply carried nothing readable. */
   answer: external_exports.string().nullable().default(null),
   /** The Goal this question belongs to — a step knows its Goal on its own, not only through
-   *  an `InboxItem`'s `communication.goalIds[0]` (walk/design.md §12 item 3).
+   *  an `InboxItem`'s `communication.goalIds[0]` (docs/clients/app/walk/design.md §12 item 3).
    *  READ BY `apps/client/src/walk/order.ts`, which stamps it onto every `WalkStep`: the walk's
    *  order, its route, home's trees and the list of steps all take a step's Goal from here, so
    *  this is the field they agree through rather than each re-deriving it from the row it
@@ -10890,7 +10927,19 @@ var QueueItemSchema = external_exports.object({
     said: external_exports.string(),
     at: external_exports.string(),
     entryId: external_exports.string()
-  }).nullable().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
+   *  answer to a question, a voice note filed as work. Null when the only hands on it have been its
+   *  agent's; optional, so a hand-built queue (fixtures, the demo) and a door older than
+   *  20261001030911 need not spell it — `work/list.ts`'s `yoursAt` keeps its other sources, so the
+   *  Work tab orders as it did before the migration rather than throwing on the missing key.
+   *
+   *  It is a FACT, not a reconstruction: `latest` holds one Entry, so an agent's progress note a
+   *  minute after the person speaks erases their instant from it, and the durable traces the client
+   *  can see (`replies`, `questions[].answeredAt`) miss a spontaneous note entirely — a `request`
+   *  Entry with no `about_id` is in neither. */
+  lastPersonAt: external_exports.string().nullable().optional()
 });
 var COLD_AFTER_MS = 3 * 24 * 60 * 60 * 1e3;
 var NoteSourceSchema = external_exports.enum(["app", "call"]);
@@ -10920,7 +10969,7 @@ var NoteSchema = external_exports.object({
   assignee: external_exports.string().nullable(),
   /** The request thread minted at assignment; null until assigned. */
   parentId: external_exports.string().nullable(),
-  /** REMINDERS (reminders-design.md): the NOT-BEFORE this becomes eligible to ride a
+  /** REMINDERS (docs/model/notes/reminders-design.md): the NOT-BEFORE this becomes eligible to ride a
    *  call — never a deadline. It only ever comes from the user's own words, so when it
    *  passes Paigy rings ONCE (#1293, owner 2026-08-26: a time said out loud is consent to
    *  a ring at that time); after that it rides like any other. Null = "the very next
@@ -11182,6 +11231,31 @@ var SnapshotSchema = external_exports.object({
     computers: external_exports.array(ComputerRowSchema).nullable()
   }).nullable()
 });
+var CallRecapSchema = external_exports.object({
+  call: external_exports.object({
+    status: external_exports.string(),
+    startedAt: external_exports.string(),
+    durationMs: external_exports.number().nullable(),
+    agents: external_exports.array(external_exports.object({ id: external_exports.string(), name: external_exports.string().nullable() }))
+  }),
+  topics: external_exports.array(external_exports.object({
+    goalId: external_exports.string().uuid(),
+    title: external_exports.string(),
+    owner: external_exports.string(),
+    state: external_exports.string(),
+    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. */
+    /** `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() }))
+  })),
+  unfiled: external_exports.array(external_exports.object({ lineId: external_exports.string().uuid(), 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) {
   const id = sessionId2 ?? sessionId();
   return `session:${id.slice(0, 8)}`;
@@ -11376,6 +11450,22 @@ async function claimSessions(opts = {}) {
   if (!res.ok) throw new Error(`claim_sessions failed: ${res.status}`);
   return (await res.json()).sessions;
 }
+async function claimSessionEnds(opts = {}) {
+  const res = await ensureAuthed(await reach(`${BACKEND_URL}/api/sessions/ends/claim`, {
+    headers: { authorization: `Bearer ${authToken(opts.token)}` }
+    // the HOST's identity
+  }));
+  if (!res.ok) throw new Error(`claim_session_ends failed: ${res.status}`);
+  return (await res.json()).ends ?? [];
+}
+async function finishSessionEnd(endId, result, opts = {}) {
+  const res = await ensureAuthed(await reach(`${BACKEND_URL}/api/sessions/ends/${encodeURIComponent(endId)}`, {
+    method: "POST",
+    headers: { "content-type": "application/json", authorization: `Bearer ${authToken(opts.token)}` },
+    body: JSON.stringify({ result })
+  }));
+  if (!res.ok) await fail("finish_session_end", res);
+}
 async function recordDecision(decision, opts = {}) {
   const res = await ensureAuthed(await reach(`${BACKEND_URL}/api/host/decisions`, {
     method: "POST",
@@ -11499,7 +11589,9 @@ async function contact(input, opts = {}) {
       // this cannot see.
       repo: repoFromRemote(a.repo) ?? a.repo ?? currentRepo() ?? void 0,
       ask: a.ask,
-      options: a.options ?? []
+      options: a.options ?? [],
+      ...a.select ? { select: a.select } : {},
+      ...a.answers ? { answers: a.answers } : {}
     }));
     const res = await ensureAuthed(await send22(`${BACKEND_URL}/api/goals/contact`, {
       method: "POST",
@@ -12391,7 +12483,7 @@ async function brokerView(deps) {
 }
 
 // src/workspaces.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync3, statSync as statSync2, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname2, join as join5, resolve } from "path";
 import { homedir as homedir5 } from "os";
 function workspacesFile() {
@@ -12432,10 +12524,41 @@ function resolveWakeDir(pinned, deps) {
   }
   return listWorkspaces(deps)[0];
 }
+function originOf(dir) {
+  try {
+    if (!statSync2(join5(dir, ".git")).isDirectory()) return null;
+    const config = readFileSync3(join5(dir, ".git", "config"), "utf8");
+    const section = config.split(/^\[/m).find((s) => /^remote\s+"origin"\]/.test(s));
+    return section?.match(/^\s*url\s*=\s*(.+)$/m)?.[1]?.trim() ?? null;
+  } catch {
+    return null;
+  }
+}
+var MAX_CHILDREN = 300;
+var MAX_REPOS = 100;
+function listRepos(deps) {
+  const repos = [];
+  for (const root of listWorkspaces(deps)) {
+    const own = originOf(root);
+    if (own) repos.push({ path: root, remote: own });
+    let children = [];
+    try {
+      children = readdirSync(root, { withFileTypes: true }).filter((d) => d.isDirectory() && !d.name.startsWith(".")).map((d) => d.name).sort().slice(0, MAX_CHILDREN);
+    } catch {
+    }
+    for (const name of children) {
+      if (repos.length >= MAX_REPOS) return repos;
+      const path = join5(root, name);
+      const remote = originOf(path);
+      if (remote) repos.push({ path, remote });
+    }
+  }
+  return repos.slice(0, MAX_REPOS);
+}
 
 // src/holder.ts
 import { execFileSync as execFileSync3 } from "child_process";
-import { readFileSync as readFileSync4, readdirSync } from "fs";
+import { readFileSync as readFileSync4, readdirSync as readdirSync2 } from "fs";
 import { homedir as homedir6 } from "os";
 import { join as join6 } from "path";
 function isAlive(pid) {
@@ -12466,9 +12589,62 @@ function holds(pid, procStart, deps) {
   }
   return false;
 }
+function proven(pid, procStart, deps) {
+  if (!deps.alive(pid) || typeof procStart !== "string" || !procStart.trim()) return false;
+  const want = squash(procStart);
+  return ["UTC", "local"].some((zone) => {
+    const got = deps.started(pid, zone);
+    return got !== null && squash(got) === want;
+  });
+}
+function localHolderPids(deps = {}) {
+  const dir = deps.dir ?? join6(process.env.CLAUDE_CONFIG_DIR?.trim() || join6(homedir6(), ".claude"), "sessions");
+  const list = deps.list ?? ((d) => readdirSync2(d));
+  const read = deps.read ?? ((f) => readFileSync4(f, "utf8"));
+  const check = { alive: deps.alive ?? isAlive, started: deps.started ?? psStart };
+  const held = /* @__PURE__ */ new Map();
+  let files;
+  try {
+    files = list(dir);
+  } catch {
+    return held;
+  }
+  for (const file of files) {
+    if (!/^\d+\.json$/.test(file)) continue;
+    let row;
+    try {
+      row = JSON.parse(read(join6(dir, file)));
+    } catch {
+      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;
+    const slot = sessionSlot(row.sessionId);
+    held.set(slot, [...held.get(slot) ?? [], { pid, proven: proven(pid, row.procStart, check) }]);
+  }
+  return held;
+}
+function psParent(pid) {
+  try {
+    const out = execFileSync3("ps", ["-o", "ppid=", "-p", String(pid)], { encoding: "utf8", timeout: 2e3 }).trim();
+    const n = Number(out);
+    return Number.isInteger(n) && n > 0 ? n : null;
+  } catch {
+    return null;
+  }
+}
+function descendsFrom(pid, ancestor, parent = psParent) {
+  let at = pid;
+  for (let i = 0; i < 32 && at !== null && at > 1; i += 1) {
+    if (at === ancestor) return true;
+    at = parent(at);
+  }
+  return false;
+}
 function localHolders(deps = {}) {
   const dir = deps.dir ?? join6(process.env.CLAUDE_CONFIG_DIR?.trim() || join6(homedir6(), ".claude"), "sessions");
-  const list = deps.list ?? ((d) => readdirSync(d));
+  const list = deps.list ?? ((d) => readdirSync2(d));
   const read = deps.read ?? ((f) => readFileSync4(f, "utf8"));
   const check = { alive: deps.alive ?? isAlive, started: deps.started ?? psStart };
   const held = /* @__PURE__ */ new Map();
@@ -12495,8 +12671,67 @@ function localHolders(deps = {}) {
   return held;
 }
 
+// src/end.ts
+var GRACE_MS = 5e3;
+async function endTerminal(pid, slot, deps) {
+  try {
+    deps.kill(pid, "SIGTERM");
+  } catch (e) {
+    return { ok: false, kind: "terminal", pid, why: `SIGTERM refused: ${e.message}`.slice(0, 200) };
+  }
+  const grace = deps.graceMs ?? GRACE_MS;
+  for (let waited = 0; waited < grace; waited += 250) {
+    if (!deps.alive(pid)) {
+      deps.log(`session_ended ${JSON.stringify({ sessionId: slot, pid, kind: "terminal", signal: "SIGTERM" })}`);
+      return { ok: true, kind: "terminal", pid, signal: "SIGTERM" };
+    }
+    await deps.sleep(250);
+  }
+  try {
+    deps.kill(pid, "SIGKILL");
+  } catch (e) {
+    return { ok: false, kind: "terminal", pid, why: `SIGKILL refused: ${e.message}`.slice(0, 200) };
+  }
+  deps.log(`session_ended ${JSON.stringify({ sessionId: slot, pid, kind: "terminal", signal: "SIGKILL" })}`);
+  return { ok: true, kind: "terminal", pid, signal: "SIGKILL" };
+}
+async function endSession(end, deps) {
+  const slots = deps.slotsFor(end.agent);
+  if (!slots.length) return { ok: false, why: "not_on_this_host" };
+  let ended2 = null;
+  if (end.which === "harness" || end.which === "any") {
+    for (const slot of slots) {
+      const run = deps.ownRun(slot);
+      if (!run) continue;
+      run.stop();
+      deps.log(`session_ended ${JSON.stringify({ sessionId: slot, kind: "harness", signal: "stop" })}`);
+      ended2 = { ok: true, kind: "harness", signal: "stop" };
+    }
+    if (end.which === "harness" && !ended2) return { ok: false, kind: "harness", why: "no_harness_copy_here" };
+  }
+  if (end.which === "terminal" || end.which === "any") {
+    let terminal = null;
+    let unproven = null;
+    for (const slot of slots) {
+      for (const { pid, proven: proven2 } of deps.pidsFor(slot).filter((p) => !deps.isOwn(p.pid))) {
+        if (!proven2) {
+          deps.log(`session_end_refused ${JSON.stringify({ sessionId: slot, pid, why: "no_proc_start" })}`);
+          unproven = { ok: false, kind: "terminal", pid, why: "no_proc_start" };
+          continue;
+        }
+        terminal = await endTerminal(pid, slot, deps);
+        if (!terminal.ok) return terminal;
+      }
+    }
+    if (terminal) return terminal;
+    if (unproven) return unproven;
+    if (end.which === "terminal") return { ok: false, kind: "terminal", why: "no_terminal_copy_here" };
+  }
+  return ended2 ?? { ok: false, why: "nothing_running_here" };
+}
+
 // src/owner.ts
-import { closeSync as closeSync2, openSync as openSync2, readSync, readdirSync as readdirSync2 } from "fs";
+import { closeSync as closeSync2, openSync as openSync2, readSync, readdirSync as readdirSync3 } from "fs";
 import { homedir as homedir7 } from "os";
 import { join as join7 } from "path";
 var HEAD_BYTES = 64e3;
@@ -12515,7 +12750,7 @@ function ownerSession(slot, deps = {}) {
   if (!m) return null;
   const prefix = m[1];
   const root = deps.projectsDir ?? join7(homedir7(), ".claude", "projects");
-  const list = deps.list ?? ((dir) => readdirSync2(dir));
+  const list = deps.list ?? ((dir) => readdirSync3(dir));
   const head = deps.head ?? readHead;
   let folders;
   try {
@@ -13891,7 +14126,20 @@ var AskInputSchema2 = external_exports.object({
   ask: external_exports.string().trim().min(1).max(1e4).describe(
     "ONE question, and only what is needed to answer it. Several questions are several asks in the array, one each: an answer settles the one ask it was given in the shape that ask declares, so a person who answers the part of a bundled ask that interested them settles nothing and is asked again. Paigy reads every ask once and takes a bundled one apart into its own cards anyway \u2014 each question a Question on the one Goal the ask lands on, never a Goal of its own \u2014 but the words it splits are its reading, not yours. News, progress and findings are their own contact; ANY contact for a person already on a call JOINS that call, whatever channel you asked for, so several arrive as one call."
   ),
-  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional()
+  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional(),
+  // A CHECKLIST WHEN THE CHOICES ARE INDEPENDENT (owner, 2026-10-02 01:44 UTC: "bring back the
+  // checklist mode of answering"). The answer shape was taken off this surface with the wire form
+  // (#575) on the promise that Paigy would derive it, and the Goal-scoped contact that replaced it
+  // only ever sends pick-one or words (`goal/intake.ts` `answerOf`): three independent fixes went out
+  // as "All three / 1 and 3 only / Just log it", which the person could not read without the text and
+  // could not answer as the ticks he wanted. "many" is the one shape an agent knows and the read does
+  // not: whether its own options exclude each other.
+  select: external_exports.enum(["one", "many"]).optional().describe(
+    'How the options are answered: "one" (default) to pick one, "many" to tick any number of them. Use "many" when the options are independent things they may want several of \u2014 never combinations of them like "all three" or "1 and 3". Ignored without options.'
+  ),
+  answers: external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/).optional().describe(
+    "Your reply answers a question the person asked you: the id the conversation shows for it (8 characters or whole). Their question closes with this reply as its answer, and any decision of yours it was holding back goes back to them. Needs parentId: the Goal the question is on. The reply is sent to them as it is; to also ask something new, send that as its own ask."
+  )
 }).strict();
 var StartContactSchema2 = external_exports.object({
   asks: external_exports.array(AskInputSchema2).min(1).describe("The questions to pose, one per object. An ask with a parentId is filed on that Goal as it is; only an ask naming no Goal is placed in the tree by Paigy."),
@@ -13900,7 +14148,7 @@ var StartContactSchema2 = external_exports.object({
 }).strict();
 var ContactSchema2 = external_exports.union([StartContactSchema2, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict()]);
 var CONTACT_SCHEMA2 = { type: "object", ...mcpInputSchema2(ContactSchema2) };
-var CONTACT_DESCRIPTION2 = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none is placed in the person's tree by Paigy. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. A bundled ask is taken apart into its own cards by Paigy's one intake read, every one on the Goal the ask lands on; separate pieces of work are separate asks. An ask with no options that is not blocking is a report, and a report is an UPDATE, never a claim on them: it reaches them and is listed apart from what waits on them, so no answer is owed and none should be awaited. On a Goal whose report card is still open it is added to that card, with no new push; one that only says where your work stands while under way is recorded as the Goal's progress, not sent (the result says so). Send options (or waiting:'hard') when you actually need an answer. If the person is already on a call, your contact joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.";
+var CONTACT_DESCRIPTION2 = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'select', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none is placed in the person's tree by Paigy. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. A bundled ask is taken apart into its own cards by Paigy's one intake read, every one on the Goal the ask lands on; separate pieces of work are separate asks. An ask with no options that is not blocking is a report, and a report is an UPDATE, never a claim on them: it reaches them and is listed apart from what waits on them, so no answer is owed and none should be awaited. On a Goal whose report card is still open it is added to that card, with no new push; one that only says where your work stands while under way is recorded as the Goal's progress, not sent (the result says so). Send options (or waiting:'hard') when you actually need an answer. Each option's label must stand on its own \u2014 the person may see only the labels \u2014 so never a label that points into your text ('All three', 'Option 2', '1 and 3 only'); when the options are independent and they may want several, pass select:'many' and they get a checklist. If the person is already on a call, your contact joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.";
 var CreateGoalSchema2 = external_exports.object({
   outcome: external_exports.string().trim().min(1).max(1e4),
   /** The work's NAME (#2115) — one to five words, how a person refers to it out loud ("the night
@@ -13956,11 +14204,11 @@ var GetGoalSchema2 = external_exports.object({
   history: external_exports.boolean().optional(),
   /** WHEN A READ HAS CONFUSED YOU. Adds `diagnosis`: every reader that already answers a question
    *  about this work, each answer attributed to the reader that gave it, and every disagreement
-   *  between two of them named. Off by default; `apps/api/src/goal/diagnose-design.md`. */
+   *  between two of them named. Off by default; `docs/model/goal/diagnose-design.md`. */
   diagnose: external_exports.boolean().optional()
 }).strict();
-var GET_GOAL_DESCRIPTION2 = "Read one Goal without claiming it: its outcome, state, revision, progress, blockers, the conversation on it (each question with its options and what was decided), `next`, the one step to take, and `more`, where to read further. The conversation carries everything the person said, every open question and your newest entry; your older entries are left out and counted \u2014 history: true reads every entry in full. Another account's Goals, and another agent's Goal that is not below one of yours, are not disclosed.\n\ndiagnose: true is for when a read has CONFUSED you \u2014 not for the working loop. It adds `diagnosis`, which asks every reader that already answers a question about your work and NAMES the reader behind every value, so you never guess which of two places to look: what state your work is really in (the stored `goals.state` beside the derived `goal_execution_state`, which can differ); whether anything is armed to ring and when (`ladder_candidates`, with the ladder's own last decision); whether a wake fired for you and what it did (durable `wake.*` events, beside when your process was last heard from); and what has reached you (`list_waiting` \u2014 review flags, unstarted work, open questions, the person's newest words). Read `diagnosis.disagreements` FIRST: each one is two readers giving different values for the same fact, with both values and both sources, and it never chooses between them \u2014 that is yours to do, from the Goal's own history. `diagnosis.looked` names every reader asked, including any that could not answer, so an empty answer is never confused with a broken one.";
-var UPDATE_GOAL_DESCRIPTION2 = `Update an owned Goal at an exact revision. State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. title is the work's name in one to five words, as a person would refer to it out loud (it is spoken on a call and heads every list); null clears it. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision. dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. state: done means the work was accomplished, and it can be reopened: when the person says it is not done ("it's not working"), set state: active on that same Goal instead of starting a new one; its parent reopens with it. state: done while children are still open records your part as done: the Goal waits and closes by itself when its last open child closes. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
+var GET_GOAL_DESCRIPTION2 = "Read one Goal without claiming it: its outcome, state, revision, progress, blockers, the conversation on it (each question with its options and what was decided), `next`, the one step to take, and `more`, where to read further. A question in that conversation reads `open` (nothing yet), `answered` (a choice was made, and `answer` carries it), `replied` (they said something and the read settled the question on their words \u2014 NO option of yours was chosen, and the words are the reply line beside it, so read that before you act), or `closed`. The conversation carries everything the person said, every open question and your newest entry; your older entries are left out and counted \u2014 history: true reads every entry in full. Another account's Goals, and another agent's Goal that is not below one of yours, are not disclosed.\n\ndiagnose: true is for when a read has CONFUSED you \u2014 not for the working loop. It adds `diagnosis`, which asks every reader that already answers a question about your work and NAMES the reader behind every value, so you never guess which of two places to look: what state your work is really in (the stored `goals.state` beside the derived `goal_execution_state`, which can differ); whether anything is armed to ring and when (`ladder_candidates`, with the ladder's own last decision); whether a wake fired for you and what it did (durable `wake.*` events, beside when your process was last heard from); and what has reached you (`list_waiting` \u2014 review flags, unstarted work, open questions, the person's newest words). Read `diagnosis.disagreements` FIRST: each one is two readers giving different values for the same fact, with both values and both sources, and it never chooses between them \u2014 that is yours to do, from the Goal's own history. `diagnosis.looked` names every reader asked, including any that could not answer, so an empty answer is never confused with a broken one.";
+var UPDATE_GOAL_DESCRIPTION2 = `Update an owned Goal at an exact revision. State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. A CONTACT ON THIS GOAL MOVES ITS REVISION: a question filed on a Goal is a change to it, so an update prepared before a contact and sent after it is refused as stale (409 goal_revision_conflict) \u2014 re-read the Goal, then write. title is the work's name in one to five words, as a person would refer to it out loud (it is spoken on a call and heads every list); null clears it. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision. dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. state: done means the work was accomplished, and it can be reopened: when the person says it is not done ("it's not working"), set state: active on that same Goal instead of starting a new one; its parent reopens with it. state: done while children are still open records your part as done: the Goal waits and closes by itself when its last open child closes. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
 var CLAIM_GOAL_DESCRIPTION2 = "Claim the oldest runnable or review-pending Goal you own, or pass goalId to claim that Goal. Another agent's Goal that has gone quiet for 3 days (check_replies lists them as stalledOthers) is taken over when you claim it, and becomes yours to finish or cancel. Returns the Goal as get_goal reads it, and creates or renews the execution lease.";
 var CHECK_REPLIES_DESCRIPTION2 = "What is waiting for you: your open Deliveries (a request the user started toward you, a handoff), one row each with its Goals, how many decisions are still open, and the newest words in brief; `assigned`, your Goals nobody has started yet, however they became yours (claim_goal({goalId}) starts one); and `review`, your Goals with something new on them \u2014 the user's answers and notes are Entries on the Goal, not Deliveries. A pure read with no arguments: nothing is consumed, acknowledged or claimed by reading it, so call it on startup, after a long wait, or whenever you want to know what is outstanding. To act on one, claim its Goal (claim_goal) or reread a Delivery in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true clears the Goal from `review` and closes the Deliveries addressed to you on it.";
 var CheckRepliesSchema2 = external_exports.object({}).strict();
@@ -13989,6 +14237,7 @@ function entryWords(entry) {
   return entry.sources.map((source) => source.text).join("\n");
 }
 var LIVE_MS2 = 3 * 6e4;
+var WORKING_MS2 = 30 * 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(
@@ -14059,7 +14308,7 @@ var AttentionSchema2 = external_exports.object({
   points: external_exports.array(external_exports.string()).nullable(),
   /** Whether the ask blocks the sender — what lets arbitration escalate it on silence. */
   blocking: external_exports.boolean(),
-  /** Reserved (MODEL.md lists it): a response deadline. No row column yet — a later Phase 2
+  /** Reserved (docs/model/model.md lists it): a response deadline. No row column yet — a later Phase 2
    *  slice wires it; optional so today's rows/callers project cleanly. */
   deadline: external_exports.string().datetime().nullable().optional()
 });
@@ -14110,7 +14359,7 @@ var NotifyRequestFields2 = external_exports.object({
    *  derive agent-side before sealing, so the server only ever shapes plaintext). */
   // 10k, not a sentence budget. What the human hears is bounded by the BROKER — it splits
   // the ask into topics and gives each one at most three sentences and one question
-  // (broker/agenda-design.md) — not by a wire cap the agent has to pre-summarize under.
+  // (docs/brain/broker/agenda-design.md) — not by a wire cap the agent has to pre-summarize under.
   // Owner, 2026-07-28: "our actual limitation on how long something is to the user should
   // come from the broker splitting and summarizing." The cap that remains is a size guard.
   ask: external_exports.string().min(1).max(1e4).optional().describe(
@@ -14187,7 +14436,7 @@ var UserAnswerSchema2 = external_exports.discriminatedUnion("kind", [
   external_exports.object({ kind: external_exports.literal("clarify"), chunks: external_exports.array(external_exports.string()).min(1) }),
   external_exports.object({ kind: external_exports.literal("confirm"), approved: external_exports.boolean() }),
   external_exports.object({ kind: external_exports.literal("turns"), turns: external_exports.array(TurnSchema2).min(1) }),
-  /** An auto-answer derived from the user's PAST decisions (broker/precedent-design.md §2):
+  /** An auto-answer derived from the user's PAST decisions (docs/brain/broker/precedent-design.md §2):
    *  delivered through the same settle/await path as a human answer, carrying the judge's
    *  derivation and the precedent ids it grew from. Always paired with a visible trail
    *  card the user can reply to — the broker never overrides the user. */
@@ -14236,7 +14485,7 @@ var AwaitItemSchema2 = external_exports.discriminatedUnion("type", [
      *  and now knows exactly which call to make. Absent when either half is missing —
      *  a sentence with a hole in it is worse than no sentence. */
     note: external_exports.string().optional(),
-    /** The call record rendered for THIS agent (`voice/record-design.md`): the words the
+    /** The call record rendered for THIS agent (`docs/brain/voice/record-design.md`): the words the
      *  shaped answer was mapped from, filtered to its own claims. There is no second list
      *  of labels beside it — the acts went 2026-09-04 and `intents` went with them (owner,
      *  2026-09-04): the agent reads the sentence and decides. */
@@ -14332,10 +14581,11 @@ var AgendaTurnSchema2 = external_exports.object({
   agentId: external_exports.string().optional(),
   select: SelectShapeSchema2.optional(),
   options: external_exports.array(OptionSchema2.omit({ id: true })).optional(),
-  /** Pacing (#826, owner 2026-08-03: "how fast we move through them ... are parameters"):
-   *  seconds the floor stays open after this turn speaks. Absent = the bot's defaults
-   *  (the beat for context, the answer window for asks). Clamped bot-side. */
-  pace: external_exports.number().positive().optional(),
+  /* `pace` STOOD HERE (#826). A turn could carry seconds and the model chose them. The walk
+     paces itself now — a short beat between the sentences of a turn, the longer one at its end
+     (owner, 2026-09-30: "remove the bot deciding pace") — and it does that where the words are
+     spoken, not where the plan is written, so nothing between the brain and the walk decides
+     anything. A caller's own `beat_s` tuning is what it used to override. */
   /** Whether the walk WAITS for an answer before moving on. Absent = derived as today
    *  (a question blocks, context flows). blocking:false on a question = ask and move
    *  on, the claim stays pending; blocking:true on context = hold for a reply. */
@@ -14370,7 +14620,7 @@ var InboxItemSchema2 = external_exports.object({
    *  instant the agent picks it up (#997). Absent = pre-trigger row; fall back to
    *  `createdAt`. */
   agentStateAt: external_exports.string().datetime().optional(),
-  /** THE QUESTIONS A CALL CARRIES — the call screen's agenda spine (walk/design.md §11, owner
+  /** THE QUESTIONS A CALL CARRIES — the call screen's agenda spine (docs/clients/app/walk/design.md §11, owner
    *  2026-09-22). One per DecisionNeed on the Call, in the Call's order, answered or open (a
    *  superseded or cancelled need is no longer a question anyone is asked). Present only on a
    *  Call's cards, and every card of that Call carries the same list: the call screen reads it
@@ -14431,7 +14681,7 @@ var InboxItemSchema2 = external_exports.object({
    *  off the same open list the card came from, so it clears when the Call does. A card is the
    *  backup for a call not taken; while the call has it, the call is where it is answered. */
   onCall: external_exports.literal(true).optional(),
-  /** THE RING, ON THE ITEM (walk/design.md §12 §17, #2251): the last ring on this card was
+  /** THE RING, ON THE ITEM (docs/clients/app/walk/design.md §12 §17, #2251): the last ring on this card was
    *  declined, and what the ladder will do next — read off the cron's own row, never computed
    *  on the phone. Present only while a `declined` receipt stands on the card's last Call.
    *  The ladder is ACCOUNT-WIDE (#2259): `anchorAt` and `step` are the account's position;
@@ -14462,7 +14712,7 @@ var InboxItemSchema2 = external_exports.object({
     "Labels for a select:'confirm' paige \u2014 'yesno' (Yes/No) or 'approve' (Approve/Deny). Ignored unless select is 'confirm'."
   ),
   /** Real downstream work is stuck behind this one — set by the agent, independent of
-   *  urgency (see the main README's "premier use case" + notify/states.md). Drives the
+   *  urgency (see the main README's "premier use case" + docs/delivery/notify/states.md). Drives the
    *  inbox's blocking badge and the extra confirm step before dismissing it. */
   blocking: external_exports.boolean().default(false),
   /** The user's locked-in answer; present only for replied items (GET /api/replied/:id). */
@@ -14536,9 +14786,17 @@ var UserSettingsSchema2 = external_exports.object({
     banner: external_exports.boolean(),
     push: external_exports.boolean()
   }),
+  /** LockedIn / Default / DateNight on screen; the stored words are unchanged on purpose —
+   *  they are an enum on a live column across every account, and the rename is a rename of
+   *  what people read (owner, 2026-09-30). */
   sessionMode: external_exports.enum(["default", "all_calls", "silent"]),
-  silentPush: external_exports.boolean(),
-  autoCallback: external_exports.boolean(),
+  /** `silentPush` lived here until #2813 and is now GONE, field and column both. It was kept as an
+   *  optional long after DateNight stopped reading it, on the theory that a phone on an older
+   *  bundle PATCHing the whole settings object would be REFUSED for sending a key we had stopped
+   *  wanting. That theory was wrong about this schema: these are plain `z.object`s with no
+   *  `.strict()` anywhere in this file, and zod STRIPS unknown keys rather than rejecting them, so
+   *  an old bundle's `silentPush` is accepted and ignored. Worth remembering before keeping the
+   *  next dead field for the same reason. */
   /** Opt-in (default false) to using your content to improve Paigy and train models. */
   improveConsent: external_exports.boolean(),
   missedCall: MissedCallSchema2.default("backoff_standard"),
@@ -14549,12 +14807,16 @@ var UserSettingsSchema2 = external_exports.object({
    *  must not silently reset this privacy choice. Absent = leave unchanged on
    *  write, 'hosted' on read (see store.ts). */
   voiceMode: external_exports.enum(["hosted", "on_device"]).optional(),
-  /** Talk — after you answer, the next step is read aloud (walk/design.md §6). ALWAYS ON until
+  /** Talk — after you answer, the next step is read aloud (docs/clients/app/walk/design.md §6). ALWAYS ON until
    *  turned off (owner, 2026-09-18, #2249): a setting, not a per-walk toggle. Optional, NOT
    *  defaulted, for the same reason `voiceMode` is: a stale client PATCHing the full settings
    *  object must not silently turn it back on. Absent = leave unchanged on write, true on
    *  read (see store.ts). */
   talk: external_exports.boolean().optional(),
+  /** CALL DIAGNOSTICS (owner, 2026-10-01): the call report carries each listen and the bot's own
+   *  load timings. SERVER-SET, no UI — on for every account that existed on 2026-10-01, off for
+   *  newer ones (migration 20261001132859). Read-only here: the settings PATCH never writes it. */
+  callDiagnostics: external_exports.boolean().optional(),
   /** Per-user ring budget (#603): calls per rolling day before further calls
    *  degrade to banner. Absent = the global default (25). A number, never a
    *  bypass — every account keeps a ceiling. No UI; set per user for testing. */
@@ -14563,9 +14825,6 @@ var UserSettingsSchema2 = external_exports.object({
    *  slower speaker). No API-side semantics; the bot resolves each key with its
    *  own defaults. Set per user (no UI yet); absent = bot defaults. */
   voiceTuning: external_exports.record(external_exports.string(), external_exports.union([external_exports.number(), external_exports.string()])).optional(),
-  /** Opt-in to real-phone (PSTN) calls when the app can't ring. Optional, not
-   *  defaulted — an older client PATCHing the full object must not clobber it. */
-  pstnCalls: external_exports.boolean().optional(),
   /** The user's IANA timezone (e.g. "America/Bogota"), recorded by the app — it is the
    *  only party that knows it. REMINDERS are why it exists: "remind me at ten" becomes
    *  an absolute `due_at` only if we know whose ten. Optional and never defaulted, for
@@ -14609,7 +14868,7 @@ var ConnectionSummarySchema2 = external_exports.object({
   /** The credential kind: "device" = a paired machine (mint-only — it hosts and mints, it
    *  never talks); "agent" = an identity that sends. The roster and devices surfaces split
    *  on this. Optional/absent reads as "agent" (a row predating the kind column). See
-   *  apps/api/src/tokens/devices-vs-agents-design.md. */
+   *  docs/server/tokens/devices-vs-agents-design.md. */
   kind: external_exports.enum(["device", "agent"]).optional(),
   /** For an agent, the token id of the DEVICE that minted it — so agents group under their
    *  machine, and revoking a device cascades to them. Null on devices, and on unlinked
@@ -14627,7 +14886,7 @@ var ConnectionSummarySchema2 = external_exports.object({
    *  user on the agent's own page. null = no ceiling (today's behaviour for every
    *  connection). Android binds importance to a relationship rather than to each message,
    *  and that is the thing our roster could not say: "Marlow may always call me; Otto
-   *  never may" (navigation-design.md, gap 2). Clamped in `arbitrateLevel`, so it binds
+   *  never may" (docs/clients/app/party/navigation-design.md, gap 2). Clamped in `arbitrateLevel`, so it binds
    *  every surface at once and outranks even `sessionMode: all_calls` — a mode the user
    *  set once must not overrule a rule they set about one agent. */
   reach: NotifyLevelSchema2.nullable().optional(),
@@ -14638,7 +14897,14 @@ var ConnectionSummarySchema2 = external_exports.object({
   /** Last presence heartbeat from a running agent process (POST /api/presence) — the
    *  desktop app while open. Null = never seen; stale = offline. */
   lastSeenAt: external_exports.string().datetime().nullable().optional(),
-  /** What a live desktop can run (companion.md §2.2), advertised on its heartbeat:
+  /** 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
+   *  `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.
+   *  With no work of its own for `WORKING_MS`, an agent sitting on this is not taking its work. */
+  oldestReadyAt: external_exports.string().datetime().nullable().optional(),
+  /** What a live desktop can run (docs/clients/desktop/companion.md §2.2), advertised on its heartbeat:
    *  harness availabilities + granted workspaces — the option set the phone's
    *  "new session" sheet offers. Absent for ordinary MCP agents. */
   runtime: external_exports.object({
@@ -14646,7 +14912,12 @@ var ConnectionSummarySchema2 = external_exports.object({
      *  shows its age here (`apps/desktop/src/update.ts`). */
     version: external_exports.string().optional(),
     harnesses: external_exports.array(external_exports.object({ name: external_exports.string(), label: external_exports.string(), status: external_exports.string() })).optional(),
-    workspaces: external_exports.array(external_exports.string()).optional()
+    workspaces: external_exports.array(external_exports.string()).optional(),
+    /** THE GIT REPOS IN THOSE FOLDERS (2026-10-01, Goal 26982211): each granted folder that is a
+     *  repo, and each repo directly inside one, with its `origin` remote. A session started for
+     *  work on `mauurda/paigy` opens in that repo rather than the folder above it, where the repo's
+     *  own AGENTS.md is never read (`workspaceForRepo`). Absent on hosts that predate it. */
+    repos: external_exports.array(external_exports.object({ path: external_exports.string(), remote: external_exports.string() })).optional()
   }).optional(),
   /** The tail of this agent's working log, when a harness is driving it — the agent page's
    *  live strip. Absent for anything the desktop harness isn't running (a hatched identity
@@ -14659,7 +14930,8 @@ var ConnectionSummarySchema2 = external_exports.object({
 });
 var LedgerItemSchema2 = external_exports.object({ id: external_exports.string(), parentId: external_exports.string(), title: external_exports.string(), createdAt: external_exports.string() });
 var AgentLedgerSchema2 = external_exports.object({
-  agent: external_exports.object({ id: external_exports.string(), name: external_exports.string(), revokedAt: external_exports.string().nullable() }),
+  /** Null when the agent has not named itself yet — never a placeholder (owner, 2026-10-01). */
+  agent: external_exports.object({ id: external_exports.string(), name: external_exports.string().nullable(), revokedAt: external_exports.string().nullable() }),
   /** Its own questions you have not answered. */
   asks: external_exports.array(LedgerItemSchema2),
   /** Its questions you answered that nobody acted on — still owed to somebody. */
@@ -14729,7 +15001,7 @@ var QueueQuestionSchema2 = external_exports.object({
    *  for a settled question whose reply carried nothing readable. */
   answer: external_exports.string().nullable().default(null),
   /** The Goal this question belongs to — a step knows its Goal on its own, not only through
-   *  an `InboxItem`'s `communication.goalIds[0]` (walk/design.md §12 item 3).
+   *  an `InboxItem`'s `communication.goalIds[0]` (docs/clients/app/walk/design.md §12 item 3).
    *  READ BY `apps/client/src/walk/order.ts`, which stamps it onto every `WalkStep`: the walk's
    *  order, its route, home's trees and the list of steps all take a step's Goal from here, so
    *  this is the field they agree through rather than each re-deriving it from the row it
@@ -14821,7 +15093,19 @@ var QueueItemSchema2 = external_exports.object({
     said: external_exports.string(),
     at: external_exports.string(),
     entryId: external_exports.string()
-  }).nullable().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
+   *  answer to a question, a voice note filed as work. Null when the only hands on it have been its
+   *  agent's; optional, so a hand-built queue (fixtures, the demo) and a door older than
+   *  20261001030911 need not spell it — `work/list.ts`'s `yoursAt` keeps its other sources, so the
+   *  Work tab orders as it did before the migration rather than throwing on the missing key.
+   *
+   *  It is a FACT, not a reconstruction: `latest` holds one Entry, so an agent's progress note a
+   *  minute after the person speaks erases their instant from it, and the durable traces the client
+   *  can see (`replies`, `questions[].answeredAt`) miss a spontaneous note entirely — a `request`
+   *  Entry with no `about_id` is in neither. */
+  lastPersonAt: external_exports.string().nullable().optional()
 });
 var COLD_AFTER_MS2 = 3 * 24 * 60 * 60 * 1e3;
 var NoteSourceSchema2 = external_exports.enum(["app", "call"]);
@@ -14851,7 +15135,7 @@ var NoteSchema2 = external_exports.object({
   assignee: external_exports.string().nullable(),
   /** The request thread minted at assignment; null until assigned. */
   parentId: external_exports.string().nullable(),
-  /** REMINDERS (reminders-design.md): the NOT-BEFORE this becomes eligible to ride a
+  /** REMINDERS (docs/model/notes/reminders-design.md): the NOT-BEFORE this becomes eligible to ride a
    *  call — never a deadline. It only ever comes from the user's own words, so when it
    *  passes Paigy rings ONCE (#1293, owner 2026-08-26: a time said out loud is consent to
    *  a ring at that time); after that it rides like any other. Null = "the very next
@@ -15111,6 +15395,31 @@ var SnapshotSchema2 = external_exports.object({
     computers: external_exports.array(ComputerRowSchema2).nullable()
   }).nullable()
 });
+var CallRecapSchema2 = external_exports.object({
+  call: external_exports.object({
+    status: external_exports.string(),
+    startedAt: external_exports.string(),
+    durationMs: external_exports.number().nullable(),
+    agents: external_exports.array(external_exports.object({ id: external_exports.string(), name: external_exports.string().nullable() }))
+  }),
+  topics: external_exports.array(external_exports.object({
+    goalId: external_exports.string().uuid(),
+    title: external_exports.string(),
+    owner: external_exports.string(),
+    state: external_exports.string(),
+    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. */
+    /** `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() }))
+  })),
+  unfiled: external_exports.array(external_exports.object({ lineId: external_exports.string().uuid(), words: external_exports.string(), atMs: external_exports.number() })),
+  more: external_exports.object({ lines: external_exports.number(), entries: external_exports.number(), topics: external_exports.number() })
+});
 
 // src/paigy/activity.ts
 function shortenPaths(s) {
@@ -15411,7 +15720,7 @@ var AcpDriver = class {
 var frame2 = (body) => JSON.stringify({ jsonrpc: "2.0", ...body });
 
 // src/paigy/inbox.ts
-import { mkdirSync as mkdirSync3, readdirSync as readdirSync3, renameSync, rmSync as rmSync2, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { mkdirSync as mkdirSync3, readdirSync as readdirSync4, renameSync, rmSync as rmSync2, statSync as statSync3, writeFileSync as writeFileSync3 } from "fs";
 import { join as join8 } from "path";
 import { homedir as homedir8 } from "os";
 import { randomUUID as randomUUID4 } from "crypto";
@@ -15423,7 +15732,7 @@ function openInbox(dir) {
   const receipt = (name) => join8(dir, "taken", `${name}.note`);
   const taken = (name) => {
     try {
-      return statSync2(receipt(name)).mtimeMs;
+      return statSync3(receipt(name)).mtimeMs;
     } catch (error) {
       if (missing(error)) return null;
       throw error;
@@ -15467,7 +15776,7 @@ var alive = (pid) => {
 };
 function inboxFor(root = INBOX_ROOT) {
   try {
-    for (const name of readdirSync3(root)) {
+    for (const name of readdirSync4(root)) {
       const pid = Number(name.split("-")[0]);
       if (!Number.isInteger(pid) || !alive(pid)) rmSync2(join8(root, name), { recursive: true, force: true });
     }
@@ -16494,7 +16803,9 @@ function startHost(opts) {
     void heartbeat({
       version: VERSION,
       harnesses: detectAll().map((a) => ({ name: a.name, label: a.label, status: a.status })),
-      workspaces: listWorkspaces(opts.wsDeps)
+      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)
     }, asHost).catch(() => {
     });
     void listenSlots().then(sweepSlots).catch(() => {
@@ -16540,6 +16851,31 @@ function startHost(opts) {
       void refreshIdentities();
       opts.log(`\u25B6 phone-launched ${label} (${spec.harness}) in ${spec.workspace}`);
     }
+    const ends = await claimSessionEnds(asHost).catch(() => []);
+    for (const end of ends) {
+      const result = await endSession(end, {
+        slotsFor: (agent2) => listSlots().filter((slot) => slot !== "Desktop" && slotIdentity(slot).tokenId === agent2),
+        pidsFor: (slot) => localHolderPids().get(slot) ?? [],
+        ownRun: (slot) => runs.get(runKey(slot))?.run ?? null,
+        isOwn: (pid) => descendsFrom(pid, process.pid),
+        kill: (pid, signal) => {
+          process.kill(pid, signal);
+        },
+        alive: (pid) => {
+          try {
+            process.kill(pid, 0);
+            return true;
+          } catch (e) {
+            return e.code === "EPERM";
+          }
+        },
+        sleep: (ms) => new Promise((r) => setTimeout(r, ms)),
+        log: opts.log
+      }).catch((e) => ({ ok: false, why: `end_threw: ${e.message}`.slice(0, 200) }));
+      opts.log(result.ok ? `\u25A0 ended ${end.which} copy of ${end.agent.slice(0, 8)}` : `\u25CC end of ${end.agent.slice(0, 8)} not done here: ${result.why}`);
+      await finishSessionEnd(end.endId, result, asHost).catch(() => {
+      });
+    }
   }
   async function presenceMap() {
     const presence = /* @__PURE__ */ new Map();
@@ -16564,6 +16900,14 @@ function startHost(opts) {
       const key = runKey(slot);
       if (slot === "Desktop" || isRevoked(slot)) return;
       const live = runs.get(key);
+      if (live) {
+        const theirs = (localHolderPids().get(slot) ?? []).map((p) => p.pid).filter((pid) => !descendsFrom(pid, process.pid));
+        if (theirs.length) {
+          opts.log(`session_stood_back ${JSON.stringify({ sessionId: slot, livePid: theirs[0] })} \u2014 a terminal runs this conversation; stopping this host's copy`);
+          live.run.stop();
+          return;
+        }
+      }
       const tokenId = slotIdentity(slot).tokenId;
       const seenByServer = tokenId ? presence.get(tokenId) : void 0;
       const holder = holders.get(slot);
@@ -16849,7 +17193,7 @@ ipcMain.handle("paigy:status", () => ({
   paired: Boolean(deviceToken()),
   device: Boolean(readToken(DEVICE_SLOT)),
   sessions: host?.sessions().map(([, label]) => label) ?? [],
-  // The party (companion.md / party design.md): who lives on this machine and what
+  // The party (docs/clients/desktop/companion.md / party design.md): who lives on this machine and what
   // each one is doing THIS SECOND — the one thing the laptop knows better than the phone.
   roster: host?.roster() ?? readHostState()?.roster ?? []
 }));