opencode-courier 0.7.0 → 0.7.2

package/README.md

@@ -21,7 +21,7 @@ The edge cases on the live terminal UI, narrated ([what it shows](#demos)).
 ## Quickstart
 
 ```bash
-npm install -g @opencode/cli@2.0.29   # OpenCode V2, at the version courier is tested on
+npm install -g @opencode/cli@2.0.31   # OpenCode V2, at the version courier is tested on
 opencode plugin add opencode-courier  # by name, so OpenCode offers new releases
 opencode                              # in any folder
 ```
@@ -43,7 +43,7 @@ sometimes stall on a request; if nothing moves for a few minutes, send the promp
 
 Courier is built on OpenCode V2's plugin API (`@opencode/plugin`), not the V1 one
 (`@opencode-ai/plugin`), and needs OpenCode V2. Each release is pinned to one V2 version and tested
-against it end to end; the current one is tested on **OpenCode 2.0.29**. CI also runs the live
+against it end to end; the current one is tested on **OpenCode 2.0.31**. CI also runs the live
 suite on the newest OpenCode release, on `main` and nightly, so a host release that breaks the
 plugin shows up there first. Older releases and their versions: [Supported OpenCode version](#supported-opencode-version).
 
@@ -111,8 +111,11 @@ pinned to its version. OpenCode never checks it:
 the plugin installs and loads on any V2 host, and on a version other than the pinned one writes one
 line to the server log naming both ([more](docs/reference.md#the-opencode-version)).
 
+<!-- compat-table:start: generated by script/compat-table.ts from the release tags -->
 | opencode-courier | OpenCode V2 (`opencode` and `@opencode/plugin`) |
 |---|---|
+| 0.7.2 | 2.0.31 |
+| 0.7.1 | 2.0.30 |
 | 0.5.0, 0.6.0, 0.7.0 | 2.0.29 |
 | 0.4.0, 0.4.1 | 2.0.28 |
 | 0.2.3, 0.3.0 | 2.0.26 |
@@ -120,14 +123,15 @@ line to the server log naming both ([more](docs/reference.md#the-opencode-versio
 | 0.2.1 | 2.0.23 |
 | 0.2.0 | 2.0.22 |
 | 0.1.6 | 0.0.0-beta-19271 (the beta line: `opencode2` from `@opencode-ai/cli`, and `@opencode-ai/plugin`) |
+<!-- compat-table:end -->
 
 The [terminal part](#in-the-terminal) relies on the host to provide its UI modules and is tested on
-OpenCode 2.0.29 only; the server part works as before on older V2 hosts from 2.0.4 on.
+OpenCode 2.0.31 only; the server part works as before on older V2 hosts from 2.0.4 on.
 
 Check yours with `opencode --version`, and install the matching CLI with:
 
 ```bash
-npm install -g @opencode/cli@2.0.29
+npm install -g @opencode/cli@2.0.31
 ```
 
 ### The plugin
@@ -210,7 +214,7 @@ Each tool's parameters: [the reference](docs/reference.md#the-tools).
   children, a scheduled message or a webhook is not, nor is one that answers what you typed in its
   session. [More](docs/reference.md#a-child-that-fails).
 - **A message that fails to wake its session is sent again.** A report, notice or scheduled message
-  that waits in an idle session's inbox for 30 seconds without a turn starting for it is sent once
+  (but not a note that a request was answered elsewhere) that waits in an idle session's inbox for 30 seconds without a turn starting for it is sent once
   more under the same inbox id, which OpenCode takes for the same message, not a second one. If the
   session still does not take it, the footer and the tree panel show it as `stalled`, for you to
   prompt it. [More](docs/reference.md#a-missed-wake).
@@ -220,7 +224,9 @@ Each tool's parameters: [the reference](docs/reference.md#the-tools).
   and under its rules, before anything is passed on: its model cannot approve, only propose. For a
   question, it asks you and passes your answer back, or links its own question to the child's so your
   pick goes straight to it. Whichever answer comes first counts, and the other is withdrawn.
-  [More](docs/reference.md#a-child-that-asks-for-permission).
+  A request starts a turn in the top session if it is idle; if you answer it somewhere else, the
+  note that it is settled waits for that session's next turn, usually the child's report or its
+  silence, instead of starting one of its own. [More](docs/reference.md#a-child-that-asks-for-permission).
 - **Some forms only you can answer**, such as OpenCode's web search asking for a provider: the top
   session is told, and you answer in the child's session. [More](docs/reference.md#a-child-that-shows-a-form).
 - **You can see and stop a whole subtree** with `courier_tree` and `courier_stop`, or in the

package/dist/person/events.d.ts

@@ -7,8 +7,8 @@ import { type PersonPorts, type PersonState } from "./ports.js";
  */
 export declare function reportAsked(ports: PersonPorts, state: PersonState, event: PermissionAsked): Promise<string[]>;
 /**
- * Tells the session told about a request that it was answered some other way, so it does not pass on
- * a stale question; requests answered through courier_answer no longer wait and are skipped.
+ * Tells the session told about a request that it was answered some other way, so it does not pass on a stale
+ * question; requests answered through courier_answer are skipped. Sent with `resume: false`, so it starts no turn.
  */
 export declare function reportReplied(ports: PersonPorts, state: PersonState, event: PermissionReplied): Promise<string[]>;
 /**

package/dist/person/events.js

@@ -36,8 +36,8 @@ export async function reportAsked(ports, state, event) {
     return [topOf(chain)];
 }
 /**
- * Tells the session told about a request that it was answered some other way, so it does not pass on
- * a stale question; requests answered through courier_answer no longer wait and are skipped.
+ * Tells the session told about a request that it was answered some other way, so it does not pass on a stale
+ * question; requests answered through courier_answer are skipped. Sent with `resume: false`, so it starts no turn.
  */
 export async function reportReplied(ports, state, event) {
     if (!claim(state.seen, event.id))
@@ -54,8 +54,9 @@ export async function reportReplied(ports, state, event) {
         sessionID: topOf(chain),
         text: envelope(sessionID, permissionSettledNotice(chain[0].title, requestID, reply), { answered: reply, request: requestID }),
         description: `Session ${sessionID} no longer asks for permission`,
-        metadata: { source: "courier", from: sessionID, answered: reply, requestID },
+        metadata: { source: "courier", from: sessionID, answered: reply, requestID, resume: false },
         delivery: "steer",
+        resume: false,
     });
     return [topOf(chain)];
 }

package/dist/skill.js

@@ -11,17 +11,22 @@ export const SKILL_CONTENT = [
         "opencode-courier role line in your system prompt, names your depth in the session tree and its limits.",
     "",
     "1. Decide: split or do. Split when the task has 2 or more independent, substantial parts touching separate files or " +
-        "areas; do it yourself when it is small, sequential or tightly coupled. Never start exactly one session. " +
-        "An implementation task with one tightly coupled core usually still has independent parts: its e2e scenario, its " +
+        "areas; do it yourself when it is small, sequential or tightly coupled. Never start exactly one session for the whole " +
+        "task: it only adds a hop. What you read and write yourself stays in your context for every later turn, so keep the " +
+        "deciding, checking and integrating, and hand off the long reading and writing. An implementation task with one tightly " +
+        "coupled core usually still has independent parts: finding out what the change needs (a session with isolate: false " +
+        "reads the code, or a library's or a host's source, tries things and reports what it found), its e2e scenario, its " +
         "documentation, sometimes a second test file, and a review of the core by a session with fresh context, which reads the " +
         "committed diff against the task and the repository's rules and reports its findings (isolate: false, it edits nothing). " +
-        "Weigh each of them: do the core yourself first and commit it, so that the names and texts the other parts depend on are " +
-        "fixed, then, if 2 or more remain, start one session per remaining part, in one group. A part that is itself big and " +
-        "divisible is split again by the session that gets it; at the deepest level a session does its part itself. " +
+        "Weigh each of them. When the other parts depend on names and texts the core fixes, split in stages: the core first, " +
+        "yourself when it is small or by one session when it is big, merged and committed before the rest start; then, if 2 or " +
+        "more parts remain, one session per remaining part, in one group. A part that is itself big and divisible is split again " +
+        "by the session that gets it; at the deepest level a session does its part itself. " +
         `Say which in one line of your reply, before you start: ${SPLIT_LINE}, so that a reasoned decision to do it ` +
         "yourself can be told from one never made.",
     "2. Plan the parts so that no two edit the same files. Write each task so the session can do it without you: what to " +
-        "produce and where, how to check it, what to report. Say if it may split its part further.",
+        "produce and where, how to check it, what to report. Say if it may split its part further, and to run its checks " +
+        "through the project's scripts (step 6): each permission request of a session below you wakes you and waits on the person.",
     "3. Start them: one courier_spawn per part, all with the same group name, so you are woken once with every report; " +
         "isolate: true for each part that edits files in parallel with another (commit your own work first if you are isolated " +
         "yourself). For long work, courier_later a check-in for yourself, and courier_cancel it when the reports arrive.",

package/dist/tree/text.js

@@ -47,7 +47,7 @@ function splitRule(parentID, depth, limits) {
         `You are at depth ${depth} of a session tree that goes at most ${limits.maxDepth} deep. Split your task or do it yourself:`,
         "- Split it when it has 2 or more independent parts, each substantial and touching separate files or areas: start one " +
             `session per part with courier_spawn, at most ${limits.maxChildren} of yours running at once and ${limits.maxTotal} in the whole tree.`,
-        "- Do it yourself when it is small, sequential or tightly coupled. Never start exactly one session.",
+        "- Do it yourself when it is small, sequential or tightly coupled. Never start exactly one session for the whole task.",
         `- Say which in one line of your reply: ${SPLIT_LINE}.`,
         "- If you split, you orchestrate: end your turn while they work, check and integrate each part yourself when it " +
             `reports (never hand that checking to another session), then send ${parentID} one combined report.`,

package/dist/tree/wake.d.ts

@@ -14,6 +14,7 @@ export interface Enqueued {
                 readonly description?: unknown;
                 readonly metadata?: {
                     readonly source?: unknown;
+                    readonly resume?: unknown;
                 };
             };
         };
@@ -34,8 +35,8 @@ export interface Execution {
     };
 }
 /**
- * Watches a courier message enqueued for a session until it is delivered, noting whether the session runs: a running
- * turn takes it at its next step, an idle session is woken for it. Returns whether it is watched.
+ * Watches a courier message enqueued for a session until it is delivered, noting whether the session runs.
+ * Returns whether it is watched, which one sent with `resume: false` is not.
  */
 export declare function watchWake(ports: WatchPorts, event: Enqueued): Promise<boolean>;
 /** Stops watching a message once it is delivered or cancelled. */

package/dist/tree/wake.js

@@ -4,14 +4,17 @@ export const WAKE_MS = 30_000;
 /** Whether a session's stored messages end with the marker of an ended turn; one with none yet is taken to run. */
 const endsIdle = (messages) => messages.at(-1)?.type === "idle";
 /**
- * Watches a courier message enqueued for a session until it is delivered, noting whether the session runs: a running
- * turn takes it at its next step, an idle session is woken for it. Returns whether it is watched.
+ * Watches a courier message enqueued for a session until it is delivered, noting whether the session runs.
+ * Returns whether it is watched, which one sent with `resume: false` is not.
  */
 export async function watchWake(ports, event) {
     const { sessionID, inboxID, item } = event.data;
     const payload = item.payload;
     if (item.type !== "synthetic" || payload?.metadata?.source !== "courier" || typeof payload.text !== "string")
         return false;
+    // Sent without a wake: it waits for the next turn, which nothing owes it.
+    if (payload.metadata.resume === false)
+        return false;
     const at = event.created ?? ports.now();
     // Read after the enqueue: a turn it started has stored messages since, and an unknown session is taken to run.
     const idle = await ports.session.context({ sessionID }).then(endsIdle, () => false);

package/dist/tui.js

@@ -1151,7 +1151,7 @@ async function confirmForget(ctx, courier, location, by, target, done) {
   return true;
 }
 var FOCUS_PROMPT = "pane.focus.left";
-var SPLIT_WIDTH = 80;
+var SPLIT_WIDTH = 108;
 var oneLine = (title) => title.replace(/[\r\n]+/g, " ");
 function TreePanel(props) {
   const {
@@ -1197,7 +1197,7 @@ function TreePanel(props) {
       presentation,
       focused
     } = input;
-    view.note(ctx.renderer.width > SPLIT_WIDTH ? {
+    view.note(ctx.renderer.width >= SPLIT_WIDTH ? {
       presentation,
       focused
     } : {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-courier",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Multi-session orchestration for OpenCode V2: spawn child sessions, be woken by them. No polling.",
   "license": "MIT",
   "author": "Ivo Pogace <71701666+ivopogace@users.noreply.github.com>",
@@ -56,12 +56,12 @@
     "test:e2e": "e2e/run.sh"
   },
   "peerDependencies": {
-    "@opencode/plugin": "2.0.29",
+    "@opencode/plugin": "2.0.31",
     "effect": "4.0.1"
   },
   "devDependencies": {
-    "@opencode/plugin": "2.0.29",
-    "@opencode/theme": "2.0.29",
+    "@opencode/plugin": "2.0.31",
+    "@opencode/theme": "2.0.31",
     "@opentui/core": "0.5.17",
     "@opentui/solid": "0.5.17",
     "@types/bun": "1.3.14",