@sjawhar/pi-legion-envoy 0.18.3 → 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"];
@@ -29713,7 +29717,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."),
@@ -29784,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",
@@ -30199,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
@@ -31177,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)
@@ -31186,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]);
@@ -31371,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")
@@ -31548,14 +31573,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
@@ -31655,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}`,
@@ -32573,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"];
@@ -29711,7 +29715,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."),
@@ -29782,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",
@@ -30197,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
@@ -31662,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)
@@ -31671,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]);
@@ -31856,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")
@@ -32033,14 +32058,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
@@ -32140,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}`,
@@ -33050,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

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

package/package.json

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