@automatalabs/acp-agents 0.35.2 → 0.36.0

package/dist/acp-client.js

@@ -42,6 +42,17 @@ const CLIENT_INFO = {
 const CLAUDE_RAW_MESSAGE_METHOD = "_claude/sdkMessage";
 /** Cross-agent vendor extension for injecting content into a live prompt turn. */
 export const SESSION_STEERING_METHOD = "_session/steering";
+/** Cross-agent vendor extension carrying turn-TERMINAL state for LOADED sessions (the re-attach
+ *  arm's authoritative completion evidence — see `InteractiveSession.awaitCurrentTurn`): the
+ *  `_session/loaded_turn/query` request answers whether the loaded session's founding turn is
+ *  still running at the backend ("running"), observably completed while the host was down
+ *  ("completed" — the replay's trailing assistant message is the turn's FINAL message), or ended
+ *  without a terminal message ("interrupted" — nothing is running, re-issue is safe), and the
+ *  `_session/loaded_turn/ended` notification fires when a turn that was "running" at query time
+ *  ends (with its stop reason, or its error). Backends without the extension degrade
+ *  guest-visibly through the same strict advertisement gate as steering. */
+export const LOADED_TURN_QUERY_METHOD = "_session/loaded_turn/query";
+export const LOADED_TURN_ENDED_METHOD = "_session/loaded_turn/ended";
 /** Bound the best-effort session/close round-trip so a slow agent can't hang run()'s finally. */
 const CLOSE_SESSION_TIMEOUT_MS = 5_000;
 /** Grace for a cancelled prompt/config lifecycle to settle before close + process quarantine. */
@@ -198,6 +209,56 @@ class SessionState {
     modes;
     turnStartIndex = 0;
     finalMessageStartIndex = 0;
+    /** The re-attach arm's transcript probe (phase D): where the LOADED
+     *  session's founding turn starts — the assistant-text length after the
+     *  LAST replayed user message (the founding turn's prompt). Tracked from
+     *  the session/update stream; only meaningful for sessions re-opened via
+     *  `session/load` (whose replay streams in BEFORE the load response). */
+    loadedTurnStartIndex = 0;
+    /** Whether the transcript ever showed a user message (a turn started at
+     *  all — a session whose replay has none never received its prompt). */
+    sawUserMessage = false;
+    /** The KIND of the transcript's last content event: an assistant message
+     *  chunk is a PROGRESS event, never a terminal marker by itself — the
+     *  re-attach arm's completion evidence is a terminal assistant message
+     *  on a SETTLED stream (no updates for the loaded-turn settle grace),
+     *  not a trailing chunk at an arbitrary instant (phase-D review: a
+     *  trailing chunk used to be treated as proof of completion, so partial
+     *  output of a still-streaming turn could be settled as success). Any
+     *  other trailing content (a user message, a tool call, a thought, a
+     *  plan) means the founding turn ended without a terminal message —
+     *  not observable as a successful completion. */
+    trailingContentKind = 'other';
+    /** Monotonic wall-clock of the session's most recent update (the
+     *  re-attach arm's stream-settled probe — `applyUpdate` is synchronous
+     *  on the wire, so this is the authoritative last-progress instant). */
+    lastUpdateAt = Date.now();
+    /** The re-attach arm's update watchers (woken by every session/update). */
+    updateWatchers = new Set();
+    /**
+     * The load boundary — the phase-D review round-2 fix for the re-attach
+     * arm's completion evidence. `session/load` obliges the agent to replay
+     * the ENTIRE persisted conversation and only then resolve the request,
+     * so the transcript is complete AT load resolution; anything applied
+     * after that instant is LIVE CONTINUATION evidence of a turn still
+     * running at the backend. `markLoadBoundary()` (called by the runner
+     * synchronously after the load response) snapshots the replay-complete
+     * state, and every CONTENT update applied after the mark flips
+     * `sawPostLoadContentUpdate` — the seam's "the turn may still be
+     * running" signal. Bookkeeping updates (usage, mode, available
+     * commands, session info) are NOT continuation evidence (claude's
+     * adapter emits an `available_commands_update` right after every
+     * load).
+     */
+    loadBoundary = null;
+    sawPostLoadContentUpdate = false;
+    /** The loaded-turn TERMINAL state (the `_session/loaded_turn` extension's authoritative
+     *  completion evidence): the `_session/loaded_turn/ended` notification this session received
+     *  (a turn that was running at load ended), or null when no such notification arrived. The
+     *  seam's `awaitCurrentTurn` waits on this instead of guessing from a quiet gap. */
+    loadedTurnEnded = null;
+    /** The loaded-turn-ended watchers (woken by every ended notification). */
+    loadedTurnEndedWatchers = new Set();
     /** `label`/`runId`/`callIndex` are carried here ONLY so the MultiplexClient can stamp them onto emitted
      *  events as context — they never affect routing or the wire request. */
     constructor(cwd, policy, permissionResolver, elicitationResolver, label, runId, callIndex, initializeMeta, modes, mcpServerIds = [], retainSessionLog = true) {
@@ -241,8 +302,17 @@ class SessionState {
         return this.textChunks.slice(this.finalMessageStartIndex).join("");
     }
     applyUpdate(update) {
+        this.lastUpdateAt = Date.now();
+        // A CONTENT update applied after the load boundary is live-continuation
+        // evidence (a turn still running at the backend). Bookkeeping update
+        // kinds never flip the flag — the seam must not mistake claude's
+        // post-load `available_commands_update` for a running turn.
+        if (this.loadBoundary !== null && isContentUpdate(update.sessionUpdate)) {
+            this.sawPostLoadContentUpdate = true;
+        }
         switch (update.sessionUpdate) {
             case "agent_message_chunk": {
+                this.trailingContentKind = 'assistant-message';
                 if (update.content.type === "text") {
                     this.textChunks.push(update.content.text);
                     this.history.push({
@@ -255,6 +325,7 @@ class SessionState {
                 break;
             }
             case "tool_call": {
+                this.trailingContentKind = 'other';
                 this.finalMessageStartIndex = this.textChunks.length;
                 this.history.push({
                     role: "tool",
@@ -267,13 +338,32 @@ class SessionState {
             }
             // Any other CONTENT event also ends the in-flight assistant message — text streamed after
             // it belongs to a new message. Bookkeeping updates (usage, mode) never break a message.
-            case "user_message_chunk":
+            case "user_message_chunk": {
+                // The loaded-session founding-turn probe (see the fields above): the
+                // LAST user message in the replay is the founding turn's prompt, and
+                // its assistant text starts after it.
+                this.sawUserMessage = true;
+                this.loadedTurnStartIndex = this.textChunks.length;
+                this.trailingContentKind = 'other';
+                this.finalMessageStartIndex = this.textChunks.length;
+                break;
+            }
             case "agent_thought_chunk":
             case "tool_call_update":
             case "plan": {
+                // A trailing thought/tool/plan event means the model is still
+                // working — the founding turn is not observably complete.
+                this.trailingContentKind = 'other';
                 this.finalMessageStartIndex = this.textChunks.length;
                 break;
             }
+            case "plan_update":
+            case "plan_removed": {
+                // Plan mutations are content progress but never a completed
+                // assistant message; they do not segment the final message.
+                this.trailingContentKind = 'other';
+                break;
+            }
             case "usage_update": {
                 this.usage.recordCost(update.cost);
                 // Also feed the context token counts so AgentUsage.total is non-zero for backends
@@ -294,12 +384,121 @@ class SessionState {
             default:
                 break;
         }
+        // Wake the re-attach arm's stream watchers after EVERY update kind
+        // (any update — chunk, thought, tool call, usage — resets the loaded
+        // turn's settle clock; the seam's quiet wait keys on this).
+        for (const watcher of this.updateWatchers)
+            watcher();
     }
     applyRawMessage(message) {
         if (message && message.type === "result" && message.subtype === "success") {
             this.rawResultSuccess = message;
         }
     }
+    /** The loaded-session founding-turn observability probe: whether the
+     *  transcript shows a turn ever started (a user message) and the KIND of
+     *  the trailing content event. The trailing kind is PROGRESS evidence,
+     *  not completion by itself — the re-attach arm classifies completion
+     *  from the LOAD BOUNDARY (the transcript as of load resolution) plus
+     *  whether any content update followed the load (see
+     *  `loadBoundaryState` and `InteractiveSession.awaitCurrentTurn`). */
+    loadedTurnState() {
+        return {
+            hasUserMessage: this.sawUserMessage,
+            trailingContentKind: this.trailingContentKind,
+        };
+    }
+    /** The most recent instant a session/update arrived for this session
+     *  (the re-attach arm's stream-settled clock; `applyUpdate` runs
+     *  synchronously on the wire, so the timestamp is authoritative). */
+    lastUpdateAtMs() {
+        return this.lastUpdateAt;
+    }
+    /**
+     * Mark the load boundary (see the field docs): called by the runner
+     * synchronously after the `session/load` response, when the replay is
+     * complete and the transcript holds the entire persisted conversation.
+     * Idempotent: the FIRST mark wins (a re-load over the same handle keeps
+     * the original boundary).
+     */
+    markLoadBoundary() {
+        if (this.loadBoundary !== null)
+            return;
+        this.loadBoundary = {
+            hasUserMessage: this.sawUserMessage,
+            trailingContentKind: this.trailingContentKind,
+        };
+        this.sawPostLoadContentUpdate = false;
+    }
+    /**
+     * The load-boundary probe (the re-attach arm's completion evidence;
+     * see `InteractiveSession.awaitCurrentTurn`): the replay-complete
+     * transcript state captured at load resolution, plus whether any
+     * CONTENT update arrived after the boundary (live-continuation
+     * evidence). `marked: false` when the handle was never load-marked (a
+     * session that did not come from the runner's `loadSession` path) —
+     * the seam refuses rather than guessing.
+     */
+    loadBoundaryState() {
+        return {
+            marked: this.loadBoundary !== null,
+            hasUserMessage: this.loadBoundary?.hasUserMessage ?? this.sawUserMessage,
+            trailingContentKind: this.loadBoundary?.trailingContentKind ?? this.trailingContentKind,
+            sawPostLoadContentUpdate: this.sawPostLoadContentUpdate,
+        };
+    }
+    /** Record the loaded-turn terminal notification (a turn that was
+     *  running at load ended — with its stop reason, or its error) and
+     *  wake the seam's watchers. Idempotent per session: the FIRST ended
+     *  notification wins (a re-sent notification after a reconnect cannot
+     *  overwrite the recorded terminal state). */
+    recordLoadedTurnEnded(notification) {
+        if (this.loadedTurnEnded !== null)
+            return;
+        this.loadedTurnEnded = {
+            ...(notification.stopReason !== undefined ? { stopReason: notification.stopReason } : {}),
+            ...(notification.error !== undefined ? { error: notification.error } : {}),
+        };
+        for (const watcher of this.loadedTurnEndedWatchers)
+            watcher();
+    }
+    /** The recorded loaded-turn terminal state, or null when the running
+     *  turn has not ended (yet). */
+    loadedTurnEndedState() {
+        return this.loadedTurnEnded;
+    }
+    /** Watch the loaded-turn-ended channel: the listener fires when the
+     *  `_session/loaded_turn/ended` notification arrives (and immediately
+     *  for a notification that already arrived). Returns the unsubscribe
+     *  thunk. The re-attach arm's authoritative terminal wait. */
+    subscribeLoadedTurnEnded(listener) {
+        if (this.loadedTurnEnded !== null) {
+            queueMicrotask(listener);
+            return () => { };
+        }
+        this.loadedTurnEndedWatchers.add(listener);
+        return () => {
+            this.loadedTurnEndedWatchers.delete(listener);
+        };
+    }
+    /** Watch the session/update stream: the listener fires after every
+     *  applied update. Returns the unsubscribe thunk. The re-attach arm
+     *  waits on this instead of polling, so a long still-running turn is
+     *  observed with zero busy work. */
+    subscribeUpdates(listener) {
+        this.updateWatchers.add(listener);
+        return () => {
+            this.updateWatchers.delete(listener);
+        };
+    }
+    /** The founding turn's assistant text: the transcript accumulated after
+     *  the last user-message boundary (the outcome text the re-attach arm
+     *  resolves with — identical to `finalMessageText()` exactly when the
+     *  trailing content event is an assistant message, which is the probe's
+     *  completeness condition). */
+    loadedTurnText() {
+        return this.textChunks.slice(this.loadedTurnStartIndex).join('');
+    }
     /** Settle every deferred permission still parked on this session. Used by release/cancel/death
      *  teardown so an interactive resolver can never strand an ACP prompt turn. */
     settlePendingPermissions() {
@@ -661,6 +860,31 @@ class MultiplexClient {
         }
     }
     extNotification(method, params) {
+        if (method === LOADED_TURN_ENDED_METHOD) {
+            // The loaded-turn terminal notification (the re-attach arm's
+            // authoritative completion evidence): route by sessionId and record
+            // the terminal state on the session (the seam's wait target).
+            const sessionId = typeof params.sessionId === "string" ? params.sessionId : undefined;
+            if (!sessionId)
+                return;
+            const state = this.sessions.get(sessionId);
+            if (!state)
+                return;
+            const raw = params.error;
+            const error = raw !== undefined && typeof raw === "object" && raw !== null
+                ? {
+                    name: typeof raw.name === "string" ? raw.name : "Error",
+                    message: typeof raw.message === "string"
+                        ? raw.message
+                        : String(raw.message),
+                }
+                : undefined;
+            const stopReason = typeof params.stopReason === "string"
+                ? params.stopReason
+                : undefined;
+            state.recordLoadedTurnEnded({ ...(stopReason !== undefined ? { stopReason } : {}), ...(error !== undefined ? { error } : {}) });
+            return;
+        }
         if (method !== CLAUDE_RAW_MESSAGE_METHOD)
             return;
         // claude-agent-acp stamps the owning sessionId on every raw _claude/sdkMessage; route by it
@@ -984,6 +1208,7 @@ export class PooledConnection {
         this.connection = client({ name: CLIENT_INFO.name })
             .onNotification(CLIENT_METHODS.session_update, ({ params }) => this.client.sessionUpdate(params))
             .onNotification(CLAUDE_RAW_MESSAGE_METHOD, (params) => (params ?? {}), ({ params }) => this.client.extNotification(CLAUDE_RAW_MESSAGE_METHOD, params))
+            .onNotification(LOADED_TURN_ENDED_METHOD, (params) => (params ?? {}), ({ params }) => this.client.extNotification(LOADED_TURN_ENDED_METHOD, params))
             .onNotification(CLIENT_METHODS.elicitation_complete, ({ params }) => this.client.elicitationComplete(params))
             .onRequest(CLIENT_METHODS.session_request_permission, ({ params }) => this.client.requestPermission(params))
             .onRequest(CLIENT_METHODS.elicitation_create, ({ params }) => this.client.requestElicitation(params))
@@ -1592,6 +1817,23 @@ export class PooledConnection {
         this.client.steeringResponse(request.sessionId, response.outcome);
         return response;
     }
+    /** Driven `_session/loaded_turn/query` extension request (the re-attach
+     *  arm's authoritative founding-turn classification): asks whether the
+     *  loaded session's founding turn is still running at the backend, or
+     *  ended while the host was down. Strictly capability-gated on the
+     *  initialize `_meta.loadedTurn.supported === true` advertisement — a
+     *  backend without the extension rejects before any wire request (the
+     *  "same gate" the seam's degradation keys on). */
+    async queryLoadedTurn(sessionId, label) {
+        await this.ready;
+        if (this.negotiated?.supportsLoadedTurnTerminalState !== true) {
+            throw new WorkflowError(`ACP agent (${this.backendId}) does not advertise ${LOADED_TURN_QUERY_METHOD}; ` +
+                "InitializeResponse._meta.loadedTurn.supported was not exactly true", WorkflowErrorCode.SCRIPT_VALIDATION_ERROR, { recoverable: false, agentLabel: label });
+        }
+        return this.rawAgentRequest(LOADED_TURN_QUERY_METHOD, {
+            sessionId,
+        });
+    }
     /** session/set_config_option on this connection, raced against process death. */
     setSessionConfigOption(request) {
         return this.race(this.connection.agent.request(AGENT_METHODS.session_set_config_option, request));
@@ -1968,6 +2210,61 @@ export class SessionHandle {
     rawStructuredOutput() {
         return this.state.rawResultSuccess?.structured_output;
     }
+    /** The loaded-session founding-turn observability probe (see
+     *  `InteractiveSession.awaitCurrentTurn`): whether the replayed transcript
+     *  shows a turn ever started, and the KIND of the trailing content event.
+     *  The trailing kind is PROGRESS evidence, never completion by itself —
+     *  the seam classifies completion from the LOAD BOUNDARY plus whether
+     *  any content update followed the load (see `loadBoundaryState`).
+     *  Added for the REPL broker's re-attach arm; additive passthrough to
+     *  `SessionState`. */
+    loadedTurnState() {
+        return this.state.loadedTurnState();
+    }
+    /** Mark the load boundary (see `markLoadBoundary` on `SessionState`):
+     *  the runner calls this synchronously after the `session/load` response
+     *  — the replay is complete at that instant, and any CONTENT update
+     *  applied afterwards is live-continuation evidence. */
+    markLoadBoundary() {
+        this.state.markLoadBoundary();
+    }
+    /** The load-boundary probe (see `loadBoundaryState` on `SessionState`). */
+    loadBoundaryState() {
+        return this.state.loadBoundaryState();
+    }
+    /** The most recent instant a session/update arrived for this session
+     *  (the re-attach arm's stream-settled clock). Added for the REPL
+     *  broker's re-attach arm; additive passthrough to `SessionState`. */
+    lastUpdateAtMs() {
+        return this.state.lastUpdateAtMs();
+    }
+    /** Watch the session/update stream (fires after every applied update;
+     *  returns the unsubscribe thunk). Added for the REPL broker's re-attach
+     *  arm; additive passthrough to `SessionState`. */
+    subscribeUpdates(listener) {
+        return this.state.subscribeUpdates(listener);
+    }
+    /** The founding turn's assistant text (the transcript accumulated after
+     *  the last user-message boundary). Added for the REPL broker's re-attach
+     *  arm; additive passthrough to `SessionState`. */
+    loadedTurnText() {
+        return this.state.loadedTurnText();
+    }
+    /** The recorded `_session/loaded_turn/ended` terminal state (the
+     *  re-attach arm's authoritative completion evidence), or null when a
+     *  running founding turn has not ended yet. Added for the REPL broker's
+     *  re-attach arm; additive passthrough to `SessionState`. */
+    loadedTurnEndedState() {
+        return this.state.loadedTurnEndedState();
+    }
+    /** Watch the loaded-turn-ended channel (fires when the
+     *  `_session/loaded_turn/ended` notification arrives — and immediately
+     *  when one already arrived). Returns the unsubscribe thunk. Added for
+     *  the REPL broker's re-attach arm; additive passthrough to
+     *  `SessionState`. */
+    subscribeLoadedTurnEnded(listener) {
+        return this.state.subscribeLoadedTurnEnded(listener);
+    }
     /** Cancel the active turn. A backend that does not settle within the grace window is closed and
      *  its pooled child is quarantined for recycle after sibling sessions drain. */
     async cancel() {
@@ -2053,3 +2350,25 @@ function flattenSelectOptions(options) {
     }
     return out;
 }
+/** Is this update kind CONTENT (a live turn's progress) rather than
+ *  bookkeeping? The re-attach arm's load-boundary classification: only
+ *  content updates are continuation evidence (a resumed turn streams
+ *  chunks/thoughts/tool calls/plans; usage/mode/command/session-info
+ *  updates are ambient bookkeeping — claude's adapter emits an
+ *  `available_commands_update` right after every load, live turn or
+ *  not). */
+function isContentUpdate(kind) {
+    switch (kind) {
+        case "user_message_chunk":
+        case "agent_message_chunk":
+        case "agent_thought_chunk":
+        case "tool_call":
+        case "tool_call_update":
+        case "plan":
+        case "plan_update":
+        case "plan_removed":
+            return true;
+        default:
+            return false;
+    }
+}

package/dist/backends/opencode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/backends/opencode.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EACV,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAuCvB,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,EAAE,WAIjC,CAAC;AAEF,qBAAa,eAAgB,YAAW,OAAO;IAGjC,QAAQ,CAAC,WAAW,EAAE,WAAW;IAF7C,QAAQ,CAAC,EAAE,EAAG,UAAU,CAAU;gBAEb,WAAW,GAAE,WAAiC;IAEnE,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,0BAA0B,QAAQ;IAE3C,qBAAqB,CACnB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,2BAA2B,GAAG,SAAS;IAW1C,WAAW,IAAI,WAAW;IAuB1B,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAKlD,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAO5E,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;CAKpD;AAED,eAAO,MAAM,yBAAyB,4DAmBpC,CAAC"}
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/backends/opencode.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EACV,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EACjB,MAAM,eAAe,CAAC;AA+DvB,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,EAAE,WAIjC,CAAC;AAEF,qBAAa,eAAgB,YAAW,OAAO;IAGjC,QAAQ,CAAC,WAAW,EAAE,WAAW;IAF7C,QAAQ,CAAC,EAAE,EAAG,UAAU,CAAU;gBAEb,WAAW,GAAE,WAAiC;IAEnE,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,0BAA0B,QAAQ;IAE3C,qBAAqB,CACnB,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,2BAA2B,GAAG,SAAS;IAW1C,WAAW,IAAI,WAAW;IA2B1B,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAKlD,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAO5E,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;CAKpD;AAED,eAAO,MAAM,yBAAyB,4DAmBpC,CAAC"}

package/dist/backends/opencode.js

@@ -2,9 +2,8 @@
 // a native structured-output result channel and ignores request._meta today, so the backend uses
 // the repo's generic schema dialect plus prompt embedding. When OpenCode advertises HTTP MCP, the
 // runner can also inject the client-hosted StructuredOutput MCP tool.
-import { randomUUID } from "node:crypto";
 import { copyFileSync, existsSync, mkdirSync } from "node:fs";
-import { homedir, tmpdir } from "node:os";
+import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { createRequire } from "node:module";
 import { META_KEYS } from "@automatalabs/shared-types";
@@ -14,20 +13,44 @@ import { toJsonSchema } from "../schema-strict.js";
 import { parseFinalJson } from "../structured-output.js";
 import { defineBuiltinBackend } from "./define.js";
 const require = createRequire(import.meta.url);
-/** Per-spawn OpenCode isolation env: fresh XDG data/state/cache trees seeded with the user's
+/** Per-spawn OpenCode isolation env: dedicated XDG data/state/cache trees seeded with the user's
  *  credentials, plus autoupdate off so a concurrent TUI upgrade never swaps state formats
- *  underneath a running server. Config (XDG_CONFIG_HOME) is deliberately NOT overridden. */
+ *  underneath a running server. Config (XDG_CONFIG_HOME) is deliberately NOT overridden.
+ *
+ *  The root is STABLE per user+host (phase-D review: it used to be a fresh random tmpdir per
+ *  spawn, so agent-persisted sessions lived in a tree no later process could reach — cross-
+ *  process `session/load` fell back to the runner's fresh-session path, and re-attachment was
+ *  not real for the opencode built-in despite it advertising `loadSession: true`). The stable
+ *  root keeps every spawned server's persisted sessions reachable by later processes — pool
+ *  recycles within one daemon AND daemon restarts — so the restore path's re-attach arm and the
+ *  lazy followUp re-attach both work. It lives OUTSIDE the user's real opencode data dir (a
+ *  sibling `agentprism/opencode` tree under the same data home), so the daemon's instances
+ *  never contend with the user's own interactive TUI for the sqlite store; the contention
+ *  protection that motivated the original isolation is retained for exactly that overlap. The
+ *  residual tradeoff: CONCURRENT daemon-spawned opencode processes (pool size > 1, or a recycle
+ *  overlapping its predecessor) share the stable tree, like every other backend shares the
+ *  user's real state — the documented anomalyco/opencode#31307 busy-wait risk is bounded to
+ *  that overlap instead of being traded away entirely.
+ *
+ *  `AGENTPRISM_OPENCODE_DATA_ROOT` overrides the root (tests and ops); the stable default is
+ *  `<data home>/agentprism/opencode` where the data home is the user's `XDG_DATA_HOME` (or
+ *  `~/.local/share`). */
 function isolatedOpenCodeEnv(base) {
-    const root = join(tmpdir(), `agentprism-opencode-${randomUUID()}`);
-    const dataHome = join(root, "data");
-    const dataDir = join(dataHome, "opencode");
+    const override = base.AGENTPRISM_OPENCODE_DATA_ROOT;
+    const dataHome = base.XDG_DATA_HOME && base.XDG_DATA_HOME.trim() !== ""
+        ? base.XDG_DATA_HOME
+        : join(homedir(), ".local", "share");
+    const root = override && override.trim() !== ""
+        ? override.trim()
+        : join(dataHome, "agentprism", "opencode");
+    const dataDir = join(root, "data", "opencode");
     const stateHome = join(root, "state");
     const cacheHome = join(root, "cache");
     mkdirSync(dataDir, { recursive: true });
     mkdirSync(stateHome, { recursive: true });
     mkdirSync(cacheHome, { recursive: true });
     // Credentials live in the REAL data dir; seed them so the isolated instance authenticates.
-    // Refresh-token write-back stays in the isolated copy — re-auth churn is the accepted cost of
+    // Refresh-token write-back stays in the dedicated tree — re-auth churn is the accepted cost of
     // not letting concurrent instances revoke each other's tokens (anomalyco/opencode#37059).
     const sourceData = base.XDG_DATA_HOME && base.XDG_DATA_HOME.trim() !== ""
         ? join(base.XDG_DATA_HOME, "opencode")
@@ -38,7 +61,7 @@ function isolatedOpenCodeEnv(base) {
             copyFileSync(source, join(dataDir, file));
     }
     return {
-        XDG_DATA_HOME: dataHome,
+        XDG_DATA_HOME: join(root, "data"),
         XDG_STATE_HOME: stateHome,
         XDG_CACHE_HOME: cacheHome,
         OPENCODE_DISABLE_AUTOUPDATE: "1",
@@ -76,12 +99,16 @@ export class OpenCodeBackend {
         // auth.json. Overlapping processes — routine since process-exclusive injected pooling
         // (#292) — surface that as mid-run "ACP connection closed" and cross-instance auth
         // revocation (upstream: anomalyco/opencode#31307, #29395, #21215, #38366, #37059).
-        // Give every spawned server its own XDG data/state/cache trees with credentials seeded in
-        // (OPENCODE_DB alone is insufficient per #33321 — the snapshot gitdir stays shared).
-        // XDG_CONFIG_HOME stays shared so the user's opencode.jsonc and providers apply, and an
-        // explicitly exported OPENCODE_DB still wins over the isolated tree's database. Tradeoff:
-        // agent-persisted sessions live in the spawned process's isolated tree, so cross-process
-        // session/load|resume falls back to the runner's fresh-session path.
+        // Every spawned server gets its own dedicated XDG data/state/cache trees with credentials
+        // seeded in (OPENCODE_DB alone is insufficient per #33321 — the snapshot gitdir stays
+        // shared). The root is STABLE per user+host (phase-D review: it used to be a random
+        // tmpdir per spawn, which made cross-process session/load|resume fall back to the
+        // runner's fresh-session path — re-attachment was not real for opencode); persisted
+        // sessions therefore survive pool recycles and daemon restarts. The dedicated tree sits
+        // OUTSIDE the user's live opencode data dir, so the daemon's instances never overlap the
+        // user's own TUI — the contention the isolation exists for — and XDG_CONFIG_HOME stays
+        // shared so the user's opencode.jsonc and providers apply. An explicitly exported
+        // OPENCODE_DB still wins over the dedicated tree's database.
         const env = { ...process.env, ...isolatedOpenCodeEnv(process.env) };
         const override = env.AGENTPRISM_OPENCODE_ACP_CMD;
         if (override) {

package/dist/capabilities.d.ts

@@ -24,6 +24,12 @@ export interface NegotiatedCapabilities {
      *  top-level initialize-response `_meta.steering.supported === true` contract. This is
      *  intentionally independent of agentCapabilities._meta, which gates outgoing custom metadata. */
     supportsSteering: boolean;
+    /** Whether the agent advertises the `_session/loaded_turn` vendor extension through the
+     *  top-level initialize-response `_meta.loadedTurn.supported === true` contract: the
+     *  loaded-session founding-turn TERMINAL STATE channel (the re-attach arm's authoritative
+     *  completion evidence — see `InteractiveSession.awaitCurrentTurn`). Same strict parse and
+     *  same independence from agentCapabilities._meta as steering. */
+    supportsLoadedTurnTerminalState: boolean;
     /** Whether session/close is advertised (gates the best-effort release-time close). */
     supportsClose: boolean;
     /** Whether session/load is advertised. The current SDK keeps this as the legacy top-level

package/dist/capabilities.d.ts.map

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

package/dist/capabilities.js

@@ -45,6 +45,9 @@ export function negotiateCapabilities(response, customCapabilities) {
         // Steering is an initialize-response extension advertisement. Never infer it from the
         // backend name/version or from agentCapabilities._meta (the separate outgoing-meta gate).
         supportsSteering: advertisesSteering(response._meta),
+        // The loaded-turn terminal-state extension rides the same initialize-response `_meta`
+        // advertisement channel (strict `loadedTurn.supported === true`), never inferred.
+        supportsLoadedTurnTerminalState: advertisesLoadedTurn(response._meta),
         supportsClose: advertised(sessionCapabilities?.close),
         supportsLoadSession: agent.loadSession === true || advertised(sessionCapabilities?.load),
         supportsListSessions: advertised(sessionCapabilities?.list),
@@ -59,6 +62,18 @@ export function negotiateCapabilities(response, customCapabilities) {
         gatedKeys: customCapabilities ? [...customCapabilities.gatedKeys] : undefined,
     };
 }
+/** Strict, defensive parser for the top-level loaded-turn extension advertisement. Only the
+ *  exact boolean true is support; absent, null, malformed, array, string, numeric, and truthy
+ *  values are all unsupported. */
+function advertisesLoadedTurn(meta) {
+    if (!meta || typeof meta !== "object" || Array.isArray(meta))
+        return false;
+    const loadedTurn = meta.loadedTurn;
+    return Boolean(loadedTurn &&
+        typeof loadedTurn === "object" &&
+        !Array.isArray(loadedTurn) &&
+        loadedTurn.supported === true);
+}
 /** Strict, defensive parser for the top-level steering extension advertisement. Only the exact
  *  boolean true is support; absent, null, malformed, array, string, numeric, and truthy values are
  *  all unsupported. */

package/dist/index.d.ts

@@ -9,13 +9,14 @@ export type { ProviderIntent } from "./provider-store.js";
 export { claudeAuthProfile, codexAuthProfile, opencodeAuthProfile, piAuthProfile } from "./auth/auth-profiles.js";
 export type { AuthProfile, TerminalLaunch } from "./auth/auth-profile.js";
 export { InteractiveSession } from "./interactive.js";
+export { LoadedTurnFailedError, LoadedTurnStillRunningError, isLoadedTurnFailedError, isLoadedTurnStillRunningError, } from "./interactive.js";
 export type { InteractiveSessionOptions, InteractiveTurn } from "./interactive.js";
 export { AGENT_METHODS, CLIENT_METHODS } from "@agentclientprotocol/sdk";
 export type { AgentNotificationMethod, AgentNotificationParamsByMethod, AgentAuthCapabilities, AgentRequestMethod, AgentRequestParamsByMethod, AgentRequestResponsesByMethod, AuthCapabilities, AuthEnvVar, AuthenticateRequest, AuthenticateResponse, AuthMethod, AuthMethodAgent, AuthMethodEnvVar, AuthMethodId, AuthMethodTerminal, DisableProviderRequest, DisableProviderResponse, CompleteElicitationNotification, ConnectMcpRequest, ConnectMcpResponse, CreateElicitationRequest, CreateElicitationResponse, DeleteSessionRequest, DeleteSessionResponse, DisconnectMcpRequest, DisconnectMcpResponse, ElicitationAcceptAction, ElicitationCapabilities, ElicitationContentValue, ElicitationFormCapabilities, ElicitationFormMode, ElicitationId, ElicitationPropertySchema, ElicitationRequestScope, ElicitationSchema, ElicitationSchemaType, ElicitationSessionScope, ElicitationUrlCapabilities, ElicitationUrlMode, ForkSessionRequest, ForkSessionResponse, ListProvidersRequest, ListProvidersResponse, ListSessionsRequest, ListSessionsResponse, LlmProtocol, LoadSessionRequest, LoadSessionResponse, LogoutCapabilities, LogoutRequest, LogoutResponse, McpConnectionId, McpServerAcp, McpServerAcpId, MessageMcpNotification, MessageMcpRequest, MessageMcpResponse, ResumeSessionRequest, ResumeSessionResponse, ProviderCurrentConfig, ProviderId, ProviderInfo, ProvidersCapabilities, SessionMode, SessionModeState, SessionConfigOption, SessionInfo, SendRequestOptions, SetProviderRequest, SetProviderResponse, } from "@agentclientprotocol/sdk";
 export { BACKENDS_ENV, registryWithRunBackends, resolveBackendRegistry } from "./registry.js";
 export type { BackendRegistry, CustomBackendConfig, RegisteredBackend } from "./registry.js";
-export { CANCEL_NOT_HONORED_GRACE_MS, PI_CHILD_CLEANUP_DEADLINE_MS, PI_CLOSE_DELIVERY_MARGIN_MS, PI_CLOSE_SESSION_TIMEOUT_MS, PI_DISPOSE_SIGKILL_GRACE_MS, PI_PROCESS_EXIT_MARGIN_MS, PI_PROCESS_SHUTDOWN_ENVELOPE_MS, PooledConnection, SESSION_STEERING_METHOD, SessionHandle, isChildCleanupError, } from "./acp-client.js";
-export type { AcpSessionOptions, PooledConnectionDeps, SteeringOutcome, SteeringRequest, SteeringResponse, } from "./acp-client.js";
+export { CANCEL_NOT_HONORED_GRACE_MS, PI_CHILD_CLEANUP_DEADLINE_MS, PI_CLOSE_DELIVERY_MARGIN_MS, PI_CLOSE_SESSION_TIMEOUT_MS, PI_DISPOSE_SIGKILL_GRACE_MS, PI_PROCESS_EXIT_MARGIN_MS, PI_PROCESS_SHUTDOWN_ENVELOPE_MS, PooledConnection, SESSION_STEERING_METHOD, LOADED_TURN_QUERY_METHOD, LOADED_TURN_ENDED_METHOD, SessionHandle, isChildCleanupError, } from "./acp-client.js";
+export type { AcpSessionOptions, PooledConnectionDeps, SteeringOutcome, SteeringRequest, SteeringResponse, LoadedTurnQueryRequest, LoadedTurnQueryResponse, LoadedTurnEndedNotification, LoadedTurnStatus, } from "./acp-client.js";
 export { AGENT_METHOD_COVERAGE, ACP_EXTENSION_SUPPORT_MATRIX, ACP_AUTH_REQUIRED_CODE_EXCLUSIVE, AUTH_CAPABILITY_KEYS, AUTH_META_CONVENTION_KEYS, AUTH_META_MATRIX, CLIENT_METHOD_COVERAGE, CODEX_SPAWN_AUTH_ENV, HANDLED_AUTH_METHOD_TYPES, PI_ACP_PROTOCOL_CONTRACT, BUILTIN_PROTOCOL_COVERAGE, assertAuthCapabilityShape, } from "./protocol-coverage.js";
 export type { AgentMethodCoverage, AcpExtensionSupportMatrixRow, AuthMetaMatrixRow, BuiltinProtocolCoverageRow, ClientMethodCoverage, } from "./protocol-coverage.js";
 export { GATED_CUSTOM_META_KEYS, adaptPromptContent, gateCustomMeta, isSupportedProtocolVersion, negotiateCapabilities, unsupportedMcpServer, } from "./capabilities.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACtG,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,SAAS,EACT,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClH,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EACV,uBAAuB,EACvB,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,6BAA6B,EAC7B,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC9F,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7F,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,+BAA+B,EAC/B,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,gCAAgC,EAChC,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,6BAA6B,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClG,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,OAAO,EACP,SAAS,EACT,2BAA2B,EAC3B,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpF,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEvG,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7F,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,EAAE,4BAA4B,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1F,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACtG,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,SAAS,EACT,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClH,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EACV,uBAAuB,EACvB,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,6BAA6B,EAC7B,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC9F,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7F,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,+BAA+B,EAC/B,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,gCAAgC,EAChC,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,6BAA6B,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClG,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,OAAO,EACP,SAAS,EACT,2BAA2B,EAC3B,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpF,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEvG,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7F,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,EAAE,4BAA4B,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1F,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -15,10 +15,11 @@ export { ProviderStore } from "./provider-store.js";
 // backends supply none (conformance-by-absence, §3.5).
 export { claudeAuthProfile, codexAuthProfile, opencodeAuthProfile, piAuthProfile } from "./auth/auth-profiles.js";
 export { InteractiveSession } from "./interactive.js";
+export { LoadedTurnFailedError, LoadedTurnStillRunningError, isLoadedTurnFailedError, isLoadedTurnStillRunningError, } from "./interactive.js";
 export { AGENT_METHODS, CLIENT_METHODS } from "@agentclientprotocol/sdk";
 // The custom-backend registry: run ANY ACP agent as an agent() target.
 export { BACKENDS_ENV, registryWithRunBackends, resolveBackendRegistry } from "./registry.js";
-export { CANCEL_NOT_HONORED_GRACE_MS, PI_CHILD_CLEANUP_DEADLINE_MS, PI_CLOSE_DELIVERY_MARGIN_MS, PI_CLOSE_SESSION_TIMEOUT_MS, PI_DISPOSE_SIGKILL_GRACE_MS, PI_PROCESS_EXIT_MARGIN_MS, PI_PROCESS_SHUTDOWN_ENVELOPE_MS, PooledConnection, SESSION_STEERING_METHOD, SessionHandle, isChildCleanupError, } from "./acp-client.js";
+export { CANCEL_NOT_HONORED_GRACE_MS, PI_CHILD_CLEANUP_DEADLINE_MS, PI_CLOSE_DELIVERY_MARGIN_MS, PI_CLOSE_SESSION_TIMEOUT_MS, PI_DISPOSE_SIGKILL_GRACE_MS, PI_PROCESS_EXIT_MARGIN_MS, PI_PROCESS_SHUTDOWN_ENVELOPE_MS, PooledConnection, SESSION_STEERING_METHOD, LOADED_TURN_QUERY_METHOD, LOADED_TURN_ENDED_METHOD, SessionHandle, isChildCleanupError, } from "./acp-client.js";
 export { AGENT_METHOD_COVERAGE, ACP_EXTENSION_SUPPORT_MATRIX, ACP_AUTH_REQUIRED_CODE_EXCLUSIVE, AUTH_CAPABILITY_KEYS, AUTH_META_CONVENTION_KEYS, AUTH_META_MATRIX, CLIENT_METHOD_COVERAGE, CODEX_SPAWN_AUTH_ENV, HANDLED_AUTH_METHOD_TYPES, PI_ACP_PROTOCOL_CONTRACT, BUILTIN_PROTOCOL_COVERAGE, assertAuthCapabilityShape, } from "./protocol-coverage.js";
 // ACP capability negotiation: parse/validate the initialize response and gate what the client
 // sends (custom `_meta` keys, MCP transports) on what the connected agent advertised.