@paigy/harness 0.3.38 → 0.3.39

package/dist/cli.js

@@ -77,7 +77,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, models: entry.models };
+  const base = { name: entry.name, label: entry.label };
   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;
@@ -109,8 +109,7 @@ var init_catalog = __esm({
         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",
-        models: ["claude-3-5-sonnet-20241022", "claude-3-5-haiku-20241022", "claude-3-opus-20240229"]
+        installAdapter: "npm install -g @agentclientprotocol/claude-agent-acp"
       },
       {
         name: "codex",
@@ -120,8 +119,7 @@ var init_catalog = __esm({
         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",
-        models: ["gpt-4o", "gpt-4o-mini", "o1", "o1-mini"]
+        installAdapter: "npm install -g @agentclientprotocol/codex-acp"
       },
       {
         name: "agy",
@@ -131,8 +129,7 @@ var init_catalog = __esm({
         adapter: "paigy-agy-acp",
         authProbe: ["agy", "help"],
         loginHint: "Install and set up Antigravity (`agy`).",
-        installCli: "curl -fsSL https://antigravity.dev/install.sh | bash",
-        models: ["gemini-1.5-pro", "gemini-1.5-flash", "gemini-2.0-pro-exp"]
+        installCli: "curl -fsSL https://antigravity.dev/install.sh | bash"
       }
     ];
   }
@@ -301,8 +298,8 @@ var init_ZodError = __esm({
       "not_finite"
     ]);
     quotelessJson = (obj) => {
-      const json = JSON.stringify(obj, null, 2);
-      return json.replace(/"([^"]+)":/g, "$1:");
+      const json3 = JSON.stringify(obj, null, 2);
+      return json3.replace(/"([^"]+)":/g, "$1:");
     };
     ZodError = class _ZodError extends Error {
       get errors() {
@@ -23927,14 +23924,18 @@ async function hatch(name, voice = null, opts = {}) {
 }
 async function whoAmI(opts = {}) {
   try {
-    const res = await reach(`${BACKEND_URL}/api/identity`, {
-      headers: { authorization: `Bearer ${authToken(opts.token)}` }
-    });
-    return res.ok ? await res.json() : null;
+    return await readIdentity(opts);
   } catch {
     return null;
   }
 }
+async function readIdentity(opts = {}) {
+  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/identity`, {
+    headers: { authorization: `Bearer ${authToken(opts.token)}` }
+  }));
+  if (!res.ok) await fail("read_identity", res);
+  return await res.json();
+}
 async function claimSessions(opts = {}) {
   const res = await ensureAuthed(await reach(`${BACKEND_URL}/api/sessions/claim`, {
     headers: { authorization: `Bearer ${authToken(opts.token)}` }
@@ -24294,7 +24295,7 @@ ${block2}`;
   }
   return text.slice(0, start) + updated + text.slice(end);
 }
-var import_undici, require2, CODEX_ENV, BACKEND_URL, NETWORK_MSG, PROXY_ENV, agent, INSTANCE_ID, WORKSPACE_ID, envSession, lineage, CLIENT, ignoreOverride, defaultOptions, getDefaultOptions, getRefs, getRelativePath, parseCatchDef, integerDateParser, isJsonSchema7AllOfType, emojiRegex2, zodPatterns, ALPHA_NUMERIC, primitiveMappings, asAnyOf, parseOptionalDef, parsePipelineDef, parseReadonlyDef, selectParser, get$ref, addMeta, zodToJsonSchema, OPTIONS_MIN, OPTIONS_MAX, OPTION_LABEL_MAX, OPTION_HINT_MAX, OptionSchema, OptionInputSchema, NIGHT, ASK_MAX, UNITS_MAX, UNIT_TITLE_MAX, UNIT_BODY_MAX, UnitInputSchema, questionHandle, NodeRef, BlockedAction, reason, actionFits, ACTION_FITS, userExplicitlyRequested, units, UpdateInputSchema, questionFields, refineQuestion, QuestionInputSchema, QuestionWireSchema, AnswerInputSchema, QuestionDependencySchema, sendFields, ContactSchema, sendsAnything, ContactWireSchema, CONTACT_SCHEMA, CONTACT_DESCRIPTION, CreateGoalSchema, UpdateGoalSchema, changedGoal, goalTitle, GOAL_OUTCOME_MAX, goalOutcome, CreateChange, EditChange, StateChange, AssignChange, DeferChange, MoveChange, DependencyChange, read, GoalChangeSchema, editNames, ManageGoalsSchema, ManageGoalsToolSchema, MANAGE_GOALS_DESCRIPTION, GetGoalSchema, GET_GOAL_DESCRIPTION, SearchToolSchema, SEARCH_DESCRIPTION, CheckActivitySchema, FEEDBACK_TEXT_MAX, SendFeedbackSchema, SEND_FEEDBACK_DESCRIPTION, AGENT_TOOLS, AGENT_TOOL_NAMES, id, key, participant, SourceSchema, ResultRefSchema, NodeRefSchema, DependencySchema, goalState, existingGoalChanges, BrainGoalChangeSchema, option, QuestionChangeSchema, lessonScope, LessonChangeSchema, BrainNextSchema, messageBase, BrainMessageSchema, BrainSearchSchema, BrainResultSchema, str, strs, CompactResultSchema, COMPACT_RESULT_JSON_SCHEMA, str2, strs2, TalkerReplySchema, TALKER_REPLY_JSON_SCHEMA, str3, strs3, FilerReplySchema, FILER_REPLY_JSON_SCHEMA, ExplainerReplySchema, EXPLAINER_REPLY_JSON_SCHEMA, DISTILLER_DEFECTS, DistillerReplySchema, DISTILLER_REPLY_JSON_SCHEMA, TIDY_AUDIENCES, TidyReplySchema, TIDY_REPLY_JSON_SCHEMA, LIVE_MS, WORKING_MS, WORKING_TIER_MS, RECENT_TIER_MS, ContextSchema, ParticipantSchema, TransformSchema, VisualSchema, NotifyLevelSchema, SelectShapeSchema, ReceiptEventSchema, AttentionSchema, NotifyRequestFields, NotifyRequestSchema, NotifyStatusSchema, AgentStateSchema, TurnSchema, UserAnswerSchema, IntentSchema, RideAlongSchema, AwaitItemSchema, VoiceKeySchema, AgendaTurnSchema, CLAIM_STALE_MS, InboxItemSchema, APNS_TOKEN_RE, PushTokenSchema, MissedCallSchema, clock, QUIET, BrokerTuningSchema, UserSettingsSchema, HistoryWorkSchema, HistoryEntrySchema, HistoryPageSchema, ACTIVITY_LINES, ACTIVITY_LINE_MAX, AgentActivitySchema, ConnectionSummarySchema, LedgerItemSchema, AgentLedgerSchema, ReassignResultSchema, LessonStateSchema, LessonViewSchema, QueueQuestionSchema, QueueReplySchema, QueueItemSchema, QueueDeltaSchema, COLD_AFTER_MS, NoteSourceSchema, NoteStatusSchema, NoteRepeatSchema, DecisionSchema, NoteSchema, TriageItemSchema, TriageAssignmentSchema, TriageStatusSchema, SubmitTriageSchema, TriageProposalSchema, AcceptTriageSchema, AcceptTriageResultSchema, DeliveryModeSchema, WAKE_EVENT, wakeChannel, RegisterDeliverySchema, OAuthStartSchema, DeliveryConfigSchema, HostDecisionSchema, WakeNudgeSchema, PairingStatusSchema, DeviceCodeSchema, DeviceInfoSchema, DeviceTokenSchema, SupportRequestSchema, NotificationFeedbackKindSchema, SlimOptionSchema, QuestionRowSchema, WorkStateSchema, WorkRowSchema, ComputerRowSchema, AgentRowSchema, SnapshotSchema, CallRecapSchema, TOKEN_PATH, KEY_PATH, sleep, UnpairedError, RevokedError, ApiError, tokenOverride, authToken, AWAIT_WINDOW_MS, NOT_SENT, APPLIED, DEMOTED, HEARTBEAT_MS, RETRY_MS, JOIN, JOIN_TIMEOUT_MS, lines;
+var import_undici, require2, CODEX_ENV, BACKEND_URL, NETWORK_MSG, PROXY_ENV, agent, INSTANCE_ID, WORKSPACE_ID, envSession, lineage, CLIENT, ignoreOverride, defaultOptions, getDefaultOptions, getRefs, getRelativePath, parseCatchDef, integerDateParser, isJsonSchema7AllOfType, emojiRegex2, zodPatterns, ALPHA_NUMERIC, primitiveMappings, asAnyOf, parseOptionalDef, parsePipelineDef, parseReadonlyDef, selectParser, get$ref, addMeta, zodToJsonSchema, OPTIONS_MIN, OPTIONS_MAX, OPTION_LABEL_MAX, OPTION_HINT_MAX, OptionSchema, OptionInputSchema, NIGHT, ASKING_RULES, ASK_MAX, UNITS_MAX, UNIT_TITLE_MAX, UNIT_BODY_MAX, UnitInputSchema, questionHandle, NodeRef, BlockedAction, reason, actionFits, ACTION_FITS, userExplicitlyRequested, units, UpdateInputSchema, questionFields, refineQuestion, QuestionInputSchema, QuestionWireSchema, AnswerInputSchema, QuestionDependencySchema, sendFields, ContactSchema, sendsAnything, ContactWireSchema, CONTACT_SCHEMA, CONTACT_DESCRIPTION, CreateGoalSchema, UpdateGoalSchema, changedGoal, goalTitle, GOAL_OUTCOME_MAX, goalOutcome, CreateChange, EditChange, StateChange, AssignChange, DeferChange, MoveChange, DependencyChange, read, GoalChangeSchema, editNames, ManageGoalsSchema, ManageGoalsToolSchema, MANAGE_GOALS_DESCRIPTION, GetGoalSchema, GetDeliverySchema, GET_DELIVERY_DESCRIPTION, GET_GOAL_DESCRIPTION, SearchToolSchema, SEARCH_DESCRIPTION, ConfigureIdentitySchema, CONFIGURE_IDENTITY_DESCRIPTION, CheckActivitySchema, FEEDBACK_TEXT_MAX, SendFeedbackSchema, SEND_FEEDBACK_DESCRIPTION, AGENT_TOOLS, AGENT_TOOL_NAMES, id, key, participant, SourceSchema, ResultRefSchema, NodeRefSchema, DependencySchema, goalState, existingGoalChanges, BrainGoalChangeSchema, option, QuestionChangeSchema, lessonScope, LessonChangeSchema, BrainNextSchema, messageBase, BrainMessageSchema, BrainSearchSchema, BrainResultSchema, str, strs, CompactResultSchema, COMPACT_RESULT_JSON_SCHEMA, str2, strs2, TalkerReplySchema, TALKER_REPLY_JSON_SCHEMA, str3, strs3, FilerReplySchema, FILER_REPLY_JSON_SCHEMA, ExplainerReplySchema, EXPLAINER_REPLY_JSON_SCHEMA, DISTILLER_DEFECTS, DistillerReplySchema, DISTILLER_REPLY_JSON_SCHEMA, TIDY_AUDIENCES, TidyReplySchema, TIDY_REPLY_JSON_SCHEMA, LIVE_MS, WORKING_MS, WORKING_TIER_MS, RECENT_TIER_MS, json, clock, HeardEventSchema, HeardCursorSchema, HeardPageSchema, MAX_EVENTS, MAX_BYTES, batchBytes, HeardBatchSchema, ContextSchema, ParticipantSchema, TransformSchema, VisualSchema, NotifyLevelSchema, SelectShapeSchema, ReceiptEventSchema, AttentionSchema, NotifyRequestFields, NotifyRequestSchema, NotifyStatusSchema, AgentStateSchema, TurnSchema, UserAnswerSchema, IntentSchema, RideAlongSchema, AwaitItemSchema, VoiceKeySchema, AgendaTurnSchema, CLAIM_STALE_MS, InboxItemSchema, APNS_TOKEN_RE, PushTokenSchema, MissedCallSchema, clock2, QUIET, BrokerTuningSchema, UserSettingsSchema, HistoryWorkSchema, HistoryEntrySchema, HistoryPageSchema, ACTIVITY_LINES, ACTIVITY_LINE_MAX, AgentActivitySchema, ConnectionSummarySchema, LedgerItemSchema, AgentLedgerSchema, ReassignResultSchema, LessonStateSchema, LessonViewSchema, QueueQuestionSchema, QueueReplySchema, QueueItemSchema, QueueDeltaSchema, COLD_AFTER_MS, NoteSourceSchema, NoteStatusSchema, NoteRepeatSchema, DecisionSchema, NoteSchema, TriageItemSchema, TriageAssignmentSchema, TriageStatusSchema, SubmitTriageSchema, TriageProposalSchema, AcceptTriageSchema, AcceptTriageResultSchema, DeliveryModeSchema, WAKE_EVENT, wakeChannel, RegisterDeliverySchema, OAuthStartSchema, DeliveryConfigSchema, HostDecisionSchema, WakeNudgeSchema, PairingStatusSchema, DeviceCodeSchema, DeviceInfoSchema, DeviceTokenSchema, SupportRequestSchema, NotificationFeedbackKindSchema, SlimOptionSchema, QuestionRowSchema, WorkStateSchema, WorkRowSchema, ComputerRowSchema, AgentRowSchema, SnapshotSchema, CallRecapSchema, TOKEN_PATH, KEY_PATH, sleep, UnpairedError, RevokedError, ApiError, tokenOverride, authToken, AWAIT_WINDOW_MS, NOT_SENT, APPLIED, DEMOTED, HEARTBEAT_MS, RETRY_MS, JOIN, JOIN_TIMEOUT_MS, lines;
 var init_dist = __esm({
   "../../packages/sdk/dist/index.js"() {
     "use strict";
@@ -24310,6 +24311,7 @@ var init_dist = __esm({
     init_zod();
     init_zod();
     init_zod();
+    init_zod();
     import_undici = __toESM(require_undici(), 1);
     require2 = __sdkCreateRequire(import.meta.url);
     CODEX_ENV = ["CODEX_THREAD_ID", "CODEX_SESSION_ID", "CODEX_HOME", "PAIGY_TOKEN", "PAIGY_SESSION_ID", "PAIGY_HARNESS", "PAIGY_INSTANCE_ID", "PAIGY_ON_WAKE"];
@@ -24718,6 +24720,16 @@ var init_dist = __esm({
       imgUrl: OptionSchema.shape.image
     }).strict();
     NIGHT = { from: 23, to: 7 };
+    ASKING_RULES = `HOW TO ASK:
+1. Write one question per object. Five questions are five objects in \`questions\`, in one contact, so each can be answered on its own; one question with five parts settles nothing until all five are answered.
+2. Name the Goal you are working on as the question's \`goalId\`: the question goes onto that Goal and its answer comes back there. It must exist: create it with manage_goals first.
+3. \`workItBlocks\` only for work you are truly blocked on (it asks for a call); leave it out for a question you can keep working around.
+4. Never hold the process open with while-loops. A wait that comes back \`expired\` is not a finished conversation: wait again with contact({wait:true}) only while you have nothing else to do. While a Call you placed is open, keep receiving window after window until it ends, even when a window is empty: the person may give follow-ups or instructions. With no open Call, STOP WAITING when a window comes back with nothing new \u2014 the question stays open, and its answer reaches you on the Goal. Otherwise, yield only with a working listener or scheduled wakeup, and collect answers with \`contact({wait:false})\` or \`get_goal\` on that wake.
+5. One question, one row. Never restate a question that is still waiting inside a new contact: keep waiting on the original, or the answer lands on one copy and the other stays open. Take back one that no longer matters with \`withdrawQuestionIds\`.
+6. Read the Goal's conversation before asking. Never ask again what was answered or already shipped \u2014 and tell its states apart: \`answered\` carries the choice in \`answer\`, while \`replied\` means they said something and chose none of your options, so that question is still yours to settle and their words are the line beside it.
+7. A question carries its options when you have them; a free-text question may omit them. Each option\u2019s label must stand on its own and name its choice in full -- never \`All three\` or \`Option 2\`. \`pickMode: "many"\` makes the card a checklist (options they may want several of); \`"one"\`, the default, a pick (one rules out the others); \`"rank"\` an ordering. Each question is sent exactly as written, with no reading in between. They can always answer in their own words, so never add an 'Other' option.
+8. A diagnosis says when, why and how it happens, then proposes one fix. Never options first.
+9. 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. 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. Requested delivery and completed-Goal reports require a reply (reply_required); ordinary progress may omit it.`;
     ASK_MAX = 250;
     UNITS_MAX = 12;
     UNIT_TITLE_MAX = 50;
@@ -24766,10 +24778,18 @@ var init_dist = __esm({
       // 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.`
+        `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. The reply is required for requested delivery and completed Goals; ordinary progress may omit it.`
       ).optional(),
       userExplicitlyRequested
     }).strict().superRefine((u, ctx) => {
+      if (u.userExplicitlyRequested && !u.reply) {
+        ctx.addIssue({
+          code: external_exports.ZodIssueCode.custom,
+          path: ["reply"],
+          params: { refusal: "reply_required" },
+          message: "reply_required: an update requested for delivery needs one reply, written in the person\u2019s voice for this report."
+        });
+      }
       refuseOverCaps(u.message, u.units, "message", ctx);
       if (u.reply && u.reply.length > OPTION_LABEL_MAX) {
         ctx.addIssue({
@@ -24857,14 +24877,10 @@ var init_dist = __esm({
       questions: external_exports.array(QuestionWireSchema).min(1).max(20).optional()
     }).strict().refine(sendsAnything, "a contact sends at least one update, question, answer, withdrawal or question dependency");
     CONTACT_SCHEMA = { type: "object", ...mcpInputSchema(ContactSchema) };
-    CONTACT_DESCRIPTION = `Send to and receive from the person: updates, questions, answers to questions addressed to you, withdrawals of your own questions, and what a question holds up. Every Goal you name must already exist: create it with manage_goals first; an unknown Goal is refused and nothing is sent. Every item applies on its own: read \`results\`, where a failed item names why while the rest still apply.
-
-QUESTIONS: one question per object; several questions are several objects in one contact, so each can be answered on its own. Each is sent exactly as written, with no reading in between: a bundled question arrives as one card. Give options when you have them. 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'). pickMode:'one' (the default) makes a pick, for alternatives; 'many' a checklist, for independent options they may want several of; 'rank' an ordering. The person can always answer in their own words, so never add an 'Other' option. workItBlocks names the work a question holds up, only when you are truly blocked: it asks for a call. Answers land on the question's Goal: collect them by receiving (below) or with get_goal.
+    CONTACT_DESCRIPTION = "Send to and receive from the person: updates, questions, answers to questions addressed to you, withdrawals of your own questions, and what a question holds up. Every Goal you name must already exist: create it with manage_goals first; an unknown Goal is refused and nothing is sent. Every item applies on its own: read `results`, where a failed item names why while the rest still apply.\n\n" + ASKING_RULES + `
 
 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\`).`;
@@ -24970,6 +24986,10 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
        *  between two of them named. Off by default; `docs/model/goal/diagnose-design.md`. */
       diagnose: external_exports.boolean().optional()
     }).strict();
+    GetDeliverySchema = external_exports.object({
+      deliveryId: external_exports.string().uuid().describe("The Delivery id returned by contact or receive.")
+    }).strict();
+    GET_DELIVERY_DESCRIPTION = "Read a Delivery in full: its whole ask, units, options and answers, plus current callState and callOutcome for a Call. Any agent of the same account may read it; another account is not disclosed. Reading never acknowledges or resends anything. Use this after a call or when receive names a Call you are waiting on.";
     GET_GOAL_DESCRIPTION = "Read one Goal (a read never puts you on it), including others (the ten most recent other contributors, with names, latest entry headlines and times): 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. Every Goal of your person is readable, whichever of their agents owns it; another account's Goals 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.";
     SearchToolSchema = external_exports.object({
       query: external_exports.string().trim().min(1).max(500),
@@ -24978,6 +24998,8 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
       limit: external_exports.number().int().min(1).max(20).optional()
     }).strict();
     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.";
+    ConfigureIdentitySchema = external_exports.object({}).strict();
+    CONFIGURE_IDENTITY_DESCRIPTION = "Read this authenticated agent\u2019s current name, voice and token ID. Read-only; no arguments. Pairing, renaming and logout are available only through the local configure driver.";
     CheckActivitySchema = external_exports.object({}).strict();
     FEEDBACK_TEXT_MAX = 5e4;
     SendFeedbackSchema = external_exports.object({
@@ -24987,8 +25009,10 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
     }).strict();
     SEND_FEEDBACK_DESCRIPTION = "Send feedback about Paigy itself (a bug report, an idea) straight to the Paigy team. Send it only when the person asked you to, or agreed when you offered: it goes to Paigy, never to the person, and nobody answers it here. Not for your work or a question for the person: use contact for those. Returns whether it was stored.";
     AGENT_TOOLS = [
+      { name: "configure", description: CONFIGURE_IDENTITY_DESCRIPTION, inputSchema: mcpInputSchema(ConfigureIdentitySchema) },
       { name: "contact", description: CONTACT_DESCRIPTION, inputSchema: CONTACT_SCHEMA },
       { name: "manage_goals", description: MANAGE_GOALS_DESCRIPTION, inputSchema: mcpInputSchema(ManageGoalsToolSchema) },
+      { name: "get_delivery", description: GET_DELIVERY_DESCRIPTION, inputSchema: mcpInputSchema(GetDeliverySchema) },
       { name: "get_goal", description: GET_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(GetGoalSchema) },
       { name: "search", description: SEARCH_DESCRIPTION, inputSchema: mcpInputSchema(SearchToolSchema) },
       { name: "check_activity", description: "Read your person's agents that contributed in the last 24 hours, newest first: at most 30 agents and their five most recently touched Goals, with their latest entry headline and time. Use get_goal to read a Goal and its other contributors before starting overlapping work. Read-only; no arguments.", inputSchema: mcpInputSchema(CheckActivitySchema) },
@@ -25255,6 +25279,42 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
     WORKING_MS = 60 * 6e4;
     WORKING_TIER_MS = 2 * 60 * 6e4;
     RECENT_TIER_MS = 24 * 60 * 6e4;
+    json = external_exports.lazy(() => external_exports.union([
+      external_exports.string(),
+      external_exports.number().finite(),
+      external_exports.boolean(),
+      external_exports.null(),
+      external_exports.array(json),
+      external_exports.record(json)
+    ]));
+    clock = external_exports.number().int().nonnegative().safe();
+    HeardEventSchema = external_exports.object({
+      eventId: external_exports.string().uuid(),
+      source: external_exports.enum(["phone", "bot"]),
+      sequence: clock,
+      kind: external_exports.string().min(1),
+      phoneAtMs: clock.optional(),
+      botAtMs: clock.optional(),
+      payload: external_exports.record(json)
+    }).strict();
+    HeardCursorSchema = HeardEventSchema.pick({ source: true, sequence: true, eventId: true });
+    HeardPageSchema = external_exports.object({
+      events: external_exports.array(HeardEventSchema).max(200),
+      next: HeardCursorSchema.nullable()
+    }).strict();
+    MAX_EVENTS = 50;
+    MAX_BYTES = 8e4;
+    batchBytes = (events) => {
+      let bytes = 0;
+      for (const char of JSON.stringify({ events })) {
+        const point = char.codePointAt(0);
+        bytes += point < 128 ? 1 : point < 2048 ? 2 : point < 65536 ? 3 : 4;
+      }
+      return bytes;
+    };
+    HeardBatchSchema = external_exports.object({
+      events: external_exports.array(HeardEventSchema).min(1).max(MAX_EVENTS)
+    }).strict().refine((value) => batchBytes(value.events) <= MAX_BYTES, "heard_batch_too_large");
     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(
@@ -25811,8 +25871,8 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
       "inbox",
       "dismiss"
     ]);
-    clock = (h) => h === 0 ? "midnight" : h === 12 ? "noon" : h < 12 ? `${h} am` : `${h - 12} pm`;
-    QUIET = ` Nothing rings from ${clock(NIGHT.from)} to ${clock(NIGHT.to)} your time; the count waits for morning.`;
+    clock2 = (h) => h === 0 ? "midnight" : h === 12 ? "noon" : h < 12 ? `${h} am` : `${h - 12} pm`;
+    QUIET = ` Nothing rings from ${clock2(NIGHT.from)} to ${clock2(NIGHT.to)} your time; the count waits for morning.`;
     BrokerTuningSchema = external_exports.object({
       /** 'none' = skip the spoken ack after a mapped answer (power users find it slow). */
       ackVerbosity: external_exports.enum(["normal", "none"]).optional(),
@@ -26127,7 +26187,13 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
         /** 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()
+        summary: external_exports.string().optional(),
+        /** AN AGENT'S UPDATE OR QUESTION AS ITS UNITS' TITLES (owner, 2026-10-08: "send the 50 chars from the title
+         *  of each unit"): each at most 50 characters, in order; absent when it has none. */
+        titles: external_exports.array(external_exports.string()).optional(),
+        /** A PROGRESS NOTE'S ONE POINT ("An agent's progress note -> maybe let's cap it at 200 chars"): the
+         *  update's own line, before its units; the row caps it at 200. Absent on anything else. */
+        line: 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
@@ -26501,7 +26567,9 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
         words: external_exports.string(),
         atMs: external_exports.number()
       })),
-      more: external_exports.object({ lines: external_exports.number(), entries: external_exports.number(), topics: external_exports.number() })
+      more: external_exports.object({ lines: external_exports.number(), entries: external_exports.number(), topics: external_exports.number() }),
+      /** Last stored position on this page when another exists; absent before paging shipped. */
+      next: external_exports.number().int().nonnegative().nullable().optional()
     });
     TOKEN_PATH = join22(homedir22(), ".paigy", "token.json");
     KEY_PATH = join22(homedir22(), ".paigy", "key.json");
@@ -31430,11 +31498,11 @@ function extractJson(raw) {
   return null;
 }
 function parseVerdicts(raw, knownIds, knownAgents) {
-  const json = extractJson(raw);
-  if (!json) return { ok: false, error: "no JSON found in the model's answer", raw };
+  const json3 = extractJson(raw);
+  if (!json3) return { ok: false, error: "no JSON found in the model's answer", raw };
   let parsed;
   try {
-    parsed = JSON.parse(json);
+    parsed = JSON.parse(json3);
   } catch (e) {
     return { ok: false, error: `JSON.parse failed: ${e.message}`, raw };
   }
@@ -31680,13 +31748,17 @@ var init_triage = __esm({
 init_catalog();
 
 // src/cli-args.ts
+init_zod();
 var TRIAGE_VIA = ["ollama", "claude", "codex", "agy"];
 var USAGE = "usage: paigy-harness setup | pair | host [--grant DIR]\u2026 | service | enable-tools [--scope user|project] | hatch NAME [--voice KEY] [--slot SLOT] | launch NAME [--under GOAL] [--voice KEY] [--harness \u2026] [--mode \u2026] [--cwd DIR] BRIEF\u2026 | handoff | triage [--via ollama|claude|codex|agy] [--json] [--apply [--yes-close] [--yes-stale] [--yes-assign]] | [--harness claude|codex|agy] [--mode bypass|ask] [--cwd DIR] [--grace SECONDS] [--doctor] PROMPT\u2026";
 function parseArgs(argv) {
   const args = { harness: "claude", mode: "bypass", cwd: process.cwd(), doctor: false, help: false, host: false, pair: false, service: false, setup: false, enableTools: false, scope: "user", grant: [], hatch: null, voice: null, slot: null, launch: null, under: null, graceSeconds: 90, prompt: "", handoff: false, triage: false, via: null, json: false, apply: false, yesClose: false, yesStale: false, yesAssign: false };
   const words2 = [];
+  let commandPosition = true;
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
+    const command = commandPosition && !!arg && !arg.startsWith("-");
+    if (command) commandPosition = false;
     const next = () => argv[++i];
     if (arg === "--harness") {
       const v = next();
@@ -31702,7 +31774,7 @@ function parseArgs(argv) {
       args.cwd = v;
     } else if (arg === "--doctor") {
       args.doctor = true;
-    } else if (arg === "-h" || arg === "--help" || arg === "help") {
+    } else if (arg === "-h" || arg === "--help" || command && arg === "help") {
       args.help = true;
     } else if (arg === "--scope") {
       const v = next();
@@ -31712,21 +31784,21 @@ function parseArgs(argv) {
       const v = Number(next());
       if (!Number.isFinite(v) || v < 0) return { error: "--grace needs seconds (0 = straight to phone)" };
       args.graceSeconds = v;
-    } else if (arg === "host") {
+    } else if (command && arg === "host") {
       args.host = true;
-    } else if (arg === "pair") {
+    } else if (command && arg === "pair") {
       args.pair = true;
-    } else if (arg === "setup") {
+    } else if (command && arg === "setup") {
       args.setup = true;
-    } else if (arg === "service") {
+    } else if (command && arg === "service") {
       args.service = true;
     } else if (arg === "--grant") {
       const v = next();
       if (!v) return { error: "--grant needs a folder to allow" };
       args.grant.push(v);
-    } else if (arg === "handoff") {
+    } else if (command && arg === "handoff") {
       args.handoff = true;
-    } else if (arg === "triage") {
+    } else if (command && arg === "triage") {
       args.triage = true;
     } else if (arg === "--via") {
       const v = next();
@@ -31743,9 +31815,9 @@ function parseArgs(argv) {
       args.yesStale = true;
     } else if (arg === "--yes-assign") {
       args.yesAssign = true;
-    } else if (arg === "enable-tools") {
+    } else if (command && arg === "enable-tools") {
       args.enableTools = true;
-    } else if (arg === "hatch") {
+    } else if (command && arg === "hatch") {
       const v = next();
       if (!v) return { error: 'hatch needs a name: paigy-harness hatch "Voice bug hunter"' };
       args.hatch = v;
@@ -31755,12 +31827,14 @@ function parseArgs(argv) {
       args.slot = next() ?? null;
     } else if (arg === "--identity") {
       return { error: '--identity is gone: start a helper with `paigy-harness launch NAME "brief"`, which gives it its own session' };
-    } else if (arg === "launch") {
+    } else if (command && arg === "launch") {
       const v = next();
       if (!v) return { error: 'launch needs a name: paigy-harness launch "Deploy check" "brief"' };
       args.launch = v;
     } else if (arg === "--under") {
-      args.under = next() ?? null;
+      const v = next();
+      if (!v || !external_exports.string().uuid().safeParse(v).success) return { error: "--under needs a Goal UUID" };
+      args.under = v;
     } else if (arg?.startsWith("--")) {
       return { error: `unknown flag ${arg}` };
     } else if (arg) {
@@ -31769,6 +31843,7 @@ function parseArgs(argv) {
   }
   args.prompt = words2.join(" ");
   if (args.help) return args;
+  if (args.under && !args.launch) return { error: "--under requires launch NAME" };
   if (args.launch && !args.prompt) return { error: 'launch needs a brief: paigy-harness launch "Deploy check" "brief"' };
   if (!args.doctor && !args.handoff && !args.hatch && !args.host && !args.pair && !args.service && !args.setup && !args.enableTools && !args.triage && !args.prompt) return { error: "a prompt is required (or setup / --doctor / pair / host / service / enable-tools / hatch NAME / handoff / triage)" };
   if ((args.yesClose || args.yesStale || args.yesAssign) && !args.apply)
@@ -32192,8 +32267,7 @@ function startSession(opts) {
   if (!existsSync3(cwd)) {
     queueMicrotask(() => opts.onEvent({ kind: "error", message: `workspace does not exist: ${cwd}` }));
   }
-  let codexConfig = opts.harness === "codex" ? JSON.parse(process.env.CODEX_CONFIG || "{}") : null;
-  if (opts.model && opts.harness === "codex") codexConfig = { ...codexConfig, model: opts.model };
+  const codexConfig = opts.harness === "codex" ? JSON.parse(process.env.CODEX_CONFIG || "{}") : null;
   if (codexConfig) {
     const key3 = "mcp_servers.paigy.env_vars";
     const configPath = join5(process.env.CODEX_HOME || join5(homedir4(), ".codex"), "config.toml");
@@ -32219,8 +32293,6 @@ function startSession(opts) {
       PATH: [process.env.PATH, ...probeDirs()].filter(Boolean).join(delimiter2),
       ...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
@@ -33599,6 +33671,7 @@ init_zod();
 init_zod();
 init_zod();
 init_zod();
+init_zod();
 var OPTIONS_MIN2 = 2;
 var OPTIONS_MAX2 = 6;
 var OPTION_LABEL_MAX2 = 50;
@@ -33628,6 +33701,16 @@ var OptionInputSchema2 = external_exports.object({
   imgUrl: OptionSchema2.shape.image
 }).strict();
 var NIGHT2 = { from: 23, to: 7 };
+var ASKING_RULES2 = `HOW TO ASK:
+1. Write one question per object. Five questions are five objects in \`questions\`, in one contact, so each can be answered on its own; one question with five parts settles nothing until all five are answered.
+2. Name the Goal you are working on as the question's \`goalId\`: the question goes onto that Goal and its answer comes back there. It must exist: create it with manage_goals first.
+3. \`workItBlocks\` only for work you are truly blocked on (it asks for a call); leave it out for a question you can keep working around.
+4. Never hold the process open with while-loops. A wait that comes back \`expired\` is not a finished conversation: wait again with contact({wait:true}) only while you have nothing else to do. While a Call you placed is open, keep receiving window after window until it ends, even when a window is empty: the person may give follow-ups or instructions. With no open Call, STOP WAITING when a window comes back with nothing new \u2014 the question stays open, and its answer reaches you on the Goal. Otherwise, yield only with a working listener or scheduled wakeup, and collect answers with \`contact({wait:false})\` or \`get_goal\` on that wake.
+5. One question, one row. Never restate a question that is still waiting inside a new contact: keep waiting on the original, or the answer lands on one copy and the other stays open. Take back one that no longer matters with \`withdrawQuestionIds\`.
+6. Read the Goal's conversation before asking. Never ask again what was answered or already shipped \u2014 and tell its states apart: \`answered\` carries the choice in \`answer\`, while \`replied\` means they said something and chose none of your options, so that question is still yours to settle and their words are the line beside it.
+7. A question carries its options when you have them; a free-text question may omit them. Each option\u2019s label must stand on its own and name its choice in full -- never \`All three\` or \`Option 2\`. \`pickMode: "many"\` makes the card a checklist (options they may want several of); \`"one"\`, the default, a pick (one rules out the others); \`"rank"\` an ordering. Each question is sent exactly as written, with no reading in between. They can always answer in their own words, so never add an 'Other' option.
+8. A diagnosis says when, why and how it happens, then proposes one fix. Never options first.
+9. 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. 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. Requested delivery and completed-Goal reports require a reply (reply_required); ordinary progress may omit it.`;
 function draft20202(node) {
   if (Array.isArray(node)) return node.map(draft20202);
   if (node && typeof node === "object") {
@@ -33746,10 +33829,18 @@ var UpdateInputSchema2 = external_exports.object({
   // 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.`
+    `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. The reply is required for requested delivery and completed Goals; ordinary progress may omit it.`
   ).optional(),
   userExplicitlyRequested: userExplicitlyRequested2
 }).strict().superRefine((u, ctx) => {
+  if (u.userExplicitlyRequested && !u.reply) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      path: ["reply"],
+      params: { refusal: "reply_required" },
+      message: "reply_required: an update requested for delivery needs one reply, written in the person\u2019s voice for this report."
+    });
+  }
   refuseOverCaps2(u.message, u.units, "message", ctx);
   if (u.reply && u.reply.length > OPTION_LABEL_MAX2) {
     ctx.addIssue({
@@ -33837,14 +33928,10 @@ var ContactWireSchema2 = external_exports.object({
   questions: external_exports.array(QuestionWireSchema2).min(1).max(20).optional()
 }).strict().refine(sendsAnything2, "a contact sends at least one update, question, answer, withdrawal or question dependency");
 var CONTACT_SCHEMA2 = { type: "object", ...mcpInputSchema2(ContactSchema2) };
-var CONTACT_DESCRIPTION2 = `Send to and receive from the person: updates, questions, answers to questions addressed to you, withdrawals of your own questions, and what a question holds up. Every Goal you name must already exist: create it with manage_goals first; an unknown Goal is refused and nothing is sent. Every item applies on its own: read \`results\`, where a failed item names why while the rest still apply.
-
-QUESTIONS: one question per object; several questions are several objects in one contact, so each can be answered on its own. Each is sent exactly as written, with no reading in between: a bundled question arrives as one card. Give options when you have them. 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'). pickMode:'one' (the default) makes a pick, for alternatives; 'many' a checklist, for independent options they may want several of; 'rank' an ordering. The person can always answer in their own words, so never add an 'Other' option. workItBlocks names the work a question holds up, only when you are truly blocked: it asks for a call. Answers land on the question's Goal: collect them by receiving (below) or with get_goal.
+var CONTACT_DESCRIPTION2 = "Send to and receive from the person: updates, questions, answers to questions addressed to you, withdrawals of your own questions, and what a question holds up. Every Goal you name must already exist: create it with manage_goals first; an unknown Goal is refused and nothing is sent. Every item applies on its own: read `results`, where a failed item names why while the rest still apply.\n\n" + ASKING_RULES2 + `
 
 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\`).`;
@@ -33950,6 +34037,10 @@ var GetGoalSchema2 = external_exports.object({
    *  between two of them named. Off by default; `docs/model/goal/diagnose-design.md`. */
   diagnose: external_exports.boolean().optional()
 }).strict();
+var GetDeliverySchema2 = external_exports.object({
+  deliveryId: external_exports.string().uuid().describe("The Delivery id returned by contact or receive.")
+}).strict();
+var GET_DELIVERY_DESCRIPTION2 = "Read a Delivery in full: its whole ask, units, options and answers, plus current callState and callOutcome for a Call. Any agent of the same account may read it; another account is not disclosed. Reading never acknowledges or resends anything. Use this after a call or when receive names a Call you are waiting on.";
 var GET_GOAL_DESCRIPTION2 = "Read one Goal (a read never puts you on it), including others (the ten most recent other contributors, with names, latest entry headlines and times): 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. Every Goal of your person is readable, whichever of their agents owns it; another account's Goals 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 SearchToolSchema2 = external_exports.object({
   query: external_exports.string().trim().min(1).max(500),
@@ -33958,6 +34049,8 @@ var SearchToolSchema2 = external_exports.object({
   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 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 ConfigureIdentitySchema2 = external_exports.object({}).strict();
+var CONFIGURE_IDENTITY_DESCRIPTION2 = "Read this authenticated agent\u2019s current name, voice and token ID. Read-only; no arguments. Pairing, renaming and logout are available only through the local configure driver.";
 var CheckActivitySchema2 = external_exports.object({}).strict();
 var FEEDBACK_TEXT_MAX2 = 5e4;
 var SendFeedbackSchema2 = external_exports.object({
@@ -33967,8 +34060,10 @@ var SendFeedbackSchema2 = external_exports.object({
 }).strict();
 var SEND_FEEDBACK_DESCRIPTION2 = "Send feedback about Paigy itself (a bug report, an idea) straight to the Paigy team. Send it only when the person asked you to, or agreed when you offered: it goes to Paigy, never to the person, and nobody answers it here. Not for your work or a question for the person: use contact for those. Returns whether it was stored.";
 var AGENT_TOOLS2 = [
+  { name: "configure", description: CONFIGURE_IDENTITY_DESCRIPTION2, inputSchema: mcpInputSchema2(ConfigureIdentitySchema2) },
   { name: "contact", description: CONTACT_DESCRIPTION2, inputSchema: CONTACT_SCHEMA2 },
   { name: "manage_goals", description: MANAGE_GOALS_DESCRIPTION2, inputSchema: mcpInputSchema2(ManageGoalsToolSchema2) },
+  { name: "get_delivery", description: GET_DELIVERY_DESCRIPTION2, inputSchema: mcpInputSchema2(GetDeliverySchema2) },
   { name: "get_goal", description: GET_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(GetGoalSchema2) },
   { name: "search", description: SEARCH_DESCRIPTION2, inputSchema: mcpInputSchema2(SearchToolSchema2) },
   { name: "check_activity", description: "Read your person's agents that contributed in the last 24 hours, newest first: at most 30 agents and their five most recently touched Goals, with their latest entry headline and time. Use get_goal to read a Goal and its other contributors before starting overlapping work. Read-only; no arguments.", inputSchema: mcpInputSchema2(CheckActivitySchema2) },
@@ -34250,8 +34345,45 @@ function entryWords(entry) {
 }
 var LIVE_MS2 = 3 * 6e4;
 var WORKING_MS2 = 60 * 6e4;
+var isWorking = (c, now) => !!c.lastWorkedAt && now - Date.parse(c.lastWorkedAt) < WORKING_MS2;
 var WORKING_TIER_MS2 = 2 * 60 * 6e4;
 var RECENT_TIER_MS2 = 24 * 60 * 6e4;
+var json2 = external_exports.lazy(() => external_exports.union([
+  external_exports.string(),
+  external_exports.number().finite(),
+  external_exports.boolean(),
+  external_exports.null(),
+  external_exports.array(json2),
+  external_exports.record(json2)
+]));
+var clock3 = external_exports.number().int().nonnegative().safe();
+var HeardEventSchema2 = external_exports.object({
+  eventId: external_exports.string().uuid(),
+  source: external_exports.enum(["phone", "bot"]),
+  sequence: clock3,
+  kind: external_exports.string().min(1),
+  phoneAtMs: clock3.optional(),
+  botAtMs: clock3.optional(),
+  payload: external_exports.record(json2)
+}).strict();
+var HeardCursorSchema2 = HeardEventSchema2.pick({ source: true, sequence: true, eventId: true });
+var HeardPageSchema2 = external_exports.object({
+  events: external_exports.array(HeardEventSchema2).max(200),
+  next: HeardCursorSchema2.nullable()
+}).strict();
+var MAX_EVENTS2 = 50;
+var MAX_BYTES2 = 8e4;
+var batchBytes2 = (events) => {
+  let bytes = 0;
+  for (const char of JSON.stringify({ events })) {
+    const point = char.codePointAt(0);
+    bytes += point < 128 ? 1 : point < 2048 ? 2 : point < 65536 ? 3 : 4;
+  }
+  return bytes;
+};
+var HeardBatchSchema2 = external_exports.object({
+  events: external_exports.array(HeardEventSchema2).min(1).max(MAX_EVENTS2)
+}).strict().refine((value) => batchBytes2(value.events) <= MAX_BYTES2, "heard_batch_too_large");
 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(
@@ -34808,8 +34940,8 @@ var MissedCallSchema2 = external_exports.enum([
   "inbox",
   "dismiss"
 ]);
-var clock2 = (h) => h === 0 ? "midnight" : h === 12 ? "noon" : h < 12 ? `${h} am` : `${h - 12} pm`;
-var QUIET2 = ` Nothing rings from ${clock2(NIGHT2.from)} to ${clock2(NIGHT2.to)} your time; the count waits for morning.`;
+var clock22 = (h) => h === 0 ? "midnight" : h === 12 ? "noon" : h < 12 ? `${h} am` : `${h - 12} pm`;
+var QUIET2 = ` Nothing rings from ${clock22(NIGHT2.from)} to ${clock22(NIGHT2.to)} your time; the count waits for morning.`;
 var BrokerTuningSchema2 = external_exports.object({
   /** 'none' = skip the spoken ack after a mapped answer (power users find it slow). */
   ackVerbosity: external_exports.enum(["normal", "none"]).optional(),
@@ -35124,7 +35256,13 @@ var QueueItemSchema2 = external_exports.object({
     /** 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()
+    summary: external_exports.string().optional(),
+    /** AN AGENT'S UPDATE OR QUESTION AS ITS UNITS' TITLES (owner, 2026-10-08: "send the 50 chars from the title
+     *  of each unit"): each at most 50 characters, in order; absent when it has none. */
+    titles: external_exports.array(external_exports.string()).optional(),
+    /** A PROGRESS NOTE'S ONE POINT ("An agent's progress note -> maybe let's cap it at 200 chars"): the
+     *  update's own line, before its units; the row caps it at 200. Absent on anything else. */
+    line: 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
@@ -35496,7 +35634,9 @@ var CallRecapSchema2 = external_exports.object({
     words: external_exports.string(),
     atMs: external_exports.number()
   })),
-  more: external_exports.object({ lines: external_exports.number(), entries: external_exports.number(), topics: external_exports.number() })
+  more: external_exports.object({ lines: external_exports.number(), entries: external_exports.number(), topics: external_exports.number() }),
+  /** Last stored position on this page when another exists; absent before paging shipped. */
+  next: external_exports.number().int().nonnegative().nullable().optional()
 });
 
 // src/paigy/activity.ts
@@ -35570,9 +35710,9 @@ function limitIn(text, now) {
   if (!line) return null;
   const reset = resetOf(line, now);
   if (reset !== null && reset > now && reset - now <= FARTHEST_MS) {
-    return { until: reset + MARGIN_MS, resets: /resets\s+(?:at\s+)?(.+?)\s*(?:\(|$)/i.exec(line)?.[1]?.trim() ?? clock3(reset) };
+    return { until: reset + MARGIN_MS, resets: /resets\s+(?:at\s+)?(.+?)\s*(?:\(|$)/i.exec(line)?.[1]?.trim() ?? clock4(reset) };
   }
-  return { until: now + RETRY_MS2, resets: clock3(now + RETRY_MS2) };
+  return { until: now + RETRY_MS2, resets: clock4(now + RETRY_MS2) };
 }
 function resetOf(line, now) {
   const m = /resets\s+(?:at\s+)?(?:([a-z]{3})[a-z]*\s+(\d{1,2}),?\s+(?:at\s+)?)?(\d{1,2})(?::(\d{2}))?\s*(am|pm)\b(?:\s*\(([^)]+)\))?/i.exec(line);
@@ -35616,7 +35756,7 @@ function wallToEpoch(year, month, day, hour, minute, zone) {
   const first = wall - offset(wall);
   return wall - offset(first);
 }
-function clock3(t) {
+function clock4(t) {
   return new Date(t).toLocaleTimeString("en-US", { hour: "numeric", minute: "2-digit" }).replace(/\s?([AP])M$/i, (_, x) => `${x.toLowerCase()}m`);
 }
 var pausedLine = (limit) => `Paused by the usage limit until ${limit.resets}`;
@@ -35660,7 +35800,7 @@ function episodes(opts = {}) {
         episode.called = true;
         const rest = episode.paused.filter((n) => !episode.running.includes(n));
         const text = [
-          `Claude's usage limit paused ${names(episode.paused)} from ${clock3(episode.since)}.`,
+          `Claude's usage limit paused ${names(episode.paused)} from ${clock4(episode.since)}.`,
           rest.length ? `It has reset: ${names(episode.running)} ${episode.running.length > 1 ? "are" : "is"} running again, and ${names(rest)} ${rest.length > 1 ? "haven't" : "hasn't"} started again yet.` : `It has reset, and ${episode.paused.length > 1 ? "they have all" : "it has"} carried on.`
         ].join(" ");
         void call(text).then(
@@ -36153,7 +36293,7 @@ function send2(session, state, text) {
   session.send(text);
 }
 async function pump(session, state, rail, opts) {
-  const clock4 = opts.beat ?? beat();
+  const clock5 = opts.beat ?? beat();
   const now = opts.now ?? Date.now;
   const counts = { wake: 0, rest: 0, safety: 0, skipped: 0 };
   const tally = { noted: 0, seen: 0, announced: 0 };
@@ -36185,7 +36325,7 @@ async function pump(session, state, rail, opts) {
       counts.wake = counts.rest = counts.safety = counts.skipped = tally.noted = tally.seen = tally.announced = tally.paused = 0;
       since = now();
     }
-    cause = await clock4.next(state.asks?.size ? ASK_BEAT_MS : state.paused ? Math.max(1e3, Math.min(SAFETY_MS, state.paused.until - now())) : SAFETY_MS);
+    cause = await clock5.next(state.asks?.size ? ASK_BEAT_MS : state.paused ? Math.max(1e3, Math.min(SAFETY_MS, state.paused.until - now())) : SAFETY_MS);
     if (!await opts.onIdle()) return;
   }
 }
@@ -36195,7 +36335,7 @@ function runHarness(opts) {
   let running = true;
   let tail = [];
   const state = { resting: true };
-  const clock4 = beat();
+  const clock5 = beat();
   let session = null;
   const speaksAs = opts.session ?? opts.resume ?? sessionId();
   const instance = randomUUID4();
@@ -36256,7 +36396,7 @@ ${event.message}`, state, rail, { log: opts.log });
         stop2();
         return;
       } else if (carried) runningAgain();
-      clock4.nudge("rest");
+      clock5.nudge("rest");
     }
   }
   session = startSession({
@@ -36275,13 +36415,13 @@ ${event.message}`, state, rail, { log: opts.log });
     },
     onEvent: (event) => void handle(event).catch((err) => opts.log(`\u26A0 ${err.message}`))
   });
-  void pump(session, state, rail, { onIdle: () => running, beat: clock4, initialPrompt: opts.prompt, log: opts.log, ...inbox ? { inbox } : {} }).catch(
+  void pump(session, state, rail, { onIdle: () => running, beat: clock5, initialPrompt: opts.prompt, log: opts.log, ...inbox ? { inbox } : {} }).catch(
     (e) => opts.log(`\u26A0 conversation loop stopped: ${e.message}`)
   );
   opts.log(`\u25B6 started ${opts.harness} in ${opts.cwd} (${opts.mode} mode)`);
   function stop2() {
     running = false;
-    clock4.nudge("wake");
+    clock5.nudge("wake");
     tail = [];
     cancelAsks(state);
     session?.stop();
@@ -36296,7 +36436,7 @@ ${event.message}`, state, rail, { log: opts.log });
     working: () => running && state.resting !== true,
     // Paused by a usage limit, the activity line says so: the quiet place the pause is shown.
     tail: () => state.paused ? [pausedLine(state.paused)] : [...tail],
-    nudge: () => clock4.nudge("wake"),
+    nudge: () => clock5.nudge("wake"),
     stop: stop2
   };
 }
@@ -36727,7 +36867,7 @@ var claimedRun = (sessionId2) => {
   const slot = sessionSlot(sessionId2);
   return { slot, key: runKey(slot) };
 };
-var launchRun = (spec) => ({ session: spec.sessionId, model: spec.model });
+var launchRun = (spec) => ({ session: spec.sessionId });
 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";
@@ -36757,13 +36897,12 @@ function evict(runs, key3, run) {
   if (runs.get(key3)?.run === run) runs.delete(key3);
 }
 var PRESENCE_FRESH_MS = 3 * 6e4;
-var IDLE_HOLDER_MS = 30 * 6e4;
 function wakeAction(live, now, serverSeenAt, here = {}) {
   if (live) return { action: "skip", why: "run" };
   if (here.holder) return { action: "skip", why: "holder" };
   if (serverSeenAt !== void 0 && now - serverSeenAt < PRESENCE_FRESH_MS) {
     if (here.goneAt !== void 0 && serverSeenAt <= here.goneAt) return { action: "spawn", why: "gone" };
-    if (here.movedAt !== void 0 && now - here.movedAt >= IDLE_HOLDER_MS) return { action: "spawn", why: "idle" };
+    if (here.movedAt !== void 0 && now - here.movedAt >= WORKING_MS2 && !isWorking(here, now)) return { action: "spawn", why: "idle" };
     return { action: "skip", why: "presence" };
   }
   return { action: "spawn", why: "nobody" };
@@ -36836,7 +36975,7 @@ function startHost(opts) {
     });
     void heartbeat({
       version: VERSION,
-      harnesses: detectAll().map((a) => ({ name: a.name, label: a.label, status: a.status, models: a.models })),
+      harnesses: detectAll().map((a) => ({ name: a.name, label: a.label, status: a.status })),
       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)
@@ -36918,7 +37057,7 @@ function startHost(opts) {
     const presence = /* @__PURE__ */ new Map();
     try {
       for (const c of (await listConnections(asHost)).items) {
-        if (c.lastSeenAt) presence.set(c.id, Date.parse(c.lastSeenAt));
+        presence.set(c.id, c);
       }
       lastPresence = presence;
     } catch {
@@ -36951,11 +37090,12 @@ function startHost(opts) {
         }
       }
       const tokenId = slotIdentity(slot).tokenId;
-      const seenByServer = tokenId ? presence.get(tokenId) : void 0;
+      const connection = tokenId ? presence.get(tokenId) : void 0;
+      const seenByServer = connection?.lastSeenAt ? Date.parse(connection.lastSeenAt) : void 0;
       const holder = holders.get(slot);
       if (holder) heldHere.add(slot);
       else if (heldHere.delete(slot)) goneAt.set(slot, Date.now());
-      const here = { holder, goneAt: goneAt.get(slot) };
+      const here = { holder, goneAt: goneAt.get(slot), lastWorkedAt: connection?.lastWorkedAt };
       let decided = wakeAction(!!live, Date.now(), seenByServer, here);
       const label = slotName(slot) ?? slot;
       if (decided.action === "skip" && decided.why !== "presence") {
@@ -36998,7 +37138,7 @@ function startHost(opts) {
         const since = found.since;
         decided = wakeAction(false, Date.now(), seenByServer, { ...here, ...since ? { movedAt: Date.parse(since) } : {} });
         if (decided.action === "skip") {
-          const said = `is working somewhere this host cannot see (heartbeat) \u2014 ${found.waiting}${since ? ` last moved ${ago(since, Date.now())}; taken over once it sits ${IDLE_HOLDER_MS / 6e4} min untouched` : ", with nothing to say when it last moved"}`;
+          const said = `is connected somewhere this host cannot see (heartbeat) \u2014 ${found.waiting}${since ? ` last moved ${ago(since, Date.now())}; takeover requires ${WORKING_MS2 / 6e4} min without own activity or waiting-work movement` : ", with nothing to say when it last moved"}`;
           opts.log(`\u25CC ${label} ${said} \u2014 not spawning`);
           decide(slot, "stood_back", found, seenByServer, said);
           return;
@@ -37167,7 +37307,7 @@ function startHost(opts) {
           // sessions we started ourselves. The server already knows: `last_seen_at` on the
           // agent's own token, the same evidence `wakeAction` stands back for. So: a run we
           // hold, OR a process the server heard from inside `PRESENCE_FRESH_MS`.
-          running: live.has(name) || !!slot && lastHolders.has(slot) || !!id3.tokenId && Date.now() - (lastPresence.get(id3.tokenId) ?? 0) < PRESENCE_FRESH_MS,
+          running: live.has(name) || !!slot && lastHolders.has(slot) || !!id3.tokenId && Date.now() - Date.parse(lastPresence.get(id3.tokenId)?.lastSeenAt ?? "") < PRESENCE_FRESH_MS,
           // `working` stays ours alone — it means a run WE hold is mid-turn, which is the only
           // thing a tail can tell us. A process we did not spawn has no tail here to read.
           working: live.get(name)?.working() ?? false