@paigy/harness 0.3.33 → 0.3.35

package/dist/cli.js

@@ -23805,28 +23805,28 @@ function overrideToken(secret) {
 async function fail(what, res) {
   throw new ApiError(what, res.status, await res.text());
 }
-async function createGoal(input, opts = {}) {
+async function manageGoals(input, opts = {}) {
   const token = authToken(opts.token) ?? "";
-  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals`, {
+  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals/manage`, {
     method: "POST",
-    headers: { "content-type": "application/json", authorization: `Bearer ${token}`, "x-paigy-model": "goal-entry-v1" },
+    headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
     body: JSON.stringify(input)
   }));
-  if (!res.ok) await fail("create_goal", res);
+  if (!res.ok) await fail("manage_goals", res);
   return await res.json();
 }
 async function claimGoal(goalId, opts = {}) {
   const token = authToken(opts.token) ?? "";
-  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals/claim`, { method: "POST", headers: { "content-type": "application/json", authorization: `Bearer ${token}`, "x-paigy-model": "goal-entry-v1" }, body: JSON.stringify(goalId ? { goalId } : {}) }));
+  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals/claim`, { method: "POST", headers: { "content-type": "application/json", authorization: `Bearer ${token}` }, body: JSON.stringify(goalId ? { goalId } : {}) }));
   if (!res.ok) await fail("claim_goal", res);
   return await res.json();
 }
-async function getGoal(goalId, opts = {}, read = {}) {
+async function getGoal(goalId, opts = {}, read3 = {}) {
   const token = authToken(opts.token) ?? "";
-  const query = [read.history ? "history=1" : "", read.diagnose ? "diagnose=1" : ""].filter(Boolean).join("&");
+  const query = [read3.history ? "history=1" : "", read3.diagnose ? "diagnose=1" : ""].filter(Boolean).join("&");
   const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals/${encodeURIComponent(goalId)}${query ? `?${query}` : ""}`, {
     method: "GET",
-    headers: { authorization: `Bearer ${token}`, "x-paigy-model": "goal-entry-v1" }
+    headers: { authorization: `Bearer ${token}` }
   }));
   if (!res.ok) await fail("get_goal", res);
   return await res.json();
@@ -23834,7 +23834,7 @@ async function getGoal(goalId, opts = {}, read = {}) {
 async function updateGoal(goalId, input, opts = {}) {
   const token = authToken(opts.token) ?? "";
   const operationId = input.operationId ?? randomUUID2();
-  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals/${encodeURIComponent(goalId)}`, { method: "PATCH", headers: { "content-type": "application/json", authorization: `Bearer ${token}`, "x-paigy-model": "goal-entry-v1" }, body: JSON.stringify({ ...input, operationId }) }));
+  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals/${encodeURIComponent(goalId)}`, { method: "PATCH", headers: { "content-type": "application/json", authorization: `Bearer ${token}` }, body: JSON.stringify({ ...input, operationId }) }));
   if (!res.ok) await fail("update_goal", res);
   return await res.json();
 }
@@ -23926,7 +23926,7 @@ async function listNotes(opts = {}) {
 }
 async function listConnections(opts = {}) {
   const res = await ensureAuthed(await reach(`${BACKEND_URL}/api/tokens`, {
-    headers: { authorization: `Bearer ${authToken(opts.token)}`, "x-paigy-model": "goal-entry-v1" }
+    headers: { authorization: `Bearer ${authToken(opts.token)}` }
   }));
   if (!res.ok) throw new Error(`list_connections failed: ${res.status} ${await res.text()}`);
   return await res.json();
@@ -23976,9 +23976,10 @@ function currentRepo(cwd = process.cwd()) {
 }
 async function contact(input, opts = {}) {
   const parsed = ContactSchema.parse(input);
+  if (!("asks" in parsed) && !("deliveryId" in parsed)) throw new Error("contact with nothing to send receives: call receiveContact");
   opts.signal?.throwIfAborted();
   const send22 = opts.reach ?? reach;
-  const headers = { "content-type": "application/json", authorization: `Bearer ${authToken(opts.token) ?? ""}`, "x-paigy-model": "goal-entry-v1" };
+  const headers = { "content-type": "application/json", authorization: `Bearer ${authToken(opts.token) ?? ""}` };
   let deliveryId;
   let deliveries = [];
   let recorded = [];
@@ -24023,7 +24024,7 @@ async function contact(input, opts = {}) {
   const all = deliveries.filter((d) => !!d.deliveryId && !!d.goalId).map(({ id: id22, deliveryId: deliveryId2, goalId }) => ({ ...id22 ? { id: id22 } : {}, deliveryId: deliveryId2, goalId }));
   const joinedCard = deliveries[0]?.joinedCard === true;
   const joinedCall = deliveries[0]?.joinedCall === true;
-  const read = async (signal2) => {
+  const read3 = async (signal2) => {
     const res = await ensureAuthed(await send22(`${BACKEND_URL}/api/deliveries/${encodeURIComponent(deliveryId)}`, { headers, signal: signal2 }));
     if (!res.ok) await fail("read_delivery", res);
     const one = await res.json();
@@ -24037,14 +24038,14 @@ async function contact(input, opts = {}) {
     };
   };
   const settled = (d) => d.kind === "notification" || d.state === "closed" || d.answers.length > 0 || d.entries.some((e) => e.kind === "contribution");
-  if (opts.waits === false) return read(opts.signal);
+  if (opts.waits === false) return read3(opts.signal);
   const window = AbortSignal.timeout(AWAIT_WINDOW_MS);
   const signal = opts.signal ? AbortSignal.any([opts.signal, window]) : window;
   let latest;
   try {
     while (true) {
       signal.throwIfAborted();
-      latest = await read(signal);
+      latest = await read3(signal);
       if (settled(latest)) return latest;
       await sleep2(5e3, void 0, { signal });
     }
@@ -24054,11 +24055,11 @@ async function contact(input, opts = {}) {
     throw error;
   }
 }
-async function checkReplies(opts = {}) {
+async function receive(opts = {}) {
   const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/deliveries`, {
-    headers: { authorization: `Bearer ${authToken(opts.token) ?? ""}`, "x-paigy-model": "goal-entry-v1" }
+    headers: { authorization: `Bearer ${authToken(opts.token) ?? ""}` }
   }));
-  if (!res.ok) await fail("check_replies", res);
+  if (!res.ok) await fail("receive", res);
   return await res.json();
 }
 function frame(line, topic, event, payload) {
@@ -24243,7 +24244,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, AskInputSchema, StartContactSchema, ContactSchema, CONTACT_SCHEMA, CONTACT_DESCRIPTION, CreateGoalSchema, CreateGoalToolSchema, CREATE_GOAL_DESCRIPTION, UpdateGoalSchema, UpdateGoalToolSchema, ClaimGoalSchema, GetGoalSchema, GET_GOAL_DESCRIPTION, UPDATE_GOAL_DESCRIPTION, CLAIM_GOAL_DESCRIPTION, CHECK_REPLIES_DESCRIPTION, CheckRepliesSchema, AGENT_TOOLS, AGENT_TOOL_NAMES, id, key, participant, SourceSchema, ResultRefSchema, NodeRefSchema, DependencySchema, goalState, existingGoalChanges, GoalChangeSchema, BrainGoalChangeSchema, option, QuestionChangeSchema, lessonScope, LessonChangeSchema, BrainNextSchema, messageBase, BrainMessageSchema, BrainSearchSchema, BrainResultSchema, str, strs, CompactResultSchema, COMPACT_RESULT_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, MoveRingSchema, MoveSchema, 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, asked, NOT_SENT, 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, OptionSchema, OptionInputSchema, NIGHT, AskInputSchema, StartContactSchema, ReceiveContactSchema, ContactSchema, CONTACT_SCHEMA, CONTACT_DESCRIPTION, CreateGoalSchema, UpdateGoalSchema, UpdateGoalToolSchema, changedGoal, goalTitle, goalOutcome, CreateChange, EditChange, StateChange, AssignChange, DeferChange, MoveChange, DependencyChange, read, GoalChangeSchema, editNames, ManageGoalsSchema, ManageGoalsToolSchema, MANAGE_GOALS_DESCRIPTION, ClaimGoalSchema, GetGoalSchema, GET_GOAL_DESCRIPTION, UPDATE_GOAL_DESCRIPTION, CLAIM_GOAL_DESCRIPTION, SearchToolSchema, SEARCH_DESCRIPTION, WhoIsWorkingSchema, 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, 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, asked, NOT_SENT, DEMOTED, HEARTBEAT_MS, RETRY_MS, JOIN, JOIN_TIMEOUT_MS, lines;
 var init_dist = __esm({
   "../../packages/sdk/dist/index.js"() {
     "use strict";
@@ -24669,7 +24670,7 @@ var init_dist = __esm({
         'How the options are answered: "many" makes a checklist (they may want several, e.g. independent fixes), "one" (the default) a pick (choosing one rules out the others). Send "many" whenever more than one option could be wanted at once. The person can always answer in their own words as well. Ignored without options.'
       ),
       answers: external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/).optional().describe(
-        "Your reply answers a question the person asked you: the id the conversation shows for it (8 characters or whole). Their question closes with this reply as its answer, and any decision of yours it was holding back goes back to them. Needs parentId: the Goal the question is on. The reply is sent to them as it is; to also ask something new, send that as its own ask."
+        "Your reply answers a question the person asked you: the id the conversation shows for it (8 characters or whole). Their question closes with this reply as its answer, and any decision of yours it was holding back goes back to them. parentId is optional here: the question's own Goal is used. The reply is sent to them as it is; to also ask something new, send that as its own ask."
       )
     }).strict();
     StartContactSchema = external_exports.object({
@@ -24677,9 +24678,17 @@ var init_dist = __esm({
       waiting: external_exports.enum(["none", "hard"]).default("none").describe("hard requests a call even when channel is notification; user permissions and ring cooldowns still apply."),
       channel: external_exports.enum(["notification", "call"]).default("notification")
     }).strict();
-    ContactSchema = external_exports.union([StartContactSchema, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict()]);
+    ReceiveContactSchema = external_exports.object({
+      wait: external_exports.boolean().optional().describe(
+        "Only controls when this returns. true (the default when you send and acknowledge nothing): wait up to about 45 seconds for incoming communication addressed to you, and return as soon as some is available. false: return what is waiting now. It does not mean work is blocked, set urgency, or ask for a call. `waitOutcome` says which happened: `available`, `expired` (nothing arrived in the window; wait again without sending again), or `not_waited` (a hosted connection never holds a wait)."
+      ),
+      ackEventIds: external_exports.array(external_exports.string().uuid()).min(1).max(100).optional().describe(
+        "The exact eventIds of the events you have handled: an acknowledgment (ACK). Reading alone acknowledges nothing, so an event comes back until you acknowledge it; after that the next batch can come. Each recipient acknowledges separately, for itself only. A Question you owe is answered (an ask with `answers`), never acknowledged away: that id is refused until it is answered."
+      )
+    }).strict();
+    ContactSchema = external_exports.union([StartContactSchema, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict(), ReceiveContactSchema]);
     CONTACT_SCHEMA = { type: "object", ...mcpInputSchema(ContactSchema) };
-    CONTACT_DESCRIPTION = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'select', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none starts a new Goal of yours. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. Each ask is sent exactly as written, with no reading in between: a bundled ask arrives as one card, so separate questions are separate asks. An ask with no options that is not blocking is a report, and a report is an UPDATE, never a claim on them: it reaches them and is listed apart from what waits on them, so no answer is owed and none should be awaited. On a Goal whose report card is still open it is added to that card, with no new push; Where your work stands while under way is progress: report it with update_goal, not contact. Send options (or waiting:'hard') when you actually need an answer. Each option's label must stand on its own \u2014 the person may see only the labels \u2014 so never a label that points into your text ('All three', 'Option 2', '1 and 3 only'). select:'many' makes the card a checklist, for independent options they may want several of; select:'one' (the default) a pick, for alternatives. The person can always answer in their own words, so never add an 'Other' option. If the person is already on a call, your contact joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.";
+    CONTACT_DESCRIPTION = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'select', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none starts a new Goal of yours. Notification returns immediately; collect answers by receiving (below). On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. Each ask is sent exactly as written, with no reading in between: a bundled ask arrives as one card, so separate questions are separate asks. An ask with no options that is not blocking is a report, never a claim on them, so no answer is owed and none should be awaited. A report reaches the person only when it answers something they asked you, or once the Goal is done; any other report is recorded as the Goal's progress and nobody is notified. So when the work is finished, mark the Goal done first, then send one message saying what is done and anything they need to do or check. On a Goal whose report card is still open, a report that does reach them is added to that card, with no new push. Send options (or waiting:'hard') when you actually need an answer. Each option's label must stand on its own \u2014 the person may see only the labels \u2014 so never a label that points into your text ('All three', 'Option 2', '1 and 3 only'). select:'many' makes the card a checklist, for independent options they may want several of; select:'one' (the default) a pick, for alternatives. The person can always answer in their own words, so never add an 'Other' option. If the person is already on a call, a contact that reaches them joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.\n\nRECEIVING: contact with no asks sends nothing and returns `events`, a limited batch of what is addressed to you (not a history page): `question`, a Question you owe (answer it with an ask whose `answers` is its questionId); `update`, something new on one of your Goals (a reply, an answer: read it with get_goal); `instruction`, a request or note sent to you. `hasMore` says more are waiting. Reading acknowledges nothing: once you have handled events, confirm their eventIds with contact({ackEventIds}), and the next batch can come. contact({}) waits up to about 45 seconds for something to arrive; contact({wait:false}) returns at once. It also lists work given to you that nobody has started (`assigned`; claim_goal starts it) and your work gone quiet (`stalled`).";
     CreateGoalSchema = external_exports.object({
       outcome: external_exports.string().trim().min(1).max(1e4),
       /** The work's NAME (#2115) — one to five words, how a person refers to it out loud ("the night
@@ -24699,10 +24708,6 @@ var init_dist = __esm({
        *  repo name. Delegated work inherits this from its parent Goal when omitted. */
       repo: external_exports.string().trim().min(1).max(200).optional()
     });
-    CreateGoalToolSchema = CreateGoalSchema.extend({
-      idempotencyKey: CreateGoalSchema.shape.idempotencyKey.optional().describe("Optional. One is minted per call; pass your own only so a retry lands on the same Goal.")
-    }).strict();
-    CREATE_GOAL_DESCRIPTION = 'Create a durable Goal for an outcome. Without parentGoalId it is placed against your open Goals: if one already IS this work, that Goal comes back (existing: true) and nothing new is created \u2014 continue it; if the work belongs under one, it is created there (parentGoalId in the receipt); otherwise it is a root. Pass parentGoalId yourself to put it under a specific Goal. Pass repo to anchor the work to a specific repository ("owner/repo" or repo name); delegated children inherit it. Pass title to name it in one to five words, as a person would refer to it out loud ("the night rings") \u2014 it heads every list and is spoken on a call; without one the brain writes it. Admission only: claim it before doing work, then update it as it advances. Returns an admission receipt with goalId, current state, revision, ownerParticipant, and the next step; no Goal content or execution lease.';
     UpdateGoalSchema = external_exports.object({
       revision: external_exports.number().int().positive(),
       changes: external_exports.object({
@@ -24726,7 +24731,65 @@ var init_dist = __esm({
       reason: external_exports.string().trim().min(1).max(2e3),
       operationId: external_exports.string().uuid().optional()
     }).strict();
-    UpdateGoalToolSchema = UpdateGoalSchema.omit({ operationId: true }).extend({ goalId: external_exports.string().uuid() }).strict();
+    UpdateGoalToolSchema = external_exports.object({
+      goalId: external_exports.string().uuid(),
+      revision: UpdateGoalSchema.shape.revision,
+      changes: UpdateGoalSchema.shape.changes.innerType().pick({ progress: true, reviewed: true, dueAt: true, withdraw: true }).strict().refine((v) => Object.keys(v).length > 0),
+      reason: UpdateGoalSchema.shape.reason
+    }).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.");
+    CreateChange = external_exports.object({
+      kind: external_exports.literal("create"),
+      title: goalTitle,
+      outcome: goalOutcome,
+      ownerId: external_exports.string().trim().min(1).optional().describe("Who owns the work: an agent's participant (as who_is_working shows it) or the person's. Omitted: you."),
+      parentGoalId: external_exports.string().uuid().optional().describe("The Goal it belongs under. Omitted: a root."),
+      sourceEntryIds: external_exports.array(external_exports.string().uuid()).max(20).optional().describe("The whole Entries the work came from, ones you can read.")
+    }).strict();
+    EditChange = external_exports.object({ kind: external_exports.literal("edit"), goalId: changedGoal, title: goalTitle.optional(), outcome: goalOutcome.optional() }).strict();
+    StateChange = external_exports.object({ kind: external_exports.literal("state"), goalId: changedGoal, state: external_exports.enum(["open", "completed", "canceled"]).describe(
+      "completed: the Goal's own work is done now (refused while required children are open); open: reopen it; canceled: it will not be done."
+    ) }).strict();
+    AssignChange = external_exports.object({ kind: external_exports.literal("assign"), goalId: changedGoal, ownerId: external_exports.string().trim().min(1).describe("The new owner's participant.") }).strict();
+    DeferChange = external_exports.object({ kind: external_exports.literal("defer"), goalId: changedGoal, until: external_exports.string().datetime({ offset: true }).nullable().describe(
+      "Postpone it until this instant (its owner is woken then), or null to take the postponement back."
+    ) }).strict();
+    MoveChange = external_exports.object({ kind: external_exports.literal("move"), goalId: changedGoal, parentGoalId: external_exports.string().uuid().nullable().describe(
+      "Its new parent, or null for a root. Only this Goal moves; its new parent's other children stay."
+    ) }).strict();
+    DependencyChange = external_exports.object({
+      kind: external_exports.literal("dependency"),
+      change: external_exports.enum(["add", "remove"]),
+      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.")
+    }).strict();
+    read = { revision: external_exports.number().int().positive().optional() };
+    GoalChangeSchema = external_exports.discriminatedUnion("kind", [
+      CreateChange,
+      EditChange.extend(read),
+      StateChange.extend(read),
+      AssignChange.extend(read),
+      DeferChange.extend(read),
+      MoveChange.extend(read),
+      DependencyChange
+    ]);
+    editNames = (changes, ctx) => changes.forEach((c, i) => {
+      if (c.kind === "edit" && c.title === void 0 && c.outcome === void 0) {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["changes", i], message: "an edit supplies title, outcome, or both" });
+      }
+    });
+    ManageGoalsSchema = external_exports.object({
+      requestId: external_exports.string().uuid().optional(),
+      changes: external_exports.array(GoalChangeSchema).min(1).max(50)
+    }).strict().superRefine((v, ctx) => editNames(v.changes, ctx));
+    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_joined, 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, or null); 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 a Goal you own or have written on. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
     ClaimGoalSchema = external_exports.object({ goalId: external_exports.string().uuid().optional() }).strict();
     GetGoalSchema = external_exports.object({
       goalId: external_exports.string().uuid(),
@@ -24739,27 +24802,30 @@ var init_dist = __esm({
       diagnose: external_exports.boolean().optional()
     }).strict();
     GET_GOAL_DESCRIPTION = "Read one Goal without claiming it, including others (the ten most recent other contributors, with names, latest entry headlines and times): its outcome, state, revision, progress, blockers, the conversation on it (each question with its options and what was decided), `next`, the one step to take, and `more`, where to read further. A question in that conversation reads `open` (nothing yet), `answered` (a choice was made, and `answer` carries it), `replied` (they said something and the read settled the question on their words \u2014 NO option of yours was chosen, and the words are the reply line beside it, so read that before you act), or `closed`. The conversation carries everything the person said, every open question and your newest entry; your older entries are left out and counted \u2014 history: true reads every entry in full. Every Goal of your person is readable, whichever of their agents owns it; another account's Goals are not disclosed.\n\ndiagnose: true is for when a read has CONFUSED you \u2014 not for the working loop. It adds `diagnosis`, which asks every reader that already answers a question about your work and NAMES the reader behind every value, so you never guess which of two places to look: what state your work is really in (the stored `goals.state` beside the derived `goal_execution_state`, which can differ); whether anything is armed to ring and when (`ladder_candidates`, with the ladder's own last decision); whether a wake fired for you and what it did (durable `wake.*` events, beside when your process was last heard from); and what has reached you (`list_waiting` \u2014 review flags, unstarted work, open questions, the person's newest words). Read `diagnosis.disagreements` FIRST: each one is two readers giving different values for the same fact, with both values and both sources, and it never chooses between them \u2014 that is yours to do, from the Goal's own history. `diagnosis.looked` names every reader asked, including any that could not answer, so an empty answer is never confused with a broken one.";
-    UPDATE_GOAL_DESCRIPTION = `Update a Goal you are on at an exact revision. You are on a Goal you own, or one you have written on (an update with progress, or a contact on it); any of your person's agents may write on any of their Goals, and one that never touched a Goal is refused (409 goal_not_joined). State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. A CONTACT ON THIS GOAL MOVES ITS REVISION: a question filed on a Goal is a change to it, so an update prepared before a contact and sent after it is refused as stale (409 goal_revision_conflict) \u2014 re-read the Goal, then write. title is the work's name in one to five words, as a person would refer to it out loud (it is spoken on a call and heads every list); null clears it. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision. dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. state: done means the work was accomplished, and it can be reopened: when the person says it is not done ("it's not working"), set state: active on that same Goal instead of starting a new one; its parent reopens with it. state: done while children are still open records your part as done: the Goal waits and closes by itself when its last open child closes. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
-    CLAIM_GOAL_DESCRIPTION = "Claim a pending answer to your question or the oldest runnable or review-pending Goal you own. Pass goalId to join any Goal of your person; its assignment stays unchanged. Read others before overlapping another agent\u2019s work. Joining lets you contribute and change its state; use update_goal with ownerParticipant when the assignment itself should change. Returns the Goal as get_goal reads it, and marks you as on it, which never shuts another agent out: other agents of your person may write on it and change it too, and two changes at once are told apart by revision (409 goal_revision_conflict).";
-    CHECK_REPLIES_DESCRIPTION = "What is waiting for you: your open Deliveries (a request the user started toward you, a handoff), one row each with its Goals, how many decisions are still open, and the newest words in brief; `assigned`, your Goals nobody has started yet, however they became yours (claim_goal({goalId}) starts one); and `review`, your Goals with something new on them \u2014 the user's answers and notes are Entries on the Goal, not Deliveries. A pure read with no arguments: nothing is consumed, acknowledged or claimed by reading it, so call it on startup, after a long wait, or whenever you want to know what is outstanding. To act on one, claim its Goal (claim_goal) or reread a Delivery in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true clears the Goal from `review` and closes the Deliveries addressed to you on it.";
-    CheckRepliesSchema = external_exports.object({}).strict();
+    UPDATE_GOAL_DESCRIPTION = "Report work on a Goal you are on, at an exact revision: progress, review acknowledgement, when to wake for it, and withdrawing a question of yours. What the Goal is (its title, outcome, state, owner, parent, dependencies) changes with manage_goals. You are on a Goal you own, or one you have written on (an update with progress, or a contact on it); any of your person's agents may write on any of their Goals, and one that never touched a Goal is refused (409 goal_not_joined). Stale revisions are rejected. A CONTACT ON THIS GOAL MOVES ITS REVISION: a question filed on a Goal is a change to it, so an update prepared before a contact and sent after it is refused as stale (409 goal_revision_conflict) \u2014 re-read the Goal, then write. progress says where the work stands. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision (contact({ackEventIds}) does the same for an `update` event). dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. Returns the Goal as get_goal reads it, at its new revision.";
+    CLAIM_GOAL_DESCRIPTION = "Claim a pending answer to your question or the oldest runnable or review-pending Goal you own. Pass goalId to join any Goal of your person; its assignment stays unchanged. Read others before overlapping another agent\u2019s work. Joining lets you contribute and change it; use manage_goals (assign) when the assignment itself should change. Returns the Goal as get_goal reads it, and marks you as on it, which never shuts another agent out: other agents of your person may write on it and change it too, and two changes at once are told apart by revision (409 goal_revision_conflict).";
+    SearchToolSchema = external_exports.object({
+      query: external_exports.string().trim().min(1).max(500),
+      types: external_exports.array(external_exports.enum(["entry", "goal", "answer"])).min(1).optional(),
+      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.";
+    WhoIsWorkingSchema = external_exports.object({}).strict();
     AGENT_TOOLS = [
-      { name: "who_is_working", description: "Read your person's agents that contributed in the last 24 hours, newest first: at most 30 agents and their five most recently touched Goals, with their latest entry headline and time. Use get_goal to read a Goal and its other contributors before starting overlapping work. Read-only; no arguments.", inputSchema: mcpInputSchema(CheckRepliesSchema) },
+      { name: "who_is_working", description: "Read your person's agents that contributed in the last 24 hours, newest first: at most 30 agents and their five most recently touched Goals, with their latest entry headline and time. Use get_goal to read a Goal and its other contributors before starting overlapping work. Read-only; no arguments.", inputSchema: mcpInputSchema(WhoIsWorkingSchema) },
       { name: "contact", description: CONTACT_DESCRIPTION, inputSchema: CONTACT_SCHEMA },
-      { name: "check_replies", description: CHECK_REPLIES_DESCRIPTION, inputSchema: mcpInputSchema(CheckRepliesSchema) },
-      { name: "create_goal", description: CREATE_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(CreateGoalToolSchema) },
+      { name: "manage_goals", description: MANAGE_GOALS_DESCRIPTION, inputSchema: mcpInputSchema(ManageGoalsToolSchema) },
       { name: "claim_goal", description: CLAIM_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(ClaimGoalSchema) },
       { name: "get_goal", description: GET_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(GetGoalSchema) },
-      { name: "update_goal", description: UPDATE_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(UpdateGoalToolSchema) }
+      { name: "update_goal", description: UPDATE_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(UpdateGoalToolSchema) },
+      { name: "search", description: SEARCH_DESCRIPTION, inputSchema: mcpInputSchema(SearchToolSchema) }
     ];
     AGENT_TOOL_NAMES = AGENT_TOOLS.map((t) => t.name);
     id = external_exports.string().uuid();
     key = external_exports.string().min(1).max(40);
     participant = external_exports.string().regex(/^(human|agent):.+$/, "a participant ID such as agent:<uuid>");
-    SourceSchema = external_exports.object({
-      entryId: id,
-      span: external_exports.object({ start: external_exports.number().int().min(0), end: external_exports.number().int().min(1) }).strict().refine((s) => s.end > s.start, "a span ends after it starts").optional()
-    }).strict();
+    SourceSchema = external_exports.object({ entryId: id }).strict();
     ResultRefSchema = external_exports.union([external_exports.object({ id }).strict(), external_exports.object({ local: key }).strict()]);
     NodeRefSchema = external_exports.object({ type: external_exports.enum(["goal", "question"]), id }).strict();
     DependencySchema = external_exports.object({
@@ -24784,17 +24850,6 @@ var init_dist = __esm({
         reason: external_exports.string().max(500).optional()
       }).strict()
     ];
-    GoalChangeSchema = external_exports.union([
-      external_exports.object({
-        kind: external_exports.literal("create"),
-        title: external_exports.string().min(1).max(120),
-        outcome: external_exports.string().min(1),
-        ownerId: participant,
-        parentGoalId: id.optional(),
-        sourceEntryIds: external_exports.array(id)
-      }).strict(),
-      ...existingGoalChanges
-    ]);
     BrainGoalChangeSchema = external_exports.union([
       // newSession: Paigy starts a session to own it (owner, 2026-10-06); until it has, the person owns it.
       external_exports.object({
@@ -24851,7 +24906,7 @@ var init_dist = __esm({
       external_exports.object({ ...messageBase, to: external_exports.object({ kind: external_exports.literal("user") }).strict() }).strict(),
       external_exports.object({
         ...messageBase,
-        to: external_exports.object({ kind: external_exports.literal("session"), sessionId: id }).strict(),
+        to: external_exports.object({ kind: external_exports.literal("agent"), agentId: external_exports.string().regex(/^agent:(?!paigy$)\S+$/) }).strict(),
         call: external_exports.object({ callId: id, listen: external_exports.literal(true) }).strict().optional()
       }).strict()
     ]);
@@ -24881,7 +24936,7 @@ var init_dist = __esm({
     CompactResultSchema = external_exports.object({
       next: external_exports.object({ say: strs, then: external_exports.enum(["listen", "hold", "end", "none"]), waitFor: strs, reason: str, instructions: strs }).strict(),
       messages: external_exports.array(external_exports.object({ key: str, to: str, text: str, about: strs, entries: strs, owed: strs, inviteToCall: external_exports.boolean() }).strict()),
-      entries: external_exports.array(external_exports.object({ key: str, from: str, start: external_exports.number().int(), end: external_exports.number().int(), on: strs }).strict()),
+      entries: external_exports.array(external_exports.object({ key: str, from: str, on: strs }).strict()),
       answers: external_exports.array(external_exports.object({ question: str, entries: strs, summary: str, picked: strs }).strict()),
       changes: external_exports.array(external_exports.object({
         key: str,
@@ -25178,7 +25233,7 @@ var init_dist = __esm({
       /** The awaited ask was REPLACED by a newer notification on its thread (e.g. a
        *  post-feedback revision, #633) — the user will never answer this id. Stop
        *  awaiting it; the live ask is the thread's newest turn (await that one, or
-       *  re-orient via check_replies). */
+       *  re-orient via contact({})). */
       external_exports.object({
         type: external_exports.literal("superseded"),
         parentId: external_exports.string(),
@@ -25629,39 +25684,22 @@ var init_dist = __esm({
       moved: external_exports.object({ asks: external_exports.number(), answered: external_exports.number(), requests: external_exports.number(), goals: external_exports.number(), callbacks: external_exports.number() }),
       parentId: external_exports.string().nullable()
     });
-    MoveRingSchema = external_exports.enum(["home", "travels", "retired", "quarantined"]);
-    MoveSchema = external_exports.object({
+    LessonStateSchema = external_exports.enum(["active", "proposed", "retired"]);
+    LessonViewSchema = external_exports.object({
       id: external_exports.string(),
-      /** The reusable question, as distill normalized it. */
-      question: external_exports.string(),
-      /** The operative ruling. Editable by the user (PATCH) — which resets the ledger. */
-      answer: external_exports.string(),
-      /** The user's stated reason, when they gave one. Null = inherently narrow: the judge is
-       *  told so, and the ruling only derives essentially the same question in the same scope. */
-      rationale: external_exports.string().nullable(),
-      /** Where the ruling lives: a repo/workspace, or 'global'. */
-      scope: external_exports.string(),
-      ring: MoveRingSchema,
-      /** True = the user pinned it with `always` (travel granted by hand, not by evidence). */
+      text: external_exports.string(),
+      state: LessonStateSchema,
+      /** The Goal it is scoped to; null = the whole account. */
+      scopeGoalId: external_exports.string().nullable(),
+      goalTitle: external_exports.string().nullable(),
+      version: external_exports.number(),
       pinned: external_exports.boolean(),
-      /** True = a pin the user placed was BROKEN by later counter-evidence. Surfaced so the
-       *  break is visible instead of a pin silently disappearing. */
-      pinBroken: external_exports.boolean(),
-      /** When the ruling was distilled. */
-      learnedAt: external_exports.string(),
-      /** Last time it answered an ask. Null = never fired. */
-      lastUsedAt: external_exports.string().nullable(),
-      /** How many asks it has answered. Instrumentation — deliberately NOT an input to the
-       *  evidence curve: firing says the question keeps arising, not that the ruling is right. */
-      usedCount: external_exports.number(),
-      /** Ledger: outcomes that said it held up. Saturating — the tenth is worth almost nothing. */
-      confirms: external_exports.number(),
-      /** Ledger: contradictions, in signal units (a full override = 1, weaker signals less).
-       *  Linear and priced above the entire confirmation budget, so any full counter wins. */
-      counters: external_exports.number(),
-      /** The agent that asked the question this move came from, when known. Null for a move
-       *  distilled from a clarify ruling (those carry no agent) or one whose source rows are gone. */
-      learnedFrom: external_exports.object({ id: external_exports.string(), name: external_exports.string() }).nullable()
+      /** When the person last wrote its text themselves. */
+      editedAt: external_exports.string().nullable(),
+      createdAt: external_exports.string(),
+      updatedAt: external_exports.string(),
+      /** The Entries it came from, oldest first; `words` is null when an Entry has none to show (sealed). */
+      sources: external_exports.array(external_exports.object({ entryId: external_exports.string(), words: external_exports.string().nullable(), at: external_exports.string() }))
     });
     QueueQuestionSchema = external_exports.object({
       /** The decision need's id — what an answer is accepted against. */
@@ -25925,7 +25963,7 @@ var init_dist = __esm({
       goalId: external_exports.string().uuid().nullable().optional(),
       /** When the server last heard from the agent, as the host read it: the presence it stood back for. */
       seenAt: external_exports.string().datetime().nullable().optional(),
-      /** When that work last moved (`claimable.since` on `check_replies`), the fact the bound is judged on. */
+      /** When that work last moved (`claimable.since` on an agent's `contact({})` read), the fact the bound is judged on. */
       since: external_exports.string().datetime().nullable().optional(),
       /** What the host said, in its log's own words: why it stood back, or what the take-over did. */
       said: external_exports.string().max(300).optional()
@@ -26160,7 +26198,7 @@ var init_dist = __esm({
     tokenOverride = null;
     authToken = (explicit) => explicit ?? tokenOverride ?? readToken();
     AWAIT_WINDOW_MS = 45e3;
-    NOT_SENT = "Recorded as progress, not sent: nobody was notified. If the person should see it (a result, something to try or check, a finding), contact again and say so; report progress with update_goal.";
+    NOT_SENT = "Recorded as the Goal's progress, not sent: nobody was notified. The person is told only a question, an answer to one they asked you, and what you say once the Goal is done. To close the work, mark the Goal done first, then send the one message saying what is done and anything they need to do or check.";
     DEMOTED = "Delivered as a card, not a call: the person's settings do not allow a call right now (silent, quiet hours, or a mode). It has reached them; do not send it again, with or without a Goal.";
     HEARTBEAT_MS = 25e3;
     RETRY_MS = [1e3, 2e3, 5e3, 1e4, 3e4];
@@ -28093,27 +28131,27 @@ var require_chunkstream = __commonJS({
       this._buffers = null;
       this.emit("close");
     };
-    ChunkStream.prototype._processReadAllowingLess = function(read) {
+    ChunkStream.prototype._processReadAllowingLess = function(read3) {
       this._reads.shift();
       let smallerBuf = this._buffers[0];
-      if (smallerBuf.length > read.length) {
-        this._buffered -= read.length;
-        this._buffers[0] = smallerBuf.slice(read.length);
-        read.func.call(this, smallerBuf.slice(0, read.length));
+      if (smallerBuf.length > read3.length) {
+        this._buffered -= read3.length;
+        this._buffers[0] = smallerBuf.slice(read3.length);
+        read3.func.call(this, smallerBuf.slice(0, read3.length));
       } else {
         this._buffered -= smallerBuf.length;
         this._buffers.shift();
-        read.func.call(this, smallerBuf);
+        read3.func.call(this, smallerBuf);
       }
     };
-    ChunkStream.prototype._processRead = function(read) {
+    ChunkStream.prototype._processRead = function(read3) {
       this._reads.shift();
       let pos = 0;
       let count = 0;
-      let data = Buffer.alloc(read.length);
-      while (pos < read.length) {
+      let data = Buffer.alloc(read3.length);
+      while (pos < read3.length) {
         let buf = this._buffers[count++];
-        let len = Math.min(buf.length, read.length - pos);
+        let len = Math.min(buf.length, read3.length - pos);
         buf.copy(data, pos, 0, len);
         pos += len;
         if (len !== buf.length) {
@@ -28123,17 +28161,17 @@ var require_chunkstream = __commonJS({
       if (count > 0) {
         this._buffers.splice(0, count);
       }
-      this._buffered -= read.length;
-      read.func.call(this, data);
+      this._buffered -= read3.length;
+      read3.func.call(this, data);
     };
     ChunkStream.prototype._process = function() {
       try {
         while (this._buffered > 0 && this._reads && this._reads.length > 0) {
-          let read = this._reads[0];
-          if (read.allowLess) {
-            this._processReadAllowingLess(read);
-          } else if (this._buffered >= read.length) {
-            this._processRead(read);
+          let read3 = this._reads[0];
+          if (read3.allowLess) {
+            this._processReadAllowingLess(read3);
+          } else if (this._buffered >= read3.length) {
+            this._processRead(read3);
           } else {
             break;
           }
@@ -29758,12 +29796,12 @@ var require_sync_reader = __commonJS({
     };
     SyncReader.prototype.process = function() {
       while (this._reads.length > 0 && this._buffer.length) {
-        let read = this._reads[0];
-        if (this._buffer.length && (this._buffer.length >= read.length || read.allowLess)) {
+        let read3 = this._reads[0];
+        if (this._buffer.length && (this._buffer.length >= read3.length || read3.allowLess)) {
           this._reads.shift();
           let buf = this._buffer;
-          this._buffer = buf.slice(read.length);
-          read.func.call(this, buf.slice(0, read.length));
+          this._buffer = buf.slice(read3.length);
+          read3.func.call(this, buf.slice(0, read3.length));
         } else {
           break;
         }
@@ -31424,7 +31462,7 @@ function onEnter(input, onLine) {
 // src/cli.ts
 init_dist();
 var import_qrcode = __toESM(require_lib(), 1);
-import { randomUUID as randomUUID7 } from "crypto";
+import { randomUUID as randomUUID6 } from "crypto";
 import { hostname } from "os";
 import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
 import { execFile as execFile2, execSync } from "child_process";
@@ -31433,7 +31471,7 @@ import { join as join11 } from "path";
 
 // src/run.ts
 init_dist();
-import { randomUUID as randomUUID6 } from "crypto";
+import { randomUUID as randomUUID5 } from "crypto";
 
 // src/harness/session.ts
 init_dist();
@@ -33278,7 +33316,7 @@ var AskInputSchema2 = external_exports.object({
     'How the options are answered: "many" makes a checklist (they may want several, e.g. independent fixes), "one" (the default) a pick (choosing one rules out the others). Send "many" whenever more than one option could be wanted at once. The person can always answer in their own words as well. Ignored without options.'
   ),
   answers: external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/).optional().describe(
-    "Your reply answers a question the person asked you: the id the conversation shows for it (8 characters or whole). Their question closes with this reply as its answer, and any decision of yours it was holding back goes back to them. Needs parentId: the Goal the question is on. The reply is sent to them as it is; to also ask something new, send that as its own ask."
+    "Your reply answers a question the person asked you: the id the conversation shows for it (8 characters or whole). Their question closes with this reply as its answer, and any decision of yours it was holding back goes back to them. parentId is optional here: the question's own Goal is used. The reply is sent to them as it is; to also ask something new, send that as its own ask."
   )
 }).strict();
 var StartContactSchema2 = external_exports.object({
@@ -33286,9 +33324,17 @@ var StartContactSchema2 = external_exports.object({
   waiting: external_exports.enum(["none", "hard"]).default("none").describe("hard requests a call even when channel is notification; user permissions and ring cooldowns still apply."),
   channel: external_exports.enum(["notification", "call"]).default("notification")
 }).strict();
-var ContactSchema2 = external_exports.union([StartContactSchema2, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict()]);
+var ReceiveContactSchema2 = external_exports.object({
+  wait: external_exports.boolean().optional().describe(
+    "Only controls when this returns. true (the default when you send and acknowledge nothing): wait up to about 45 seconds for incoming communication addressed to you, and return as soon as some is available. false: return what is waiting now. It does not mean work is blocked, set urgency, or ask for a call. `waitOutcome` says which happened: `available`, `expired` (nothing arrived in the window; wait again without sending again), or `not_waited` (a hosted connection never holds a wait)."
+  ),
+  ackEventIds: external_exports.array(external_exports.string().uuid()).min(1).max(100).optional().describe(
+    "The exact eventIds of the events you have handled: an acknowledgment (ACK). Reading alone acknowledges nothing, so an event comes back until you acknowledge it; after that the next batch can come. Each recipient acknowledges separately, for itself only. A Question you owe is answered (an ask with `answers`), never acknowledged away: that id is refused until it is answered."
+  )
+}).strict();
+var ContactSchema2 = external_exports.union([StartContactSchema2, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict(), ReceiveContactSchema2]);
 var CONTACT_SCHEMA2 = { type: "object", ...mcpInputSchema2(ContactSchema2) };
-var CONTACT_DESCRIPTION2 = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'select', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none starts a new Goal of yours. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. Each ask is sent exactly as written, with no reading in between: a bundled ask arrives as one card, so separate questions are separate asks. An ask with no options that is not blocking is a report, and a report is an UPDATE, never a claim on them: it reaches them and is listed apart from what waits on them, so no answer is owed and none should be awaited. On a Goal whose report card is still open it is added to that card, with no new push; Where your work stands while under way is progress: report it with update_goal, not contact. Send options (or waiting:'hard') when you actually need an answer. Each option's label must stand on its own \u2014 the person may see only the labels \u2014 so never a label that points into your text ('All three', 'Option 2', '1 and 3 only'). select:'many' makes the card a checklist, for independent options they may want several of; select:'one' (the default) a pick, for alternatives. The person can always answer in their own words, so never add an 'Other' option. If the person is already on a call, your contact joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.";
+var CONTACT_DESCRIPTION2 = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'select', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none starts a new Goal of yours. Notification returns immediately; collect answers by receiving (below). On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. Each ask is sent exactly as written, with no reading in between: a bundled ask arrives as one card, so separate questions are separate asks. An ask with no options that is not blocking is a report, never a claim on them, so no answer is owed and none should be awaited. A report reaches the person only when it answers something they asked you, or once the Goal is done; any other report is recorded as the Goal's progress and nobody is notified. So when the work is finished, mark the Goal done first, then send one message saying what is done and anything they need to do or check. On a Goal whose report card is still open, a report that does reach them is added to that card, with no new push. Send options (or waiting:'hard') when you actually need an answer. Each option's label must stand on its own \u2014 the person may see only the labels \u2014 so never a label that points into your text ('All three', 'Option 2', '1 and 3 only'). select:'many' makes the card a checklist, for independent options they may want several of; select:'one' (the default) a pick, for alternatives. The person can always answer in their own words, so never add an 'Other' option. If the person is already on a call, a contact that reaches them joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.\n\nRECEIVING: contact with no asks sends nothing and returns `events`, a limited batch of what is addressed to you (not a history page): `question`, a Question you owe (answer it with an ask whose `answers` is its questionId); `update`, something new on one of your Goals (a reply, an answer: read it with get_goal); `instruction`, a request or note sent to you. `hasMore` says more are waiting. Reading acknowledges nothing: once you have handled events, confirm their eventIds with contact({ackEventIds}), and the next batch can come. contact({}) waits up to about 45 seconds for something to arrive; contact({wait:false}) returns at once. It also lists work given to you that nobody has started (`assigned`; claim_goal starts it) and your work gone quiet (`stalled`).";
 var CreateGoalSchema2 = external_exports.object({
   outcome: external_exports.string().trim().min(1).max(1e4),
   /** The work's NAME (#2115) — one to five words, how a person refers to it out loud ("the night
@@ -33308,10 +33354,6 @@ var CreateGoalSchema2 = external_exports.object({
    *  repo name. Delegated work inherits this from its parent Goal when omitted. */
   repo: external_exports.string().trim().min(1).max(200).optional()
 });
-var CreateGoalToolSchema2 = CreateGoalSchema2.extend({
-  idempotencyKey: CreateGoalSchema2.shape.idempotencyKey.optional().describe("Optional. One is minted per call; pass your own only so a retry lands on the same Goal.")
-}).strict();
-var CREATE_GOAL_DESCRIPTION2 = 'Create a durable Goal for an outcome. Without parentGoalId it is placed against your open Goals: if one already IS this work, that Goal comes back (existing: true) and nothing new is created \u2014 continue it; if the work belongs under one, it is created there (parentGoalId in the receipt); otherwise it is a root. Pass parentGoalId yourself to put it under a specific Goal. Pass repo to anchor the work to a specific repository ("owner/repo" or repo name); delegated children inherit it. Pass title to name it in one to five words, as a person would refer to it out loud ("the night rings") \u2014 it heads every list and is spoken on a call; without one the brain writes it. Admission only: claim it before doing work, then update it as it advances. Returns an admission receipt with goalId, current state, revision, ownerParticipant, and the next step; no Goal content or execution lease.';
 var UpdateGoalSchema2 = external_exports.object({
   revision: external_exports.number().int().positive(),
   changes: external_exports.object({
@@ -33335,7 +33377,65 @@ var UpdateGoalSchema2 = external_exports.object({
   reason: external_exports.string().trim().min(1).max(2e3),
   operationId: external_exports.string().uuid().optional()
 }).strict();
-var UpdateGoalToolSchema2 = UpdateGoalSchema2.omit({ operationId: true }).extend({ goalId: external_exports.string().uuid() }).strict();
+var UpdateGoalToolSchema2 = external_exports.object({
+  goalId: external_exports.string().uuid(),
+  revision: UpdateGoalSchema2.shape.revision,
+  changes: UpdateGoalSchema2.shape.changes.innerType().pick({ progress: true, reviewed: true, dueAt: true, withdraw: true }).strict().refine((v) => Object.keys(v).length > 0),
+  reason: UpdateGoalSchema2.shape.reason
+}).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 CreateChange2 = external_exports.object({
+  kind: external_exports.literal("create"),
+  title: goalTitle2,
+  outcome: goalOutcome2,
+  ownerId: external_exports.string().trim().min(1).optional().describe("Who owns the work: an agent's participant (as who_is_working shows it) or the person's. Omitted: you."),
+  parentGoalId: external_exports.string().uuid().optional().describe("The Goal it belongs under. Omitted: a root."),
+  sourceEntryIds: external_exports.array(external_exports.string().uuid()).max(20).optional().describe("The whole Entries the work came from, ones you can read.")
+}).strict();
+var EditChange2 = external_exports.object({ kind: external_exports.literal("edit"), goalId: changedGoal2, title: goalTitle2.optional(), outcome: goalOutcome2.optional() }).strict();
+var StateChange2 = external_exports.object({ kind: external_exports.literal("state"), goalId: changedGoal2, state: external_exports.enum(["open", "completed", "canceled"]).describe(
+  "completed: the Goal's own work is done now (refused while required children are open); open: reopen it; canceled: it will not be done."
+) }).strict();
+var AssignChange2 = external_exports.object({ kind: external_exports.literal("assign"), goalId: changedGoal2, ownerId: external_exports.string().trim().min(1).describe("The new owner's participant.") }).strict();
+var DeferChange2 = external_exports.object({ kind: external_exports.literal("defer"), goalId: changedGoal2, until: external_exports.string().datetime({ offset: true }).nullable().describe(
+  "Postpone it until this instant (its owner is woken then), or null to take the postponement back."
+) }).strict();
+var MoveChange2 = external_exports.object({ kind: external_exports.literal("move"), goalId: changedGoal2, parentGoalId: external_exports.string().uuid().nullable().describe(
+  "Its new parent, or null for a root. Only this Goal moves; its new parent's other children stay."
+) }).strict();
+var DependencyChange2 = external_exports.object({
+  kind: external_exports.literal("dependency"),
+  change: external_exports.enum(["add", "remove"]),
+  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.")
+}).strict();
+var read2 = { revision: external_exports.number().int().positive().optional() };
+var GoalChangeSchema2 = external_exports.discriminatedUnion("kind", [
+  CreateChange2,
+  EditChange2.extend(read2),
+  StateChange2.extend(read2),
+  AssignChange2.extend(read2),
+  DeferChange2.extend(read2),
+  MoveChange2.extend(read2),
+  DependencyChange2
+]);
+var editNames2 = (changes, ctx) => changes.forEach((c, i) => {
+  if (c.kind === "edit" && c.title === void 0 && c.outcome === void 0) {
+    ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["changes", i], message: "an edit supplies title, outcome, or both" });
+  }
+});
+var ManageGoalsSchema2 = external_exports.object({
+  requestId: external_exports.string().uuid().optional(),
+  changes: external_exports.array(GoalChangeSchema2).min(1).max(50)
+}).strict().superRefine((v, ctx) => editNames2(v.changes, ctx));
+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_joined, 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, or null); 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 a Goal you own or have written on. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
 var ClaimGoalSchema2 = external_exports.object({ goalId: external_exports.string().uuid().optional() }).strict();
 var GetGoalSchema2 = external_exports.object({
   goalId: external_exports.string().uuid(),
@@ -33348,27 +33448,30 @@ var GetGoalSchema2 = external_exports.object({
   diagnose: external_exports.boolean().optional()
 }).strict();
 var GET_GOAL_DESCRIPTION2 = "Read one Goal without claiming it, including others (the ten most recent other contributors, with names, latest entry headlines and times): its outcome, state, revision, progress, blockers, the conversation on it (each question with its options and what was decided), `next`, the one step to take, and `more`, where to read further. A question in that conversation reads `open` (nothing yet), `answered` (a choice was made, and `answer` carries it), `replied` (they said something and the read settled the question on their words \u2014 NO option of yours was chosen, and the words are the reply line beside it, so read that before you act), or `closed`. The conversation carries everything the person said, every open question and your newest entry; your older entries are left out and counted \u2014 history: true reads every entry in full. Every Goal of your person is readable, whichever of their agents owns it; another account's Goals are not disclosed.\n\ndiagnose: true is for when a read has CONFUSED you \u2014 not for the working loop. It adds `diagnosis`, which asks every reader that already answers a question about your work and NAMES the reader behind every value, so you never guess which of two places to look: what state your work is really in (the stored `goals.state` beside the derived `goal_execution_state`, which can differ); whether anything is armed to ring and when (`ladder_candidates`, with the ladder's own last decision); whether a wake fired for you and what it did (durable `wake.*` events, beside when your process was last heard from); and what has reached you (`list_waiting` \u2014 review flags, unstarted work, open questions, the person's newest words). Read `diagnosis.disagreements` FIRST: each one is two readers giving different values for the same fact, with both values and both sources, and it never chooses between them \u2014 that is yours to do, from the Goal's own history. `diagnosis.looked` names every reader asked, including any that could not answer, so an empty answer is never confused with a broken one.";
-var UPDATE_GOAL_DESCRIPTION2 = `Update a Goal you are on at an exact revision. You are on a Goal you own, or one you have written on (an update with progress, or a contact on it); any of your person's agents may write on any of their Goals, and one that never touched a Goal is refused (409 goal_not_joined). State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. A CONTACT ON THIS GOAL MOVES ITS REVISION: a question filed on a Goal is a change to it, so an update prepared before a contact and sent after it is refused as stale (409 goal_revision_conflict) \u2014 re-read the Goal, then write. title is the work's name in one to five words, as a person would refer to it out loud (it is spoken on a call and heads every list); null clears it. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision. dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. state: done means the work was accomplished, and it can be reopened: when the person says it is not done ("it's not working"), set state: active on that same Goal instead of starting a new one; its parent reopens with it. state: done while children are still open records your part as done: the Goal waits and closes by itself when its last open child closes. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
-var CLAIM_GOAL_DESCRIPTION2 = "Claim a pending answer to your question or the oldest runnable or review-pending Goal you own. Pass goalId to join any Goal of your person; its assignment stays unchanged. Read others before overlapping another agent\u2019s work. Joining lets you contribute and change its state; use update_goal with ownerParticipant when the assignment itself should change. Returns the Goal as get_goal reads it, and marks you as on it, which never shuts another agent out: other agents of your person may write on it and change it too, and two changes at once are told apart by revision (409 goal_revision_conflict).";
-var CHECK_REPLIES_DESCRIPTION2 = "What is waiting for you: your open Deliveries (a request the user started toward you, a handoff), one row each with its Goals, how many decisions are still open, and the newest words in brief; `assigned`, your Goals nobody has started yet, however they became yours (claim_goal({goalId}) starts one); and `review`, your Goals with something new on them \u2014 the user's answers and notes are Entries on the Goal, not Deliveries. A pure read with no arguments: nothing is consumed, acknowledged or claimed by reading it, so call it on startup, after a long wait, or whenever you want to know what is outstanding. To act on one, claim its Goal (claim_goal) or reread a Delivery in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true clears the Goal from `review` and closes the Deliveries addressed to you on it.";
-var CheckRepliesSchema2 = external_exports.object({}).strict();
+var UPDATE_GOAL_DESCRIPTION2 = "Report work on a Goal you are on, at an exact revision: progress, review acknowledgement, when to wake for it, and withdrawing a question of yours. What the Goal is (its title, outcome, state, owner, parent, dependencies) changes with manage_goals. You are on a Goal you own, or one you have written on (an update with progress, or a contact on it); any of your person's agents may write on any of their Goals, and one that never touched a Goal is refused (409 goal_not_joined). Stale revisions are rejected. A CONTACT ON THIS GOAL MOVES ITS REVISION: a question filed on a Goal is a change to it, so an update prepared before a contact and sent after it is refused as stale (409 goal_revision_conflict) \u2014 re-read the Goal, then write. progress says where the work stands. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision (contact({ackEventIds}) does the same for an `update` event). dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. Returns the Goal as get_goal reads it, at its new revision.";
+var CLAIM_GOAL_DESCRIPTION2 = "Claim a pending answer to your question or the oldest runnable or review-pending Goal you own. Pass goalId to join any Goal of your person; its assignment stays unchanged. Read others before overlapping another agent\u2019s work. Joining lets you contribute and change it; use manage_goals (assign) when the assignment itself should change. Returns the Goal as get_goal reads it, and marks you as on it, which never shuts another agent out: other agents of your person may write on it and change it too, and two changes at once are told apart by revision (409 goal_revision_conflict).";
+var SearchToolSchema2 = external_exports.object({
+  query: external_exports.string().trim().min(1).max(500),
+  types: external_exports.array(external_exports.enum(["entry", "goal", "answer"])).min(1).optional(),
+  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 WhoIsWorkingSchema2 = external_exports.object({}).strict();
 var AGENT_TOOLS2 = [
-  { name: "who_is_working", description: "Read your person's agents that contributed in the last 24 hours, newest first: at most 30 agents and their five most recently touched Goals, with their latest entry headline and time. Use get_goal to read a Goal and its other contributors before starting overlapping work. Read-only; no arguments.", inputSchema: mcpInputSchema2(CheckRepliesSchema2) },
+  { name: "who_is_working", description: "Read your person's agents that contributed in the last 24 hours, newest first: at most 30 agents and their five most recently touched Goals, with their latest entry headline and time. Use get_goal to read a Goal and its other contributors before starting overlapping work. Read-only; no arguments.", inputSchema: mcpInputSchema2(WhoIsWorkingSchema2) },
   { name: "contact", description: CONTACT_DESCRIPTION2, inputSchema: CONTACT_SCHEMA2 },
-  { name: "check_replies", description: CHECK_REPLIES_DESCRIPTION2, inputSchema: mcpInputSchema2(CheckRepliesSchema2) },
-  { name: "create_goal", description: CREATE_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(CreateGoalToolSchema2) },
+  { name: "manage_goals", description: MANAGE_GOALS_DESCRIPTION2, inputSchema: mcpInputSchema2(ManageGoalsToolSchema2) },
   { name: "claim_goal", description: CLAIM_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(ClaimGoalSchema2) },
   { name: "get_goal", description: GET_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(GetGoalSchema2) },
-  { name: "update_goal", description: UPDATE_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(UpdateGoalToolSchema2) }
+  { name: "update_goal", description: UPDATE_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(UpdateGoalToolSchema2) },
+  { name: "search", description: SEARCH_DESCRIPTION2, inputSchema: mcpInputSchema2(SearchToolSchema2) }
 ];
 var AGENT_TOOL_NAMES2 = AGENT_TOOLS2.map((t) => t.name);
 var id2 = external_exports.string().uuid();
 var key2 = external_exports.string().min(1).max(40);
 var participant2 = external_exports.string().regex(/^(human|agent):.+$/, "a participant ID such as agent:<uuid>");
-var SourceSchema2 = external_exports.object({
-  entryId: id2,
-  span: external_exports.object({ start: external_exports.number().int().min(0), end: external_exports.number().int().min(1) }).strict().refine((s) => s.end > s.start, "a span ends after it starts").optional()
-}).strict();
+var SourceSchema2 = external_exports.object({ entryId: id2 }).strict();
 var ResultRefSchema2 = external_exports.union([external_exports.object({ id: id2 }).strict(), external_exports.object({ local: key2 }).strict()]);
 var NodeRefSchema2 = external_exports.object({ type: external_exports.enum(["goal", "question"]), id: id2 }).strict();
 var DependencySchema2 = external_exports.object({
@@ -33393,17 +33496,6 @@ var existingGoalChanges2 = [
     reason: external_exports.string().max(500).optional()
   }).strict()
 ];
-var GoalChangeSchema2 = external_exports.union([
-  external_exports.object({
-    kind: external_exports.literal("create"),
-    title: external_exports.string().min(1).max(120),
-    outcome: external_exports.string().min(1),
-    ownerId: participant2,
-    parentGoalId: id2.optional(),
-    sourceEntryIds: external_exports.array(id2)
-  }).strict(),
-  ...existingGoalChanges2
-]);
 var BrainGoalChangeSchema2 = external_exports.union([
   // newSession: Paigy starts a session to own it (owner, 2026-10-06); until it has, the person owns it.
   external_exports.object({
@@ -33460,7 +33552,7 @@ var BrainMessageSchema2 = external_exports.union([
   external_exports.object({ ...messageBase2, to: external_exports.object({ kind: external_exports.literal("user") }).strict() }).strict(),
   external_exports.object({
     ...messageBase2,
-    to: external_exports.object({ kind: external_exports.literal("session"), sessionId: id2 }).strict(),
+    to: external_exports.object({ kind: external_exports.literal("agent"), agentId: external_exports.string().regex(/^agent:(?!paigy$)\S+$/) }).strict(),
     call: external_exports.object({ callId: id2, listen: external_exports.literal(true) }).strict().optional()
   }).strict()
 ]);
@@ -33490,7 +33582,7 @@ var strs2 = external_exports.array(external_exports.string());
 var CompactResultSchema2 = external_exports.object({
   next: external_exports.object({ say: strs2, then: external_exports.enum(["listen", "hold", "end", "none"]), waitFor: strs2, reason: str2, instructions: strs2 }).strict(),
   messages: external_exports.array(external_exports.object({ key: str2, to: str2, text: str2, about: strs2, entries: strs2, owed: strs2, inviteToCall: external_exports.boolean() }).strict()),
-  entries: external_exports.array(external_exports.object({ key: str2, from: str2, start: external_exports.number().int(), end: external_exports.number().int(), on: strs2 }).strict()),
+  entries: external_exports.array(external_exports.object({ key: str2, from: str2, on: strs2 }).strict()),
   answers: external_exports.array(external_exports.object({ question: str2, entries: strs2, summary: str2, picked: strs2 }).strict()),
   changes: external_exports.array(external_exports.object({
     key: str2,
@@ -33804,7 +33896,7 @@ var AwaitItemSchema2 = external_exports.discriminatedUnion("type", [
   /** The awaited ask was REPLACED by a newer notification on its thread (e.g. a
    *  post-feedback revision, #633) — the user will never answer this id. Stop
    *  awaiting it; the live ask is the thread's newest turn (await that one, or
-   *  re-orient via check_replies). */
+   *  re-orient via contact({})). */
   external_exports.object({
     type: external_exports.literal("superseded"),
     parentId: external_exports.string(),
@@ -34255,39 +34347,22 @@ var ReassignResultSchema2 = external_exports.object({
   moved: external_exports.object({ asks: external_exports.number(), answered: external_exports.number(), requests: external_exports.number(), goals: external_exports.number(), callbacks: external_exports.number() }),
   parentId: external_exports.string().nullable()
 });
-var MoveRingSchema2 = external_exports.enum(["home", "travels", "retired", "quarantined"]);
-var MoveSchema2 = external_exports.object({
+var LessonStateSchema2 = external_exports.enum(["active", "proposed", "retired"]);
+var LessonViewSchema2 = external_exports.object({
   id: external_exports.string(),
-  /** The reusable question, as distill normalized it. */
-  question: external_exports.string(),
-  /** The operative ruling. Editable by the user (PATCH) — which resets the ledger. */
-  answer: external_exports.string(),
-  /** The user's stated reason, when they gave one. Null = inherently narrow: the judge is
-   *  told so, and the ruling only derives essentially the same question in the same scope. */
-  rationale: external_exports.string().nullable(),
-  /** Where the ruling lives: a repo/workspace, or 'global'. */
-  scope: external_exports.string(),
-  ring: MoveRingSchema2,
-  /** True = the user pinned it with `always` (travel granted by hand, not by evidence). */
+  text: external_exports.string(),
+  state: LessonStateSchema2,
+  /** The Goal it is scoped to; null = the whole account. */
+  scopeGoalId: external_exports.string().nullable(),
+  goalTitle: external_exports.string().nullable(),
+  version: external_exports.number(),
   pinned: external_exports.boolean(),
-  /** True = a pin the user placed was BROKEN by later counter-evidence. Surfaced so the
-   *  break is visible instead of a pin silently disappearing. */
-  pinBroken: external_exports.boolean(),
-  /** When the ruling was distilled. */
-  learnedAt: external_exports.string(),
-  /** Last time it answered an ask. Null = never fired. */
-  lastUsedAt: external_exports.string().nullable(),
-  /** How many asks it has answered. Instrumentation — deliberately NOT an input to the
-   *  evidence curve: firing says the question keeps arising, not that the ruling is right. */
-  usedCount: external_exports.number(),
-  /** Ledger: outcomes that said it held up. Saturating — the tenth is worth almost nothing. */
-  confirms: external_exports.number(),
-  /** Ledger: contradictions, in signal units (a full override = 1, weaker signals less).
-   *  Linear and priced above the entire confirmation budget, so any full counter wins. */
-  counters: external_exports.number(),
-  /** The agent that asked the question this move came from, when known. Null for a move
-   *  distilled from a clarify ruling (those carry no agent) or one whose source rows are gone. */
-  learnedFrom: external_exports.object({ id: external_exports.string(), name: external_exports.string() }).nullable()
+  /** When the person last wrote its text themselves. */
+  editedAt: external_exports.string().nullable(),
+  createdAt: external_exports.string(),
+  updatedAt: external_exports.string(),
+  /** The Entries it came from, oldest first; `words` is null when an Entry has none to show (sealed). */
+  sources: external_exports.array(external_exports.object({ entryId: external_exports.string(), words: external_exports.string().nullable(), at: external_exports.string() }))
 });
 var QueueQuestionSchema2 = external_exports.object({
   /** The decision need's id — what an answer is accepted against. */
@@ -34549,7 +34624,7 @@ var HostDecisionSchema2 = external_exports.object({
   goalId: external_exports.string().uuid().nullable().optional(),
   /** When the server last heard from the agent, as the host read it: the presence it stood back for. */
   seenAt: external_exports.string().datetime().nullable().optional(),
-  /** When that work last moved (`claimable.since` on `check_replies`), the fact the bound is judged on. */
+  /** When that work last moved (`claimable.since` on an agent's `contact({})` read), the fact the bound is judged on. */
   since: external_exports.string().datetime().nullable().optional(),
   /** What the host said, in its log's own words: why it stood back, or what the take-over did. */
   said: external_exports.string().max(300).optional()
@@ -34907,8 +34982,13 @@ function railFor(opts) {
     update: (goalId, input) => updateGoal(goalId, input, opts),
     // One read and back: the pump owns the waiting, so a Call must not hold a window here.
     contact: (input) => contact(input, { ...opts, waits: false }),
-    create: (input) => createGoal(input, opts),
-    waiting: () => checkReplies(opts)
+    create: async (input) => {
+      const made = await manageGoals({ changes: [{ kind: "create", ...input }] }, opts);
+      const goal = made.goals.find((g) => g.goalId === made.results[0]?.goalId);
+      if (!goal) throw new Error(`manage_goals create failed: ${made.results[0]?.error ?? "no goal"}`);
+      return { goalId: goal.goalId, revision: goal.revision };
+    },
+    waiting: () => receive(opts)
   };
 }
 function cancelAsks(state) {
@@ -35037,7 +35117,6 @@ ${event.result?.trim() || "No result reported."}`, state, rail, opts);
 }
 
 // src/paigy/conversation.ts
-import { randomUUID as randomUUID5 } from "crypto";
 var HARNESS_INSTRUCTION = "You are running as an unattended background harness agent; your user reaches you through Paigy and is not at this terminal. Nothing wakes you after your turn ends but the person, so wait on CI or a deploy inside the turn. The person never sees your turn's final message: it is kept as progress on this Goal. Anything the person needs \u2014 a question, a result, a blocker \u2014 you send through Paigy's contact tool, once; the harness sends nothing on your behalf. What the person says later arrives with the Goal it was said on named in front of it; answer them on that Goal (its id as the contact's parentId).";
 var SAFETY_MS = 6e4;
 var ASK_BEAT_MS = 5e3;
@@ -35155,23 +35234,23 @@ async function gather(state, rail, held) {
   const moved = movedBelow(held, state);
   for (const { goal, since } of moved) look2(goal.goalId, "subtree", goal.title, since);
   const heard = [];
-  const read = /* @__PURE__ */ new Set();
+  const read3 = /* @__PURE__ */ new Set();
   for (const [goalId, { since, ...found }] of looks) {
     let brief = found.brief;
     if (!brief) {
       try {
         brief = await rail.read(goalId);
       } catch (error) {
-        if (error.status === 404) read.add(goalId);
+        if (error.status === 404) read3.add(goalId);
         continue;
       }
     }
-    read.add(goalId);
+    read3.add(goalId);
     const fresh = !brief.reviewSince && (found.via === "waiting work" || found.via === "assigned") ? sinceTheWork(brief) : { after: -1 };
     if (found.via === "assigned") announced.add(goalId);
     heard.push({ goalId, ...found, brief, words: unheard(brief, state, brief.reviewSince ? null : since ?? null, fresh.after, brief.reviewSince), ...fresh.note ? { note: fresh.note } : {} });
   }
-  for (const { goal, since } of moved) if (read.has(goal.goalId)) state.below.goals.set(goal.goalId, { since, at: goal.updatedAt ?? null });
+  for (const { goal, since } of moved) if (read3.has(goal.goalId)) state.below.goals.set(goal.goalId, { since, at: goal.updatedAt ?? null });
   return { heard, listed };
 }
 var GIVEN = "This Goal was given to you, and nobody has started it. Carry on with what you're doing unless it changes that; claim_goal with its id when you take it up.";
@@ -35289,7 +35368,7 @@ async function look(session, state, rail, opts) {
       if (opts?.initialPrompt?.trim()) {
         const prompt = opts.initialPrompt.trim();
         opts.initialPrompt = void 0;
-        const admitted = await rail.create({ outcome: prompt, idempotencyKey: randomUUID5() });
+        const admitted = await rail.create({ title: prompt.split(/\s+/).slice(0, 5).join(" ").slice(0, 80), outcome: prompt });
         brief2 = await rail.claim();
         if (!brief2.goalId || brief2.revision === void 0) {
           state.goal = { id: admitted.goalId, revision: admitted.revision };
@@ -35380,9 +35459,9 @@ async function pump(session, state, rail, opts) {
     }
     if (!await opts.onIdle()) return;
     if (now() - since >= BEAT_REPORT_MS) {
-      const read = counts.wake + counts.rest + counts.safety;
-      if (read || counts.skipped || tally.noted || tally.seen || tally.announced) {
-        opts.log?.(`\u25B9 beats: ${read} read (${counts.wake} wake, ${counts.rest} rest, ${counts.safety} safety), ${counts.skipped} wake mid-turn skipped, ${tally.noted} noted mid-turn, ${tally.seen} seen by the hook, ${tally.announced} assigned announced${tally.paused ? `, ${tally.paused} held by the usage limit` : ""}`);
+      const read3 = counts.wake + counts.rest + counts.safety;
+      if (read3 || counts.skipped || tally.noted || tally.seen || tally.announced) {
+        opts.log?.(`\u25B9 beats: ${read3} read (${counts.wake} wake, ${counts.rest} rest, ${counts.safety} safety), ${counts.skipped} wake mid-turn skipped, ${tally.noted} noted mid-turn, ${tally.seen} seen by the hook, ${tally.announced} assigned announced${tally.paused ? `, ${tally.paused} held by the usage limit` : ""}`);
       }
       counts.wake = counts.rest = counts.safety = counts.skipped = tally.noted = tally.seen = tally.announced = tally.paused = 0;
       since = now();
@@ -35400,7 +35479,7 @@ function runHarness(opts) {
   const clock4 = beat();
   let session = null;
   const speaksAs = opts.session ?? opts.resume ?? sessionId();
-  const instance = randomUUID6();
+  const instance = randomUUID5();
   const rail = railFor({ token: opts.token, reach: reachAs(speaksAs, instance) });
   let inbox;
   if (opts.harness === "claude") {
@@ -35639,7 +35718,7 @@ function proven(pid, procStart, deps) {
 function localHolderPids(deps = {}) {
   const dir = deps.dir ?? join7(process.env.CLAUDE_CONFIG_DIR?.trim() || join7(homedir7(), ".claude"), "sessions");
   const list = deps.list ?? ((d) => readdirSync3(d));
-  const read = deps.read ?? ((f) => readFileSync5(f, "utf8"));
+  const read3 = deps.read ?? ((f) => readFileSync5(f, "utf8"));
   const check = { alive: deps.alive ?? isAlive, started: deps.started ?? psStart };
   const held = /* @__PURE__ */ new Map();
   let files;
@@ -35652,7 +35731,7 @@ function localHolderPids(deps = {}) {
     if (!/^\d+\.json$/.test(file)) continue;
     let row;
     try {
-      row = JSON.parse(read(join7(dir, file)));
+      row = JSON.parse(read3(join7(dir, file)));
     } catch {
       continue;
     }
@@ -35684,7 +35763,7 @@ function descendsFrom(pid, ancestor, parent = psParent) {
 function localHolders(deps = {}) {
   const dir = deps.dir ?? join7(process.env.CLAUDE_CONFIG_DIR?.trim() || join7(homedir7(), ".claude"), "sessions");
   const list = deps.list ?? ((d) => readdirSync3(d));
-  const read = deps.read ?? ((f) => readFileSync5(f, "utf8"));
+  const read3 = deps.read ?? ((f) => readFileSync5(f, "utf8"));
   const check = { alive: deps.alive ?? isAlive, started: deps.started ?? psStart };
   const held = /* @__PURE__ */ new Map();
   let files;
@@ -35697,7 +35776,7 @@ function localHolders(deps = {}) {
     if (!/^\d+\.json$/.test(file)) continue;
     let row;
     try {
-      row = JSON.parse(read(join7(dir, file)));
+      row = JSON.parse(read3(join7(dir, file)));
     } catch {
       continue;
     }
@@ -35931,7 +36010,7 @@ async function waitingWork(token, session) {
   if (quiet !== void 0 && Date.now() < quiet) return { skip: BOUND_SKIP };
   let found;
   try {
-    found = await checkReplies({ token, ...session ? { reach: reachAs(session) } : {} });
+    found = await receive({ token, ...session ? { reach: reachAs(session) } : {} });
   } catch (error) {
     if (error instanceof RevokedError) return { skip: "was revoked: its credential is gone for good", revoked: true };
     if (error instanceof ApiError && error.body?.error === "identity_session_mismatch") {
@@ -36170,7 +36249,7 @@ function startHost(opts) {
         skip(`has a full conversation (${resumes.slice(0, 8)}) \u2014 not resuming it; its Goals go to the dead-agent handoff`);
         return;
       }
-      const read = async () => {
+      const read3 = async () => {
         const got = await waitingWork(token, identity.sessionId ?? owner?.sessionId);
         if (!("skip" in got)) return got;
         if (got.revoked) {
@@ -36182,7 +36261,7 @@ function startHost(opts) {
         return null;
       };
       if (decided.why === "presence") {
-        found = await read() ?? void 0;
+        found = await read3() ?? void 0;
         if (!found) return;
         const since = found.since;
         decided = wakeAction(false, Date.now(), seenByServer, { ...here, ...since ? { movedAt: Date.parse(since) } : {} });
@@ -36208,7 +36287,7 @@ function startHost(opts) {
         skip("has no granted folder to wake in");
         return;
       }
-      found ??= await read() ?? void 0;
+      found ??= await read3() ?? void 0;
       if (!found) return;
       if (runs.has(key3)) {
         skip("was started by the wake that read it first");
@@ -36344,7 +36423,7 @@ function startHost(opts) {
         return {
           name,
           // The slot key rides along so the window's agent page can speak AS this agent —
-          // its pending reads (`checkReplies`, the same pure read the sweep does) need the
+          // its pending reads (`receive`, the same pure read the sweep does) need the
           // slot's own token, and the display name is not a key.
           slot,
           tokenId: id3.tokenId,
@@ -36750,7 +36829,7 @@ async function main() {
   let launched;
   if (parsed.launch) {
     overrideToken(readSlot("Desktop") || null);
-    const session = randomUUID7();
+    const session = randomUUID6();
     const minted = await hatch(parsed.launch, parsed.voice ?? null, {
       reach: reachAs(session),
       brief: parsed.prompt,