@sjawhar/pi-legion-envoy 1.49.0 → 1.49.1

package/dist/envoy.js

@@ -29649,6 +29649,7 @@ function date4(params) {
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 config(en_default());
 // ../contracts/src/dispatch-api.ts
+var ASK_TURNS = ["human", "agent"];
 var DELIVERY_CAPABILITIES = ["aside", "btw", "steer"];
 var DispatchEventSchema = object({
   issue_key: string2().nullable(),
@@ -29729,8 +29730,8 @@ var CommentEventPayloadSchema = object({
   ask_id: string2().nullish(),
   ask_question: string2().optional(),
   ask_state: _enum2(["open", "answered", "resolved"]).optional(),
-  ask_waiting_on: _enum2(["human", "agent"]).optional(),
-  turn: _enum2(["human", "agent"]).nullish(),
+  ask_waiting_on: _enum2(ASK_TURNS).optional(),
+  turn: _enum2(ASK_TURNS).nullish(),
   anchor: object({ block_id: string2().nullable().optional(), quote: string2().optional() }).nullish(),
   suggestion: object({ replace_with: string2().optional() }).nullish(),
   author: object({ kind: string2(), id: string2() }).optional(),
@@ -29853,16 +29854,14 @@ function documentOwnerValidation(requireArtifact, alwaysRequireArtifact = false)
     message: alwaysRequireArtifact ? "Exactly one of issue and project is required; artifact or ref must name the document." : "Exactly one of issue and project is required; with project, artifact names the document."
   };
 }
-var commentValidation = (() => {
-  const owner = documentOwnerValidation(true);
-  return {
-    check: (value) => {
-      const input = value;
-      return owner.check(value) && (input.turn === undefined || typeof input.reply_to_ask === "string");
-    },
-    message: `${owner.message} turn requires reply_to_ask.`
-  };
-})();
+var commentOwner = documentOwnerValidation(true);
+var commentValidation = {
+  check: (value) => {
+    const input = value;
+    return commentOwner.check(value) && (input.turn === undefined || typeof input.reply_to_ask === "string");
+  },
+  message: `${commentOwner.message} turn requires reply_to_ask.`
+};
 var ISSUE_COMPONENTS_MODES = ["inherit", "explicit", "none"];
 function componentsArgument(z) {
   return z.object({
@@ -29884,6 +29883,7 @@ var SPEC_SECTIONS = [
 ];
 var SPEC_WRITING_GUIDANCE = `When writing a spec, use these sections in order: ${SPEC_SECTIONS.join(", ")}. ` + "Write for a reader who has not seen the code: plain sentences, every identifier expanded on " + "first use, no coined shorthand; see skills/dispatch Writing for the human and Writing a spec.";
 var ASK_URGENCIES = ["low", "med", "high", "blocking"];
+var ASK_QUESTION_MAX = 800;
 var ISSUE_STATUSES = [
   "triage",
   "icebox",
@@ -29895,6 +29895,9 @@ var ISSUE_STATUSES = [
   "retro",
   "done"
 ];
+function isIssueStatus(value) {
+  return ISSUE_STATUSES.includes(value);
+}
 var DOC_EDIT_OPS = ["replace", "delete", "insert", "retype", "move"];
 var dispatchToolSpecs = [
   {
@@ -29937,13 +29940,13 @@ var dispatchToolSpecs = [
   },
   {
     name: "dispatch_ask",
-    description: "Open a durable, answerable decision on an issue or project document. Do not use it for a status update or discussion; " + "use dispatch_message instead. A to-do a human must complete is a question phrased as that to-do, with the options you want (for example Done / Can't). " + "Anchor a document question, thread reply_to/reply_to_ask, or cite a dispatch:// " + 'reference \u2014 it must be answerable from its own text and anchor alone, never "see above". A quote anchor is pinned to its block. Question is at most 800 ' + `characters and has at most 8 options. ${OWNER_REFERENCE}`,
+    description: "Open a durable, answerable decision on an issue or project document. Do not use it for a status update or discussion; " + "use dispatch_message instead. A to-do a human must complete is a question phrased as that to-do, with the options you want (for example Done / Can't). " + "Anchor a document question, thread reply_to/reply_to_ask, or cite a dispatch:// " + `reference \u2014 it must be answerable from its own text and anchor alone, never "see above". A quote anchor is pinned to its block. Question is at most ${ASK_QUESTION_MAX} ` + `characters and has at most 8 options. ${OWNER_REFERENCE}`,
     arguments: (z) => ({
       issue: z.string().describe(ISSUE_REFERENCE).optional(),
       project: z.string().describe("Project key owning the document.").optional(),
       artifact: z.string().describe("Project document artifact id, slug, or filename.").optional(),
       ref: z.string().describe("Optional dispatch:// reference (issue, document, message, or ask); appended to the question and rendered as a link.").optional(),
-      question: z.string({ max: 800 }).describe("Decision question, at most 800 characters."),
+      question: z.string({ max: ASK_QUESTION_MAX }).describe(`Decision question, at most ${ASK_QUESTION_MAX} characters.`),
       options: z.array(z.object({
         label: z.string().describe("Selectable option label."),
         description: z.string().describe("Optional option context.").optional()
@@ -29963,7 +29966,7 @@ var dispatchToolSpecs = [
     description: "Edit an open question in place. Use it to correct or refine the same decision; retract the " + "old ask and open a new one when the decision itself changes. Previous text remains in the " + "event log. Only the asking session can edit it; answered or resolved asks cannot be edited.",
     arguments: (z) => ({
       ask: z.string().describe("Ask id to edit."),
-      question: z.string({ max: 800 }).describe("Replacement decision question, at most 800 characters.").optional(),
+      question: z.string({ max: ASK_QUESTION_MAX }).describe(`Replacement decision question, at most ${ASK_QUESTION_MAX} characters.`).optional(),
       options: z.array(z.object({
         label: z.string().describe("Selectable option label."),
         description: z.string().describe("Optional option context.").optional()
@@ -31194,9 +31197,9 @@ function resolveOptions(options) {
 
 // ../envoy-client/src/ask-answer.ts
 var HEAD_LENGTH = 120;
-function textHead(text, limit = HEAD_LENGTH) {
+function textHead(text) {
   const flat = text.replace(/\s+/g, " ").trim();
-  return flat.length > limit ? `${flat.slice(0, limit)}\u2026` : flat;
+  return flat.length > HEAD_LENGTH ? `${flat.slice(0, HEAD_LENGTH)}\u2026` : flat;
 }
 function askAnswerText(answer) {
   if (answer === null || answer === undefined)
@@ -31210,6 +31213,29 @@ function askAnswerText(answer) {
   return `${selected} - ${text}`;
 }
 
+// ../envoy-client/src/dispatch-owner.ts
+function documentLabel(project, slug) {
+  return `${project}/${slug}`;
+}
+function issueTopic(key) {
+  return { label: key, topic: dispatchIssueSubject(key, ">") };
+}
+function documentTopicOf(project, slug) {
+  return {
+    label: documentLabel(project, slug),
+    topic: dispatchDocumentSubject(project, slug, ">")
+  };
+}
+function dispatchIssueRef(key) {
+  return `dispatch://${key}`;
+}
+function dispatchDocumentRef(owner, slug) {
+  return `dispatch://${owner}/artifact/${slug}`;
+}
+function dispatchChildRef(ownerRef, kind, id) {
+  return `${ownerRef}/${kind}/${id}`;
+}
+
 // ../envoy-client/src/delivery.ts
 var KNOWN_SOURCES = EnvelopeSchema.shape.source.enum;
 var FOREIGN_SESSION_ID = /\b01a0[0-9a-f]{4}-[0-9a-f]{4}-7[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12}\b/g;
@@ -31247,6 +31273,31 @@ var TolerantInboundEnvelopeSchema = object({
   source: InboundEnvelopeSchema.shape.source.optional().catch(undefined),
   sender: object(tolerantShape(InboundSenderSchema.shape)).optional().catch(undefined)
 }).passthrough();
+async function postDeliveryReply(config, sessionId, delivery, result) {
+  const response = await fetch(`${config.url}/api/v1/messages/${delivery.messageID}/reply`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${config.token}`, "Content-Type": "application/json" },
+    body: JSON.stringify({
+      actor: { kind: "session", id: sessionId },
+      attempt: delivery.attempt,
+      ...result
+    })
+  });
+  if (!response.ok) {
+    throw new Error(`Dispatch reply failed: ${response.status} ${await response.text()}`);
+  }
+}
+function expectsLaneReceipt(frame) {
+  return frame.reply !== undefined && frame.reply !== "" && frame.subject === frame.directSubject && frame.envelopeTopic !== undefined && frame.envelopeTopic !== frame.directSubject;
+}
+function rememberBounded(seen, key, limit) {
+  seen.add(key);
+  if (seen.size > limit) {
+    const oldest = seen.values().next();
+    if (!oldest.done)
+      seen.delete(oldest.value);
+  }
+}
 var DispatchDeliveryRequestSchema = object({
   attempt: number2().int().positive(),
   mode: _enum2(DELIVERY_CAPABILITIES)
@@ -31313,23 +31364,20 @@ function dispatchOwner(event, topic) {
     return `${document.project} / ${document.slug}`;
   return event.artifact_id ?? "unknown";
 }
-function dispatchCommentReplyWith(event, topic) {
-  if (event.type !== "comment.created")
-    return;
-  const comment = CommentEventPayloadSchema.safeParse(event.payload);
-  if (!comment.success || comment.data.id === undefined)
+function dispatchCommentReplyWith(event, topic, comment) {
+  if (comment === undefined || comment.id === undefined)
     return;
-  const reply = comment.data.ask_id;
+  const reply = comment.ask_id;
   const thread = reply === undefined || reply === null || reply === "" ? "reply_to" : "reply_to_ask";
-  const threadID = thread === "reply_to" ? comment.data.id : String(reply);
+  const threadID = thread === "reply_to" ? comment.id : String(reply);
   if (event.issue_key !== null) {
     return {
       tool: "dispatch_comment",
       args: { issue: event.issue_key, [thread]: threadID, body: "..." }
     };
   }
-  let project = comment.data.project_key;
-  let artifact = comment.data.artifact_slug;
+  let project = comment.project_key;
+  let artifact = comment.artifact_slug;
   if (project === undefined || project === "" || artifact === undefined || artifact === "") {
     [project, artifact] = dispatchOwner(event, topic).split(" / ", 2);
   }
@@ -31358,13 +31406,10 @@ function dispatchPayload(event) {
   const parsed = schema.safeParse(event.payload);
   return parsed.success ? parsed.data : event.payload;
 }
-function dispatchAskQuestion(event) {
-  if (event.type !== "comment.created")
-    return;
-  const parsed = CommentEventPayloadSchema.safeParse(event.payload);
-  return parsed.success && parsed.data.ask_question !== undefined && parsed.data.ask_question !== "" ? textHead(parsed.data.ask_question) : undefined;
+function dispatchAskQuestion(comment) {
+  return comment?.ask_question !== undefined && comment.ask_question !== "" ? textHead(comment.ask_question) : undefined;
 }
-function dispatchReplyRef(event, topic, inReplyTo) {
+function dispatchReplyRef(event, topic, inReplyTo, comment) {
   let kind;
   let document = topicDocument(topic);
   if (event.type.startsWith("ask.")) {
@@ -31372,23 +31417,23 @@ function dispatchReplyRef(event, topic, inReplyTo) {
   } else if (event.type.startsWith("message.")) {
     kind = "message";
   } else if (event.type === "comment.created") {
-    const comment = CommentEventPayloadSchema.safeParse(event.payload);
-    if (!comment.success || comment.data.ask_id === undefined || comment.data.ask_id === null) {
+    if (comment === undefined || comment.ask_id === undefined || comment.ask_id === null) {
       return inReplyTo;
     }
     kind = "ask";
-    const { project_key: project, artifact_slug: slug } = comment.data;
+    const { project_key: project, artifact_slug: slug } = comment;
     if (project !== undefined && project !== "" && slug !== undefined && slug !== "") {
       document = { project, slug };
     }
   } else {
     return inReplyTo;
   }
-  if (event.issue_key !== null)
-    return `dispatch://${event.issue_key}/${kind}/${inReplyTo}`;
+  if (event.issue_key !== null) {
+    return dispatchChildRef(dispatchIssueRef(event.issue_key), kind, inReplyTo);
+  }
   if (document === undefined)
     return inReplyTo;
-  return `dispatch://${document.project}/artifact/${document.slug}/${kind}/${inReplyTo}`;
+  return dispatchChildRef(dispatchDocumentRef(document.project, document.slug), kind, inReplyTo);
 }
 function isObject2(value) {
   return typeof value === "object" && value !== null;
@@ -31400,16 +31445,16 @@ function parseDispatchFrame(rawPayload) {
   } catch {
     return { raw: rawPayload };
   }
-  const targeted = DispatchTargetedFrameSchema.safeParse(value);
-  if (targeted.success) {
-    const wireFrame = value;
-    return {
-      event: targeted.data.event,
-      notify: wireFrame.event.notify,
-      delivery: targeted.data.delivery
-    };
-  }
   if (isObject2(value) && "delivery" in value) {
+    const targeted = DispatchTargetedFrameSchema.safeParse(value);
+    if (targeted.success) {
+      const wireFrame = value;
+      return {
+        event: targeted.data.event,
+        notify: wireFrame.event.notify,
+        delivery: targeted.data.delivery
+      };
+    }
     const recoverable = RecoverableDispatchDeliveryFailureSchema.safeParse(value);
     if (recoverable.success) {
       return {
@@ -31481,12 +31526,13 @@ function renderInbound(raw, sessionID, subject) {
   let askAuthor;
   const dispatchRendered = envelope.source === "dispatch" && envelope.payload !== undefined;
   if (envelope.source === "dispatch") {
+    const topic = subject ?? envelope.topic;
     if (envelope.payload === undefined) {
       dispatchIssue = "payload";
     } else {
       const frame = parseDispatchFrame(envelope.payload);
       if ("event" in frame) {
-        if (frame.notify === false && (subject ?? envelope.topic)?.startsWith(DISPATCH_TOPIC_PREFIX) === true) {
+        if (frame.notify === false && topic?.startsWith(DISPATCH_TOPIC_PREFIX) === true) {
           return { skip: true, content: "", envelope };
         }
         if (frame.event.actor.kind === "session" && frame.event.actor.id === sessionID) {
@@ -31500,7 +31546,7 @@ function renderInbound(raw, sessionID, subject) {
           const who = removed.data.by?.id ?? "someone";
           return {
             skip: false,
-            content: `Unsubscribed from ${dispatchOwner(frame.event, subject ?? envelope.topic)} by ${who}`,
+            content: `Unsubscribed from ${dispatchOwner(frame.event, topic)} by ${who}`,
             envelope
           };
         }
@@ -31510,7 +31556,7 @@ function renderInbound(raw, sessionID, subject) {
             return { skip: true, content: "", envelope };
           }
           const who = follower.data.by?.id ?? "someone";
-          const owner = dispatchOwner(frame.event, subject ?? envelope.topic);
+          const owner = dispatchOwner(frame.event, topic);
           const ask = follower.data.ask_id ?? "?";
           return {
             skip: false,
@@ -31518,8 +31564,10 @@ function renderInbound(raw, sessionID, subject) {
             envelope
           };
         }
+        const comment = frame.event.type === "comment.created" ? CommentEventPayloadSchema.safeParse(frame.event.payload) : undefined;
+        const commentPayload = comment?.success === true ? comment.data : undefined;
         const answered = dispatchAskAnswer(frame.event);
-        const question = answered?.question ?? dispatchAskQuestion(frame.event);
+        const question = answered?.question ?? dispatchAskQuestion(commentPayload);
         if (frame.event.type.startsWith("ask.")) {
           const asked = AskAuthorPayloadSchema.safeParse(frame.event.payload);
           if (asked.success && asked.data.author.kind === "session") {
@@ -31527,9 +31575,9 @@ function renderInbound(raw, sessionID, subject) {
           }
         }
         if (inReplyTo !== undefined) {
-          inReplyTo = dispatchReplyRef(frame.event, subject ?? envelope.topic, inReplyTo);
+          inReplyTo = dispatchReplyRef(frame.event, topic, inReplyTo, commentPayload);
         }
-        dispatchReply = dispatchCommentReplyWith(frame.event, subject ?? envelope.topic);
+        dispatchReply = dispatchCommentReplyWith(frame.event, topic, commentPayload);
         if (frame.event.type === "message.created") {
           const message = MessageEventPayloadSchema.safeParse(frame.event.payload);
           const requested = DispatchDeliveryRequestSchema.safeParse(frame.delivery);
@@ -31550,11 +31598,9 @@ function renderInbound(raw, sessionID, subject) {
           }
         }
         dispatchEvent = {
-          owner: dispatchOwner(frame.event, subject ?? envelope.topic),
+          owner: dispatchOwner(frame.event, topic),
           ...frame.event.issue_key === null ? {
-            ...(subject ?? envelope.topic)?.startsWith(DISPATCH_DOCUMENT_TOPIC_PREFIX) === true ? {
-              document: dispatchOwner(frame.event, subject ?? envelope.topic).replace(" / ", "/")
-            } : {},
+            ...topic?.startsWith(DISPATCH_DOCUMENT_TOPIC_PREFIX) === true ? { document: dispatchOwner(frame.event, topic).replace(" / ", "/") } : {},
             ...frame.event.artifact_id === undefined || frame.event.artifact_id === null ? {} : { artifact_id: frame.event.artifact_id }
           } : { issue_key: frame.event.issue_key },
           type: frame.event.type,
@@ -31582,14 +31628,16 @@ function renderInbound(raw, sessionID, subject) {
   const payloadSummary = envelope.payload_summary ?? "unknown";
   const message = !dispatchRendered && envelope.payload !== undefined && envelope.payload !== envelope.payload_summary ? parsedPayload : undefined;
   const summaryIsHead = typeof message === "string" && envelope.payload_summary !== undefined && message.startsWith(envelope.payload_summary.endsWith("\u2026") ? envelope.payload_summary.slice(0, -1) : envelope.payload_summary);
-  const body = `${envelope.payload_summary ?? ""}
-${envelope.payload ?? ""}`;
   let foreignSession;
-  for (const match of body.matchAll(FOREIGN_SESSION_ID)) {
-    if (match[0] !== envelope.source_session && match[0] !== sessionID && match[0] !== askAuthor) {
-      foreignSession = match[0];
-      break;
+  for (const part of [envelope.payload_summary ?? "", envelope.payload ?? ""]) {
+    for (const match of part.matchAll(FOREIGN_SESSION_ID)) {
+      if (match[0] !== envelope.source_session && match[0] !== sessionID && match[0] !== askAuthor) {
+        foreignSession = match[0];
+        break;
+      }
     }
+    if (foreignSession !== undefined)
+      break;
   }
   const role = envelope.sender?.roles?.[0];
   const reply = dispatchReply ?? replyWith(envelope);
@@ -32300,14 +32348,8 @@ function formatZodIssues(issues, schema) {
 }
 
 // ../envoy-client/src/dispatch-execute.ts
-function issueTopic(key) {
-  return { label: key, topic: dispatchIssueSubject(key, ">") };
-}
 function documentTopic(artifact) {
-  return {
-    label: `${artifact.project}/${artifact.slug}`,
-    topic: dispatchDocumentSubject(artifact.project, artifact.slug, ">")
-  };
+  return documentTopicOf(artifact.project, artifact.slug);
 }
 function resolvedTopic(resolved) {
   if (resolved.owner.kind === "project")
@@ -32326,7 +32368,7 @@ function documentResultDetails(artifact) {
   return {
     project: artifact.project,
     artifact: artifact.id,
-    document: `${artifact.project}/${artifact.slug}`
+    document: documentLabel(artifact.project, artifact.slug)
   };
 }
 function writeResultDetails(resolved, fields) {
@@ -32337,15 +32379,15 @@ function writeResultDetails(resolved, fields) {
     throw new Error("issue document is missing its issue");
   return { issue: resolved.issue.key, ...fields };
 }
-async function askOwnerDetails(client, ask, resolved) {
+async function askOwnerDetails(client, ask, artifact) {
   if (ask.issue_key !== null) {
     return { issue: ask.issue_key, ask: ask.id };
   }
   if (ask.artifact_id === undefined || ask.artifact_id === null) {
     throw new Error("document ask is missing its artifact ID");
   }
-  const artifact = resolved?.artifact ?? await client.getArtifact(ask.artifact_id);
-  return { ...documentResultDetails(artifact), ask: ask.id };
+  const owner = artifact ?? await client.getArtifact(ask.artifact_id);
+  return { ...documentResultDetails(owner), ask: ask.id };
 }
 async function commentOwnerResult(client, comment, artifact) {
   if (comment.issue_key !== null) {
@@ -32356,12 +32398,12 @@ async function commentOwnerResult(client, comment, artifact) {
   }
   const owner = artifact ?? await client.getArtifact(comment.artifact_id);
   return {
-    label: documentTopic(owner).label,
+    label: documentLabel(owner.project, owner.slug),
     details: { ...documentResultDetails(owner), comment: comment.id }
   };
 }
-async function followedAskDetails(client, ask, resolved) {
-  return { ...await askOwnerDetails(client, ask, resolved), follows: { ask: ask.id } };
+async function followedAskDetails(client, ask, artifact) {
+  return { ...await askOwnerDetails(client, ask, artifact), follows: { ask: ask.id } };
 }
 var nativeIssueKeyPattern = /^[A-Z][A-Z0-9]{1,9}-[0-9]+$/;
 var externalIssueRefPattern = /^([^/\s]+)\/([^/\s#]+)#([1-9][0-9]*)$/;
@@ -32436,7 +32478,7 @@ function searchResultLine(result, baseUrl) {
   const href = new URL(result.href, baseUrl).toString();
   const { owner } = result;
   if (owner.kind === "document") {
-    const reference = `dispatch://${owner.project}/artifact/${owner.slug}`;
+    const reference = dispatchDocumentRef(owner.project, owner.slug);
     return `${reference} [document] ${owner.name} - ${result.kind}: ${snippetText(result.snippet)} -> ${href}`;
   }
   const artifactName = result.artifact ? ` ${result.artifact.name}` : "";
@@ -32447,7 +32489,6 @@ function askUrgency(args) {
   const value = args.urgency;
   return ASK_URGENCIES.find((urgency) => urgency === value);
 }
-var maxAskQuestion16 = 800;
 function questionWithRef(question, ref) {
   return ref === undefined || question.includes(ref) ? question : `${question}
 
@@ -32457,7 +32498,7 @@ function askQuestionWithRef(args) {
   return questionWithRef(stringArg(args, "question"), optionalString(args, "ref"));
 }
 function askQuestionProblem(withRef) {
-  return withRef.length > maxAskQuestion16 ? `question plus ref ${overCapMessage(withRef.length, maxAskQuestion16)}; shorten the question or drop the ref` : undefined;
+  return withRef.length > ASK_QUESTION_MAX ? `question plus ref ${overCapMessage(withRef.length, ASK_QUESTION_MAX)}; shorten the question or drop the ref` : undefined;
 }
 function parseDispatchRef(ref) {
   const projectDocument = ref.match(/^dispatch:\/\/([A-Z][A-Z0-9]{1,9})\/artifact\/([^/@]+)(?:@v(\d+))?(?:\/(ask|comment)\/([^/]+))?$/);
@@ -32512,6 +32553,10 @@ function parseDispatchRef(ref) {
     return { owner, kind: "message", id: message };
   return { owner, kind: "issue", id: issue };
 }
+function refTarget(ref, kind, id) {
+  const ownerRef = ref.owner.kind === "issue" ? dispatchIssueRef(ref.owner.issue) : dispatchDocumentRef(ref.owner.project, `${ref.artifact}`);
+  return dispatchChildRef(ownerRef, kind, id);
+}
 var uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var askIdProblem = "ask must be a bare ask id or a dispatch://.../ask/<id> reference";
 var commentIdProblem = "comment must be a bare comment id or a dispatch://.../comment/<id> reference";
@@ -32555,7 +32600,7 @@ function argumentProblems(tool, args) {
     case "dispatch_ask": {
       const question = optionalString(args, "question");
       const ref = optionalString(args, "ref");
-      if (question !== undefined && ref !== undefined && question.length <= maxAskQuestion16) {
+      if (question !== undefined && ref !== undefined && question.length <= ASK_QUESTION_MAX) {
         const problem = askQuestionProblem(questionWithRef(question, ref));
         if (problem !== undefined)
           problems.push(problem);
@@ -32645,11 +32690,17 @@ function dispatchRefFromUrl(value, serverUrl) {
 }
 var refGrammarProblem = "ref must be a valid dispatch:// reference such as dispatch://KEY-1, " + "dispatch://KEY-1/ask/<uuid>, dispatch://KEY-1/comment/<uuid>, " + "dispatch://KEY-1/message/<uuid>, dispatch://KEY-1/artifact/<slug>, or " + "dispatch://PROJECT/artifact/<document-ref> (an artifact id, slug, or filename); " + "a dashboard URL on this Dispatch server is accepted too";
 var ownerRequiredProblem = "issue is required; supply issue or set LEGION_ISSUE";
+var toolSchemas = new Map;
 function toolSchema(tool) {
+  const cached = toolSchemas.get(tool);
+  if (cached !== undefined)
+    return cached;
   const spec = dispatchToolSpecs.find((candidate) => candidate.name === tool);
   if (!spec)
     throw new Error(`Unknown Dispatch tool: ${tool}`);
-  return dispatchToolSchema(spec, zodSchemaApi(exports_external), { strict: true });
+  const schema = dispatchToolSchema(spec, zodSchemaApi(exports_external), { strict: true });
+  toolSchemas.set(tool, schema);
+  return schema;
 }
 async function resolveOwnerArguments(tool, input, cwd, env, exec, serverUrl, problems) {
   if (issueFreeTools[tool] === true)
@@ -32857,11 +32908,21 @@ function referenceLines(edges) {
     return `- ${edge.kind} ${edge.node.kind} ${edge.node.ref ?? edge.node.id} (${excerpt}${edge.created_at})`;
   });
 }
+function unavailableReason(error) {
+  return error instanceof DispatchServiceError && error.status === 404 ? "unavailable" : `unavailable: ${messageFor(error)}`;
+}
 async function graphEdges(client, query) {
   try {
     return (await client.getReferences(query)).edges;
   } catch (error) {
-    return error instanceof DispatchServiceError && error.status === 404 ? "unavailable" : `unavailable: ${error instanceof Error ? error.message : String(error)}`;
+    return unavailableReason(error);
+  }
+}
+async function issueReferencesOrUnavailable(client, key) {
+  try {
+    return await client.getIssueReferences(key);
+  } catch (error) {
+    return unavailableReason(error);
   }
 }
 async function graphSections(client, ref) {
@@ -33071,8 +33132,9 @@ async function executeDispatchTool(input) {
   problems.push(...argumentProblems(input.tool, ownerArguments.args));
   if (problems.length > 0)
     throw new ToolInputError(input.tool, problems);
+  const dispatchClient = () => new DispatchClient(configUrl, configToken, fetchImpl, input.signal);
   if (input.tool === "dispatch_open_asks") {
-    const client = new DispatchClient(configUrl, configToken, fetchImpl, input.signal);
+    const client = dispatchClient();
     const project = optionalString(ownerArguments.args, "project");
     if (project !== undefined) {
       const response = await client.openAsksForProject(project);
@@ -33088,7 +33150,7 @@ async function executeDispatchTool(input) {
     const sessionId = input.sessionId?.trim();
     if (!sessionId)
       throw new Error("host session id is required for dispatch_whoami");
-    const client = new DispatchClient(configUrl, configToken, fetchImpl, input.signal);
+    const client = dispatchClient();
     const identity = await client.whoami();
     const owner = identity.kind === "agent" ? identity.owner : identity.login.toLowerCase();
     return {
@@ -33098,7 +33160,7 @@ async function executeDispatchTool(input) {
   }
   const args = parsed.success ? parsed.data : ownerArguments.args;
   const actor = toolActor(await resolveOrigin(env, exec, input.cwd), input);
-  const client = new DispatchClient(configUrl, configToken, fetchImpl, input.signal);
+  const client = dispatchClient();
   const owner = ownerArguments.owner?.kind === "issue" ? {
     kind: "issue",
     issue: await ensureIssue(client, ownerArguments.owner.issue, actor)
@@ -33337,7 +33399,7 @@ async function executeDispatchTool(input) {
       return {
         text: `Asked ${ask.id} on ${askOwner.label} (urgency ${ask.urgency}): ${ask.question}
 ${followsAsk(askOwner)}`,
-        details: await followedAskDetails(client, ask, resolved)
+        details: await followedAskDetails(client, ask, resolved?.artifact)
       };
     }
     case "dispatch_edit_ask": {
@@ -33419,7 +33481,7 @@ ${followsAsk(askOwner)}`,
         ...inReplyTo === undefined ? {} : { in_reply_to: inReplyTo },
         actor
       });
-      const messageRef = `dispatch://${issueKey}/message/${message.id}`;
+      const messageRef = dispatchChildRef(dispatchIssueRef(issueKey), "message", message.id);
       return {
         text: `Posted message ${message.id} (${messageRef}) ${notSubscribed(issueTopic(issueKey))}`,
         details: { issue: issueKey, message: message.id }
@@ -33481,7 +33543,7 @@ ${trailer.join(`
           }
         };
       }
-      const details = await followedAskDetails(client, result.ask, resolved);
+      const details = await followedAskDetails(client, result.ask, resolved.artifact);
       return {
         text: `Approval requested for ${resolved.artifact.name} (document id ${resolved.artifact.id}) at version ${result.version} (ask ${result.ask.id}). The answer arrives as artifact.approved or artifact.changes_requested; an edit after approval makes it stale, so request again for the new version.`,
         details: { ...details, artifact: resolved.artifact.id, version: result.version }
@@ -33504,7 +33566,7 @@ ${trailer.join(`
       };
       const artifactOwner = documentOwner();
       const result = artifactOwner.kind === "project" ? await client.projectArtifact(artifactOwner.project, artifactInput) : await client.artifact(issue(), artifactInput);
-      const artifactRef = artifactOwner.kind === "project" ? `dispatch://${artifactOwner.project}/artifact/${result.artifact.slug}` : `dispatch://${issue()}/artifact/${result.artifact.slug}`;
+      const artifactRef = dispatchDocumentRef(artifactOwner.kind === "project" ? artifactOwner.project : issue(), result.artifact.slug);
       const uploadOwner = artifactOwner.kind === "project" ? documentTopic(result.artifact) : issueTopic(issue());
       return {
         text: `Uploaded ${result.artifact.name} as version ${result.version.number} (artifact slug ${result.artifact.slug}; ${artifactRef}) ${notSubscribed(uploadOwner)}`,
@@ -33540,7 +33602,7 @@ ${trailer.join(`
         const ref = ownerArguments.ref;
         const id = await resolveIdPrefix(input.tool, "ask", ref, async () => ref.owner.kind === "issue" ? client.listIssueAsks(ref.owner.issue) : client.getArtifactAsks((await resolveArtifact(client, ref.owner, ref.artifact)).artifact.id, "all"));
         const askRead = await client.getAsk(id);
-        const askRef = ref.owner.kind === "issue" ? `dispatch://${ref.owner.issue}/ask/${id}` : `dispatch://${ref.owner.project}/artifact/${ref.artifact}/ask/${id}`;
+        const askRef = refTarget(ref, "ask", id);
         return {
           text: askSummary(askRead, await graphSections(client, askRef)),
           details: ref.owner.kind === "project" ? { project: ref.owner.project } : { issue: ref.owner.issue }
@@ -33550,7 +33612,7 @@ ${trailer.join(`
         const ref = ownerArguments.ref;
         const id = await resolveIdPrefix(input.tool, "comment", ref, async () => ref.owner.kind === "issue" ? client.getComments(ref.owner.issue) : client.getArtifactComments((await resolveArtifact(client, ref.owner, ref.artifact)).artifact.id));
         const comment = await client.getComment(id);
-        const commentRef = ref.owner.kind === "issue" ? `dispatch://${ref.owner.issue}/comment/${id}` : `dispatch://${ref.owner.project}/artifact/${ref.artifact}/comment/${id}`;
+        const commentRef = refTarget(ref, "comment", id);
         return {
           text: commentSummary(comment, await graphSections(client, commentRef)),
           details: ref.owner.kind === "project" ? { project: ref.owner.project } : { issue: comment.comment.issue_key }
@@ -33561,7 +33623,7 @@ ${trailer.join(`
           throw new Error("message references are issue-scoped");
         }
         const messageRead = await client.getMessage(ownerArguments.ref.owner.issue, ownerArguments.ref.id);
-        const messageRef = `dispatch://${ownerArguments.ref.owner.issue}/message/${ownerArguments.ref.id}`;
+        const messageRef = dispatchChildRef(dispatchIssueRef(ownerArguments.ref.owner.issue), "message", ownerArguments.ref.id);
         return {
           text: messageSummary(messageRead, await graphSections(client, messageRef)),
           details: { issue: messageRead.message.issue_key }
@@ -33569,7 +33631,7 @@ ${trailer.join(`
       }
       if (documentOwner().kind === "project") {
         const resolved = await resolveArtifact(client, documentOwner(), stringArg(args, "artifact"));
-        const documentRef = `dispatch://${resolved.artifact.project}/artifact/${resolved.artifact.slug}`;
+        const documentRef = dispatchDocumentRef(resolved.artifact.project, resolved.artifact.slug);
         return {
           text: [
             `Document: ${resolved.artifact.project} / ${resolved.artifact.name}`,
@@ -33581,7 +33643,7 @@ ${trailer.join(`
 `),
           details: {
             project: resolved.artifact.project,
-            document: `${resolved.artifact.project}/${resolved.artifact.slug}`
+            document: documentLabel(resolved.artifact.project, resolved.artifact.slug)
           }
         };
       }
@@ -33598,14 +33660,12 @@ ${trailer.join(`
           details: { issue: read.issue.key }
         };
       }
-      let references;
-      try {
-        references = await client.getIssueReferences(read.issue.key);
-      } catch (error) {
-        references = error instanceof DispatchServiceError && error.status === 404 ? "unavailable" : `unavailable: ${error instanceof Error ? error.message : String(error)}`;
-      }
+      const [references, graph] = await Promise.all([
+        issueReferencesOrUnavailable(client, read.issue.key),
+        graphSections(client, dispatchIssueRef(read.issue.key))
+      ]);
       return {
-        text: issueSummary(read.issue, read.events, references, await graphSections(client, `dispatch://${read.issue.key}`)),
+        text: issueSummary(read.issue, read.events, references, graph),
         details: { issue: read.issue.key }
       };
     }
@@ -33640,12 +33700,12 @@ function dispatchFollowNotice(details) {
     return null;
   let owner;
   if (typeof issue === "string" && issue !== "") {
-    owner = { label: issue, topic: dispatchIssueSubject(issue, ">") };
+    owner = issueTopic(issue);
   } else if (typeof document === "string") {
     const [project, slug] = document.split("/", 2);
     if (!project || !slug)
       return null;
-    owner = { label: document, topic: dispatchDocumentSubject(project, slug, ">") };
+    owner = { label: document, topic: documentTopicOf(project, slug).topic };
   } else {
     return null;
   }
@@ -33654,6 +33714,16 @@ function dispatchFollowNotice(details) {
     text: `Following ask ${ask} on ${owner.label}: its answer and replies reach you directly (dispatch_follow unfollow to stop). For every event on ${owner.label}: envoy_subscribe ${owner.topic}.`
   };
 }
+function createFollowAnnouncer(emit) {
+  const announced = new Set;
+  return (details) => {
+    const notice = dispatchFollowNotice(details);
+    if (notice === null || announced.has(notice.ask))
+      return;
+    announced.add(notice.ask);
+    return emit(notice.text);
+  };
+}
 function subscriptionRemovedTopics(raw, sessionID) {
   let envelope;
   try {
@@ -33801,11 +33871,19 @@ var envoyToolSpecs = [
     requiresSubscriptionCapability: false
   }
 ];
+function sendConfirmationText(result) {
+  return `sent ${result.envelope.event_id} to ${result.recipient}${result.confirmed ? "" : " (recipient unconfirmed by listener)"}`;
+}
+var envoyToolSchemas = new Map;
 function parseEnvoyToolArguments(operation, parameters) {
   const spec = envoyToolSpecs.find((candidate) => candidate.operation === operation);
   if (spec === undefined)
     throw new Error(`missing Envoy tool specification for ${operation}`);
-  const schema = object(spec.arguments(zodSchemaApi(exports_external))).strict();
+  let schema = envoyToolSchemas.get(operation);
+  if (schema === undefined) {
+    schema = object(spec.arguments(zodSchemaApi(exports_external))).strict();
+    envoyToolSchemas.set(operation, schema);
+  }
   const parsed = schema.safeParse(parameters, { reportInput: true });
   if (!parsed.success) {
     throw new ToolInputError(spec.name, formatZodIssues(parsed.error.issues, schema));
@@ -33854,6 +33932,17 @@ var EnvelopeResponseSchema = EnvelopeSchema.extend({
   recipient: string2().optional(),
   holder: string2().optional()
 });
+function mergeInterestSources(registryTopics, liveTopics) {
+  const interests = new Map;
+  for (const topic of registryTopics) {
+    interests.set(topic, liveTopics.includes(topic) ? "both" : "registry");
+  }
+  for (const topic of liveTopics) {
+    if (!interests.has(topic))
+      interests.set(topic, "live");
+  }
+  return interests;
+}
 function expandSubscriptionTopics(topics) {
   const expanded = new Set;
   for (const topic of topics) {
@@ -34135,7 +34224,6 @@ async function copySessionID(copyToClipboard, sessionID) {
 // extensions/envoy.ts
 var codec2 = import_nats.StringCodec();
 var NATS_RETRY_INTERVAL_MS = 15000;
-var ALL_CAPABILITIES = DELIVERY_CAPABILITIES;
 var CAPABILITIES_WITHOUT_BTW = DELIVERY_CAPABILITIES.filter((capability) => capability !== "btw");
 var ROLE_CLAIM_ENTRY = "envoy-role-claim";
 var OPEN_ASKS_TIMEOUT_MS = 3000;
@@ -34208,7 +34296,7 @@ function envoyExtension(pi) {
       return null;
     const snapshot = await new DispatchClient(config.url, config.token, fetch, AbortSignal.timeout(OPEN_ASKS_TIMEOUT_MS)).openAsks(requestedSessionID);
     availabilityWarningSessionIDs.delete(requestedSessionID);
-    return snapshot;
+    return { snapshot, url: config.url };
   };
   const restoreLocalSessionState = (context) => {
     sessionDirectory = context.cwd;
@@ -34230,28 +34318,17 @@ function envoyExtension(pi) {
     return connection;
   };
   const postDispatchReply = async (delivery, result) => {
-    const config = currentDispatchConfig();
-    const response = await fetch(`${config.url}/api/v1/messages/${delivery.messageID}/reply`, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${config.token}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({
-        actor: { kind: "session", id: sessionID },
-        attempt: delivery.attempt,
-        ...result
-      })
-    });
-    if (!response.ok) {
-      throw new Error(`Dispatch reply failed: ${response.status} ${await response.text()}`);
-    }
+    await postDeliveryReply(currentDispatchConfig(), sessionID, delivery, result);
   };
   const deliver = async (subject, raw, reply) => {
     const rendered = renderInbound(raw, sessionID, subject);
     const directSubject = agentSubject(sessionID);
-    const envelopeTopic = rendered.envelope?.topic;
-    if (reply !== "" && subject === directSubject && envelopeTopic !== undefined && envelopeTopic !== directSubject) {
+    if (expectsLaneReceipt({
+      subject,
+      directSubject,
+      envelopeTopic: rendered.envelope?.topic,
+      reply
+    })) {
       try {
         (await ensureConnection()).publish(reply);
       } catch (error) {
@@ -34305,14 +34382,8 @@ function envoyExtension(pi) {
         console.warn(`[envoy] failed to deliver envelope ${envelope?.event_id ?? "unknown"}`, error);
         throw error;
       }
-      if (dedupeKey !== undefined) {
-        dedupeKeys.add(dedupeKey);
-        if (dedupeKeys.size > 1000) {
-          const oldest = dedupeKeys.values().next();
-          if (!oldest.done)
-            dedupeKeys.delete(oldest.value);
-        }
-      }
+      if (dedupeKey !== undefined)
+        rememberBounded(dedupeKeys, dedupeKey, 1000);
     }
   };
   const RESUBSCRIBE_DELAY_MS = Number(process.env.ENVOY_RESUBSCRIBE_DELAY_MS ?? "") || 5000;
@@ -34378,7 +34449,7 @@ function envoyExtension(pi) {
     topics: [...new Set([agentSubject(sessionID), ...subscriptions.keys()])],
     port: 0,
     title: activeSessionContext?.sessionManager.getSessionName?.() ?? "",
-    capabilities: typeof pi.askEphemeral === "function" ? ALL_CAPABILITIES : CAPABILITIES_WITHOUT_BTW,
+    capabilities: typeof pi.askEphemeral === "function" ? DELIVERY_CAPABILITIES : CAPABILITIES_WITHOUT_BTW,
     driving: false,
     selfSubscribed: true
   });
@@ -34734,14 +34805,14 @@ function envoyExtension(pi) {
     if (id === "")
       return;
     try {
-      const snapshot = await queryOpenAsks(id);
-      if (snapshot === null)
+      const open = await queryOpenAsks(id);
+      if (open === null)
         return;
       return {
         message: {
           customType: "dispatch-open-asks",
           content: `Dispatch authored-ask summary:
-${formatOpenAsksSummary(snapshot, currentDispatchConfig().url)}`,
+${formatOpenAsksSummary(open.snapshot, open.url)}`,
           display: false,
           attribution: "agent"
         }
@@ -34758,15 +34829,13 @@ ${formatOpenAsksSummary(snapshot, currentDispatchConfig().url)}`,
       };
     }
   });
-  const announcedFollows = new Set;
+  const announceFollow = createFollowAnnouncer((text) => {
+    pi.sendMessage({ customType: "envoy-message", content: text, display: true }, { deliverAs: "steer", triggerTurn: false });
+  });
   pi.on("tool_result", async (event) => {
     if (event.isError)
       return;
-    const notice = dispatchFollowNotice(event.details);
-    if (notice === null || announcedFollows.has(notice.ask))
-      return;
-    announcedFollows.add(notice.ask);
-    pi.sendMessage({ customType: "envoy-message", content: notice.text, display: true }, { deliverAs: "steer", triggerTurn: false });
+    announceFollow(event.details);
   });
   async function execute(operation, rawParameters) {
     try {
@@ -34816,14 +34885,7 @@ Warnings: ${warnings.join("; ")}`, {
         }
         case EnvoyToolOperation.listInterests: {
           const registry = await client.getInterest(sessionID);
-          const interests = new Map;
-          for (const topic of registry.topics) {
-            interests.set(topic, subscriptions.has(topic) ? "both" : "registry");
-          }
-          for (const topic of subscriptions.keys()) {
-            if (!interests.has(topic))
-              interests.set(topic, "live");
-          }
+          const interests = mergeInterestSources(registry.topics, [...subscriptions.keys()]);
           return toolSuccess(JSON.stringify({ ...registry, topics: [...interests.keys()] }, null, 2), {
             interests: [...interests].map(([topic, source]) => ({ topic, source }))
           });
@@ -34838,8 +34900,7 @@ Warnings: ${warnings.join("; ")}`, {
             message: stringFor(parameters, "message"),
             ...toMessageMetadata(parameters)
           });
-          const confirmation = result.confirmed ? "" : " (recipient unconfirmed by listener)";
-          return toolSuccess(`sent ${result.envelope.event_id} to ${result.recipient}${confirmation}`, {
+          return toolSuccess(sendConfirmationText(result), {
             event_id: result.envelope.event_id,
             recipient: result.recipient,
             confirmed: result.confirmed

package/dist/legion.js

@@ -28923,6 +28923,7 @@ function preprocess(fn, schema) {
   return pipe(transform(fn), schema);
 }
 // ../contracts/src/dispatch-api.ts
+var ASK_TURNS = ["human", "agent"];
 var DELIVERY_CAPABILITIES = ["aside", "btw", "steer"];
 var DispatchEventSchema = object({
   issue_key: string2().nullable(),
@@ -29003,8 +29004,8 @@ var CommentEventPayloadSchema = object({
   ask_id: string2().nullish(),
   ask_question: string2().optional(),
   ask_state: _enum2(["open", "answered", "resolved"]).optional(),
-  ask_waiting_on: _enum2(["human", "agent"]).optional(),
-  turn: _enum2(["human", "agent"]).nullish(),
+  ask_waiting_on: _enum2(ASK_TURNS).optional(),
+  turn: _enum2(ASK_TURNS).nullish(),
   anchor: object({ block_id: string2().nullable().optional(), quote: string2().optional() }).nullish(),
   suggestion: object({ replace_with: string2().optional() }).nullish(),
   author: object({ kind: string2(), id: string2() }).optional(),
@@ -29127,16 +29128,14 @@ function documentOwnerValidation(requireArtifact, alwaysRequireArtifact = false)
     message: alwaysRequireArtifact ? "Exactly one of issue and project is required; artifact or ref must name the document." : "Exactly one of issue and project is required; with project, artifact names the document."
   };
 }
-var commentValidation = (() => {
-  const owner = documentOwnerValidation(true);
-  return {
-    check: (value) => {
-      const input = value;
-      return owner.check(value) && (input.turn === undefined || typeof input.reply_to_ask === "string");
-    },
-    message: `${owner.message} turn requires reply_to_ask.`
-  };
-})();
+var commentOwner = documentOwnerValidation(true);
+var commentValidation = {
+  check: (value) => {
+    const input = value;
+    return commentOwner.check(value) && (input.turn === undefined || typeof input.reply_to_ask === "string");
+  },
+  message: `${commentOwner.message} turn requires reply_to_ask.`
+};
 var ISSUE_COMPONENTS_MODES = ["inherit", "explicit", "none"];
 function componentsArgument(z) {
   return z.object({
@@ -29158,6 +29157,7 @@ var SPEC_SECTIONS = [
 ];
 var SPEC_WRITING_GUIDANCE = `When writing a spec, use these sections in order: ${SPEC_SECTIONS.join(", ")}. ` + "Write for a reader who has not seen the code: plain sentences, every identifier expanded on " + "first use, no coined shorthand; see skills/dispatch Writing for the human and Writing a spec.";
 var ASK_URGENCIES = ["low", "med", "high", "blocking"];
+var ASK_QUESTION_MAX = 800;
 var ISSUE_STATUSES = [
   "triage",
   "icebox",
@@ -29169,6 +29169,9 @@ var ISSUE_STATUSES = [
   "retro",
   "done"
 ];
+function isIssueStatus(value) {
+  return ISSUE_STATUSES.includes(value);
+}
 var DOC_EDIT_OPS = ["replace", "delete", "insert", "retype", "move"];
 var dispatchToolSpecs = [
   {
@@ -29211,13 +29214,13 @@ var dispatchToolSpecs = [
   },
   {
     name: "dispatch_ask",
-    description: "Open a durable, answerable decision on an issue or project document. Do not use it for a status update or discussion; " + "use dispatch_message instead. A to-do a human must complete is a question phrased as that to-do, with the options you want (for example Done / Can't). " + "Anchor a document question, thread reply_to/reply_to_ask, or cite a dispatch:// " + 'reference \u2014 it must be answerable from its own text and anchor alone, never "see above". A quote anchor is pinned to its block. Question is at most 800 ' + `characters and has at most 8 options. ${OWNER_REFERENCE}`,
+    description: "Open a durable, answerable decision on an issue or project document. Do not use it for a status update or discussion; " + "use dispatch_message instead. A to-do a human must complete is a question phrased as that to-do, with the options you want (for example Done / Can't). " + "Anchor a document question, thread reply_to/reply_to_ask, or cite a dispatch:// " + `reference \u2014 it must be answerable from its own text and anchor alone, never "see above". A quote anchor is pinned to its block. Question is at most ${ASK_QUESTION_MAX} ` + `characters and has at most 8 options. ${OWNER_REFERENCE}`,
     arguments: (z) => ({
       issue: z.string().describe(ISSUE_REFERENCE).optional(),
       project: z.string().describe("Project key owning the document.").optional(),
       artifact: z.string().describe("Project document artifact id, slug, or filename.").optional(),
       ref: z.string().describe("Optional dispatch:// reference (issue, document, message, or ask); appended to the question and rendered as a link.").optional(),
-      question: z.string({ max: 800 }).describe("Decision question, at most 800 characters."),
+      question: z.string({ max: ASK_QUESTION_MAX }).describe(`Decision question, at most ${ASK_QUESTION_MAX} characters.`),
       options: z.array(z.object({
         label: z.string().describe("Selectable option label."),
         description: z.string().describe("Optional option context.").optional()
@@ -29237,7 +29240,7 @@ var dispatchToolSpecs = [
     description: "Edit an open question in place. Use it to correct or refine the same decision; retract the " + "old ask and open a new one when the decision itself changes. Previous text remains in the " + "event log. Only the asking session can edit it; answered or resolved asks cannot be edited.",
     arguments: (z) => ({
       ask: z.string().describe("Ask id to edit."),
-      question: z.string({ max: 800 }).describe("Replacement decision question, at most 800 characters.").optional(),
+      question: z.string({ max: ASK_QUESTION_MAX }).describe(`Replacement decision question, at most ${ASK_QUESTION_MAX} characters.`).optional(),
       options: z.array(z.object({
         label: z.string().describe("Selectable option label."),
         description: z.string().describe("Optional option context.").optional()
@@ -29990,11 +29993,7 @@ function generation(env) {
 }
 
 // src/legion/daemon-client.ts
-function defaultSleep(ms) {
-  const { promise, resolve } = Promise.withResolvers();
-  setTimeout(resolve, ms);
-  return promise;
-}
+import { setTimeout as delay } from "timers/promises";
 var SPAWN_WORKER_RETRY_DELAYS_MS = [2000, 5000];
 var SPAWN_WORKER_ATTEMPTS = SPAWN_WORKER_RETRY_DELAYS_MS.length + 1;
 
@@ -30053,7 +30052,7 @@ function sessionCapability(body) {
   return { sessionId: candidate.sessionId, secret: candidate.secret };
 }
 var WORKER_SESSION_PATH = "/legion/v1/worker-session";
-function createLegionDaemonClient(baseUrl, fetchFn = fetch, recovery, sleep = defaultSleep) {
+function createLegionDaemonClient(baseUrl, fetchFn = fetch, recovery, sleep = (ms) => delay(ms)) {
   const endpoint = baseUrl.replace(/\/+$/, "");
   const postOnce = async (path, body, schema, fetchImpl = fetchFn, onResponseReadError) => {
     const response = await fetchImpl(`${endpoint}${path}`, {
@@ -30362,9 +30361,6 @@ function toolFailure(error) {
 
 // src/legion/tools.ts
 var jsonSuccess = (details) => toolSuccess(JSON.stringify(details), details);
-function isIssueStatus(value) {
-  return ISSUE_STATUSES.includes(value);
-}
 function isDispatchArtifactId(value) {
   return LegionDaemonApi.GatesRegister.request.shape.artifactId.safeParse(value).success;
 }
@@ -30623,7 +30619,7 @@ var JJ_LOG_REWRITE_WORDS = ["undo", "abandon"];
 var JJ_OP_WORDS = ["op", "operation"];
 var JJ_OP_LOG_REWRITE_WORDS = ["restore", "revert"];
 var JJ_MENTION = /\bjj\b/;
-var JJ_LOG_REWRITE_MENTION = /\b(?:undo|abandon)\b|\b(?:op|operation)\b\W+(?:restore|revert)\b/;
+var JJ_LOG_REWRITE_MENTION = new RegExp(`\\b(?:${JJ_LOG_REWRITE_WORDS.join("|")})\\b|\\b(?:${JJ_OP_WORDS.join("|")})\\b\\W+(?:${JJ_OP_LOG_REWRITE_WORDS.join("|")})\\b`);
 function jjLogRewriteMention(text) {
   if (!JJ_MENTION.test(text))
     return;

package/dist/skills/dispatch/SKILL.md

@@ -30,6 +30,8 @@ vocabulary, and is often on a phone. Write for that person.
   what each costs, and your recommendation with its reason.
 - Before posting, test it: could Sami, reading only this text on his phone, know what he is being
   told or asked? If not, rewrite it. Length is not the problem; density is.
+- When an ask or message communicates a judgment, lead with that judgment in one sentence and put the mechanism underneath it. Do not make the reader ask a second time whether the result is a win. This shapes communication only when a judgment exists; it does not pre-decide an open question or remove its genuine options. Inferred from the AGENTC-186 12-hour-cap incident (platform PO, 2026-09-17).
+- When a Dispatch message states a root cause, include the reproducing command or test in that same message. Without it, label the diagnosis a hypothesis; a diagnosis still in progress may say so plainly. This boundary applies to causal claims, not to reporting that an investigation has started. Inferred from the astro lane's 2026-09-16 retro (platform PO, 2026-09-17).
 
 ## Agent authentication
 
@@ -267,6 +269,8 @@ It returns the imported commit, or the recorded error when the model was rejecte
 
 Before saying you are waiting for human input, call `dispatch_open_asks`. With no arguments it lists this session's active asks across open issues and project documents, including whether the human or agent owes the next reply. With `dispatch_open_asks({ project })` it lists every open ask in that project — on its issues and on its documents, whoever authored them — which is how you audit what a whole project is waiting on rather than just your own asks.
 
+**Unsettled product shape needs a decision before implementation.** When a page, navigation entry, table key, customer-scoping rule, or persisted sidecar would set product shape that Sami has not already settled, send a one-line ask before the first implementation commit. A platform-PO schema or contract ruling does not settle product shape. This does not turn a user-specified decision or routine implementation into an approval request; it is inferred from AGENTC-186's 2026-09-16 retro (platform PO, 2026-09-17).
+
 **Anything that needs the human is an ask, or it does not exist.** An approval, a credential,
 a setting only they can change, a review click, a conflict between two of their own rules - if
 your work waits on it, open a `dispatch_ask` the moment you know, the action as the question.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sjawhar/pi-legion-envoy",
-  "version": "1.49.0",
+  "version": "1.49.1",
   "type": "module",
   "omp": {
     "extensions": [