linkshell-cli 0.2.126 → 0.3.1

package/src/runtime/acp/agent-session.ts

@@ -1,1180 +0,0 @@
-import {
-  createEnvelope,
-  parseTypedPayload,
-  type Envelope,
-} from "@linkshell/protocol";
-import { AcpClient } from "./acp-client.js";
-import { ClaudeSdkClient } from "./claude-sdk-client.js";
-import { ClaudeStreamJsonClient } from "./claude-stream-json-client.js";
-import type { AgentProtocol, AgentProvider } from "./provider-resolver.js";
-import { resolveAgentCommand } from "./provider-resolver.js";
-
-type AgentStatus = "unavailable" | "idle" | "running" | "waiting_permission" | "error";
-
-function protocolSupportsImages(protocol: AgentProtocol | undefined): boolean {
-  return protocol === "codex-app-server" ||
-    protocol === "claude-agent-sdk" ||
-    protocol === "claude-stream-json";
-}
-
-interface AgentMessage {
-  id: string;
-  role: "user" | "assistant" | "system";
-  content: string;
-  createdAt: number;
-  isStreaming?: boolean;
-}
-
-interface AgentToolCall {
-  id: string;
-  name: string;
-  input?: string;
-  output?: string;
-  createdAt?: number;
-  status: "pending" | "running" | "completed" | "failed";
-}
-
-interface AgentPlanStep {
-  id: string;
-  text: string;
-  status: "pending" | "in_progress" | "completed";
-}
-
-interface AgentPermission {
-  requestId: string;
-  toolName?: string;
-  toolInput?: string;
-  context?: string;
-  options: { id: string; label: string; kind: "allow" | "deny" | "other" }[];
-}
-
-interface PendingPermissionWaiter {
-  resolve: (value: unknown) => void;
-  timer: ReturnType<typeof setTimeout>;
-}
-
-const PERMISSION_TIMEOUT_MS = 5 * 60_000;
-
-function id(prefix: string): string {
-  return `${prefix}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-}
-
-function stringify(value: unknown): string {
-  if (typeof value === "string") return value;
-  try {
-    return JSON.stringify(value, null, 2);
-  } catch {
-    return String(value);
-  }
-}
-
-function firstString(value: Record<string, unknown>, keys: string[]): string | undefined {
-  for (const key of keys) {
-    const next = value[key];
-    if (typeof next === "string" && next.length > 0) return next;
-  }
-  return undefined;
-}
-
-function asRecord(value: unknown): Record<string, unknown> | undefined {
-  return typeof value === "object" && value ? value as Record<string, unknown> : undefined;
-}
-
-function extractItem(value: unknown): Record<string, unknown> | undefined {
-  const raw = asRecord(value);
-  if (!raw) return undefined;
-  return asRecord(raw.item) ?? raw;
-}
-
-function stringifyDefined(value: unknown): string | undefined {
-  if (value === undefined || value === null || value === "") return undefined;
-  return stringify(value);
-}
-
-function appendCapped(current: string | undefined, delta: string, maxLength: number): string {
-  const next = `${current ?? ""}${delta}`;
-  if (next.length <= maxLength) return next;
-  return next.slice(next.length - maxLength);
-}
-
-function decodeBase64(value: string | undefined): string | undefined {
-  if (!value) return undefined;
-  try {
-    return Buffer.from(value, "base64").toString("utf8");
-  } catch {
-    return undefined;
-  }
-}
-
-function normalizeToolStatus(value: unknown, completedFallback = false): AgentToolCall["status"] {
-  if (value === "completed" || value === "succeeded" || value === "success" || value === "applied") {
-    return "completed";
-  }
-  if (value === "failed" || value === "error" || value === "declined" || value === "cancelled") {
-    return "failed";
-  }
-  if (value === "pending" || value === "queued") return "pending";
-  if (value === "running" || value === "inProgress" || value === "executing") return "running";
-  return completedFallback ? "completed" : "running";
-}
-
-function normalizePlanStatus(value: unknown): AgentPlanStep["status"] {
-  if (value === "completed" || value === "done") return "completed";
-  if (value === "inProgress" || value === "running" || value === "active") return "in_progress";
-  return "pending";
-}
-
-function planStepFromItem(item: Record<string, unknown>): AgentPlanStep | undefined {
-  const text = firstString(item, ["text", "title", "description", "message"]);
-  if (!text) return undefined;
-  return {
-    id: firstString(item, ["id", "itemId"]) ?? id("plan"),
-    text,
-    status: normalizePlanStatus(item.status),
-  };
-}
-
-function nameFromToolMethod(method: string): string {
-  if (method.includes("commandExecution")) return "命令";
-  if (method.includes("fileChange")) return "文件修改";
-  if (method.includes("mcpToolCall")) return "MCP 工具";
-  return "工具";
-}
-
-function isToolItemType(itemType: string | undefined): boolean {
-  return (
-    itemType === "commandExecution" ||
-    itemType === "fileChange" ||
-    itemType === "mcpToolCall" ||
-    itemType === "dynamicToolCall"
-  );
-}
-
-function toolNameFromItem(item: Record<string, unknown>): string | undefined {
-  const itemType = firstString(item, ["type"]);
-  if (itemType === "commandExecution") return "命令";
-  if (itemType === "fileChange") return "文件修改";
-  if (itemType === "mcpToolCall") {
-    const server = firstString(item, ["server"]);
-    const tool = firstString(item, ["tool", "toolName", "name"]);
-    return [server, tool].filter(Boolean).join(" · ") || "MCP 工具";
-  }
-  if (itemType === "dynamicToolCall") {
-    const namespace = firstString(item, ["namespace"]);
-    const tool = firstString(item, ["tool", "toolName", "name"]);
-    return [namespace, tool].filter(Boolean).join(" · ") || "工具";
-  }
-  return firstString(item, ["toolName", "tool", "name", "title"]);
-}
-
-function toolInputFromItem(item: Record<string, unknown>): string | undefined {
-  const itemType = firstString(item, ["type"]);
-  if (itemType === "commandExecution") {
-    const command = firstString(item, ["command"]);
-    const cwd = firstString(item, ["cwd"]);
-    if (command && cwd) return `${command}\n\ncwd: ${cwd}`;
-    return command ?? cwd;
-  }
-  if (itemType === "fileChange") {
-    const changes = Array.isArray(item.changes) ? item.changes : [];
-    return summarizeFileChanges(changes) ?? firstString(item, ["path", "file", "filePath", "absolutePath", "relativePath"]);
-  }
-  return stringifyDefined(item.arguments ?? item.input ?? item.toolInput);
-}
-
-function looksLikeDiff(text: string): boolean {
-  const value = text.trim();
-  return (
-    value.startsWith("diff --git ") ||
-    value.startsWith("@@ ") ||
-    value.includes("\n@@ ") ||
-    (value.includes("\n--- ") && value.includes("\n+++ "))
-  );
-}
-
-function collectDiffStrings(value: unknown, depth = 0): string[] {
-  if (depth > 6 || value === undefined || value === null) return [];
-  if (typeof value === "string") return looksLikeDiff(value) ? [value] : [];
-  if (Array.isArray(value)) return value.flatMap((entry) => collectDiffStrings(entry, depth + 1));
-  const raw = asRecord(value);
-  if (!raw) return [];
-  const direct: string[] = [];
-  const nested: string[] = [];
-  for (const [key, entry] of Object.entries(raw)) {
-    const lowerKey = key.toLowerCase();
-    const isDiffField =
-      lowerKey.includes("diff") ||
-      lowerKey.includes("patch") ||
-      lowerKey.includes("unified");
-    if (typeof entry === "string" && isDiffField && entry.trim()) {
-      direct.push(entry);
-    } else if (typeof entry === "object" && entry) {
-      nested.push(...collectDiffStrings(entry, depth + 1));
-    }
-  }
-  return [...direct, ...nested].filter((entry) => looksLikeDiff(entry));
-}
-
-function extractDiffText(value: unknown): string | undefined {
-  const diffs = collectDiffStrings(value)
-    .map((entry) => entry.trim())
-    .filter(Boolean);
-  if (diffs.length === 0) return undefined;
-  return diffs
-    .filter((entry, index, array) => array.indexOf(entry) === index)
-    .join("\n\n")
-    .slice(0, 24_000);
-}
-
-function summarizeFileChanges(changes: unknown[]): string | undefined {
-  const lines = changes
-    .map((change) => {
-      const raw = asRecord(change);
-      if (!raw) return undefined;
-      const path =
-        firstString(raw, ["path", "file", "filePath", "absolutePath", "relativePath"]) ??
-        firstString(asRecord(raw.update) ?? {}, ["path", "file", "filePath"]);
-      const kind = firstString(raw, ["kind", "type", "operation", "action"]);
-      return [kind, path].filter(Boolean).join(" ") || path;
-    })
-    .filter((line): line is string => Boolean(line));
-  return lines.length > 0 ? lines.slice(0, 8).join("\n") : undefined;
-}
-
-export class AgentSessionProxy {
-  private client: AcpClient | ClaudeSdkClient | ClaudeStreamJsonClient | undefined;
-  private activeProvider: AgentProvider | undefined;
-  private activeProtocol: AgentProtocol | undefined;
-  private agentSessionId: string | undefined;
-  private status: AgentStatus = "unavailable";
-  private error: string | undefined;
-  private initialized = false;
-  private currentTurnId: string | undefined;
-  private messages: AgentMessage[] = [];
-  private toolCalls = new Map<string, AgentToolCall>();
-  private toolOutputBuffers = new Map<string, string>();
-  private plan: AgentPlanStep[] = [];
-  private planDeltaBuffers = new Map<string, string>();
-  private pendingPermissions = new Map<string, AgentPermission>();
-  private permissionWaiters = new Map<string, PendingPermissionWaiter>();
-  private permissionSources = new Map<string, string>();
-
-  constructor(
-    private readonly input: {
-      sessionId: string;
-      cwd: string;
-      availableProviders: AgentProvider[];
-      command?: string;
-      send: (envelope: Envelope) => void;
-      verbose?: boolean;
-    },
-  ) {}
-
-  async handleEnvelope(envelope: Envelope): Promise<void> {
-    switch (envelope.type) {
-      case "agent.initialize":
-        await this.initialize();
-        this.sendSnapshot();
-        break;
-      case "agent.session.new": {
-        const payload = parseTypedPayload("agent.session.new", envelope.payload);
-        await this.ensureSession(payload.cwd ?? this.input.cwd, payload.mcpServers);
-        this.sendSnapshot();
-        break;
-      }
-      case "agent.session.load": {
-        const payload = parseTypedPayload("agent.session.load", envelope.payload);
-        await this.ensureClient();
-        if (!this.client) return;
-        const result = await this.client.loadSession({
-          sessionId: payload.agentSessionId,
-          cwd: payload.cwd ?? this.input.cwd,
-        });
-        this.agentSessionId = this.extractSessionId(result) ?? payload.agentSessionId;
-        this.status = "idle";
-        this.error = undefined;
-        this.sendSnapshot();
-        break;
-      }
-      case "agent.session.list":
-        await this.sendSessionList();
-        break;
-      case "agent.prompt": {
-        const payload = parseTypedPayload("agent.prompt", envelope.payload);
-        await this.sendPrompt(payload);
-        break;
-      }
-      case "agent.cancel": {
-        const payload = parseTypedPayload("agent.cancel", envelope.payload);
-        this.cancelPendingPermissions();
-        this.client?.cancel({
-          sessionId: payload.agentSessionId ?? this.agentSessionId,
-          turnId: this.currentTurnId,
-        });
-        this.currentTurnId = undefined;
-        this.status = "idle";
-        this.sendUpdate({ kind: "status", status: "idle" });
-        break;
-      }
-      case "agent.permission.response": {
-        const payload = parseTypedPayload("agent.permission.response", envelope.payload);
-        const permission = this.pendingPermissions.get(payload.requestId);
-        this.pendingPermissions.delete(payload.requestId);
-        const selectedOptionId =
-          payload.optionId ?? selectPermissionOption(permission, payload.outcome);
-        const waiter = this.permissionWaiters.get(payload.requestId);
-        if (waiter) {
-          clearTimeout(waiter.timer);
-          this.permissionWaiters.delete(payload.requestId);
-          waiter.resolve(formatPermissionResponse(
-            this.permissionSources.get(payload.requestId),
-            payload.outcome,
-            selectedOptionId,
-          ));
-          this.permissionSources.delete(payload.requestId);
-        } else {
-          this.client?.respondPermission({
-            sessionId: payload.agentSessionId ?? this.agentSessionId,
-            requestId: payload.requestId,
-            outcome: payload.outcome === "cancelled" ? "deny" : payload.outcome,
-            optionId: selectedOptionId,
-          });
-        }
-        this.status = "running";
-        this.sendSnapshot();
-        break;
-      }
-    }
-  }
-
-  stop(): void {
-    this.client?.stop();
-    this.client = undefined;
-  }
-
-  private async initialize(): Promise<void> {
-    if (this.initialized) {
-      this.sendCapabilities();
-      return;
-    }
-    await this.tryStartFirstAvailable();
-  }
-
-  private async tryStartFirstAvailable(): Promise<void> {
-    if (this.client) return;
-
-    for (const provider of this.input.availableProviders) {
-      const resolved = resolveAgentCommand({
-        provider,
-        command: this.input.command,
-      });
-      if (!resolved) continue;
-
-      const tryCreateClient = async (config: typeof resolved): Promise<AcpClient | ClaudeSdkClient | ClaudeStreamJsonClient> => {
-        const isClaudeSdk = config.protocol === "claude-agent-sdk";
-        const isClaudeStreamJson = config.protocol === "claude-stream-json";
-        const client = isClaudeSdk
-          ? new ClaudeSdkClient({
-              command: config.command,
-              protocol: config.protocol,
-              framing: config.framing,
-              cwd: this.input.cwd,
-              onNotification: (method, params) => this.handleNotification(method, params),
-              onRequest: (method, params) => this.handleRequest(method, params),
-              onExit: (message) => this.handleExit(message),
-            })
-          : isClaudeStreamJson
-          ? new ClaudeStreamJsonClient({
-              command: config.command,
-              protocol: config.protocol,
-              framing: config.framing,
-              cwd: this.input.cwd,
-              onNotification: (method, params) => this.handleNotification(method, params),
-              onRequest: (method, params) => this.handleRequest(method, params),
-              onExit: (message) => this.handleExit(message),
-            })
-          : new AcpClient({
-              command: config.command,
-              protocol: config.protocol,
-              framing: config.framing,
-              cwd: this.input.cwd,
-              onNotification: (method, params) => this.handleNotification(method, params),
-              onRequest: (method, params) => this.handleRequest(method, params),
-              onExit: (message) => this.handleExit(message),
-            });
-        await client.initialize();
-        return client;
-      };
-
-      try {
-        this.client = await tryCreateClient(resolved);
-        this.activeProvider = provider;
-        this.activeProtocol = resolved.protocol;
-        this.initialized = true;
-        this.status = "idle";
-        this.error = undefined;
-        this.sendCapabilities();
-        return;
-      } catch (error) {
-        if (provider === "claude" && resolved.protocol === "claude-agent-sdk") {
-          if (this.input.verbose) {
-            process.stderr.write(`[agent] Claude SDK failed, falling back to stream-json: ${error instanceof Error ? error.message : String(error)}\n`);
-          }
-          try {
-            const fallback = {
-              provider,
-              command: "claude --print --output-format stream-json --input-format stream-json --verbose --permission-mode bypassPermissions",
-              protocol: "claude-stream-json" as const,
-              framing: "newline" as const,
-            };
-            this.client = await tryCreateClient(fallback);
-            this.activeProvider = provider;
-            this.activeProtocol = fallback.protocol;
-            this.initialized = true;
-            this.status = "idle";
-            this.error = undefined;
-            this.sendCapabilities();
-            return;
-          } catch (fallbackError) {
-            this.client?.stop();
-            this.client = undefined;
-            this.activeProtocol = undefined;
-            if (this.input.verbose) {
-              process.stderr.write(`[agent] Claude stream-json fallback failed: ${fallbackError instanceof Error ? fallbackError.message : String(fallbackError)}\n`);
-            }
-          }
-        }
-        this.client?.stop();
-        this.client = undefined;
-        this.activeProtocol = undefined;
-        if (this.input.verbose) {
-          process.stderr.write(`[agent] failed to start ${provider}: ${error instanceof Error ? error.message : String(error)}\n`);
-        }
-      }
-    }
-
-    this.status = "unavailable";
-    this.error = "没有可用的 Agent provider。请安装 Claude Code 或 Codex CLI。";
-    this.sendCapabilities();
-  }
-
-  private async ensureClient(): Promise<void> {
-    if (this.client) return;
-    await this.tryStartFirstAvailable();
-  }
-
-  private async ensureSession(
-    cwd: string,
-    mcpServers?: Record<string, unknown>,
-  ): Promise<void> {
-    await this.ensureClient();
-    if (!this.client || this.agentSessionId) return;
-    try {
-      const result = await this.client.newSession({ cwd, mcpServers });
-      this.agentSessionId = this.extractSessionId(result) ?? id("agent-session");
-      this.status = "idle";
-      this.error = undefined;
-      this.sendUpdate({ kind: "status", status: "idle" });
-    } catch (error) {
-      this.status = "error";
-      this.error = error instanceof Error ? error.message : String(error);
-      this.sendUpdate({ kind: "error", error: this.error, status: "error" });
-    }
-  }
-
-  private async sendPrompt(payload: {
-    agentSessionId?: string;
-    clientMessageId: string;
-    contentBlocks: { type: "text" | "image"; text?: string; data?: string; mimeType?: string }[];
-    model?: string;
-    reasoningEffort?: string;
-    permissionMode?: "read_only" | "workspace_write" | "full_access";
-  }): Promise<void> {
-    await this.ensureSession(this.input.cwd);
-    if (!this.client || !this.agentSessionId) return;
-
-    const content = payload.contentBlocks
-      .map((block) => (block.type === "text" ? block.text ?? "" : `[${block.mimeType ?? "image"} attachment]`))
-      .filter(Boolean)
-      .join("\n");
-    const userMessage: AgentMessage = {
-      id: payload.clientMessageId,
-      role: "user",
-      content,
-      createdAt: Date.now(),
-    };
-    this.messages.push(userMessage);
-    this.status = "running";
-    this.sendUpdate({ kind: "message", message: userMessage, status: "running" });
-
-    try {
-      const result = await this.client.prompt({
-        sessionId: payload.agentSessionId ?? this.agentSessionId,
-        content: payload.contentBlocks,
-        clientMessageId: payload.clientMessageId,
-        model: payload.model,
-        reasoningEffort: payload.reasoningEffort,
-        permissionMode: payload.permissionMode,
-        cwd: this.input.cwd,
-      });
-      this.currentTurnId = this.extractTurnId(result) ?? this.currentTurnId;
-      if (this.status === "running") {
-        this.status = "idle";
-        this.sendUpdate({ kind: "status", status: "idle" });
-      }
-    } catch (error) {
-      this.status = "error";
-      this.error = error instanceof Error ? error.message : String(error);
-      this.sendUpdate({ kind: "error", error: this.error, status: "error" });
-    }
-  }
-
-  private handleRequest(method: string, params: unknown): Promise<unknown> | unknown {
-    if (isPermissionRequestMethod(method)) {
-      return this.handlePermission(params, true, method);
-    }
-    if (this.input.verbose) {
-      process.stderr.write(`[agent:request] unsupported ${method}\n`);
-    }
-    return {};
-  }
-
-  private async sendSessionList(): Promise<void> {
-    await this.ensureClient();
-    if (!this.client) return;
-    try {
-      const result = await this.client.listSessions();
-      this.sendUpdate({
-        kind: "status",
-        status: "idle",
-        delta: stringify(result).slice(0, 4000),
-      });
-    } catch (error) {
-      this.sendUpdate({
-        kind: "error",
-        error: error instanceof Error ? error.message : String(error),
-        status: "error",
-      });
-    }
-  }
-
-  private handleNotification(method: string, params: unknown): void {
-    if (this.input.verbose) {
-      process.stderr.write(`[agent] ${method} ${stringify(params).slice(0, 500)}\n`);
-    }
-    if (
-      method === "initialized" ||
-      method.startsWith("account/") ||
-      method.startsWith("mcpServer/startupStatus/") ||
-      method === "thread/status/changed" ||
-      method === "thread/tokenUsage/updated" ||
-      method === "serverRequest/resolved" ||
-      method === "mcpServer/oauthLogin/completed"
-    ) {
-      return;
-    }
-    if (method === "thread/started") {
-      this.agentSessionId = this.extractSessionId(params) ?? this.agentSessionId;
-      this.status = "idle";
-      this.sendUpdate({ kind: "status", status: "idle" });
-      return;
-    }
-    if (method === "turn/started") {
-      this.currentTurnId = this.extractTurnId(params) ?? this.currentTurnId;
-      this.status = "running";
-      this.sendUpdate({ kind: "status", status: "running" });
-      return;
-    }
-    if (method === "turn/completed") {
-      this.currentTurnId = undefined;
-      this.status = "idle";
-      this.sendUpdate({ kind: "status", status: "idle" });
-      return;
-    }
-    if (isPermissionRequestMethod(method)) {
-      this.handlePermission(params, false, method);
-      return;
-    }
-
-    switch (method) {
-      case "item/agentMessage/delta":
-        this.handleAgentMessageDelta(params);
-        return;
-      case "turn/plan/updated":
-        this.handlePlanUpdated(params);
-        return;
-      case "item/plan/delta":
-        this.handlePlanDelta(params);
-        return;
-      case "item/started":
-        this.handleItemStarted(params);
-        return;
-      case "item/completed":
-        this.handleItemCompleted(params);
-        return;
-      case "item/commandExecution/outputDelta":
-      case "item/fileChange/outputDelta":
-      case "item/mcpToolCall/progress":
-        this.handleToolDelta(method, params);
-        return;
-      case "item/fileChange/patchUpdated":
-        this.handleFilePatchUpdated(params);
-        return;
-      case "turn/diff/updated":
-        this.handleTurnDiffUpdated(params);
-        return;
-      case "command/exec/outputDelta":
-        this.handleCommandExecDelta(params);
-        return;
-      case "item/autoApprovalReview/started":
-      case "item/autoApprovalReview/completed":
-      case "item/commandExecution/terminalInteraction":
-        return;
-    }
-
-    if (method === "session/update") {
-      this.handleUpdate(params);
-      return;
-    }
-
-    if (this.input.verbose) {
-      process.stderr.write(`[agent] ignored ${method}\n`);
-    }
-  }
-
-  private handlePermission(
-    params: unknown,
-    waitForResponse: boolean,
-    source?: string,
-  ): Promise<unknown> | void {
-    const raw = typeof params === "object" && params ? params as Record<string, unknown> : {};
-    const requestId = firstString(raw, ["requestId", "id", "permissionId"]) ?? id("perm");
-    const rawToolCall = typeof raw.toolCall === "object" && raw.toolCall
-      ? raw.toolCall as Record<string, unknown>
-      : raw;
-    const permission: AgentPermission = {
-      requestId,
-      toolName: firstString(rawToolCall, ["toolName", "tool", "name", "title", "kind"]),
-      toolInput: stringify(rawToolCall.input ?? rawToolCall.toolInput ?? rawToolCall),
-      context: firstString(raw, ["context", "description", "message", "title"]),
-      options: parsePermissionOptions(raw.options),
-    };
-    this.pendingPermissions.set(requestId, permission);
-    if (source) this.permissionSources.set(requestId, source);
-    this.status = "waiting_permission";
-    this.input.send(createEnvelope({
-      type: "agent.permission.request",
-      sessionId: this.input.sessionId,
-      payload: { agentSessionId: this.agentSessionId, ...permission },
-    }));
-
-    if (!waitForResponse) return;
-
-    return new Promise((resolve) => {
-      const timer = setTimeout(() => {
-        this.pendingPermissions.delete(requestId);
-        this.permissionWaiters.delete(requestId);
-        this.permissionSources.delete(requestId);
-        resolve(formatPermissionResponse(source, "cancelled", "cancelled"));
-        this.sendSnapshot();
-      }, PERMISSION_TIMEOUT_MS);
-      this.permissionWaiters.set(requestId, { resolve, timer });
-    });
-  }
-
-  private handleAgentMessageDelta(params: unknown): void {
-    const raw = asRecord(params);
-    if (!raw) return;
-    const itemId = firstString(raw, ["itemId", "id", "messageId"]) ?? id("msg");
-    const delta = firstString(raw, ["delta", "text", "content"]);
-    if (!delta) return;
-    const current = this.messages.find((message) => message.id === itemId);
-    const message: AgentMessage = {
-      id: itemId,
-      role: "assistant",
-      content: `${current?.content ?? ""}${delta}`,
-      createdAt: current?.createdAt ?? Date.now(),
-      isStreaming: true,
-    };
-    this.upsertMessage(message);
-    this.status = "running";
-    this.sendUpdate({ kind: "message_delta", message, delta, status: "running" });
-  }
-
-  private handlePlanUpdated(params: unknown): void {
-    const raw = asRecord(params);
-    const plan = Array.isArray(raw?.plan) ? raw.plan : [];
-    this.plan = plan
-      .map((entry, index) => {
-        const step = asRecord(entry);
-        const text = firstString(step ?? {}, ["text", "title", "description", "message"]);
-        if (!text) return undefined;
-        return {
-          id: firstString(step ?? {}, ["id"]) ?? `plan-${index + 1}`,
-          text,
-          status: normalizePlanStatus(step?.status),
-        } satisfies AgentPlanStep;
-      })
-      .filter((step): step is AgentPlanStep => Boolean(step));
-    if (this.plan.length > 0) {
-      this.sendUpdate({ kind: "plan", plan: this.plan, status: "running" });
-    }
-  }
-
-  private handlePlanDelta(params: unknown): void {
-    const raw = asRecord(params);
-    if (!raw) return;
-    const itemId = firstString(raw, ["itemId", "id"]) ?? id("plan");
-    const delta = firstString(raw, ["delta", "text"]);
-    if (!delta) return;
-    const text = `${this.planDeltaBuffers.get(itemId) ?? ""}${delta}`;
-    this.planDeltaBuffers.set(itemId, text);
-    const existing = this.plan.findIndex((step) => step.id === itemId);
-    const step: AgentPlanStep = { id: itemId, text, status: "in_progress" };
-    if (existing >= 0) this.plan[existing] = step;
-    else this.plan.push(step);
-    this.sendUpdate({ kind: "plan", plan: this.plan, status: "running" });
-  }
-
-  private handleItemStarted(params: unknown): void {
-    const item = extractItem(params);
-    if (!item) return;
-    const itemType = firstString(item, ["type"]);
-
-    if (itemType === "agentMessage" || itemType === "assistantMessage") {
-      this.handleCompletedMessageItem(item, true);
-      return;
-    }
-
-    if (itemType === "plan") {
-      const planStep = planStepFromItem(item);
-      if (planStep) {
-        const existing = this.plan.findIndex((step) => step.id === planStep.id);
-        if (existing >= 0) this.plan[existing] = planStep;
-        else this.plan.push(planStep);
-        this.sendUpdate({ kind: "plan", plan: this.plan, status: "running" });
-      }
-      return;
-    }
-
-    const toolCall = this.withToolCreatedAt(this.toolCallFromItem(item, "running"));
-    if (!toolCall) return;
-    this.toolCalls.set(toolCall.id, toolCall);
-    this.sendUpdate({ kind: "tool_call", toolCall, status: "running" });
-  }
-
-  private handleItemCompleted(params: unknown): void {
-    const item = extractItem(params);
-    if (!item) return;
-    const itemType = firstString(item, ["type"]);
-
-    if (itemType === "agentMessage" || itemType === "assistantMessage") {
-      this.handleCompletedMessageItem(item, false);
-      return;
-    }
-
-    if (itemType === "plan") {
-      const planStep = planStepFromItem(item);
-      if (planStep) {
-        const existing = this.plan.findIndex((step) => step.id === planStep.id);
-        const completed = { ...planStep, status: "completed" as const };
-        if (existing >= 0) this.plan[existing] = completed;
-        else this.plan.push(completed);
-        this.sendUpdate({ kind: "plan", plan: this.plan, status: this.status === "running" ? "running" : "idle" });
-      }
-      return;
-    }
-
-    const toolCall = this.withToolCreatedAt(
-      this.toolCallFromItem(item, normalizeToolStatus(item.status, true)),
-    );
-    if (!toolCall) return;
-    const bufferedOutput = this.toolOutputBuffers.get(toolCall.id);
-    if (bufferedOutput && !toolCall.output) toolCall.output = bufferedOutput;
-    this.toolCalls.set(toolCall.id, toolCall);
-    this.sendUpdate({ kind: "tool_result", toolCall, status: this.status === "running" ? "running" : "idle" });
-  }
-
-  private handleToolDelta(method: string, params: unknown): void {
-    const raw = asRecord(params);
-    if (!raw) return;
-    const itemId = firstString(raw, ["itemId", "id", "toolCallId"]) ?? id("tool");
-    const delta = firstString(raw, ["delta", "message", "text"]);
-    if (!delta) return;
-    const output = appendCapped(this.toolOutputBuffers.get(itemId), delta, 6000);
-    this.toolOutputBuffers.set(itemId, output);
-    const existing = this.toolCalls.get(itemId);
-    const toolCall: AgentToolCall = {
-      id: itemId,
-      name: existing?.name ?? nameFromToolMethod(method),
-      input: existing?.input,
-      output,
-      createdAt: existing?.createdAt ?? Date.now(),
-      status: "running",
-    };
-    this.toolCalls.set(itemId, toolCall);
-    this.sendUpdate({ kind: "tool_call", toolCall, status: "running" });
-  }
-
-  private handleFilePatchUpdated(params: unknown): void {
-    const raw = asRecord(params);
-    if (!raw) return;
-    const itemId = firstString(raw, ["itemId", "id"]) ?? id("file");
-    const changes = Array.isArray(raw.changes) ? raw.changes : [];
-    const output = extractDiffText(raw) ?? summarizeFileChanges(changes);
-    const existing = this.toolCalls.get(itemId);
-    const toolCall = this.withToolCreatedAt({
-      id: itemId,
-      name: existing?.name ?? "文件修改",
-      input: existing?.input,
-      output: output || existing?.output,
-      createdAt: existing?.createdAt ?? Date.now(),
-      status: existing?.status ?? "running",
-    });
-    if (!toolCall) return;
-    if (toolCall.id !== itemId) this.toolCalls.delete(itemId);
-    this.toolCalls.set(toolCall.id, toolCall);
-    this.sendUpdate({ kind: "tool_call", toolCall, status: "running" });
-  }
-
-  private handleTurnDiffUpdated(params: unknown): void {
-    const raw = asRecord(params);
-    if (!raw) return;
-    const diff = extractDiffText(raw);
-    if (!diff) return;
-    const itemId = firstString(raw, ["itemId", "id", "turnId"]) ?? "workspace-diff";
-    const changes = Array.isArray(raw.changes) ? raw.changes : [];
-    const existing = this.toolCalls.get(itemId);
-    const toolCall = this.withToolCreatedAt({
-      id: itemId,
-      name: existing?.name ?? "文件修改",
-      input: existing?.input ?? summarizeFileChanges(changes),
-      output: diff,
-      createdAt: existing?.createdAt ?? Date.now(),
-      status: existing?.status ?? "running",
-    });
-    if (!toolCall) return;
-    if (toolCall.id !== itemId) this.toolCalls.delete(itemId);
-    this.toolCalls.set(toolCall.id, toolCall);
-    this.sendUpdate({ kind: "tool_call", toolCall, status: "running" });
-  }
-
-  private handleCommandExecDelta(params: unknown): void {
-    const raw = asRecord(params);
-    if (!raw) return;
-    const processId = firstString(raw, ["processId", "id"]) ?? id("exec");
-    const delta =
-      firstString(raw, ["delta", "text"]) ??
-      decodeBase64(firstString(raw, ["deltaBase64"]));
-    if (!delta) return;
-    const output = appendCapped(this.toolOutputBuffers.get(processId), delta, 6000);
-    this.toolOutputBuffers.set(processId, output);
-    const existing = this.toolCalls.get(processId);
-    const toolCall: AgentToolCall = {
-      id: processId,
-      name: existing?.name ?? "命令输出",
-      input: existing?.input,
-      output,
-      createdAt: existing?.createdAt ?? Date.now(),
-      status: "running",
-    };
-    this.toolCalls.set(processId, toolCall);
-    this.sendUpdate({ kind: "tool_call", toolCall, status: "running" });
-  }
-
-  private handleCompletedMessageItem(item: Record<string, unknown>, streaming: boolean): void {
-    const itemId = firstString(item, ["id"]) ?? id("msg");
-    const existing = this.messages.find((message) => message.id === itemId);
-    const content = firstString(item, ["text", "content", "message"]) ?? existing?.content;
-    if (!content) return;
-    const message: AgentMessage = {
-      id: itemId,
-      role: "assistant",
-      content,
-      createdAt: existing?.createdAt ?? Date.now(),
-      isStreaming: streaming,
-    };
-    this.upsertMessage(message);
-    this.sendUpdate({
-      kind: streaming ? "message_delta" : "message",
-      message,
-      status: this.status === "running" ? "running" : "idle",
-    });
-  }
-
-  private toolCallFromItem(
-    item: Record<string, unknown>,
-    fallbackStatus: AgentToolCall["status"],
-  ): AgentToolCall | undefined {
-    const itemId = firstString(item, ["id", "itemId", "toolCallId"]);
-    if (!itemId) return undefined;
-    const itemType = firstString(item, ["type"]);
-    const name = toolNameFromItem(item);
-    if (!name && !isToolItemType(itemType)) return undefined;
-    const bufferedOutput = this.toolOutputBuffers.get(itemId);
-    const rawOutput =
-      firstString(item, ["aggregatedOutput", "output", "stdout", "stderr"]) ??
-      stringifyDefined(item.result ?? item.error ?? item.contentItems);
-    const output = itemType === "fileChange"
-      ? extractDiffText(item) ?? bufferedOutput ?? rawOutput
-      : rawOutput ?? bufferedOutput;
-    return {
-      id: itemId,
-      name: name ?? "工具",
-      input: toolInputFromItem(item),
-      output,
-      createdAt: Date.now(),
-      status: normalizeToolStatus(item.status, fallbackStatus === "completed"),
-    };
-  }
-
-  private handleUpdate(params: unknown): void {
-    const raw = typeof params === "object" && params ? params as Record<string, unknown> : {};
-    const nested = typeof raw.params === "object" && raw.params ? raw.params as Record<string, unknown> : {};
-    const text =
-      firstString(raw, ["delta", "text", "content", "message"]) ??
-      firstString(nested, ["delta", "text", "content", "message"]) ??
-      undefined;
-    if (!text) return;
-    const role = raw.role === "user" || raw.role === "system" ? raw.role : "assistant";
-
-    if (firstString(raw, ["toolName", "tool", "name"])) {
-      const toolCall: AgentToolCall = {
-        id: firstString(raw, ["toolCallId", "callId", "id"]) ?? id("tool"),
-        name: firstString(raw, ["toolName", "tool", "name"]) ?? "tool",
-        input: stringify(raw.input ?? raw.toolInput ?? ""),
-        output: stringify(raw.output ?? raw.result ?? ""),
-        createdAt: Date.now(),
-        status: raw.status === "completed" || raw.status === "failed" || raw.status === "running"
-          ? raw.status
-          : "running",
-      };
-      const nextToolCall = this.withToolCreatedAt(toolCall);
-      if (!nextToolCall) return;
-      this.toolCalls.set(nextToolCall.id, nextToolCall);
-      this.sendUpdate({ kind: "tool_call", toolCall: nextToolCall, status: "running" });
-      return;
-    }
-
-    const message: AgentMessage = {
-      id: firstString(raw, ["messageId", "id"]) ?? id("msg"),
-      role,
-      content: text,
-      createdAt: Date.now(),
-      isStreaming: raw.done === false || raw.isStreaming === true,
-    };
-    this.upsertMessage(message);
-    this.status = raw.done === true ? "idle" : "running";
-    this.sendUpdate({
-      kind: "message",
-      message,
-      status: this.status === "running" ? "running" : "idle",
-    });
-  }
-
-  private handleExit(message: string): void {
-    this.cancelPendingPermissions();
-    this.status = "error";
-    this.error = message;
-    this.client = undefined;
-    this.activeProtocol = undefined;
-    this.sendUpdate({ kind: "error", error: message, status: "error" });
-  }
-
-  private cancelPendingPermissions(): void {
-    for (const [requestId, waiter] of this.permissionWaiters) {
-      clearTimeout(waiter.timer);
-      waiter.resolve(formatPermissionResponse(
-        this.permissionSources.get(requestId),
-        "cancelled",
-        "cancelled",
-      ));
-      this.pendingPermissions.delete(requestId);
-      this.permissionSources.delete(requestId);
-    }
-    this.permissionWaiters.clear();
-  }
-
-  private upsertMessage(message: AgentMessage): void {
-    const existing = this.messages.findIndex((entry) => entry.id === message.id);
-    if (existing >= 0) this.messages[existing] = message;
-    else this.messages.push(message);
-    if (this.messages.length > 100) this.messages.shift();
-  }
-
-  private withToolCreatedAt(toolCall: AgentToolCall | undefined): AgentToolCall | undefined {
-    if (!toolCall) return undefined;
-    const duplicate = this.findDuplicateFileTool(toolCall);
-    const existing = duplicate ?? this.toolCalls.get(toolCall.id);
-    return {
-      ...existing,
-      ...toolCall,
-      id: existing?.id ?? toolCall.id,
-      createdAt: existing?.createdAt ?? toolCall.createdAt ?? Date.now(),
-    };
-  }
-
-  private findDuplicateFileTool(toolCall: AgentToolCall): AgentToolCall | undefined {
-    const output = toolCall.output?.trim();
-    if (!toolCall.name.includes("文件") || !output) return undefined;
-    return [...this.toolCalls.values()].find((existing) =>
-      existing.id !== toolCall.id &&
-      existing.name.includes("文件") &&
-      existing.output?.trim() === output
-    );
-  }
-
-  private sendCapabilities(): void {
-    const enabled = Boolean(this.client && this.initialized && !this.error);
-    const activeProvider = this.activeProvider ?? this.input.availableProviders[0];
-    const supportsPermission = enabled && this.activeProtocol !== "claude-stream-json";
-    this.input.send(createEnvelope({
-      type: "agent.capabilities",
-      sessionId: this.input.sessionId,
-      payload: {
-        enabled,
-        provider: activeProvider ?? "codex",
-        protocolVersion: 1,
-        error: enabled ? undefined : this.error,
-        supportsSessionList: enabled,
-        supportsSessionLoad: enabled,
-        supportsImages: enabled && protocolSupportsImages(this.activeProtocol),
-        supportsAudio: false,
-        supportsPermission,
-        supportsPlan: enabled,
-        supportsCancel: enabled,
-      },
-    }));
-  }
-
-  private sendSnapshot(): void {
-    this.input.send(createEnvelope({
-      type: "agent.snapshot",
-      sessionId: this.input.sessionId,
-      payload: {
-        agentSessionId: this.agentSessionId,
-        messages: this.messages,
-        toolCalls: [...this.toolCalls.values()],
-        pendingPermissions: [...this.pendingPermissions.values()],
-        status: this.status,
-        error: this.error,
-      },
-    }));
-  }
-
-  private sendUpdate(payload: {
-    kind: "message" | "message_delta" | "tool_call" | "tool_result" | "plan" | "status" | "error";
-    message?: AgentMessage;
-    delta?: string;
-    toolCall?: AgentToolCall;
-    plan?: AgentPlanStep[];
-    status?: "idle" | "running" | "waiting_permission" | "error";
-    error?: string;
-  }): void {
-    this.input.send(createEnvelope({
-      type: "agent.update",
-      sessionId: this.input.sessionId,
-      payload: { agentSessionId: this.agentSessionId, ...payload },
-    }));
-  }
-
-  private extractSessionId(value: unknown): string | undefined {
-    if (!value || typeof value !== "object") return undefined;
-    const raw = value as Record<string, unknown>;
-    if (raw.thread && typeof raw.thread === "object") {
-      const threadId = firstString(raw.thread as Record<string, unknown>, ["id", "threadId"]);
-      if (threadId) return threadId;
-    }
-    return firstString(raw, ["sessionId", "id", "agentSessionId"]);
-  }
-
-  private extractTurnId(value: unknown): string | undefined {
-    if (!value || typeof value !== "object") return undefined;
-    const raw = value as Record<string, unknown>;
-    if (raw.turn && typeof raw.turn === "object") {
-      const turnId = firstString(raw.turn as Record<string, unknown>, ["id", "turnId"]);
-      if (turnId) return turnId;
-    }
-    return firstString(raw, ["turnId", "id"]);
-  }
-}
-
-function parsePermissionOptions(value: unknown): AgentPermission["options"] {
-  if (!Array.isArray(value)) {
-    return [
-      { id: "allow", label: "允许", kind: "allow" },
-      { id: "deny", label: "拒绝", kind: "deny" },
-    ];
-  }
-
-  const options = value
-    .map((entry, index) => {
-      const raw = typeof entry === "object" && entry ? entry as Record<string, unknown> : {};
-      const idValue = raw.optionId ?? raw.id ?? raw.kind ?? `option-${index + 1}`;
-      const labelValue = raw.name ?? raw.label ?? raw.kind ?? String(idValue);
-      const id = String(idValue);
-      const label = String(labelValue);
-      const normalized = `${id} ${label}`.toLowerCase();
-      const kind: AgentPermission["options"][number]["kind"] = normalized.includes("reject") || normalized.includes("deny")
-        ? "deny"
-        : normalized.includes("allow")
-          ? "allow"
-          : "other";
-      return { id, label, kind };
-    })
-    .filter((option) => option.id.length > 0 && option.label.length > 0);
-
-  return options.length > 0
-    ? options
-    : [
-        { id: "allow", label: "允许", kind: "allow" },
-        { id: "deny", label: "拒绝", kind: "deny" },
-      ];
-}
-
-function selectPermissionOption(
-  permission: AgentPermission | undefined,
-  outcome: "allow" | "deny" | "cancelled",
-): string {
-  if (outcome === "cancelled") return "cancelled";
-  const option = permission?.options.find((item) => item.kind === outcome);
-  return option?.id ?? outcome;
-}
-
-function isPermissionRequestMethod(method: string): boolean {
-  return (
-    method === "session/request_permission" ||
-    method.endsWith("/requestApproval") ||
-    method === "mcpServer/elicitation/request" ||
-    method === "item/tool/requestUserInput" ||
-    method === "claude/requestApproval"
-  );
-}
-
-function formatPermissionResponse(
-  source: string | undefined,
-  outcome: "allow" | "deny" | "cancelled",
-  optionId: string,
-): unknown {
-  if (source === "item/commandExecution/requestApproval" || source === "item/fileChange/requestApproval") {
-    return { decision: outcome === "allow" ? "accept" : outcome === "deny" ? "decline" : "cancel" };
-  }
-  if (source === "item/permissions/requestApproval") {
-    if (outcome === "allow") {
-      return {
-        permissions: { type: "managed", network: { enabled: true }, fileSystem: { type: "fullAccess" } },
-        scope: optionId.includes("session") ? "session" : "turn",
-      };
-    }
-    return { permissions: { type: "managed", network: { enabled: false }, fileSystem: { type: "readOnly" } } };
-  }
-  if (source === "claude/requestApproval") {
-    return { behavior: outcome === "allow" ? "allow" : "deny" };
-  }
-  return {
-    outcome:
-      outcome === "cancelled"
-        ? { outcome: "cancelled" }
-        : { outcome: "selected", optionId },
-  };
-}