@te-river/opencode-team-mode 1.5.14 → 1.6.0

package/dist/tm/dispatch.d.ts

@@ -1,29 +1,33 @@
 /**
- * tm_dispatch / tm_join — ASYNC sub-agent dispatch (issue #7 of 2026-09-18).
+ * tm_join — the COLLECT side of sub-agent work (issue #7 of 2026-09-18; the
+ * dispatch side was removed in 1.5.16).
  *
- * Why this exists: the host's built-in `task` tool blocks the CALLING
- * session until the child agent returns, so "the team runs in parallel" was
- * only half true — the lead stood still for the sum of every dispatch, and
- * each child's full reply landed in the lead's context whether it needed it
- * there or not.  OpenCode hands plugins its own client (`input.client`), and
- * the official session API has `create` + `promptAsync` — "start if needed
- * and return IMMEDIATELY" — so a plugin-owned dispatcher gets real overlap
- * without touching a line of host code.  If a future host ever removes that
- * surface, both tools degrade with an explicit instruction to fall back to
- * `task`, rather than failing the round.
+ * What is gone and why: this module used to own a plugin-side dispatcher,
+ * `tm_dispatch`, which bought the lead real overlap by creating child sessions
+ * through `client.session.create` + `promptAsync`.  It was removed on the
+ * user's instruction, because a child a plugin creates is a session the user
+ * can neither open from the tool card nor stop from the interface — the host
+ * renders only its own built-in tools, and only its own `task` card links to a
+ * live child session.  "The lead can `cancel:true` it" is not the same thing as
+ * the user being able to.  Delegation therefore goes back to the host's `task`
+ * (and `task { background: true }`, which the installers switch on), and what
+ * stays here is the half that is still ours to do: observing and collecting
+ * children, which is also how the lead reads back a reply that
+ * `src/task-offload.ts` replaced with a pointer.
  *
  * Contract kept from T3 (no sub-agent spawns a sub-agent):
- *   - `tm_dispatch` executes ONLY for the team lead (ctx.agent check here,
- *     plus an explicit deny for the five specialists in agents.ts — the
- *     tm_* wildcard would otherwise hand it to everyone);
- *   - children are the five named specialists, never "team";
- *   - the child session is parented to the lead session (parentID), so the
- *     host's own session tree, cancellation and UI still make sense.
+ *   - `tm_join` executes ONLY for the team lead (ctx.agent check here, plus an
+ *     explicit deny for the five specialists in agents.ts — the tm_* wildcard
+ *     would otherwise hand it to everyone);
+ *   - the children it knows about are the five named specialists, never "team";
+ *   - everything it touches is parented to the calling session (parentID), and
+ *     parentage is READ BACK from the host before an id is claimed — this module
+ *     never assumes a session belongs to the caller.
  *
  * Context economy (design goal #4): tm_join renders each child's reply
- * through the SAME governance pipeline as every other tm_* tool, so five
- * long sub-agent reports become five handles + 80-token previews that the
- * lead can page through with tm_fetch — not 5×N kilotokens dumped inline.
+ * through the SAME governance pipeline as every other tm_* tool, so a long
+ * sub-agent report arrives as a handle + an 80-token preview the lead can page
+ * through with tm_fetch — not kilotokens dumped inline.
  */
 import type { HostEvent, ToolDefinition } from "../types.js";
 import type { TmPipelines } from "./pipelines.js";
@@ -59,28 +63,93 @@ export interface DispatchDeps {
     onChildSession?: (sessionID: string, agent: string) => void;
     /** Injectable clock for tests. */
     now?: () => number;
+    /** tm_browser's live lease table (id + owning session + idle).  tm_join uses
+     *  it to report a child that settled while still holding a visible window —
+     *  see the lease tripwire. Absent = the check is skipped, never assumed. */
+    browserLeases?: () => {
+        id: string;
+        owner: string;
+        agent: string;
+        idleMs: number;
+    }[];
     /** Ceiling on how long tm_join will wait on a round of children. */
     maxWaitMs?: number;
 }
 interface SessionApi {
-    create?: (opts: unknown) => Promise<unknown>;
-    promptAsync?: (opts: unknown) => Promise<unknown>;
     messages?: (opts: unknown) => Promise<unknown>;
+    get?: (opts: unknown) => Promise<unknown>;
     status?: (opts: unknown) => Promise<unknown>;
     abort?: (opts: unknown) => Promise<unknown>;
     /** GET /session/{id}/children -> Session[] — the host's own session tree,
      *  i.e. the recovery source when this process never saw the dispatch. */
     children?: (opts: unknown) => Promise<unknown>;
+    /** GET /session/{id}/todo -> Todo[] — READ-ONLY (the SDK gives no write
+     *  body; writing is the built-in `todowrite` tool's job).  We use it as the
+     *  goal tripwire below. */
+    todo?: (opts: unknown) => Promise<unknown>;
 }
-/** Resolve the host session API defensively — a missing namespace means the
- *  host does not speak this protocol, and the caller must degrade. */
+/** Open items on the host's own todo list, in the shape tm_join reports. */
+export interface HostTodo {
+    content: string;
+    status: string;
+}
+export declare function openHostTodos(todos: unknown): HostTodo[];
+/** #80: the line tm_join adds when a SETTLED child still owns a browser window.
+ *  Takes only the leases already filtered to settled children, so the ownership
+ *  rule stays where the child registry is; this function's whole job is to say
+ *  it in the one shape that survives the lead's skimming — and to refuse to say
+ *  it for a window that was never ours. */
+export declare function leaseTripwire(held: readonly {
+    id: string;
+    owner: string;
+    agent: string;
+    idleMs: number;
+}[], callerSessionID?: string): string | null;
+/** Resolve the host session API defensively — `messages` is what tm_join
+ *  cannot work without (the collected reply); a host without it means the
+ *  caller must degrade, and `create`/`promptAsync` are deliberately NOT part
+ *  of this contract any more: nothing here spawns sessions. */
 export declare function sessionApiOf(client: unknown): SessionApi | null;
-/** The title `tm_dispatch` gives every child session.  `parseDispatchTitle`
- *  is the discriminator on the way back: a child the host lists but this
- *  process never created is OURS only if this shape (and a known agent)
- *  matches — otherwise it belongs to the built-in `task` tool and we must
- *  not claim its reply. */
-export declare function dispatchTitle(agent: string, label: string): string;
+/** The host's OWN visible-and-non-blocking sub-agent path: its built-in `task`
+ *  takes `background: true`, and because that card is rendered by the host's
+ *  own `task` renderer it links to the live child session — which a plugin tool
+ *  card structurally cannot do.  Gated behind a runtime flag (verified in the
+ *  desktop binary): `OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS`, falling back
+ *  to the umbrella `OPENCODE_EXPERIMENTAL`.  We read the SAME env the host
+ *  reads — our plugin runs inside that process — so this is a fact, not a
+ *  guess. */
+export declare function hostBackgroundSubagentsEnabled(env?: NodeJS.ProcessEnv): boolean;
+/** What a tm_join wait may actually cost.  The FIRST bounded wait gets the
+ *  requested budget (clamped to TM_JOIN_MAX_WAIT_MS); a wait that follows a
+ *  wait which settled nothing gets cut to REPEAT_WAIT_MS, because the second
+ *  one is the shape of a lead parking instead of working — measured live at
+ *  2 × 300 s of nothing while six children ran. */
+export declare const REPEAT_WAIT_MS = 10000;
+export declare function joinBudget(waitMs: number, maxWaitMs: number, prev: {
+    stillRunning: number;
+    streak: number;
+} | undefined): {
+    budget: number;
+    repeat: boolean;
+    streak: number;
+};
+/** Recognise the title a `tm_dispatch` child used to carry — the tool is no
+ *  longer registered (a plugin-spawned child is a session the user can neither
+ *  open from a card nor stop from the UI), but children created before the
+ *  change are still live in the host's session tree and tm_join must still
+ *  collect them.
+ *
+ *  The shape was the host's OWN subagent convention — the built-in task tool
+ *  titles its children `${description} (@${agent} subagent)` (verified in the
+ *  desktop binary), which is what the renderer's `taskSession()` heuristic
+ *  reads to colour a child row.  Ours added a ` ·tm` marker inside that shape,
+ *  and the marker is LOAD-BEARING in both directions: it is what tells a
+ *  leftover dispatch apart from a host `task` child, so an automatic tree walk
+ *  never claims a reply that belongs to the host's dispatcher.  The pre-1.5.15
+ *  shape (`tm:<agent>:<label>`) still parses for the same reason — a session
+ *  that exists must stay collectable.  A child named explicitly by id takes a
+ *  different path (`claimNamedChild`), where the lock is the host's own
+ *  parentage rather than the title. */
 export declare function parseDispatchTitle(title: unknown, targets: readonly string[]): {
     agent: string;
     label: string;
@@ -99,9 +168,21 @@ export declare function parseDispatchTitle(title: unknown, targets: readonly str
 export declare function lastAssistantMessage(messages: unknown): {
     text: string;
     completedAt?: number;
+    error?: string;
 };
 /** Back-compat seam: the reply text alone. */
 export declare function lastAssistantText(messages: unknown): string;
+/**
+ * Turn whatever the host puts in an error slot into ONE readable line.
+ *
+ * The live host nests them (`{name, data:{message, ref}}`, `{error:{message}}`,
+ * a bare string — sometimes several at once), and `String(obj)` is
+ * "[object Object]".  That is what a lead reported to a user for three child
+ * sessions that died at launch: the one diagnostic the whole flow had was
+ * destroyed by our own rendering.  Never again: dig the known fields, then
+ * fall back to a compact key dump — never a bare object stringify.
+ */
+export declare function describeHostError(err: unknown, max?: number): string;
 /** One child's status line — the lead reads these, so keep them terse. */
 export declare function renderChildLine(c: ChildRecord, elapsedMs: number): string;
 /** Verdicts tm_join can actually observe (issue #7's "leader keeps control"). */
@@ -110,8 +191,14 @@ export declare function summarizeStates(children: readonly ChildRecord[]): {
     idle: number;
     error: number;
 };
+/** `ids` arrives in three shapes on the live host: a real array, a
+ *  JSON-array STRING (`"[\"ses_x\"]"` — what a model actually sent on
+ *  2026-09-19), or a comma-separated list.  Array.isArray alone silently
+ *  ignored the string form and returned EVERY child when the lead asked for
+ *  one, which is the same class of bug as the old `Boolean("false")` headless
+ *  trap: the arg is trusted because it "looks" like the declared type. */
+export declare function parseIdList(raw: unknown): string[] | null;
 export declare function buildDispatchTools(deps: DispatchDeps): {
-    tm_dispatch: ToolDefinition;
     tm_join: ToolDefinition;
     /** Feed the host event bus: `session.idle` / `session.error` /
      *  `session.status` mark children settled without polling. */

package/dist/tm/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/tm/dispatch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/tm/dispatch.ts"],"names":[],"mappings":"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"}