keepwork-sdk 1.0.0

package/dist-npm/types/src/ai-chat/AIChat.session.d.ts

@@ -0,0 +1,201 @@
+/**
+ * AIChat.session.ts — ChatSession 类
+ *
+ * 包含：
+ * - ChatSession 构造函数（历史/sandbox/子 session/AgentRouter 注册）
+ * - send()（含子 agent 结果注入、模板展开、图片压缩/上传、历史持久化）
+ * - 消息管理（addUserMessage / addAssistantMessage / clear / getHistory）
+ * - 消息修剪（_evictMessages / _evictExcessImages）
+ * - 工作空间管理（setWorkspace / setMountFolder）
+ * - AgentRouter 集成（executeTool / unregisterAgent）
+ * - restartAgent（配置文件加载 + 状态重置）
+ *
+ * 该文件导出 `ChatSession` 类，并在模块求值时将其挂载到 AIChat.prototype.createSession。
+ */
+import AIChat, { type ChatMessage } from './AIChat.core';
+import { type ChildSessionHost } from './ChildSessionMixin';
+import SandboxToolEnv from './SandboxToolEnv';
+/** ChatSession 构造选项 */
+export interface ChatSessionOptions {
+    chatId?: string;
+    modId?: string;
+    persistedId?: string;
+    skipHistory?: boolean;
+    model?: string;
+    apiCacheKey?: string | null;
+    historyLength?: number;
+    systemPrompt?: string;
+    system_prompt?: string;
+    workspace?: string | null;
+    mountFolder?: unknown;
+    enabledCategories?: string[];
+    toolProxy?: unknown;
+    name?: string;
+    parentSession?: unknown;
+    onChildStream?: ((event: unknown) => void) | null;
+    backgroundAgent?: boolean;
+    _depth?: number;
+    _maxDepth?: number;
+    [key: string]: unknown;
+}
+/** 默认设置（restartAgent 回退用） */
+interface DefaultSettings {
+    model: string;
+    historyLength: number;
+    workspace: string | null;
+    mountFolder: unknown;
+    systemPrompt: string | null;
+    enabledCategories: string[];
+}
+/**
+ * ChatSession — 单个 AI 对话会话。
+ *
+ * 管理：
+ * - 对话消息历史（messages 数组）
+ * - 工具执行 sandbox（SandboxToolEnv）
+ * - 子 agent 任务队列（via ChildSessionMixin）
+ * - 历史持久化（upsertChatHistory / updateChatHistory）
+ * - AgentRouter 注册（命名顶层 session 自动注册）
+ * - agent 重启（restartAgent + AgentConfig 配置文件加载）
+ */
+declare class ChatSession implements ChildSessionHost {
+    aiChat: any;
+    messages: any[];
+    chatId: string;
+    modId: string | null;
+    skipHistory: boolean;
+    historyId?: string;
+    historyRows: unknown[] | null;
+    model: string;
+    apiCacheKey: string | null;
+    historyLength: number;
+    options: ChatSessionOptions;
+    sandbox: SandboxToolEnv;
+    _workspaceExplicitlySet: boolean;
+    workspace: string | null;
+    mountFolder: unknown;
+    _pendingContexts: string[];
+    _restartedWithPromptFile: boolean;
+    _savedMessages?: ChatMessage[] | null;
+    _restartSignal?: unknown;
+    _registeredAsAgent: boolean;
+    _defaultSettings: DefaultSettings;
+    name: string | null;
+    parentSession: ChildSessionHost | null;
+    _childSessions: Record<string, import('./ChildSessionMixin').ChildSessionEntry>;
+    _pendingChildResults: import('./ChildSessionMixin').PendingChildResult[];
+    _debounceTimers: ReturnType<typeof setTimeout>[];
+    _isSending: boolean;
+    _lastSendOptions: Record<string, unknown>;
+    _maxChildSessions: number;
+    _depth: number;
+    _maxDepth: number;
+    onChildStream: ((event: import('./ChildSessionMixin').ChildStreamEvent) => void) | null;
+    constructor(aiChat: AIChat, options?: ChatSessionOptions);
+    /** sdk 访问器（指向 aiChat.sdk） */
+    get sdk(): unknown;
+    /**
+     * 入队后台上下文（将在下一次 send() 时注入到用户消息前）。
+     * 多次调用会累积；下次 send() 时统一冲刷。
+     * @param text - 要注入的上下文文本
+     */
+    sendContext(text: string): void;
+    /**
+     * 取消注册 AgentRouter 中的 agent 名称。
+     * 当此 session 不再处理该 agent 任务时调用。
+     */
+    unregisterAgent(): void;
+    /**
+     * 直接通过 sandbox 执行工具（AgentRouter.toolCallOnly 路径使用）。
+     */
+    executeTool(fnName: string, fnArgs: unknown): Promise<unknown>;
+    /**
+     * 设置文件操作工作空间。
+     * 同步更新 `this.workspace` 和 `this.sandbox.workspace`。
+     * @param wsName - 工作空间名，null/'' 表示清除
+     */
+    setWorkspace(wsName: string | null): void;
+    /**
+     * 设置只读回退层的 mountFolder 配置。
+     * @param mountFolderConfig - 挂载文件夹路径/对象，或 null 清除
+     */
+    setMountFolder(mountFolderConfig: unknown): void;
+    /** 设置 API 缓存 Key（传递给 aiGenerators.chat）。 */
+    setAPICacheKey(key: string): void;
+    /**
+     * 向会话历史追加用户消息（自动冲刷 _pendingContexts 并注入到消息前）。
+     * @param content - 消息内容（字符串或多模态数组）
+     */
+    addUserMessage(content: unknown): ChatMessage;
+    /**
+     * 冲刷并返回所有待注入的上下文（包裹在 context_begin…context_end 块中）。
+     * 若无待处理上下文则返回空字符串。
+     * @private
+     */
+    _flushPendingContexts(): string;
+    /**
+     * 向会话历史追加助手消息。
+     * @param content    - 助手文本内容
+     * @param gptChatId  - 可选的 GPT Chat ID（用于历史关联）
+     */
+    addAssistantMessage(content: string | null | unknown, gptChatId?: string): void;
+    /**
+     * 发送消息并更新会话历史（主发送入口）。
+     *
+     * 处理流程：
+     * 1. 取消 debounce 定时器
+     * 2. 若 runCode=true，通过 sandbox.processTemplate 展开 ${...} 表达式
+     * 3. 注入待处理的子 agent 结果（tool call 形式）
+     * 4. 冲刷 _pendingContexts
+     * 5. 压缩 / 上传内联 base64 图片
+     * 6. 添加用户消息，修剪历史
+     * 7. 调用 aiChat.chat()
+     * 8. 追加助手消息，持久化历史
+     *
+     * @param userMessage - 用户消息（字符串、多模态数组，或 null 仅消费子 agent 结果）
+     * @param options     - 发送选项（model / tools / enableTools / 流式回调等）
+     */
+    send(userMessage: unknown, options?: any): Promise<unknown>;
+    /**
+     * 将多模态 content 数组中的内联 base64 图片上传到临时 CDN，
+     * 并将 data-URI 替换为远程 URL。
+     * @private
+     */
+    _uploadInlineImages(contentArray: import('../utils/ImageUtils').ContentItem[]): Promise<import('../utils/ImageUtils').ContentItem[]>;
+    /**
+     * 按 historyLength 修剪旧消息轮次。
+     * 保留所有前置 system 消息 + 最后 `historyLength` 轮对话。
+     * @private
+     */
+    _evictMessages(): void;
+    /**
+     * 从历史中移除超出 maxCount 限制的旧图片，
+     * 将被移除的 image_url 替换为 `(user_image)` 文本占位符。
+     * @private
+     */
+    _evictExcessImages(maxCount: number): void;
+    /** 清空对话历史（仅清空 messages 数组）。 */
+    clear(): void;
+    /** 获取当前对话历史的副本。 */
+    getHistory(): ChatMessage[];
+    /**
+     * 重启 agent 会话（可选加载配置文件）。
+     *
+     * 行为：
+     * - 无 promptFile：恢复所有设置到构造时的默认值
+     * - 纯 Markdown（只有 system_prompt）：仅更换系统提示，其他设置保持默认
+     * - 完整配置：临时覆盖设置；下次无 promptFile 的重启会恢复全部默认值
+     *
+     * @param promptFile - 配置文件 URL 或路径（.json / .yml / .yaml / .md）
+     * @param tools      - 可选工具分类覆盖（空表示继承默认值）
+     * @param _options   - 高级选项（预留）
+     * @returns `{ configSource }`
+     */
+    restartAgent(promptFile?: string, tools?: string[], _options?: unknown): Promise<{
+        configSource: string;
+    }>;
+    _triggerImmediateCallback(): Promise<void>;
+}
+export { ChatSession };
+export default ChatSession;
+//# sourceMappingURL=AIChat.session.d.ts.map

package/dist-npm/types/src/ai-chat/AIChat.session.d.ts.map

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

package/dist-npm/types/src/ai-chat/AIGenerators.base.d.ts

@@ -0,0 +1,297 @@
+/**
+ * AIGenerators.base.ts — AI 生成器公共工具 + 聊天路由层
+ *
+ * 包含：
+ * - 构造函数与基础工具（getModels / getAllModels / _getToken / _authHeaders 等）
+ * - 请求头规范化（_normalizeHeaders）
+ * - 模型/provider 解析（_resolveLocalModelSettings / _detectProvider / _shouldPreferDirect）
+ * - 直连路由决策（shouldRouteDirect）
+ * - 聊天核心路由（chat / chatViaProxy / chatCompletion）
+ * - 直连底层方法（callLLM / _callOpenAILLM / _callOpenRouterLLM / _callGoogleLLM）
+ * - SSE 读取（_readSSETextResponse / _readSSEImageResponse / _readChatCompletionSSE / _readKeepworkProxySSE）
+ * - 消息格式化工具（_normalizeMessages / _normalizeOpenAIChatMessages / _messagesToGeminiContents 等）
+ * - Reasoning 处理（_normalizeReasoningOption / _buildReasoningBodyField 等）
+ */
+export declare const DEFAULT_CHAT_MODEL = "keepwork-flash";
+export declare const DEFAULT_IMAGE_MODEL = "keepwork-image";
+export declare const DEFAULT_VIDEO_MODEL = "keepwork-video";
+/** 聊天消息（OpenAI 格式） */
+export interface GenMessage {
+    role: string;
+    content: unknown;
+    tool_calls?: GenToolCall[];
+    tool_call_id?: string;
+    [key: string]: unknown;
+}
+/** 工具调用 */
+export interface GenToolCall {
+    id?: string;
+    type?: string;
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+    index?: number;
+}
+/** SDK 最小接口 */
+export interface AIGeneratorsSDKRef {
+    baseURL?: string;
+    token?: string | null;
+    userApiKey?: string | null;
+    localAPIKeySettings?: {
+        resolveModelSettings: (model: string, opts?: unknown) => {
+            model?: string;
+            apiKey?: string;
+            provider?: string;
+            preferDirect?: boolean;
+        };
+        detectProvider?: (model: string) => string | null;
+        getProviderApiKey?: (provider: string) => string | null;
+    };
+    get?: (url: string) => Promise<unknown>;
+    cloudDrive?: {
+        uploadTempFile: (file: File, opts?: {
+            filename?: string;
+            expire?: number;
+        }) => Promise<{
+            url?: string;
+        }>;
+    };
+    [key: string]: unknown;
+}
+/** 本地模型设置 */
+export interface LocalModelSettings {
+    model?: string;
+    apiKey?: string;
+    provider?: string;
+    preferDirect?: boolean;
+}
+/** 聊天选项 */
+export interface GenChatOptions {
+    messages?: GenMessage[];
+    prompt?: string;
+    model?: string;
+    tools?: unknown[];
+    stream?: boolean;
+    temperature?: number;
+    responseFormat?: string | {
+        type: string;
+    };
+    reasoning?: boolean | object;
+    knowledgeBaseCodes?: string[];
+    apiCacheKey?: string | null;
+    abortController?: AbortController;
+    extraHeaders?: Record<string, string>;
+    localModelSettings?: LocalModelSettings;
+    directProvider?: string;
+    apiKey?: string;
+    preferDirect?: boolean;
+    directOnly?: boolean;
+    returnRaw?: boolean;
+    extraBody?: Record<string, unknown>;
+    modalities?: string[];
+    outputModalities?: string[];
+    output_modalities?: string[];
+    images?: Array<{
+        url?: string;
+        image_url?: {
+            url: string;
+        };
+        role?: string;
+    }>;
+    onMessage?: (fullText: string, delta?: unknown, raw?: unknown, meta?: unknown) => void;
+    onReasoning?: (fullReasoning: string, delta?: string, raw?: unknown) => void;
+    onToolCall?: (toolCall: GenToolCall) => void;
+    onComplete?: (result: unknown, fullResponse?: unknown) => void;
+    onError?: (error: Error) => void;
+    onImage?: (url: string, raw?: unknown, meta?: unknown) => void;
+    [key: string]: unknown;
+}
+/** shouldRouteDirect 返回值 */
+export interface RouteDirectDecision {
+    route: boolean;
+    provider?: string;
+    apiKey?: string;
+}
+/**
+ * AIGeneratorsBase — AI 生成器公共工具 + 聊天路由基类。
+ * 由 AIGenerators.media.ts 继承以添加 genImage / genVideo 等媒体生成方法。
+ */
+export declare class AIGeneratorsBase {
+    sdk: AIGeneratorsSDKRef;
+    /** 全量模型列表缓存（getAllModels 使用） */
+    _allModelsCache?: unknown[];
+    constructor(sdk: AIGeneratorsSDKRef);
+    /** Keepwork gpt API 基础 URL */
+    get _apiBase(): string;
+    /**
+     * 获取预设的常用模型列表。
+     * @param type - 'chat' | 'image' | 'video'
+     */
+    getModels(type?: 'chat' | 'image' | 'video'): string[];
+    /**
+     * 从 Keepwork 获取完整模型列表（内存缓存）。
+     * @param opts.forceRefresh - 是否绕过缓存（默认 false）
+     */
+    getAllModels(opts?: {
+        forceRefresh?: boolean;
+    }): Promise<unknown[]>;
+    /** 获取认证 token（sdk.token → localStorage 回退）。 */
+    _getToken(): string | null;
+    /**
+     * 规范化请求头对象（过滤 null/undefined，拒绝含非 Latin-1 字符的 value）。
+     * 用于防止 fetch API 因非法头值崩溃。
+     */
+    _normalizeHeaders(headers?: Record<string, unknown>, context?: string): Record<string, string>;
+    /**
+     * 构建 Keepwork API 鉴权请求头（含 Authorization / user-api-key）。
+     * @param extra - 额外请求头
+     */
+    _authHeaders(extra?: Record<string, string>): Record<string, string>;
+    /**
+     * 解析模型的本地配置（model / apiKey / provider / preferDirect）。
+     * 若 SDK 无 localAPIKeySettings 则直接返回 `{ model }`。
+     */
+    _resolveLocalModelSettings(model?: string, provider?: string): LocalModelSettings;
+    /** 判断是否应优先使用直连路由。 */
+    _shouldPreferDirect(localModelSettings: LocalModelSettings, opts?: GenChatOptions): boolean;
+    /** 解析直连 provider 名称（caller > localModelSettings > 自动检测）。 */
+    _directProvider(localModelSettings: LocalModelSettings, opts?: GenChatOptions): string | null;
+    /**
+     * 决定 chat 请求是否应绕过 Keepwork proxy 直连 provider。
+     *
+     * 规则：
+     * - strict（无 key 则抛出）：directOnly=true 或 preferDirect=true 或 明确指定 apiKey+directProvider
+     * - lenient（无 key 则回退代理）：localModelSettings.preferDirect=true
+     *
+     * @throws 严格模式下无 API key 时抛出
+     */
+    shouldRouteDirect(options?: GenChatOptions, localModelSettings?: LocalModelSettings | null): RouteDirectDecision;
+    /**
+     * 根据 model 名称自动检测 provider（OpenRouter / Doubao / Qwen / Claude / Gemini / OpenAI）。
+     * 返回 null 表示无法识别（使用 Keepwork proxy）。
+     */
+    _detectProvider(model: string): string | null;
+    /** 将 messages + prompt 规范化为消息数组（至少需要其中一个）。 */
+    _normalizeMessages(messages?: GenMessage[], prompt?: string): GenMessage[];
+    /** 将消息数组规范化为 OpenAI Chat Completions 格式（含 tool_calls / tool 消息处理）。 */
+    _normalizeOpenAIChatMessages(messages: GenMessage[], prompt?: string): GenMessage[];
+    /** 将 OpenAI 格式消息转换为 Gemini contents 格式。 */
+    _messagesToGeminiContents(messages: GenMessage[]): Array<{
+        role: string;
+        parts: unknown[];
+    }>;
+    /** 将消息 content 转换为 Gemini parts 格式（支持文本/图片/视频）。 */
+    _contentToGeminiParts(content: unknown): unknown[];
+    /** 将 URL 转换为 Gemini file_data 或 inline_data part。 */
+    _urlToGeminiFilePart(url: string, fallbackMimeType: string, videoMetadata?: unknown): unknown;
+    _extractOpenAIText(data: Record<string, unknown>): string;
+    _extractGeminiText(data: Record<string, unknown>): string;
+    _extractReasoningText(data: Record<string, unknown>): string;
+    _shouldDisableReasoning(model: string): boolean;
+    _requiresReasoning(model: string): boolean;
+    _normalizeReasoningOption(model: string, reasoning: unknown): unknown;
+    _buildReasoningBodyField(provider: string, reasoning: unknown): {
+        key: string;
+        value: unknown;
+    } | null;
+    _keepworkChatHeaders(extra?: Record<string, string>): Record<string, string>;
+    /**
+     * 统一聊天入口：自动判断直连或 proxy 路由。
+     * 两种传输路径都发出相同的回调格式（onMessage / onToolCall / onComplete / onError）。
+     */
+    chat(options?: GenChatOptions): Promise<unknown>;
+    /**
+     * 通过 Keepwork `/gpt/chat` proxy 发送聊天请求。
+     * 支持流式和非流式两种模式，统一发出 AIChat 兼容的回调。
+     */
+    chatViaProxy(options?: GenChatOptions): Promise<unknown>;
+    /** @private 解析 Keepwork proxy SSE 流，返回累积文本。 */
+    _readKeepworkProxySSE(response: Response, { onMessage, onReasoning, onToolCall, onComplete }?: {
+        onMessage?: GenChatOptions['onMessage'];
+        onReasoning?: GenChatOptions['onReasoning'];
+        onToolCall?: GenChatOptions['onToolCall'];
+        onComplete?: GenChatOptions['onComplete'];
+    }): Promise<string>;
+    /**
+     * 直接调用 OpenAI/OpenRouter 等 provider（支持 tool-calls、streaming）。
+     * 在绕过 Keepwork proxy 时使用。
+     */
+    chatCompletion(options?: GenChatOptions): Promise<unknown>;
+    /** @private 解析 OpenAI/OpenRouter chat-completion SSE，返回累积文本。 */
+    _readChatCompletionSSE(response: Response, { onMessage, onReasoning, onToolCall, onComplete }?: {
+        onMessage?: GenChatOptions['onMessage'];
+        onReasoning?: GenChatOptions['onReasoning'];
+        onToolCall?: GenChatOptions['onToolCall'];
+        onComplete?: GenChatOptions['onComplete'];
+    }): Promise<string>;
+    callLLM(options?: GenChatOptions & {
+        returnRaw?: boolean;
+    }): Promise<unknown>;
+    _callOpenAILLM(opts: {
+        model: string;
+        apiKey: string;
+        messages: GenMessage[];
+        stream?: boolean;
+        temperature?: number;
+        responseFormat?: unknown;
+        onMessage?: GenChatOptions['onMessage'];
+        onReasoning?: GenChatOptions['onReasoning'];
+        abortController?: AbortController;
+        extraHeaders?: Record<string, string>;
+    }): Promise<{
+        text: string;
+        data?: unknown;
+    }>;
+    _callOpenRouterLLM(opts: {
+        model: string;
+        apiKey: string;
+        messages: GenMessage[];
+        stream?: boolean;
+        temperature?: number;
+        responseFormat?: unknown;
+        onMessage?: GenChatOptions['onMessage'];
+        onReasoning?: GenChatOptions['onReasoning'];
+        onImage?: GenChatOptions['onImage'];
+        abortController?: AbortController;
+        extraHeaders?: Record<string, string>;
+        extraBody?: Record<string, unknown>;
+    }): Promise<{
+        text: string;
+        imageUrl?: string;
+        data?: unknown;
+        reasoning?: string;
+    }>;
+    _callGoogleLLM(opts: {
+        model: string;
+        apiKey: string;
+        messages: GenMessage[];
+        stream?: boolean;
+        temperature?: number;
+        responseFormat?: unknown;
+        onMessage?: GenChatOptions['onMessage'];
+        onReasoning?: GenChatOptions['onReasoning'];
+        abortController?: AbortController;
+        extraHeaders?: Record<string, string>;
+    }): Promise<{
+        text: string;
+        data?: unknown;
+    }>;
+    _readSSETextResponse(resp: Response, provider: string, callbacks?: {
+        onMessage?: GenChatOptions['onMessage'];
+        onReasoning?: GenChatOptions['onReasoning'];
+    }): Promise<string>;
+    _readSSEImageResponse(resp: Response, provider: string, callbacks?: {
+        onMessage?: GenChatOptions['onMessage'];
+        onReasoning?: GenChatOptions['onReasoning'];
+        onImage?: GenChatOptions['onImage'];
+    }): Promise<{
+        text: string;
+        reasoning: string;
+        imageUrl: string;
+        data: unknown;
+    }>;
+    _extractGeneratedImageUrl(data: unknown): string | null;
+    _findFirstImageInValue(value: unknown): string | null;
+}
+//# sourceMappingURL=AIGenerators.base.d.ts.map

package/dist-npm/types/src/ai-chat/AIGenerators.base.d.ts.map

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

package/dist-npm/types/src/ai-chat/AIGenerators.d.ts

@@ -0,0 +1,15 @@
+/**
+ * AIGenerators.ts — AI 图像/视频生成模块主入口（TypeScript 版）
+ *
+ * 组合层：从 AIGenerators.media.ts 重导出完整类（包含 base + media 层）。
+ *
+ * 拆分结构：
+ * - AIGenerators.base.ts  — 公共工具 + 聊天路由（chat / callLLM / chatCompletion / SSE 读取等）
+ * - AIGenerators.media.ts — 继承 base，添加 genImage / genVideo / pollVideoTask 等媒体生成方法
+ * - AIGenerators.ts        — 本文件：组合入口 + 统一导出
+ */
+export { default } from './AIGenerators.media';
+export type { GenImageOptions, GenVideoOptions, VideoTaskStatus, PollVideoCallbacks } from './AIGenerators.media';
+export { DEFAULT_CHAT_MODEL, DEFAULT_IMAGE_MODEL, DEFAULT_VIDEO_MODEL } from './AIGenerators.base';
+export type { GenMessage, GenChatOptions, LocalModelSettings, RouteDirectDecision, AIGeneratorsSDKRef } from './AIGenerators.base';
+//# sourceMappingURL=AIGenerators.d.ts.map

package/dist-npm/types/src/ai-chat/AIGenerators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIGenerators.d.ts","sourceRoot":"","sources":["../../../../src/ai-chat/AIGenerators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAClH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACnG,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}