@sjawhar/opencode-legion-envoy 0.38.0 → 0.39.0

package/README.md

@@ -14,6 +14,7 @@ This package exposes:
 - `envoy_sessions`
 - `dispatch_issue`
 - `dispatch_ask`
+- `dispatch_edit_ask`
 - `dispatch_resolve_ask`
 - `dispatch_comment`
 - `dispatch_suggest`
@@ -24,7 +25,7 @@ This package exposes:
 - `dispatch_read`
 - `dispatch_search`
 
-The eleven native `dispatch_*` tools create and read Dispatch issues, asks, comments,
+The twelve native `dispatch_*` tools create and read Dispatch issues, asks, comments,
 documents, and artifacts, or search all of them. They are present when `dispatch.enabled`
 resolves a server URL and bearer token from envoy.json (`~/.config/opencode/envoy.json`, merged
 with `<repo>/.opencode/envoy.json`) or the `DISPATCH_URL` and `DISPATCH_TOKEN` environment

package/dist/src/server.js

@@ -13717,6 +13717,27 @@ var dispatchToolSpecs = [
       }).describe("Optional document location for the question.").optional()
     })
   },
+  {
+    name: "dispatch_edit_ask",
+    description: "Edit an open question in place. Use it to correct or refine the same decision; retract the " + "old ask and open a new one when the decision itself changes. Previous text remains in the " + "event log. Only the asking session can edit it; answered or resolved asks cannot be edited.",
+    arguments: (z) => ({
+      ask: z.string().describe("Ask id to edit."),
+      question: z.string({ max: 800 }).describe("Replacement decision question, at most 800 characters.").optional(),
+      options: z.array(z.object({
+        label: z.string().describe("Selectable option label."),
+        description: z.string().describe("Optional option context.").optional()
+      }), { max: 8 }).describe("Replacement choices, at most 8.").optional(),
+      multiple: z.boolean().describe("Whether multiple choices may be selected.").optional(),
+      urgency: z.enum(ASK_URGENCIES).describe("Replacement decision urgency.").optional()
+    }),
+    validation: {
+      check: (value) => {
+        const input = value;
+        return typeof input.question === "string" || Array.isArray(input.options) || typeof input.multiple === "boolean" || typeof input.urgency === "string";
+      },
+      message: "Ask edit requires at least one field besides ask."
+    }
+  },
   {
     name: "dispatch_resolve_ask",
     description: "Retract an open question that is moot or resolve one after finding the answer. This closes the question without answering it.",
@@ -14482,6 +14503,9 @@ class DispatchClient {
   async resolveAsk(id, input) {
     return this.#json("POST", ["api", "v1", "asks", id, "resolve"], input);
   }
+  async editAsk(id, input) {
+    return this.#json("PATCH", ["api", "v1", "asks", id], input);
+  }
   async comment(issue, input) {
     return this.#json("POST", ["api", "v1", "issues", await this.#resolveIssue(issue), "comments"], input);
   }
@@ -14638,7 +14662,12 @@ class DispatchClient {
 var nativeIssueKeyPattern = /^[A-Z][A-Z0-9]{1,9}-[0-9]+$/;
 var externalIssueRefPattern = /^([^/\s]+)\/([^/\s#]+)#([1-9][0-9]*)$/;
 var bareIssueNumberPattern = /^[1-9][0-9]*$/;
-var issueFreeTools = new Set(["dispatch_issue", "dispatch_resolve_ask", "dispatch_search"]);
+var issueFreeTools = new Set([
+  "dispatch_issue",
+  "dispatch_edit_ask",
+  "dispatch_resolve_ask",
+  "dispatch_search"
+]);
 async function askResultDetails(client, ask) {
   if (ask.issue_key !== null) {
     return {
@@ -14726,6 +14755,16 @@ function parseDispatchRef(ref) {
     return { issue, kind: "comment", id: comment };
   return { issue, kind: "issue", id: issue };
 }
+function askId(args) {
+  const ask = stringArg(args, "ask");
+  if (!ask.startsWith("dispatch://"))
+    return ask;
+  const reference = parseDispatchRef(ask);
+  if (reference?.kind !== "ask") {
+    throw new Error("ask must be a bare ask id or a dispatch://.../ask/<id> reference");
+  }
+  return reference.id;
+}
 function toolSchema(tool) {
   const spec = dispatchToolSpecs.find((candidate) => candidate.name === tool);
   if (!spec)
@@ -14994,6 +15033,23 @@ async function executeDispatchTool(input) {
         details: await askResultDetails(client, ask)
       };
     }
+    case "dispatch_edit_ask": {
+      const question = optionalString(args, "question");
+      const options = args.options;
+      const multiple = optionalBoolean(args, "multiple");
+      const urgency = askUrgency(args);
+      const ask = await client.editAsk(askId(args), {
+        ...question === undefined ? {} : { question },
+        ...Array.isArray(options) ? { options } : {},
+        ...multiple === undefined ? {} : { multiple },
+        ...urgency === undefined ? {} : { urgency },
+        actor
+      });
+      return {
+        text: `Ask edited: ${ask.question}`,
+        details: await askResultDetails(client, ask)
+      };
+    }
     case "dispatch_comment": {
       const artifactReference = optionalString(args, "artifact");
       if (optionalString(args, "quote") !== undefined && artifactReference === undefined) {

package/package.json

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

package/skills/dispatch/SKILL.md

@@ -94,6 +94,20 @@ accepts `{ artifact, mark_id }` from a browser that has already written its mark
 use the quote form. An anchor whose quote disappears becomes orphaned but remains readable against
 its original document version.
 
+Correct or refine an open ask in place instead of opening a second question:
+```ts
+dispatch_edit_ask({
+  ask,
+  question?,
+  options?: { label, description? }[],
+  multiple?,
+  urgency?,
+})
+```
+At least one field besides `ask` is required. Use this only while the same decision remains
+open: it keeps the prior text in the event log. An answered or resolved ask cannot be edited.
+If the decision is moot or superseded, retract the old ask and open a new one.
+
 An ask stays open until a human answers, unless its question no longer needs that answer. Retract a
 moot or superseded question, or self-resolve one after finding the answer:
 ```ts