@sjawhar/opencode-legion-envoy 1.9.0 → 1.10.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(),
@@ -13835,7 +13845,7 @@ 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()
     })
   },
   {
@@ -14998,13 +15008,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 +15462,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}`;
@@ -15790,6 +15800,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 +15909,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.10.0",
   "type": "module",
   "main": "dist/src/server.js",
   "exports": {

package/skills/dispatch/SKILL.md

@@ -298,6 +298,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