chatccc 0.2.252 → 0.2.253

package/src/adapters/adapter-interface.ts

@@ -1,217 +0,0 @@
-// =============================================================================
-// adapter-interface.ts — 统一的 AI 工具适配器接口和归一化消息类型
-// =============================================================================
-// 所有 AI 工具适配器（Claude SDK、Cursor CLI、Codex CLI 等）都必须实现
-// ToolAdapter 接口。归一化消息类型 UnifiedBlock 屏蔽了各工具的差异，
-// 使 session.ts 不需要关心底层是哪个 AI 工具。
-// =============================================================================
-
-// ---------------------------------------------------------------------------
-// UnifiedBlock — 归一化后的消息块
-// ---------------------------------------------------------------------------
-
-export interface UnifiedThinkingBlock {
-  type: "thinking";
-  thinking: string;
-}
-
-export interface UnifiedTextBlock {
-  type: "text";
-  text: string;
-}
-
-/**
- * 适配器明确告知"这是一段完整的最终文本"（覆盖语义，而非追加）。
- *
- * 背景：Cursor CLI 在 `--stream-partial-output` 模式下，先发若干条 partial assistant
- * 消息（每条只是 delta 增量），流结束时再发一条 final assistant 消息（完整文本）。
- * 若把 final 也按 `text` 追加到 finalText，最终会出现"partial 累加 + final 完整"
- * 共两段重复内容。因此 cursor-adapter 把 final 这条标记为 text_final，
- * 由 session.ts 累积到独立字段 finalCompleteText（覆盖语义），最终发送时
- * 由 pickFinalReply 在两者之间挑选。
- *
- * 对没有 partial/final 双轨的适配器（如 Claude SDK），永远不会 emit 此类型。
- *
- * 命名注意：此处的 "final" 指"完整/最终版本"（与 partial delta 相对），
- * 不等于 stream-state / AccumulatorState 中的 finalReply / finalText。
- * 后者命名含 "final" 但实际语义是"本轮所有文本的累积"，属历史遗留命名，
- * 详见 session.ts 的 AccumulatorState 注释和 stream-state.ts 的 StreamState 注释。
- */
-export interface UnifiedTextFinalBlock {
-  type: "text_final";
-  text: string;
-}
-
-export interface UnifiedToolUseBlock {
-  type: "tool_use";
-  /** 工具调用 ID，用于与 tool_result 对应（Claude SDK 会提供，Cursor 旧格式可能无） */
-  id?: string;
-  name: string;
-  input: unknown;
-}
-
-export interface UnifiedToolResultBlock {
-  type: "tool_result";
-  tool_use_id: string;
-  content: unknown;
-  is_error?: boolean;
-}
-
-export interface UnifiedRedactedThinkingBlock {
-  type: "redacted_thinking";
-}
-
-export interface UnifiedSearchResultBlock {
-  type: "search_result";
-  query: string;
-}
-
-export interface UnifiedCompactBoundaryBlock {
-  type: "compact_boundary";
-  trigger: "manual" | "auto";
-  pre_tokens: number;
-  post_tokens?: number;
-}
-
-export interface UnifiedAgentStatusBlock {
-  type: "agent_status";
-  status: "compacting" | "responding";
-}
-
-export type UnifiedBlock =
-  | UnifiedAgentStatusBlock
-  | UnifiedThinkingBlock
-  | UnifiedTextBlock
-  | UnifiedTextFinalBlock
-  | UnifiedToolUseBlock
-  | UnifiedToolResultBlock
-  | UnifiedRedactedThinkingBlock
-  | UnifiedSearchResultBlock
-  | UnifiedCompactBoundaryBlock;
-
-// ---------------------------------------------------------------------------
-// UnifiedStreamMessage — 一次 SDK/CLI 事件对应的归一化消息
-// ---------------------------------------------------------------------------
-
-export interface UnifiedStreamMessage {
-  type: "assistant" | "user" | "system";
-  blocks: UnifiedBlock[];
-  /**
-   * 适配器确认本事件代表一条完整、权威的最终回复，而不是流式文本片段。
-   *
-   * response-stall 终止与最终事件可能在同一事件循环边界竞态；只有该标记
-   * 为 true 时，上层才允许把已经触发的超时改判为正常完成。
-   */
-  isFinalResponse?: boolean;
-}
-
-// ---------------------------------------------------------------------------
-// CreateSessionResult
-// ---------------------------------------------------------------------------
-
-export interface CreateSessionResult {
-  sessionId: string;
-}
-
-// ---------------------------------------------------------------------------
-// SessionInfo — 会话元数据（/state、/cd 等命令使用）
-// ---------------------------------------------------------------------------
-
-export interface SessionInfo {
-  sessionId: string;
-  cwd?: string;
-  summary?: string;
-  lastModified?: number;
-  /**
-   * 会话实际使用的模型展示名（如 Cursor 的 `Composer 2 Fast`）。
-   * - Cursor adapter：从 cursor-agent system/init 事件学习并持久化到 store
-   * - Claude adapter：留空（model 由 ChatCCC 配置 `CLAUDE_MODEL` 决定，不从 SDK 取）
-   * 上层 /state、/sessions 渲染时按 tool 决定显示哪一来源。
-   */
-  model?: string;
-}
-
-export interface ToolProcessInfo {
-  /** Root PID returned by child_process.spawn. With shell:true this is the shell wrapper PID. */
-  pid: number;
-}
-
-export interface ToolPromptOptions {
-  /** Called once a CLI-backed prompt process has been spawned. */
-  onProcessStart?: (info: ToolProcessInfo) => void;
-  /** Called when the adapter leaves the prompt process scope normally or by abort. */
-  onProcessExit?: (info: ToolProcessInfo) => void;
-  /** Called when the adapter creates an SDK session internally.
-   *  The callback receives a close function that terminates the underlying
-   *  subprocess. Used by stop-stuck-loop to kill the CLI process immediately. */
-  onSessionCreated?: (closeSession: () => void) => void;
-}
-
-// ---------------------------------------------------------------------------
-// ToolAdapter — 统一的 AI 工具适配器接口
-// ---------------------------------------------------------------------------
-
-export interface ToolAdapter {
-  /** 日志/展示用名称，如 "Claude" */
-  readonly displayName: string;
-
-  /** 群描述中会话 ID 的前缀，如 "Claude Session:" */
-  readonly sessionDescPrefix: string;
-
-  /**
-   * Whether ChatCCC may infer a stalled response from unchanged streamed output.
-   * Defaults to true. Adapters that only emit output after a request completes must disable it.
-   */
-  readonly responseStallDetectionEnabled?: boolean;
-
-  /**
-   * 创建新会话，返回会话 ID。
-   * 适配器内部需处理后台流消费（静默消费 stream 中除 init 外的所有事件）。
-   * signal 用于上层在长期收不到 init 事件时终止底层 SDK/CLI。
-   */
-  createSession(cwd: string, signal?: AbortSignal): Promise<CreateSessionResult>;
-
-  /**
-   * 向已有会话发送提示文本，返回归一化消息的异步迭代器。
-   * 消费者遍历结束后（或提前中止时）适配器自动关闭底层会话。
-   */
-  prompt(
-    sessionId: string,
-    userText: string,
-    cwd: string,
-    signal?: AbortSignal,
-    options?: ToolPromptOptions,
-  ): AsyncIterable<UnifiedStreamMessage>;
-
-  /**
-   * 查询会话元数据。会话不存在时返回 undefined。
-   */
-  getSessionInfo(sessionId: string): Promise<SessionInfo | undefined>;
-
-  /**
-   * 关闭/清理会话（/stop 或中断时调用）。
-   * 对于流式结束后自动关闭的适配器（如 Claude SDK），此为 no-op。
-   */
-  closeSession(sessionId: string): Promise<void>;
-}
-
-// ---------------------------------------------------------------------------
-// parseUserCommand — 从包装后的 userText 中提取原始用户消息并判断模式
-// ---------------------------------------------------------------------------
-
-export interface UserCommand {
-  /** 原始用户消息（去除包装） */
-  original: string;
-  /** 检测到的模式：plan / ask / null（普通消息） */
-  mode: "plan" | "ask" | null;
-}
-
-/** 从 [User message]...[/User message] 包装中提取原始消息并识别 /plan /ask 前缀 */
-export function parseUserCommand(userText: string): UserCommand {
-  const match = userText.match(/\[User message\]\n(.*?)\n\[\/User message\]/s);
-  if (!match) return { original: "", mode: null };
-  const original = match[1].trimStart();
-  if (original.startsWith("/plan")) return { original, mode: "plan" };
-  if (original.startsWith("/ask")) return { original, mode: "ask" };
-  return { original, mode: null };
-}

package/src/adapters/ccc-adapter.ts

@@ -1,150 +0,0 @@
-import { ChatSession, type ChatSessionConfig, type ChatSessionOptions } from "../../deepccc-agent/src/index.ts";
-import { config as deepCccConfig } from "../../deepccc-agent/src/config.ts";
-import {
-  getBuiltinContextSession,
-  newBuiltinSessionId,
-  normalizeBuiltinSessionId,
-} from "../../deepccc-agent/src/context.ts";
-import { config, CCC_SESSION_PREFIX } from "../config.ts";
-import type {
-  CreateSessionResult,
-  SessionInfo,
-  ToolAdapter,
-  ToolPromptOptions,
-  UnifiedStreamMessage,
-} from "./adapter-interface.ts";
-
-export interface CccAdapterOptions extends ChatSessionConfig {
-  contextDir?: string;
-  compactAtTokens?: number;
-  keepRecentMessages?: number;
-  compactionTimeoutMs?: number;
-  maxSteps?: number;
-}
-
-function toChatSessionOptions(
-  sessionId: string,
-  cwd: string,
-  options: CccAdapterOptions,
-): ChatSessionOptions {
-  return {
-    cwd,
-    persist: true,
-    sessionId,
-    contextDir: options.contextDir,
-    compactAtTokens: options.compactAtTokens,
-    keepRecentMessages: options.keepRecentMessages,
-    compactionTimeoutMs: options.compactionTimeoutMs,
-    maxSteps: options.maxSteps,
-    // chatccc 无终端可交互，且对齐 claude/codex 适配器的 bypass 模式：
-    // 高危命令不询问，全部放行（与独立 deepccc CLI 的 ask 模式不同）
-    permissionMode: "bypass",
-  };
-}
-
-export function createCccAdapter(options: CccAdapterOptions = {}): ToolAdapter {
-  if (!options.apiKey?.trim()) {
-    throw new Error("ChatCCC 未配置 CCC Agent API Key。请先填写 ccc.DEEPSEEK_API_KEY 后再启用 CCC Agent。");
-  }
-
-  const chatConfig: ChatSessionConfig = {
-    apiKey: options.apiKey,
-    ...(options.provider !== undefined ? { provider: options.provider } : {}),
-    ...(options.baseURL !== undefined ? { baseURL: options.baseURL } : {}),
-    ...(options.model !== undefined ? { model: options.model } : {}),
-    ...(options.effort !== undefined ? { effort: options.effort } : {}),
-  };
-
-  return {
-    displayName: "CCC Agent",
-    sessionDescPrefix: CCC_SESSION_PREFIX,
-    // Non-streaming DeepCCC emits its reply only after the provider request finishes,
-    // so unchanged output cannot distinguish a slow request from a stalled response.
-    responseStallDetectionEnabled: deepCccConfig.streaming,
-
-    async createSession(cwd: string): Promise<CreateSessionResult> {
-      const sessionId = newBuiltinSessionId();
-      const session = new ChatSession(
-        chatConfig,
-        toChatSessionOptions(sessionId, cwd, options),
-      );
-      session.reset();
-      return { sessionId };
-    },
-
-    async *prompt(
-      sessionId: string,
-      userText: string,
-      cwd: string,
-      signal?: AbortSignal,
-      _promptOptions?: ToolPromptOptions,
-    ): AsyncIterable<UnifiedStreamMessage> {
-      const normalizedSessionId = normalizeBuiltinSessionId(sessionId);
-      const session = new ChatSession(
-        chatConfig,
-        toChatSessionOptions(normalizedSessionId, cwd, options),
-      );
-
-      for await (const event of session.chat(userText, signal)) {
-        if (event.type === "status") {
-          yield {
-            type: "assistant",
-            blocks: [{
-              type: "agent_status",
-              status: event.phase === "compacting" ? "compacting" : "responding",
-            }],
-          };
-        } else if (event.type === "text") {
-          yield {
-            type: "assistant",
-            blocks: [{ type: "text", text: event.text }],
-          };
-        } else if (event.type === "tool_use") {
-          yield {
-            type: "assistant",
-            blocks: [{
-              type: "tool_use",
-              id: event.id,
-              name: event.name,
-              input: event.input,
-            }],
-          };
-        } else if (event.type === "tool_result") {
-          yield {
-            type: "assistant",
-            blocks: [{
-              type: "tool_result",
-              tool_use_id: event.tool_use_id,
-              content: event.content,
-              is_error: event.is_error,
-            }],
-          };
-        } else if (event.type === "done" && !signal?.aborted) {
-          yield {
-            type: "assistant",
-            blocks: [],
-            isFinalResponse: true,
-          };
-        } else if (event.type === "error") {
-          throw new Error(event.message);
-        }
-      }
-    },
-
-    async getSessionInfo(sessionId: string): Promise<SessionInfo | undefined> {
-      const normalizedSessionId = normalizeBuiltinSessionId(sessionId);
-      const info = getBuiltinContextSession(normalizedSessionId, options.contextDir);
-      if (!info) return undefined;
-      return {
-        sessionId: info.sessionId,
-        cwd: info.cwd,
-        lastModified: info.updatedAt,
-        model: options.model ?? config.ccc.model,
-      };
-    },
-
-    async closeSession(_sessionId: string): Promise<void> {
-      // ChatSession uses one request-scoped stream per prompt. AbortSignal handles cancellation.
-    },
-  };
-}