@sjawhar/pi-legion-envoy 0.43.0 → 0.44.0

package/dist/envoy.js

@@ -29725,6 +29725,11 @@ var ChildStatusEventPayloadSchema = object({
   from: string2().optional(),
   to: string2().optional()
 });
+var SubscriptionRemovedEventPayloadSchema = object({
+  session_id: string2().optional(),
+  by: object({ kind: string2(), id: string2().optional() }).passthrough().optional(),
+  topics: array(string2()).optional()
+});
 // ../contracts/src/dispatch-snippet.ts
 var HTML_ENTITIES = [
   ["&lt;", "<"],
@@ -31107,6 +31112,18 @@ function renderInbound(raw, sessionID, subject) {
         if (frame.event.actor.kind === "session" && frame.event.actor.id === sessionID) {
           return { skip: true, content: "", envelope };
         }
+        if (frame.event.type === "subscription.removed") {
+          const removed = SubscriptionRemovedEventPayloadSchema.safeParse(frame.event.payload);
+          if (!removed.success || removed.data.session_id !== sessionID) {
+            return { skip: true, content: "", envelope };
+          }
+          const who = removed.data.by?.id ?? "someone";
+          return {
+            skip: false,
+            content: `Unsubscribed from ${dispatchOwner(frame.event, subject ?? envelope.topic)} by ${who}`,
+            envelope
+          };
+        }
         askQuestion = dispatchAskQuestion(frame.event);
         messageReplyPreview = dispatchMessageReplyPreview(frame.event);
         dispatchEvent = {
@@ -32387,6 +32404,46 @@ function dispatchSubscriptionTopic(details) {
   const { topic } = details;
   return typeof topic === "string" && topic.startsWith("notifications.dispatch.") ? topic : null;
 }
+function dispatchTopicLabel(topic) {
+  if (topic.startsWith(DISPATCH_ISSUE_TOPIC_PREFIX)) {
+    const [key] = topic.slice(DISPATCH_ISSUE_TOPIC_PREFIX.length).split(".", 2);
+    if (key !== undefined && key !== "")
+      return key;
+  }
+  if (topic.startsWith(DISPATCH_DOCUMENT_TOPIC_PREFIX)) {
+    const [project, slug] = topic.slice(DISPATCH_DOCUMENT_TOPIC_PREFIX.length).split(".", 3);
+    if (project !== undefined && project !== "" && slug !== undefined && slug !== "") {
+      return `${project}/${slug}`;
+    }
+  }
+  return topic;
+}
+function subscriptionRemovedTopics(raw, sessionID) {
+  let envelope;
+  try {
+    envelope = JSON.parse(raw);
+  } catch {
+    return;
+  }
+  if (typeof envelope !== "object" || envelope === null)
+    return;
+  const { source, payload } = envelope;
+  if (source !== "dispatch" || typeof payload !== "string")
+    return;
+  let event;
+  try {
+    event = JSON.parse(payload);
+  } catch {
+    return;
+  }
+  const parsedEvent = DispatchEventSchema.safeParse(event);
+  if (!parsedEvent.success || parsedEvent.data.type !== "subscription.removed")
+    return;
+  const parsedPayload = SubscriptionRemovedEventPayloadSchema.safeParse(parsedEvent.data.payload);
+  if (!parsedPayload.success || parsedPayload.data.session_id !== sessionID)
+    return;
+  return parsedPayload.data.topics ?? [];
+}
 
 // ../envoy-client/src/tool-contract.ts
 var DELIVERY_CONTRACT = "Delivery is at-least-once, possibly out of order across topics; use id for dedupe and at for freshness.";
@@ -32864,6 +32921,8 @@ function envoyExtension(pi) {
   };
   const deliver = async (subject, raw, reply) => {
     const rendered = renderInbound(raw, sessionID, subject);
+    for (const topic of subscriptionRemovedTopics(raw, sessionID) ?? [])
+      closeIntentionally(topic);
     const dedupeKey = rendered.envelope?.dedupe_key;
     const duplicate = dedupeKey !== undefined && dedupeKeys.has(dedupeKey);
     if (!duplicate && !rendered.skip) {
@@ -33255,8 +33314,16 @@ function envoyExtension(pi) {
     if (topic === null)
       return;
     try {
-      if (await subscribe(topic))
+      const isNew = await subscribe(topic);
+      if (isNew)
         await registerSession();
+      if (isNew) {
+        pi.sendMessage({
+          customType: "envoy-message",
+          content: `Subscribed to ${dispatchTopicLabel(topic)} (every event on this issue reaches you; envoy_unsubscribe ${topic} to stop).`,
+          display: true
+        }, { deliverAs: "steer", triggerTurn: false });
+      }
     } catch (error) {
       activeSessionContext?.ui.notify(`envoy: dispatch reply auto-subscribe failed (${messageFor(error)}); run envoy_subscribe ${topic}`, "warning");
     }

package/dist/legion.js

@@ -29724,6 +29724,11 @@ var ChildStatusEventPayloadSchema = object({
   from: string2().optional(),
   to: string2().optional()
 });
+var SubscriptionRemovedEventPayloadSchema = object({
+  session_id: string2().optional(),
+  by: object({ kind: string2(), id: string2().optional() }).passthrough().optional(),
+  topics: array(string2()).optional()
+});
 // ../contracts/src/dispatch-snippet.ts
 var HTML_ENTITIES = [
   ["&lt;", "<"],
@@ -31554,6 +31559,18 @@ function renderInbound(raw, sessionID, subject) {
         if (frame.event.actor.kind === "session" && frame.event.actor.id === sessionID) {
           return { skip: true, content: "", envelope };
         }
+        if (frame.event.type === "subscription.removed") {
+          const removed = SubscriptionRemovedEventPayloadSchema.safeParse(frame.event.payload);
+          if (!removed.success || removed.data.session_id !== sessionID) {
+            return { skip: true, content: "", envelope };
+          }
+          const who = removed.data.by?.id ?? "someone";
+          return {
+            skip: false,
+            content: `Unsubscribed from ${dispatchOwner(frame.event, subject ?? envelope.topic)} by ${who}`,
+            envelope
+          };
+        }
         askQuestion = dispatchAskQuestion(frame.event);
         messageReplyPreview = dispatchMessageReplyPreview(frame.event);
         dispatchEvent = {
@@ -32827,6 +32844,46 @@ function dispatchSubscriptionTopic(details) {
   const { topic } = details;
   return typeof topic === "string" && topic.startsWith("notifications.dispatch.") ? topic : null;
 }
+function dispatchTopicLabel(topic) {
+  if (topic.startsWith(DISPATCH_ISSUE_TOPIC_PREFIX)) {
+    const [key] = topic.slice(DISPATCH_ISSUE_TOPIC_PREFIX.length).split(".", 2);
+    if (key !== undefined && key !== "")
+      return key;
+  }
+  if (topic.startsWith(DISPATCH_DOCUMENT_TOPIC_PREFIX)) {
+    const [project, slug] = topic.slice(DISPATCH_DOCUMENT_TOPIC_PREFIX.length).split(".", 3);
+    if (project !== undefined && project !== "" && slug !== undefined && slug !== "") {
+      return `${project}/${slug}`;
+    }
+  }
+  return topic;
+}
+function subscriptionRemovedTopics(raw, sessionID) {
+  let envelope;
+  try {
+    envelope = JSON.parse(raw);
+  } catch {
+    return;
+  }
+  if (typeof envelope !== "object" || envelope === null)
+    return;
+  const { source, payload } = envelope;
+  if (source !== "dispatch" || typeof payload !== "string")
+    return;
+  let event;
+  try {
+    event = JSON.parse(payload);
+  } catch {
+    return;
+  }
+  const parsedEvent = DispatchEventSchema.safeParse(event);
+  if (!parsedEvent.success || parsedEvent.data.type !== "subscription.removed")
+    return;
+  const parsedPayload = SubscriptionRemovedEventPayloadSchema.safeParse(parsedEvent.data.payload);
+  if (!parsedPayload.success || parsedPayload.data.session_id !== sessionID)
+    return;
+  return parsedPayload.data.topics ?? [];
+}
 
 // ../envoy-client/src/tool-contract.ts
 var DELIVERY_CONTRACT = "Delivery is at-least-once, possibly out of order across topics; use id for dedupe and at for freshness.";
@@ -33296,6 +33353,8 @@ function envoyExtension(pi) {
   };
   const deliver = async (subject, raw, reply) => {
     const rendered = renderInbound(raw, sessionID, subject);
+    for (const topic of subscriptionRemovedTopics(raw, sessionID) ?? [])
+      closeIntentionally(topic);
     const dedupeKey = rendered.envelope?.dedupe_key;
     const duplicate = dedupeKey !== undefined && dedupeKeys.has(dedupeKey);
     if (!duplicate && !rendered.skip) {
@@ -33687,8 +33746,16 @@ function envoyExtension(pi) {
     if (topic === null)
       return;
     try {
-      if (await subscribe(topic))
+      const isNew = await subscribe(topic);
+      if (isNew)
         await registerSession();
+      if (isNew) {
+        pi.sendMessage({
+          customType: "envoy-message",
+          content: `Subscribed to ${dispatchTopicLabel(topic)} (every event on this issue reaches you; envoy_unsubscribe ${topic} to stop).`,
+          display: true
+        }, { deliverAs: "steer", triggerTurn: false });
+      }
     } catch (error) {
       activeSessionContext?.ui.notify(`envoy: dispatch reply auto-subscribe failed (${messageFor(error)}); run envoy_subscribe ${topic}`, "warning");
     }

package/dist/skills/dispatch/SKILL.md

@@ -226,9 +226,11 @@ It returns `details` `{ issue, topic, message }`. `body` is capped at 2,000 char
 
 ## What comes back
 
-A write result's `details.topic` subscribes the host to its owner. Issue writes use `notifications.dispatch.issue.<KEY>.>`;
+A write result's `details.topic` subscribes the host to its owner, and the first such subscription on an issue or document also tells
+you so (an already-subscribed write stays quiet — no repeat notice). Issue writes use `notifications.dispatch.issue.<KEY>.>`;
 project-document writes use `notifications.dispatch.document.<PROJECT>.<SLUG>.>`. The owner topic carries every Dispatch event; `notify`
-only controls agent wake and routed delivery. After a restart, catch up with:
+only controls agent wake and routed delivery. A human may unsubscribe you from the issue or document header; you are told with a
+`subscription.removed` notice when that happens. After a restart, catch up with:
 
 ```ts
 dispatch_read({ issue?, project?, artifact?, ref? })

package/package.json

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