opencode-courier 0.11.1 → 0.13.0

package/dist/tree/tools.js

@@ -4,10 +4,10 @@ import { rethrow } from "../kernel/tool.js";
 import { cleanup } from "./cleanup.js";
 import { send } from "./send.js";
 import { spawn } from "./spawn.js";
-import { listChildren, status } from "./status.js";
+import { listChildren } from "./status.js";
 import { stop } from "./stop.js";
 import { tree } from "./subtree.js";
-import { childrenText, cleanupText, sendText, spawnText, statusText, stopText, treeText } from "./text.js";
+import { childrenText, cleanupText, sendText, spawnText, stopText, treeText } from "./text.js";
 /**
  * The tree's courier tools: their input schemas, descriptions, and what each returns. The descriptions are
  * model-facing like the texts in `text.ts`, and snapshotted with them in `test/notices.test.ts`.
@@ -16,10 +16,26 @@ export const SpawnInput = Schema.Struct({
     task: Schema.String.annotate({ description: "What the new session should do. It is told who started it and how to report back." }),
     title: Schema.optional(Schema.String.annotate({ description: "Session title; defaults to the task's first line." })),
     agent: Schema.optional(Schema.String.annotate({ description: "Agent to run the session with; defaults to the default agent." })),
+    model: Schema.optional(Schema.String.annotate({
+        description: "The model to run the session on, as provider/model (opencode/gpt-5-nano). Leave it unset for your own model, or the " +
+            "agent's own if it names one. Refused when OpenCode does not list it here.",
+    })),
+    variant: Schema.optional(Schema.String.annotate({
+        description: "The model's variant, its reasoning effort as OpenCode names it (low, medium, high, or another the model has). Leave " +
+            "it unset for the chosen model's own; with a model of your own choosing, that is the model's default. Refused when " +
+            "the model has no such variant.",
+    })),
     isolate: Schema.optional(Schema.Boolean.annotate({ description: "Run the session in its own git worktree so parallel sessions don't share files. From a session that is itself " +
             "isolated, the worktree starts from your current commit, not your uncommitted changes: commit first. The session " +
             "commits on a branch named courier/<its session ID> and names it in its report; merge that branch yourself.",
     })),
+    native: Schema.optional(Schema.Boolean.annotate({
+        description: "true starts the session as your OpenCode subagent: it leaves OpenCode's session lists for your subagent tab, the " +
+            "person answers its permission requests and questions in the view of the nearest session above it that is not a " +
+            "subagent, usually the top one, and deleting your session deletes it. false starts a standalone session, whatever the " +
+            "plugin's nativeChildren option says; unset, that option decides. Refused with isolate: true, as a subagent runs in " +
+            "its parent's directory.",
+    })),
     group: Schema.optional(Schema.String.annotate({
         description: "A join group: start the sessions of one batch with the same name, and their reports are held and delivered " +
             "to you in one message once every one of them has reported and your turn has ended, instead of one turn per " +
@@ -45,9 +61,6 @@ export const SendInput = Schema.Struct({
     }).annotate({ description: "With a report: what you produced, listed in the message after your text in a fixed layout." })),
     queue: Schema.optional(Schema.Boolean.annotate({ description: "Wait until the target's current turn ends instead of steering it now." })),
 });
-export const StatusInput = Schema.Struct({
-    sessionID: Schema.String.annotate({ description: "The session to look at." }),
-});
 export const ChildrenInput = Schema.Struct({
     sessionID: Schema.optional(Schema.String.annotate({ description: "The session whose children to list; defaults to this one." })),
 });
@@ -72,10 +85,11 @@ export function addTreeTools(tools, ports) {
     tools.add({
         name: "courier_spawn",
         options: { codemode: false },
-        description: "Start a new OpenCode session on a task and return immediately. It runs on your model. The session reports " +
+        description: "Start a new OpenCode session on a task and return immediately. It runs on your model, unless you name a model or a " +
+            "variant (reasoning effort) fit for the task. The session reports " +
             "back with courier_send, which wakes this session, and you are told if its turn fails or ends without a report " +
             "instead, it waits for a permission or it asks a question. Give a batch of parallel sessions one group name to " +
-            "be woken once, with all their reports, instead of once per report. DO NOT poll it or call courier_status in a " +
+            "be woken once, with all their reports, instead of once per report. DO NOT poll it or call courier_children in a " +
             "loop: once you have started the sessions you need, end your turn by replying without calling more tools; each " +
             "report, or each group's reports, starts a new turn in which you carry on. For long tasks, also courier_later a " +
             "check-in for yourself in case it never reports, and courier_cancel it when it does.",
@@ -91,7 +105,8 @@ export function addTreeTools(tools, ports) {
         description: "Deliver a message to another OpenCode session. If that session is idle, OpenCode starts a new turn for it. " +
             "Use it to report back to the session that started you, with a status (done, partial, blocked or failed) and " +
             "the artifacts you produced, or to steer a session you started. The status is carried as an attribute of the " +
-            "message; without one, a message to the session that started you is progress, not your report. If you were " +
+            "message; without one, a message to the session that started you is progress, not your report. A message to a " +
+            "session you started carries no status: one given is dropped. If you were " +
             "started in a group, a report with status done, partial or failed is held and delivered with the group's other " +
             "reports; the result says so, and nothing more is needed from you.",
         input: SendInput,
@@ -100,23 +115,12 @@ export function addTreeTools(tools, ports) {
             return { content: sendText(input.sessionID, delivered), metadata: delivered };
         },
     });
-    tools.add({
-        name: "courier_status",
-        options: { codemode: false },
-        description: "Look once at a session's state and its last reply, e.g. on a scheduled check-in. Not for waiting: " +
-            "sessions you started report back on their own.",
-        input: StatusInput,
-        execute: async (input) => {
-            const result = await status(ports.courier, input).catch(rethrow("courier_status"));
-            return { content: statusText(result), metadata: result };
-        },
-    });
     tools.add({
         name: "courier_children",
         options: { codemode: false },
         description: "List the sessions this one started with courier_spawn, with each one's state and last reply, and for one " +
             "started in a group, its group and whether its report is held, still out, or released, e.g. after a " +
-            "compaction or restart. Like courier_status, for a one-off look, not for waiting.",
+            "compaction or restart. For a one-off look, e.g. on a scheduled check-in, not for waiting: sessions you started report back on their own.",
         input: ChildrenInput,
         execute: async (input, context) => {
             const listed = await listChildren(ports.courier, input.sessionID || context.sessionID).catch(rethrow("courier_children"));

package/dist/tui.js

@@ -1457,6 +1457,8 @@ var Row = Schema3.Struct({
   report: Schema3.optionalKey(Schema3.Struct({ state: Schema3.Literals(["owed", "reported", "ended"]), status: Schema3.optionalKey(Schema3.String), progressed: Schema3.Boolean })),
   group: Schema3.optionalKey(Schema3.Struct({ name: Schema3.String, standing: Schema3.String })),
   isolated: Schema3.Boolean,
+  native: Schema3.optionalKey(Schema3.Boolean),
+  model: Schema3.optionalKey(Schema3.String),
   created: Schema3.Number,
   idle: Schema3.optionalKey(Schema3.Number),
   cost: Schema3.optionalKey(Schema3.Number),
@@ -1740,6 +1742,12 @@ function statusParts(row, now = Date.now()) {
   }, {
     text: row.isolated ? "isolated" : "",
     kind: "plain"
+  }, {
+    text: row.native ? "native" : "",
+    kind: "plain"
+  }, {
+    text: row.model ?? "",
+    kind: "plain"
   }];
   return parts.filter((part) => part.text);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-courier",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "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,14 +56,14 @@
     "test:e2e": "e2e/run.sh"
   },
   "peerDependencies": {
-    "@opencode/plugin": "2.1.4",
+    "@opencode/plugin": "2.2.0",
     "effect": "4.0.1"
   },
   "devDependencies": {
-    "@opencode/plugin": "2.1.4",
-    "@opencode/theme": "2.1.4",
-    "@opentui/core": "0.6.8",
-    "@opentui/solid": "0.6.8",
+    "@opencode/plugin": "2.2.0",
+    "@opencode/theme": "2.2.0",
+    "@opentui/core": "0.7.0",
+    "@opentui/solid": "0.7.0",
     "@types/bun": "1.4.2",
     "@types/node": "26.6.4",
     "effect": "4.0.1",