@huyooo/ai-chat-types 0.2.45 → 0.3.2

package/dist/chat-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 前端扩展事件类型 + 依赖事件类型的工具函数
+ *
+ * billing 等元数据现在通过 DataEvent（type='data', name='billing'）传递，
+ * 不再需要在此处硬编码扩展事件。
+ *
+ * compact/content_compress 事件已内置于 ChatEvent 联合类型，无需重复声明。
+ */
+import type { AssetApprovalPolicy, AssetHostDependency, AssetSideEffectLevel } from '@huyooo/ai-chat-core';
+import type { ChatEvent, ToolApprovalReason, ToolApprovalRequestEvent, ToolCallResultEvent, ToolCallStartEvent } from '@huyooo/ai-chat-core/events';
+export type FrontendChatEvent = ChatEvent;
+export interface ToolGovernanceInfo {
+    approvalReason?: ToolApprovalReason;
+    approvalPolicy?: AssetApprovalPolicy;
+    sideEffectLevel?: AssetSideEffectLevel;
+    hostDependency?: AssetHostDependency;
+}
+type ToolGovernanceEventData = ToolApprovalRequestEvent['data'] | ToolCallStartEvent['data'] | ToolCallResultEvent['data'];
+export declare function extractToolGovernance(data: ToolGovernanceEventData): ToolGovernanceInfo;
+export declare function mergeToolGovernance<T extends object>(target: T, governance: ToolGovernanceInfo): T & ToolGovernanceInfo;
+export declare function buildToolGovernanceLabels(governance: ToolGovernanceInfo): {
+    approvalReasonText?: string;
+    tags: string[];
+};
+/** 判断事件是否需要保存到数据库 */
+export declare function shouldSaveEvent(event: FrontendChatEvent): boolean;
+export {};
+//# sourceMappingURL=chat-utils.d.ts.map

package/dist/chat-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-utils.d.ts","sourceRoot":"","sources":["../src/chat-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,6BAA6B,CAAA;AAEpC,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAA;AAEzC,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,cAAc,CAAC,EAAE,mBAAmB,CAAA;IACpC,eAAe,CAAC,EAAE,oBAAoB,CAAA;IACtC,cAAc,CAAC,EAAE,mBAAmB,CAAA;CACrC;AAED,KAAK,uBAAuB,GACxB,wBAAwB,CAAC,MAAM,CAAC,GAChC,kBAAkB,CAAC,MAAM,CAAC,GAC1B,mBAAmB,CAAC,MAAM,CAAC,CAAA;AAE/B,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,GAAG,kBAAkB,CAOvF;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,MAAM,EAAE,CAAC,EACT,UAAU,EAAE,kBAAkB,GAC7B,CAAC,GAAG,kBAAkB,CAQxB;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,kBAAkB,GAAG;IACzE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAA;CACf,CAqCA;AAED,qBAAqB;AACrB,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CASjE"}

package/dist/index.d.ts

@@ -1,17 +1,41 @@
-import * as _huyooo_ai_chat_core_events from '@huyooo/ai-chat-core/events';
-export { AbortEvent, ChatEvent, ChatEventType, CompactEndEvent, CompactEvent, CompactStartEvent, DoneEvent, ErrorCategory, ErrorDetails, ErrorEvent, PlanStep, PlanStepStatus, SearchEndEvent, SearchEvent, SearchResult, SearchResultEvent, SearchStartEvent, StatusEvent, StepEndEvent, StepEvent, StepStartEvent, TextDeltaEvent, TextEvent, ThinkingDeltaEvent, ThinkingEndEvent, ThinkingEvent, ThinkingStartEvent, TokenUsage, ToolApprovalRequestEvent, ToolCallInfo, ToolCallOutputEvent, ToolCallResultEvent, ToolCallStartEvent, ToolCallStatus, ToolErrorShape, ToolEvent, ToolUIShape, createAbort, createApiError, createCompactEnd, createCompactStart, createDone, createError, createParseError, createRateLimitError, createSearchEnd, createSearchResult, createSearchStart, createStepEnd, createStepStart, createTextDelta, createThinkingDelta, createThinkingEnd, createThinkingStart, createTimeoutError, createToolCallOutput, createToolCallResult, createToolCallStart, createToolError, isAbortEvent, isCompactEvent, isErrorEvent, isRetryableError, isSearchEvent, isStatusEvent, isStepEvent, isTextEvent, isThinkingEvent, isThrowableToolError, isToolEvent } from '@huyooo/ai-chat-core/events';
-import { ModelOption, ChatEvent } from '@huyooo/ai-chat-core';
-export { AutoRunConfig, AutoRunMode, McpConnectionInfo, McpConnectionStatus, McpServerConfig, ModelOption, ProviderType, ThinkingMode } from '@huyooo/ai-chat-core';
-
-/** 对话模式（扩展支持 'plan'，兼容旧数据） */
-type ChatMode = 'agent' | 'ask' | 'plan';
-/** 聊天历史消息（无状态架构传入） */
-interface ChatHistoryMessage {
+import type { AssetApprovalPolicy, AssetHostDependency, AssetSideEffectLevel, AssetSource, FinishReason, McpConnectionStatus, ToolUI } from '@huyooo/ai-chat-core';
+/**
+ * @huyooo/ai-chat-types
+ *
+ * AI Chat 公共类型定义
+ *
+ * 架构层级：
+ * 1. ai-chat-core - 核心引擎（定义事件、工具等核心类型）
+ * 2. ai-chat-types - 公共接口（导出 ChatAdapter、重新导出 ChatEvent）
+ * 3. 各适配器包 - 实现 ChatAdapter 接口
+ */
+export type { ChatEvent, ChatEventType, AssistantSegmentReason, ToolApprovalReason, ToolCallStatus, ToolCallInfo, TokenUsage, ErrorCategory, ErrorDetails, ToolError, ToolUI, FinishReason, ToolFailureReason, ThinkingStartEvent, ThinkingDeltaEvent, ThinkingEndEvent, ThinkingEvent, ToolCallStartEvent, ToolCallResultEvent, ToolCallOutputEvent, ToolApprovalRequestEvent, ToolCallRequestEvent, ToolEvent, TextStartEvent, TextDeltaEvent, TextEndEvent, TextEvent, DataEvent, PlanStep, PlanStepStatus, DoneEvent, ErrorEvent, AbortEvent, StatusEvent, StepStartEvent, StepEndEvent, StepEvent, AssistantSegmentStartEvent, AssistantSegmentEvent, CompactStartEvent, CompactEndEvent, CompactEvent, ContentCompressStartEvent, ContentCompressEndEvent, ContentCompressEvent, } from '@huyooo/ai-chat-core/events';
+export { createThinkingStart, createThinkingDelta, createThinkingEnd, createToolCallStart, createToolCallResult, createToolCallOutput, createTextStart, createTextDelta, createTextEnd, createDone, createData, createError, createApiError, createRateLimitError, createToolError, createTimeoutError, createParseError, createAbort, createStepStart, createStepEnd, createAssistantSegmentStart, isThinkingEvent, isToolEvent, isTextEvent, isDataEvent, isStatusEvent, isErrorEvent, isAbortEvent, isStepEvent, isAssistantSegmentEvent, isCompactEvent, isContentCompressEvent, isRetryableError, isToolError, createCompactStart, createCompactEnd, createContentCompressStart, createContentCompressEnd, } from '@huyooo/ai-chat-core/events';
+export type { AssetApprovalPolicy, AssetHostDependency, AssetSideEffectLevel, AssetSource, ThinkingMode, AutoRunMode, AutoRunConfig, ModelOption, ProtocolId, McpServerConfig, McpConnectionStatus, McpConnectionInfo, } from '@huyooo/ai-chat-core';
+/** 对话模式 */
+export type ChatMode = 'agent' | 'ask';
+/** 聊天历史消息（无状态架构传入，需包含完整工具调用上下文） */
+export interface ChatHistoryMessage {
     role: 'user' | 'assistant' | 'system' | 'tool';
     content: string;
+    /** 思考内容（工具调用循环需回传，如 DeepSeek/GLM） */
+    reasoning_content?: string;
+    /** 工具消息关联的 tool_call_id */
+    tool_call_id?: string;
+    /** assistant 消息的工具调用列表 */
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+        /** Gemini 模型需要的 thought_signature */
+        thought_signature?: string;
+    }>;
 }
 /** 聊天选项（使用本地 ChatMode） */
-interface ChatOptions {
+export interface ChatOptions {
     mode?: ChatMode;
     model?: string;
     provider?: string;
@@ -21,12 +45,16 @@ interface ChatOptions {
     autoRunConfig?: {
         mode?: 'run-everything' | 'manual';
     };
+    maxIterations?: number;
+    maxDurationMs?: number;
+    maxToolCalls?: number;
+    maxTotalTokens?: number;
     history?: ChatHistoryMessage[];
     /** Skills 内容（启用的 Skills 的 content 数组，前端拼好传入） */
     skillContents?: string[];
 }
 /** 会话记录 */
-interface SessionRecord {
+export interface SessionRecord {
     id: string;
     appId: string | null;
     userId: string | null;
@@ -41,13 +69,15 @@ interface SessionRecord {
     updatedAt: Date;
 }
 /** 消息记录 */
-interface MessageRecord {
+export interface MessageRecord {
     id: string;
     /** 前端关联 ID（本地模式与 id 相同，云端模式为前端生成的 UUID） */
     clientId?: string | null;
     sessionId: string;
-    role: 'user' | 'assistant';
+    role: 'user' | 'assistant' | 'system';
     content: string;
+    /** 用户通过 @ 选择的上下文资源 */
+    atContextItems?: AtContextItem[] | null;
     /** 用户消息附带的图片（data URL 或 base64） */
     images: string[];
     /** 生成此消息时使用的模型 */
@@ -58,20 +88,31 @@ interface MessageRecord {
     webSearchEnabled?: boolean | null;
     /** 生成此消息时是否启用深度思考 */
     thinkingEnabled?: boolean | null;
-    /** 执行步骤列表 JSON */
-    steps?: string | null;
+    /** 子表中的消息内容 Part */
+    parts: MessagePartRecord[];
     operationIds?: string | null;
     /** Token 使用统计（JSON 字符串） */
     usage?: string | null;
     /** 响应耗时（毫秒） */
     duration?: number | null;
+    /** 结束原因（done 事件携带） */
+    finishReason?: FinishReason | null;
     /** 消息序号（会话内递增，用于分叉删除） */
     sequence: number;
     /** 时间戳（毫秒，Unix 时间戳） */
     timestamp: number;
 }
+export interface GetMessagesPageParams {
+    limit?: number;
+    beforeSequence?: number;
+}
+export interface MessagePage {
+    messages: MessageRecord[];
+    hasMore: boolean;
+    nextBeforeSequence: number | null;
+}
 /** 操作记录 */
-interface OperationRecord {
+export interface OperationRecord {
     id: string;
     sessionId: string;
     messageId?: string | null;
@@ -82,7 +123,7 @@ interface OperationRecord {
     timestamp: Date;
 }
 /** 回收站记录 */
-interface TrashRecord {
+export interface TrashRecord {
     id: string;
     sessionId: string;
     originalPath: string;
@@ -91,7 +132,7 @@ interface TrashRecord {
     autoDeleteAt: Date;
 }
 /** Skill 记录（system prompt 片段，支持本地或云端管理） */
-interface SkillRecord {
+export interface SkillRecord {
     id: string;
     name: string;
     description: string;
@@ -99,11 +140,13 @@ interface SkillRecord {
     icon: string;
     enabled: boolean;
     builtIn: boolean;
+    extensionId?: string;
+    extensionName?: string;
     createdAt: Date;
     updatedAt: Date;
 }
 /** 文件信息 */
-interface FileInfo {
+export interface FileInfo {
     name: string;
     path: string;
     isDirectory: boolean;
@@ -111,32 +154,273 @@ interface FileInfo {
     modifiedAt: Date;
     extension: string;
 }
+export type AtContextKind = 'file' | 'doc' | 'terminal' | 'chat';
+interface AtContextItemBase {
+    kind: AtContextKind;
+    id: string;
+    label: string;
+    mention: string;
+    description?: string;
+}
+export interface AtFileContextItem extends AtContextItemBase {
+    kind: 'file';
+    path: string;
+}
+export interface AtDocumentContextItem extends AtContextItemBase {
+    kind: 'doc';
+    documentId: string;
+    source: string;
+    snippet?: string;
+    score?: number;
+    matchType?: 'exact' | 'semantic' | 'fulltext' | 'hybrid';
+}
+export interface AtTerminalContextItem extends AtContextItemBase {
+    kind: 'terminal';
+    sessionId: string;
+    cwd: string;
+    status: string;
+    updatedAt: string;
+}
+export interface AtChatContextItem extends AtContextItemBase {
+    kind: 'chat';
+    sessionId: string;
+    updatedAt: number;
+    preview?: string;
+    matchedMessageId?: string;
+}
+export type AtContextItem = AtFileContextItem | AtDocumentContextItem | AtTerminalContextItem | AtChatContextItem;
+export type AtResourceKind = AtContextKind | 'directory';
+export interface AtResourceLocator {
+    path?: string;
+    documentId?: string;
+    sessionId?: string;
+    cwd?: string;
+    messageId?: string;
+}
+export interface AtResourcePreview {
+    text?: string;
+    score?: number;
+    matchType?: 'exact' | 'semantic' | 'fulltext' | 'hybrid';
+    updatedAt?: string | number;
+    status?: string;
+}
+export interface AtResourceContent {
+    kind: 'full' | 'summary' | 'structure';
+    text: string;
+    truncated?: boolean;
+    /**
+     * 该正文在使用 TokenCounter 计数下的 token 数。
+     * 由 chat-utils 在应用 token budget 后写入，下游可据此做二次裁剪或调试展示。
+     */
+    tokens?: number;
+}
+export interface AtResourceRecommendedTool {
+    alias: string;
+    displayName?: string;
+    purpose: string;
+    /** 该工具是否能继续读到资源更多正文 / 结构化内容（元信息 / 查找类为 false） */
+    canReadMore: boolean;
+}
+/**
+ * 文件格式能力契约 —— 整个 @ 文件链路的单一类型真相源。
+ *
+ * 同一套枚举同时被：
+ *   - superx/src/shared/fileTypeCatalog.ts（在宿主侧填充具体格式表并派生默认策略）
+ *   - ai-chat-shared/src/at-context-tools.ts（在前端侧按能力推荐工具）
+ * 共同使用，严禁在任何一侧再次重复声明，避免双写漂移。
+ *
+ * DocumentType 语义：
+ * - code/config/style/web/text/data   → 原文按行读（super_filesystem__read）
+ * - word/pdf/excel/powerpoint/notebook → 已解析文档统一读取（super_filesystem__read）
+ * - ebook/opendocument                → 同上
+ * - unknown                           → 只推按名搜索，不推读取
+ */
+export type DocumentType = 'code' | 'config' | 'style' | 'web' | 'text' | 'data' | 'word' | 'pdf' | 'excel' | 'powerpoint' | 'notebook' | 'ebook' | 'opendocument' | 'unknown';
+export type ReadStrategy = 'line-range' | 'section' | 'page' | 'sheet-range' | 'slide' | 'cell' | 'symbol' | 'none';
+export type SearchStrategy = 'grep' | 'document-index' | 'code-index' | 'none';
+export type EditStrategy = 'text' | 'structured-code' | 'readonly' | 'none';
+export interface AtResolvedFileContext {
+    title?: string;
+    content: string | null;
+    /** 文件格式分类，由宿主通过 fileTypeCatalog 解析得出 */
+    docType?: DocumentType;
+    /** 文件读取坐标能力：行 / 页 / cell / symbol 等 */
+    readStrategy?: ReadStrategy;
+    /** 文件内容搜索能力：grep / 文档索引 / 代码索引 */
+    searchStrategy?: SearchStrategy;
+    /** 文件编辑能力：文本替换 / 结构化代码 / 只读 */
+    editStrategy?: EditStrategy;
+    metadata?: Record<string, unknown>;
+}
+export interface AtResourceAccess {
+    /** 推荐工具里是否至少有一个能继续读到资源更多正文 / 结构化内容 */
+    canReadMore: boolean;
+    /**
+     * 资源正文当前是否还有"直读 / 直搜"通道可用。
+     * - file 资源：由 fileTypeCatalog 的 parser/readStrategy/searchStrategy 直接决定
+     *   （unsupported 或 read=none + search=none 时为 false）
+     * - directory / doc / terminal / chat 等非文件资源：恒为 true
+     * 下游渲染层直接读此字段即可，无需再反推 metadata 字符串。
+     */
+    directReadable: boolean;
+    recommendedTools: AtResourceRecommendedTool[];
+    /**
+     * 最终分配给该资源的 token 预算（预览 + 正文 + 元信息提示合计上限）。
+     * 由 chat-utils 在装配 prompt 时按全局 budget 分配得出；未开启 token budget 时为 undefined。
+     */
+    allocatedTokens?: number;
+}
+export interface AtResourceDescriptor {
+    kind: AtResourceKind;
+    mention: string;
+    title: string;
+    locator: AtResourceLocator;
+    preview?: AtResourcePreview;
+    content?: AtResourceContent;
+    access: AtResourceAccess;
+    metadata?: Record<string, unknown>;
+}
 /** 工具信息 */
-interface ToolInfo {
+export interface ToolInfo {
+    name: string;
+    description: string;
+    displayName: string;
+    assetId: string;
+    source: AssetSource;
+    category: string;
+    parameters?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    errorSchema?: Record<string, unknown>;
+    approvalPolicy?: AssetApprovalPolicy;
+    sideEffectLevel?: AssetSideEffectLevel;
+    hostDependency?: AssetHostDependency;
+}
+export type ChatCapabilityGroupSource = AssetSource;
+export interface ChatCapabilitySkillItem {
+    id: string;
     name: string;
     description: string;
+    source: AssetSource;
+    extensionId: string;
+    extensionName: string;
+    chatEnabled: boolean;
+}
+export interface ChatCapabilityToolItem {
+    alias: string;
+    displayName: string;
+    description: string;
+    source: AssetSource;
+    category: string;
+    extensionId: string;
+    extensionName: string;
+    runtimeInjected: boolean;
+    runtimeAvailable: boolean;
+    chatEnabled: boolean;
+    approvalPolicy?: AssetApprovalPolicy;
+    sideEffectLevel?: AssetSideEffectLevel;
+    hostDependency?: AssetHostDependency;
+}
+export interface ChatCapabilityMcpToolItem {
+    alias: string;
+    displayName: string;
+    description: string;
+    source: AssetSource;
+    extensionId: string;
+    extensionName: string;
+    runtimeInjected: boolean;
+    runtimeAvailable: boolean;
+    chatEnabled: boolean;
+}
+export interface ChatCapabilityMcpServerItem {
+    id: string;
+    name: string;
+    source: AssetSource;
+    extensionId: string;
+    extensionName: string;
+    runtimeInjected: boolean;
+    runtimeAvailable: boolean;
+    connectionStatus: McpConnectionStatus;
+    error?: string;
+    tools: ChatCapabilityMcpToolItem[];
+}
+export interface ChatCapabilityExtensionGroup {
+    id: string;
+    name: string;
+    source: ChatCapabilityGroupSource;
+    extensionEnabled: boolean;
+    /**
+     * Total capabilities owned by the extension, including items hidden while the
+     * extension is disabled. Renderers should use this for extension-level counts.
+     */
+    availableCount?: number;
+    skills: ChatCapabilitySkillItem[];
+    tools: ChatCapabilityToolItem[];
+    mcpServers: ChatCapabilityMcpServerItem[];
+}
+export interface ChatCapabilitySnapshot {
+    extensions: ChatCapabilityExtensionGroup[];
+}
+export interface AgentCapabilityManifestTool {
+    alias: string;
+    displayName: string;
+    description: string;
+    kind: 'tool' | 'mcp-tool';
+}
+export interface AgentCapabilityManifestSkill {
+    id: string;
+    name: string;
+    description: string;
+}
+export interface AgentCapabilityManifestExtension {
+    id: string;
+    name: string;
+    source: string;
+    skills: AgentCapabilityManifestSkill[];
+    tools: AgentCapabilityManifestTool[];
+}
+export interface AgentCapabilityManifest {
+    version: '1';
+    extensions: AgentCapabilityManifestExtension[];
+}
+export interface ChatCapabilitySelection {
+    toolOverrides: Record<string, boolean>;
+    mcpToolOverrides: Record<string, boolean>;
+}
+export interface SkillEnabledItem {
+    id: string;
+    enabled: boolean;
+}
+export interface ChatCapabilityToolEnabledItem {
+    alias: string;
+    enabled: boolean;
+}
+export interface ChatCapabilityToolEnabledResult extends ChatCapabilityToolEnabledItem {
+    kind?: 'tool' | 'mcp';
+    error?: string;
 }
 /** 工具批准请求 */
-interface ToolApprovalRequest {
+export interface ToolApprovalRequest {
     id: string;
     name: string;
     args: Record<string, unknown>;
 }
 /** 工具执行结果（executeTool 返回值） */
-interface ToolExecutionResult {
+export interface ToolExecutionResult {
     success: boolean;
     result: string;
     error?: string;
     /** 工具 UI 声明（成功时） */
-    ui?: {
-        type: 'render' | 'action';
-        name: string;
-        props?: Record<string, unknown>;
-    };
-    toolError?: _huyooo_ai_chat_core_events.ToolErrorShape;
+    ui?: ToolUI;
+    approvalPolicy?: AssetApprovalPolicy;
+    sideEffectLevel?: AssetSideEffectLevel;
+    hostDependency?: AssetHostDependency;
+    riskSummary?: string;
+    riskTags?: string[];
+    riskSignals?: string[];
+    toolError?: import('@huyooo/ai-chat-core/events').ToolError;
 }
 /** ASR 会话配置 */
-interface AsrSessionConfig {
+export interface AsrSessionConfig {
     /** 音频格式 */
     format?: 'pcm' | 'wav';
     /** 采样率 */
@@ -151,7 +435,7 @@ interface AsrSessionConfig {
     showUtterances?: boolean;
 }
 /** ASR 识别结果 */
-interface AsrResultData {
+export interface AsrResultData {
     result?: {
         text: string;
         utterances?: Array<{
@@ -165,14 +449,13 @@ interface AsrResultData {
         duration: number;
     };
 }
-
+import type { ChatEvent, ModelOption } from '@huyooo/ai-chat-core';
 /**
  * ChatAdapter 接口
  *
  * 统一的聊天适配器接口，支持多种实现：
- * - Electron IPC（ai-chat-bridge-electron）
+ * - Electron IPC（ai-chat-bridge-electron/renderer）
  * - HTTP/SSE（ai-chat-adapter-http）
- * - 直连（ai-chat-adapter-direct，CLI 用）
  *
  * 行为统一保证：无论使用哪种实现（本地直连 / HTTP / 混合），对调用方接口一致——
  * getModels()、sendMessage()、getSessions() 等语义相同，sendMessage 产出的事件均为
@@ -180,17 +463,43 @@ interface AsrResultData {
  * 不因适配器或模型而异。core 层通过契约测试（CHAT_EVENT_TYPES）保证 Orchestrator
  * 产出合法事件。
  */
-interface ChatAdapter {
+export interface ChatAdapter {
     /** 获取可用模型 */
     getModels(): Promise<ModelOption[]>;
-    /** 获取所有工具列表（用于设置面板） */
+    /** 获取所有工具列表（用于工具设置或管理视图） */
     getAllTools?(): Promise<ToolInfo[]>;
+    /** 获取聊天能力快照（扩展 -> 能力分类 -> 能力项） */
+    getChatCapabilitySnapshot?(): Promise<ChatCapabilitySnapshot>;
+    /** 监听聊天能力更新 */
+    onChatCapabilityUpdate?(callback: () => void): () => void;
     /** 发送消息，返回异步迭代器 */
     sendMessage(message: string, options?: ChatOptions, images?: string[], sessionId?: string): AsyncIterable<ChatEvent>;
     /** 取消当前请求 */
     cancel(): void;
     /** 设置当前工作目录 */
     setCwd?(dir: string): void;
+    /** 搜索可引用的文档上下文 */
+    searchAtDocuments?(query: string, options?: {
+        limit?: number;
+    }): Promise<AtDocumentContextItem[]>;
+    /** 列出可引用的终端会话 */
+    listAtTerminals?(options?: {
+        query?: string;
+        limit?: number;
+        workspaceRoot?: string;
+    }): Promise<AtTerminalContextItem[]>;
+    /** 搜索可引用的历史对话 */
+    searchAtChats?(query: string, options?: {
+        limit?: number;
+    }): Promise<AtChatContextItem[]>;
+    /** 读取可引用的文档上下文内容 */
+    readAtDocumentContext?(documentId: string): Promise<string | null>;
+    /** 读取可引用的终端上下文内容 */
+    readAtTerminalContext?(sessionId: string): Promise<string | null>;
+    /** 读取可引用的历史对话上下文内容 */
+    readAtChatContext?(sessionId: string): Promise<string | null>;
+    /** 解析 @ 文件上下文（供宿主接入高级文件解析器） */
+    resolveAtFileContext?(filePath: string): Promise<AtResolvedFileContext | null>;
     /** 获取会话列表 */
     getSessions(): Promise<SessionRecord[]>;
     /** 获取单个会话 */
@@ -203,6 +512,8 @@ interface ChatAdapter {
     deleteSession(id: string): Promise<void>;
     /** 获取会话消息 */
     getMessages(sessionId: string): Promise<MessageRecord[]>;
+    /** 分页获取会话消息（优先返回最近消息，按 sequence 升序返回当前页） */
+    getMessagesPage?(sessionId: string, params?: GetMessagesPageParams): Promise<MessagePage>;
     /** 保存消息 */
     saveMessage(params: SaveMessageParams): Promise<MessageRecord>;
     /** 更新消息（增量保存） */
@@ -272,28 +583,28 @@ interface ChatAdapter {
         stage: string;
         error?: string;
     }) => void): () => void;
-    /** 获取 Skills 列表 */
-    getSkills?(): Promise<SkillRecord[]>;
-    /** 创建 Skill */
-    createSkill?(data: {
-        name: string;
-        description?: string;
-        content: string;
-        icon?: string;
-    }): Promise<SkillRecord>;
-    /** 更新 Skill */
-    updateSkill?(id: string, data: {
-        name?: string;
-        description?: string;
-        content?: string;
-        icon?: string;
-        enabled?: boolean;
-    }): Promise<void>;
-    /** 删除 Skill */
-    deleteSkill?(id: string): Promise<void>;
-    /** 切换 Skill 启用状态 */
-    toggleSkill?(id: string): Promise<{
+    /** 批量设置 Skill 的聊天启用状态（聊天侧仅保留此能力） */
+    setSkillsChatEnabled?(items: SkillEnabledItem[]): Promise<Array<SkillEnabledItem & {
+        error?: string;
+    }>>;
+    /** 批量设置普通 Tool 的聊天启用状态（不改变扩展运行时启停） */
+    setToolsChatEnabled?(items: ChatCapabilityToolEnabledItem[]): Promise<ChatCapabilityToolEnabledResult[]>;
+    /** 批量设置 MCP Tool 的聊天启用状态（不改变扩展运行时启停） */
+    setMcpToolsChatEnabled?(items: ChatCapabilityToolEnabledItem[]): Promise<ChatCapabilityToolEnabledResult[]>;
+    /**
+     * 设置扩展的整体启停状态（Layer 1：影响 ChatRuntime 的 sessionTools）。
+     * 对比 setSkillsChatEnabled / setToolsChatEnabled，这里是"容器级"开关：
+     * 禁用扩展会让其所有 tool/skill/mcp 从会话工具集里卸下，直接减少 token 占用。
+     */
+    setExtensionEnabled?(payload: {
+        id: string;
         enabled: boolean;
+        source: AssetSource;
+    }): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
     }>;
     onToolApprovalRequest?(callback: (request: ToolApprovalRequest) => void): () => void;
     respondToolApproval?(id: string, approved: boolean): Promise<void>;
@@ -333,7 +644,7 @@ interface ChatAdapter {
     openExternal?(url: string): Promise<void>;
 }
 /** 创建会话参数 */
-interface CreateSessionParams {
+export interface CreateSessionParams {
     title?: string;
     model?: string;
     mode?: string;
@@ -342,7 +653,7 @@ interface CreateSessionParams {
     hidden?: boolean;
 }
 /** 更新会话参数 */
-interface UpdateSessionParams {
+export interface UpdateSessionParams {
     title?: string;
     model?: string;
     mode?: string;
@@ -351,32 +662,47 @@ interface UpdateSessionParams {
     hidden?: boolean;
 }
 /** 保存消息参数 */
-interface SaveMessageParams {
+export interface SaveMessageParams {
     id?: string;
     sessionId: string;
-    role: 'user' | 'assistant';
+    role: 'user' | 'assistant' | 'system';
     content: string;
+    atContextItems?: AtContextItem[];
     images?: string[];
     model?: string;
     mode?: string;
     webSearchEnabled?: boolean;
     thinkingEnabled?: boolean;
-    steps?: string;
+    parts?: MessagePartInput[];
     operationIds?: string;
+    finishReason?: FinishReason;
 }
 /** 更新消息参数 */
-interface UpdateMessageParams {
+export interface UpdateMessageParams {
     id: string;
     content?: string;
-    steps?: string;
+    atContextItems?: AtContextItem[] | null;
+    parts?: MessagePartInput[];
     operationIds?: string;
     /** Token 使用统计（JSON 字符串） */
     usage?: string;
     /** 响应耗时（毫秒） */
     duration?: number;
+    /** 结束原因（done 事件携带） */
+    finishReason?: FinishReason;
+}
+export interface MessagePartRecord {
+    messageId: string;
+    sequence: number;
+    type: string;
+    payload: string;
+}
+export interface MessagePartInput {
+    type: string;
+    payload: string;
 }
 /** 发送消息参数 */
-interface SendMessageParams {
+export interface SendMessageParams {
     message: string;
     images?: string[];
     sessionId?: string;
@@ -390,5 +716,5 @@ interface SendMessageParams {
         history?: ChatHistoryMessage[];
     };
 }
-
-export type { AsrResultData, AsrSessionConfig, ChatAdapter, ChatHistoryMessage, ChatMode, ChatOptions, CreateSessionParams, FileInfo, MessageRecord, OperationRecord, SaveMessageParams, SendMessageParams, SessionRecord, SkillRecord, ToolApprovalRequest, ToolExecutionResult, ToolInfo, TrashRecord, UpdateMessageParams, UpdateSessionParams };
+export { buildToolGovernanceLabels, type FrontendChatEvent, type ToolGovernanceInfo, extractToolGovernance, mergeToolGovernance, shouldSaveEvent, } from './chat-utils';
+//# sourceMappingURL=index.d.ts.map