@sjawhar/opencode-legion-envoy 3.2.1 → 3.2.2

package/dist/src/server.js

@@ -17267,7 +17267,7 @@ var envoyToolSpecs = [
   },
   {
     name: "envoy_whoami",
-    description: "Returns this session's Envoy identity: session ID, machine ID, port, and directory.",
+    description: "Returns this session's Envoy identity: session ID, machine ID, port, and directory. session_id is the address a reply reaches. Where a host runs a task subagent inside its parent's process, such a subagent registers no Envoy session of its own, so its session_id is the parent session that spawned it and the result says so.",
     arguments: () => ({}),
     operation: EnvoyToolOperation.whoami,
     requiresSubscriptionCapability: false
@@ -17435,7 +17435,7 @@ function createEnvoyClient(config2) {
       const idempotencyKey = input.idempotencyKey ?? crypto.randomUUID();
       const response = EnvelopeResponseSchema.parse(JSON.parse(await post("/v1/messages/send", {
         source: input.source ?? "agent",
-        ...input.sourceSessionID === undefined ? {} : { source_session: input.sourceSessionID },
+        ...sourceSession(input.sourceSessionID),
         target_session: input.targetSessionID,
         message: input.message,
         idempotency_key: idempotencyKey,
@@ -17451,7 +17451,7 @@ function createEnvoyClient(config2) {
       const idempotencyKey = input.idempotencyKey ?? crypto.randomUUID();
       const response = EnvelopeResponseSchema.parse(JSON.parse(await post("/v1/messages/publish", {
         source: input.source ?? "agent",
-        ...input.sourceSessionID === undefined ? {} : { source_session: input.sourceSessionID },
+        ...sourceSession(input.sourceSessionID),
         topic: input.topic,
         message: input.message,
         ...input.payload === undefined ? {} : { payload: input.payload },
@@ -17514,6 +17514,9 @@ function messageMetadata(input) {
     ...input.expiresAt === undefined ? {} : { expires_at: input.expiresAt }
   };
 }
+function sourceSession(sessionID) {
+  return sessionID === undefined || sessionID === "" ? {} : { source_session: sessionID };
+}
 
 // src/server.ts
 import { tool } from "@opencode-ai/plugin/tool";

package/package.json

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

package/skills/envoy/SKILL.md

@@ -106,6 +106,25 @@ envoy_send(
 )
 ```
 
+### Your own address, and a subagent's
+
+`envoy_whoami`'s `session_id` is the address a reply to you reaches. Inside a `task` subagent it
+is the session that spawned you: a subagent registers no Envoy session of its own, so a peer
+answering it reaches that session, which relays to you over hub. The `subagent` field in that
+output carries your own host session id — it is not an address, so never hand it to a peer.
+
+`session_id` is empty when nothing can be reached: a process that took no Envoy identity, or a
+subagent whose spawning session this process can no longer place (it forked away, and other
+top-level sessions are running). Then your messages carry no sender either, so say who you are
+in the message body. An empty address is deliberate — being handed an unrelated live session
+would send your peers to an agent that never spawned you.
+
+Your own `envoy_publish` never reaches the agent that spawned you. The listener delivers nothing
+to the session a message names as its source, and inside a subagent that source is your parent,
+so a publish to a role it holds — or to any topic it subscribes to — is accepted and delivered to
+nobody. Use hub for that one hop. `envoy_send` to any other session, including a reply, is
+unaffected.
+
 ### Delivery capabilities
 
 Each session row from `envoy_sessions` carries `capabilities`, the targeted-delivery modes that