@parlor/agent-host 0.2.0 → 0.3.0

package/dist/acp.d.ts

@@ -1,3 +1,5 @@
+import { type SessionConfigOption } from "@agentclientprotocol/sdk";
+import type { AgentOption, AgentUsage } from "@parlor/chat";
 import type { AgentProfile } from "./agents.js";
 /**
  * The only file that knows ACP. The v1 adapter speaks ndjson over stdio through
@@ -41,6 +43,12 @@ export interface OpenSessionInput {
     /** A remote turn never runs in a bypass mode. */
     readonly pinAskMode: boolean;
     readonly strictAsk?: boolean | undefined;
+    /**
+     * With `pinAskMode`, the agent's own safety review where it has one (Claude's `auto`,
+     * Codex's `agent`), asking only for what that review flags. Once the agent leaves it, the
+     * session stays in a mode that asks before every action.
+     */
+    readonly autoMode?: boolean | undefined;
 }
 export interface StdioMcpServer {
     readonly name: string;
@@ -58,6 +66,10 @@ export interface AgentSession {
     prompt(blocks: readonly PromptBlock[], handlers: TurnHandlers): Promise<StopReason>;
     cancel(): Promise<void>;
     close(): Promise<void>;
+    /** What a prompt may choose for this session now, with the value it runs with. */
+    readonly options: readonly AgentOption[];
+    /** Sets one of `options` to one of its values. */
+    setOption(id: string, value: string): Promise<void>;
 }
 export type PromptBlock = {
     readonly kind: "text";
@@ -100,6 +112,12 @@ export type AgentUpdate = {
 } | {
     readonly kind: "mode";
     readonly modeId: string;
+} | {
+    readonly kind: "options";
+    readonly options: readonly AgentOption[];
+} | {
+    readonly kind: "usage";
+    readonly usage: AgentUsage;
 };
 export type AskEffect = "allow_once" | "allow_always" | "reject_once" | "reject_always";
 export type AgentAsk = {
@@ -151,6 +169,7 @@ export interface AcpAgentHandlers {
     newSession(input: OpenSessionInput): Promise<{
         readonly id: string;
         readonly modes?: AgentModes | undefined;
+        readonly options?: readonly AgentOption[] | undefined;
     }>;
     prompt(sessionId: string, blocks: readonly PromptBlock[], peer: {
         update(update: AgentUpdate): Promise<void>;
@@ -158,6 +177,8 @@ export interface AcpAgentHandlers {
         readonly cancelled: AbortSignal;
     }): Promise<StopReason>;
 }
+/** The agent's select options a prompt may choose, its groups flattened. */
+export declare function agentOptionsOf(configOptions: readonly SessionConfigOption[] | null | undefined): AgentOption[];
 /** ACP v1 over stdio. */
 export declare function acpLauncher(): AgentLauncher;
 /** Serves `handlers` as an ACP agent on `io`, until the other side hangs up. */

package/dist/acp.d.ts.map

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

package/dist/acp.js

@@ -2,6 +2,7 @@ import { spawn } from "node:child_process";
 import { Readable, Writable } from "node:stream";
 import { agent as acpAgent, client as acpClient, methods, ndJsonStream, PROTOCOL_VERSION, RequestError, } from "@agentclientprotocol/sdk";
 import { commandOf, launchEnvironment } from "./adapter-launch.js";
+import { agentUsageOf } from "./agent-options.js";
 import { logEvent } from "./log.js";
 /** `openSession` would not run the session; `leftOpen` when the agent still holds it. */
 export class SessionRefused extends Error {
@@ -17,6 +18,7 @@ const KILL_GRACE_MS = 2_000;
 const MAX_DETAIL_CHARS = 4_000;
 const AUTH_REQUIRED = -32000;
 const MCP_PREFIX = "mcp__";
+const AUTO_MODES_BY_PREFERENCE = ["auto", "agent"];
 const ASK_MODES_BY_PREFERENCE = ["default", "workspace-write", "read-only"];
 const STRICT_ASK_MODES_BY_PREFERENCE = ["default", "read-only", "workspace-write"];
 const isFields = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
@@ -118,6 +120,12 @@ function updateOf(update) {
             };
         case "current_mode_update":
             return { kind: "mode", modeId: update.currentModeId };
+        case "config_option_update":
+            return { kind: "options", options: agentOptionsOf(update.configOptions) };
+        case "usage_update": {
+            const usage = agentUsageOf(update._meta, Date.now());
+            return usage && { kind: "usage", usage };
+        }
         default:
             return undefined;
     }
@@ -164,8 +172,71 @@ function sessionUpdateOf(update) {
             };
         case "mode":
             return { sessionUpdate: "current_mode_update", currentModeId: update.modeId };
+        case "options":
+            return {
+                sessionUpdate: "config_option_update",
+                configOptions: update.options.map(configOptionOf),
+            };
+        case "usage":
+            return {
+                sessionUpdate: "usage_update",
+                used: 0,
+                size: 0,
+                _meta: {
+                    "_claude/rateLimit": {
+                        unifiedWindows: Object.fromEntries(update.usage.windows.map((window) => [
+                            window.id,
+                            {
+                                utilization: window.used,
+                                ...(window.resetsAt === undefined
+                                    ? {}
+                                    : { resetsAt: window.resetsAt / 1000 }),
+                            },
+                        ])),
+                    },
+                },
+            };
     }
 }
+/** The permission mode is the computer's to pin; `model_config` tunes a model, not a choice. */
+const HIDDEN_CATEGORIES = new Set(["mode", "model_config"]);
+/** The agent's select options a prompt may choose, its groups flattened. */
+export function agentOptionsOf(configOptions) {
+    return (configOptions ?? []).flatMap((option) => {
+        if (option.type !== "select")
+            return [];
+        if (option.category && HIDDEN_CATEGORIES.has(option.category))
+            return [];
+        const values = option.options.flatMap((entry) => "options" in entry ? entry.options : [entry]);
+        return [
+            {
+                id: option.id,
+                name: option.name,
+                ...(option.category ? { category: option.category } : {}),
+                current: option.currentValue,
+                values: values.map((value) => ({
+                    id: value.value,
+                    name: value.name,
+                    ...(value.description ? { description: value.description } : {}),
+                })),
+            },
+        ];
+    });
+}
+function configOptionOf(option) {
+    return {
+        id: option.id,
+        name: option.name,
+        ...(option.category ? { category: option.category } : {}),
+        type: "select",
+        currentValue: option.current,
+        options: option.values.map((value) => ({
+            value: value.id,
+            name: value.name,
+            ...(value.description ? { description: value.description } : {}),
+        })),
+    };
+}
 const claudeToolName = (mcp) => ({
     claudeCode: { toolName: `${MCP_PREFIX}${mcp.server}__${mcp.tool}` },
 });
@@ -290,6 +361,10 @@ function askingModeOf(modes, strict) {
         return modes.currentModeId;
     return ASK_MODES_BY_PREFERENCE.find((mode) => available.has(mode));
 }
+function autoModeOf(modes) {
+    const available = new Set(modes.availableModes.map((mode) => mode.id));
+    return AUTO_MODES_BY_PREFERENCE.find((mode) => available.has(mode));
+}
 function sessionModesOf(modes) {
     return modes
         ? {
@@ -363,13 +438,20 @@ export function acpLauncher() {
                     const known = state.calls.get(mapped.toolCallId);
                     state.calls.set(mapped.toolCallId, { ...known, title: mapped.title });
                 }
+                else if (mapped.kind === "options") {
+                    state.options = mapped.options;
+                }
                 if (mapped.kind === "mode" && state.pinned && mapped.modeId !== state.pinned) {
-                    void context
-                        .request(methods.agent.session.setMode, {
-                        sessionId: notification.sessionId,
-                        modeId: state.pinned,
-                    })
-                        .catch(() => undefined);
+                    state.pinned = state.fallback ?? state.pinned;
+                    state.fallback = undefined;
+                    if (mapped.modeId !== state.pinned) {
+                        void context
+                            .request(methods.agent.session.setMode, {
+                            sessionId: notification.sessionId,
+                            modeId: state.pinned,
+                        })
+                            .catch(() => undefined);
+                    }
                 }
                 state.handlers?.update(mapped);
             };
@@ -436,7 +518,12 @@ export function acpLauncher() {
                             cwd: input.cwd,
                             mcpServers,
                         });
-                        return { id: input.resume, modes: resumed.modes, resumed: true };
+                        return {
+                            id: input.resume,
+                            modes: resumed.modes,
+                            configOptions: resumed.configOptions,
+                            resumed: true,
+                        };
                     }
                     catch { }
                 }
@@ -444,7 +531,12 @@ export function acpLauncher() {
                     cwd: input.cwd,
                     mcpServers,
                 });
-                return { id: created.sessionId, modes: created.modes, resumed: false };
+                return {
+                    id: created.sessionId,
+                    modes: created.modes,
+                    configOptions: created.configOptions,
+                    resumed: false,
+                };
             };
             return {
                 capabilities,
@@ -466,13 +558,21 @@ export function acpLauncher() {
                         return context.request(methods.agent.session.close, { sessionId }).then(() => true, () => false);
                     };
                     const modes = input.pinAskMode ? opened.modes : undefined;
-                    const pinned = modes
+                    const asking = modes
                         ? askingModeOf(modes, input.strictAsk === true)
                         : undefined;
+                    const auto = modes && input.autoMode ? autoModeOf(modes) : undefined;
+                    const pinned = asking === undefined ? undefined : (auto ?? asking);
                     if (modes && pinned === undefined) {
                         throw new SessionRefused(`${profile.name} offers no mode that asks before it acts, so it cannot take a turn from an app.`, !(await close()));
                     }
-                    const state = { handlers: undefined, calls: new Map(), pinned };
+                    const state = {
+                        handlers: undefined,
+                        calls: new Map(),
+                        pinned,
+                        fallback: pinned === asking ? undefined : asking,
+                        options: agentOptionsOf(opened.configOptions),
+                    };
                     sessions.set(sessionId, state);
                     if (pinned !== undefined && pinned !== modes?.currentModeId) {
                         try {
@@ -488,6 +588,17 @@ export function acpLauncher() {
                     const session = {
                         id: sessionId,
                         resumed: opened.resumed,
+                        get options() {
+                            return state.options;
+                        },
+                        setOption: async (id, value) => {
+                            const response = await context.request(methods.agent.session.setConfigOption, {
+                                sessionId,
+                                configId: id,
+                                value,
+                            });
+                            state.options = agentOptionsOf(response.configOptions);
+                        },
                         prompt: async (blocks, handlers) => {
                             if (state.handlers)
                                 throw new Error("This session is already answering a prompt.");
@@ -521,6 +632,7 @@ export function acpLauncher() {
 export function serveAcpAgent(handlers, io) {
     const running = new Map();
     const aliases = new Map();
+    const configs = new Map();
     const idOf = (sessionId) => aliases.get(sessionId) ?? sessionId;
     const app = acpAgent({ name: "parlor-fake-agent" })
         .onRequest(methods.agent.initialize, () => ({
@@ -536,13 +648,20 @@ export function serveAcpAgent(handlers, io) {
         authMethods: [],
     }))
         .onRequest(methods.agent.session.new, async ({ params }) => {
-        const { id, modes } = await handlers.newSession({
+        const { id, modes, options } = await handlers.newSession({
             cwd: params.cwd,
             mcpServers: stdioServersOf(params.mcpServers),
             pinAskMode: false,
         });
         const state = sessionModesOf(modes);
-        return { sessionId: id, ...(state ? { modes: state } : {}) };
+        const configOptions = options?.map(configOptionOf);
+        if (configOptions)
+            configs.set(id, configOptions);
+        return {
+            sessionId: id,
+            ...(state ? { modes: state } : {}),
+            ...(configOptions ? { configOptions } : {}),
+        };
     })
         .onRequest(methods.agent.session.resume, async ({ params }) => {
         if (!handlers.capabilities.resume) {
@@ -557,6 +676,13 @@ export function serveAcpAgent(handlers, io) {
         return {};
     })
         .onRequest(methods.agent.session.setMode, () => ({}))
+        .onRequest(methods.agent.session.setConfigOption, ({ params }) => {
+        const options = (configs.get(idOf(params.sessionId)) ?? []).map((option) => option.id === params.configId && option.type === "select"
+            ? { ...option, currentValue: String(params.value) }
+            : option);
+        configs.set(idOf(params.sessionId), options);
+        return { configOptions: options };
+    })
         .onRequest(methods.agent.session.close, () => {
         if (!handlers.capabilities.close) {
             throw RequestError.methodNotFound(methods.agent.session.close);