@agentproto/driver-agent-cli 2.7.0 → 2.8.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentCliHandle, a as AgentCliRuntime, b as AgentCliDefinition, c as AgentCliRuntimeSession, d as AgentCliClient, S as SetModelResult, e as AgentCliPrintConfig, R as RuntimeConfig, C as ContinuationStrategyId, f as AgentCliStartOptions, T as TurnContext, g as ContinuationKeyScope } from './schema-lciWmbTG.js';
-export { h as AgentCliAuth, i as AgentCliCapabilities, j as AgentCliConnectOptions, k as AgentCliContinuation, l as AgentCliFrontmatter, m as AgentCliFsZones, n as AgentCliInstallMethod, o as AgentCliMcpBlock, p as AgentCliMode, q as AgentCliModelEntry, r as AgentCliModels, s as AgentCliOption, t as AgentCliOptionType, u as AgentCliPinnedSessionTuning, v as AgentCliPresetDeclaration, w as AgentCliProtocol, x as AgentCliRouteSelection, y as AgentCliSession, z as AgentCliSessionMode, B as AgentCliSetupPersist, D as AgentCliSetupSkipIf, E as AgentCliSetupStep, F as AgentCliVersionCheck, G as RuntimeConfigInput, H as SetEffortResult, I as SetSessionModeResult, J as SteerOutcome, K as agentCliFrontmatterSchema, L as runtimeConfigSchema } from './schema-lciWmbTG.js';
+import { A as AgentCliHandle, a as AgentCliRuntime, b as AgentCliDefinition, c as AgentCliRuntimeSession, d as AgentCliClient, S as SetModelResult, e as AgentCliPrintConfig, R as RuntimeConfig, C as ContinuationStrategyId, f as AgentCliStartOptions, T as TurnContext, g as ContinuationKeyScope } from './schema-DafVng6S.js';
+export { h as AgentCliAuth, i as AgentCliCapabilities, j as AgentCliConnectOptions, k as AgentCliContinuation, l as AgentCliFrontmatter, m as AgentCliFsZones, n as AgentCliInstallMethod, o as AgentCliMcpBlock, p as AgentCliMode, q as AgentCliModelEntry, r as AgentCliModels, s as AgentCliOption, t as AgentCliOptionType, u as AgentCliPinnedSessionTuning, v as AgentCliPresetDeclaration, w as AgentCliProtocol, x as AgentCliRouteSelection, y as AgentCliSession, z as AgentCliSessionMode, B as AgentCliSetupPersist, D as AgentCliSetupSkipIf, E as AgentCliSetupStep, F as AgentCliVersionCheck, G as RuntimeConfigInput, H as SetEffortResult, I as SetSessionModeResult, J as SteerOutcome, K as agentCliFrontmatterSchema, L as runtimeConfigSchema } from './schema-DafVng6S.js';
 import { StreamEvent, AcpMcpServer } from '@agentproto/acp';
 export { StreamEvent } from '@agentproto/acp';
 import { ChildProcess } from 'node:child_process';
@@ -84,8 +84,15 @@ declare function applyModelCommand(arm: AgentCliClient, modelId: string): Promis
  * almost always has a more useful line ("npx claude-agent-acp: not
  * authenticated, run `claude login`"). Hosts read `error.data` when
  * present, falling back to `message` for older payloads.
+ *
+ * When `stderrTurnError` is supplied, a line it parses into a message
+ * (see {@link parseStderrStreamError}) is surfaced as THIS turn's error:
+ * the turn is cancelled and ended with `reason:"error"` instead of hanging
+ * forever on a `prompt` the server never resolves. Only armed for adapters
+ * whose transport retries silently (opencode); every other adapter keeps
+ * the exact prior behavior.
  */
-declare function promptTurn(arm: AgentCliClient, turnId: string, message: unknown): AsyncIterable<StreamEvent>;
+declare function promptTurn(arm: AgentCliClient, turnId: string, message: unknown, stderrTurnError?: (line: string) => string | undefined): AsyncIterable<StreamEvent>;
 
 /**
  * Agent CLI as a model port — turn ANY AIP-45 agent CLI runtime into a generic

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { LEGACY_GATEWAY_MODE_IDS, LEGACY_POSTURE_MODE_IDS, RuntimeConfigError, agentCliFrontmatterSchema, agentCliSupportsHostContextIsolation, applyModelCommand, autoAllowPermissionHandler, composeSpawn, createAcpProtocolArm, createAgentCliRuntime, createArmSessionControls, createJcodeMapperState, createMastraMapperState, createPrintSession, createProprietaryProtocolArm, defineAgentCli, hostContextExcludes, inferLegacyModeKind, isLegacyExtractedModeId, isModelSwitchAcknowledgement, mapJcodeEvent, mapMastraEvent, parseModelSwitchCommand, planModePermissionHandler, promptTurn, resolveContinuationStrategy, runtimeConfigSchema, toFileBasedMcpServers } from './chunk-D4NQQ2C7.mjs';
+export { LEGACY_GATEWAY_MODE_IDS, LEGACY_POSTURE_MODE_IDS, RuntimeConfigError, agentCliFrontmatterSchema, agentCliSupportsHostContextIsolation, applyModelCommand, autoAllowPermissionHandler, composeSpawn, createAcpProtocolArm, createAgentCliRuntime, createArmSessionControls, createJcodeMapperState, createMastraMapperState, createPrintSession, createProprietaryProtocolArm, defineAgentCli, hostContextExcludes, inferLegacyModeKind, isLegacyExtractedModeId, isModelSwitchAcknowledgement, mapJcodeEvent, mapMastraEvent, parseModelSwitchCommand, planModePermissionHandler, promptTurn, resolveContinuationStrategy, runtimeConfigSchema, toFileBasedMcpServers } from './chunk-E45SX7GU.mjs';
 
 /**
  * @agentproto/driver-agent-cli v0.1.0-alpha

package/dist/manifest/index.d.ts

@@ -1,5 +1,5 @@
-import { l as AgentCliFrontmatter, A as AgentCliHandle } from '../schema-lciWmbTG.js';
-export { K as agentCliFrontmatterSchema } from '../schema-lciWmbTG.js';
+import { l as AgentCliFrontmatter, A as AgentCliHandle } from '../schema-DafVng6S.js';
+export { K as agentCliFrontmatterSchema } from '../schema-DafVng6S.js';
 import '@agentproto/acp';
 import '@agentproto/acp/client';
 import '@agentproto/command-sandbox';

package/dist/manifest/index.mjs

@@ -1,5 +1,5 @@
-import { agentCliFrontmatterSchema, defineAgentCli } from '../chunk-D4NQQ2C7.mjs';
-export { agentCliFrontmatterSchema } from '../chunk-D4NQQ2C7.mjs';
+import { agentCliFrontmatterSchema, defineAgentCli } from '../chunk-E45SX7GU.mjs';
+export { agentCliFrontmatterSchema } from '../chunk-E45SX7GU.mjs';
 import matter from 'gray-matter';
 
 /**

package/dist/{schema-lciWmbTG.d.ts → schema-DafVng6S.d.ts}

@@ -321,6 +321,17 @@ interface AgentCliCapabilities {
      * session id is not a native TUI resume. Default false.
      */
     nativeTerminalResume?: boolean;
+    /**
+     * The harness itself defers mounted MCP tool schemas behind its own
+     * on-demand search tool (e.g. Claude Code's `ToolSearch`), so it never
+     * pays the full turn-0 `tools/list` payload of a large MCP server. The
+     * daemon uses this to default its own `/mcp` self-mount to EAGER for the
+     * session instead of stacking a second deferral layer (`tool_search`) on
+     * top, where a tool hidden by the daemon is invisible to the harness's
+     * native search. Declare it only when verified for the harness's default
+     * configuration; absent/false ⇒ the role / daemon default applies.
+     */
+    nativeToolSearch?: boolean;
 }
 /**
  * Support status for a declared mode. Absent ⇒ treated as `"active"`.
@@ -1040,6 +1051,29 @@ interface AgentCliClient {
      * session concept (proprietary one-shots).
      */
     readonly sessionId?: string;
+    /**
+     * Whether this arm's transport to the agent is still usable — a FRESH
+     * read, never a cached flag (the ACP arm asks the SDK connection's own
+     * abort signal). `true` before `connect()` resolves: nothing has died
+     * yet, so "not connected" would be a lie.
+     *
+     * Only the ACP arm implements this; arms with no long-lived connection
+     * (print — a fresh subprocess per turn; proprietary in-process) omit it,
+     * and every caller treats absence as "no transport to lose."
+     */
+    isConnected?(): boolean;
+    /**
+     * Subscribe to transport death — the push half of the liveness surface
+     * whose pull half is {@link isConnected}. Fires at most once, and fires
+     * synchronously if the transport is ALREADY gone when you subscribe, so a
+     * host that only gets the handle after `connect()` can never miss it.
+     *
+     * Only the ACP arm implements this; arms with no long-lived connection
+     * omit it (there is no transport to lose). Also fires on an orderly
+     * `close()` — the "was this death expected?" judgement belongs to the
+     * host, which knows whether it asked for the teardown.
+     */
+    onDisconnect?(listener: (err: Error) => void): void;
     /**
      * Diagnostic hook — returns the last N lines of the child's stderr,
      * joined with newlines. Set by the runner after spawn; read by
@@ -1047,6 +1081,16 @@ interface AgentCliClient {
      * Not part of the protocol; internal to the runner.
      */
     _stderrTail?: () => string;
+    /**
+     * Live stderr subscription — the push half of {@link _stderrTail}. Set by
+     * the runner after spawn; `promptTurn` subscribes for the duration of a
+     * turn to surface provider errors that exist ONLY on stderr. Some ACP
+     * servers (opencode) treat a provider 429/usage-cap as retryable and loop
+     * internally, logging the reason to stderr while `session/prompt` never
+     * resolves — the stderr line is the only evidence. Returns an unsubscribe
+     * function. Not part of the protocol; internal to the runner.
+     */
+    _onStderrLine?: (listener: (line: string) => void) => () => void;
 }
 /**
  * The runtime handle returned by `defineAgentCli` — call `.start()`
@@ -1320,6 +1364,34 @@ interface AgentCliRuntimeSession {
      * WebSocket transport).
      */
     readonly pid?: number;
+    /**
+     * Whether the adapter's transport is still usable, read FRESH at call
+     * time. The pull half of the transport-liveness surface (the push half is
+     * {@link AgentCliStartOptions.onDisconnect}) and the answer to a question
+     * `pid` cannot: the wrapper process can be alive and reported by
+     * `process.kill(pid, 0)` while its stdio JSON-RPC stream is closed, at
+     * which point every RPC rejects with "ACP connection closed" and the
+     * session is dead in every way that matters.
+     *
+     * `true` before anything has died, and for arms that hold no long-lived
+     * connection at all (the print arm re-spawns per turn — there is no
+     * transport to lose between turns). A host must therefore treat only an
+     * explicit `false` as evidence of death, never the absence of `true`.
+     */
+    isConnected?(): boolean;
+    /**
+     * Subscribe to transport death — the push half of the surface whose pull
+     * half is {@link isConnected}. Fires at most once, and SYNCHRONOUSLY if
+     * the transport already died before you subscribed, so a host that wires
+     * this up after `start()` resolves cannot miss a connection that failed in
+     * between.
+     *
+     * Fires for an orderly `close()` too: only the host knows whether it asked
+     * for the teardown, so the "was this expected?" judgement stays there (the
+     * daemon makes it by refusing to crash-mark a row that isn't `running`).
+     * Absent for arms with no long-lived connection.
+     */
+    onDisconnect?(listener: (err: Error) => void): void;
     send(message: unknown): AsyncIterable<StreamEvent>;
     cancel(): Promise<void>;
     /**
@@ -1700,6 +1772,7 @@ declare const agentCliFrontmatterSchema: z.ZodObject<{
         resumable: z.ZodOptional<z.ZodBoolean>;
         bidirectional: z.ZodOptional<z.ZodBoolean>;
         nativeTerminalResume: z.ZodOptional<z.ZodBoolean>;
+        nativeToolSearch: z.ZodOptional<z.ZodBoolean>;
         file_attach: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     modes: z.ZodOptional<z.ZodArray<z.ZodObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/driver-agent-cli",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "@agentproto/driver-agent-cli — AIP-45 AGENT-CLI.md reference implementation. Multi-protocol runner that loads an AGENT-CLI.md manifest, spawns the binary, and dispatches turns through an ACP / MCP / proprietary arm. ACP arm delegates to @agentproto/acp; emits the canonical StreamEvent taxonomy regardless of underlying protocol.",
   "keywords": [
     "agentproto",
@@ -53,7 +53,7 @@
   "dependencies": {
     "gray-matter": "^4.0.3",
     "zod": "^4.6.5",
-    "@agentproto/acp": "0.9.2",
+    "@agentproto/acp": "0.10.0",
     "@agentproto/command-sandbox": "0.3.0",
     "@agentproto/define-doctype": "0.1.3"
   },