@sjawhar/pi-legion-envoy 0.19.0 → 0.20.0

package/README.md

@@ -118,6 +118,10 @@ The shared contract supplies the model-facing schemas and descriptions. The
 `dispatch` skill describes when to use each operation for issues, asks, review
 feedback, documents, artifacts, and status reads.
 
+`dispatch_artifact` accepts exactly one upload source: a local `path`, or inline `content`.
+For example, an architect can post its primary specification with
+`{ issue, name: "spec.md", content: "# Design", primary: true }`.
+
 Lifecycle and scope decisions between Legion roles go through `envoy_publish` to the owning
 architect's role topic; Dispatch is for durable questions to the human and the shared
 document, not for coordination between roles.

package/dist/envoy.js

@@ -29687,6 +29687,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"];
@@ -29783,14 +29787,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",
@@ -30198,7 +30210,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
@@ -31176,6 +31199,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)
@@ -31185,7 +31211,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]);
@@ -31370,7 +31396,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")
@@ -31652,12 +31678,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}`,
@@ -32570,7 +32604,7 @@ function envoyExtension(pi) {
         name: spec.name,
         label: spec.name,
         description: spec.description,
-        parameters: pi.zod.object(spec.arguments(zodSchemaApi(pi.zod))),
+        parameters: dispatchToolSchema(spec, zodSchemaApi(pi.zod)),
         execute: async (_id, params, _signal, _onUpdate, context) => {
           try {
             const result = await executeDispatchTool({

package/dist/legion.js

@@ -29685,6 +29685,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"];
@@ -29781,14 +29785,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",
@@ -30196,7 +30208,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
@@ -31661,6 +31684,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)
@@ -31670,7 +31696,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]);
@@ -31855,7 +31881,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")
@@ -32137,12 +32163,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}`,
@@ -33047,7 +33081,7 @@ function envoyExtension(pi) {
         name: spec.name,
         label: spec.name,
         description: spec.description,
-        parameters: pi.zod.object(spec.arguments(zodSchemaApi(pi.zod))),
+        parameters: dispatchToolSchema(spec, zodSchemaApi(pi.zod)),
         execute: async (_id, params, _signal, _onUpdate, context) => {
           try {
             const result = await executeDispatchTool({

package/dist/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
 

package/package.json

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