@wrongstack/acp 1.1.1 → 1.1.4

package/dist/integration/acp-agent-failure.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Classify the error an external agent ends a turn with.
+ *
+ * Claude's ACP adapter fails a `session/prompt` with a JSON-RPC internal error
+ * whose message carries Claude's own text ("You've hit your limit · resets
+ * 3pm") and whose `data.errorKind` names the provider failure. Reported as a
+ * generic prompt failure, a spent subscription quota looked like a broken
+ * tool: the leader retried a worker that could not run for hours.
+ */
+import type { SubagentError } from '@wrongstack/core/types';
+/**
+ * The SubagentError for a JSON-RPC error that names a provider failure, or
+ * undefined when it is something else (left to the generic mapping).
+ */
+export declare function classifyAgentFailure(rpc: {
+    code?: number;
+    message: string;
+    data?: unknown;
+}, agent: string, now?: number): SubagentError | undefined;
+//# sourceMappingURL=acp-agent-failure.d.ts.map

package/dist/integration/acp-subagent-runner-options.d.ts

@@ -0,0 +1,88 @@
+/** Options for {@link makeACPSubagentRunner} (split out to keep the runner file small). */
+import type { SubagentRunContext, TaskSpec } from '@wrongstack/core/types';
+import type { ACPProgressEvent, ACPProgressHandler } from '../client/acp-session.js';
+import type { AcpSteerOutcome } from '../client/acp-session-ops.js';
+import type { PermissionPolicy } from '../client/permission.js';
+import type { McpServer } from '../types/acp-v1.js';
+export interface ACPSubagentRunnerOptions {
+    /** How to spawn the external agent. */
+    command: string;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+    cwd?: string | undefined;
+    /** Subagent role label — surfaced in errors and used for logging. */
+    role?: string | undefined;
+    /**
+     * Cap for each request to the agent other than a prompt turn (initialize,
+     * session/new, …). Defaults to 5 minutes. A prompt turn has no length cap:
+     * it ends when the agent finishes, is aborted through `ctx.signal`, or goes
+     * silent for `promptIdleTimeoutMs`.
+     */
+    timeoutMs?: number | undefined;
+    /** See `ACPSessionOptions.promptIdleTimeoutMs`. Default 10 minutes. */
+    promptIdleTimeoutMs?: number | undefined;
+    /**
+     * Filesystem sandbox root. Defaults to `options.cwd` (when set) or
+     * the process's current working directory. All `fs/read_text_file` /
+     * `fs/write_text_file` calls are bounded to this root.
+     */
+    projectRoot?: string | undefined;
+    /**
+     * Live progress callback. Forwarded to `ACPSession.prompt` so the host
+     * can render the external agent's tool calls / diffs / text as they
+     * stream, instead of waiting for the buffered final result.
+     */
+    onProgress?: ACPProgressHandler | undefined;
+    /**
+     * Host live-view hook. Called with the run context so a fleet/TUI/WebUI
+     * publisher can attribute tool calls and text to the right subagent.
+     * Invoked in addition to `onProgress`.
+     */
+    publishLive?: ((ctx: SubagentRunContext, task: TaskSpec, event: ACPProgressEvent) => void) | undefined;
+    /**
+     * Called while a turn runs on an agent that accepts steering, with a
+     * function that injects a message into that turn; the returned function is
+     * called when the turn ends. Lets the host route live notes to the worker.
+     */
+    onTurnLive?: ((ctx: SubagentRunContext, task: TaskSpec, steer: (text: string) => Promise<AcpSteerOutcome>) => (() => void) | undefined) | undefined;
+    /**
+     * Permission policy for the external agent's `session/request_permission`
+     * calls. Defaults to the session's own default. Inject the host's
+     * confirm/trust UI here so an external agent's file writes / commands
+     * are surfaced to a human instead of silently auto-approved.
+     */
+    permissionPolicy?: PermissionPolicy | undefined;
+    /** Session mode to switch to after `session/new` (see ACPSessionOptions.initialModeId). */
+    initialModeId?: string | undefined;
+    /** Fail the session when the agent does not offer `initialModeId`. */
+    requireInitialMode?: boolean | undefined;
+    /**
+     * MCP servers to expose to the external agent (passed through
+     * `session/new` / `session/load`). Stdio servers are always sent;
+     * HTTP/SSE are filtered by the agent's advertised capabilities.
+     */
+    mcpServers?: McpServer[] | undefined;
+    /**
+     * Per-session setup, computed from the task and run context each time a
+     * session starts (once per task, or once for a persistent session): extra
+     * MCP servers, appended to `mcpServers`, and the `_meta` for `session/new`.
+     * Lets the host give each worker its own identity on shared channels.
+     */
+    sessionSetup?: ((task: TaskSpec, ctx: SubagentRunContext) => AcpSessionSetup) | undefined;
+    /**
+     * When true, the underlying `ACPSession` is kept open across multiple
+     * runner invocations (multi-turn conversation — the external agent
+     * keeps its context). The caller MUST call `stop()` to tear it down.
+     * Defaults to false (one process per task).
+     */
+    persistent?: boolean | undefined;
+}
+export interface AcpSessionSetup {
+    mcpServers?: McpServer[] | undefined;
+    meta?: Record<string, unknown> | undefined;
+    /** Per-task guidance placed before the user's task in the ACP prompt turn. */
+    promptPrefix?: string | undefined;
+    /** Replaces `permissionPolicy` for this session (e.g. bound to the delegating session). */
+    permissionPolicy?: PermissionPolicy | undefined;
+}
+//# sourceMappingURL=acp-subagent-runner-options.d.ts.map

package/dist/integration/acp-subagent-runner.d.ts

@@ -11,62 +11,10 @@
  * Connected to the Director / MultiAgentCoordinator via the
  * `SubagentRunner` interface (same shape as `AgentSubagentRunner`).
  */
-import type { SubagentRunContext, SubagentRunner, TaskSpec } from '@wrongstack/core/types';
-import { type ACPProgressEvent, type ACPProgressHandler, ACPSession } from '../client/acp-session.js';
-import type { PermissionPolicy } from '../client/permission.js';
-import type { McpServer } from '../types/acp-v1.js';
-export interface ACPSubagentRunnerOptions {
-    /** How to spawn the external agent. */
-    command: string;
-    args?: string[] | undefined;
-    env?: Record<string, string> | undefined;
-    cwd?: string | undefined;
-    /** Subagent role label — surfaced in errors and used for logging. */
-    role?: string | undefined;
-    /**
-     * Hard wall-clock cap for one prompt turn. Defaults to 5 minutes.
-     * Overrides `SubagentRunContext.budget.limits.timeoutMs` if both are set.
-     */
-    timeoutMs?: number | undefined;
-    /**
-     * Filesystem sandbox root. Defaults to `options.cwd` (when set) or
-     * the process's current working directory. All `fs/read_text_file` /
-     * `fs/write_text_file` calls are bounded to this root.
-     */
-    projectRoot?: string | undefined;
-    /**
-     * Live progress callback. Forwarded to `ACPSession.prompt` so the host
-     * can render the external agent's tool calls / diffs / text as they
-     * stream, instead of waiting for the buffered final result.
-     */
-    onProgress?: ACPProgressHandler | undefined;
-    /**
-     * Host live-view hook. Called with the run context so a fleet/TUI/WebUI
-     * publisher can attribute tool calls and text to the right subagent.
-     * Invoked in addition to `onProgress`.
-     */
-    publishLive?: ((ctx: SubagentRunContext, task: TaskSpec, event: ACPProgressEvent) => void) | undefined;
-    /**
-     * Permission policy for the external agent's `session/request_permission`
-     * calls. Defaults to the session's own default. Inject the host's
-     * confirm/trust UI here so an external agent's file writes / commands
-     * are surfaced to a human instead of silently auto-approved.
-     */
-    permissionPolicy?: PermissionPolicy | undefined;
-    /**
-     * MCP servers to expose to the external agent (passed through
-     * `session/new` / `session/load`). Stdio servers are always sent;
-     * HTTP/SSE are filtered by the agent's advertised capabilities.
-     */
-    mcpServers?: McpServer[] | undefined;
-    /**
-     * When true, the underlying `ACPSession` is kept open across multiple
-     * runner invocations (multi-turn conversation — the external agent
-     * keeps its context). The caller MUST call `stop()` to tear it down.
-     * Defaults to false (one process per task).
-     */
-    persistent?: boolean | undefined;
-}
+import type { SubagentRunner } from '@wrongstack/core/types';
+import { ACPSession } from '../client/acp-session.js';
+import type { ACPSubagentRunnerOptions } from './acp-subagent-runner-options.js';
+export type { ACPSubagentRunnerOptions, AcpSessionSetup } from './acp-subagent-runner-options.js';
 /**
  * Static catalog of agent ids → spawn options.
  *
@@ -86,13 +34,6 @@ export declare const ACP_AGENT_COMMANDS: Record<string, ACPSubagentRunnerOptions
  * explicitly.
  */
 export declare function makeACPSubagentRunner(options: ACPSubagentRunnerOptions): Promise<SubagentRunner>;
-/**
- * Build a long-lived `SubagentRunner` plus an explicit `stop()` for
- * teardown. The caller is responsible for calling `stop()` when done
- * (or when the host's signal fires). Useful for the `wstack acp spawn`
- * CLI command, which holds the child open for the duration of a user
- * task and tears down on SIGINT.
- */
 export declare function makeACPSubagentRunnerWithStop(options: ACPSubagentRunnerOptions): Promise<{
     runner: SubagentRunner;
     stop: () => void | Promise<void>;

package/dist/integration/run-one-acp-task.d.ts

@@ -6,6 +6,7 @@
  */
 import type { ACPProgressHandler } from '../client/acp-session.js';
 import type { PermissionPolicy } from '../client/permission.js';
+import { type ACPSubagentRunnerOptions } from './acp-subagent-runner.js';
 export interface RunOneAcpTaskOptions {
     command: string;
     args?: string[] | undefined;
@@ -22,6 +23,8 @@ export interface RunOneAcpTaskOptions {
     permissionPolicy?: PermissionPolicy | undefined;
     /** Owning WrongStack session for session-scoped ACP operations. */
     sessionId?: string | undefined;
+    /** Per-session MCP servers and `_meta`; see {@link ACPSubagentRunnerOptions.sessionSetup}. */
+    sessionSetup?: ACPSubagentRunnerOptions['sessionSetup'];
 }
 export interface RunOneAcpTaskResult {
     result: string;

package/dist/registry/contracts.d.ts

@@ -48,6 +48,12 @@ export interface ACPAgentDescriptor {
         fs: boolean;
     };
     integration: ACPIntegration;
+    /**
+     * The agent's context window in tokens, when the vendor publishes one.
+     * Shown as the session's context limit when the agent leads the session;
+     * absent means unknown.
+     */
+    contextWindow?: number;
     /** Documentation URL — shown in `wstack acp list` and the ensemble UI. */
     docs: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/acp",
-  "version": "1.1.1",
+  "version": "1.1.4",
   "license": "MIT",
   "description": "ACP (Agent Client Protocol) integration for WrongStack — client + agent support",
   "keywords": [
@@ -60,8 +60,8 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "^1.4.0",
-    "@wrongstack/core": "1.1.0",
-    "@wrongstack/primitives": "1.1.0"
+    "@wrongstack/core": "1.1.2",
+    "@wrongstack/primitives": "1.1.2"
   },
   "devDependencies": {
     "@types/node": "^26.5.1",