@paigy/harness 0.3.36 → 0.3.37

package/dist/cli.js

@@ -24254,7 +24254,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, 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, 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, LIVE_MS, WORKING_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, 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, 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 init_dist = __esm({
   "../../packages/sdk/dist/index.js"() {
     "use strict";
@@ -24268,6 +24268,8 @@ var init_dist = __esm({
     init_zod();
     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"];
@@ -24649,10 +24651,12 @@ var init_dist = __esm({
     };
     OPTIONS_MIN = 2;
     OPTIONS_MAX = 6;
+    OPTION_LABEL_MAX = 50;
+    OPTION_HINT_MAX = 200;
     OptionSchema = external_exports.object({
       id: external_exports.string(),
       label: external_exports.string(),
-      hint: external_exports.string().max(500).describe("Optional short projection of consequence or action if this option is chosen (e.g. 'Reruns test suite', 'Merges to main').").optional(),
+      hint: external_exports.string().max(500).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
       // .describe() flows into the MCP contact JSON schema (zodToJsonSchema), so
       // the constraints below are what an agent reads when deciding to use these.
       html: external_exports.string().max(16384).describe(
@@ -24666,8 +24670,10 @@ var init_dist = __esm({
       id: external_exports.string().trim().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/).optional().describe(
         `Optional: this option's own id, which answers name it by (selectedOptionIds). Give every option one, or none: without them the options are numbered "1", "2", \u2026 in order.`
       ),
-      label: external_exports.string().trim().min(1).max(1e3),
-      hint: OptionSchema.shape.hint,
+      // SHORT CHOICES (owner, 2026-10-07: "options label should be maybe max 50 characters and the hint 200"):
+      // a label is one choice the person reads, or hears on a call; a hint says its consequence in a line.
+      label: external_exports.string().trim().min(1).max(OPTION_LABEL_MAX, `option_label_too_long: an option's label is at most ${OPTION_LABEL_MAX} characters; say the choice, and put its consequence in the hint.`).describe(`The choice, at most ${OPTION_LABEL_MAX} characters, standing on its own.`),
+      hint: external_exports.string().max(OPTION_HINT_MAX, `option_hint_too_long: an option's hint is at most ${OPTION_HINT_MAX} characters.`).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
       htmlPreview: OptionSchema.shape.html,
       imgUrl: OptionSchema.shape.image
     }).strict();
@@ -24707,7 +24713,7 @@ var init_dist = __esm({
       ),
       goalId: external_exports.string().uuid().describe("The Goal the question is about, which must exist (create it with manage_goals first). Its answer comes back there."),
       units,
-      options: external_exports.array(OptionInputSchema).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own."),
+      options: external_exports.array(OptionInputSchema).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own, at most 50 characters; a hint, at most 200."),
       // HOW THE OPTIONS ARE ANSWERED, SAID BY THE AGENT (owner, 2026-10-02: "one and many makes sense";
       // brain_prompts.md §1: structured agent questions need no model). The app draws all three.
       pickMode: external_exports.enum(["one", "many", "rank"]).optional().describe(
@@ -24827,7 +24833,8 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
     }).strict();
     changedGoal = external_exports.string().uuid().describe("The Goal to change, as a read shows it.");
     goalTitle = external_exports.string().trim().min(1).max(80).describe("The Goal's short display name: one to five words, how a person refers to it out loud.");
-    goalOutcome = external_exports.string().trim().min(1).max(1e4).describe("The full desired result. There is no third description field.");
+    GOAL_OUTCOME_MAX = 500;
+    goalOutcome = external_exports.string().trim().min(1).max(GOAL_OUTCOME_MAX, `outcome_too_long: a Goal's outcome is one paragraph, at most ${GOAL_OUTCOME_MAX} characters; split the rest into child Goals (create with parentGoalId).`).describe(`The desired result, one paragraph of at most ${GOAL_OUTCOME_MAX} characters. More than that is more work: create child Goals under it (parentGoalId). There is no third description field.`);
     CreateChange = external_exports.object({
       kind: external_exports.literal("create"),
       title: goalTitle,
@@ -24853,7 +24860,7 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
       goalId: changedGoal,
       dependsOnGoalId: external_exports.string().uuid().describe("The Goal it waits on."),
       action: external_exports.enum(["start", "complete"]).describe("What waits: starting goalId, or completing it."),
-      reason: external_exports.string().trim().min(1).max(2e3).optional().describe("Why, as an explanation, never as policy.")
+      reason: external_exports.string().trim().min(1).max(250).optional().describe("Why, at most 250 characters, as an explanation, never as policy.")
     }).strict();
     read = { revision: external_exports.number().int().positive().optional() };
     GoalChangeSchema = external_exports.discriminatedUnion("kind", [
@@ -24877,7 +24884,7 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
     ManageGoalsToolSchema = external_exports.object({
       changes: external_exports.array(external_exports.discriminatedUnion("kind", [CreateChange, EditChange, StateChange, AssignChange, DeferChange, MoveChange, DependencyChange])).min(1).max(50).describe("The changes, applied in order, each on its own.")
     }).strict().superRefine((v, ctx) => editNames(v.changes, ctx));
-    MANAGE_GOALS_DESCRIPTION = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls; edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
+    MANAGE_GOALS_DESCRIPTION = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls (an outcome is one paragraph, at most 500 characters: split more into child Goals with parentGoalId); edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
     GetGoalSchema = external_exports.object({
       goalId: external_exports.string().uuid(),
       /** Every entry in full. Without it the read carries the person's words, open questions and your
@@ -24895,7 +24902,7 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
       goalId: external_exports.string().uuid().optional(),
       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 Answers (found by their Question or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, its Questions' Answers, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (an Answer carries its Question, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
+    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.";
     CheckActivitySchema = external_exports.object({}).strict();
     FEEDBACK_TEXT_MAX = 5e4;
     SendFeedbackSchema = external_exports.object({
@@ -24958,6 +24965,7 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
       external_exports.object({
         kind: external_exports.literal("create"),
         text: external_exports.string().min(1),
+        summary: external_exports.string().optional(),
         answererId: participant,
         goal: ResultRefSchema.optional(),
         blocks: external_exports.array(external_exports.object({ question: ResultRefSchema }).strict()),
@@ -25008,12 +25016,12 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
     }).strict();
     BrainResultSchema = external_exports.object({
       messages: external_exports.array(BrainMessageSchema),
-      entries: external_exports.array(external_exports.object({ key, sources: external_exports.array(SourceSchema).min(1), goals: external_exports.array(ResultRefSchema) }).strict()),
+      entries: external_exports.array(external_exports.object({ key, sources: external_exports.array(SourceSchema).min(1), goals: external_exports.array(ResultRefSchema), summary: external_exports.string().optional() }).strict()),
       questions: external_exports.array(external_exports.object({ key, entryKeys: external_exports.array(key), change: QuestionChangeSchema }).strict()),
       answers: external_exports.array(external_exports.object({
         question: ResultRefSchema,
         entryKeys: external_exports.array(key).min(1),
-        summary: external_exports.string().min(1),
+        summary: external_exports.string(),
         selectedOptionIds: external_exports.array(external_exports.string().min(1)).optional()
       }).strict()),
       goals: external_exports.array(external_exports.object({ key, entryKeys: external_exports.array(key), change: BrainGoalChangeSchema }).strict()),
@@ -25058,12 +25066,15 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
       messages: external_exports.array(external_exports.object({ key: str2, to: str2, text: str2, about: strs2, blocks: str2 }).strict()),
       /** What the call does next: listen, hold (the person asked for a moment) or end (they asked to). */
       then: external_exports.enum(["listen", "hold", "end"]),
-      /** Items the person's words settle: the item's handle, the chosen option IDs, the line handles. */
-      answers: external_exports.array(external_exports.object({ item: str2, options: strs2, lines: strs2 }).strict()),
-      /** The line handles that hold a new instruction from the person. */
+      /** The person's replies to items (replies, owner 2026-10-07): the item's handle, the chosen option
+       *  IDs, the line handles, how they replied in under ten words (keeping any condition), and `defer`:
+       *  "" when their words settle the item, else what a reply that puts it off waits for -- "call" (the
+       *  end of this call), a question's handle (that question's answer) or an ISO time. */
+      replies: external_exports.array(external_exports.object({ item: str2, options: strs2, lines: strs2, summary: str2, defer: str2 }).strict()),
+      /** The line handles that tell the talker how to run this call; they last until it ends and reach no agent. */
       instruction: strs2,
-      /** The line handles that ask for new work, a change to existing work, or a standing rule: the filer
-       *  reads only these (3e). */
+      /** The line handles the filer acts on, and the only ones it reads (3e): new work, a change to existing
+       *  work, feedback on Paigy, anything said to an agent, and any rule meant to outlast the call. */
       file: strs2,
       /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
       need: external_exports.object({ kind: external_exports.enum(["search", "item", "agent", ""]), text: str2 }).strict(),
@@ -25076,8 +25087,9 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
     str3 = external_exports.string();
     strs3 = external_exports.array(external_exports.string());
     FilerReplySchema = external_exports.object({
-      /** Which Goals each new line goes on: a line's handle and Goal handles (or keys of new Goals). */
-      filed: external_exports.array(external_exports.object({ line: str3, goals: strs3 }).strict()),
+      /** Which Goals each new line goes on: a line's handle, Goal handles (or keys of new Goals), and what
+       *  the line says in at most ten words. */
+      filed: external_exports.array(external_exports.object({ line: str3, goals: strs3, summary: str3 }).strict()),
       goals: external_exports.array(external_exports.object({
         op: external_exports.enum(["create", "edit", "complete", "cancel", "reopen", "assign", "defer", "move", "block", "unblock"]),
         key: str3,
@@ -25096,6 +25108,7 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
         key: str3,
         question: str3,
         text: str3,
+        summary: str3,
         to: str3,
         goal: str3,
         options: external_exports.array(external_exports.object({ id: str3, label: str3 }).strict()),
@@ -25109,6 +25122,58 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
     FILER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
       zodToJsonSchema(FilerReplySchema, { $refStrategy: "none" })
     );
+    ExplainerReplySchema = external_exports.object({
+      /** The explanation, as sentences, spoken in order. */
+      say: external_exports.array(external_exports.string()),
+      /** Questions to an agent about gaps in what it read: the agent's handle and the question. */
+      followUps: external_exports.array(external_exports.object({ to: external_exports.string(), text: external_exports.string() }).strict())
+    }).strict();
+    EXPLAINER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+      zodToJsonSchema(ExplainerReplySchema, { $refStrategy: "none" })
+    );
+    DISTILLER_DEFECTS = [
+      "reasked",
+      // a question put to the person again after they answered it
+      "unsupported",
+      // a fact stated that nothing in the input supports
+      "unsaid",
+      // an agent's answer arrived during the call and was never said
+      "skipped",
+      // an agenda item never put to the person
+      "unsaved",
+      // something the person answered or asked for did not save, was refused or dropped
+      "ignored",
+      // the person asked or said something and was never answered (the critic's ignored_a_question)
+      "promised"
+      // said it did or would do something, and nothing shows it done (the critic's broken_promise)
+    ];
+    DistillerReplySchema = external_exports.object({
+      defects: external_exports.array(external_exports.object({
+        kind: external_exports.enum(DISTILLER_DEFECTS),
+        /** The handles of the lines it shows in. */
+        lines: external_exports.array(external_exports.string()),
+        /** The handle of the record it concerns, or "". */
+        about: external_exports.string(),
+        /** One plain sentence, in words, never handles: it is what the feedback row keeps. */
+        why: external_exports.string()
+      }).strict())
+    }).strict();
+    DISTILLER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+      zodToJsonSchema(DistillerReplySchema, { $refStrategy: "none" })
+    );
+    TIDY_AUDIENCES = ["talker", "filer", "agents"];
+    TidyReplySchema = external_exports.object({
+      lessons: external_exports.array(external_exports.object({
+        lesson: external_exports.string(),
+        op: external_exports.enum(["keep", "revise", "withdraw"]),
+        text: external_exports.string(),
+        for: external_exports.enum([...TIDY_AUDIENCES, ""]),
+        into: external_exports.string()
+      }).strict())
+    }).strict();
+    TIDY_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+      zodToJsonSchema(TidyReplySchema, { $refStrategy: "none" })
+    );
     LIVE_MS = 3 * 6e4;
     WORKING_MS = 60 * 6e4;
     ContextSchema = external_exports.object({
@@ -25791,7 +25856,7 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
        *  desktop app while open. Null = never seen; stale = offline. */
       lastSeenAt: external_exports.string().datetime().nullable().optional(),
       /** WORKING, NOT JUST CONNECTED (owner, 2026-09-30): the last time the agent itself acted on one of
-       *  its Goals — took its lease or recorded an operation (`tokens.last_worked_at`). Within
+       *  its Goals — wrote on one or recorded an operation (`tokens.last_worked_at`). Within
        *  `WORKING_MS` it is working; otherwise it is connected but idle. Null = not seen working yet. */
       lastWorkedAt: external_exports.string().datetime().nullable().optional(),
       /** The oldest of its Goals that is `ready` for it — work handed to it that nobody has started.
@@ -25989,7 +26054,7 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
        *
        *  IT IS THE PAYLOAD'S OWN HASH, NEVER A STAMP ON THE WORK. Nothing here reasons about which
        *  writes change which field — the comparison is over the bytes the phone is holding, so a fact
-       *  the row shows that no `updated_at` moves for (a lease lapsing, a dependency's state, a
+       *  the row shows that no `updated_at` moves for (`active` lapsing, a dependency's state, a
        *  sibling appearing in `childGoalIds`) cannot go unnoticed. Optional because a hand-built
        *  queue (a fixture, the demo) spells none, and a row with no rev is simply always re-sent. */
       rev: external_exports.string().optional()
@@ -26306,14 +26371,13 @@ RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of w
         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. */
+        /** `words` is always what they SAID, verbatim — the record, never replaced. `summary` is what
+         *  the line says in ten words (owner, 2026-10-07): the filer's, or the talker's for the answer it
+         *  gave, so the row scans like a chosen option and their own words stay under it. Absent when
+         *  neither wrote one. */
         /** `about` is the request the line answered (its question), null for words that answered none —
          *  the key the screen groups on, so one question is one row however many times it was answered. */
-        lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), headline: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
+        lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), summary: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
       })),
       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() })
@@ -33409,12 +33473,16 @@ init_zod();
 init_zod();
 init_zod();
 init_zod();
+init_zod();
+init_zod();
 var OPTIONS_MIN2 = 2;
 var OPTIONS_MAX2 = 6;
+var OPTION_LABEL_MAX2 = 50;
+var OPTION_HINT_MAX2 = 200;
 var OptionSchema2 = external_exports.object({
   id: external_exports.string(),
   label: external_exports.string(),
-  hint: external_exports.string().max(500).describe("Optional short projection of consequence or action if this option is chosen (e.g. 'Reruns test suite', 'Merges to main').").optional(),
+  hint: external_exports.string().max(500).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX2} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   // .describe() flows into the MCP contact JSON schema (zodToJsonSchema), so
   // the constraints below are what an agent reads when deciding to use these.
   html: external_exports.string().max(16384).describe(
@@ -33428,8 +33496,10 @@ var OptionInputSchema2 = external_exports.object({
   id: external_exports.string().trim().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/).optional().describe(
     `Optional: this option's own id, which answers name it by (selectedOptionIds). Give every option one, or none: without them the options are numbered "1", "2", \u2026 in order.`
   ),
-  label: external_exports.string().trim().min(1).max(1e3),
-  hint: OptionSchema2.shape.hint,
+  // SHORT CHOICES (owner, 2026-10-07: "options label should be maybe max 50 characters and the hint 200"):
+  // a label is one choice the person reads, or hears on a call; a hint says its consequence in a line.
+  label: external_exports.string().trim().min(1).max(OPTION_LABEL_MAX2, `option_label_too_long: an option's label is at most ${OPTION_LABEL_MAX2} characters; say the choice, and put its consequence in the hint.`).describe(`The choice, at most ${OPTION_LABEL_MAX2} characters, standing on its own.`),
+  hint: external_exports.string().max(OPTION_HINT_MAX2, `option_hint_too_long: an option's hint is at most ${OPTION_HINT_MAX2} characters.`).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX2} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   htmlPreview: OptionSchema2.shape.html,
   imgUrl: OptionSchema2.shape.image
 }).strict();
@@ -33539,7 +33609,7 @@ var questionFields2 = {
   ),
   goalId: external_exports.string().uuid().describe("The Goal the question is about, which must exist (create it with manage_goals first). Its answer comes back there."),
   units: units2,
-  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own."),
+  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own, at most 50 characters; a hint, at most 200."),
   // HOW THE OPTIONS ARE ANSWERED, SAID BY THE AGENT (owner, 2026-10-02: "one and many makes sense";
   // brain_prompts.md §1: structured agent questions need no model). The app draws all three.
   pickMode: external_exports.enum(["one", "many", "rank"]).optional().describe(
@@ -33659,7 +33729,8 @@ var UpdateGoalSchema2 = external_exports.object({
 }).strict();
 var changedGoal2 = external_exports.string().uuid().describe("The Goal to change, as a read shows it.");
 var goalTitle2 = external_exports.string().trim().min(1).max(80).describe("The Goal's short display name: one to five words, how a person refers to it out loud.");
-var goalOutcome2 = external_exports.string().trim().min(1).max(1e4).describe("The full desired result. There is no third description field.");
+var GOAL_OUTCOME_MAX2 = 500;
+var goalOutcome2 = external_exports.string().trim().min(1).max(GOAL_OUTCOME_MAX2, `outcome_too_long: a Goal's outcome is one paragraph, at most ${GOAL_OUTCOME_MAX2} characters; split the rest into child Goals (create with parentGoalId).`).describe(`The desired result, one paragraph of at most ${GOAL_OUTCOME_MAX2} characters. More than that is more work: create child Goals under it (parentGoalId). There is no third description field.`);
 var CreateChange2 = external_exports.object({
   kind: external_exports.literal("create"),
   title: goalTitle2,
@@ -33685,7 +33756,7 @@ var DependencyChange2 = external_exports.object({
   goalId: changedGoal2,
   dependsOnGoalId: external_exports.string().uuid().describe("The Goal it waits on."),
   action: external_exports.enum(["start", "complete"]).describe("What waits: starting goalId, or completing it."),
-  reason: external_exports.string().trim().min(1).max(2e3).optional().describe("Why, as an explanation, never as policy.")
+  reason: external_exports.string().trim().min(1).max(250).optional().describe("Why, at most 250 characters, as an explanation, never as policy.")
 }).strict();
 var read2 = { revision: external_exports.number().int().positive().optional() };
 var GoalChangeSchema2 = external_exports.discriminatedUnion("kind", [
@@ -33709,7 +33780,7 @@ var ManageGoalsSchema2 = external_exports.object({
 var ManageGoalsToolSchema2 = external_exports.object({
   changes: external_exports.array(external_exports.discriminatedUnion("kind", [CreateChange2, EditChange2, StateChange2, AssignChange2, DeferChange2, MoveChange2, DependencyChange2])).min(1).max(50).describe("The changes, applied in order, each on its own.")
 }).strict().superRefine((v, ctx) => editNames2(v.changes, ctx));
-var MANAGE_GOALS_DESCRIPTION2 = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls; edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
+var MANAGE_GOALS_DESCRIPTION2 = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls (an outcome is one paragraph, at most 500 characters: split more into child Goals with parentGoalId); edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
 var GetGoalSchema2 = external_exports.object({
   goalId: external_exports.string().uuid(),
   /** Every entry in full. Without it the read carries the person's words, open questions and your
@@ -33727,7 +33798,7 @@ var SearchToolSchema2 = external_exports.object({
   goalId: external_exports.string().uuid().optional(),
   limit: external_exports.number().int().min(1).max(20).optional()
 }).strict();
-var SEARCH_DESCRIPTION2 = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and Answers (found by their Question or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, its Questions' Answers, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (an Answer carries its Question, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
+var SEARCH_DESCRIPTION2 = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and replies -- the person's answers, acknowledgements and deferrals (type answer; found by their summary, by the question or report they reply to, or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, the replies to its items, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (a reply carries its kind -- answered, acknowledged or deferred -- whether it is closed (a deferral is not), its summary in under ten words, its question or report, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
 var CheckActivitySchema2 = external_exports.object({}).strict();
 var FEEDBACK_TEXT_MAX2 = 5e4;
 var SendFeedbackSchema2 = external_exports.object({
@@ -33790,6 +33861,7 @@ var QuestionChangeSchema2 = external_exports.union([
   external_exports.object({
     kind: external_exports.literal("create"),
     text: external_exports.string().min(1),
+    summary: external_exports.string().optional(),
     answererId: participant2,
     goal: ResultRefSchema2.optional(),
     blocks: external_exports.array(external_exports.object({ question: ResultRefSchema2 }).strict()),
@@ -33840,12 +33912,12 @@ var BrainSearchSchema2 = external_exports.object({
 }).strict();
 var BrainResultSchema2 = external_exports.object({
   messages: external_exports.array(BrainMessageSchema2),
-  entries: external_exports.array(external_exports.object({ key: key2, sources: external_exports.array(SourceSchema2).min(1), goals: external_exports.array(ResultRefSchema2) }).strict()),
+  entries: external_exports.array(external_exports.object({ key: key2, sources: external_exports.array(SourceSchema2).min(1), goals: external_exports.array(ResultRefSchema2), summary: external_exports.string().optional() }).strict()),
   questions: external_exports.array(external_exports.object({ key: key2, entryKeys: external_exports.array(key2), change: QuestionChangeSchema2 }).strict()),
   answers: external_exports.array(external_exports.object({
     question: ResultRefSchema2,
     entryKeys: external_exports.array(key2).min(1),
-    summary: external_exports.string().min(1),
+    summary: external_exports.string(),
     selectedOptionIds: external_exports.array(external_exports.string().min(1)).optional()
   }).strict()),
   goals: external_exports.array(external_exports.object({ key: key2, entryKeys: external_exports.array(key2), change: BrainGoalChangeSchema2 }).strict()),
@@ -33890,12 +33962,15 @@ var TalkerReplySchema2 = external_exports.object({
   messages: external_exports.array(external_exports.object({ key: str22, to: str22, text: str22, about: strs22, blocks: str22 }).strict()),
   /** What the call does next: listen, hold (the person asked for a moment) or end (they asked to). */
   then: external_exports.enum(["listen", "hold", "end"]),
-  /** Items the person's words settle: the item's handle, the chosen option IDs, the line handles. */
-  answers: external_exports.array(external_exports.object({ item: str22, options: strs22, lines: strs22 }).strict()),
-  /** The line handles that hold a new instruction from the person. */
+  /** The person's replies to items (replies, owner 2026-10-07): the item's handle, the chosen option
+   *  IDs, the line handles, how they replied in under ten words (keeping any condition), and `defer`:
+   *  "" when their words settle the item, else what a reply that puts it off waits for -- "call" (the
+   *  end of this call), a question's handle (that question's answer) or an ISO time. */
+  replies: external_exports.array(external_exports.object({ item: str22, options: strs22, lines: strs22, summary: str22, defer: str22 }).strict()),
+  /** The line handles that tell the talker how to run this call; they last until it ends and reach no agent. */
   instruction: strs22,
-  /** The line handles that ask for new work, a change to existing work, or a standing rule: the filer
-   *  reads only these (3e). */
+  /** The line handles the filer acts on, and the only ones it reads (3e): new work, a change to existing
+   *  work, feedback on Paigy, anything said to an agent, and any rule meant to outlast the call. */
   file: strs22,
   /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
   need: external_exports.object({ kind: external_exports.enum(["search", "item", "agent", ""]), text: str22 }).strict(),
@@ -33908,8 +33983,9 @@ var TALKER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
 var str32 = external_exports.string();
 var strs32 = external_exports.array(external_exports.string());
 var FilerReplySchema2 = external_exports.object({
-  /** Which Goals each new line goes on: a line's handle and Goal handles (or keys of new Goals). */
-  filed: external_exports.array(external_exports.object({ line: str32, goals: strs32 }).strict()),
+  /** Which Goals each new line goes on: a line's handle, Goal handles (or keys of new Goals), and what
+   *  the line says in at most ten words. */
+  filed: external_exports.array(external_exports.object({ line: str32, goals: strs32, summary: str32 }).strict()),
   goals: external_exports.array(external_exports.object({
     op: external_exports.enum(["create", "edit", "complete", "cancel", "reopen", "assign", "defer", "move", "block", "unblock"]),
     key: str32,
@@ -33928,6 +34004,7 @@ var FilerReplySchema2 = external_exports.object({
     key: str32,
     question: str32,
     text: str32,
+    summary: str32,
     to: str32,
     goal: str32,
     options: external_exports.array(external_exports.object({ id: str32, label: str32 }).strict()),
@@ -33941,6 +34018,58 @@ var FilerReplySchema2 = external_exports.object({
 var FILER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema2(FilerReplySchema2, { $refStrategy: "none" })
 );
+var ExplainerReplySchema2 = external_exports.object({
+  /** The explanation, as sentences, spoken in order. */
+  say: external_exports.array(external_exports.string()),
+  /** Questions to an agent about gaps in what it read: the agent's handle and the question. */
+  followUps: external_exports.array(external_exports.object({ to: external_exports.string(), text: external_exports.string() }).strict())
+}).strict();
+var EXPLAINER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(ExplainerReplySchema2, { $refStrategy: "none" })
+);
+var DISTILLER_DEFECTS2 = [
+  "reasked",
+  // a question put to the person again after they answered it
+  "unsupported",
+  // a fact stated that nothing in the input supports
+  "unsaid",
+  // an agent's answer arrived during the call and was never said
+  "skipped",
+  // an agenda item never put to the person
+  "unsaved",
+  // something the person answered or asked for did not save, was refused or dropped
+  "ignored",
+  // the person asked or said something and was never answered (the critic's ignored_a_question)
+  "promised"
+  // said it did or would do something, and nothing shows it done (the critic's broken_promise)
+];
+var DistillerReplySchema2 = external_exports.object({
+  defects: external_exports.array(external_exports.object({
+    kind: external_exports.enum(DISTILLER_DEFECTS2),
+    /** The handles of the lines it shows in. */
+    lines: external_exports.array(external_exports.string()),
+    /** The handle of the record it concerns, or "". */
+    about: external_exports.string(),
+    /** One plain sentence, in words, never handles: it is what the feedback row keeps. */
+    why: external_exports.string()
+  }).strict())
+}).strict();
+var DISTILLER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(DistillerReplySchema2, { $refStrategy: "none" })
+);
+var TIDY_AUDIENCES2 = ["talker", "filer", "agents"];
+var TidyReplySchema2 = external_exports.object({
+  lessons: external_exports.array(external_exports.object({
+    lesson: external_exports.string(),
+    op: external_exports.enum(["keep", "revise", "withdraw"]),
+    text: external_exports.string(),
+    for: external_exports.enum([...TIDY_AUDIENCES2, ""]),
+    into: external_exports.string()
+  }).strict())
+}).strict();
+var TIDY_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(TidyReplySchema2, { $refStrategy: "none" })
+);
 function entryWords(entry) {
   const content = entry.content;
   if (content && "sealed" in content) return "";
@@ -34640,7 +34769,7 @@ var ConnectionSummarySchema2 = external_exports.object({
    *  desktop app while open. Null = never seen; stale = offline. */
   lastSeenAt: external_exports.string().datetime().nullable().optional(),
   /** WORKING, NOT JUST CONNECTED (owner, 2026-09-30): the last time the agent itself acted on one of
-   *  its Goals — took its lease or recorded an operation (`tokens.last_worked_at`). Within
+   *  its Goals — wrote on one or recorded an operation (`tokens.last_worked_at`). Within
    *  `WORKING_MS` it is working; otherwise it is connected but idle. Null = not seen working yet. */
   lastWorkedAt: external_exports.string().datetime().nullable().optional(),
   /** The oldest of its Goals that is `ready` for it — work handed to it that nobody has started.
@@ -34838,7 +34967,7 @@ var QueueItemSchema2 = external_exports.object({
    *
    *  IT IS THE PAYLOAD'S OWN HASH, NEVER A STAMP ON THE WORK. Nothing here reasons about which
    *  writes change which field — the comparison is over the bytes the phone is holding, so a fact
-   *  the row shows that no `updated_at` moves for (a lease lapsing, a dependency's state, a
+   *  the row shows that no `updated_at` moves for (`active` lapsing, a dependency's state, a
    *  sibling appearing in `childGoalIds`) cannot go unnoticed. Optional because a hand-built
    *  queue (a fixture, the demo) spells none, and a row with no rev is simply always re-sent. */
   rev: external_exports.string().optional()
@@ -35153,14 +35282,13 @@ var CallRecapSchema2 = external_exports.object({
     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. */
+    /** `words` is always what they SAID, verbatim — the record, never replaced. `summary` is what
+     *  the line says in ten words (owner, 2026-10-07): the filer's, or the talker's for the answer it
+     *  gave, so the row scans like a chosen option and their own words stay under it. Absent when
+     *  neither wrote one. */
     /** `about` is the request the line answered (its question), null for words that answered none —
      *  the key the screen groups on, so one question is one row however many times it was answered. */
-    lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), headline: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
+    lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), summary: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
   })),
   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() })

package/dist/main.js

@@ -9923,10 +9923,12 @@ var zodToJsonSchema = (schema, options) => {
 };
 var OPTIONS_MIN = 2;
 var OPTIONS_MAX = 6;
+var OPTION_LABEL_MAX = 50;
+var OPTION_HINT_MAX = 200;
 var OptionSchema = external_exports.object({
   id: external_exports.string(),
   label: external_exports.string(),
-  hint: external_exports.string().max(500).describe("Optional short projection of consequence or action if this option is chosen (e.g. 'Reruns test suite', 'Merges to main').").optional(),
+  hint: external_exports.string().max(500).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   // .describe() flows into the MCP contact JSON schema (zodToJsonSchema), so
   // the constraints below are what an agent reads when deciding to use these.
   html: external_exports.string().max(16384).describe(
@@ -9940,8 +9942,10 @@ var OptionInputSchema = external_exports.object({
   id: external_exports.string().trim().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/).optional().describe(
     `Optional: this option's own id, which answers name it by (selectedOptionIds). Give every option one, or none: without them the options are numbered "1", "2", \u2026 in order.`
   ),
-  label: external_exports.string().trim().min(1).max(1e3),
-  hint: OptionSchema.shape.hint,
+  // SHORT CHOICES (owner, 2026-10-07: "options label should be maybe max 50 characters and the hint 200"):
+  // a label is one choice the person reads, or hears on a call; a hint says its consequence in a line.
+  label: external_exports.string().trim().min(1).max(OPTION_LABEL_MAX, `option_label_too_long: an option's label is at most ${OPTION_LABEL_MAX} characters; say the choice, and put its consequence in the hint.`).describe(`The choice, at most ${OPTION_LABEL_MAX} characters, standing on its own.`),
+  hint: external_exports.string().max(OPTION_HINT_MAX, `option_hint_too_long: an option's hint is at most ${OPTION_HINT_MAX} characters.`).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   htmlPreview: OptionSchema.shape.html,
   imgUrl: OptionSchema.shape.image
 }).strict();
@@ -10051,7 +10055,7 @@ var questionFields = {
   ),
   goalId: external_exports.string().uuid().describe("The Goal the question is about, which must exist (create it with manage_goals first). Its answer comes back there."),
   units,
-  options: external_exports.array(OptionInputSchema).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own."),
+  options: external_exports.array(OptionInputSchema).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own, at most 50 characters; a hint, at most 200."),
   // HOW THE OPTIONS ARE ANSWERED, SAID BY THE AGENT (owner, 2026-10-02: "one and many makes sense";
   // brain_prompts.md §1: structured agent questions need no model). The app draws all three.
   pickMode: external_exports.enum(["one", "many", "rank"]).optional().describe(
@@ -10171,7 +10175,8 @@ var UpdateGoalSchema = external_exports.object({
 }).strict();
 var changedGoal = external_exports.string().uuid().describe("The Goal to change, as a read shows it.");
 var goalTitle = external_exports.string().trim().min(1).max(80).describe("The Goal's short display name: one to five words, how a person refers to it out loud.");
-var goalOutcome = external_exports.string().trim().min(1).max(1e4).describe("The full desired result. There is no third description field.");
+var GOAL_OUTCOME_MAX = 500;
+var goalOutcome = external_exports.string().trim().min(1).max(GOAL_OUTCOME_MAX, `outcome_too_long: a Goal's outcome is one paragraph, at most ${GOAL_OUTCOME_MAX} characters; split the rest into child Goals (create with parentGoalId).`).describe(`The desired result, one paragraph of at most ${GOAL_OUTCOME_MAX} characters. More than that is more work: create child Goals under it (parentGoalId). There is no third description field.`);
 var CreateChange = external_exports.object({
   kind: external_exports.literal("create"),
   title: goalTitle,
@@ -10197,7 +10202,7 @@ var DependencyChange = external_exports.object({
   goalId: changedGoal,
   dependsOnGoalId: external_exports.string().uuid().describe("The Goal it waits on."),
   action: external_exports.enum(["start", "complete"]).describe("What waits: starting goalId, or completing it."),
-  reason: external_exports.string().trim().min(1).max(2e3).optional().describe("Why, as an explanation, never as policy.")
+  reason: external_exports.string().trim().min(1).max(250).optional().describe("Why, at most 250 characters, as an explanation, never as policy.")
 }).strict();
 var read = { revision: external_exports.number().int().positive().optional() };
 var GoalChangeSchema = external_exports.discriminatedUnion("kind", [
@@ -10221,7 +10226,7 @@ var ManageGoalsSchema = external_exports.object({
 var ManageGoalsToolSchema = external_exports.object({
   changes: external_exports.array(external_exports.discriminatedUnion("kind", [CreateChange, EditChange, StateChange, AssignChange, DeferChange, MoveChange, DependencyChange])).min(1).max(50).describe("The changes, applied in order, each on its own.")
 }).strict().superRefine((v, ctx) => editNames(v.changes, ctx));
-var MANAGE_GOALS_DESCRIPTION = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls; edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
+var MANAGE_GOALS_DESCRIPTION = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls (an outcome is one paragraph, at most 500 characters: split more into child Goals with parentGoalId); edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
 var GetGoalSchema = external_exports.object({
   goalId: external_exports.string().uuid(),
   /** Every entry in full. Without it the read carries the person's words, open questions and your
@@ -10239,7 +10244,7 @@ var SearchToolSchema = external_exports.object({
   goalId: external_exports.string().uuid().optional(),
   limit: external_exports.number().int().min(1).max(20).optional()
 }).strict();
-var SEARCH_DESCRIPTION = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and Answers (found by their Question or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, its Questions' Answers, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (an Answer carries its Question, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
+var SEARCH_DESCRIPTION = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and replies -- the person's answers, acknowledgements and deferrals (type answer; found by their summary, by the question or report they reply to, or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, the replies to its items, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (a reply carries its kind -- answered, acknowledged or deferred -- whether it is closed (a deferral is not), its summary in under ten words, its question or report, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
 var CheckActivitySchema = external_exports.object({}).strict();
 var FEEDBACK_TEXT_MAX = 5e4;
 var SendFeedbackSchema = external_exports.object({
@@ -10302,6 +10307,7 @@ var QuestionChangeSchema = external_exports.union([
   external_exports.object({
     kind: external_exports.literal("create"),
     text: external_exports.string().min(1),
+    summary: external_exports.string().optional(),
     answererId: participant,
     goal: ResultRefSchema.optional(),
     blocks: external_exports.array(external_exports.object({ question: ResultRefSchema }).strict()),
@@ -10352,12 +10358,12 @@ var BrainSearchSchema = external_exports.object({
 }).strict();
 var BrainResultSchema = external_exports.object({
   messages: external_exports.array(BrainMessageSchema),
-  entries: external_exports.array(external_exports.object({ key, sources: external_exports.array(SourceSchema).min(1), goals: external_exports.array(ResultRefSchema) }).strict()),
+  entries: external_exports.array(external_exports.object({ key, sources: external_exports.array(SourceSchema).min(1), goals: external_exports.array(ResultRefSchema), summary: external_exports.string().optional() }).strict()),
   questions: external_exports.array(external_exports.object({ key, entryKeys: external_exports.array(key), change: QuestionChangeSchema }).strict()),
   answers: external_exports.array(external_exports.object({
     question: ResultRefSchema,
     entryKeys: external_exports.array(key).min(1),
-    summary: external_exports.string().min(1),
+    summary: external_exports.string(),
     selectedOptionIds: external_exports.array(external_exports.string().min(1)).optional()
   }).strict()),
   goals: external_exports.array(external_exports.object({ key, entryKeys: external_exports.array(key), change: BrainGoalChangeSchema }).strict()),
@@ -10402,12 +10408,15 @@ var TalkerReplySchema = external_exports.object({
   messages: external_exports.array(external_exports.object({ key: str2, to: str2, text: str2, about: strs2, blocks: str2 }).strict()),
   /** What the call does next: listen, hold (the person asked for a moment) or end (they asked to). */
   then: external_exports.enum(["listen", "hold", "end"]),
-  /** Items the person's words settle: the item's handle, the chosen option IDs, the line handles. */
-  answers: external_exports.array(external_exports.object({ item: str2, options: strs2, lines: strs2 }).strict()),
-  /** The line handles that hold a new instruction from the person. */
+  /** The person's replies to items (replies, owner 2026-10-07): the item's handle, the chosen option
+   *  IDs, the line handles, how they replied in under ten words (keeping any condition), and `defer`:
+   *  "" when their words settle the item, else what a reply that puts it off waits for -- "call" (the
+   *  end of this call), a question's handle (that question's answer) or an ISO time. */
+  replies: external_exports.array(external_exports.object({ item: str2, options: strs2, lines: strs2, summary: str2, defer: str2 }).strict()),
+  /** The line handles that tell the talker how to run this call; they last until it ends and reach no agent. */
   instruction: strs2,
-  /** The line handles that ask for new work, a change to existing work, or a standing rule: the filer
-   *  reads only these (3e). */
+  /** The line handles the filer acts on, and the only ones it reads (3e): new work, a change to existing
+   *  work, feedback on Paigy, anything said to an agent, and any rule meant to outlast the call. */
   file: strs2,
   /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
   need: external_exports.object({ kind: external_exports.enum(["search", "item", "agent", ""]), text: str2 }).strict(),
@@ -10420,8 +10429,9 @@ var TALKER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
 var str3 = external_exports.string();
 var strs3 = external_exports.array(external_exports.string());
 var FilerReplySchema = external_exports.object({
-  /** Which Goals each new line goes on: a line's handle and Goal handles (or keys of new Goals). */
-  filed: external_exports.array(external_exports.object({ line: str3, goals: strs3 }).strict()),
+  /** Which Goals each new line goes on: a line's handle, Goal handles (or keys of new Goals), and what
+   *  the line says in at most ten words. */
+  filed: external_exports.array(external_exports.object({ line: str3, goals: strs3, summary: str3 }).strict()),
   goals: external_exports.array(external_exports.object({
     op: external_exports.enum(["create", "edit", "complete", "cancel", "reopen", "assign", "defer", "move", "block", "unblock"]),
     key: str3,
@@ -10440,6 +10450,7 @@ var FilerReplySchema = external_exports.object({
     key: str3,
     question: str3,
     text: str3,
+    summary: str3,
     to: str3,
     goal: str3,
     options: external_exports.array(external_exports.object({ id: str3, label: str3 }).strict()),
@@ -10453,6 +10464,58 @@ var FilerReplySchema = external_exports.object({
 var FILER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema(FilerReplySchema, { $refStrategy: "none" })
 );
+var ExplainerReplySchema = external_exports.object({
+  /** The explanation, as sentences, spoken in order. */
+  say: external_exports.array(external_exports.string()),
+  /** Questions to an agent about gaps in what it read: the agent's handle and the question. */
+  followUps: external_exports.array(external_exports.object({ to: external_exports.string(), text: external_exports.string() }).strict())
+}).strict();
+var EXPLAINER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema(ExplainerReplySchema, { $refStrategy: "none" })
+);
+var DISTILLER_DEFECTS = [
+  "reasked",
+  // a question put to the person again after they answered it
+  "unsupported",
+  // a fact stated that nothing in the input supports
+  "unsaid",
+  // an agent's answer arrived during the call and was never said
+  "skipped",
+  // an agenda item never put to the person
+  "unsaved",
+  // something the person answered or asked for did not save, was refused or dropped
+  "ignored",
+  // the person asked or said something and was never answered (the critic's ignored_a_question)
+  "promised"
+  // said it did or would do something, and nothing shows it done (the critic's broken_promise)
+];
+var DistillerReplySchema = external_exports.object({
+  defects: external_exports.array(external_exports.object({
+    kind: external_exports.enum(DISTILLER_DEFECTS),
+    /** The handles of the lines it shows in. */
+    lines: external_exports.array(external_exports.string()),
+    /** The handle of the record it concerns, or "". */
+    about: external_exports.string(),
+    /** One plain sentence, in words, never handles: it is what the feedback row keeps. */
+    why: external_exports.string()
+  }).strict())
+}).strict();
+var DISTILLER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema(DistillerReplySchema, { $refStrategy: "none" })
+);
+var TIDY_AUDIENCES = ["talker", "filer", "agents"];
+var TidyReplySchema = external_exports.object({
+  lessons: external_exports.array(external_exports.object({
+    lesson: external_exports.string(),
+    op: external_exports.enum(["keep", "revise", "withdraw"]),
+    text: external_exports.string(),
+    for: external_exports.enum([...TIDY_AUDIENCES, ""]),
+    into: external_exports.string()
+  }).strict())
+}).strict();
+var TIDY_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema(TidyReplySchema, { $refStrategy: "none" })
+);
 function entryUnit(entry) {
   if (entry.kind !== "contribution" || !entry.aboutId) return null;
   const plain = entry.content && "plain" in entry.content ? entry.content.plain : null;
@@ -11142,7 +11205,7 @@ var ConnectionSummarySchema = external_exports.object({
    *  desktop app while open. Null = never seen; stale = offline. */
   lastSeenAt: external_exports.string().datetime().nullable().optional(),
   /** WORKING, NOT JUST CONNECTED (owner, 2026-09-30): the last time the agent itself acted on one of
-   *  its Goals — took its lease or recorded an operation (`tokens.last_worked_at`). Within
+   *  its Goals — wrote on one or recorded an operation (`tokens.last_worked_at`). Within
    *  `WORKING_MS` it is working; otherwise it is connected but idle. Null = not seen working yet. */
   lastWorkedAt: external_exports.string().datetime().nullable().optional(),
   /** The oldest of its Goals that is `ready` for it — work handed to it that nobody has started.
@@ -11340,7 +11403,7 @@ var QueueItemSchema = external_exports.object({
    *
    *  IT IS THE PAYLOAD'S OWN HASH, NEVER A STAMP ON THE WORK. Nothing here reasons about which
    *  writes change which field — the comparison is over the bytes the phone is holding, so a fact
-   *  the row shows that no `updated_at` moves for (a lease lapsing, a dependency's state, a
+   *  the row shows that no `updated_at` moves for (`active` lapsing, a dependency's state, a
    *  sibling appearing in `childGoalIds`) cannot go unnoticed. Optional because a hand-built
    *  queue (a fixture, the demo) spells none, and a row with no rev is simply always re-sent. */
   rev: external_exports.string().optional()
@@ -11657,14 +11720,13 @@ var CallRecapSchema = external_exports.object({
     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. */
+    /** `words` is always what they SAID, verbatim — the record, never replaced. `summary` is what
+     *  the line says in ten words (owner, 2026-10-07): the filer's, or the talker's for the answer it
+     *  gave, so the row scans like a chosen option and their own words stay under it. Absent when
+     *  neither wrote one. */
     /** `about` is the request the line answered (its question), null for words that answered none —
      *  the key the screen groups on, so one question is one row however many times it was answered. */
-    lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), headline: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
+    lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), summary: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
   })),
   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() })
@@ -14457,10 +14519,12 @@ var zodToJsonSchema2 = (schema, options) => {
 // ../../packages/schema/dist/index.js
 var OPTIONS_MIN2 = 2;
 var OPTIONS_MAX2 = 6;
+var OPTION_LABEL_MAX2 = 50;
+var OPTION_HINT_MAX2 = 200;
 var OptionSchema2 = external_exports.object({
   id: external_exports.string(),
   label: external_exports.string(),
-  hint: external_exports.string().max(500).describe("Optional short projection of consequence or action if this option is chosen (e.g. 'Reruns test suite', 'Merges to main').").optional(),
+  hint: external_exports.string().max(500).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX2} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   // .describe() flows into the MCP contact JSON schema (zodToJsonSchema), so
   // the constraints below are what an agent reads when deciding to use these.
   html: external_exports.string().max(16384).describe(
@@ -14474,8 +14538,10 @@ var OptionInputSchema2 = external_exports.object({
   id: external_exports.string().trim().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/).optional().describe(
     `Optional: this option's own id, which answers name it by (selectedOptionIds). Give every option one, or none: without them the options are numbered "1", "2", \u2026 in order.`
   ),
-  label: external_exports.string().trim().min(1).max(1e3),
-  hint: OptionSchema2.shape.hint,
+  // SHORT CHOICES (owner, 2026-10-07: "options label should be maybe max 50 characters and the hint 200"):
+  // a label is one choice the person reads, or hears on a call; a hint says its consequence in a line.
+  label: external_exports.string().trim().min(1).max(OPTION_LABEL_MAX2, `option_label_too_long: an option's label is at most ${OPTION_LABEL_MAX2} characters; say the choice, and put its consequence in the hint.`).describe(`The choice, at most ${OPTION_LABEL_MAX2} characters, standing on its own.`),
+  hint: external_exports.string().max(OPTION_HINT_MAX2, `option_hint_too_long: an option's hint is at most ${OPTION_HINT_MAX2} characters.`).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX2} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   htmlPreview: OptionSchema2.shape.html,
   imgUrl: OptionSchema2.shape.image
 }).strict();
@@ -14585,7 +14651,7 @@ var questionFields2 = {
   ),
   goalId: external_exports.string().uuid().describe("The Goal the question is about, which must exist (create it with manage_goals first). Its answer comes back there."),
   units: units2,
-  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own."),
+  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own, at most 50 characters; a hint, at most 200."),
   // HOW THE OPTIONS ARE ANSWERED, SAID BY THE AGENT (owner, 2026-10-02: "one and many makes sense";
   // brain_prompts.md §1: structured agent questions need no model). The app draws all three.
   pickMode: external_exports.enum(["one", "many", "rank"]).optional().describe(
@@ -14705,7 +14771,8 @@ var UpdateGoalSchema2 = external_exports.object({
 }).strict();
 var changedGoal2 = external_exports.string().uuid().describe("The Goal to change, as a read shows it.");
 var goalTitle2 = external_exports.string().trim().min(1).max(80).describe("The Goal's short display name: one to five words, how a person refers to it out loud.");
-var goalOutcome2 = external_exports.string().trim().min(1).max(1e4).describe("The full desired result. There is no third description field.");
+var GOAL_OUTCOME_MAX2 = 500;
+var goalOutcome2 = external_exports.string().trim().min(1).max(GOAL_OUTCOME_MAX2, `outcome_too_long: a Goal's outcome is one paragraph, at most ${GOAL_OUTCOME_MAX2} characters; split the rest into child Goals (create with parentGoalId).`).describe(`The desired result, one paragraph of at most ${GOAL_OUTCOME_MAX2} characters. More than that is more work: create child Goals under it (parentGoalId). There is no third description field.`);
 var CreateChange2 = external_exports.object({
   kind: external_exports.literal("create"),
   title: goalTitle2,
@@ -14731,7 +14798,7 @@ var DependencyChange2 = external_exports.object({
   goalId: changedGoal2,
   dependsOnGoalId: external_exports.string().uuid().describe("The Goal it waits on."),
   action: external_exports.enum(["start", "complete"]).describe("What waits: starting goalId, or completing it."),
-  reason: external_exports.string().trim().min(1).max(2e3).optional().describe("Why, as an explanation, never as policy.")
+  reason: external_exports.string().trim().min(1).max(250).optional().describe("Why, at most 250 characters, as an explanation, never as policy.")
 }).strict();
 var read2 = { revision: external_exports.number().int().positive().optional() };
 var GoalChangeSchema2 = external_exports.discriminatedUnion("kind", [
@@ -14755,7 +14822,7 @@ var ManageGoalsSchema2 = external_exports.object({
 var ManageGoalsToolSchema2 = external_exports.object({
   changes: external_exports.array(external_exports.discriminatedUnion("kind", [CreateChange2, EditChange2, StateChange2, AssignChange2, DeferChange2, MoveChange2, DependencyChange2])).min(1).max(50).describe("The changes, applied in order, each on its own.")
 }).strict().superRefine((v, ctx) => editNames2(v.changes, ctx));
-var MANAGE_GOALS_DESCRIPTION2 = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls; edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
+var MANAGE_GOALS_DESCRIPTION2 = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls (an outcome is one paragraph, at most 500 characters: split more into child Goals with parentGoalId); edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
 var GetGoalSchema2 = external_exports.object({
   goalId: external_exports.string().uuid(),
   /** Every entry in full. Without it the read carries the person's words, open questions and your
@@ -14773,7 +14840,7 @@ var SearchToolSchema2 = external_exports.object({
   goalId: external_exports.string().uuid().optional(),
   limit: external_exports.number().int().min(1).max(20).optional()
 }).strict();
-var SEARCH_DESCRIPTION2 = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and Answers (found by their Question or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, its Questions' Answers, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (an Answer carries its Question, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
+var SEARCH_DESCRIPTION2 = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and replies -- the person's answers, acknowledgements and deferrals (type answer; found by their summary, by the question or report they reply to, or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, the replies to its items, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (a reply carries its kind -- answered, acknowledged or deferred -- whether it is closed (a deferral is not), its summary in under ten words, its question or report, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
 var CheckActivitySchema2 = external_exports.object({}).strict();
 var FEEDBACK_TEXT_MAX2 = 5e4;
 var SendFeedbackSchema2 = external_exports.object({
@@ -14836,6 +14903,7 @@ var QuestionChangeSchema2 = external_exports.union([
   external_exports.object({
     kind: external_exports.literal("create"),
     text: external_exports.string().min(1),
+    summary: external_exports.string().optional(),
     answererId: participant2,
     goal: ResultRefSchema2.optional(),
     blocks: external_exports.array(external_exports.object({ question: ResultRefSchema2 }).strict()),
@@ -14886,12 +14954,12 @@ var BrainSearchSchema2 = external_exports.object({
 }).strict();
 var BrainResultSchema2 = external_exports.object({
   messages: external_exports.array(BrainMessageSchema2),
-  entries: external_exports.array(external_exports.object({ key: key2, sources: external_exports.array(SourceSchema2).min(1), goals: external_exports.array(ResultRefSchema2) }).strict()),
+  entries: external_exports.array(external_exports.object({ key: key2, sources: external_exports.array(SourceSchema2).min(1), goals: external_exports.array(ResultRefSchema2), summary: external_exports.string().optional() }).strict()),
   questions: external_exports.array(external_exports.object({ key: key2, entryKeys: external_exports.array(key2), change: QuestionChangeSchema2 }).strict()),
   answers: external_exports.array(external_exports.object({
     question: ResultRefSchema2,
     entryKeys: external_exports.array(key2).min(1),
-    summary: external_exports.string().min(1),
+    summary: external_exports.string(),
     selectedOptionIds: external_exports.array(external_exports.string().min(1)).optional()
   }).strict()),
   goals: external_exports.array(external_exports.object({ key: key2, entryKeys: external_exports.array(key2), change: BrainGoalChangeSchema2 }).strict()),
@@ -14936,12 +15004,15 @@ var TalkerReplySchema2 = external_exports.object({
   messages: external_exports.array(external_exports.object({ key: str22, to: str22, text: str22, about: strs22, blocks: str22 }).strict()),
   /** What the call does next: listen, hold (the person asked for a moment) or end (they asked to). */
   then: external_exports.enum(["listen", "hold", "end"]),
-  /** Items the person's words settle: the item's handle, the chosen option IDs, the line handles. */
-  answers: external_exports.array(external_exports.object({ item: str22, options: strs22, lines: strs22 }).strict()),
-  /** The line handles that hold a new instruction from the person. */
+  /** The person's replies to items (replies, owner 2026-10-07): the item's handle, the chosen option
+   *  IDs, the line handles, how they replied in under ten words (keeping any condition), and `defer`:
+   *  "" when their words settle the item, else what a reply that puts it off waits for -- "call" (the
+   *  end of this call), a question's handle (that question's answer) or an ISO time. */
+  replies: external_exports.array(external_exports.object({ item: str22, options: strs22, lines: strs22, summary: str22, defer: str22 }).strict()),
+  /** The line handles that tell the talker how to run this call; they last until it ends and reach no agent. */
   instruction: strs22,
-  /** The line handles that ask for new work, a change to existing work, or a standing rule: the filer
-   *  reads only these (3e). */
+  /** The line handles the filer acts on, and the only ones it reads (3e): new work, a change to existing
+   *  work, feedback on Paigy, anything said to an agent, and any rule meant to outlast the call. */
   file: strs22,
   /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
   need: external_exports.object({ kind: external_exports.enum(["search", "item", "agent", ""]), text: str22 }).strict(),
@@ -14954,8 +15025,9 @@ var TALKER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
 var str32 = external_exports.string();
 var strs32 = external_exports.array(external_exports.string());
 var FilerReplySchema2 = external_exports.object({
-  /** Which Goals each new line goes on: a line's handle and Goal handles (or keys of new Goals). */
-  filed: external_exports.array(external_exports.object({ line: str32, goals: strs32 }).strict()),
+  /** Which Goals each new line goes on: a line's handle, Goal handles (or keys of new Goals), and what
+   *  the line says in at most ten words. */
+  filed: external_exports.array(external_exports.object({ line: str32, goals: strs32, summary: str32 }).strict()),
   goals: external_exports.array(external_exports.object({
     op: external_exports.enum(["create", "edit", "complete", "cancel", "reopen", "assign", "defer", "move", "block", "unblock"]),
     key: str32,
@@ -14974,6 +15046,7 @@ var FilerReplySchema2 = external_exports.object({
     key: str32,
     question: str32,
     text: str32,
+    summary: str32,
     to: str32,
     goal: str32,
     options: external_exports.array(external_exports.object({ id: str32, label: str32 }).strict()),
@@ -14987,6 +15060,58 @@ var FilerReplySchema2 = external_exports.object({
 var FILER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema2(FilerReplySchema2, { $refStrategy: "none" })
 );
+var ExplainerReplySchema2 = external_exports.object({
+  /** The explanation, as sentences, spoken in order. */
+  say: external_exports.array(external_exports.string()),
+  /** Questions to an agent about gaps in what it read: the agent's handle and the question. */
+  followUps: external_exports.array(external_exports.object({ to: external_exports.string(), text: external_exports.string() }).strict())
+}).strict();
+var EXPLAINER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(ExplainerReplySchema2, { $refStrategy: "none" })
+);
+var DISTILLER_DEFECTS2 = [
+  "reasked",
+  // a question put to the person again after they answered it
+  "unsupported",
+  // a fact stated that nothing in the input supports
+  "unsaid",
+  // an agent's answer arrived during the call and was never said
+  "skipped",
+  // an agenda item never put to the person
+  "unsaved",
+  // something the person answered or asked for did not save, was refused or dropped
+  "ignored",
+  // the person asked or said something and was never answered (the critic's ignored_a_question)
+  "promised"
+  // said it did or would do something, and nothing shows it done (the critic's broken_promise)
+];
+var DistillerReplySchema2 = external_exports.object({
+  defects: external_exports.array(external_exports.object({
+    kind: external_exports.enum(DISTILLER_DEFECTS2),
+    /** The handles of the lines it shows in. */
+    lines: external_exports.array(external_exports.string()),
+    /** The handle of the record it concerns, or "". */
+    about: external_exports.string(),
+    /** One plain sentence, in words, never handles: it is what the feedback row keeps. */
+    why: external_exports.string()
+  }).strict())
+}).strict();
+var DISTILLER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(DistillerReplySchema2, { $refStrategy: "none" })
+);
+var TIDY_AUDIENCES2 = ["talker", "filer", "agents"];
+var TidyReplySchema2 = external_exports.object({
+  lessons: external_exports.array(external_exports.object({
+    lesson: external_exports.string(),
+    op: external_exports.enum(["keep", "revise", "withdraw"]),
+    text: external_exports.string(),
+    for: external_exports.enum([...TIDY_AUDIENCES2, ""]),
+    into: external_exports.string()
+  }).strict())
+}).strict();
+var TIDY_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(TidyReplySchema2, { $refStrategy: "none" })
+);
 function entryWords(entry) {
   const content = entry.content;
   if (content && "sealed" in content) return "";
@@ -15686,7 +15811,7 @@ var ConnectionSummarySchema2 = external_exports.object({
    *  desktop app while open. Null = never seen; stale = offline. */
   lastSeenAt: external_exports.string().datetime().nullable().optional(),
   /** WORKING, NOT JUST CONNECTED (owner, 2026-09-30): the last time the agent itself acted on one of
-   *  its Goals — took its lease or recorded an operation (`tokens.last_worked_at`). Within
+   *  its Goals — wrote on one or recorded an operation (`tokens.last_worked_at`). Within
    *  `WORKING_MS` it is working; otherwise it is connected but idle. Null = not seen working yet. */
   lastWorkedAt: external_exports.string().datetime().nullable().optional(),
   /** The oldest of its Goals that is `ready` for it — work handed to it that nobody has started.
@@ -15884,7 +16009,7 @@ var QueueItemSchema2 = external_exports.object({
    *
    *  IT IS THE PAYLOAD'S OWN HASH, NEVER A STAMP ON THE WORK. Nothing here reasons about which
    *  writes change which field — the comparison is over the bytes the phone is holding, so a fact
-   *  the row shows that no `updated_at` moves for (a lease lapsing, a dependency's state, a
+   *  the row shows that no `updated_at` moves for (`active` lapsing, a dependency's state, a
    *  sibling appearing in `childGoalIds`) cannot go unnoticed. Optional because a hand-built
    *  queue (a fixture, the demo) spells none, and a row with no rev is simply always re-sent. */
   rev: external_exports.string().optional()
@@ -16199,14 +16324,13 @@ var CallRecapSchema2 = external_exports.object({
     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. */
+    /** `words` is always what they SAID, verbatim — the record, never replaced. `summary` is what
+     *  the line says in ten words (owner, 2026-10-07): the filer's, or the talker's for the answer it
+     *  gave, so the row scans like a chosen option and their own words stay under it. Absent when
+     *  neither wrote one. */
     /** `about` is the request the line answered (its question), null for words that answered none —
      *  the key the screen groups on, so one question is one row however many times it was answered. */
-    lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), headline: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
+    lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), summary: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
   })),
   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() })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paigy/harness",
-  "version": "0.3.36",
+  "version": "0.3.37",
   "description": "Run Claude Code / Codex on this machine, bridged to Paigy — launchable from your phone.",
   "license": "MIT",
   "type": "module",