@sjawhar/pi-legion-envoy 0.18.0 → 0.18.2

package/dist/envoy.js

@@ -16116,122 +16116,6 @@ import { existsSync } from "fs";
 import { dirname, resolve } from "path";
 import { fileURLToPath } from "url";
 
-// ../contracts/src/dispatch-tools.ts
-var ISSUE_REFERENCE = "An issue is a native KEY or external owner/repo#n reference; an external reference creates its native issue on first use in the repository's mapped project (DISPATCH_REPO_PROJECTS) or, failing that, the default project (DISPATCH_DEFAULT_PROJECT).";
-var ASK_URGENCIES = ["low", "med", "high", "blocking"];
-var DOC_EDIT_OPS = ["replace", "delete", "insert"];
-var dispatchToolSpecs = [
-  {
-    name: "dispatch_issue",
-    description: "Create a native Dispatch issue for newly tracked work. Do not use it when an existing issue " + `already covers the work; read or update that issue instead. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      project: z.string().describe("Project key for the new issue."),
-      title: z.string().describe("Concise issue title."),
-      parent: z.string().describe("Optional parent issue.").optional(),
-      external: z.string().describe("Optional external issue reference.").optional(),
-      spec: z.string().describe("Optional initial primary-document markdown.").optional()
-    })
-  },
-  {
-    name: "dispatch_ask",
-    description: "Open a durable, answerable decision on an issue. Do not use it for a status update or discussion; " + `use dispatch_message instead. Question is at most 800 characters and has at most 8 options. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      question: z.string({ max: 800 }).describe("Decision question, at most 800 characters."),
-      options: z.array(z.object({
-        label: z.string().describe("Selectable option label."),
-        description: z.string().describe("Optional option context.").optional()
-      }), { max: 8 }).describe("Optional choices, at most 8.").optional(),
-      multiple: z.boolean().describe("Whether multiple choices may be selected.").optional(),
-      custom: z.boolean().describe("Whether a free-text answer is allowed.").optional(),
-      urgency: z.enum(ASK_URGENCIES).describe("Optional decision urgency.").optional(),
-      anchor: z.object({
-        artifact: z.string().describe("Artifact slug or id containing the quoted text."),
-        quote: z.string().describe("Exact text the decision concerns."),
-        occurrence: z.number({ int: true, min: 0 }).describe("Zero-based occurrence of the quote.").optional()
-      }).describe("Optional document location for the question.").optional()
-    })
-  },
-  {
-    name: "dispatch_comment",
-    description: "Add review feedback to an issue or document quote. Do not use it for an exact replacement; use " + `dispatch_suggest instead. Body is at most 2,000 characters. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      artifact: z.string().describe("Artifact slug or id required when quote is given.").optional(),
-      quote: z.string().describe("Optional exact quoted document text.").optional(),
-      occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based occurrence of quote.").optional(),
-      body: z.string({ max: 2000 }).describe("Review comment, at most 2,000 characters."),
-      reply_to: z.string().describe("Optional comment id to reply to.").optional()
-    })
-  },
-  {
-    name: "dispatch_suggest",
-    description: "Propose an exact replacement for quoted document text. Do not use it for general feedback; use " + `dispatch_comment instead. Optional explanation is at most 2,000 characters. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      artifact: z.string().describe("Artifact slug or id containing the quoted text."),
-      quote: z.string().describe("Exact document text to replace."),
-      replace_with: z.string().describe("Replacement text."),
-      body: z.string({ max: 2000 }).describe("Optional rationale, at most 2,000 characters.").optional(),
-      occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based occurrence of quote.").optional()
-    })
-  },
-  {
-    name: "dispatch_message",
-    description: "Post a plain issue update. Do not use it for a decision or line-specific review; use dispatch_ask " + `or dispatch_comment instead. Body is at most 2,000 characters. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      body: z.string({ max: 2000 }).describe("Update text, at most 2,000 characters.")
-    })
-  },
-  {
-    name: "dispatch_doc_edit",
-    description: "Apply deterministic text edits to a document. Do not use it for review feedback or for reading; use " + `dispatch_comment, dispatch_suggest, or dispatch_doc_read instead. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      artifact: z.string().describe("Artifact slug or id for the document."),
-      ops: z.array(z.object({
-        op: z.enum(DOC_EDIT_OPS).describe("Edit operation."),
-        find: z.string().describe("Text to find for replace or delete.").optional(),
-        with: z.string().describe("Replacement text for replace.").optional(),
-        occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based match occurrence.").optional(),
-        markdown: z.string().describe("Markdown to insert.").optional(),
-        after: z.string().describe("Anchor after which to insert.").optional(),
-        before: z.string().describe("Anchor before which to insert.").optional()
-      })).describe("Flat tagged edits; the server validates fields required for each operation."),
-      summary: z.string().describe("Optional named-version summary.").optional()
-    })
-  },
-  {
-    name: "dispatch_doc_read",
-    description: "Read a live document or a named document version. Do not use it for issue status, asks, or events; " + "use dispatch_read instead. Supply ref or issue; issue plus an omitted artifact reads the primary document. " + `${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE).optional(),
-      artifact: z.string().describe("Optional artifact slug or id; primary document by default.").optional(),
-      version: z.number({ int: true, min: 1 }).describe("Optional version number.").optional(),
-      ref: z.string().describe("Optional dispatch:// document reference.").optional()
-    })
-  },
-  {
-    name: "dispatch_artifact",
-    description: "Upload a local file as an issue artifact. Do not use it to edit a live document; use dispatch_doc_edit " + `instead. Files are limited to 25 MiB. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      name: z.string().describe("Artifact filename shown in Dispatch."),
-      path: z.string().describe("Local path to the file to upload."),
-      primary: z.boolean().describe("Make this document the issue primary artifact.").optional(),
-      summary: z.string().describe("Optional version summary.").optional()
-    })
-  },
-  {
-    name: "dispatch_read",
-    description: "Read an issue summary, targeted ask, or targeted comment reply chain. Do not use it for document " + "contents; use dispatch_doc_read instead. Supply issue or ref. " + ISSUE_REFERENCE,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE).optional(),
-      ref: z.string().describe("Optional dispatch:// issue reference.").optional()
-    })
-  }
-];
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -29764,6 +29648,160 @@ 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 DispatchEventSchema = object({
+  issue_key: string2(),
+  type: string2(),
+  actor: object({ kind: string2(), id: string2().optional() }).passthrough(),
+  payload: object({}).passthrough()
+});
+var IssueEventPayloadSchema = object({
+  title: string2().optional(),
+  status: string2().optional(),
+  route: string2().nullish()
+});
+var ArtifactCreatedEventPayloadSchema = object({
+  artifact: object({ name: string2().optional() }).optional()
+});
+var ArtifactVersionEventPayloadSchema = object({
+  name: string2().optional(),
+  version: object({ number: number2().optional(), summary: string2().nullish() }).optional(),
+  diff: string2().optional()
+});
+var AskEventPayloadSchema = object({
+  question: string2().optional(),
+  options: array(object({ label: string2().optional() })).nullish(),
+  answer: object({ selected: array(string2()).nullish(), text: string2().nullish() }).nullish()
+});
+var CommentEventPayloadSchema = object({
+  artifact_name: string2().optional(),
+  body: string2().optional(),
+  reply_to: string2().nullish(),
+  anchor: object({ quote: string2().optional() }).nullish(),
+  suggestion: object({ replace_with: string2().optional() }).nullish()
+});
+var MessageEventPayloadSchema = object({ body: string2().optional() });
+var ChildStatusEventPayloadSchema = object({
+  child_key: string2().optional(),
+  from: string2().optional(),
+  to: string2().optional()
+});
+// ../contracts/src/dispatch-tools.ts
+var ISSUE_REFERENCE = "An issue is a native KEY or external owner/repo#n reference; an external reference creates its native issue on first use in the repository's mapped project (DISPATCH_REPO_PROJECTS) or, failing that, the default project (DISPATCH_DEFAULT_PROJECT).";
+var ASK_URGENCIES = ["low", "med", "high", "blocking"];
+var DOC_EDIT_OPS = ["replace", "delete", "insert"];
+var dispatchToolSpecs = [
+  {
+    name: "dispatch_issue",
+    description: "Create a native Dispatch issue for newly tracked work. Do not use it when an existing issue " + `already covers the work; read or update that issue instead. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      project: z.string().describe("Project key for the new issue."),
+      title: z.string().describe("Concise issue title."),
+      parent: z.string().describe("Optional parent issue.").optional(),
+      external: z.string().describe("Optional external issue reference.").optional(),
+      spec: z.string().describe("Optional initial primary-document markdown.").optional()
+    })
+  },
+  {
+    name: "dispatch_ask",
+    description: "Open a durable, answerable decision on an issue. Do not use it for a status update or discussion; " + `use dispatch_message instead. Question is at most 800 characters and has at most 8 options. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      question: z.string({ max: 800 }).describe("Decision question, at most 800 characters."),
+      options: z.array(z.object({
+        label: z.string().describe("Selectable option label."),
+        description: z.string().describe("Optional option context.").optional()
+      }), { max: 8 }).describe("Optional choices, at most 8.").optional(),
+      multiple: z.boolean().describe("Whether multiple choices may be selected.").optional(),
+      custom: z.boolean().describe("Whether a free-text answer is allowed.").optional(),
+      urgency: z.enum(ASK_URGENCIES).describe("Optional decision urgency.").optional(),
+      anchor: z.object({
+        artifact: z.string().describe("Artifact slug or id containing the quoted text."),
+        quote: z.string().describe("Exact text the decision concerns."),
+        occurrence: z.number({ int: true, min: 0 }).describe("Zero-based occurrence of the quote.").optional()
+      }).describe("Optional document location for the question.").optional()
+    })
+  },
+  {
+    name: "dispatch_comment",
+    description: "Add review feedback to an issue or document quote. Do not use it for an exact replacement; use " + `dispatch_suggest instead. Body is at most 2,000 characters. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      artifact: z.string().describe("Artifact slug or id required when quote is given.").optional(),
+      quote: z.string().describe("Optional exact quoted document text.").optional(),
+      occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based occurrence of quote.").optional(),
+      body: z.string({ max: 2000 }).describe("Review comment, at most 2,000 characters."),
+      reply_to: z.string().describe("Optional comment id to reply to.").optional()
+    })
+  },
+  {
+    name: "dispatch_suggest",
+    description: "Propose an exact replacement for quoted document text. Do not use it for general feedback; use " + `dispatch_comment instead. Optional explanation is at most 2,000 characters. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      artifact: z.string().describe("Artifact slug or id containing the quoted text."),
+      quote: z.string().describe("Exact document text to replace."),
+      replace_with: z.string().describe("Replacement text."),
+      body: z.string({ max: 2000 }).describe("Optional rationale, at most 2,000 characters.").optional(),
+      occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based occurrence of quote.").optional()
+    })
+  },
+  {
+    name: "dispatch_message",
+    description: "Post a plain issue update. Do not use it for a decision or line-specific review; use dispatch_ask " + `or dispatch_comment instead. Body is at most 2,000 characters. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      body: z.string({ max: 2000 }).describe("Update text, at most 2,000 characters.")
+    })
+  },
+  {
+    name: "dispatch_doc_edit",
+    description: "Apply deterministic text edits to a document. Do not use it for review feedback or for reading; use " + `dispatch_comment, dispatch_suggest, or dispatch_doc_read instead. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      artifact: z.string().describe("Artifact slug or id for the document."),
+      ops: z.array(z.object({
+        op: z.enum(DOC_EDIT_OPS).describe("Edit operation."),
+        find: z.string().describe("Text to find for replace or delete.").optional(),
+        with: z.string().describe("Replacement text for replace.").optional(),
+        occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based match occurrence.").optional(),
+        markdown: z.string().describe("Markdown to insert.").optional(),
+        after: z.string().describe("Anchor after which to insert.").optional(),
+        before: z.string().describe("Anchor before which to insert.").optional()
+      })).describe("Flat tagged edits; the server validates fields required for each operation."),
+      summary: z.string().describe("Optional named-version summary.").optional()
+    })
+  },
+  {
+    name: "dispatch_doc_read",
+    description: "Read a live document or a named document version. Do not use it for issue status, asks, or events; " + "use dispatch_read instead. Supply ref or issue; issue plus an omitted artifact reads the primary document. " + `${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE).optional(),
+      artifact: z.string().describe("Optional artifact slug or id; primary document by default.").optional(),
+      version: z.number({ int: true, min: 1 }).describe("Optional version number.").optional(),
+      ref: z.string().describe("Optional dispatch:// document reference.").optional()
+    })
+  },
+  {
+    name: "dispatch_artifact",
+    description: "Upload a local file as an issue artifact. Do not use it to edit a live document; use dispatch_doc_edit " + `instead. Files are limited to 25 MiB. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      name: z.string().describe("Artifact filename shown in Dispatch."),
+      path: z.string().describe("Local path to the file to upload."),
+      primary: z.boolean().describe("Make this document the issue primary artifact.").optional(),
+      summary: z.string().describe("Optional version summary.").optional()
+    })
+  },
+  {
+    name: "dispatch_read",
+    description: "Read an issue summary, targeted ask, or targeted comment reply chain. Do not use it for document " + "contents; use dispatch_doc_read instead. Supply issue or ref. " + ISSUE_REFERENCE,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE).optional(),
+      ref: z.string().describe("Optional dispatch:// issue reference.").optional()
+    })
+  }
+];
 // ../contracts/src/envelope.ts
 var isSubject = (value) => typeof value === "string" && value.length > 0;
 var EnvelopeSchema = object({
@@ -30748,57 +30786,20 @@ function replyWith(envelope) {
     return;
   return `envoy_send(session_id="${envelope.source_session}", message="...")`;
 }
-var DispatchEventSchema = object({
-  issue_key: string2(),
-  type: string2(),
-  actor: object({ kind: string2(), id: string2().optional() }).passthrough(),
-  payload: object({}).passthrough()
-});
-var IssuePayloadSchema = object({
-  title: string2().optional(),
-  status: string2().optional(),
-  route: string2().nullish()
-});
-var ArtifactCreatedPayloadSchema = object({
-  artifact: object({ name: string2().optional() }).optional()
-});
-var ArtifactVersionPayloadSchema = object({
-  name: string2().optional(),
-  version: object({ number: number2().optional(), summary: string2().nullish() }).optional(),
-  diff: string2().optional()
-});
-var AskPayloadSchema = object({
-  question: string2().optional(),
-  options: array(object({ label: string2().optional() })).nullish(),
-  answer: object({ selected: array(string2()).nullish(), text: string2().nullish() }).nullish()
-});
-var CommentPayloadSchema = object({
-  artifact_name: string2().optional(),
-  body: string2().optional(),
-  reply_to: string2().nullish(),
-  anchor: object({ quote: string2().optional() }).nullish(),
-  suggestion: object({ replace_with: string2().optional() }).nullish()
-});
-var MessagePayloadSchema = object({ body: string2().optional() });
-var ChildStatusPayloadSchema = object({
-  child_key: string2().optional(),
-  from: string2().optional(),
-  to: string2().optional()
-});
 var DISPATCH_PAYLOAD_SCHEMAS = {
-  "issue.created": IssuePayloadSchema,
-  "issue.updated": IssuePayloadSchema,
-  "issue.closed": IssuePayloadSchema,
-  "artifact.created": ArtifactCreatedPayloadSchema,
-  "artifact.version": ArtifactVersionPayloadSchema,
-  "ask.opened": AskPayloadSchema,
-  "ask.answered": AskPayloadSchema,
-  "comment.created": CommentPayloadSchema,
-  "comment.resolved": CommentPayloadSchema,
-  "suggestion.accepted": CommentPayloadSchema,
-  "suggestion.rejected": CommentPayloadSchema,
-  "message.created": MessagePayloadSchema,
-  "child.status": ChildStatusPayloadSchema
+  "issue.created": IssueEventPayloadSchema,
+  "issue.updated": IssueEventPayloadSchema,
+  "issue.closed": IssueEventPayloadSchema,
+  "artifact.created": ArtifactCreatedEventPayloadSchema,
+  "artifact.version": ArtifactVersionEventPayloadSchema,
+  "ask.opened": AskEventPayloadSchema,
+  "ask.answered": AskEventPayloadSchema,
+  "comment.created": CommentEventPayloadSchema,
+  "comment.resolved": CommentEventPayloadSchema,
+  "suggestion.accepted": CommentEventPayloadSchema,
+  "suggestion.rejected": CommentEventPayloadSchema,
+  "message.created": MessageEventPayloadSchema,
+  "child.status": ChildStatusEventPayloadSchema
 };
 function dispatchPayload(event) {
   const schema = DISPATCH_PAYLOAD_SCHEMAS[event.type];
@@ -31182,7 +31183,8 @@ class DispatchClient {
       form.set("primary", String(input.primary));
     if (input.summary !== undefined)
       form.set("summary", input.summary);
-    form.set("actor", JSON.stringify(input.actor));
+    if (input.actor !== undefined)
+      form.set("actor", JSON.stringify(input.actor));
     form.set("file", input.file, input.name);
     return this.#form("POST", ["api", "v1", "issues", await this.#resolveIssue(issue), "artifacts"], form);
   }

package/dist/legion.js

@@ -16114,122 +16114,6 @@ var require_mod4 = __commonJS(function(exports) {
 // extensions/legion.ts
 import path4 from "path";
 
-// ../contracts/src/dispatch-tools.ts
-var ISSUE_REFERENCE = "An issue is a native KEY or external owner/repo#n reference; an external reference creates its native issue on first use in the repository's mapped project (DISPATCH_REPO_PROJECTS) or, failing that, the default project (DISPATCH_DEFAULT_PROJECT).";
-var ASK_URGENCIES = ["low", "med", "high", "blocking"];
-var DOC_EDIT_OPS = ["replace", "delete", "insert"];
-var dispatchToolSpecs = [
-  {
-    name: "dispatch_issue",
-    description: "Create a native Dispatch issue for newly tracked work. Do not use it when an existing issue " + `already covers the work; read or update that issue instead. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      project: z.string().describe("Project key for the new issue."),
-      title: z.string().describe("Concise issue title."),
-      parent: z.string().describe("Optional parent issue.").optional(),
-      external: z.string().describe("Optional external issue reference.").optional(),
-      spec: z.string().describe("Optional initial primary-document markdown.").optional()
-    })
-  },
-  {
-    name: "dispatch_ask",
-    description: "Open a durable, answerable decision on an issue. Do not use it for a status update or discussion; " + `use dispatch_message instead. Question is at most 800 characters and has at most 8 options. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      question: z.string({ max: 800 }).describe("Decision question, at most 800 characters."),
-      options: z.array(z.object({
-        label: z.string().describe("Selectable option label."),
-        description: z.string().describe("Optional option context.").optional()
-      }), { max: 8 }).describe("Optional choices, at most 8.").optional(),
-      multiple: z.boolean().describe("Whether multiple choices may be selected.").optional(),
-      custom: z.boolean().describe("Whether a free-text answer is allowed.").optional(),
-      urgency: z.enum(ASK_URGENCIES).describe("Optional decision urgency.").optional(),
-      anchor: z.object({
-        artifact: z.string().describe("Artifact slug or id containing the quoted text."),
-        quote: z.string().describe("Exact text the decision concerns."),
-        occurrence: z.number({ int: true, min: 0 }).describe("Zero-based occurrence of the quote.").optional()
-      }).describe("Optional document location for the question.").optional()
-    })
-  },
-  {
-    name: "dispatch_comment",
-    description: "Add review feedback to an issue or document quote. Do not use it for an exact replacement; use " + `dispatch_suggest instead. Body is at most 2,000 characters. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      artifact: z.string().describe("Artifact slug or id required when quote is given.").optional(),
-      quote: z.string().describe("Optional exact quoted document text.").optional(),
-      occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based occurrence of quote.").optional(),
-      body: z.string({ max: 2000 }).describe("Review comment, at most 2,000 characters."),
-      reply_to: z.string().describe("Optional comment id to reply to.").optional()
-    })
-  },
-  {
-    name: "dispatch_suggest",
-    description: "Propose an exact replacement for quoted document text. Do not use it for general feedback; use " + `dispatch_comment instead. Optional explanation is at most 2,000 characters. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      artifact: z.string().describe("Artifact slug or id containing the quoted text."),
-      quote: z.string().describe("Exact document text to replace."),
-      replace_with: z.string().describe("Replacement text."),
-      body: z.string({ max: 2000 }).describe("Optional rationale, at most 2,000 characters.").optional(),
-      occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based occurrence of quote.").optional()
-    })
-  },
-  {
-    name: "dispatch_message",
-    description: "Post a plain issue update. Do not use it for a decision or line-specific review; use dispatch_ask " + `or dispatch_comment instead. Body is at most 2,000 characters. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      body: z.string({ max: 2000 }).describe("Update text, at most 2,000 characters.")
-    })
-  },
-  {
-    name: "dispatch_doc_edit",
-    description: "Apply deterministic text edits to a document. Do not use it for review feedback or for reading; use " + `dispatch_comment, dispatch_suggest, or dispatch_doc_read instead. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      artifact: z.string().describe("Artifact slug or id for the document."),
-      ops: z.array(z.object({
-        op: z.enum(DOC_EDIT_OPS).describe("Edit operation."),
-        find: z.string().describe("Text to find for replace or delete.").optional(),
-        with: z.string().describe("Replacement text for replace.").optional(),
-        occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based match occurrence.").optional(),
-        markdown: z.string().describe("Markdown to insert.").optional(),
-        after: z.string().describe("Anchor after which to insert.").optional(),
-        before: z.string().describe("Anchor before which to insert.").optional()
-      })).describe("Flat tagged edits; the server validates fields required for each operation."),
-      summary: z.string().describe("Optional named-version summary.").optional()
-    })
-  },
-  {
-    name: "dispatch_doc_read",
-    description: "Read a live document or a named document version. Do not use it for issue status, asks, or events; " + "use dispatch_read instead. Supply ref or issue; issue plus an omitted artifact reads the primary document. " + `${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE).optional(),
-      artifact: z.string().describe("Optional artifact slug or id; primary document by default.").optional(),
-      version: z.number({ int: true, min: 1 }).describe("Optional version number.").optional(),
-      ref: z.string().describe("Optional dispatch:// document reference.").optional()
-    })
-  },
-  {
-    name: "dispatch_artifact",
-    description: "Upload a local file as an issue artifact. Do not use it to edit a live document; use dispatch_doc_edit " + `instead. Files are limited to 25 MiB. ${ISSUE_REFERENCE}`,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE),
-      name: z.string().describe("Artifact filename shown in Dispatch."),
-      path: z.string().describe("Local path to the file to upload."),
-      primary: z.boolean().describe("Make this document the issue primary artifact.").optional(),
-      summary: z.string().describe("Optional version summary.").optional()
-    })
-  },
-  {
-    name: "dispatch_read",
-    description: "Read an issue summary, targeted ask, or targeted comment reply chain. Do not use it for document " + "contents; use dispatch_doc_read instead. Supply issue or ref. " + ISSUE_REFERENCE,
-    arguments: (z) => ({
-      issue: z.string().describe(ISSUE_REFERENCE).optional(),
-      ref: z.string().describe("Optional dispatch:// issue reference.").optional()
-    })
-  }
-];
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -29762,6 +29646,160 @@ 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 DispatchEventSchema = object({
+  issue_key: string2(),
+  type: string2(),
+  actor: object({ kind: string2(), id: string2().optional() }).passthrough(),
+  payload: object({}).passthrough()
+});
+var IssueEventPayloadSchema = object({
+  title: string2().optional(),
+  status: string2().optional(),
+  route: string2().nullish()
+});
+var ArtifactCreatedEventPayloadSchema = object({
+  artifact: object({ name: string2().optional() }).optional()
+});
+var ArtifactVersionEventPayloadSchema = object({
+  name: string2().optional(),
+  version: object({ number: number2().optional(), summary: string2().nullish() }).optional(),
+  diff: string2().optional()
+});
+var AskEventPayloadSchema = object({
+  question: string2().optional(),
+  options: array(object({ label: string2().optional() })).nullish(),
+  answer: object({ selected: array(string2()).nullish(), text: string2().nullish() }).nullish()
+});
+var CommentEventPayloadSchema = object({
+  artifact_name: string2().optional(),
+  body: string2().optional(),
+  reply_to: string2().nullish(),
+  anchor: object({ quote: string2().optional() }).nullish(),
+  suggestion: object({ replace_with: string2().optional() }).nullish()
+});
+var MessageEventPayloadSchema = object({ body: string2().optional() });
+var ChildStatusEventPayloadSchema = object({
+  child_key: string2().optional(),
+  from: string2().optional(),
+  to: string2().optional()
+});
+// ../contracts/src/dispatch-tools.ts
+var ISSUE_REFERENCE = "An issue is a native KEY or external owner/repo#n reference; an external reference creates its native issue on first use in the repository's mapped project (DISPATCH_REPO_PROJECTS) or, failing that, the default project (DISPATCH_DEFAULT_PROJECT).";
+var ASK_URGENCIES = ["low", "med", "high", "blocking"];
+var DOC_EDIT_OPS = ["replace", "delete", "insert"];
+var dispatchToolSpecs = [
+  {
+    name: "dispatch_issue",
+    description: "Create a native Dispatch issue for newly tracked work. Do not use it when an existing issue " + `already covers the work; read or update that issue instead. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      project: z.string().describe("Project key for the new issue."),
+      title: z.string().describe("Concise issue title."),
+      parent: z.string().describe("Optional parent issue.").optional(),
+      external: z.string().describe("Optional external issue reference.").optional(),
+      spec: z.string().describe("Optional initial primary-document markdown.").optional()
+    })
+  },
+  {
+    name: "dispatch_ask",
+    description: "Open a durable, answerable decision on an issue. Do not use it for a status update or discussion; " + `use dispatch_message instead. Question is at most 800 characters and has at most 8 options. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      question: z.string({ max: 800 }).describe("Decision question, at most 800 characters."),
+      options: z.array(z.object({
+        label: z.string().describe("Selectable option label."),
+        description: z.string().describe("Optional option context.").optional()
+      }), { max: 8 }).describe("Optional choices, at most 8.").optional(),
+      multiple: z.boolean().describe("Whether multiple choices may be selected.").optional(),
+      custom: z.boolean().describe("Whether a free-text answer is allowed.").optional(),
+      urgency: z.enum(ASK_URGENCIES).describe("Optional decision urgency.").optional(),
+      anchor: z.object({
+        artifact: z.string().describe("Artifact slug or id containing the quoted text."),
+        quote: z.string().describe("Exact text the decision concerns."),
+        occurrence: z.number({ int: true, min: 0 }).describe("Zero-based occurrence of the quote.").optional()
+      }).describe("Optional document location for the question.").optional()
+    })
+  },
+  {
+    name: "dispatch_comment",
+    description: "Add review feedback to an issue or document quote. Do not use it for an exact replacement; use " + `dispatch_suggest instead. Body is at most 2,000 characters. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      artifact: z.string().describe("Artifact slug or id required when quote is given.").optional(),
+      quote: z.string().describe("Optional exact quoted document text.").optional(),
+      occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based occurrence of quote.").optional(),
+      body: z.string({ max: 2000 }).describe("Review comment, at most 2,000 characters."),
+      reply_to: z.string().describe("Optional comment id to reply to.").optional()
+    })
+  },
+  {
+    name: "dispatch_suggest",
+    description: "Propose an exact replacement for quoted document text. Do not use it for general feedback; use " + `dispatch_comment instead. Optional explanation is at most 2,000 characters. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      artifact: z.string().describe("Artifact slug or id containing the quoted text."),
+      quote: z.string().describe("Exact document text to replace."),
+      replace_with: z.string().describe("Replacement text."),
+      body: z.string({ max: 2000 }).describe("Optional rationale, at most 2,000 characters.").optional(),
+      occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based occurrence of quote.").optional()
+    })
+  },
+  {
+    name: "dispatch_message",
+    description: "Post a plain issue update. Do not use it for a decision or line-specific review; use dispatch_ask " + `or dispatch_comment instead. Body is at most 2,000 characters. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      body: z.string({ max: 2000 }).describe("Update text, at most 2,000 characters.")
+    })
+  },
+  {
+    name: "dispatch_doc_edit",
+    description: "Apply deterministic text edits to a document. Do not use it for review feedback or for reading; use " + `dispatch_comment, dispatch_suggest, or dispatch_doc_read instead. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      artifact: z.string().describe("Artifact slug or id for the document."),
+      ops: z.array(z.object({
+        op: z.enum(DOC_EDIT_OPS).describe("Edit operation."),
+        find: z.string().describe("Text to find for replace or delete.").optional(),
+        with: z.string().describe("Replacement text for replace.").optional(),
+        occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based match occurrence.").optional(),
+        markdown: z.string().describe("Markdown to insert.").optional(),
+        after: z.string().describe("Anchor after which to insert.").optional(),
+        before: z.string().describe("Anchor before which to insert.").optional()
+      })).describe("Flat tagged edits; the server validates fields required for each operation."),
+      summary: z.string().describe("Optional named-version summary.").optional()
+    })
+  },
+  {
+    name: "dispatch_doc_read",
+    description: "Read a live document or a named document version. Do not use it for issue status, asks, or events; " + "use dispatch_read instead. Supply ref or issue; issue plus an omitted artifact reads the primary document. " + `${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE).optional(),
+      artifact: z.string().describe("Optional artifact slug or id; primary document by default.").optional(),
+      version: z.number({ int: true, min: 1 }).describe("Optional version number.").optional(),
+      ref: z.string().describe("Optional dispatch:// document reference.").optional()
+    })
+  },
+  {
+    name: "dispatch_artifact",
+    description: "Upload a local file as an issue artifact. Do not use it to edit a live document; use dispatch_doc_edit " + `instead. Files are limited to 25 MiB. ${ISSUE_REFERENCE}`,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE),
+      name: z.string().describe("Artifact filename shown in Dispatch."),
+      path: z.string().describe("Local path to the file to upload."),
+      primary: z.boolean().describe("Make this document the issue primary artifact.").optional(),
+      summary: z.string().describe("Optional version summary.").optional()
+    })
+  },
+  {
+    name: "dispatch_read",
+    description: "Read an issue summary, targeted ask, or targeted comment reply chain. Do not use it for document " + "contents; use dispatch_doc_read instead. Supply issue or ref. " + ISSUE_REFERENCE,
+    arguments: (z) => ({
+      issue: z.string().describe(ISSUE_REFERENCE).optional(),
+      ref: z.string().describe("Optional dispatch:// issue reference.").optional()
+    })
+  }
+];
 // ../contracts/src/envelope.ts
 var isSubject = (value) => typeof value === "string" && value.length > 0;
 var EnvelopeSchema = object({
@@ -30235,9 +30273,6 @@ async function handleLegionControlDirective(directive, actions) {
       case "reclaim-architect":
         await actions.reclaimArchitect();
         break;
-      case "shutdown":
-        actions.requestShutdown();
-        break;
     }
     actions.acknowledge();
   } catch (error) {
@@ -30249,8 +30284,6 @@ function parseControlDirective(raw) {
   if (typeof payload !== "object" || payload === null || !("type" in payload)) {
     throw new Error("Legion control directive must be an object with a type");
   }
-  if (payload.type === "shutdown")
-    return { type: "shutdown" };
   if (payload.type === "reclaim-architect") {
     if (!("redeliver" in payload) || typeof payload.redeliver !== "object" || payload.redeliver === null || !("topic" in payload.redeliver) || typeof payload.redeliver.topic !== "string" || !("payload" in payload.redeliver) || typeof payload.redeliver.payload !== "string" || !("eventId" in payload.redeliver) || typeof payload.redeliver.eventId !== "string") {
       throw new Error("Legion control directive is missing redelivery metadata");
@@ -31245,57 +31278,20 @@ function replyWith(envelope) {
     return;
   return `envoy_send(session_id="${envelope.source_session}", message="...")`;
 }
-var DispatchEventSchema = object({
-  issue_key: string2(),
-  type: string2(),
-  actor: object({ kind: string2(), id: string2().optional() }).passthrough(),
-  payload: object({}).passthrough()
-});
-var IssuePayloadSchema = object({
-  title: string2().optional(),
-  status: string2().optional(),
-  route: string2().nullish()
-});
-var ArtifactCreatedPayloadSchema = object({
-  artifact: object({ name: string2().optional() }).optional()
-});
-var ArtifactVersionPayloadSchema = object({
-  name: string2().optional(),
-  version: object({ number: number2().optional(), summary: string2().nullish() }).optional(),
-  diff: string2().optional()
-});
-var AskPayloadSchema = object({
-  question: string2().optional(),
-  options: array(object({ label: string2().optional() })).nullish(),
-  answer: object({ selected: array(string2()).nullish(), text: string2().nullish() }).nullish()
-});
-var CommentPayloadSchema = object({
-  artifact_name: string2().optional(),
-  body: string2().optional(),
-  reply_to: string2().nullish(),
-  anchor: object({ quote: string2().optional() }).nullish(),
-  suggestion: object({ replace_with: string2().optional() }).nullish()
-});
-var MessagePayloadSchema = object({ body: string2().optional() });
-var ChildStatusPayloadSchema = object({
-  child_key: string2().optional(),
-  from: string2().optional(),
-  to: string2().optional()
-});
 var DISPATCH_PAYLOAD_SCHEMAS = {
-  "issue.created": IssuePayloadSchema,
-  "issue.updated": IssuePayloadSchema,
-  "issue.closed": IssuePayloadSchema,
-  "artifact.created": ArtifactCreatedPayloadSchema,
-  "artifact.version": ArtifactVersionPayloadSchema,
-  "ask.opened": AskPayloadSchema,
-  "ask.answered": AskPayloadSchema,
-  "comment.created": CommentPayloadSchema,
-  "comment.resolved": CommentPayloadSchema,
-  "suggestion.accepted": CommentPayloadSchema,
-  "suggestion.rejected": CommentPayloadSchema,
-  "message.created": MessagePayloadSchema,
-  "child.status": ChildStatusPayloadSchema
+  "issue.created": IssueEventPayloadSchema,
+  "issue.updated": IssueEventPayloadSchema,
+  "issue.closed": IssueEventPayloadSchema,
+  "artifact.created": ArtifactCreatedEventPayloadSchema,
+  "artifact.version": ArtifactVersionEventPayloadSchema,
+  "ask.opened": AskEventPayloadSchema,
+  "ask.answered": AskEventPayloadSchema,
+  "comment.created": CommentEventPayloadSchema,
+  "comment.resolved": CommentEventPayloadSchema,
+  "suggestion.accepted": CommentEventPayloadSchema,
+  "suggestion.rejected": CommentEventPayloadSchema,
+  "message.created": MessageEventPayloadSchema,
+  "child.status": ChildStatusEventPayloadSchema
 };
 function dispatchPayload(event) {
   const schema = DISPATCH_PAYLOAD_SCHEMAS[event.type];
@@ -31672,7 +31668,8 @@ class DispatchClient {
       form.set("primary", String(input.primary));
     if (input.summary !== undefined)
       form.set("summary", input.summary);
-    form.set("actor", JSON.stringify(input.actor));
+    if (input.actor !== undefined)
+      form.set("actor", JSON.stringify(input.actor));
     form.set("file", input.file, input.name);
     return this.#form("POST", ["api", "v1", "issues", await this.#resolveIssue(issue), "artifacts"], form);
   }
@@ -33336,7 +33333,6 @@ function legionExtension(pi) {
         }
         await handleLegionControlDirective(directive, {
           reclaimArchitect,
-          requestShutdown: () => pi.sendMessage({ type: "shutdown-request" }),
           acknowledge: () => {
             if (reply)
               connection.publish(reply, controlCodec.encode(JSON.stringify({ type: "ack" })));

package/package.json

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