@sjawhar/opencode-legion-envoy 0.20.0 → 0.20.1

package/dist/src/server.js

@@ -19,122 +19,6 @@ import { existsSync } from "fs";
 import path3 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, {
@@ -13667,6 +13551,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({
@@ -14319,7 +14357,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sjawhar/opencode-legion-envoy",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "type": "module",
   "main": "dist/src/server.js",
   "exports": {