@sjawhar/pi-legion-envoy 1.48.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,22 @@ 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({
+    mode: z.enum(ISSUE_COMPONENTS_MODES).describe("inherit: take the parent chain's attachment (the default; deletes this issue's own). explicit: attach to ids. none: not architectural work, with reason."),
+    ids: z.array(z.string({ min: 1 }), { min: 1, max: 50 }).describe("For mode explicit: bare component ids from the project's architecture model (web, dispatch-server), not external ones.").optional(),
+    reason: z.string({ min: 1 }).describe("For mode none: why this issue is not architectural (process, hiring, ops).").optional()
+  }).describe("Attach the issue to architecture components. Attach the root before decomposing it; children inherit unless they choose.");
+}
 var SPEC_SECTIONS = [
   "Summary",
   "Decisions needed",
@@ -29876,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",
@@ -29887,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 = [
   {
@@ -29901,12 +29912,13 @@ var dispatchToolSpecs = [
       spec: z.string().describe(`Optional initial primary-document markdown. ${SPEC_WRITING_GUIDANCE}`).optional(),
       labels: z.array(z.string({ min: 1, max: 40 }), { max: 20 }).describe("Optional initial labels, at most 20 labels of up to 40 characters.").optional(),
       priority: z.number({ int: true, min: 0, max: 3 }).describe("Optional coarse priority: P0 is highest and P3 is lowest.").optional(),
-      assignee: z.string().describe("GitHub login of the human who answers this issue's asks; defaults to your owner when you act for a person, else the parent's assignee, else unassigned.").optional()
+      assignee: z.string().describe("GitHub login of the human who answers this issue's asks; defaults to your owner when you act for a person, else the parent's assignee, else unassigned.").optional(),
+      components: componentsArgument(z).optional()
     })
   },
   {
     name: "dispatch_issue_update",
-    description: "Update an existing issue: move its lifecycle status, retitle it, replace its labels, link a URL " + "(the pull request that delivers it, a run, a document), set its route, or set or clear its parent. " + "Status is one of " + `${ISSUE_STATUSES.join(", ")}; outside Legion, move it yourself as the work advances; inside ` + "Legion the daemon moves it. external_links are " + "merged into the issue's existing links by URL, so linking the pull request you just opened " + "keeps every earlier link. Priority is the human's and is not settable here. At least one " + `field besides issue is required. ${ISSUE_REFERENCE}`,
+    description: "Update an existing issue: move its lifecycle status, retitle it, replace its labels, link a URL " + "(the pull request that delivers it, a run, a document), set its route, set or clear its parent, " + "or attach it to architecture components. Status is one of " + `${ISSUE_STATUSES.join(", ")}; outside Legion, move it yourself as the work advances; inside ` + "Legion the daemon moves it. external_links are " + "merged into the issue's existing links by URL, so linking the pull request you just opened " + "keeps every earlier link. components replaces the issue's own attachment and is allowed on a " + "closed issue. Priority is the human's and is not settable here. At least one " + `field besides issue is required. ${ISSUE_REFERENCE}`,
     arguments: (z) => ({
       issue: z.string().describe(ISSUE_REFERENCE),
       status: z.enum(ISSUE_STATUSES).describe("New lifecycle status.").optional(),
@@ -29914,26 +29926,27 @@ var dispatchToolSpecs = [
       labels: z.array(z.string({ min: 1, max: 40 }), { max: 20 }).describe("Replacement label set, at most 20 labels of up to 40 characters; replaces every existing label.").optional(),
       external_links: z.array(z.string({ min: 1 })).describe("URLs to link; merged into the issue's existing external links by URL.").optional(),
       route: z.string().describe("Route the issue to role:<name> or session:<id>; an empty string clears it.").optional(),
-      parent: z.string().describe("Parent issue key in the same project; an empty string clears the parent.").optional()
+      parent: z.string().describe("Parent issue key in the same project; an empty string clears the parent.").optional(),
+      components: componentsArgument(z).optional()
     }),
     validation: {
       check: (value) => {
         const input = value;
-        return typeof input.status === "string" || typeof input.title === "string" || Array.isArray(input.labels) || Array.isArray(input.external_links) || typeof input.route === "string" || typeof input.parent === "string";
+        return typeof input.status === "string" || typeof input.title === "string" || Array.isArray(input.labels) || Array.isArray(input.external_links) || typeof input.route === "string" || typeof input.parent === "string" || typeof input.components === "object" && input.components !== null;
       },
-      message: "Issue update requires at least one field besides issue: status, title, labels, external_links, route, or parent."
+      message: "Issue update requires at least one field besides issue: status, title, labels, external_links, route, parent, or components."
     },
     strict: true
   },
   {
     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()
@@ -29953,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()
@@ -31184,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)
@@ -31200,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;
@@ -31237,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)
@@ -31303,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")
+function dispatchCommentReplyWith(event, topic, comment) {
+  if (comment === undefined || comment.id === undefined)
     return;
-  const comment = CommentEventPayloadSchema.safeParse(event.payload);
-  if (!comment.success || comment.data.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);
   }
@@ -31348,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.")) {
@@ -31362,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;
@@ -31390,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 {
@@ -31471,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) {
@@ -31490,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
           };
         }
@@ -31500,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,
@@ -31508,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") {
@@ -31517,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);
@@ -31540,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,
@@ -31572,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);
@@ -32290,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")
@@ -32316,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) {
@@ -32327,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) {
@@ -32346,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]*)$/;
@@ -32390,6 +32442,27 @@ function optionalNumber(args, name) {
   const value = args[name];
   return typeof value === "number" ? value : undefined;
 }
+function optionalComponents(args, name) {
+  const value = args[name];
+  if (typeof value !== "object" || value === null)
+    return;
+  const input = value;
+  return {
+    mode: input.mode,
+    ...input.ids === undefined ? {} : { ids: input.ids },
+    ...input.reason === undefined ? {} : { reason: input.reason }
+  };
+}
+function componentsChange(input, after) {
+  switch (input.mode) {
+    case "explicit":
+      return `components -> explicit [${after.ids.join(", ")}]`;
+    case "none":
+      return `components -> none (${after.reason ?? input.reason ?? ""})`;
+    case "inherit":
+      return "components -> inherit";
+  }
+}
 function isDuplicateCandidate(value) {
   if (typeof value !== "object" || value === null)
     return false;
@@ -32405,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}` : "";
@@ -32416,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}
 
@@ -32426,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)\/([^/]+))?$/);
@@ -32481,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";
@@ -32524,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);
@@ -32614,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)
@@ -32773,6 +32855,18 @@ function approvalLine(artifact) {
       return `Approval: changes requested on v${approval.version} by ${approval.by?.id ?? "unknown"}: ${approval.reason ?? ""}`;
   }
 }
+function componentsLine(components) {
+  const inherited = components.inherited_from === null ? "" : ` (inherited from ${components.inherited_from})`;
+  const retired = components.unknown.length === 0 ? "" : ` (retired: ${components.unknown.join(", ")})`;
+  switch (components.mode) {
+    case "explicit":
+      return `Components: ${components.ids.length === 0 ? "none live" : components.ids.join(", ")}${inherited}${retired}`;
+    case "none":
+      return `Components: none \u2014 ${components.reason ?? ""}${inherited}`;
+    case "inherit":
+      return "Components: unassigned";
+  }
+}
 function issueSummary(issue, events, references, graph) {
   const asks = issue.open_asks;
   const spec = issue.artifacts?.find((artifact) => artifact.primary);
@@ -32781,6 +32875,8 @@ function issueSummary(issue, events, references, graph) {
     throw new Error("Dispatch issue is missing priority");
   if (issue.assignee === undefined)
     throw new Error("Dispatch issue is missing assignee");
+  if (issue.components === undefined)
+    throw new Error("Dispatch issue is missing components");
   return [
     `Title: ${issue.title}`,
     `Key: ${issue.key}`,
@@ -32788,6 +32884,7 @@ function issueSummary(issue, events, references, graph) {
     `Assignee: ${issue.assignee ?? "unassigned"}`,
     ...issue.priority === null ? [] : [`Priority: P${issue.priority}`],
     `Labels: ${issue.labels.length === 0 ? "none" : issue.labels.join(", ")}`,
+    componentsLine(issue.components),
     `Route: ${issue.route ?? "none"}`,
     ...specApproval === undefined ? [] : [`Spec ${specApproval.replace(/^Approval/, "approval")}`],
     "Open asks:",
@@ -32811,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) {
@@ -33025,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);
@@ -33042,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 {
@@ -33052,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)
@@ -33077,6 +33185,7 @@ async function executeDispatchTool(input) {
       const spec = optionalString(args, "spec");
       const priority = optionalNumber(args, "priority");
       const assignee = optionalString(args, "assignee");
+      const components = optionalComponents(args, "components");
       const labels = args.labels;
       try {
         const created = await client.issue({
@@ -33088,6 +33197,7 @@ async function executeDispatchTool(input) {
           ...spec === undefined ? {} : { spec },
           ...priority === undefined ? {} : { priority },
           ...assignee === undefined ? {} : { assignee },
+          ...components === undefined ? {} : { components },
           ...Array.isArray(labels) ? { labels } : {},
           actor
         });
@@ -33120,6 +33230,7 @@ async function executeDispatchTool(input) {
       const title = optionalString(args, "title");
       const route = optionalString(args, "route");
       const parent = optionalString(args, "parent");
+      const components = optionalComponents(args, "components");
       const labels = Array.isArray(args.labels) ? args.labels : undefined;
       const requestedLinks = Array.isArray(args.external_links) ? [...new Set(args.external_links)] : undefined;
       let newLinks = [];
@@ -33133,6 +33244,7 @@ async function executeDispatchTool(input) {
           ...labels === undefined ? {} : { labels },
           ...route === undefined ? {} : { route },
           ...parent === undefined ? {} : { parent: parent === "" ? null : parent },
+          ...components === undefined ? {} : { components },
           ...requestedLinks === undefined ? {} : { external_links: [...before.external_links, ...newLinks.map((url) => ({ url }))] },
           actor
         });
@@ -33145,7 +33257,8 @@ async function executeDispatchTool(input) {
             newLinks.length === 0 ? `already linked ${requestedLinks.join(", ")} ${linkCount}` : `linked ${newLinks.join(", ")} ${linkCount}`
           ],
           ...route === undefined ? [] : [after.route === null ? "route cleared" : `route ${after.route}`],
-          ...parent === undefined ? [] : [after.parent === null ? "parent cleared" : `parent -> ${after.parent}`]
+          ...parent === undefined ? [] : [after.parent === null ? "parent cleared" : `parent -> ${after.parent}`],
+          ...components === undefined ? [] : [componentsChange(components, after.components)]
         ];
         return {
           text: `${after.key}: ${changes.join("; ")} ${notSubscribed(issueTopic(after.key))}`,
@@ -33286,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": {
@@ -33368,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 }
@@ -33430,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 }
@@ -33453,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)}`,
@@ -33489,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 }
@@ -33499,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 }
@@ -33510,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 }
@@ -33518,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}`,
@@ -33530,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)
           }
         };
       }
@@ -33547,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 }
       };
     }
@@ -33589,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;
   }
@@ -33603,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 {
@@ -33750,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));
@@ -33803,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) {
@@ -34084,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;
@@ -34157,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;
@@ -34179,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) {
@@ -34254,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;
@@ -34327,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
   });
@@ -34683,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"
         }
@@ -34707,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 {
@@ -34765,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 }))
           });
@@ -34787,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,22 @@ 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({
+    mode: z.enum(ISSUE_COMPONENTS_MODES).describe("inherit: take the parent chain's attachment (the default; deletes this issue's own). explicit: attach to ids. none: not architectural work, with reason."),
+    ids: z.array(z.string({ min: 1 }), { min: 1, max: 50 }).describe("For mode explicit: bare component ids from the project's architecture model (web, dispatch-server), not external ones.").optional(),
+    reason: z.string({ min: 1 }).describe("For mode none: why this issue is not architectural (process, hiring, ops).").optional()
+  }).describe("Attach the issue to architecture components. Attach the root before decomposing it; children inherit unless they choose.");
+}
 var SPEC_SECTIONS = [
   "Summary",
   "Decisions needed",
@@ -29150,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",
@@ -29161,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 = [
   {
@@ -29175,12 +29186,13 @@ var dispatchToolSpecs = [
       spec: z.string().describe(`Optional initial primary-document markdown. ${SPEC_WRITING_GUIDANCE}`).optional(),
       labels: z.array(z.string({ min: 1, max: 40 }), { max: 20 }).describe("Optional initial labels, at most 20 labels of up to 40 characters.").optional(),
       priority: z.number({ int: true, min: 0, max: 3 }).describe("Optional coarse priority: P0 is highest and P3 is lowest.").optional(),
-      assignee: z.string().describe("GitHub login of the human who answers this issue's asks; defaults to your owner when you act for a person, else the parent's assignee, else unassigned.").optional()
+      assignee: z.string().describe("GitHub login of the human who answers this issue's asks; defaults to your owner when you act for a person, else the parent's assignee, else unassigned.").optional(),
+      components: componentsArgument(z).optional()
     })
   },
   {
     name: "dispatch_issue_update",
-    description: "Update an existing issue: move its lifecycle status, retitle it, replace its labels, link a URL " + "(the pull request that delivers it, a run, a document), set its route, or set or clear its parent. " + "Status is one of " + `${ISSUE_STATUSES.join(", ")}; outside Legion, move it yourself as the work advances; inside ` + "Legion the daemon moves it. external_links are " + "merged into the issue's existing links by URL, so linking the pull request you just opened " + "keeps every earlier link. Priority is the human's and is not settable here. At least one " + `field besides issue is required. ${ISSUE_REFERENCE}`,
+    description: "Update an existing issue: move its lifecycle status, retitle it, replace its labels, link a URL " + "(the pull request that delivers it, a run, a document), set its route, set or clear its parent, " + "or attach it to architecture components. Status is one of " + `${ISSUE_STATUSES.join(", ")}; outside Legion, move it yourself as the work advances; inside ` + "Legion the daemon moves it. external_links are " + "merged into the issue's existing links by URL, so linking the pull request you just opened " + "keeps every earlier link. components replaces the issue's own attachment and is allowed on a " + "closed issue. Priority is the human's and is not settable here. At least one " + `field besides issue is required. ${ISSUE_REFERENCE}`,
     arguments: (z) => ({
       issue: z.string().describe(ISSUE_REFERENCE),
       status: z.enum(ISSUE_STATUSES).describe("New lifecycle status.").optional(),
@@ -29188,26 +29200,27 @@ var dispatchToolSpecs = [
       labels: z.array(z.string({ min: 1, max: 40 }), { max: 20 }).describe("Replacement label set, at most 20 labels of up to 40 characters; replaces every existing label.").optional(),
       external_links: z.array(z.string({ min: 1 })).describe("URLs to link; merged into the issue's existing external links by URL.").optional(),
       route: z.string().describe("Route the issue to role:<name> or session:<id>; an empty string clears it.").optional(),
-      parent: z.string().describe("Parent issue key in the same project; an empty string clears the parent.").optional()
+      parent: z.string().describe("Parent issue key in the same project; an empty string clears the parent.").optional(),
+      components: componentsArgument(z).optional()
     }),
     validation: {
       check: (value) => {
         const input = value;
-        return typeof input.status === "string" || typeof input.title === "string" || Array.isArray(input.labels) || Array.isArray(input.external_links) || typeof input.route === "string" || typeof input.parent === "string";
+        return typeof input.status === "string" || typeof input.title === "string" || Array.isArray(input.labels) || Array.isArray(input.external_links) || typeof input.route === "string" || typeof input.parent === "string" || typeof input.components === "object" && input.components !== null;
       },
-      message: "Issue update requires at least one field besides issue: status, title, labels, external_links, route, or parent."
+      message: "Issue update requires at least one field besides issue: status, title, labels, external_links, route, parent, or components."
     },
     strict: true
   },
   {
     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()
@@ -29227,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()
@@ -29980,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;
 
@@ -30043,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}`, {
@@ -30352,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;
 }
@@ -30613,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
 
@@ -248,6 +250,17 @@ that follow from it:
 the question carries `dispatch://KEY/artifact/<slug>` (or `ref`), never just its filename. Text
 they must read to decide belongs in the spec in the first place — see [Artifacts](#artifacts).
 
+Attach an issue to the architecture components it changes, before decomposing it — children inherit the parent's attachment unless they choose their own, so attaching the root once classifies the whole tree:
+
+```
+dispatch_issue({ project: "CORE", title: "...", components: { mode: "explicit", ids: ["dispatch-server", "web"] } })
+dispatch_issue_update({ issue: "CORE-12", components: { mode: "explicit", ids: ["web"] } })   // this issue's own set, replacing what it inherited
+dispatch_issue_update({ issue: "CORE-13", components: { mode: "none", reason: "hiring, not code" } })
+dispatch_issue_update({ issue: "CORE-14", components: { mode: "inherit" } })                  // back to the parent chain's attachment
+```
+
+Component ids are the file names under the repository's `.dispatch/architecture/` (`web.md` → `web`); an id the model lacks, or an `external` component, is refused with `COMPONENTS_INPUT`. A closed issue can be classified without reopening. Two rules: declare and attach before decomposing work, and change code and its architecture description (`.dispatch/architecture/<id>.md`) in the same review — the tree at `GET /api/v1/projects/{key}/architecture` counts every issue whose effective set names a component or anything it contains.
+
 Import a project's architecture model from its configured source repository now (a human configures the source in Settings):
 ```ts
 dispatch_architecture_sync({ project: "CORE" })
@@ -256,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/dist/skills/legion-architect/SKILL.md

@@ -331,3 +331,7 @@ capacity, and cross-tree conflict. Use the Legion escalation operation for those
 everything else in the tree, or use `dispatch_ask` for a human question; workers may reach
 Sami directly with `dispatch_ask` the same way. Do not create a wait loop for any wake
 source.
+
+## Architecture components
+
+Bootstrap on a root whose project has an architecture source: in the root's first PR (the implement worker pushes it), write `.dispatch/architecture/<id>.md` files for the planned components — front matter `title`, `parent`, `depends_on`, `external`; no `paths` yet. The importer reads the source branch's head, so the sync and the attach below work only once that PR has merged to the source branch: until then leave the root on `inherit` (the attach would answer `400 COMPONENTS_INPUT`, the component does not exist yet). After the merge, `dispatch_architecture_sync({ project })` and attach the root with `dispatch_issue_update({ issue, components: { mode: "explicit", ids: [...] } })`. Children inherit the root's attachment; give a child its own `components` only when it changes a narrower set, and `{ mode: "none", reason }` when it is not architectural work. Attach before decomposing, and require every implementer to change the component file beside the code it describes in the same review.

package/package.json

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