@qduc/term2 0.25.0 → 0.26.0

package/dist/acp-v2/agent.d.ts

@@ -0,0 +1,37 @@
+import * as acp from '@agentclientprotocol/sdk/experimental/v2';
+import type { ILoggingService } from '../services/service-interfaces.js';
+export type AcpV2PromptOutcome = Readonly<{
+    stopReason: acp.StopReason;
+}>;
+export type AcpV2EmitUpdate = (update: acp.SessionUpdate) => Promise<void>;
+/**
+ * A prompt that has passed admission but has not started producing updates.
+ * Keeping admission separate lets the ACP response acknowledge accepted work
+ * before the runtime begins streaming it.
+ */
+export type AcpV2PromptExecution = Readonly<{
+    run: (emit: AcpV2EmitUpdate, signal: AbortSignal) => Promise<AcpV2PromptOutcome>;
+}>;
+/**
+ * Protocol-neutral lifecycle required by the ACP adapter. The production
+ * implementation will be backed by term2's extracted headless session host;
+ * this boundary keeps ACP transport and schema concerns out of that host.
+ */
+export interface AcpV2SessionBackend {
+    createSession(request: Pick<acp.NewSessionRequest, 'cwd'>): Promise<acp.NewSessionResponse>;
+    listSessions(request: acp.ListSessionsRequest): Promise<acp.ListSessionsResponse>;
+    resumeSession(request: Pick<acp.ResumeSessionRequest, 'sessionId' | 'cwd' | 'replayFrom'>, emit: AcpV2EmitUpdate): Promise<acp.ResumeSessionResponse>;
+    closeSession(sessionId: acp.SessionId): Promise<void>;
+    preparePrompt(request: acp.PromptRequest): Promise<AcpV2PromptExecution>;
+    cancelSession(sessionId: acp.SessionId): Promise<void>;
+    setClient?(sessionId: acp.SessionId, client: acp.AgentContext, signal: AbortSignal): void;
+    clearClient?(sessionId: acp.SessionId): void;
+}
+export type CreateAcpV2AgentOptions = Readonly<{
+    backend: AcpV2SessionBackend;
+    logger: Pick<ILoggingService, 'error'>;
+    version: string;
+}>;
+/** Build the experimental ACP v2 protocol adapter around a session backend. */
+export declare function createAcpV2Agent(options: CreateAcpV2AgentOptions): acp.AgentApp;
+//# sourceMappingURL=agent.d.ts.map

package/dist/acp-v2/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../source/acp-v2/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,0CAA0C,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3E;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,GAAG,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC5F,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClF,aAAa,CACX,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,WAAW,GAAG,KAAK,GAAG,YAAY,CAAC,EAC3E,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACtC,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzE,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,SAAS,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1F,WAAW,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAoBH,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,GAAG,CAAC,QAAQ,CAiH/E"}

package/dist/acp-v2/agent.js

@@ -0,0 +1,171 @@
+import * as acp from '@agentclientprotocol/sdk/experimental/v2';
+const SESSION_BUSY_ERROR_CODE = -32000;
+const assertNoUnsupportedSessionExtensions = (request) => {
+    if (request.additionalDirectories && request.additionalDirectories.length > 0) {
+        throw acp.RequestError.invalidParams(undefined, 'additionalDirectories are not supported');
+    }
+    if (request.mcpServers && request.mcpServers.length > 0) {
+        throw acp.RequestError.invalidParams(undefined, 'MCP servers are not supported');
+    }
+};
+/** Build the experimental ACP v2 protocol adapter around a session backend. */
+export function createAcpV2Agent(options) {
+    const activePrompts = new Map();
+    const app = acp.agent({ name: 'term2' });
+    app.onRequest(acp.methods.agent.initialize, () => ({
+        protocolVersion: acp.PROTOCOL_VERSION,
+        info: { name: 'term2', title: 'term2', version: options.version },
+        capabilities: { session: {} },
+    }));
+    app.onRequest(acp.methods.agent.session.new, async ({ params }) => {
+        assertNoUnsupportedSessionExtensions(params);
+        return await options.backend.createSession({ cwd: params.cwd });
+    });
+    app.onRequest(acp.methods.agent.session.list, async ({ params }) => await options.backend.listSessions(params));
+    app.onRequest(acp.methods.agent.session.resume, async ({ params, client }) => {
+        assertNoUnsupportedSessionExtensions(params);
+        return await options.backend.resumeSession({
+            sessionId: params.sessionId,
+            cwd: params.cwd,
+            ...(params.replayFrom === undefined ? {} : { replayFrom: params.replayFrom }),
+        }, async (update) => {
+            await client.notify(acp.methods.client.session.update, { sessionId: params.sessionId, update });
+        });
+    });
+    app.onRequest(acp.methods.agent.session.close, async ({ params }) => {
+        const active = activePrompts.get(params.sessionId);
+        active?.controller.abort();
+        let cancellationError;
+        try {
+            if (active)
+                await options.backend.cancelSession(params.sessionId);
+        }
+        catch (error) {
+            cancellationError = error;
+        }
+        await active?.done;
+        await options.backend.closeSession(params.sessionId);
+        options.backend.clearClient?.(params.sessionId);
+        if (cancellationError !== undefined)
+            throw cancellationError;
+        return {};
+    });
+    app.onRequest(acp.methods.agent.session.prompt, async ({ params, client }) => {
+        const { active, settle } = reservePrompt(activePrompts, params.sessionId);
+        options.backend.setClient?.(params.sessionId, client, active.controller.signal);
+        let execution;
+        try {
+            execution = await options.backend.preparePrompt(params);
+        }
+        catch (error) {
+            activePrompts.delete(params.sessionId);
+            options.backend.clearClient?.(params.sessionId);
+            settle();
+            throw error;
+        }
+        if (active.controller.signal.aborted) {
+            setTimeout(() => {
+                void runPrompt({
+                    sessionId: params.sessionId,
+                    execution,
+                    controller: active.controller,
+                    client,
+                    activePrompts,
+                    logger: options.logger,
+                }).finally(() => {
+                    options.backend.clearClient?.(params.sessionId);
+                    settle();
+                });
+            }, 0);
+            return {};
+        }
+        try {
+            await client.notify(acp.methods.client.session.update, {
+                sessionId: params.sessionId,
+                update: { sessionUpdate: 'state_update', state: 'running' },
+            });
+        }
+        catch (error) {
+            activePrompts.delete(params.sessionId);
+            options.backend.clearClient?.(params.sessionId);
+            active.controller.abort();
+            settle();
+            await options.backend.cancelSession(params.sessionId);
+            throw error;
+        }
+        setTimeout(() => {
+            void runPrompt({
+                sessionId: params.sessionId,
+                execution,
+                controller: active.controller,
+                client,
+                activePrompts,
+                logger: options.logger,
+            }).finally(() => {
+                options.backend.clearClient?.(params.sessionId);
+                settle();
+            });
+        }, 0);
+        return {};
+    });
+    app.onNotification(acp.methods.agent.session.cancel, async ({ params }) => {
+        activePrompts.get(params.sessionId)?.controller.abort();
+        await options.backend.cancelSession(params.sessionId);
+    });
+    return app;
+}
+function reservePrompt(activePrompts, sessionId) {
+    if (activePrompts.has(sessionId)) {
+        throw new acp.RequestError(SESSION_BUSY_ERROR_CODE, 'Session is already processing foreground work');
+    }
+    const controller = new AbortController();
+    let settle;
+    const done = new Promise((resolve) => {
+        settle = resolve;
+    });
+    const active = { controller, done };
+    activePrompts.set(sessionId, active);
+    return { active, settle };
+}
+async function runPrompt(input) {
+    let stopReason = '_term2_error';
+    try {
+        if (input.controller.signal.aborted) {
+            stopReason = 'cancelled';
+        }
+        else {
+            const result = await input.execution.run(async (update) => {
+                await input.client.notify(acp.methods.client.session.update, { sessionId: input.sessionId, update });
+            }, input.controller.signal);
+            stopReason = input.controller.signal.aborted ? 'cancelled' : result.stopReason;
+        }
+    }
+    catch (error) {
+        if (input.controller.signal.aborted) {
+            stopReason = 'cancelled';
+        }
+        else {
+            input.logger.error('ACP prompt execution failed', {
+                eventType: 'acp.prompt.failed',
+                sessionId: input.sessionId,
+                errorMessage: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    finally {
+        if (input.activePrompts.get(input.sessionId)?.controller === input.controller) {
+            input.activePrompts.delete(input.sessionId);
+        }
+        try {
+            await input.client.notify(acp.methods.client.session.update, {
+                sessionId: input.sessionId,
+                update: { sessionUpdate: 'state_update', state: 'idle', stopReason },
+            });
+        }
+        catch {
+            // A disconnected client cannot receive the terminal update. Session
+            // persistence remains the source of truth for a later resume.
+        }
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/acp-v2/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../source/acp-v2/agent.ts"],"names":[],"mappings":"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"}

package/dist/acp-v2/serve-args.d.ts

@@ -0,0 +1,26 @@
+import { type ModelSettingsReasoningEffort } from '../services/models/reasoning-effort.js';
+/**
+ * Flag parsing for `term2 acp`, kept free of I/O so the launcher's
+ * operator-facing contract is unit-testable. Nothing here reads files or
+ * opens streams; `runAcp` owns the effectful composition.
+ *
+ * The accepted set is deliberately minimal — `--provider`, `--model` and
+ * `--effort` are the only knobs the launcher exposes. There is no
+ * `--auto-approve`: ACP sessions stay fail-closed in this milestone, so the
+ * CLI's interactive auto-approve flag is rejected as an unknown option rather
+ * than silently ignored.
+ */
+export type AcpArgs = {
+    provider?: string;
+    model?: string;
+    effort?: ModelSettingsReasoningEffort;
+};
+export type AcpArgsResult = {
+    ok: true;
+    args: AcpArgs;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseAcpArgs(argv: readonly string[]): AcpArgsResult;
+//# sourceMappingURL=serve-args.d.ts.map

package/dist/acp-v2/serve-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-args.d.ts","sourceRoot":"","sources":["../../source/acp-v2/serve-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAEpH;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,4BAA4B,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAIvF,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CAuBnE"}

package/dist/acp-v2/serve-args.js

@@ -0,0 +1,29 @@
+import { VALID_REASONING_EFFORTS } from '../services/models/reasoning-effort.js';
+const VALUE_FLAGS = new Set(['--provider', '--model', '--effort']);
+export function parseAcpArgs(argv) {
+    const args = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (!token.startsWith('--'))
+            return { ok: false, error: `unexpected argument "${token}"` };
+        if (!VALUE_FLAGS.has(token))
+            return { ok: false, error: `unknown option "${token}"` };
+        const value = argv[index + 1];
+        if (value === undefined || value === '' || value.startsWith('--')) {
+            return { ok: false, error: `${token} requires a value` };
+        }
+        index += 1;
+        if (token === '--provider')
+            args.provider = value;
+        else if (token === '--model')
+            args.model = value;
+        else {
+            if (!VALID_REASONING_EFFORTS.includes(value)) {
+                return { ok: false, error: `--effort must be one of: ${VALID_REASONING_EFFORTS.join(', ')}` };
+            }
+            args.effort = value;
+        }
+    }
+    return { ok: true, args };
+}
+//# sourceMappingURL=serve-args.js.map

package/dist/acp-v2/serve-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-args.js","sourceRoot":"","sources":["../../source/acp-v2/serve-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAqC,MAAM,wCAAwC,CAAC;AAsBpH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAEnE,MAAM,UAAU,YAAY,CAAC,IAAuB;IAClD,MAAM,IAAI,GAAiF,EAAE,CAAC;IAE9F,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,KAAK,GAAG,EAAE,CAAC;QAC3F,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,KAAK,GAAG,EAAE,CAAC;QACtF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAClE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,mBAAmB,EAAE,CAAC;QAC3D,CAAC;QACD,KAAK,IAAI,CAAC,CAAC;QACX,IAAI,KAAK,KAAK,YAAY;YAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;aAC7C,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;aAC5C,CAAC;YACJ,IAAI,CAAE,uBAA6C,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YAChG,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,KAAqC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}

package/dist/acp-v2/serve.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `term2 acp`: serve the Agent Client Protocol v2 over stdio.
+ *
+ * The launcher composes the same production stack `term2 serve` does — the
+ * operator's real settings authority, the shared session-log wiring, the shell
+ * sandbox runner probe, and the production runtime factory — and then hands the
+ * ACP adapter both ends of the JSON-RPC stream. It blocks until the client
+ * closes stdin (the ACP connection then closes) or until SIGINT/SIGTERM, then
+ * performs a bounded shutdown and returns.
+ *
+ * stdio contract: stdout is the protocol channel and nothing else may write to
+ * it. Diagnostics go to stderr, which is why every handler here takes an
+ * injected `writeStderr` instead of calling `console.error` directly.
+ *
+ * Security posture is inherited, not configured: the runtime factory's session
+ * snapshot forces `allowWrite:true`, `autoApprove:false` and
+ * `allowUnsandboxed:false` for every session, and there is intentionally no
+ * flag that relaxes it. Approval-required tools are mediated by the ACP
+ * `session/request_permission` bridge and remain fail-closed on every error.
+ */
+export type AcpServeIo = Readonly<{
+    stdin: ReadableStream<Uint8Array>;
+    stdout: WritableStream<Uint8Array>;
+    writeStderr: (message: string) => void;
+    /** Best-effort drain of stdout before the caller exits the process. */
+    flushStdout?: () => Promise<void>;
+}>;
+/** The real stdio of this process, wired as a newline-delimited JSON-RPC channel. */
+export declare function createStdioAcpIo(): AcpServeIo;
+/** Returns the process exit code: 0 for a clean shutdown, 1 for a startup failure. */
+export declare function runAcp(argv: readonly string[], io: AcpServeIo): Promise<number>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/acp-v2/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../source/acp-v2/serve.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACnC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC,CAAC,CAAC;AAEH,qFAAqF;AACrF,wBAAgB,gBAAgB,IAAI,UAAU,CAe7C;AAED,sFAAsF;AACtF,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAkJrF"}

package/dist/acp-v2/serve.js

@@ -0,0 +1,232 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { Readable, Writable } from 'node:stream';
+import * as acp from '@agentclientprotocol/sdk/experimental/v2';
+import { createAcpV2Agent } from './agent.js';
+import { createAcpV2SessionBackend } from './session-backend.js';
+import { parseAcpArgs } from './serve-args.js';
+import { getAllProviders, getProviderIds } from '../providers/index.js';
+import { installationVersion } from '../providers/fetch/logging-middleware.js';
+import { resolveModelFlag } from '../services/models/model-resolution.js';
+import { buildEnvOverrides, SettingsService } from '../services/settings/settings-service.js';
+import { createServeSessionLogWiring } from '../gateway/serve.js';
+import { createProductionRuntimeFactory } from '../gateway/runtime-factory.js';
+import { getDefaultShellSandboxRunner } from '../utils/shell/sandbox/shell-sandbox-runner.js';
+/** The real stdio of this process, wired as a newline-delimited JSON-RPC channel. */
+export function createStdioAcpIo() {
+    return {
+        stdin: Readable.toWeb(process.stdin),
+        stdout: Writable.toWeb(process.stdout),
+        writeStderr: (message) => {
+            process.stderr.write(`${message}\n`);
+        },
+        // An empty write resolves once every earlier write to the same handle has
+        // completed, so this is the flush barrier `process.exit` needs to avoid
+        // truncating a piped stdout.
+        flushStdout: () => new Promise((resolve) => {
+            process.stdout.write('', () => resolve());
+        }),
+    };
+}
+/** Returns the process exit code: 0 for a clean shutdown, 1 for a startup failure. */
+export async function runAcp(argv, io) {
+    const parsed = parseAcpArgs(argv);
+    if (!parsed.ok) {
+        io.writeStderr(`term2 acp: ${parsed.error}`);
+        return 1;
+    }
+    const args = parsed.args;
+    const { createLogger, createSessionContext } = createServeSessionLogWiring();
+    const sessionContext = createSessionContext();
+    const logger = createLogger('acp-launcher', sessionContext);
+    const cliOverrides = {};
+    if (args.provider || args.model || args.effort) {
+        cliOverrides.agent = {
+            ...(args.provider ? { provider: args.provider } : {}),
+            ...(args.model ? { model: args.model } : {}),
+            ...(args.effort ? { reasoningEffort: args.effort } : {}),
+        };
+    }
+    // The launcher process is the credential owner: this is the operator's real
+    // settings service (same env precedence as the CLI), not a per-session
+    // overlay. Sessions receive only the factory's allowlisted snapshot.
+    const settingsAuthority = new SettingsService({
+        env: buildEnvOverrides(),
+        ...(cliOverrides.agent ? { cli: cliOverrides } : {}),
+        loggingService: logger,
+    });
+    // Validated after settings load so runtime-defined providers from
+    // settings.json are registered before the flag is checked.
+    if (args.provider && !getProviderIds().includes(args.provider)) {
+        io.writeStderr(`term2 acp: unknown provider "${args.provider}".`);
+        io.writeStderr('Available providers:');
+        for (const provider of getAllProviders()) {
+            io.writeStderr(`  - ${provider.id}  (${provider.label})`);
+        }
+        return 1;
+    }
+    if (args.model) {
+        // The default prompter reads from the terminal. Here stdin carries the
+        // JSON-RPC channel, so an ambiguous pattern must fail instead of consuming
+        // protocol bytes: a null answer makes resolution report `cancelled`.
+        const resolution = await resolveModelFlag({
+            modelFlag: args.model,
+            ...(args.provider ? { providerFlag: args.provider } : {}),
+            settingsService: settingsAuthority,
+            loggingService: logger,
+            prompter: async () => null,
+        });
+        if (resolution.status === 'no_match') {
+            io.writeStderr(`term2 acp: ${resolution.error}`);
+            return 1;
+        }
+        if (resolution.status === 'cancelled') {
+            io.writeStderr(`term2 acp: cannot resolve --model "${args.model}" non-interactively; pass an exact model id or <provider>/<model>.`);
+            return 1;
+        }
+        if ('warnings' in resolution && resolution.warnings) {
+            for (const warning of resolution.warnings)
+                io.writeStderr(warning);
+        }
+        // A per-session override like every other CLI flag; it must not rewrite the
+        // user's persisted defaults, so nothing here persists.
+        settingsAuthority.set('agent.model', resolution.modelId, { persist: false });
+        if (resolution.provider)
+            settingsAuthority.set('agent.provider', resolution.provider, { persist: false });
+        if (resolution.reasoningEffort && !args.effort) {
+            settingsAuthority.set('agent.reasoningEffort', resolution.reasoningEffort, { persist: false });
+        }
+    }
+    const sandboxWarning = await sandboxWarningFor();
+    if (sandboxWarning)
+        io.writeStderr(sandboxWarning);
+    // Per-session scratch for the worker boundary. A unique directory (never
+    // /tmp itself) so a session's TMPDIR cannot be shared with another process.
+    let tempRoot;
+    try {
+        tempRoot = mkdtempSync(path.join(tmpdir(), 'term2-acp-'));
+    }
+    catch (error) {
+        io.writeStderr(`term2 acp: cannot create the runtime scratch directory: ${messageOf(error)}`);
+        return 1;
+    }
+    let runtimeFactory;
+    let backend;
+    let agent;
+    try {
+        runtimeFactory = createProductionRuntimeFactory({
+            settingsAuthority,
+            tmpDir: tempRoot,
+            sandboxAvailable: true,
+            allowWrite: true,
+            createLogger,
+            createSessionContext,
+        });
+        backend = createAcpV2SessionBackend({ runtimeFactory, logger });
+        agent = createAcpV2Agent({ backend, logger, version: installationVersion });
+    }
+    catch (error) {
+        rmSync(tempRoot, { recursive: true, force: true });
+        io.writeStderr(`term2 acp: failed to start: ${messageOf(error)}`);
+        return 1;
+    }
+    // The CLI module registers global SIGINT/SIGTERM handlers that force-exit for
+    // interactive sessions. An ACP shutdown is bounded and must be allowed to
+    // flush live conversations, so those listeners are parked for the run and put
+    // back in the `finally`. Restoring them matters because this launcher owns
+    // only its own two handlers: the parked ones belong to the CLI entrypoint, a
+    // test host, or an instrumenting module, and dropping them would change how
+    // the rest of the process reacts to a signal. The raw wrappers are parked so
+    // a `once` listener keeps its one-shot semantics when it comes back.
+    const parkedSigint = process.rawListeners('SIGINT');
+    const parkedSigterm = process.rawListeners('SIGTERM');
+    process.removeAllListeners('SIGINT');
+    process.removeAllListeners('SIGTERM');
+    let requestShutdown = () => undefined;
+    const shutdownRequested = new Promise((resolve) => {
+        requestShutdown = resolve;
+    });
+    const onSignal = () => requestShutdown();
+    process.once('SIGINT', onSignal);
+    process.once('SIGTERM', onSignal);
+    try {
+        const connection = agent.connect(acp.ndJsonStream(io.stdout, io.stdin));
+        // EOF on stdin closes the connection (the SDK's receive loop ends with the
+        // stream), so both a well-behaved client and a crashed one land here.
+        await Promise.race([connection.closed, shutdownRequested]);
+        await shutdownAcp({ backend, runtimeFactory, logger, io });
+        try {
+            await io.flushStdout?.();
+        }
+        catch {
+            // The process is exiting; a failed final drain has no recovery path.
+        }
+        return 0;
+    }
+    finally {
+        process.removeListener('SIGINT', onSignal);
+        process.removeListener('SIGTERM', onSignal);
+        for (const listener of parkedSigint)
+            process.on('SIGINT', listener);
+        for (const listener of parkedSigterm)
+            process.on('SIGTERM', listener);
+        rmSync(tempRoot, { recursive: true, force: true });
+    }
+}
+/**
+ * Bounded teardown: cancel turns and close live sessions, logging (and warning
+ * on stderr) rather than failing, because the client is already gone and there
+ * is nothing left to report an error to. The deadline spans two grace periods:
+ * each session's own dispose already spends one bounded grace period on
+ * cancellation and another on shutdown, and a hang there must not hold the
+ * process open forever.
+ */
+async function shutdownAcp(input) {
+    const graceMs = Math.max(1, input.runtimeFactory.policy.shutdownGraceMs) * 2;
+    let deadlineReached = false;
+    let deadlineTimer;
+    const deadline = new Promise((resolve) => {
+        deadlineTimer = setTimeout(() => {
+            deadlineReached = true;
+            resolve();
+        }, graceMs);
+    });
+    try {
+        await Promise.race([input.backend.shutdown(), deadline]);
+    }
+    catch (error) {
+        input.logger.error('ACP shutdown failed', {
+            eventType: 'acp.shutdown.failed',
+            errorMessage: messageOf(error),
+        });
+        input.io.writeStderr(`term2 acp: shutdown failed: ${messageOf(error)}`);
+    }
+    finally {
+        if (deadlineTimer)
+            clearTimeout(deadlineTimer);
+    }
+    if (deadlineReached) {
+        input.logger.warn('ACP shutdown deadline reached', { eventType: 'acp.shutdown.deadline', graceMs });
+        input.io.writeStderr(`term2 acp: shutdown deadline reached after ${graceMs}ms; exiting anyway`);
+    }
+}
+/**
+ * Advisory only: the shell tool probes the runner per command and refuses the
+ * unsandboxed fallback, so an unavailable sandbox never gates startup — it just
+ * tells the operator up front why every shell call will be refused.
+ */
+async function sandboxWarningFor() {
+    const describe = (availability) => `term2 acp: warning: shell sandbox unavailable: ${availability.type}${availability.reason ? ` (${availability.reason})` : ''}; shell tool calls will be refused`;
+    try {
+        const availability = await getDefaultShellSandboxRunner().availability();
+        return availability.type === 'available' ? undefined : describe(availability);
+    }
+    catch (error) {
+        return describe({ type: 'probe_failed', reason: messageOf(error) });
+    }
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=serve.js.map

package/dist/acp-v2/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../source/acp-v2/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,GAAG,MAAM,0CAA0C,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAsC,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAG9F,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,8BAA8B,EAAuB,MAAM,+BAA+B,CAAC;AACpG,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AA+B9F,qFAAqF;AACrF,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAA0C;QAC7E,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAA0C;QAC/E,WAAW,EAAE,CAAC,OAAe,EAAE,EAAE;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,0EAA0E;QAC1E,wEAAwE;QACxE,6BAA6B;QAC7B,WAAW,EAAE,GAAG,EAAE,CAChB,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC;KACL,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAuB,EAAE,EAAc;IAClE,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,EAAE,CAAC,WAAW,CAAC,cAAc,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,2BAA2B,EAAE,CAAC;IAC7E,MAAM,cAAc,GAAG,oBAAoB,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAE5D,MAAM,YAAY,GAAwC,EAAE,CAAC;IAC7D,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/C,YAAY,CAAC,KAAK,GAAG;YACnB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,uEAAuE;IACvE,qEAAqE;IACrE,MAAM,iBAAiB,GAAG,IAAI,eAAe,CAAC;QAC5C,GAAG,EAAE,iBAAiB,EAAE;QACxB,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,YAAqC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,cAAc,EAAE,MAAM;KACvB,CAAC,CAAC;IAEH,kEAAkE;IAClE,2DAA2D;IAC3D,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/D,EAAE,CAAC,WAAW,CAAC,gCAAgC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QAClE,EAAE,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;QACvC,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,EAAE,CAAC;YACzC,EAAE,CAAC,WAAW,CAAC,OAAO,QAAQ,CAAC,EAAE,MAAM,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,uEAAuE;QACvE,2EAA2E;QAC3E,qEAAqE;QACrE,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC;YACxC,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,eAAe,EAAE,iBAAiB;YAClC,cAAc,EAAE,MAAM;YACtB,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;SAC3B,CAAC,CAAC;QACH,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACrC,EAAE,CAAC,WAAW,CAAC,cAAc,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACtC,EAAE,CAAC,WAAW,CACZ,sCAAsC,IAAI,CAAC,KAAK,oEAAoE,CACrH,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,UAAU,IAAI,UAAU,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YACpD,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ;gBAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACrE,CAAC;QACD,4EAA4E;QAC5E,uDAAuD;QACvD,iBAAiB,CAAC,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,IAAI,UAAU,CAAC,QAAQ;YAAE,iBAAiB,CAAC,GAAG,CAAC,gBAAgB,EAAE,UAAU,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1G,IAAI,UAAU,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/C,iBAAiB,CAAC,GAAG,CAAC,uBAAuB,EAAE,UAAU,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACjD,IAAI,cAAc;QAAE,EAAE,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAEnD,yEAAyE;IACzE,4EAA4E;IAC5E,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,WAAW,CAAC,2DAA2D,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9F,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,cAA8B,CAAC;IACnC,IAAI,OAAsC,CAAC;IAC3C,IAAI,KAAmB,CAAC;IACxB,IAAI,CAAC;QACH,cAAc,GAAG,8BAA8B,CAAC;YAC9C,iBAAiB;YACjB,MAAM,EAAE,QAAQ;YAChB,gBAAgB,EAAE,IAAI;YACtB,UAAU,EAAE,IAAI;YAChB,YAAY;YACZ,oBAAoB;SACrB,CAAC,CAAC;QACH,OAAO,GAAG,yBAAyB,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,KAAK,GAAG,gBAAgB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,EAAE,CAAC,WAAW,CAAC,+BAA+B,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,8EAA8E;IAC9E,0EAA0E;IAC1E,8EAA8E;IAC9E,2EAA2E;IAC3E,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,qEAAqE;IACrE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,eAAe,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;IAClD,MAAM,iBAAiB,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACtD,eAAe,GAAG,OAAO,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC;IACzC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACxE,2EAA2E;QAC3E,sEAAsE;QACtE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC3D,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC5C,KAAK,MAAM,QAAQ,IAAI,YAAY;YAAE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAA4C,CAAC,CAAC;QACxG,KAAK,MAAM,QAAQ,IAAI,aAAa;YAAE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAA4C,CAAC,CAAC;QAC1G,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,WAAW,CAAC,KAK1B;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC7E,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,aAAyC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC7C,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,eAAe,GAAG,IAAI,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE;YACxC,SAAS,EAAE,qBAAqB;YAChC,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC;SAC/B,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,+BAA+B,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;YAAS,CAAC;QACT,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,SAAS,EAAE,uBAAuB,EAAE,OAAO,EAAE,CAAC,CAAC;QACpG,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,8CAA8C,OAAO,oBAAoB,CAAC,CAAC;IAClG,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,iBAAiB;IAC9B,MAAM,QAAQ,GAAG,CAAC,YAA+C,EAAU,EAAE,CAC3E,kDAAkD,YAAY,CAAC,IAAI,GACjE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EACtD,oCAAoC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,4BAA4B,EAAE,CAAC,YAAY,EAAE,CAAC;QACzE,OAAO,YAAY,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,QAAQ,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/acp-v2/session-backend.d.ts

@@ -0,0 +1,58 @@
+import * as acp from '@agentclientprotocol/sdk/experimental/v2';
+import { listConversations, loadConversation } from '../services/conversation/conversation-persistence.js';
+import type { RuntimeFactory } from '../gateway/runtime-factory.js';
+import { type ConversationLogWriter } from '../services/logging/conversation-log-writer.js';
+import type { ILoggingService } from '../services/service-interfaces.js';
+import type { AcpV2SessionBackend } from './agent.js';
+export declare function mapAcpPermissionChoices(choices: readonly {
+    id: string;
+    label: string;
+}[]): Array<{
+    choice: {
+        id: string;
+        label: string;
+    };
+    option: {
+        optionId: string;
+        name: string;
+        kind: acp.PermissionOptionKind;
+    };
+}>;
+export type AcpV2SessionBackendOptions = Readonly<{
+    runtimeFactory: RuntimeFactory;
+    createId?: () => string;
+    list?: typeof listConversations;
+    load?: typeof loadConversation;
+    ownerUserId?: string;
+    pageSize?: number;
+    logger?: ILoggingService;
+    writerFactory?: (options: {
+        sessionId: string;
+        dir: string;
+        logger: ILoggingService;
+    }) => ConversationLogWriter;
+    decideApproval?: (request: {
+        readonly toolName: string;
+        readonly callId?: string;
+        readonly argumentsText: string;
+    }, context: {
+        readonly sessionId: string;
+        readonly cwd: string;
+    }) => Promise<{
+        readonly answer: string;
+        readonly reason?: string;
+    }>;
+}>;
+/**
+ * The production backend a launcher process owns: the adapter's protocol
+ * surface plus a process-lifecycle method that cancels active turns and closes
+ * every live session. `AcpV2SessionBackend` deliberately stays free of
+ * lifecycle concerns (the adapter has no shutdown concept), so the launcher's
+ * teardown is expressed additively here rather than in the adapter contract.
+ */
+export type AcpV2ProductionSessionBackend = AcpV2SessionBackend & {
+    shutdown(): Promise<void>;
+};
+export declare function createAcpV2SessionBackend(options: AcpV2SessionBackendOptions): AcpV2ProductionSessionBackend;
+export declare const createProductionAcpV2SessionBackend: typeof createAcpV2SessionBackend;
+//# sourceMappingURL=session-backend.d.ts.map

package/dist/acp-v2/session-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-backend.d.ts","sourceRoot":"","sources":["../../source/acp-v2/session-backend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,GAAG,MAAM,0CAA0C,CAAC;AAGhE,OAAO,EAEL,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,sDAAsD,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gDAAgD,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EAAyC,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAqC7F,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,KAAK,CAAC;IAChG,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAC,oBAAoB,CAAA;KAAE,CAAC;CAC5E,CAAC,CAKD;AAED,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,iBAAiB,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,KAAK,qBAAqB,CAAC;IAChH,cAAc,CAAC,EAAE,CACf,OAAO,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;KAAE,EAChG,OAAO,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAC1D,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,6BAA6B,GAAG,mBAAmB,GAAG;IAChE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,6BAA6B,CA0a5G;AAED,eAAO,MAAM,mCAAmC,kCAA4B,CAAC"}