@sjawhar/pi-legion-envoy 0.4.0 → 0.4.1

package/dist/envoy.js

@@ -30990,18 +30990,35 @@ function envoyExtension(pi) {
       }, NATS_RETRY_INTERVAL_MS);
     }
   });
-  const rebind = async (_event, context) => {
+  const rebind = async (reason, context) => {
     if (defaults.natsUrls.length === 0)
       return;
+    const previousID = sessionID;
     try {
       await establishSession(context);
     } catch (error48) {
       context.ui.notify(`envoy: rebind failed (${messageFor(error48)}); will recover on reconnect`, "warning");
     }
-  };
-  pi.on("session_switch", rebind);
-  pi.on("session_branch", rebind);
-  pi.on("session_tree", rebind);
+    if (previousID === "" || previousID === sessionID)
+      return;
+    if (reason === "new" || reason === "resume")
+      return;
+    pi.sendMessage({
+      customType: "envoy-message",
+      content: encode3({
+        envoy: {
+          notice: "session id changed",
+          previous_session_id: previousID,
+          session_id: sessionID,
+          detail: "This conversation now lives under a new session id. Any identity you shared earlier (envoy_whoami output, session ids named in messages) is stale, and peers using the old id cannot reach you. Re-run envoy_whoami before identifying yourself and re-announce the new id to peers you already introduced yourself to."
+        }
+      }),
+      display: true
+    }, { deliverAs: "steer", triggerTurn: false });
+  };
+  pi.on("session_switch", (event, context) => rebind(event.reason, context));
+  pi.on("session_branch", (_event, context) => rebind(undefined, context));
+  pi.on("session_tree", (_event, context) => rebind(undefined, context));
   pi.on("session_shutdown", async () => {
     shuttingDown = true;
     try {

package/dist/skills/envoy/SKILL.md

@@ -200,6 +200,14 @@ Examples:
 
 You do NOT need to subscribe in order to send or publish.
 
+**Session ids are not stable for the life of a conversation.** On OMP, `/fork` and `/handoff`
+re-mint the session id while the conversation continues (esc-esc rewinds also did, on omp
+18.1.0–18.1.2 only); the extension rebinds automatically and injects an `envoy` notice naming
+the previous and new ids. When that notice arrives, any id you shared earlier (an
+`envoy_whoami` result quoted in a message, an id a peer saved) is stale — re-run
+`envoy_whoami` and re-announce yourself. Never treat a whoami result from earlier in the
+transcript as current when identifying yourself to peers.
+
 ### To wait for CI, PR checks, or other async work
 
 **Don't `sleep`-poll. Don't "check back in N minutes."** Subscribe to the event and continue with productive work — the system will wake the session when the event arrives.

package/package.json

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