@downcity/agent 1.1.25 → 1.1.32

package/bin/plugin/builtins/chat/runtime/ChatSessionDelete.js

@@ -0,0 +1,76 @@
+/**
+ * ChatSessionDelete：按 sessionId 彻底删除 chat 会话数据。
+ *
+ * 关键点（中文）
+ * - 删除路由映射（`.downcity/channel/meta.json`）
+ * - 删除 chat 审计目录（`.downcity/chat/<sessionId>/`）
+ * - 删除 core session 目录（`.downcity/agents/<agentId>/sessions/<sessionId>/`）
+ * - 清理运行中 agent 与队列，避免残留任务继续执行
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { resolveChatQueueStore } from "../../../../plugin/builtins/chat/runtime/ChatQueue.js";
+import { removeChatMetaBySessionId } from "../../../../plugin/builtins/chat/runtime/ChatMetaStore.js";
+function normalizeSessionId(sessionId) {
+    return String(sessionId || "").trim();
+}
+/**
+ * 彻底删除一个 chat session。
+ *
+ * 关键点（中文）
+ * - 幂等：目标不存在时返回 success + deleted=false，避免上层重试复杂化。
+ */
+export async function deleteChatSessionById(params) {
+    const sessionId = normalizeSessionId(params.sessionId);
+    if (!sessionId) {
+        return {
+            success: false,
+            sessionId: "",
+            deleted: false,
+            removedMeta: false,
+            removedChatDir: false,
+            removedSessionDir: false,
+            error: "Missing sessionId",
+        };
+    }
+    try {
+        // 关键点（中文）：先停执行，再删文件，避免删除过程中仍有任务写入。
+        params.context.session.get(sessionId).clearExecutor();
+        resolveChatQueueStore(params.context).clear(sessionId);
+        const removedMetaResult = await removeChatMetaBySessionId({
+            context: params.context,
+            sessionId,
+        });
+        const chatDir = path.join(params.context.rootPath, ".downcity", "chat", sessionId);
+        const sessionDir = params.context.paths.getDowncitySessionDirPath(sessionId);
+        const hadChatDir = await fs.pathExists(chatDir);
+        const hadSessionDir = await fs.pathExists(sessionDir);
+        if (hadChatDir) {
+            await fs.remove(chatDir);
+        }
+        if (hadSessionDir) {
+            await fs.remove(sessionDir);
+        }
+        const deleted = removedMetaResult.removed || hadChatDir || hadSessionDir;
+        return {
+            success: true,
+            sessionId,
+            deleted,
+            removedMeta: removedMetaResult.removed,
+            removedChatDir: hadChatDir,
+            removedSessionDir: hadSessionDir,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            sessionId,
+            deleted: false,
+            removedMeta: false,
+            removedChatDir: false,
+            removedSessionDir: false,
+            error: String(error),
+        };
+    }
+}
+//# sourceMappingURL=ChatSessionDelete.js.map

package/bin/plugin/builtins/chat/runtime/ChatSessionDelete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionDelete.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatSessionDelete.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAE5F,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,OAAO,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAG3C;IASC,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,KAAK;YAClB,cAAc,EAAE,KAAK;YACrB,iBAAiB,EAAE,KAAK;YACxB,KAAK,EAAE,mBAAmB;SAC3B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,mCAAmC;QACnC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,aAAa,EAAE,CAAC;QACtD,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAEvD,MAAM,iBAAiB,GAAG,MAAM,yBAAyB,CAAC;YACxD,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QACnF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,OAAO,GACX,iBAAiB,CAAC,OAAO,IAAI,UAAU,IAAI,aAAa,CAAC;QAE3D,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS;YACT,OAAO;YACP,WAAW,EAAE,iBAAiB,CAAC,OAAO;YACtC,cAAc,EAAE,UAAU;YAC1B,iBAAiB,EAAE,aAAa;SACjC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,SAAS;YACT,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,KAAK;YAClB,cAAc,EAAE,KAAK;YACrB,iBAAiB,EAAE,KAAK;YACxB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACrB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/bin/plugin/builtins/chat/runtime/ChatSessionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionTypes.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatSessionTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAEvD;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,4BAA4B,CAAC;CACxD"}

package/bin/plugin/builtins/chat/runtime/ChatSessionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionTypes.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatSessionTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/plugin/builtins/chat/runtime/ChatkeySend.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Send text to a target chat using chatKey.
+ *
+ * 设计动机（中文）
+ * - Task runner / scheduler 需要在“非当前对话上下文”向指定 chatKey 投递消息
+ * - 复用现有 dispatcher 与 chat meta（尤其 QQ 的被动回复依赖 messageId）
+ *
+ * 注意
+ * - 这里是运行时内部能力（不是 tool）；tool `chat_contact_send` 也会复用本实现
+ */
+import type { ChatDispatchAction, ChatDispatchChannel } from "../../../../plugin/builtins/chat/types/ChatDispatcher.js";
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+/**
+ * 解析实际分发目标。
+ *
+ * 规则（中文）
+ * - 仅使用 service/builtins/chat 维护的 session 路由映射。
+ * - 不再支持 legacy chatKey 字符串解析回退。
+ */
+export declare function resolveDispatchTargetByChatKey(params: {
+    context: AgentContext;
+    chatKey: string;
+}): Promise<{
+    channel: ChatDispatchChannel;
+    chatId: string;
+    chatType?: string;
+    messageThreadId?: number;
+    messageId?: string;
+} | null>;
+/**
+ * 按 chatKey 发送文本到对应平台。
+ *
+ * 流程（中文）
+ * 1) 通过 sessionId 读取映射并定位 channel dispatcher
+ * 2) 从 chat meta 回填 chatType/threadId/messageId
+ * 3) 合并参数后调用 dispatcher 发送
+ */
+export declare function sendTextByChatKey(params: {
+    context: AgentContext;
+    chatKey: string;
+    text: string;
+    replyToMessage?: boolean;
+    messageId?: string;
+}): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * 按 chatKey 发送平台动作（typing/react）。
+ *
+ * 流程（中文）
+ * 1) 通过 sessionId 读取映射并定位 channel dispatcher
+ * 2) 合并目标元信息与显式参数（显式 messageId 优先）
+ * 3) 调用 dispatcher.sendAction
+ */
+export declare function sendActionByChatKey(params: {
+    context: AgentContext;
+    chatKey: string;
+    action: ChatDispatchAction;
+    messageId?: string;
+    reactionEmoji?: string;
+    reactionIsBig?: boolean;
+}): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=ChatkeySend.d.ts.map

package/bin/plugin/builtins/chat/runtime/ChatkeySend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatkeySend.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatkeySend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAAC,MAAM,EAAE;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAAC,CA8BR;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkDhD;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsChD"}

package/bin/plugin/builtins/chat/runtime/ChatkeySend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatkeySend.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatkeySend.ts"],"names":[],"mappings":"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"}

package/bin/plugin/builtins/chat/runtime/DirectDispatchParser.d.ts

@@ -0,0 +1,22 @@
+/**
+ * DirectDispatchParser：direct 模式 assistant 文本解析器。
+ *
+ * 关键点（中文）
+ * - 默认把 assistant 文本原样当作用户可见正文发送。
+ * - frontmatter metadata 语义与 `city chat send` 保持一致。
+ * - 额外保留 `react` 字段用于 direct 模式贴表情。
+ */
+import type { ResolvedDirectDispatchPlan } from "../../../../plugin/builtins/chat/types/DirectDispatch.js";
+/**
+ * 从 assistant 文本中解析 direct 出站执行计划。
+ *
+ * 协议（中文）
+ * - frontmatter metadata：与 `city chat send` 参数保持一致。
+ * - 附件统一使用 `<file type=\"document|photo|voice|audio|video\">path</file>`。
+ * - `react` 仍仅用于 direct 模式的反应动作。
+ */
+export declare function parseDirectDispatchAssistantText(params: {
+    assistantText: string;
+    fallbackChatKey: string;
+}): ResolvedDirectDispatchPlan | null;
+//# sourceMappingURL=DirectDispatchParser.d.ts.map

package/bin/plugin/builtins/chat/runtime/DirectDispatchParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectDispatchParser.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/DirectDispatchParser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,0BAA0B,EAG3B,MAAM,gDAAgD,CAAC;AA6GxD;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,0BAA0B,GAAG,IAAI,CAuBpC"}

package/bin/plugin/builtins/chat/runtime/DirectDispatchParser.js

@@ -0,0 +1,133 @@
+/**
+ * DirectDispatchParser：direct 模式 assistant 文本解析器。
+ *
+ * 关键点（中文）
+ * - 默认把 assistant 文本原样当作用户可见正文发送。
+ * - frontmatter metadata 语义与 `city chat send` 保持一致。
+ * - 额外保留 `react` 字段用于 direct 模式贴表情。
+ */
+import { buildChatMessageText, parseChatMessageMarkup, } from "../../../../plugin/builtins/chat/runtime/ChatMessageMarkup.js";
+import { parseChatSendOptionsFromMetadata } from "../../../../plugin/builtins/chat/runtime/ChatSendMetadata.js";
+function normalizeText(value) {
+    return String(value ?? "").trim();
+}
+function parseBoolean(value) {
+    if (typeof value === "boolean")
+        return value;
+    const text = normalizeText(value).toLowerCase();
+    return text === "true" || text === "1" || text === "yes";
+}
+function parseReactionFromMetadata(value) {
+    if (typeof value === "string") {
+        const emoji = normalizeText(value);
+        return emoji ? { emoji } : null;
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    const raw = value;
+    const emoji = normalizeText(raw.emoji);
+    if (!emoji)
+        return null;
+    const big = parseBoolean(raw.big);
+    return {
+        emoji,
+        ...(big ? { big: true } : {}),
+    };
+}
+function parseReactionsFromMetadata(metadata) {
+    const out = [];
+    const raw = metadata.react;
+    if (!raw)
+        return out;
+    const list = Array.isArray(raw) ? raw : [raw];
+    for (const item of list) {
+        const parsed = parseReactionFromMetadata(item);
+        if (!parsed)
+            continue;
+        out.push(parsed);
+    }
+    return out;
+}
+function resolveTextPlan(params) {
+    const sendOptions = parseChatSendOptionsFromMetadata({
+        metadata: params.metadata,
+        strict: false,
+    });
+    const chatKey = normalizeText(sendOptions.chatKey || params.fallbackChatKey);
+    const text = buildChatMessageText({
+        segments: params.segments,
+    });
+    if (!chatKey || !text)
+        return null;
+    return {
+        text,
+        chatKey,
+        replyToMessage: sendOptions.replyToMessage === true,
+        ...(typeof sendOptions.messageId === "string" && sendOptions.messageId
+            ? { messageId: sendOptions.messageId }
+            : {}),
+        ...(typeof sendOptions.delayMs === "number"
+            ? { delayMs: sendOptions.delayMs }
+            : {}),
+        ...(typeof sendOptions.sendAtMs === "number"
+            ? { sendAtMs: sendOptions.sendAtMs }
+            : {}),
+    };
+}
+function resolveReactionPlans(params) {
+    const out = [];
+    const sendOptions = parseChatSendOptionsFromMetadata({
+        metadata: params.metadata,
+        strict: false,
+    });
+    const chatKey = normalizeText(sendOptions.chatKey || params.fallbackChatKey);
+    const messageId = normalizeText(sendOptions.messageId);
+    if (!chatKey)
+        return out;
+    for (const react of params.reacts) {
+        const emoji = normalizeText(react.emoji);
+        if (!emoji)
+            continue;
+        out.push({
+            emoji,
+            chatKey,
+            ...(messageId ? { messageId } : {}),
+            big: react.big === true,
+        });
+    }
+    return out;
+}
+/**
+ * 从 assistant 文本中解析 direct 出站执行计划。
+ *
+ * 协议（中文）
+ * - frontmatter metadata：与 `city chat send` 参数保持一致。
+ * - 附件统一使用 `<file type=\"document|photo|voice|audio|video\">path</file>`。
+ * - `react` 仍仅用于 direct 模式的反应动作。
+ */
+export function parseDirectDispatchAssistantText(params) {
+    const source = String(params.assistantText ?? "");
+    const fallbackChatKey = normalizeText(params.fallbackChatKey);
+    if (!normalizeText(source) || !fallbackChatKey)
+        return null;
+    const parsed = parseChatMessageMarkup(source);
+    const reacts = parseReactionsFromMetadata(parsed.metadata);
+    const textPlan = resolveTextPlan({
+        fallbackChatKey,
+        metadata: parsed.metadata,
+        segments: parsed.segments,
+    });
+    const reactionPlans = resolveReactionPlans({
+        fallbackChatKey,
+        metadata: parsed.metadata,
+        reacts,
+    });
+    if (!textPlan && reactionPlans.length === 0)
+        return null;
+    return {
+        text: textPlan,
+        reactions: reactionPlans,
+    };
+}
+//# sourceMappingURL=DirectDispatchParser.js.map

package/bin/plugin/builtins/chat/runtime/DirectDispatchParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectDispatchParser.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/DirectDispatchParser.ts"],"names":[],"mappings":"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"}

package/bin/plugin/builtins/chat/runtime/EnqueueDispatch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Chat enqueue dispatch helper。
+ *
+ * 关键点（中文）
+ * - 统一封装入队前/后的扩展点调用。
+ * - service 通过这里暴露 queue 生命周期，不直接散落调用细节。
+ */
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+import type { ChatEnqueueEffectInput, ChatEnqueuePipelineInput } from "../../../../plugin/builtins/chat/types/ChatPlugin.js";
+/**
+ * 入队前增强。
+ */
+export declare function prepareChatEnqueue(params: {
+    context: AgentContext;
+    input: ChatEnqueuePipelineInput;
+}): Promise<ChatEnqueuePipelineInput>;
+/**
+ * 入队后通知。
+ */
+export declare function emitChatEnqueueEffect(params: {
+    context: AgentContext;
+    input: ChatEnqueueEffectInput;
+}): Promise<void>;
+//# sourceMappingURL=EnqueueDispatch.d.ts.map

package/bin/plugin/builtins/chat/runtime/EnqueueDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnqueueDispatch.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/EnqueueDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,4CAA4C,CAAC;AAQpD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,wBAAwB,CAAC;CACjC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CASpC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,sBAAsB,CAAC;CAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}

package/bin/plugin/builtins/chat/runtime/EnqueueDispatch.js

@@ -0,0 +1,28 @@
+/**
+ * Chat enqueue dispatch helper。
+ *
+ * 关键点（中文）
+ * - 统一封装入队前/后的扩展点调用。
+ * - service 通过这里暴露 queue 生命周期，不直接散落调用细节。
+ */
+import { CHAT_PLUGIN_POINTS } from "../../../../plugin/builtins/chat/runtime/PluginPoints.js";
+function normalizeText(value) {
+    return String(value || "").trim();
+}
+/**
+ * 入队前增强。
+ */
+export async function prepareChatEnqueue(params) {
+    const normalized = {
+        ...params.input,
+        text: normalizeText(params.input.text),
+    };
+    return params.context.plugins.pipeline(CHAT_PLUGIN_POINTS.beforeEnqueue, normalized);
+}
+/**
+ * 入队后通知。
+ */
+export async function emitChatEnqueueEffect(params) {
+    await params.context.plugins.effect(CHAT_PLUGIN_POINTS.afterEnqueue, params.input);
+}
+//# sourceMappingURL=EnqueueDispatch.js.map

package/bin/plugin/builtins/chat/runtime/EnqueueDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnqueueDispatch.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/EnqueueDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAEpF,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAGxC;IACC,MAAM,UAAU,GAA6B;QAC3C,GAAG,MAAM,CAAC,KAAK;QACf,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;KACvC,CAAC;IACF,OAAQ,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CACrC,kBAAkB,CAAC,aAAa,EAChC,UAAkC,CACc,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAG3C;IACC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CACjC,kBAAkB,CAAC,YAAY,EAC/B,MAAM,CAAC,KAA6B,CACrC,CAAC;AACJ,CAAC"}

package/bin/plugin/builtins/chat/runtime/InboundAugment.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Chat inbound augment helper。
+ *
+ * 关键点（中文）
+ * - chat service 先构造基础输入，再交给 plugin pipeline 做增强。
+ * - 最终拼装顺序固定为：attachmentText -> pluginSections -> bodyText。
+ */
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+import type { ChatInboundAugmentInput } from "../../../../plugin/builtins/chat/types/ChatPlugin.js";
+/**
+ * 执行 chat 入站增强 pipeline。
+ */
+export declare function augmentChatInboundInput(params: {
+    context: AgentContext;
+    input: ChatInboundAugmentInput;
+}): Promise<ChatInboundAugmentInput>;
+/**
+ * 把增强后的 chat 入站输入拼成最终正文。
+ */
+export declare function buildChatInboundText(input: ChatInboundAugmentInput): string;
+//# sourceMappingURL=InboundAugment.d.ts.map

package/bin/plugin/builtins/chat/runtime/InboundAugment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboundAugment.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/InboundAugment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAS1F;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,uBAAuB,CAAC;CAChC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAsBnC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAW3E"}

package/bin/plugin/builtins/chat/runtime/InboundAugment.js

@@ -0,0 +1,50 @@
+/**
+ * Chat inbound augment helper。
+ *
+ * 关键点（中文）
+ * - chat service 先构造基础输入，再交给 plugin pipeline 做增强。
+ * - 最终拼装顺序固定为：attachmentText -> pluginSections -> bodyText。
+ */
+import { CHAT_PLUGIN_POINTS } from "../../../../plugin/builtins/chat/runtime/PluginPoints.js";
+function normalizeText(value) {
+    const text = String(value || "").trim();
+    return text || undefined;
+}
+/**
+ * 执行 chat 入站增强 pipeline。
+ */
+export async function augmentChatInboundInput(params) {
+    const normalized = {
+        ...params.input,
+        ...(params.input.chatType ? { chatType: params.input.chatType } : {}),
+        ...(params.input.chatKey ? { chatKey: params.input.chatKey } : {}),
+        ...(params.input.messageId ? { messageId: params.input.messageId } : {}),
+        ...(normalizeText(params.input.attachmentText)
+            ? { attachmentText: normalizeText(params.input.attachmentText) }
+            : {}),
+        ...(normalizeText(params.input.bodyText)
+            ? { bodyText: normalizeText(params.input.bodyText) }
+            : {}),
+        pluginSections: Array.isArray(params.input.pluginSections)
+            ? params.input.pluginSections.map((item) => String(item || "").trim()).filter(Boolean)
+            : [],
+        attachments: Array.isArray(params.input.attachments) ? params.input.attachments : [],
+    };
+    return params.context.plugins.pipeline(CHAT_PLUGIN_POINTS.augmentInbound, normalized);
+}
+/**
+ * 把增强后的 chat 入站输入拼成最终正文。
+ */
+export function buildChatInboundText(input) {
+    return [
+        normalizeText(input.attachmentText),
+        ...(Array.isArray(input.pluginSections)
+            ? input.pluginSections.map((item) => normalizeText(item)).filter(Boolean)
+            : []),
+        normalizeText(input.bodyText),
+    ]
+        .filter(Boolean)
+        .join("\n\n")
+        .trim();
+}
+//# sourceMappingURL=InboundAugment.js.map

package/bin/plugin/builtins/chat/runtime/InboundAugment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboundAugment.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/InboundAugment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAEpF,SAAS,aAAa,CAAC,KAAyB;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAG7C;IACC,MAAM,UAAU,GAA4B;QAC1C,GAAG,MAAM,CAAC,KAAK;QACf,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;YAC5C,CAAC,CAAC,EAAE,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE;YAChE,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YACtC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;YACpD,CAAC,CAAC,EAAE,CAAC;QACP,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;YACxD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACtF,CAAC,CAAC,EAAE;QACN,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;KACrF,CAAC;IAEF,OAAQ,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CACrC,kBAAkB,CAAC,cAAc,EACjC,UAAkC,CACa,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA8B;IACjE,OAAO;QACL,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC;QACnC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;YACrC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACzE,CAAC,CAAC,EAAE,CAAC;QACP,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;KAC9B;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC;SACZ,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/bin/plugin/builtins/chat/runtime/PluginDispatch.d.ts

@@ -0,0 +1,43 @@
+/**
+ * PluginDispatch：chat 领域的 plugin 调用辅助。
+ *
+ * 关键点（中文）
+ * - chat service 只依赖这里，不直接依赖某个具体 plugin 模块路径。
+ * - 这里封装 chat 领域的 plugin 点调用语义，保持 service 边界稳定。
+ */
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+import type { ChatAuthorizationEvaluateInput, ChatAuthorizationRole } from "../../../../plugin/builtins/auth/types/AuthPlugin.js";
+import type { ChatDispatchChannel } from "../../../../plugin/builtins/chat/types/ChatDispatcher.js";
+/**
+ * 观测入站主体。
+ */
+export declare function observeIncomingChatPrincipal(params: {
+    context: AgentContext;
+    channel: ChatDispatchChannel;
+    chatId: string;
+    chatType?: string;
+    chatTitle?: string;
+    userId?: string;
+    username?: string;
+}): Promise<void>;
+/**
+ * 校验入站消息是否允许执行。
+ *
+ * 关键点（中文）
+ * - 这是 guard 语义：允许则静默返回，拒绝则直接抛错。
+ * - 这样 chat service 可以像处理中间件一样串联 guard 点。
+ */
+export declare function guardIncomingChat(params: {
+    context: AgentContext;
+    channel: ChatDispatchChannel;
+    input: ChatAuthorizationEvaluateInput;
+}): Promise<void>;
+/**
+ * 解析用户角色。
+ */
+export declare function resolveIncomingChatUserRole(params: {
+    context: AgentContext;
+    channel: ChatDispatchChannel;
+    userId?: string;
+}): Promise<ChatAuthorizationRole | undefined>;
+//# sourceMappingURL=PluginDispatch.d.ts.map

package/bin/plugin/builtins/chat/runtime/PluginDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginDispatch.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/PluginDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,EAEV,8BAA8B,EAC9B,qBAAqB,EACtB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAQ1F;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,KAAK,EAAE,8BAA8B,CAAC;CACvC,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAW7C"}

package/bin/plugin/builtins/chat/runtime/PluginDispatch.js

@@ -0,0 +1,57 @@
+/**
+ * PluginDispatch：chat 领域的 plugin 调用辅助。
+ *
+ * 关键点（中文）
+ * - chat service 只依赖这里，不直接依赖某个具体 plugin 模块路径。
+ * - 这里封装 chat 领域的 plugin 点调用语义，保持 service 边界稳定。
+ */
+import { CHAT_PLUGIN_POINTS } from "../../../../plugin/builtins/chat/runtime/PluginPoints.js";
+function toRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return {};
+    return value;
+}
+/**
+ * 观测入站主体。
+ */
+export async function observeIncomingChatPrincipal(params) {
+    await params.context.plugins.effect(CHAT_PLUGIN_POINTS.observePrincipal, {
+        channel: params.channel,
+        chatId: params.chatId,
+        ...(params.chatType ? { chatType: params.chatType } : {}),
+        ...(params.chatTitle ? { chatTitle: params.chatTitle } : {}),
+        ...(params.userId ? { userId: params.userId } : {}),
+        ...(params.username ? { username: params.username } : {}),
+    });
+}
+/**
+ * 校验入站消息是否允许执行。
+ *
+ * 关键点（中文）
+ * - 这是 guard 语义：允许则静默返回，拒绝则直接抛错。
+ * - 这样 chat service 可以像处理中间件一样串联 guard 点。
+ */
+export async function guardIncomingChat(params) {
+    await params.context.plugins.guard(CHAT_PLUGIN_POINTS.authorizeIncoming, {
+        channel: params.channel,
+        chatId: params.input.chatId,
+        ...(params.input.chatType ? { chatType: params.input.chatType } : {}),
+        ...(params.input.userId ? { userId: params.input.userId } : {}),
+        ...(params.input.username ? { username: params.input.username } : {}),
+        ...(params.input.chatTitle ? { chatTitle: params.input.chatTitle } : {}),
+    });
+}
+/**
+ * 解析用户角色。
+ */
+export async function resolveIncomingChatUserRole(params) {
+    const result = await params.context.plugins.resolve(CHAT_PLUGIN_POINTS.resolveUserRole, {
+        channel: params.channel,
+        ...(params.userId ? { userId: params.userId } : {}),
+    });
+    const role = toRecord(result);
+    if (!role.roleId)
+        return undefined;
+    return role;
+}
+//# sourceMappingURL=PluginDispatch.js.map

package/bin/plugin/builtins/chat/runtime/PluginDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginDispatch.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/PluginDispatch.ts"],"names":[],"mappings":"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"}

package/bin/plugin/builtins/chat/runtime/PluginPoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginPoints.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/PluginPoints.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;;OAMG;;CAEK,CAAC"}

package/bin/plugin/builtins/chat/runtime/PluginPoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginPoints.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/PluginPoints.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC;;;;;;OAMG;IACH,cAAc,EAAE,qBAAqB;IACrC;;;;;;OAMG;IACH,WAAW,EAAE,kBAAkB;IAC/B;;;;;;OAMG;IACH,UAAU,EAAE,iBAAiB;IAC7B;;;;;;OAMG;IACH,aAAa,EAAE,oBAAoB;IACnC;;;;;;OAMG;IACH,YAAY,EAAE,mBAAmB;IACjC;;;;;;OAMG;IACH,gBAAgB,EAAE,uBAAuB;IACzC;;;;;;OAMG;IACH,iBAAiB,EAAE,wBAAwB;IAC3C;;;;;;OAMG;IACH,eAAe,EAAE,sBAAsB;CAC/B,CAAC"}

package/bin/plugin/builtins/chat/runtime/QueuedUserMessage.d.ts

@@ -0,0 +1,20 @@
+/**
+ * QueuedUserMessage：构造入队执行消息文本。
+ *
+ * 关键点（中文）
+ * - 统一生成 `<info>...</info>` 头部，供模型读取用户与本次请求元信息。
+ * - chat 路由环境不再放入 `<info>`，改由 system prompt 注入。
+ * - 供 chat 入站执行与其他复用入口共用，避免重复实现。
+ */
+import type { QueuedUserInfoInput } from "../../../../plugin/builtins/chat/types/ChatPromptContext.js";
+/**
+ * 构造“入队 user message”文本。
+ *
+ * 说明（中文）
+ * - 顶部 `<info>` 为内部语义块，仅记录 user/request 元信息。
+ * - 正文为用户原始输入（可为空）。
+ */
+export declare function buildQueuedUserMessageWithInfo(params: {
+    text: string;
+} & QueuedUserInfoInput): string;
+//# sourceMappingURL=QueuedUserMessage.d.ts.map

package/bin/plugin/builtins/chat/runtime/QueuedUserMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueuedUserMessage.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/QueuedUserMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AAQ7F;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,mBAAmB,GAAG,MAAM,CAgB/B"}

package/bin/plugin/builtins/chat/runtime/QueuedUserMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueuedUserMessage.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/QueuedUserMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,SAAS,kBAAkB,CAAC,KAAc;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAExB;IACrB,MAAM,SAAS,GAAG;QAChB,eAAe,kBAAkB,CAAC,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC,EAAE;QAClE,YAAY,kBAAkB,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE;QAC5D,aAAa,kBAAkB,CAAC,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC,EAAE;QAC/D,YAAY,kBAAkB,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE;QAC5D,gBAAgB,kBAAkB,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,EAAE;QACpF,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE;KACpF,CAAC;IACF,IAAI,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5C,SAAS,CAAC,IAAI,CAAC,kBAAkB,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,SAAS,GAAG,WAAW,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,GAAG,SAAS,OAAO,IAAI,EAAE,CAAC;AACnC,CAAC"}