@sjawhar/opencode-legion-envoy 1.9.0 → 1.11.0

package/dist/src/server.js

@@ -13633,10 +13633,20 @@ var CommentEventPayloadSchema = object({
 var MessageEventPayloadSchema = object({
   id: string2().optional(),
   body: string2().optional(),
-  reply_to: string2().nullish(),
+  target: string2().nullish(),
+  in_reply_to: string2().nullish(),
   reply_body: string2().optional(),
   author: object({ kind: string2(), id: string2() }).optional()
 });
+var MessageDeliveryEventPayloadSchema = object({
+  message_id: string2().optional(),
+  attempt: number2().int().positive().optional(),
+  delivery: _enum2(["btw", "aside", "steer"]).optional(),
+  session_id: string2().optional(),
+  title: string2().optional(),
+  state: _enum2(["sent", "failed"]).optional(),
+  error: string2().optional()
+});
 var ChildStatusEventPayloadSchema = object({
   child_key: string2().optional(),
   from: string2().optional(),
@@ -13730,7 +13740,7 @@ var SPEC_SECTIONS = [
 ];
 var SPEC_WRITING_GUIDANCE = `When writing a spec, use these sections in order: ${SPEC_SECTIONS.join(", ")}. ` + "Write for a reader who has not seen the code: plain sentences, every identifier expanded on " + "first use, no coined shorthand; see skills/dispatch Writing for the human and Writing a spec.";
 var ASK_URGENCIES = ["low", "med", "high", "blocking"];
-var DOC_EDIT_OPS = ["replace", "delete", "insert"];
+var DOC_EDIT_OPS = ["replace", "delete", "insert", "retype"];
 var dispatchToolSpecs = [
   {
     name: "dispatch_issue",
@@ -13835,12 +13845,12 @@ var dispatchToolSpecs = [
     arguments: (z) => ({
       issue: z.string().describe(ISSUE_REFERENCE),
       body: z.string({ max: 2000 }).describe("Update text, at most 2,000 characters."),
-      reply_to: z.string().describe("Optional message id or dispatch://KEY/message/<id> reference to reply to, threading " + "this message under it so the reply stays with the original in the Conversation.").optional()
+      in_reply_to: z.string().describe("Optional message id or dispatch://KEY/message/<id> reference to reply to, threading " + "this message under it so the reply stays with the original in the Conversation.").optional()
     })
   },
   {
     name: "dispatch_doc_edit",
-    description: "Apply deterministic text edits to an issue or project document. Do not use it for review feedback or for reading; use " + "dispatch_comment, dispatch_suggest, or dispatch_doc_read instead. The spec (or any document) holds requirements, " + `design, and decisions - never progress, status, or timestamps. ${OWNER_REFERENCE} ${SPEC_WRITING_GUIDANCE}`,
+    description: "Apply deterministic document edits, including retyping an identified paragraph into a schema-declared typed block. " + "Do not use it for review feedback or for reading; use dispatch_comment, dispatch_suggest, or dispatch_doc_read instead. " + `The spec (or any document) holds requirements, design, and decisions - never progress, status, or timestamps. ${OWNER_REFERENCE} ${SPEC_WRITING_GUIDANCE}`,
     arguments: (z) => ({
       issue: z.string().describe(ISSUE_REFERENCE).optional(),
       project: z.string().describe("Project key owning the document.").optional(),
@@ -13853,7 +13863,10 @@ var dispatchToolSpecs = [
         occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based match occurrence.").optional(),
         markdown: z.string().describe("Markdown to insert.").optional(),
         after: z.string().describe("Anchor after which to insert.").optional(),
-        before: z.string().describe("Anchor before which to insert.").optional()
+        before: z.string().describe("Anchor before which to insert.").optional(),
+        block: z.string().describe("Block id to retype.").optional(),
+        type: z.string().describe("Typed block name for retype.").optional(),
+        attributes: z.unknown().describe("Typed block attributes for retype.").optional()
       })).describe("Flat tagged edits; the server validates fields required for each operation."),
       summary: z.string().describe("Optional named-version summary.").optional()
     }),
@@ -14297,6 +14310,7 @@ function zodSchemaApi(zod) {
     },
     boolean: () => api.boolean(),
     enum: (values) => api.enum(values),
+    unknown: () => api.unknown(),
     array: (item, opts = {}) => {
       let schema = api.array(item);
       if (opts.min !== undefined)
@@ -14998,13 +15012,13 @@ function askId(args) {
   }
   return reference.id;
 }
-function messageReplyTo(args) {
-  const replyTo = optionalString(args, "reply_to");
-  if (replyTo === undefined || !replyTo.startsWith("dispatch://"))
-    return replyTo;
-  const reference = parseDispatchRef(replyTo);
+function messageInReplyTo(args) {
+  const inReplyTo = optionalString(args, "in_reply_to");
+  if (inReplyTo === undefined || !inReplyTo.startsWith("dispatch://"))
+    return inReplyTo;
+  const reference = parseDispatchRef(inReplyTo);
   if (reference?.kind !== "message") {
-    throw new Error("reply_to must be a bare message id or a dispatch://.../message/<id> reference");
+    throw new Error("in_reply_to must be a bare message id or a dispatch://.../message/<id> reference");
   }
   return reference.id;
 }
@@ -15452,10 +15466,10 @@ async function executeDispatchTool(input) {
       };
     }
     case "dispatch_message": {
-      const replyTo = messageReplyTo(args);
+      const inReplyTo = messageInReplyTo(args);
       const message = await client.message(issue(), {
         body: stringArg(args, "body"),
-        ...replyTo === undefined ? {} : { reply_to: replyTo },
+        ...inReplyTo === undefined ? {} : { in_reply_to: inReplyTo },
         actor
       });
       const messageRef = `dispatch://${message.issue_key}/message/${message.id}`;
@@ -15477,8 +15491,10 @@ async function executeDispatchTool(input) {
         ...summary === undefined ? {} : { summary },
         actor
       });
+      const retyped = ops.filter((operation) => operation.op === "retype").length;
+      const versionText = edited.version === null ? "no new version" : `version ${edited.version.number}`;
       return {
-        text: edited.version === null ? `Applied ${edited.applied} ops (no new version)` : `Applied ${edited.applied} ops (version ${edited.version.number})`,
+        text: retyped === 0 ? `Applied ${edited.applied} ops (${versionText})` : `Applied ${edited.applied} ops; retyped ${retyped} block${retyped === 1 ? "" : "s"} (${versionText})`,
         details: writeResultDetails(resolved, {
           applied: edited.applied,
           ...edited.version === null ? {} : { version: edited.version.number }
@@ -15790,6 +15806,7 @@ var SessionWireSchema = object({
   title: string2(),
   topics: array(string2()),
   roles: array(string2()).optional(),
+  capabilities: array(string2()).optional(),
   self_subscribed: boolean2(),
   last_seen: number2().int().optional()
 });
@@ -15898,6 +15915,7 @@ function createEnvoyClient(config) {
       topics: expandSubscriptionTopics(input.topics),
       port: input.port,
       title: input.title,
+      ...input.capabilities === undefined ? {} : { capabilities: input.capabilities },
       driving: input.driving,
       ...input.selfSubscribed === undefined ? {} : { self_subscribed: input.selfSubscribed }
     }))),

package/package.json

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

package/skills/dispatch/SKILL.md

@@ -199,13 +199,16 @@ exact `EditOp` shape:
 
 ```ts
 type EditOp = {
-  op: "replace" | "delete" | "insert";
+  op: "replace" | "delete" | "insert" | "retype";
   find?: string;
   with?: string;
   occurrence?: number;
   markdown?: string;
   after?: string;
   before?: string;
+  block?: string;
+  type?: string;
+  attributes?: Record<string, unknown>;
 };
 ```
 
@@ -221,6 +224,9 @@ and deleting a cell's quoted text removes only that text.
 
 Use `replace` for inline continuation. Use zero-based `occurrence` for a repeated target; re-read a missing or ambiguous target before
 retrying. Pass `summary` to name the version when recording a decision.
+`retype` turns the paragraph with `block` into the named typed `type` in place. It keeps the
+block id and uses `attributes` for client-owned typed attributes. Use it when an existing
+paragraph is the question that should become a decision.
 
 ## Typed blocks
 
@@ -236,6 +242,19 @@ quoted: `:::callout{kind="warning" title="Risk"}`. Do not write Pandoc-style `::
 block. Do not set attributes the schema marks `server: true`; the server ignores them and reasserts
 its authoritative value at settlement.
 
+Questions about a document must be `ask` blocks, never an `Open questions` prose section. An ask
+body is one or more question paragraphs followed by an optional bullet list of options, where each
+item is `Label: description`. For example:
+
+```md
+:::ask{urgency="high" multiple="false"}
+Should we ship the migration?
+
+- Ship: Release the verified change.
+- Hold: Wait for another review.
+:::
+```
+
 ## Comments and suggestions
 
 Add feedback with:
@@ -298,6 +317,24 @@ dispatch_message({ issue, body })
 It returns `details` `{ issue, topic, message }`. `body` is capped at 2,000 characters. A message is not a decision
 (`dispatch_ask`) or document feedback (`dispatch_comment`), and it does not wake anyone unless the issue is routed.
 
+### Targeted agent messages
+
+A human can target the issue message at a live Envoy session or role as **BTW**, **Aside**, or
+**Steer**. The incoming Dispatch frame names the issue and includes a `reply_with` instruction;
+reply on the same open issue with the existing tool, never a new targeted send:
+
+```ts
+dispatch_message({
+  issue: "CORE-1",
+  in_reply_to: "<targeted-message-id>",
+  body: "The requested answer.",
+})
+```
+
+`in_reply_to` correlates the answer under the human's message in its Conversation card. A BTW
+delivery can post its answer automatically; use this call when the frame asks the primary agent to
+reply. Agent bearers cannot set `target` or `delivery`.
+
 ## What comes back
 
 A write result's `details.topic` subscribes the host to its owner, and the first such subscription on an issue or document also tells