@sjawhar/opencode-legion-envoy 0.37.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

@@ -13553,7 +13553,9 @@ function date4(params) {
 config(en_default());
 // ../contracts/src/dispatch-api.ts
 var DispatchEventSchema = object({
-  issue_key: string2(),
+  issue_key: string2().nullable(),
+  artifact_id: string2().nullish(),
+  project: string2().optional(),
   type: string2(),
   actor: object({ kind: string2(), id: string2().optional() }).passthrough(),
   payload: object({}).passthrough()
@@ -13571,7 +13573,7 @@ var ArtifactVersionEventPayloadSchema = object({
   version: object({ number: number2().optional(), summary: string2().nullish() }).optional(),
   diff: string2().optional()
 });
-var AskEventPayloadSchema = object({
+var askEventPayloadFields = {
   opened_event_id: number2().int().positive(),
   question: string2().optional(),
   options: array(object({ label: string2().optional() })).nullish(),
@@ -13582,6 +13584,23 @@ var AskEventPayloadSchema = object({
     actor: object({ kind: string2().optional(), id: string2().optional() }).passthrough().optional(),
     at: string2().optional()
   }).nullish()
+};
+var AskEventPayloadSchema = intersection(object(askEventPayloadFields), object({
+  previous: never().optional(),
+  edited_by: never().optional()
+}));
+var AskEditedEventPayloadSchema = object({
+  ...askEventPayloadFields,
+  multiple: boolean2(),
+  urgency: string2(),
+  edited_at: string2().nullish(),
+  previous: object({
+    question: string2(),
+    options: array(object({ label: string2().optional() })),
+    multiple: boolean2(),
+    urgency: string2()
+  }),
+  edited_by: object({ kind: string2(), id: string2() }).passthrough()
 });
 var CommentEventPayloadSchema = object({
   artifact_name: string2().optional(),
@@ -13698,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.",
@@ -14463,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);
   }
@@ -14619,7 +14662,29 @@ 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 {
+      issue: ask.issue_key,
+      topic: dispatchIssueSubject(ask.issue_key, ">"),
+      ask: ask.id
+    };
+  }
+  if (ask.artifact_id === undefined || ask.artifact_id === null) {
+    throw new Error("document ask is missing its artifact ID");
+  }
+  const artifact = await client.getArtifact(ask.artifact_id);
+  return {
+    topic: `notifications.dispatch.document.${artifact.project}.${artifact.slug}.>`,
+    ask: ask.id
+  };
+}
 function canonicalExternalIssueRef(value) {
   const match = value.trim().match(externalIssueRefPattern);
   return match ? `${canonicalRepo(match[1] ?? "", match[2] ?? "")}#${match[3]}` : value;
@@ -14690,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)
@@ -14935,11 +15010,7 @@ async function executeDispatchTool(input) {
         throw new Error("resolved ask is missing its resolution");
       return {
         text: `${kind === "retracted" ? "Retracted" : "Resolved"} ask ${ask.id}: ${ask.resolution.reason}`,
-        details: {
-          issue: ask.issue_key,
-          topic: dispatchIssueSubject(ask.issue_key, ">"),
-          ask: ask.id
-        }
+        details: await askResultDetails(client, ask)
       };
     }
     case "dispatch_ask": {
@@ -14959,11 +15030,24 @@ async function executeDispatchTool(input) {
       });
       return {
         text: `Opened ask ${ask.id}: ${ask.question}`,
-        details: {
-          issue: ask.issue_key,
-          topic: dispatchIssueSubject(ask.issue_key, ">"),
-          ask: ask.id
-        }
+        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": {
@@ -15088,7 +15172,7 @@ Open anchored asks/comments: ${marks.join(", ")}`,
         const askRead = await client.getAsk(issueArguments.ref.id);
         return {
           text: askSummary(askRead),
-          details: { issue: askRead.ask.issue_key }
+          details: { issue: issueArguments.ref.issue }
         };
       }
       if (issueArguments.ref?.kind === "comment") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sjawhar/opencode-legion-envoy",
-  "version": "0.37.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
@@ -141,11 +155,16 @@ type EditOp = {
 };
 ```
 
-Target edits by quote: `replace` requires `find` and `with`; `delete` requires `find`; `insert`
-requires `markdown` and exactly one of `after` or `before`. An insert anchor is a quote,
-`"start"`, `"end"`, or `"heading:Title"`. Use zero-based `occurrence` for a repeated `find`.
-When a decision lands, pass `summary` to name the resulting version. Never paste progress into a
-message.
+Target `replace` and `delete` by the document's plain text: inline-code and link text match
+without Markdown syntax, and a table-cell anchor is its cell text. `replace` requires `find` and
+`with`; `delete` requires `find`; `insert` requires `markdown` and exactly one of `after` or
+`before`. An insert anchor is a quote, `"start"`, `"end"`, or `"heading:Title"`. Every insert
+creates a sibling block before or after the quote or heading's enclosing document block; `"start"`
+and `"end"` select the document edges. At a table-cell quote, pipe-table body-row fragments extend
+that table before or after the matched row; omit table header and delimiter rows, and do not exceed
+the table width. Use `replace` for inline continuation. Use zero-based `occurrence` for a repeated
+target. When a decision lands, pass `summary` to name the resulting version. Never paste progress
+into a message.
 
 ## Comments and suggestions