@sjawhar/opencode-legion-envoy 1.26.0 → 1.27.1

package/README.md

@@ -16,23 +16,28 @@ This package exposes:
 - `dispatch_ask`
 - `dispatch_edit_ask`
 - `dispatch_resolve_ask`
+- `dispatch_follow`
 - `dispatch_comment`
 - `dispatch_suggest`
 - `dispatch_message`
 - `dispatch_doc_edit`
 - `dispatch_doc_read`
+- `dispatch_request_approval`
 - `dispatch_artifact`
 - `dispatch_read`
 - `dispatch_search`
+- `dispatch_open_asks`
 
-The twelve native `dispatch_*` tools create and read Dispatch issues, asks, comments,
+The fifteen native `dispatch_*` tools create and read Dispatch issues, asks, comments,
 documents, and artifacts, or search all of them. They are present when `dispatch.enabled`
 resolves a server URL and bearer token from envoy.json (`~/.config/opencode/envoy.json`, merged
 with `<repo>/.opencode/envoy.json`) or the `DISPATCH_URL` and `DISPATCH_TOKEN` environment
 variables; `dispatch.enabled: true` without `dispatch.serverUrl` targets `http://localhost:8766`.
-Each issue-scoped call fills the target issue from the session working directory, stamps it with
-the OpenCode session id and title, and stores a successful mutation's `details.topic` as tool
-metadata so the host subscribes to that exact Dispatch topic.
+Each issue-scoped call fills the target issue from the session working directory and stamps it with
+the OpenCode session id and title. No write subscribes the session to an issue or document: a
+session follows the asks it opens or replies to (their answers and replies reach it directly),
+`dispatch_follow` leaves or rejoins one, and every write result names the `envoy_subscribe` line
+for the whole owner.
 
 `dispatch_artifact` accepts exactly one upload source: a local `path`, or inline `content`.
 An architect can post a specification directly with

package/dist/src/server.js

@@ -13682,6 +13682,11 @@ var SubscriptionRemovedEventPayloadSchema = object({
   pending: boolean2().optional(),
   request_event_id: number2().int().positive().optional()
 });
+var AskFollowerEventPayloadSchema = object({
+  ask_id: string2().optional(),
+  session_id: string2().optional(),
+  by: object({ kind: string2(), id: string2().optional() }).passthrough().optional()
+});
 // ../contracts/src/dispatch-snippet.ts
 var HTML_ENTITIES = [
   ["&lt;", "<"],
@@ -13847,6 +13852,15 @@ var dispatchToolSpecs = [
       reason: z.string({ min: 1 }).describe("Why the open ask no longer needs a human answer.")
     })
   },
+  {
+    name: "dispatch_follow",
+    description: "Follow or unfollow an ask. Every session that opens or replies to an ask follows it: its answer, " + "edits, resolution, and replies reach that session directly. Unfollow to stop; follow to rejoin or " + "to hear an ask you never wrote to. Whole-issue subscription is separate: envoy_subscribe " + "notifications.dispatch.issue.<KEY>.>",
+    arguments: (z) => ({
+      ask: z.string().describe("Full ask id (uuid)."),
+      action: z.enum(["follow", "unfollow"]).describe("follow | unfollow")
+    }),
+    strict: true
+  },
   {
     name: "dispatch_comment",
     description: "Add review feedback to an issue or project document quote, or reply to a question asked with dispatch_ask. " + "Do not use it for an exact replacement; use " + `dispatch_suggest instead. A quote anchor is pinned to its block. Body is at most 2,000 characters. ${OWNER_REFERENCE}`,
@@ -14882,6 +14896,12 @@ class DispatchClient {
   async getAsk(id) {
     return this.#json("GET", ["api", "v1", "asks", id]);
   }
+  async followAsk(id, sessionId, actor) {
+    await this.#json("PUT", ["api", "v1", "asks", id, "followers", sessionId], { actor });
+  }
+  async unfollowAsk(id, sessionId, actor) {
+    await this.#json("DELETE", ["api", "v1", "asks", id, "followers", sessionId], { actor });
+  }
   async getComment(id) {
     return this.#json("GET", ["api", "v1", "comments", id]);
   }
@@ -15115,12 +15135,33 @@ function formatZodIssues(issues, schema) {
 }
 
 // ../envoy-client/src/dispatch-execute.ts
+function issueTopic(key) {
+  return { label: key, topic: dispatchIssueSubject(key, ">") };
+}
+function documentTopic(artifact) {
+  return {
+    label: `${artifact.project}/${artifact.slug}`,
+    topic: dispatchDocumentSubject(artifact.project, artifact.slug, ">")
+  };
+}
+function resolvedTopic(resolved) {
+  if (resolved.owner.kind === "project")
+    return documentTopic(resolved.artifact);
+  if (resolved.issue === undefined)
+    throw new Error("issue document is missing its issue");
+  return issueTopic(resolved.issue.key);
+}
+function notSubscribed(owner) {
+  return `(not subscribed to ${owner.label}; envoy_subscribe ${owner.topic} for every event on it)`;
+}
+function followsAsk(owner) {
+  return `You follow this ask: its answer and replies reach you directly. For every event on ${owner.label}: envoy_subscribe ${owner.topic}`;
+}
 function documentResultDetails(artifact) {
   return {
     project: artifact.project,
     artifact: artifact.id,
-    document: `${artifact.project}/${artifact.slug}`,
-    topic: dispatchDocumentSubject(artifact.project, artifact.slug, ">")
+    document: `${artifact.project}/${artifact.slug}`
   };
 }
 function writeResultDetails(resolved, fields) {
@@ -15129,19 +15170,11 @@ function writeResultDetails(resolved, fields) {
   }
   if (resolved.issue === undefined)
     throw new Error("issue document is missing its issue");
-  return {
-    issue: resolved.issue.key,
-    topic: dispatchIssueSubject(resolved.issue.key, ">"),
-    ...fields
-  };
+  return { issue: resolved.issue.key, ...fields };
 }
-async function askResultDetails(client, ask, resolved) {
+async function askOwnerDetails(client, ask, resolved) {
   if (ask.issue_key !== null) {
-    return {
-      issue: ask.issue_key,
-      topic: dispatchIssueSubject(ask.issue_key, ">"),
-      ask: ask.id
-    };
+    return { issue: ask.issue_key, ask: ask.id };
   }
   if (ask.artifact_id === undefined || ask.artifact_id === null) {
     throw new Error("document ask is missing its artifact ID");
@@ -15149,6 +15182,9 @@ async function askResultDetails(client, ask, resolved) {
   const artifact = resolved?.artifact ?? await client.getArtifact(ask.artifact_id);
   return { ...documentResultDetails(artifact), ask: ask.id };
 }
+async function followedAskDetails(client, ask, resolved) {
+  return { ...await askOwnerDetails(client, ask, resolved), follows: { ask: ask.id } };
+}
 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]*$/;
@@ -15156,6 +15192,7 @@ var issueFreeTools = {
   dispatch_issue: true,
   dispatch_edit_ask: true,
   dispatch_resolve_ask: true,
+  dispatch_follow: true,
   dispatch_search: true,
   dispatch_open_asks: true
 };
@@ -15818,8 +15855,8 @@ async function executeDispatchTool(input) {
           actor
         });
         return {
-          text: `Created ${created.key}: ${created.title}`,
-          details: { issue: created.key, topic: dispatchIssueSubject(created.key, ">") }
+          text: `Created ${created.key}: ${created.title} ${notSubscribed(issueTopic(created.key))}`,
+          details: { issue: created.key }
         };
       } catch (error) {
         if (!(error instanceof DispatchServiceError) || error.code !== "POSSIBLE_DUPLICATE") {
@@ -15870,7 +15907,7 @@ async function executeDispatchTool(input) {
         throw new Error("resolved ask is missing its resolution");
       return {
         text: `${kind === "retracted" ? "Retracted" : "Resolved"} ask ${ask.id}: ${ask.resolution.reason}`,
-        details: await askResultDetails(client, ask)
+        details: await askOwnerDetails(client, ask)
       };
     }
     case "dispatch_ask": {
@@ -15893,9 +15930,11 @@ async function executeDispatchTool(input) {
         actor
       };
       const ask = resolved?.owner.kind === "project" ? await client.artifactAsk(resolved.artifact.id, askInput) : await client.ask(issue(), askInput);
+      const askOwner = ask.issue_key !== null ? issueTopic(ask.issue_key) : resolved === undefined ? issueTopic(issue()) : documentTopic(resolved.artifact);
       return {
-        text: `Opened ask ${ask.id}: ${ask.question}`,
-        details: await askResultDetails(client, ask, resolved)
+        text: `Asked ${ask.id} on ${askOwner.label} (urgency ${ask.urgency}): ${ask.question}
+${followsAsk(askOwner)}`,
+        details: await followedAskDetails(client, ask, resolved)
       };
     }
     case "dispatch_edit_ask": {
@@ -15912,7 +15951,7 @@ async function executeDispatchTool(input) {
       });
       return {
         text: `Ask edited: ${ask.question}`,
-        details: await askResultDetails(client, ask)
+        details: await askOwnerDetails(client, ask)
       };
     }
     case "dispatch_comment": {
@@ -15932,18 +15971,23 @@ async function executeDispatchTool(input) {
         actor
       };
       const comment = resolved?.owner.kind === "project" ? await client.artifactComment(resolved.artifact.id, commentInput) : await client.comment(issue(), commentInput);
-      const askState = comment.turn === null ? "" : ` (ask now waiting on ${comment.turn})`;
+      const commentOwner = resolved === undefined ? issueTopic(issue()) : resolvedTopic(resolved);
+      const commentDetails = resolved === undefined ? { issue: comment.issue_key, comment: comment.id } : writeResultDetails(resolved, { comment: comment.id });
+      if (replyToAsk !== undefined) {
+        const askState = comment.turn === null ? "" : `; ask now waiting on ${comment.turn}`;
+        return {
+          text: `Replied on ask ${replyToAsk} (comment ${comment.id}${askState}). ${followsAsk(commentOwner)}`,
+          details: {
+            ...commentDetails,
+            ask: replyToAsk,
+            follows: { ask: replyToAsk },
+            ...comment.turn === null ? {} : { ask_waiting_on: comment.turn }
+          }
+        };
+      }
       return {
-        text: `Posted comment ${comment.id}${askState}`,
-        details: resolved === undefined ? {
-          issue: comment.issue_key,
-          topic: dispatchIssueSubject(issue(), ">"),
-          comment: comment.id,
-          ...comment.turn === null ? {} : { ask_waiting_on: comment.turn }
-        } : writeResultDetails(resolved, {
-          comment: comment.id,
-          ...comment.turn === null ? {} : { ask_waiting_on: comment.turn }
-        })
+        text: `Posted comment ${comment.id} ${notSubscribed(commentOwner)}`,
+        details: commentDetails
       };
     }
     case "dispatch_suggest": {
@@ -15960,7 +16004,7 @@ async function executeDispatchTool(input) {
       };
       const comment = resolved.owner.kind === "project" ? await client.artifactSuggest(resolved.artifact.id, suggestionInput) : await client.suggest(issue(), suggestionInput);
       return {
-        text: `Posted suggestion ${comment.id}`,
+        text: `Posted suggestion ${comment.id} ${notSubscribed(resolvedTopic(resolved))}`,
         details: writeResultDetails(resolved, { comment: comment.id })
       };
     }
@@ -15974,12 +16018,8 @@ async function executeDispatchTool(input) {
       });
       const messageRef = `dispatch://${issueKey}/message/${message.id}`;
       return {
-        text: `Posted message ${message.id} (${messageRef})`,
-        details: {
-          issue: issueKey,
-          topic: dispatchIssueSubject(issueKey, ">"),
-          message: message.id
-        }
+        text: `Posted message ${message.id} (${messageRef}) ${notSubscribed(issueTopic(issueKey))}`,
+        details: { issue: issueKey, message: message.id }
       };
     }
     case "dispatch_doc_edit": {
@@ -15993,8 +16033,9 @@ async function executeDispatchTool(input) {
       });
       const retyped = ops.filter((operation) => operation.op === "retype").length;
       const versionText = edited.version === null ? "no new version" : `version ${edited.version.number}`;
+      const applied = retyped === 0 ? `Applied ${edited.applied} ops (${versionText})` : `Applied ${edited.applied} ops; retyped ${retyped} block${retyped === 1 ? "" : "s"} (${versionText})`;
       return {
-        text: retyped === 0 ? `Applied ${edited.applied} ops (${versionText})` : `Applied ${edited.applied} ops; retyped ${retyped} block${retyped === 1 ? "" : "s"} (${versionText})`,
+        text: `${applied} ${notSubscribed(resolvedTopic(resolved))}`,
         details: writeResultDetails(resolved, {
           applied: edited.applied,
           ...edited.version === null ? {} : { version: edited.version.number }
@@ -16037,7 +16078,7 @@ ${trailer.join(`
           }
         };
       }
-      const details = await askResultDetails(client, result.ask, resolved);
+      const details = await followedAskDetails(client, result.ask, resolved);
       return {
         text: `Approval requested for ${resolved.artifact.name} (document id ${resolved.artifact.id}) at version ${result.version} (ask ${result.ask.id}). The answer arrives as artifact.approved or artifact.changes_requested; an edit after approval makes it stale, so request again for the new version.`,
         details: { ...details, artifact: resolved.artifact.id, version: result.version }
@@ -16061,19 +16102,36 @@ ${trailer.join(`
       const artifactOwner = documentOwner();
       const result = artifactOwner.kind === "project" ? await client.projectArtifact(artifactOwner.project, artifactInput) : await client.artifact(issue(), artifactInput);
       const artifactRef = artifactOwner.kind === "project" ? `dispatch://${artifactOwner.project}/artifact/${result.artifact.slug}` : `dispatch://${issue()}/artifact/${result.artifact.slug}`;
+      const uploadOwner = artifactOwner.kind === "project" ? documentTopic(result.artifact) : issueTopic(issue());
       return {
-        text: `Uploaded ${result.artifact.name} as version ${result.version.number} (artifact slug ${result.artifact.slug}; ${artifactRef})`,
+        text: `Uploaded ${result.artifact.name} as version ${result.version.number} (artifact slug ${result.artifact.slug}; ${artifactRef}) ${notSubscribed(uploadOwner)}`,
         details: artifactOwner.kind === "project" ? {
           ...documentResultDetails(result.artifact),
           version: result.version.number
         } : {
           issue: issue(),
-          topic: dispatchIssueSubject(issue(), ">"),
           artifact: result.artifact.id,
           version: result.version.number
         }
       };
     }
+    case "dispatch_follow": {
+      const sessionId = input.sessionId?.trim();
+      if (!sessionId)
+        throw new Error("host session id is required for dispatch_follow");
+      const ask = askId(args);
+      const action = stringArg(args, "action");
+      if (action === "unfollow") {
+        await client.unfollowAsk(ask, sessionId, actor);
+        return { text: `Unfollowed ask ${ask}.`, details: { ask } };
+      }
+      const read = await client.getAsk(ask);
+      await client.followAsk(ask, sessionId, actor);
+      return {
+        text: `Following ask ${ask}: its answer and replies reach this session directly.`,
+        details: await followedAskDetails(client, read.ask)
+      };
+    }
     case "dispatch_read": {
       if (ownerArguments.ref?.kind === "ask") {
         const ref = ownerArguments.ref;
@@ -16162,14 +16220,6 @@ function asObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
 
-// ../envoy-client/src/dispatch-subscribe.ts
-function dispatchSubscriptionTopic(details) {
-  if (typeof details !== "object" || details === null || !("topic" in details))
-    return null;
-  const { topic } = details;
-  return typeof topic === "string" && topic.startsWith("notifications.dispatch.") ? topic : null;
-}
-
 // ../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.";
 var TOPIC_GUIDE = "Topic guide (all are under notifications.): agent.<session_id> (subscribe: own inbox); role.<role> " + "(publish-to; holders claim via envoy_role_set). > matches one or more trailing tokens and does not " + "match the base subject. Envoy registers the concrete base when you subscribe to <subject>.>, so " + "the recommended default remains github.<owner>.<repo>.pr.<n>.>. Default PR subscription: " + "github.<owner>.<repo>.pr.<n>.> (it receives the quiet PR family): pr.<n> (lifecycle: " + "opened/synchronize/closed; closed carries merged, merge_commit_sha, merged_by, head_sha), " + "pr.<n>.comment, pr.<n>.review, pr.<n>.mention, pr.<n>.checks (one head-checks settlement event: " + 'passed/failed/cancelled/skipped with failing names and URLs; re-fires with superseded_settlement: "true" ' + "when new runs appear for the same head). Other GitHub: issue.<n>, issue.<n>.comment, " + "issue.<n>.mention, mention, push.branch.<name>, push.tag.<name>, workflow.<file>.<action> (only " + "runs without an associated PR); slack.<team>.<channel>.message|mention and " + "slack.<team>.<channel>.thread.<ts>.message|mention; ghostwispr.<session>.<kind>; " + "whatsapp.<phone>.<jid>.<kind>; envoy.exceptions.<original-topic>.";
@@ -16783,24 +16833,6 @@ var server_default = async (input) => {
         }
       }
     },
-    "tool.execute.after": async (input, output) => {
-      const topic = dispatchSubscriptionTopic(output.metadata);
-      if (!topic)
-        return;
-      try {
-        await envoy.subscribe({
-          sessionID: input.sessionID,
-          directory: cwd,
-          topics: [topic],
-          port: currentPort() ?? 0,
-          title: activeSessionTitle ?? "",
-          driving: true
-        });
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        logger.warn(`[envoy-plugin] dispatch auto-subscribe failed: ${message}`);
-      }
-    },
     dispose: () => {
       clearInterval(timer);
       clearInterval(heartbeatInterval);

package/package.json

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

package/skills/dispatch/SKILL.md

@@ -97,7 +97,7 @@ Architects create newly tracked child work with:
 dispatch_issue({ project, title, parent?, external?, spec?, force?, labels?: string[], priority?: 0 | 1 | 2 | 3 })
 ```
 `labels` are optional initial labels: Dispatch trims them, preserves their case, and removes case-insensitive duplicates. Set `priority` on creation only when the human's intent makes the bucket clear; otherwise priority remains the human's decision. It returns
-`details` `{ issue, topic }`. Use `dispatch_issue` only to create an issue; never use it to park a question. When `spec` is supplied,
+`details` `{ issue }`; creating an issue does not subscribe you to it (see [Following](#following)). Use `dispatch_issue` only to create an issue; never use it to park a question. When `spec` is supplied,
 follow [Writing a spec](#writing-a-spec).
 
 ## Search first
@@ -131,7 +131,7 @@ dispatch_ask({
   anchor?: { artifact, quote, occurrence? },
 })
 ```
-It returns `details` `{ issue, topic, ask }` for an issue or `{ project, artifact, document, topic, ask }` for a project document.
+It returns `details` `{ issue, ask, follows: { ask } }` for an issue or `{ project, artifact, document, ask, follows: { ask } }` for a project document: you follow the ask you opened (see [Following](#following)).
 
 References belong in the question text; `ref` is sugar that appends its `dispatch://` value to the question as a rendered link.
 
@@ -248,7 +248,7 @@ It returns live or versioned markdown with open marks. `issue` with an omitted `
 ```ts
 dispatch_doc_edit({ issue?, project?, artifact, ops, summary? })
 ```
-It returns issue or project-document owner details plus `applied`, optional `version`, and its write `topic`. `ops` is an array of this
+It returns issue or project-document owner details plus `applied` and optional `version`. `ops` is an array of this
 exact `EditOp` shape:
 
 ```ts
@@ -324,7 +324,8 @@ Add feedback with:
 dispatch_comment({ issue?, project?, artifact?, ref?, quote?, occurrence?, body, reply_to?, reply_to_ask?, turn? })
 ```
 
-It returns issue or project-document owner details plus `comment` and, for writes, `topic`.
+It returns issue or project-document owner details plus `comment`; a `reply_to_ask` reply also returns `ask` and `follows: { ask }`,
+because replying to an ask makes you one of its followers (see [Following](#following)).
 `ref` names the owner (an issue or project-document reference) in place of `issue`/`project`.
 `quote` requires `artifact`; its anchor is pinned to the containing block while retaining the quote
 for display. Omit both for a floating issue comment. A reply (`reply_to`/`reply_to_ask`) takes no
@@ -342,7 +343,7 @@ Propose an exact replacement instead of describing it:
 dispatch_suggest({ issue?, project?, artifact, ref?, quote, replace_with, body?, occurrence? })
 ```
 
-It returns issue or project-document owner details plus `comment` and its write `topic`. A human accepts or rejects a suggestion.
+It returns issue or project-document owner details plus `comment`. A human accepts or rejects a suggestion.
 Errors: `TARGET_AMBIGUOUS` (add `occurrence`), `TARGET_NOT_FOUND` (re-read first), `INVALID_ANCHOR`/`ANCHOR_MISSING`/`ANCHOR_ORPHANED`
 (bad, unwritten, or stale quote), `INVALID_MARKDOWN`/`DOC_SCHEMA` (malformed content), `CAP_EXCEEDED`, `ISSUE_CLOSED`.
 
@@ -361,8 +362,8 @@ dispatch_artifact({ issue?, project?, name: "load-test-results.md", content: "#
 ```
 
 Exactly one of `issue` and `project` is required. A project upload creates an unlinked project document; it must not include `artifact`.
-Exactly one of `path` and `content` is required. It returns issue or project-document owner details plus `artifact`, `version`, and its
-write `topic`. Uploading the same `name` creates its next version — so uploading `spec.md` **replaces the issue's own specification**
+Exactly one of `path` and `content` is required. It returns issue or project-document owner details plus `artifact` and `version`.
+Uploading the same `name` creates its next version — so uploading `spec.md` **replaces the issue's own specification**
 with your text. Never do that: the spec is edited in place with `dispatch_doc_edit` (see [The Spec](#the-spec)). Address an existing
 artifact by the slug shown in the upload result or by its filename, and a project document by its artifact id, slug, or filename; the
 slug also arrives on `artifact.created` events.
@@ -396,7 +397,7 @@ pull request is where it is summarised. One message that a human reads beats ten
 dispatch_message({ issue, body })
 ```
 
-It returns `details` `{ issue, topic, message }`. `body` is capped at 2,000 characters. A message is not a decision
+It returns `details` `{ issue, 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
@@ -423,13 +424,31 @@ through Envoy or the hub. A bearer that targets over HTTP names its own session
 target only a session that advertises the mode you want. Sending to a session with no issue
 (`POST /api/v1/agents/{session_id}/messages`) stays human-only.
 
+## Following
+
+An ask has followers: every session that wrote to it — the session that opened it and every session that replied with
+`dispatch_comment({ reply_to_ask })` — plus any session a human adds from the ask card. The ask's answer, edits, resolution, and
+every reply on it reach each follower's own agent topic directly, whether or not the writer was a human and whatever the issue's
+route. The tool result says so (`You follow this ask: its answer and replies reach you directly.`) and carries `details.follows.ask`;
+the host tells you once per ask. Leave a thread you no longer need, or rejoin one, with:
+
+```ts
+dispatch_follow({ ask, action: "follow" | "unfollow" })
+```
+
+`ask` is the full ask id or a `dispatch://KEY/ask/<id>` reference. A human may also remove you from the ask card; either way you are
+told with an `ask.follower_removed` notice, and a human adding you arrives as `ask.follower_added`.
+
+No write subscribes you to an issue or document. Following covers your own asks and the threads you joined; everything else on the
+owner — other sessions' asks, comments, messages, status changes — reaches you only if you subscribe to the owner topic yourself.
+Every write result names that line: `envoy_subscribe notifications.dispatch.issue.<KEY>.>` for an issue,
+`envoy_subscribe notifications.dispatch.document.<PROJECT>.<SLUG>.>` for a project document. The owner topic carries every Dispatch
+event; `notify` 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.
+
 ## 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
-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. 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:
+After a restart, catch up with:
 
 ```ts
 dispatch_read({ issue?, project?, artifact?, ref? })

package/src/server.ts

@@ -5,7 +5,6 @@ import { agentSubject, dispatchToolSpecs, zodSchemaApi } from "@legion/contracts
 import { envoyDefaultsFromEnvironment } from "@legion/envoy-client/defaults";
 import { resolveDispatchConfig } from "@legion/envoy-client/dispatch-config";
 import { executeDispatchTool } from "@legion/envoy-client/dispatch-execute";
-import { dispatchSubscriptionTopic } from "@legion/envoy-client/dispatch-subscribe";
 import { machineID } from "@legion/envoy-client/machine";
 import {
   envoyToolSpecs,
@@ -269,29 +268,6 @@ export default async (input: { serverUrl: URL }) => {
         }
       }
     },
-    "tool.execute.after": async (
-      input: { tool: string; sessionID: string; callID: string; args: unknown },
-      output: { title: string; output: string; metadata: unknown }
-    ) => {
-      // Native Dispatch tools return `DispatchToolResult.details` in OpenCode
-      // output metadata, so only mutations with a Dispatch topic are followed.
-      // Best-effort — a subscribe failure must never surface to the model.
-      const topic = dispatchSubscriptionTopic(output.metadata);
-      if (!topic) return;
-      try {
-        await envoy.subscribe({
-          sessionID: input.sessionID,
-          directory: cwd,
-          topics: [topic],
-          port: currentPort() ?? 0,
-          title: activeSessionTitle ?? "",
-          driving: true,
-        });
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        logger.warn(`[envoy-plugin] dispatch auto-subscribe failed: ${message}`);
-      }
-    },
     // Cleanup hook (used by tests; production relies on process 'exit').
     dispose: () => {
       clearInterval(timer);