@sjawhar/opencode-legion-envoy 0.20.2 → 0.22.0

package/README.md

@@ -29,6 +29,10 @@ envoy.json (`~/.config/opencode/envoy.json`, merged with `<repo>/.opencode/envoy
 the session working directory, stamps it with the OpenCode session id and title, and stores
 `details.topic` as tool metadata so a successful mutation subscribes to that exact Dispatch topic.
 
+`dispatch_artifact` accepts exactly one upload source: a local `path`, or inline `content`.
+An architect can post a primary specification directly with
+`{ issue, name: "spec.md", content: "# Design", primary: true }`.
+
 It also maintains the live session registry metadata needed for Envoy to discover OpenCode sessions and their API ports.
 
 Slack topic examples must use the real Slack `team_id`, for example:

package/dist/src/server.js

@@ -13590,6 +13590,10 @@ var ChildStatusEventPayloadSchema = object({
   to: string2().optional()
 });
 // ../contracts/src/dispatch-tools.ts
+function dispatchToolSchema(spec, z, opts) {
+  const shape = spec.arguments(z);
+  return spec.validation === undefined ? z.object(shape, opts) : z.refineObject(shape, spec.validation.check, spec.validation.message, opts);
+}
 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"];
@@ -13616,7 +13620,6 @@ var dispatchToolSpecs = [
         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."),
@@ -13687,14 +13690,22 @@ var dispatchToolSpecs = [
   },
   {
     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}`,
+    description: "Attach a local file or inline text as an issue artifact. Do not use it to edit a live document; use " + `dispatch_doc_edit instead. Exactly one of path or content is required; artifacts 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."),
+      path: z.string().describe("Local path to the file to upload.").optional(),
+      content: z.string().describe("Inline text to store as a Markdown document.").optional(),
       primary: z.boolean().describe("Make this document the issue primary artifact.").optional(),
       summary: z.string().describe("Optional version summary.").optional()
-    })
+    }),
+    validation: {
+      check: (value) => {
+        const input = value;
+        return typeof input.path === "string" !== (typeof input.content === "string");
+      },
+      message: "Exactly one of path or content is required."
+    }
   },
   {
     name: "dispatch_read",
@@ -14082,7 +14093,18 @@ function zodSchemaApi(zod) {
         schema = schema.max(opts.max);
       return schema;
     },
-    object: (shape) => api.object(shape)
+    object: (shape, opts = {}) => {
+      let schema = api.object(shape);
+      if (opts.strict)
+        schema = schema.strict();
+      return schema;
+    },
+    refineObject: (shape, check, message, opts = {}) => {
+      let schema = api.object(shape);
+      if (opts.strict)
+        schema = schema.strict();
+      return schema.refine(check, message);
+    }
   };
 }
 // ../envoy-client/src/defaults.ts
@@ -14351,6 +14373,9 @@ class DispatchClient {
     return this.#json("POST", ["api", "v1", "issues", await this.#resolveIssue(issue), "messages"], input);
   }
   async artifact(issue, input) {
+    const artifactPath = ["api", "v1", "issues", await this.#resolveIssue(issue), "artifacts"];
+    if ("content" in input)
+      return this.#json("POST", artifactPath, input);
     const form = new FormData;
     form.set("name", input.name);
     if (input.primary !== undefined)
@@ -14360,7 +14385,7 @@ class DispatchClient {
     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);
+    return this.#form("POST", artifactPath, form);
   }
   async getArtifact(id) {
     return this.#json("GET", ["api", "v1", "artifacts", id]);
@@ -14545,7 +14570,7 @@ function toolSchema(tool) {
   const spec = dispatchToolSpecs.find((candidate) => candidate.name === tool);
   if (!spec)
     throw new Error(`Unknown Dispatch tool: ${tool}`);
-  return object(spec.arguments(zodSchemaApi(exports_external))).strict();
+  return dispatchToolSchema(spec, zodSchemaApi(exports_external), { strict: true });
 }
 async function resolveIssueArguments(tool, args, cwd, env, exec) {
   if (tool === "dispatch_issue")
@@ -14722,14 +14747,12 @@ async function executeDispatchTool(input) {
       const resolved = anchorArgs ? await resolveArtifact(client, issue(), stringArg(anchorArgs, "artifact")) : undefined;
       const options = args.options;
       const multiple = optionalBoolean(args, "multiple");
-      const custom = optionalBoolean(args, "custom");
       const urgency = askUrgency(args);
       const anchored = anchorArgs && resolved ? anchor(resolved.artifact, anchorArgs) : undefined;
       const ask = await client.ask(issue(), {
         question: stringArg(args, "question"),
         ...Array.isArray(options) ? { options } : {},
         ...multiple === undefined ? {} : { multiple },
-        ...custom === undefined ? {} : { custom },
         ...urgency === undefined ? {} : { urgency },
         ...anchored === undefined ? {} : { anchor: anchored },
         actor
@@ -14829,12 +14852,20 @@ Open anchored asks/comments: ${marks.join(", ")}`,
     case "dispatch_artifact": {
       const primary = optionalBoolean(args, "primary");
       const summary = optionalString(args, "summary");
-      const result = await client.artifact(issue(), {
-        name: stringArg(args, "name"),
+      const name = stringArg(args, "name");
+      const content = optionalString(args, "content");
+      const result = await client.artifact(issue(), content === undefined ? {
+        name,
         file: Bun.file(resolvePath(input.cwd, stringArg(args, "path"))),
         ...primary === undefined ? {} : { primary },
         ...summary === undefined ? {} : { summary },
         actor
+      } : {
+        name,
+        content,
+        ...primary === undefined ? {} : { primary },
+        ...summary === undefined ? {} : { summary },
+        actor
       });
       return {
         text: `Uploaded ${result.artifact.name} as version ${result.version.number}`,

package/package.json

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

package/skills/dispatch/SKILL.md

@@ -36,7 +36,6 @@ dispatch_ask({
   question,
   options?: { label, description? }[],
   multiple?,
-  custom?,
   urgency?,
   anchor?: { artifact, quote, occurrence? },
 })
@@ -106,15 +105,22 @@ invalid actor, route, or primary artifact.
 
 ## Artifacts
 
-Attach an image, diagram, or file with:
+Attach an image, diagram, or local file with:
 
 ```ts
 dispatch_artifact({ issue, name, path, primary?, summary? })
 ```
 
-It returns `details` `{ issue, topic, artifact, version }`. `path` is the local file to upload.
-Uploading the same `name` creates its next version. Set `primary: true` only for a markdown file
-to make it the issue's spec.
+Or, when the text is already in the call, post a Markdown document directly:
+
+```ts
+dispatch_artifact({ issue, name: "spec.md", content: "# Design\n...", primary: true })
+```
+
+Exactly one of `path` and `content` is required. The inline form sends JSON with
+`Content-Type: application/json`. It returns `details` `{ issue, topic, artifact, version }`.
+Uploading the same `name` creates its next version. Use `content` for an architect's primary spec;
+set `primary: true` only for Markdown documents.
 
 ## Messages
 
@@ -191,7 +197,6 @@ dispatch_ask({
       description: "Narrows the release but requires another deployment test.",
     },
   ],
-  custom: false,
   urgency: "high",
   anchor: {
     artifact: "spec",