@sjawhar/pi-legion-envoy 0.20.2 → 0.21.0

package/dist/envoy.js

@@ -29930,6 +29930,10 @@ var handoffMessageSchema = object({
 // ../contracts/src/subject.ts
 var AGENT_TOPIC_PREFIX = "notifications.agent.";
 var ROLE_TOPIC_PREFIX = "notifications.role.";
+var DISPATCH_ISSUE_TOPIC_PREFIX = "notifications.dispatch.issue.";
+function dispatchIssueSubject(issueKey, type) {
+  return `${DISPATCH_ISSUE_TOPIC_PREFIX}${issueKey}.${type}`;
+}
 function agentSubject(session) {
   return `${AGENT_TOPIC_PREFIX}${session}`;
 }
@@ -30838,7 +30842,10 @@ function parseDispatchFrame(rawPayload) {
     return { raw: rawPayload };
   }
   const parsed = DispatchEventSchema.safeParse(value);
-  return parsed.success ? { event: parsed.data } : { raw: value };
+  if (!parsed.success)
+    return { raw: value };
+  const wireEvent = value;
+  return { event: parsed.data, notify: wireEvent.notify };
 }
 function inboundTimestamp(milliseconds) {
   if (milliseconds === undefined)
@@ -30883,6 +30890,9 @@ function renderInbound(raw, sessionID, subject) {
     } else {
       const frame = parseDispatchFrame(envelope.payload);
       if ("event" in frame) {
+        if (frame.notify === false && (subject ?? envelope.topic)?.startsWith(DISPATCH_ISSUE_TOPIC_PREFIX) === true) {
+          return { skip: true, content: "", envelope };
+        }
         if (frame.event.actor.kind === "session" && frame.event.actor.id === sessionID) {
           return { skip: true, content: "", envelope };
         }
@@ -31336,9 +31346,6 @@ 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]*$/;
-function dispatchTopic(issue) {
-  return `notifications.dispatch.issue.${issue}.>`;
-}
 function stringArg(args, name) {
   const value = args[name];
   if (typeof value !== "string")
@@ -31561,7 +31568,7 @@ async function executeDispatchTool(input) {
       });
       return {
         text: `Created ${created.key}: ${created.title}`,
-        details: { issue: created.key, topic: dispatchTopic(created.key) }
+        details: { issue: created.key, topic: dispatchIssueSubject(created.key, ">") }
       };
     }
     case "dispatch_ask": {
@@ -31581,7 +31588,11 @@ async function executeDispatchTool(input) {
       });
       return {
         text: `Opened ask ${ask.id}: ${ask.question}`,
-        details: { issue: ask.issue_key, topic: dispatchTopic(ask.issue_key), ask: ask.id }
+        details: {
+          issue: ask.issue_key,
+          topic: dispatchIssueSubject(ask.issue_key, ">"),
+          ask: ask.id
+        }
       };
     }
     case "dispatch_comment": {
@@ -31602,7 +31613,7 @@ async function executeDispatchTool(input) {
         text: `Posted comment ${comment.id}`,
         details: {
           issue: comment.issue_key,
-          topic: dispatchTopic(comment.issue_key),
+          topic: dispatchIssueSubject(comment.issue_key, ">"),
           comment: comment.id
         }
       };
@@ -31623,7 +31634,7 @@ async function executeDispatchTool(input) {
         text: `Posted suggestion ${comment.id}`,
         details: {
           issue: comment.issue_key,
-          topic: dispatchTopic(comment.issue_key),
+          topic: dispatchIssueSubject(comment.issue_key, ">"),
           comment: comment.id
         }
       };
@@ -31634,7 +31645,7 @@ async function executeDispatchTool(input) {
         text: `Posted message ${message.id}`,
         details: {
           issue: message.issue_key,
-          topic: dispatchTopic(message.issue_key),
+          topic: dispatchIssueSubject(message.issue_key, ">"),
           message: message.id
         }
       };
@@ -31652,7 +31663,7 @@ async function executeDispatchTool(input) {
         text: edited.version === null ? `Applied ${edited.applied} ops (no new version)` : `Applied ${edited.applied} ops (version ${edited.version.number})`,
         details: {
           issue: resolved.issue.key,
-          topic: dispatchTopic(resolved.issue.key),
+          topic: dispatchIssueSubject(resolved.issue.key, ">"),
           applied: edited.applied,
           ...edited.version === null ? {} : { version: edited.version.number }
         }
@@ -31668,7 +31679,10 @@ async function executeDispatchTool(input) {
         text: marks.length === 0 ? document.markdown : `${document.markdown}
 
 Open anchored asks/comments: ${marks.join(", ")}`,
-        details: { issue: resolved.issue.key, topic: dispatchTopic(resolved.issue.key) }
+        details: {
+          issue: resolved.issue.key,
+          topic: dispatchIssueSubject(resolved.issue.key, ">")
+        }
       };
     }
     case "dispatch_artifact": {
@@ -31693,7 +31707,7 @@ Open anchored asks/comments: ${marks.join(", ")}`,
         text: `Uploaded ${result.artifact.name} as version ${result.version.number}`,
         details: {
           issue: result.artifact.issue_key,
-          topic: dispatchTopic(result.artifact.issue_key),
+          topic: dispatchIssueSubject(result.artifact.issue_key, ">"),
           artifact: result.artifact.id,
           version: result.version.number
         }
@@ -31704,7 +31718,7 @@ Open anchored asks/comments: ${marks.join(", ")}`,
         const ask = await client.getAsk(issueArguments.ref.id);
         return {
           text: askSummary(ask),
-          details: { issue: ask.issue_key, topic: dispatchTopic(ask.issue_key) }
+          details: { issue: ask.issue_key, topic: dispatchIssueSubject(ask.issue_key, ">") }
         };
       }
       if (issueArguments.ref?.kind === "comment") {
@@ -31713,7 +31727,7 @@ Open anchored asks/comments: ${marks.join(", ")}`,
           text: commentSummary(comment),
           details: {
             issue: comment.comment.issue_key,
-            topic: dispatchTopic(comment.comment.issue_key)
+            topic: dispatchIssueSubject(comment.comment.issue_key, ">")
           }
         };
       }
@@ -31721,18 +31735,18 @@ Open anchored asks/comments: ${marks.join(", ")}`,
       if (issueArguments.ref?.kind === "log") {
         return {
           text: logSummary(read.issue, read.events),
-          details: { issue: read.issue.key, topic: dispatchTopic(read.issue.key) }
+          details: { issue: read.issue.key, topic: dispatchIssueSubject(read.issue.key, ">") }
         };
       }
       if (issueArguments.ref?.kind === "children") {
         return {
           text: childrenSummary(read.issue),
-          details: { issue: read.issue.key, topic: dispatchTopic(read.issue.key) }
+          details: { issue: read.issue.key, topic: dispatchIssueSubject(read.issue.key, ">") }
         };
       }
       return {
         text: issueSummary(read.issue, read.events),
-        details: { issue: read.issue.key, topic: dispatchTopic(read.issue.key) }
+        details: { issue: read.issue.key, topic: dispatchIssueSubject(read.issue.key, ">") }
       };
     }
     default:

package/dist/legion.js

@@ -29928,6 +29928,10 @@ var handoffMessageSchema = object({
 // ../contracts/src/subject.ts
 var AGENT_TOPIC_PREFIX = "notifications.agent.";
 var ROLE_TOPIC_PREFIX = "notifications.role.";
+var DISPATCH_ISSUE_TOPIC_PREFIX = "notifications.dispatch.issue.";
+function dispatchIssueSubject(issueKey, type) {
+  return `${DISPATCH_ISSUE_TOPIC_PREFIX}${issueKey}.${type}`;
+}
 function agentSubject(session) {
   return `${AGENT_TOPIC_PREFIX}${session}`;
 }
@@ -31330,7 +31334,10 @@ function parseDispatchFrame(rawPayload) {
     return { raw: rawPayload };
   }
   const parsed = DispatchEventSchema.safeParse(value);
-  return parsed.success ? { event: parsed.data } : { raw: value };
+  if (!parsed.success)
+    return { raw: value };
+  const wireEvent = value;
+  return { event: parsed.data, notify: wireEvent.notify };
 }
 function inboundTimestamp(milliseconds) {
   if (milliseconds === undefined)
@@ -31375,6 +31382,9 @@ function renderInbound(raw, sessionID, subject) {
     } else {
       const frame = parseDispatchFrame(envelope.payload);
       if ("event" in frame) {
+        if (frame.notify === false && (subject ?? envelope.topic)?.startsWith(DISPATCH_ISSUE_TOPIC_PREFIX) === true) {
+          return { skip: true, content: "", envelope };
+        }
         if (frame.event.actor.kind === "session" && frame.event.actor.id === sessionID) {
           return { skip: true, content: "", envelope };
         }
@@ -31821,9 +31831,6 @@ 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]*$/;
-function dispatchTopic(issue) {
-  return `notifications.dispatch.issue.${issue}.>`;
-}
 function stringArg(args, name) {
   const value = args[name];
   if (typeof value !== "string")
@@ -32046,7 +32053,7 @@ async function executeDispatchTool(input) {
       });
       return {
         text: `Created ${created.key}: ${created.title}`,
-        details: { issue: created.key, topic: dispatchTopic(created.key) }
+        details: { issue: created.key, topic: dispatchIssueSubject(created.key, ">") }
       };
     }
     case "dispatch_ask": {
@@ -32066,7 +32073,11 @@ async function executeDispatchTool(input) {
       });
       return {
         text: `Opened ask ${ask.id}: ${ask.question}`,
-        details: { issue: ask.issue_key, topic: dispatchTopic(ask.issue_key), ask: ask.id }
+        details: {
+          issue: ask.issue_key,
+          topic: dispatchIssueSubject(ask.issue_key, ">"),
+          ask: ask.id
+        }
       };
     }
     case "dispatch_comment": {
@@ -32087,7 +32098,7 @@ async function executeDispatchTool(input) {
         text: `Posted comment ${comment.id}`,
         details: {
           issue: comment.issue_key,
-          topic: dispatchTopic(comment.issue_key),
+          topic: dispatchIssueSubject(comment.issue_key, ">"),
           comment: comment.id
         }
       };
@@ -32108,7 +32119,7 @@ async function executeDispatchTool(input) {
         text: `Posted suggestion ${comment.id}`,
         details: {
           issue: comment.issue_key,
-          topic: dispatchTopic(comment.issue_key),
+          topic: dispatchIssueSubject(comment.issue_key, ">"),
           comment: comment.id
         }
       };
@@ -32119,7 +32130,7 @@ async function executeDispatchTool(input) {
         text: `Posted message ${message.id}`,
         details: {
           issue: message.issue_key,
-          topic: dispatchTopic(message.issue_key),
+          topic: dispatchIssueSubject(message.issue_key, ">"),
           message: message.id
         }
       };
@@ -32137,7 +32148,7 @@ async function executeDispatchTool(input) {
         text: edited.version === null ? `Applied ${edited.applied} ops (no new version)` : `Applied ${edited.applied} ops (version ${edited.version.number})`,
         details: {
           issue: resolved.issue.key,
-          topic: dispatchTopic(resolved.issue.key),
+          topic: dispatchIssueSubject(resolved.issue.key, ">"),
           applied: edited.applied,
           ...edited.version === null ? {} : { version: edited.version.number }
         }
@@ -32153,7 +32164,10 @@ async function executeDispatchTool(input) {
         text: marks.length === 0 ? document.markdown : `${document.markdown}
 
 Open anchored asks/comments: ${marks.join(", ")}`,
-        details: { issue: resolved.issue.key, topic: dispatchTopic(resolved.issue.key) }
+        details: {
+          issue: resolved.issue.key,
+          topic: dispatchIssueSubject(resolved.issue.key, ">")
+        }
       };
     }
     case "dispatch_artifact": {
@@ -32178,7 +32192,7 @@ Open anchored asks/comments: ${marks.join(", ")}`,
         text: `Uploaded ${result.artifact.name} as version ${result.version.number}`,
         details: {
           issue: result.artifact.issue_key,
-          topic: dispatchTopic(result.artifact.issue_key),
+          topic: dispatchIssueSubject(result.artifact.issue_key, ">"),
           artifact: result.artifact.id,
           version: result.version.number
         }
@@ -32189,7 +32203,7 @@ Open anchored asks/comments: ${marks.join(", ")}`,
         const ask = await client.getAsk(issueArguments.ref.id);
         return {
           text: askSummary(ask),
-          details: { issue: ask.issue_key, topic: dispatchTopic(ask.issue_key) }
+          details: { issue: ask.issue_key, topic: dispatchIssueSubject(ask.issue_key, ">") }
         };
       }
       if (issueArguments.ref?.kind === "comment") {
@@ -32198,7 +32212,7 @@ Open anchored asks/comments: ${marks.join(", ")}`,
           text: commentSummary(comment),
           details: {
             issue: comment.comment.issue_key,
-            topic: dispatchTopic(comment.comment.issue_key)
+            topic: dispatchIssueSubject(comment.comment.issue_key, ">")
           }
         };
       }
@@ -32206,18 +32220,18 @@ Open anchored asks/comments: ${marks.join(", ")}`,
       if (issueArguments.ref?.kind === "log") {
         return {
           text: logSummary(read.issue, read.events),
-          details: { issue: read.issue.key, topic: dispatchTopic(read.issue.key) }
+          details: { issue: read.issue.key, topic: dispatchIssueSubject(read.issue.key, ">") }
         };
       }
       if (issueArguments.ref?.kind === "children") {
         return {
           text: childrenSummary(read.issue),
-          details: { issue: read.issue.key, topic: dispatchTopic(read.issue.key) }
+          details: { issue: read.issue.key, topic: dispatchIssueSubject(read.issue.key, ">") }
         };
       }
       return {
         text: issueSummary(read.issue, read.events),
-        details: { issue: read.issue.key, topic: dispatchTopic(read.issue.key) }
+        details: { issue: read.issue.key, topic: dispatchIssueSubject(read.issue.key, ">") }
       };
     }
     default:

package/dist/skills/dispatch/SKILL.md

@@ -141,8 +141,8 @@ A write result's `details.topic` subscribes the host to the issue. Events render
 dispatch <KEY> · <type> · by <actor>
 ```
 
-Human-authored events reach you, except an unnamed artifact version; child-status events also
-reach you. Session-authored events never wake sessions. After a restart, catch up with:
+The issue topic carries every Dispatch event; `notify` only controls agent wake and routed delivery.
+After a restart, catch up with:
 
 ```ts
 dispatch_read({ issue?, ref? })

package/package.json

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