qlogicagent 2.13.5 → 2.13.6

package/dist/cli/handlers/agents-handler.js

@@ -1,769 +0,0 @@
-/**
- * Agents scan/config/gateway/processes/kill handlers — extracted from StdioServer.
- * Handles: agents.scan, agents.list, agents.config, agents.setConfig, agents.getConfig,
- *          agents.removeConfig, agents.setGateway, agents.getGateway, agents.processes,
- *          agents.kill, agents.listConfigured, agents.getLog, agents.testConnection
- */
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { randomUUID } from "node:crypto";
-import { getUserAgentHome } from "../../runtime/infra/agent-paths.js";
-import { AGENT_RPC_ERROR_CODES } from "../../protocol/wire/index.js";
-import { AgentProcessManager } from "../../runtime/infra/agent-process.js";
-import { getCatalogEntry, getAgentCatalog, getCatalogPackageVersionInfo } from "../../runtime/infra/acp-detector.js";
-import { runAgentInstall } from "../../runtime/infra/agent-install-runner.js";
-import { WARM_SESSION, adoptWarmedAgent, evictPooledAgent, getAlivePooledAgent, poolKey, registerPooledAgent, } from "../../runtime/infra/external-agent-pool.js";
-import { appendMessage, getSessionMetadata, updateSessionMetadata } from "../../runtime/session/session-persistence.js";
-import { forwardExternalApproval, resolveApprovalDecision } from "../../runtime/infra/external-agent-approvals.js";
-/** Best-effort JSON string of an external tool's raw input, for the tool-call trace. */
-function externalToolArgs(p) {
-    const raw = p?.rawInput;
-    if (raw === undefined || raw === null)
-        return undefined;
-    if (typeof raw === "string")
-        return raw;
-    try {
-        return JSON.stringify(raw);
-    }
-    catch {
-        return undefined;
-    }
-}
-/** Best-effort short preview of an external tool's output (ACP content blocks or rawOutput). */
-function externalToolPreview(p) {
-    const content = p?.content;
-    if (Array.isArray(content)) {
-        const text = content
-            .map((b) => {
-            if (!b || typeof b !== "object")
-                return "";
-            const obj = b;
-            if (typeof obj.text === "string")
-                return obj.text;
-            if (typeof obj.content === "string")
-                return obj.content;
-            return "";
-        })
-            .join("");
-        if (text)
-            return text.slice(0, 2000);
-    }
-    if (typeof content === "string")
-        return content.slice(0, 2000);
-    if (p?.rawOutput !== undefined) {
-        try {
-            return JSON.stringify(p.rawOutput).slice(0, 2000);
-        }
-        catch {
-            return undefined;
-        }
-    }
-    return undefined;
-}
-/** Resolve a pending external-agent approval with the user's decision (delivered by the gateway). */
-export async function handleAgentsApprovalResponse(msg) {
-    const params = msg.params;
-    const approvalId = typeof params?.approvalId === "string" ? params.approvalId : "";
-    const optionId = typeof params?.optionId === "string" ? params.optionId : "";
-    const ok = approvalId && optionId ? resolveApprovalDecision(approvalId, optionId) : false;
-    if (msg.id !== undefined) {
-        this.sendResponse(msg.id, { ok });
-    }
-}
-export async function handleAgentsScan(msg) {
-    try {
-        const params = msg.params;
-        const store = await this.ensureAgentConfigStore();
-        this.acpDetector.setConfigStore(store.getData());
-        const agents = this.acpDetector.scan(params?.force);
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, agents);
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleAgentsList(msg) {
-    try {
-        const store = await this.ensureAgentConfigStore();
-        this.acpDetector.setConfigStore(store.getData());
-        const agents = this.acpDetector.list();
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, agents);
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-/**
- * Curated Discover-Agent catalog (12 agents) merged with live install status, for the
- * discover grid. Status comes from the detector; install carries the official command
- * summary + source for the confirm dialog (no secrets).
- */
-export async function handleAgentsCatalog(msg) {
-    try {
-        const store = await this.ensureAgentConfigStore();
-        this.acpDetector.setConfigStore(store.getData());
-        const detectedById = new Map(this.acpDetector.list().map((a) => [a.id, a]));
-        const catalog = getAgentCatalog().map((e) => {
-            const detected = detectedById.get(e.id);
-            const version = getCatalogPackageVersionInfo(e, detected?.version);
-            return {
-                id: e.id,
-                name: e.name,
-                brandId: e.brandId ?? e.id,
-                category: e.category ?? "code",
-                integration: e.integration ?? "acp",
-                authMode: e.authMode ?? "key",
-                note: e.note,
-                status: detected?.status ?? "not_installed",
-                version: version.installedVersion ?? detected?.version,
-                latestVersion: version.latestVersion,
-                updateAvailable: version.updateAvailable,
-                updatePackageName: version.packageName,
-                install: {
-                    docsUrl: e.install?.docsUrl,
-                    command: e.install?.npm ?? e.install?.pip ?? e.install?.brew ?? e.install?.curl,
-                },
-            };
-        });
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { catalog });
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, { code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR, message: err instanceof Error ? err.message : String(err) });
-        }
-    }
-}
-/**
- * One-click install a catalog agent by id. Runs ONLY the official command from the
- * catalog manifest (never a free-form command), streaming progress via the
- * agent.install.progress notification, then refreshes detection. Returns the outcome.
- */
-export async function handleAgentsInstall(msg) {
-    const params = msg.params;
-    const agentId = typeof params?.agentId === "string" ? params.agentId : undefined;
-    // Mirror preference comes from the caller (frontend toggle) first, then the env default.
-    const mirror = typeof params?.mirror === "string" && params.mirror ? params.mirror : process.env.QLOGICAGENT_INSTALL_MIRROR;
-    if (!agentId) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, { code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS, message: "agentId (string) required" });
-        }
-        return;
-    }
-    const entry = getCatalogEntry(agentId);
-    if (!entry?.install) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, { code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS, message: `Unknown or non-installable agent: ${agentId}` });
-        }
-        return;
-    }
-    try {
-        const result = await runAgentInstall(entry.install, (event) => {
-            this.sendNotification?.("agent.install.progress", { agentId, event });
-        }, {
-            // Opt-in registry mirror for slow/blocked public registries (e.g. PyPI/npm from CN).
-            mirror,
-        });
-        this.acpDetector.clearCache(); // re-detect the just-installed CLI
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { ok: result.ok, error: result.error });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, { code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR, message: err instanceof Error ? err.message : String(err) });
-        }
-    }
-}
-export async function handleAgentsConfig(msg) {
-    try {
-        const params = msg.params;
-        if (!params?.action || !params?.agent) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "action and agent are required.",
-                });
-            }
-            return;
-        }
-        const store = await this.ensureAgentConfigStore();
-        switch (params.action) {
-            case "register":
-                await store.registerCustomAgent(params.agent);
-                break;
-            case "unregister":
-                await store.unregisterCustomAgent(params.agent.id);
-                break;
-            case "update":
-                await store.registerCustomAgent(params.agent);
-                break;
-        }
-        this.acpDetector.setConfigStore(store.getData());
-        this.acpDetector.clearCache();
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { ok: true });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleAgentsSetConfig(msg) {
-    try {
-        const params = msg.params;
-        if (!params?.agentId) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "agentId is required.",
-                });
-            }
-            return;
-        }
-        const store = await this.ensureAgentConfigStore();
-        const { agentId, ...configFields } = params;
-        await store.setAgentConfig(agentId, configFields);
-        this.acpDetector.setConfigStore(store.getData());
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { ok: true });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleAgentsGetConfig(msg) {
-    try {
-        const params = msg.params;
-        if (!params?.agentId) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "agentId is required.",
-                });
-            }
-            return;
-        }
-        const store = await this.ensureAgentConfigStore();
-        const config = store.getAgentConfig(params.agentId);
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, config);
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleAgentsRemoveConfig(msg) {
-    try {
-        const params = msg.params;
-        if (!params?.agentId) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "agentId is required.",
-                });
-            }
-            return;
-        }
-        const store = await this.ensureAgentConfigStore();
-        await store.removeAgentConfig(params.agentId);
-        this.acpDetector.setConfigStore(store.getData());
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { ok: true });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleAgentsSetGateway(msg) {
-    try {
-        const params = msg.params;
-        if (!params?.url) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "url is required.",
-                });
-            }
-            return;
-        }
-        const store = await this.ensureAgentConfigStore();
-        await store.setGatewayUrl(params.url);
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { ok: true });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleAgentsGetGateway(msg) {
-    try {
-        const store = await this.ensureAgentConfigStore();
-        const url = store.getGatewayUrl();
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { url });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleAgentsListConfigured(msg) {
-    try {
-        const store = await this.ensureAgentConfigStore();
-        const data = store.getData();
-        const items = Object.entries(data.agents).map(([agentId, cfg]) => ({
-            agentId,
-            hasApiKey: !!cfg.apiKey,
-            hasBaseUrl: !!cfg.baseUrl,
-            hasModel: !!cfg.model,
-        }));
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, items);
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export function handleAgentsProcesses(msg) {
-    try {
-        const results = [];
-        const collectFrom = (pm, source) => {
-            if (!pm)
-                return;
-            for (const h of pm.getAllHandles()) {
-                results.push({
-                    memberId: h.memberId,
-                    name: h.name,
-                    pid: h.pid,
-                    state: h.state,
-                    startedAt: h.startedAt,
-                    endedAt: h.endedAt,
-                    source,
-                });
-            }
-        };
-        collectFrom(this.soloProcessManager, "solo");
-        collectFrom(this.productProcessManager, "product");
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, results);
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export function handleAgentsKill(msg) {
-    try {
-        const params = msg.params;
-        if (!params?.memberId) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "memberId is required.",
-                });
-            }
-            return;
-        }
-        let killed = false;
-        for (const pm of [this.soloProcessManager, this.productProcessManager]) {
-            if (pm?.getHandle(params.memberId)) {
-                pm.kill(params.memberId);
-                killed = true;
-                break;
-            }
-        }
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { ok: killed });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleAgentsGetLog(msg) {
-    try {
-        const params = msg.params;
-        if (!params?.agentId) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "agentId is required.",
-                });
-            }
-            return;
-        }
-        const logDir = path.join(getUserAgentHome(), "agent-logs");
-        const logFile = path.join(logDir, `${params.agentId}.stderr.log`);
-        let content = "";
-        try {
-            content = fs.readFileSync(logFile, "utf-8");
-        }
-        catch {
-            // Log file doesn't exist — return empty
-        }
-        if (params.tail && params.tail > 0 && content) {
-            const lines = content.split("\n");
-            content = lines.slice(-params.tail).join("\n");
-        }
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { log: content });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-export async function handleAgentsTestConnection(msg) {
-    try {
-        const params = msg.params;
-        if (!params?.agentId) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "agentId is required.",
-                });
-            }
-            return;
-        }
-        const store = await this.ensureAgentConfigStore();
-        this.acpDetector.setConfigStore(store.getData());
-        const agents = this.acpDetector.list();
-        const agent = agents.find(a => a.id === params.agentId);
-        if (!agent) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, {
-                    ok: false,
-                    error: `Agent ${params.agentId} not found`,
-                    durationMs: 0,
-                });
-            }
-            return;
-        }
-        if (agent.status === "not_installed") {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, {
-                    ok: false,
-                    error: `Agent ${params.agentId} is not installed`,
-                    durationMs: 0,
-                });
-            }
-            return;
-        }
-        const start = Date.now();
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, {
-                ok: agent.status === "available",
-                version: agent.version,
-                capabilities: agent.capabilities,
-                error: agent.status !== "available" ? `Agent status: ${agent.status}` : undefined,
-                durationMs: Date.now() - start,
-            });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-}
-/**
- * Get the live pooled member for (agent, workspace, session), spawning + registering one if absent.
- * Shared by agents.prompt (then runs a turn) and agents.warm (pre-spawn so the first turn is fast).
- * A turn (sessionId ≠ WARM_SESSION) first adopts a pre-warmed process if one exists.
- */
-async function ensurePooledExternalAgent(host, agentId, descriptor, cwd, sessionId, systemPrompt) {
-    const key = poolKey(agentId, cwd, sessionId);
-    const existing = getAlivePooledAgent(key);
-    if (existing)
-        return existing;
-    // A real turn adopts a process pre-warmed under WARM_SESSION (warmed before the session id existed).
-    if (sessionId !== WARM_SESSION) {
-        const adopted = adoptWarmedAgent(poolKey(agentId, cwd, WARM_SESSION), key);
-        if (adopted)
-            return adopted;
-    }
-    const memberId = `chat-${agentId}-${randomUUID().slice(0, 8)}`;
-    // Boxed so the manager's onNotification (built once at spawn) always tags chunks with the
-    // CURRENT turn's identity, not the first turn's.
-    const holder = { current: null };
-    const sendNotif = typeof host.sendNotification === "function" ? host.sendNotification.bind(host) : undefined;
-    const manager = new AgentProcessManager({
-        onNotification: (_memberId, method, payload) => {
-            const cur = holder.current;
-            if (!cur)
-                return;
-            const p = payload;
-            if (method === "turn.delta") {
-                const text = typeof p?.text === "string" ? p.text : "";
-                if (!text)
-                    return;
-                cur.deltas.push(text);
-                if (cur.turnId && sendNotif) {
-                    sendNotif("agents.prompt.delta", { agentId, sessionId: cur.sessionId, turnId: cur.turnId, requestId: cur.requestId, text });
-                    cur.streamedAny = true;
-                }
-                return;
-            }
-            if (method === "turn.thought_delta") {
-                const text = typeof p?.text === "string" ? p.text : "";
-                if (text && cur.turnId && sendNotif) {
-                    sendNotif("agents.prompt.delta", { agentId, sessionId: cur.sessionId, turnId: cur.turnId, requestId: cur.requestId, text, reasoning: true });
-                }
-                return;
-            }
-            if (method === "turn.plan") {
-                if (cur.turnId && sendNotif) {
-                    sendNotif("agents.prompt.plan", { agentId, sessionId: cur.sessionId, turnId: cur.turnId, requestId: cur.requestId, steps: Array.isArray(p?.steps) ? p.steps : [] });
-                }
-                return;
-            }
-            if (!cur.turnId || !sendNotif)
-                return;
-            const callId = typeof p?.callId === "string" ? p.callId : String(p?.callId ?? "");
-            if (method === "turn.tool_call") {
-                sendNotif("agents.prompt.tool", { agentId, sessionId: cur.sessionId, turnId: cur.turnId, requestId: cur.requestId, event: { kind: "call", callId, name: typeof p?.toolName === "string" ? p.toolName : (typeof p?.name === "string" ? p.name : "tool"), arguments: externalToolArgs(p) } });
-            }
-            else if (method === "turn.tool_result") {
-                sendNotif("agents.prompt.tool", { agentId, sessionId: cur.sessionId, turnId: cur.turnId, requestId: cur.requestId, event: { kind: "result", callId, name: typeof p?.toolName === "string" ? p.toolName : "tool", ok: p?.status !== "failed" && p?.status !== "error", outputPreview: externalToolPreview(p) } });
-            }
-        },
-        onMcpToolCall: async (mcpMemberId, tool, args) => {
-            if (typeof host.handleMcpToolCall === "function")
-                return host.handleMcpToolCall(mcpMemberId, tool, args);
-            return { ok: false, error: "MCP tool call unavailable" };
-        },
-        onPermissionRequest: (_memberId, reqParams) => forwardExternalApproval(reqParams, {
-            agentId,
-            turnContext: () => holder.current,
-            sendNotification: sendNotif,
-        }),
-        log: {
-            info: (message) => host.log?.(`[agents.prompt] ${message}`),
-            warn: (message) => host.log?.(`[agents.prompt] WARN: ${message}`),
-            debug: (message) => host.log?.(`[agents.prompt] ${message}`),
-        },
-        sessionDir: path.join(getUserAgentHome(), "agent-logs"),
-    });
-    await manager.spawn({ memberId, name: `chat-${agentId}`, cwd, prompt: "", external: descriptor, systemPrompt });
-    const entry = { manager, memberId, holder, lastUsed: Date.now() };
-    registerPooledAgent(key, entry);
-    return entry;
-}
-/** Pre-warm an external agent's process (on agent-select) so the first message skips the cold start. */
-export async function handleAgentsWarm(msg) {
-    try {
-        const params = (msg.params ?? {});
-        const agentId = typeof params.agentId === "string" ? params.agentId.trim() : "";
-        if (!agentId || agentId === "qlogicagent") {
-            if (msg.id !== undefined)
-                this.sendResponse(msg.id, { ok: false, warmed: false });
-            return;
-        }
-        const store = await this.ensureAgentConfigStore();
-        this.acpDetector.setConfigStore(store.getData());
-        this.acpDetector.scan(false);
-        const descriptor = this.acpDetector.buildExternalDescriptor(agentId);
-        if (!descriptor) {
-            if (msg.id !== undefined)
-                this.sendResponse(msg.id, { ok: false, warmed: false });
-            return;
-        }
-        const cwd = typeof this.getActiveProjectRoot === "function" ? this.getActiveProjectRoot() : process.cwd();
-        await ensurePooledExternalAgent(this, agentId, descriptor, cwd, WARM_SESSION);
-        if (msg.id !== undefined)
-            this.sendResponse(msg.id, { ok: true, warmed: true });
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, { ok: false, warmed: false, error: err instanceof Error ? err.message : String(err) });
-        }
-    }
-}
-export async function handleAgentsPrompt(msg) {
-    try {
-        const params = (msg.params ?? {});
-        const agentId = typeof params.agentId === "string" ? params.agentId.trim() : "";
-        const prompt = typeof params.prompt === "string" ? params.prompt : "";
-        if (!agentId || !prompt.trim()) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: "agentId and prompt are required.",
-                });
-            }
-            return;
-        }
-        const store = await this.ensureAgentConfigStore();
-        this.acpDetector.setConfigStore(store.getData());
-        this.acpDetector.scan(false);
-        const descriptor = this.acpDetector.buildExternalDescriptor(agentId);
-        if (!descriptor) {
-            if (msg.id !== undefined) {
-                this.sendResponse(msg.id, undefined, {
-                    code: AGENT_RPC_ERROR_CODES.INVALID_PARAMS,
-                    message: `Agent ${agentId} is not available or not ACP-compatible.`,
-                });
-            }
-            return;
-        }
-        const cwd = typeof params.cwd === "string" && params.cwd
-            ? params.cwd
-            : (typeof this.getActiveProjectRoot === "function" ? this.getActiveProjectRoot() : process.cwd());
-        const timeoutMs = typeof params.timeoutMs === "number" && params.timeoutMs > 0 ? params.timeoutMs : 300_000;
-        // Live-streaming (B) turn identity, echoed in agents.prompt.delta.
-        const streamSessionId = typeof params.sessionId === "string" ? params.sessionId : undefined;
-        const streamTurnId = typeof params.turnId === "string" ? params.turnId : undefined;
-        const streamRequestId = typeof params.requestId === "string" ? params.requestId : undefined;
-        const streamProjectId = typeof params.projectId === "string" ? params.projectId : undefined;
-        // A — resident process pool: the first turn spawns + registers a member; later turns on the
-        // same (agent, workspace, session) reuse the live member, skipping the multi-second ACP
-        // cold-start and retaining conversation context in the ACP session.
-        const key = poolKey(agentId, cwd, streamSessionId);
-        const pooled = await ensurePooledExternalAgent(this, agentId, descriptor, cwd, streamSessionId, typeof params.systemPrompt === "string" ? params.systemPrompt : undefined);
-        const turnCtx = {
-            sessionId: streamSessionId,
-            turnId: streamTurnId,
-            requestId: streamRequestId,
-            deltas: [],
-            streamedAny: false,
-        };
-        pooled.holder.current = turnCtx;
-        pooled.lastUsed = Date.now();
-        let result;
-        try {
-            result = await pooled.manager.sendTask(pooled.memberId, prompt, { timeout: timeoutMs });
-        }
-        catch (turnErr) {
-            // Turn failed — drop the (possibly wedged) resident process so the next turn respawns clean.
-            evictPooledAgent(key);
-            throw turnErr;
-        }
-        finally {
-            pooled.holder.current = null;
-        }
-        const content = turnCtx.deltas.join("") || (typeof result?.content === "string" ? result.content : "");
-        const usage = pooled.manager.getUsageTracker(pooled.memberId)?.getUsage();
-        // Persist the turn to the session transcript (the Agent-owned memory that session.getMessages
-        // reads), so external-agent conversations survive reload / session switch like the main agent's.
-        // cwd === getActiveProjectRoot(), which is exactly where resolveSessionWorkspaceDir looks.
-        if (streamSessionId) {
-            void appendMessage(streamSessionId, { role: "user", content: prompt }, cwd, streamTurnId);
-            if (content) {
-                void appendMessage(streamSessionId, { role: "assistant", content }, cwd, streamTurnId);
-            }
-            // Register session metadata so the session appears in session.list / the sidebar.
-            // projectId is REQUIRED — session.list skips sessions with no project binding. Title is
-            // set once (first turn); projectId/type are refreshed each turn (idempotent merge).
-            const existing = getSessionMetadata(streamSessionId, cwd);
-            void updateSessionMetadata(streamSessionId, {
-                type: "personal",
-                ...(streamProjectId ? { projectId: streamProjectId } : {}),
-                ...(existing?.title ? {} : { title: prompt.trim().slice(0, 40) || "外部 Agent 会话" }),
-                // Lock the session's owning agent on the first turn so re-entering it always resumes
-                // with the same external agent (e.g. codex), never falling back to the default 小智.
-                ...(existing?.agentId ? {} : { agentId }),
-            }, cwd);
-        }
-        if (msg.id !== undefined) {
-            this.sendResponse(msg.id, {
-                ok: true,
-                agentId,
-                content,
-                streamed: turnCtx.streamedAny,
-                stopReason: result?.stopReason,
-                usage: usage ? {
-                    inputTokens: usage.inputTokens,
-                    outputTokens: usage.outputTokens,
-                    totalTokens: usage.totalTokens,
-                    cacheRead: usage.cachedReadTokens,
-                    thoughtTokens: usage.thoughtTokens,
-                    cost: usage.cost,
-                } : undefined,
-            });
-        }
-    }
-    catch (err) {
-        if (msg.id !== undefined) {
-            // Carry the agent's authMethods (e.g. kimi's `kimi login`) so the UI can show a login card.
-            const authMethods = err.authMethods;
-            this.sendResponse(msg.id, undefined, {
-                code: AGENT_RPC_ERROR_CODES.INTERNAL_ERROR,
-                message: err instanceof Error ? err.message : String(err),
-                ...(Array.isArray(authMethods) && authMethods.length > 0 ? { data: { authMethods } } : {}),
-            });
-        }
-    }
-}