@wrongstack/acp 0.293.0 → 0.295.1

package/README.md

@@ -9,6 +9,20 @@ WebSocket support plus an HTTP server transport. Some optional protocol surfaces
 are intentionally unavailable; see [COMPLIANCE.md](COMPLIANCE.md) for the tested
 surface and current limitations.
 
+## Public entry points
+
+| Import | Authority |
+|---|---|
+| `@wrongstack/acp` | WrongStack's v1 client/server implementation, integrations, and stable v1 contracts |
+| `@wrongstack/acp/client` | Client-only implementation surface |
+| `@wrongstack/acp/agent` | Server/agent-only implementation surface |
+| `@wrongstack/acp/v1` | WrongStack-owned stable v1 protocol contracts only |
+| `@wrongstack/acp/sdk` | Official `@agentclientprotocol/sdk` APIs and experimental transport helpers |
+| `@wrongstack/acp/legacy` | Deprecated pre-v1 draft envelope types; compatibility only |
+
+New code must not import legacy draft contracts from the package root. Use `/v1`
+for protocol types and `/sdk` only when intentionally adopting the upstream SDK.
+
 ## Compliance
 
 The package test suite includes client/server protocol tests and an in-process
@@ -65,11 +79,17 @@ await server.start();
 ### Using the Official SDK (for advanced use cases)
 
 ```typescript
-import { ACPSession, AcpServer, createWebSocketStream } from '@wrongstack/acp/sdk';
+import {
+  AcpServer,
+  AgentApp,
+  createHttpStream,
+  createWebSocketStream,
+} from '@wrongstack/acp/sdk';
 ```
 
 The `/sdk` entry point re-exports the official SDK's public high-level APIs, method
-constants, and experimental Node/WebSocket helpers alongside WrongStack's implementation.
+constants, and experimental HTTP/Node/WebSocket helpers. WrongStack's `ACPSession`
+is intentionally available from the package root or `/client`, not from `/sdk`.
 
 ## Architecture
 

package/dist/agent/protocol-contract.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Public contracts and wire-boundary helpers for the ACP v1 protocol handler.
+ * Keeping these declarations separate leaves the handler focused on request dispatch.
+ */
+import type { ACPMessage } from '../types/acp-messages.js';
+import { ACP_PROTOCOL_VERSION, type ContentBlock, type PermissionOption, type PlanEntry, type RequestPermissionOutcome, type StopReason, type ToolKind, type UsageCost } from '../types/acp-v1.js';
+import type { AgentServerTransport } from './stdio-transport.js';
+export { ACP_PROTOCOL_VERSION };
+export type { ACPMessage, ContentBlock, RequestPermissionOutcome };
+type WireMessage = {
+    jsonrpc?: '2.0';
+    id?: string | number;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: unknown;
+};
+export declare function toWire(msg: WireMessage): ACPMessage;
+export declare const WRONGSTACK_VERSION: string;
+/** What kinds of content the agent accepts in a prompt. */
+export interface PromptCapabilities {
+    image: boolean;
+    audio: boolean;
+    embeddedContext: boolean;
+}
+export interface AgentCapabilities {
+    loadSession: boolean;
+    promptCapabilities: PromptCapabilities;
+}
+export interface RunTurnInput {
+    sessionId: string;
+    /** Content blocks the client sent. */
+    prompt: readonly ContentBlock[];
+    /** Cancelled when the client sends `session/cancel` for this session. */
+    signal: AbortSignal;
+}
+export interface RunTurnResult {
+    stopReason: StopReason;
+    /** Optional summary text the agent produced. */
+    text?: string;
+    plan?: PlanEntry[];
+    usage?: {
+        used: number;
+        size: number;
+        cost?: UsageCost | undefined;
+    };
+}
+/**
+ * A tool-call permission request the agent surfaces to the client.
+ */
+export interface RunTurnPermissionRequest {
+    toolCall: {
+        toolCallId: string;
+        title: string;
+        kind?: ToolKind | undefined;
+    };
+    options: PermissionOption[];
+}
+/** Client filesystem/terminal capabilities advertised at initialize. */
+export interface ClientCapabilities {
+    fs?: {
+        readTextFile?: boolean | undefined;
+        writeTextFile?: boolean | undefined;
+    } | undefined;
+    terminal?: boolean | undefined;
+}
+/**
+ * Client-callback API handed to `runTurn`. Lets the agent's tools call back
+ * into the connected ACP client — ask for permission, and (when the client
+ * advertises the capability) use the client's filesystem and terminal so the
+ * editor's view (including unsaved buffers) is the source of truth.
+ */
+export interface RunTurnApi {
+    /**
+     * Ask the connected ACP client to approve/reject a tool call via the
+     * `session/request_permission` method. Resolves with the client's
+     * outcome. Rejects if no client channel is available or the request
+     * times out — the caller decides the fallback.
+     */
+    requestPermission(req: RunTurnPermissionRequest): Promise<RequestPermissionOutcome>;
+    /** Capabilities the client advertised at initialize — gate tool wiring on these. */
+    clientCapabilities: ClientCapabilities;
+    /** Read a text file from the client's filesystem (`fs/read_text_file`). */
+    readTextFile(params: {
+        path: string;
+        line?: number;
+        limit?: number;
+    }): Promise<string>;
+    /** Write a text file in the client's filesystem (`fs/write_text_file`). */
+    writeTextFile(params: {
+        path: string;
+        content: string;
+    }): Promise<void>;
+    /**
+     * Run a command in the client's terminal (`terminal/create` →
+     * `wait_for_exit` → `output` → `release`) and resolve with the combined
+     * output and exit code.
+     */
+    runTerminal(params: {
+        command: string;
+        args?: string[] | undefined;
+        cwd?: string | undefined;
+    }): Promise<{
+        output: string;
+        exitCode: number | null;
+    }>;
+}
+/**
+ * The agent's per-turn work. Streams `SessionUpdate` notifications to
+ * `emit` and resolves with the final stopReason. Errors thrown from
+ * this iterable are converted to a `prompt_failed` JSON-RPC error.
+ *
+ * `api` is an optional client-callback surface (permission requests).
+ * Older runTurn implementations that ignore it keep working unchanged.
+ */
+export type RunTurn = (input: RunTurnInput, emit: (update: unknown) => void, api?: RunTurnApi) => Promise<RunTurnResult>;
+export interface SessionState {
+    id: string;
+    cwd: string;
+    /** Per-turn abort signal — aborted when the session is cancelled or closed. */
+    abort: AbortController;
+    /** Active mode, advertised to the client in current_mode_update. */
+    modeId: string;
+    /** Created at, for session/list ordering. */
+    createdAt: string;
+    /** Last activity timestamp, for session/info_update. */
+    updatedAt: string;
+    /** Optional human title. */
+    title?: string;
+}
+/** MCP-style session mode advertised in current_mode_update. */
+export interface SessionMode {
+    id: string;
+    name: string;
+    description?: string | undefined;
+}
+export interface SessionConfigOption {
+    id: string;
+    name: string;
+    type: 'select' | string;
+    currentValue: string;
+    options: {
+        value: string;
+        name: string;
+        description?: string | undefined;
+    }[];
+}
+export interface ProtocolHandlerOptions {
+    transport: AgentServerTransport;
+    /** Where the server is running; used for new sessions' default cwd. */
+    defaultCwd: string;
+    /** Agent's per-turn implementation. */
+    runTurn: RunTurn;
+    /**
+     * Optional callbacks for the lifecycle events the server should
+     * surface to the client. All default to no-ops.
+     */
+    onSessionNew?: ((state: SessionState) => void) | undefined;
+    /** Static list of available modes (advertised to clients). */
+    modes?: readonly SessionMode[] | undefined;
+    /** Static list of config options. */
+    configOptions?: readonly SessionConfigOption[] | undefined;
+    /** Agent name advertised in initialize. */
+    agentName?: string | undefined;
+    /**
+     * Optional source of replayable conversation history for `session/load`.
+     * Returns the `session/update` payloads (user/agent message chunks) to
+     * stream back to the client before the load response. Wired from
+     * `makeACPServerAgentTurn(...).replay`.
+     */
+    replayFor?: ((sessionId: string) => Array<{
+        sessionUpdate: string;
+        content: unknown;
+    }>) | undefined;
+    /**
+     * Optional hook to prime the turn engine's session history on cold
+     * `session/load` (server restart). Wired from `makeACPServerAgentTurn(...).seed`
+     * — it re-feeds the persisted conversation into the next-created Agent so
+     * the model resumes, not just the client UI.
+     */
+    seedFor?: ((sessionId: string, history: Array<{
+        sessionUpdate: string;
+        content: unknown;
+    }>) => void) | undefined;
+    /** Release per-session agent/history resources after close, delete, or handler teardown. */
+    disposeFor?: ((sessionId: string) => void) | undefined;
+    /** Maximum sessions retained concurrently by one protocol handler. Default 64. */
+    maxSessions?: number | undefined;
+    /**
+     * Optional durable session store. When set, sessions + their recorded
+     * history are persisted on create/prompt and restored on `session/load`,
+     * so a reconnecting client can resume after a server restart.
+     * (Structural type — `ACPSessionStore` satisfies it without a value import.)
+     */
+    store?: SessionPersistence | undefined;
+}
+/** Minimal durable-store contract the handler uses (ACPSessionStore satisfies it). */
+export interface SessionPersistence {
+    save(state: SessionState, history?: Array<{
+        sessionUpdate: string;
+        content: unknown;
+    }>): Promise<unknown>;
+    load(sessionId: string): Promise<(Partial<SessionState> & {
+        history?: Array<{
+            sessionUpdate: string;
+            content: unknown;
+        }> | undefined;
+    }) | null>;
+}
+//# sourceMappingURL=protocol-contract.d.ts.map

package/dist/agent/protocol-contract.d.ts.map

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

package/dist/agent/protocol-handler.d.ts

@@ -42,195 +42,9 @@
  *  notification can stop the running turn mid-stream without tearing
  *  down the session. Multiple sessions can be active concurrently.
  */
-import { type StopReason, type ContentBlock, type PermissionOption, type PlanEntry, type RequestPermissionOutcome, type ToolKind, type UsageCost } from '../types/acp-v1.js';
-import type { AgentServerTransport } from './stdio-transport.js';
-export declare const WRONGSTACK_VERSION = "0.274.1";
-/** What kinds of content the agent accepts in a prompt. */
-export interface PromptCapabilities {
-    image: boolean;
-    audio: boolean;
-    embeddedContext: boolean;
-}
-export interface AgentCapabilities {
-    loadSession: boolean;
-    promptCapabilities: PromptCapabilities;
-}
-export interface RunTurnInput {
-    sessionId: string;
-    /** Content blocks the client sent. */
-    prompt: readonly ContentBlock[];
-    /** Cancelled when the client sends `session/cancel` for this session. */
-    signal: AbortSignal;
-}
-export interface RunTurnResult {
-    stopReason: StopReason;
-    /** Optional summary text the agent produced. */
-    text?: string;
-    plan?: PlanEntry[];
-    usage?: {
-        used: number;
-        size: number;
-        cost?: UsageCost | undefined;
-    };
-}
-/**
- * A tool-call permission request the agent surfaces to the client.
- */
-export interface RunTurnPermissionRequest {
-    toolCall: {
-        toolCallId: string;
-        title: string;
-        kind?: ToolKind | undefined;
-    };
-    options: PermissionOption[];
-}
-/** Client filesystem/terminal capabilities advertised at initialize. */
-export interface ClientCapabilities {
-    fs?: {
-        readTextFile?: boolean | undefined;
-        writeTextFile?: boolean | undefined;
-    } | undefined;
-    terminal?: boolean | undefined;
-}
-/**
- * Client-callback API handed to `runTurn`. Lets the agent's tools call back
- * into the connected ACP client — ask for permission, and (when the client
- * advertises the capability) use the client's filesystem and terminal so the
- * editor's view (including unsaved buffers) is the source of truth.
- */
-export interface RunTurnApi {
-    /**
-     * Ask the connected ACP client to approve/reject a tool call via the
-     * `session/request_permission` method. Resolves with the client's
-     * outcome. Rejects if no client channel is available or the request
-     * times out — the caller decides the fallback.
-     */
-    requestPermission(req: RunTurnPermissionRequest): Promise<RequestPermissionOutcome>;
-    /** Capabilities the client advertised at initialize — gate tool wiring on these. */
-    clientCapabilities: ClientCapabilities;
-    /** Read a text file from the client's filesystem (`fs/read_text_file`). */
-    readTextFile(params: {
-        path: string;
-        line?: number;
-        limit?: number;
-    }): Promise<string>;
-    /** Write a text file in the client's filesystem (`fs/write_text_file`). */
-    writeTextFile(params: {
-        path: string;
-        content: string;
-    }): Promise<void>;
-    /**
-     * Run a command in the client's terminal (`terminal/create` →
-     * `wait_for_exit` → `output` → `release`) and resolve with the combined
-     * output and exit code.
-     */
-    runTerminal(params: {
-        command: string;
-        args?: string[] | undefined;
-        cwd?: string | undefined;
-    }): Promise<{
-        output: string;
-        exitCode: number | null;
-    }>;
-}
-/**
- * The agent's per-turn work. Streams `SessionUpdate` notifications to
- * `emit` and resolves with the final stopReason. Errors thrown from
- * this iterable are converted to a `prompt_failed` JSON-RPC error.
- *
- * `api` is an optional client-callback surface (permission requests).
- * Older runTurn implementations that ignore it keep working unchanged.
- */
-export type RunTurn = (input: RunTurnInput, emit: (update: unknown) => void, api?: RunTurnApi) => Promise<RunTurnResult>;
-export interface SessionState {
-    id: string;
-    cwd: string;
-    /** Per-turn abort signal — aborted when the session is cancelled or closed. */
-    abort: AbortController;
-    /** Active mode, advertised to the client in current_mode_update. */
-    modeId: string;
-    /** Created at, for session/list ordering. */
-    createdAt: string;
-    /** Last activity timestamp, for session/info_update. */
-    updatedAt: string;
-    /** Optional human title. */
-    title?: string;
-}
-/** MCP-style session mode advertised in current_mode_update. */
-export interface SessionMode {
-    id: string;
-    name: string;
-    description?: string | undefined;
-}
-export interface SessionConfigOption {
-    id: string;
-    name: string;
-    type: 'select' | string;
-    currentValue: string;
-    options: {
-        value: string;
-        name: string;
-        description?: string | undefined;
-    }[];
-}
-export interface ProtocolHandlerOptions {
-    transport: AgentServerTransport;
-    /** Where the server is running; used for new sessions' default cwd. */
-    defaultCwd: string;
-    /** Agent's per-turn implementation. */
-    runTurn: RunTurn;
-    /**
-     * Optional callbacks for the lifecycle events the server should
-     * surface to the client. All default to no-ops.
-     */
-    onSessionNew?: ((state: SessionState) => void) | undefined;
-    /** Static list of available modes (advertised to clients). */
-    modes?: readonly SessionMode[] | undefined;
-    /** Static list of config options. */
-    configOptions?: readonly SessionConfigOption[] | undefined;
-    /** Agent name advertised in initialize. */
-    agentName?: string | undefined;
-    /**
-     * Optional source of replayable conversation history for `session/load`.
-     * Returns the `session/update` payloads (user/agent message chunks) to
-     * stream back to the client before the load response. Wired from
-     * `makeACPServerAgentTurn(...).replay`.
-     */
-    replayFor?: ((sessionId: string) => Array<{
-        sessionUpdate: string;
-        content: unknown;
-    }>) | undefined;
-    /**
-     * Optional hook to prime the turn engine's session history on cold
-     * `session/load` (server restart). Wired from `makeACPServerAgentTurn(...).seed`
-     * — it re-feeds the persisted conversation into the next-created Agent so
-     * the model resumes, not just the client UI.
-     */
-    seedFor?: ((sessionId: string, history: Array<{
-        sessionUpdate: string;
-        content: unknown;
-    }>) => void) | undefined;
-    /**
-     * Optional durable session store. When set, sessions + their recorded
-     * history are persisted on create/prompt and restored on `session/load`,
-     * so a reconnecting client can resume after a server restart.
-     * (Structural type — `ACPSessionStore` satisfies it without a value import.)
-     */
-    store?: SessionPersistence | undefined;
-}
-/** Minimal durable-store contract the handler uses (ACPSessionStore satisfies it). */
-export interface SessionPersistence {
-    save(state: SessionState, history?: Array<{
-        sessionUpdate: string;
-        content: unknown;
-    }>): Promise<unknown>;
-    load(sessionId: string): Promise<(Partial<SessionState> & {
-        history?: Array<{
-            sessionUpdate: string;
-            content: unknown;
-        }> | undefined;
-    }) | null>;
-}
+import { WRONGSTACK_VERSION, type ProtocolHandlerOptions } from './protocol-contract.js';
+export { WRONGSTACK_VERSION };
+export type { AgentCapabilities, ClientCapabilities, PromptCapabilities, ProtocolHandlerOptions, RunTurn, RunTurnApi, RunTurnInput, RunTurnPermissionRequest, RunTurnResult, SessionConfigOption, SessionMode, SessionPersistence, SessionState, } from './protocol-contract.js';
 export declare class ACPProtocolHandler {
     private readonly transport;
     private readonly defaultCwd;
@@ -241,6 +55,8 @@ export declare class ACPProtocolHandler {
     private readonly agentName;
     private readonly replayFor;
     private readonly seedFor;
+    private readonly disposeFor;
+    private readonly maxSessions;
     private readonly store;
     private initialized;
     private clientCapabilities;
@@ -264,6 +80,7 @@ export declare class ACPProtocolHandler {
     handleMessage(msg: unknown): Promise<boolean>;
     /** Abort all active turns and drop session state. */
     close(): void;
+    private disposeSession;
     private handleRequest;
     private handleInitialize;
     private handleAuthenticate;
@@ -289,4 +106,13 @@ export declare class ACPProtocolHandler {
     private sendError;
     private allocId;
 }
+declare function errorToJsonRpc(err: unknown): {
+    code: number;
+    message: string;
+    data?: unknown;
+};
+/** Internal deterministic seam used by the per-file coverage suite. */
+export declare const protocolHandlerCoverage: {
+    errorToJsonRpc: typeof errorToJsonRpc;
+};
 //# sourceMappingURL=protocol-handler.d.ts.map

package/dist/agent/protocol-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol-handler.d.ts","sourceRoot":"","sources":["../../src/agent/protocol-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"protocol-handler.d.ts","sourceRoot":"","sources":["../../src/agent/protocol-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,EAEL,kBAAkB,EAKlB,KAAK,sBAAsB,EAS5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,OAAO,EACP,UAAU,EACV,YAAY,EACZ,wBAAwB,EACxB,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAwBhC,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAEZ;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEV;IACd,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4C;IACvE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IAEvD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,kBAAkB,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,MAAM,CAAK;IAInB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;IACJ,OAAO,CAAC,SAAS,CAAK;IAEtB,YAAY,IAAI,EAAE,sBAAsB,EAyBvC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,mBAAmB;IAY3B;;;;OAIG;IACG,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBlD;IAED,qDAAqD;IACrD,KAAK,IAAI,IAAI,CAWZ;IAED,OAAO,CAAC,cAAc;YAYR,aAAa;YA+Db,gBAAgB;YAwDhB,kBAAkB;YAUlB,YAAY;YAUZ,gBAAgB;YAqDhB,iBAAiB;YA0FjB,mBAAmB;YAwBnB,kBAAkB;YAuBlB,mBAAmB;YA0BnB,iBAAiB;YAiDjB,mBAAmB;YAanB,kBAAkB;YAKlB,sBAAsB;YAStB,gBAAgB;YAKhB,mBAAmB;YAoGnB,aAAa;YAmBb,qBAAqB;YAwBrB,iBAAiB;YAsBjB,kBAAkB;YA6BlB,gBAAgB;IAI9B,2EAA2E;YAC7D,OAAO;YAYP,SAAS;IAWvB,OAAO,CAAC,OAAO;CAGhB;AAMD,iBAAS,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAcvF;AAED,uEAAuE;AACvE,eAAO,MAAM,uBAAuB;;CAAqB,CAAC"}

package/dist/agent/server-agent-turn.d.ts

@@ -38,7 +38,8 @@
  * it. On abort, the adapter maps the resulting `AbortError` to
  * `{stopReason: 'cancelled'}`.
  */
-import type { Agent } from '@wrongstack/core';
+import type { Agent, AgentInput } from '@wrongstack/core/agent';
+import type { ContentBlock, PlanEntry, StopReason, ToolKind, UsageCost } from '../types/acp-v1.js';
 import type { RunTurn, RunTurnApi, RunTurnResult } from './protocol-handler.js';
 export interface ACPServerAgentTurnOptions {
     /**
@@ -60,6 +61,10 @@ export interface ACPServerAgentTurnOptions {
      * Default 5 minutes.
      */
     timeoutMs?: number | undefined;
+    /** Maximum replay entries retained per session. Default 1000. */
+    maxHistoryEntries?: number | undefined;
+    /** Maximum serialized replay bytes retained per session. Default 8 MiB. */
+    maxHistoryBytes?: number | undefined;
 }
 /** A recorded conversation turn, replayable on `session/load`. */
 interface SessionReplayUpdate {
@@ -87,6 +92,8 @@ export interface ACPServerAgentTurn {
         sessionUpdate: string;
         content: unknown;
     }>): void;
+    /** Drop the session's Agent, timers, seed marker, and in-memory replay history. */
+    dispose(sessionId: string): void;
 }
 /**
  * Build a `RunTurn` that owns per-session `Agent` instances and
@@ -97,6 +104,33 @@ export interface ACPServerAgentTurn {
  * `.replay(sessionId)`).
  */
 export declare function makeACPServerAgentTurn(opts: ACPServerAgentTurnOptions): ACPServerAgentTurn;
+declare function finitePositiveLimit(value: number | undefined, fallback: number): number;
+declare function trimHistory(entries: SessionReplayUpdate[], retainedBytes: number, maxEntries: number, maxBytes: number): number;
+declare function replayEntryBytes(entry: SessionReplayUpdate): number;
+/**
+ * Prime a freshly-created agent's conversation state with restored history.
+ * Each recorded user/agent chunk becomes a `user`/`assistant` message so the
+ * model continues the prior conversation instead of starting blank.
+ */
+declare function seedAgentContext(agent: Agent, history: ReadonlyArray<{
+    sessionUpdate: string;
+    content: unknown;
+}>): void;
+/** Map a WrongStack tool name to the closest ACP ToolKind for UI grouping. */
+declare function toolNameToKind(name: string): ToolKind;
+/** A short, human-readable title for a tool call card. */
+declare function toolTitle(name: string, input: unknown): string;
+declare function isRecord(v: unknown): v is Record<string, unknown>;
+/**
+ * Convert an ACP `ContentBlock[]` prompt into a core `AgentInput`.
+ *
+ * When the prompt is all text we return a plain string (the common,
+ * cheapest path). When it carries images we build a multimodal
+ * `ContentBlock[]` the provider can pass to a vision-capable model.
+ * Audio and resource blocks have no core representation yet, so they're
+ * recorded as bracketed text placeholders alongside the other content.
+ */
+declare function promptToAgentInput(blocks: readonly ContentBlock[]): AgentInput;
 /**
  * Tear down the agents and timers held by a turn factory. The
  * server's `close()` should call this so child connections don't
@@ -105,5 +139,59 @@ export declare function makeACPServerAgentTurn(opts: ACPServerAgentTurnOptions):
 export declare function disposeACPServerAgentTurn(opts: {
     agents: Map<string, Agent>;
 }): Promise<void>;
+/**
+ * Convert an ACP `ContentBlock[]` prompt to a single user-message
+ * string. Text blocks are concatenated; image / audio / resource
+ * blocks are recorded as a bracketed placeholder (full multimodal
+ * support is a future PR — the adapter is v1-text only for now).
+ */
+declare function promptToText(blocks: readonly ContentBlock[]): string;
+/**
+ * Extract the agent's final text from a `RunResult`. The shape
+ * varies across core versions, so we read the most common fields
+ * defensively and concatenate whatever text we find.
+ */
+declare function extractText(result: unknown): string;
+/**
+ * Map a `RunResult` (and the parent signal) to a v1 `StopReason`.
+ *
+ * If the parent signal was aborted, return `'cancelled'`. Otherwise
+ * the agent completed normally — we treat any non-error result
+ * as `'end_turn'`. The core `RunResult` doesn't currently surface
+ * a per-turn stop reason, so v1's `'max_tokens'`, `'max_turn_requests'`,
+ * and `'refusal'` discriminators can't be emitted precisely; we
+ * log a warning if the result carries an error and return the
+ * generic end_turn.
+ */
+declare function pickStopReason(result: unknown, signal: AbortSignal): StopReason;
+/**
+ * Extract a plan from the agent's RunResult, if available.
+ * The plan is an array of PlanEntry objects.
+ */
+declare function extractPlan(result: unknown): PlanEntry[];
+/**
+ * Extract usage/token info from the agent's RunResult, if available.
+ */
+declare function extractUsage(result: unknown): {
+    used: number;
+    size: number;
+    cost?: UsageCost | undefined;
+} | null;
+/** Internal deterministic seams used by the per-file coverage suite. */
+export declare const serverAgentTurnCoverage: {
+    finitePositiveLimit: typeof finitePositiveLimit;
+    trimHistory: typeof trimHistory;
+    replayEntryBytes: typeof replayEntryBytes;
+    seedAgentContext: typeof seedAgentContext;
+    toolNameToKind: typeof toolNameToKind;
+    toolTitle: typeof toolTitle;
+    isRecord: typeof isRecord;
+    promptToAgentInput: typeof promptToAgentInput;
+    promptToText: typeof promptToText;
+    extractText: typeof extractText;
+    pickStopReason: typeof pickStopReason;
+    extractPlan: typeof extractPlan;
+    extractUsage: typeof extractUsage;
+};
 export {};
 //# sourceMappingURL=server-agent-turn.d.ts.map

package/dist/agent/server-agent-turn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-agent-turn.d.ts","sourceRoot":"","sources":["../../src/agent/server-agent-turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,EAAE,KAAK,EAAc,MAAM,kBAAkB,CAAC;AAQ1D,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,CACR,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,UAAU,KACb,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IAC5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,kEAAkE;AAClE,UAAU,mBAAmB;IAC3B,aAAa,EAAE,oBAAoB,GAAG,qBAAqB,CAAC;IAC5D,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACpH,8DAA8D;IAC9D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAAC;IACjD;;;;;OAKG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CACpG;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,yBAAyB,GAC9B,kBAAkB,CA8JpB;AAwFD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE;IAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;CAAE,GACnC,OAAO,CAAC,IAAI,CAAC,CAIf"}
+{"version":3,"file":"server-agent-turn.d.ts","sourceRoot":"","sources":["../../src/agent/server-agent-turn.ts"],"names":[],"mappings":"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"}

package/dist/agent/session-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/agent/session-store.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,2EAA2E;AAC3E,UAAU,sBAAsB;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAiB,SAAQ,OAAO,CAAC,YAAY,CAAC;IAC7D,OAAO,CAAC,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B,YAAY,IAAI,GAAE,mBAAwB,EAEzC;IAED,sEAAsE;IAChE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAI1B;IAED;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBnF;IAED,wEAAwE;IAClE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAO9D;IAED,mCAAmC;IAC7B,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAsC9D;IAED,0EAA0E;IAC1E,OAAO,CAAC,SAAS;IAIjB,yEAAyE;YAC3D,SAAS;IAwBvB,sEAAsE;YACxD,UAAU;IAOxB,wEAAwE;YAC1D,WAAW;IAiBzB,6BAA6B;IACvB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB7C;IAED,oCAAoC;IACpC,YAAY,IAAI,MAAM,CAErB;CACF"}
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/agent/session-store.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,2EAA2E;AAC3E,UAAU,sBAAsB;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAiB,SAAQ,OAAO,CAAC,YAAY,CAAC;IAC7D,OAAO,CAAC,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B,YAAY,IAAI,GAAE,mBAAwB,EAEzC;IAED,sEAAsE;IAChE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAI1B;IAED;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBnF;IAED,wEAAwE;IAClE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAO9D;IAED,mCAAmC;IAC7B,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAsC9D;IAED,0EAA0E;IAC1E,OAAO,CAAC,SAAS;IAIjB,yEAAyE;YAC3D,SAAS;IAwBvB,sEAAsE;YACxD,UAAU;IAOxB,wEAAwE;YAC1D,WAAW;IAiBzB,6BAA6B;IACvB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB7C;IAED,oCAAoC;IACpC,YAAY,IAAI,MAAM,CAErB;CACF"}