@sjawhar/opencode-legion-envoy 0.21.0 → 0.22.1

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"];
@@ -13686,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",
@@ -14081,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
@@ -14117,9 +14140,6 @@ var DEFAULT_SERVER_URL = "http://localhost:8766";
 function normalizeDispatchUrl(url2) {
   return url2.replace(/\/+$/, "");
 }
-function deprecatedMcpUrl(url2) {
-  return normalizeDispatchUrl(url2).replace(/\/mcp$/, "");
-}
 function parsedDispatchUrl(value, source) {
   const url2 = normalizeDispatchUrl(value);
   try {
@@ -14169,7 +14189,6 @@ function readEnvoyFile(filePath) {
 }
 function resolveDispatchConfig(env, options = {}) {
   const explicitUrl = env.DISPATCH_URL;
-  const deprecatedUrl = explicitUrl ? undefined : env.DISPATCH_MCP_URL;
   const home = options.home ?? env.HOME ?? homedir();
   const cwd = options.cwd ?? process.cwd();
   const userFile = readEnvoyFile(path.join(home, ".config", "opencode", "envoy.json"));
@@ -14183,7 +14202,7 @@ function resolveDispatchConfig(env, options = {}) {
     ...userFile.kind === "valid" ? userFile.settings : null,
     ...repoFile.kind === "valid" ? repoFile.settings : null
   };
-  const rawUrl = explicitUrl !== undefined ? { value: explicitUrl, source: "DISPATCH_URL" } : deprecatedUrl !== undefined ? { value: deprecatedMcpUrl(deprecatedUrl), source: "DISPATCH_MCP_URL" } : merged.enabled === true ? { value: merged.serverUrl ?? DEFAULT_SERVER_URL, source: "dispatch.serverUrl" } : null;
+  const rawUrl = explicitUrl !== undefined ? { value: explicitUrl, source: "DISPATCH_URL" } : merged.enabled === true ? { value: merged.serverUrl ?? DEFAULT_SERVER_URL, source: "dispatch.serverUrl" } : null;
   const url2 = rawUrl ? parsedDispatchUrl(rawUrl.value, rawUrl.source) : { url: null, error: null };
   const token = env.DISPATCH_TOKEN ?? merged.token ?? null;
   const tokenSource = env.DISPATCH_TOKEN === undefined ? "dispatch.token" : "DISPATCH_TOKEN";
@@ -14350,6 +14369,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)
@@ -14359,7 +14381,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]);
@@ -14544,7 +14566,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")
@@ -14826,12 +14848,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.21.0",
+  "version": "0.22.1",
   "type": "module",
   "main": "dist/src/server.js",
   "exports": {

package/skills/dispatch/SKILL.md

@@ -105,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