@downcity/agent 1.1.1

package/bin/services/chat/runtime/ChatServiceActions.js

@@ -0,0 +1,411 @@
+/**
+ * ChatServiceActions：chat service 的 action 注册表模块。
+ *
+ * 关键点（中文）
+ * - 这里专门负责把 chat 的 CLI/API/execute 定义装配成 `ServiceActions`。
+ * - ChatService 本体只保留实例状态与 lifecycle，不再承载大段 action 声明。
+ * - action 执行仍然复用各 runtime 模块，确保行为与现有实现保持一致。
+ */
+import { mapChatChannelApiInput, mapChatChannelApiQueryInput, mapChatChannelCommandInput, mapChatConfigureApiInput, mapChatConfigureCommandInput, mapChatDeleteApiInput, mapChatDeleteCommandInput, mapChatHistoryApiInput, mapChatHistoryCommandInput, mapChatInfoApiInput, mapChatInfoCommandInput, mapChatListApiInput, mapChatListCommandInput, mapChatReactApiInput, mapChatReactCommandInput, mapChatSendApiInput, mapChatSendCommandInput, } from "./ChatActionInput.js";
+import { executeChatContextAction, executeChatDeleteAction, executeChatHistoryAction, executeChatInfoAction, executeChatListAction, executeChatReactAction, executeChatSendAction, } from "./ChatActionExecution.js";
+import { executeChatCloseAction, executeChatConfigurationAction, executeChatConfigureAction, executeChatOpenAction, executeChatReconnectAction, executeChatStatusAction, executeChatTestAction, } from "./ChatChannelFacade.js";
+const CHAT_SEND_HELP_TEXT = [
+    "",
+    "消息协议：",
+    "  frontmatter metadata 字段语义与 `city chat send` 参数一致。",
+    "  附件使用 `<file type=\"...\">path</file>`，支持 `document/photo/voice/audio/video`。",
+    "  正文与 `<file>` 可以交错出现，运行时会按原顺序发送。",
+    "",
+    "常用示例：",
+    "  city chat send --text 'done'",
+    "  city chat send --chat-key <chatKey> --text 'done'",
+    "  cat <<'EOF' | city chat send --stdin --chat-key <chatKey>",
+    "  第一行",
+    "  第二行",
+    "  EOF",
+    "  city chat send --text-file ./result.md --chat-key <chatKey>",
+    "",
+    "说明：",
+    "  当前会话可省略 `--chat-key`；跨 chat 发送时必须显式传 `--chat-key`。",
+    "  `--delay` 与 `--time` 互斥；ISO 时间必须带时区。",
+].join("\n");
+const CHAT_REACT_HELP_TEXT = [
+    "",
+    "常用示例：",
+    "  city chat react --emoji '👍'",
+    "  city chat react --emoji '✅' --message-id <messageId>",
+    "  city chat react --chat-key <chatKey> --message-id <messageId> --emoji '🔥'",
+    "",
+    "说明：",
+    "  当前会话可省略 `--chat-key`；跨 chat 操作时显式传 `--chat-key`。",
+    "  `react` 需要目标消息，优先使用显式 `--message-id`。",
+].join("\n");
+function attachCommandHelpText(command, text) {
+    command.on("--help", () => {
+        console.log(text);
+    });
+}
+/**
+ * 创建 chat service 的 action 定义表。
+ */
+export function createChatServiceActions(params) {
+    return {
+        status: {
+            command: {
+                description: "查看 chat 渠道连接状态",
+                configure(command) {
+                    command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+                },
+                mapInput: mapChatChannelCommandInput,
+            },
+            api: {
+                method: "GET",
+                mapInput(c) {
+                    return mapChatChannelApiQueryInput({
+                        channel: c.req.query("channel"),
+                    });
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatStatusAction({
+                    state: params.channelState,
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        test: {
+            command: {
+                description: "测试 chat 渠道连通性",
+                configure(command) {
+                    command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+                },
+                mapInput: mapChatChannelCommandInput,
+            },
+            api: {
+                method: "POST",
+                async mapInput(c) {
+                    return mapChatChannelApiInput(await c.req.json().catch(() => ({})));
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatTestAction({
+                    state: params.channelState,
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        reconnect: {
+            command: {
+                description: "重连 chat 渠道（默认全部）",
+                configure(command) {
+                    command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+                },
+                mapInput: mapChatChannelCommandInput,
+            },
+            api: {
+                method: "POST",
+                async mapInput(c) {
+                    return mapChatChannelApiInput(await c.req.json().catch(() => ({})));
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatReconnectAction({
+                    state: params.channelState,
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        open: {
+            command: {
+                description: "打开 chat 渠道（enabled=true，已配置则尝试启动）",
+                configure(command) {
+                    command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+                },
+                mapInput: mapChatChannelCommandInput,
+            },
+            api: {
+                method: "POST",
+                async mapInput(c) {
+                    return mapChatChannelApiInput(await c.req.json().catch(() => ({})));
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatOpenAction({
+                    state: params.channelState,
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        close: {
+            command: {
+                description: "关闭 chat 渠道（enabled=false，并停止运行）",
+                configure(command) {
+                    command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+                },
+                mapInput: mapChatChannelCommandInput,
+            },
+            api: {
+                method: "POST",
+                async mapInput(c) {
+                    return mapChatChannelApiInput(await c.req.json().catch(() => ({})));
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatCloseAction({
+                    state: params.channelState,
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        configuration: {
+            command: {
+                description: "查看 chat 渠道配置元信息（字段、类型、说明）",
+                configure(command) {
+                    command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+                },
+                mapInput: mapChatChannelCommandInput,
+            },
+            api: {
+                method: "GET",
+                mapInput(c) {
+                    return mapChatChannelApiQueryInput({
+                        channel: c.req.query("channel"),
+                    });
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatConfigurationAction({
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        configure: {
+            command: {
+                description: "更新 chat 渠道参数（写入 downcity.json，可选立即重载）",
+                configure(command) {
+                    command
+                        .requiredOption("--channel <name>", "指定渠道（telegram|feishu|qq）")
+                        .requiredOption("--config-json <json>", "配置 patch JSON（例如 '{\"channelAccountId\":\"qq-main\",\"enabled\":true}'）")
+                        .option("--restart", "配置后立即重载渠道", false);
+                },
+                mapInput: mapChatConfigureCommandInput,
+            },
+            api: {
+                method: "POST",
+                async mapInput(c) {
+                    return mapChatConfigureApiInput(c);
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatConfigureAction({
+                    state: params.channelState,
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        list: {
+            command: {
+                description: "列出当前 agent 已记录的 chat 会话（chatTitle/chatKey）",
+                configure(command) {
+                    command
+                        .option("--channel <name>", "渠道过滤（telegram|feishu|qq）")
+                        .option("--limit <n>", "返回最近 N 条（默认 50）")
+                        .option("--q <text>", "关键词过滤（title/chatId/sessionId/actor）");
+                },
+                mapInput: mapChatListCommandInput,
+            },
+            api: {
+                method: "GET",
+                mapInput(c) {
+                    return mapChatListApiInput({
+                        channel: c.req.query("channel"),
+                        limit: c.req.query("limit"),
+                        q: c.req.query("q"),
+                    });
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatListAction({
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        info: {
+            command: {
+                description: "查看指定 chat 会话信息（路由/本地路径/上下文快照）",
+                configure(command) {
+                    command
+                        .option("--chat-key <chatKey>", "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）")
+                        .option("--session-id <sessionId>", "显式指定 sessionId（优先级更高）");
+                },
+                mapInput: mapChatInfoCommandInput,
+            },
+            api: {
+                method: "GET",
+                mapInput(c) {
+                    return mapChatInfoApiInput({
+                        chatKey: c.req.query("chatKey"),
+                        sessionId: c.req.query("sessionId"),
+                    });
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatInfoAction({
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        send: {
+            command: {
+                description: "发送消息到目标 chatKey",
+                configure(command) {
+                    command
+                        .option("--text <text>", "消息正文")
+                        .option("--stdin", "从标准输入读取消息正文", false)
+                        .option("--text-file <file>", "从文件读取消息正文（相对当前目录）")
+                        .option("--reply", "显式使用 reply_to_message 回复目标消息", false)
+                        .option("--message-id <id>", "显式指定 reply 目标消息 ID")
+                        .option("--chat-key <chatKey>", "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）");
+                    attachCommandHelpText(command, CHAT_SEND_HELP_TEXT);
+                },
+                mapInput: mapChatSendCommandInput,
+            },
+            api: {
+                method: "POST",
+                async mapInput(c) {
+                    return mapChatSendApiInput(await c.req.json());
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatSendAction({
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        react: {
+            command: {
+                description: "给目标消息贴表情（当前仅 Telegram 支持）",
+                configure(command) {
+                    command
+                        .option("--emoji <emoji>", "表情字符（默认 👍）")
+                        .option("--big", "使用大表情效果（Telegram is_big）", false)
+                        .option("--message-id <id>", "目标消息 ID（默认尝试从 chat meta 回填）")
+                        .option("--chat-key <chatKey>", "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）");
+                    attachCommandHelpText(command, CHAT_REACT_HELP_TEXT);
+                },
+                mapInput: mapChatReactCommandInput,
+            },
+            api: {
+                method: "POST",
+                async mapInput(c) {
+                    return mapChatReactApiInput(await c.req.json());
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatReactAction({
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        context: {
+            command: {
+                description: "查看当前会话上下文快照",
+                configure(command) {
+                    command.option("--chat-key <chatKey>", "显式覆盖 chatKey");
+                },
+                mapInput(input) {
+                    const chatKey = typeof input.opts.chatKey === "string" ? String(input.opts.chatKey).trim() : "";
+                    return {
+                        ...(chatKey ? { chatKey } : {}),
+                    };
+                },
+            },
+            api: {
+                method: "GET",
+                mapInput(c) {
+                    const chatKey = String(c.req.query("chatKey") || "").trim();
+                    const sessionId = String(c.req.query("sessionId") || "").trim();
+                    return {
+                        ...(chatKey ? { chatKey } : {}),
+                        ...(sessionId ? { sessionId } : {}),
+                    };
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatContextAction({
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        delete: {
+            command: {
+                description: "彻底删除指定 chat 会话（映射+历史+context）",
+                configure(command) {
+                    command
+                        .option("--chat-key <chatKey>", "显式指定 chatKey")
+                        .option("--session-id <sessionId>", "显式指定 sessionId");
+                },
+                mapInput: mapChatDeleteCommandInput,
+            },
+            api: {
+                method: "POST",
+                async mapInput(c) {
+                    return mapChatDeleteApiInput(await c.req.json().catch(() => ({})));
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatDeleteAction({
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+        history: {
+            command: {
+                description: "读取 chat 历史消息（默认最近 30 条）",
+                configure(command) {
+                    command
+                        .option("--chat-key <chatKey>", "显式覆盖 chatKey")
+                        .option("--session-id <sessionId>", "显式覆盖 sessionId")
+                        .option("--limit <n>", "返回最近 N 条（默认 30）")
+                        .option("--direction <direction>", "方向过滤（all|inbound|outbound）")
+                        .option("--before-ts <ts>", "仅返回 ts 小于该值的记录（毫秒）")
+                        .option("--after-ts <ts>", "仅返回 ts 大于该值的记录（毫秒）");
+                },
+                mapInput: mapChatHistoryCommandInput,
+            },
+            api: {
+                method: "GET",
+                mapInput(c) {
+                    return mapChatHistoryApiInput({
+                        chatKey: c.req.query("chatKey"),
+                        sessionId: c.req.query("sessionId"),
+                        limit: c.req.query("limit"),
+                        direction: c.req.query("direction"),
+                        beforeTs: c.req.query("beforeTs"),
+                        afterTs: c.req.query("afterTs"),
+                    });
+                },
+            },
+            execute: async (actionParams) => {
+                return executeChatHistoryAction({
+                    context: actionParams.context,
+                    payload: actionParams.payload,
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=ChatServiceActions.js.map

package/bin/services/chat/runtime/ChatServiceActions.js.map

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

package/bin/services/chat/runtime/ChatServiceSystem.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ChatServiceSystem：chat service 的 system prompt 组装模块。
+ *
+ * 关键点（中文）
+ * - chat service prompt 与 channel prompt 都属于静态资产。
+ * - 当前请求只注入当前 channel 的 prompt，避免平台规则串味。
+ * - 该模块只负责 prompt 解析与拼装，不承担运行态控制职责。
+ */
+import type { AgentContext } from "../../../types/agent/AgentContext.js";
+/**
+ * 构建当前请求所属 channel 的提示词片段。
+ *
+ * 关键点（中文）
+ * - 仅注入当前 context 对应的 channel prompt，避免把其他平台规则混入本轮会话。
+ * - 若当前 context 不是 chat channel（如 consoleui）或尚无路由元信息，则不注入 channel prompt。
+ */
+export declare function buildCurrentChannelPrompts(context: AgentContext): Promise<string[]>;
+/**
+ * 构建 chat service 注入到 session 的 system 文本。
+ */
+export declare function buildChatServiceSystem(context: AgentContext): Promise<string>;
+//# sourceMappingURL=ChatServiceSystem.d.ts.map

package/bin/services/chat/runtime/ChatServiceSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatServiceSystem.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/runtime/ChatServiceSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA0ElE;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAUnB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC,CAQjB"}

package/bin/services/chat/runtime/ChatServiceSystem.js

@@ -0,0 +1,87 @@
+/**
+ * ChatServiceSystem：chat service 的 system prompt 组装模块。
+ *
+ * 关键点（中文）
+ * - chat service prompt 与 channel prompt 都属于静态资产。
+ * - 当前请求只注入当前 channel 的 prompt，避免平台规则串味。
+ * - 该模块只负责 prompt 解析与拼装，不承担运行态控制职责。
+ */
+import { readFileSync } from "node:fs";
+import { buildCurrentChatEnvironmentPrompt, resolveCurrentChatEnvironmentPromptInput, } from "../../chat/runtime/SystemPrompt.js";
+const CHAT_DIRECT_PROMPT_FILE_URL = new URL("../PROMPT.direct.txt", import.meta.url);
+const TELEGRAM_DIRECT_PROMPT_FILE_URL = new URL("../channels/telegram/PROMPT.direct.txt", import.meta.url);
+const FEISHU_DIRECT_PROMPT_FILE_URL = new URL("../channels/feishu/PROMPT.direct.txt", import.meta.url);
+const QQ_DIRECT_PROMPT_FILE_URL = new URL("../channels/qq/PROMPT.direct.txt", import.meta.url);
+/**
+ * 加载 chat service 使用说明提示词。
+ *
+ * 关键点（中文）
+ * - 启动阶段即加载，缺失时直接抛错，避免静默失效。
+ */
+function loadChatServicePrompt(fileUrl) {
+    try {
+        return readFileSync(fileUrl, "utf-8").trim();
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new Error(`failed to load chat service prompt from ${fileUrl.pathname}: ${reason}`);
+    }
+}
+const CHAT_SERVICE_PROMPT = loadChatServicePrompt(CHAT_DIRECT_PROMPT_FILE_URL);
+/**
+ * 加载单个 channel 提示词。
+ *
+ * 关键点（中文）
+ * - channel 提示词属于强依赖资产，缺失时直接抛错，避免运行时悄悄丢失规则。
+ */
+function loadChatChannelPrompt(fileUrl, channelName) {
+    try {
+        return readFileSync(fileUrl, "utf-8").trim();
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new Error(`failed to load ${channelName} chat channel prompt from ${fileUrl.pathname}: ${reason}`);
+    }
+}
+const CHAT_CHANNEL_PROMPTS = {
+    telegram: loadChatChannelPrompt(TELEGRAM_DIRECT_PROMPT_FILE_URL, "telegram-direct"),
+    feishu: loadChatChannelPrompt(FEISHU_DIRECT_PROMPT_FILE_URL, "feishu-direct"),
+    qq: loadChatChannelPrompt(QQ_DIRECT_PROMPT_FILE_URL, "qq-direct"),
+};
+function resolveCurrentChatPromptChannel(channel) {
+    if (channel === "telegram" || channel === "feishu" || channel === "qq") {
+        return channel;
+    }
+    return null;
+}
+/**
+ * 构建当前请求所属 channel 的提示词片段。
+ *
+ * 关键点（中文）
+ * - 仅注入当前 context 对应的 channel prompt，避免把其他平台规则混入本轮会话。
+ * - 若当前 context 不是 chat channel（如 consoleui）或尚无路由元信息，则不注入 channel prompt。
+ */
+export async function buildCurrentChannelPrompts(context) {
+    const chatEnvironment = await resolveCurrentChatEnvironmentPromptInput(context);
+    if (!chatEnvironment)
+        return [];
+    const channel = resolveCurrentChatPromptChannel(String(chatEnvironment.channel || "")
+        .trim()
+        .toLowerCase());
+    if (!channel)
+        return [];
+    return [CHAT_CHANNEL_PROMPTS[channel]].filter(Boolean);
+}
+/**
+ * 构建 chat service 注入到 session 的 system 文本。
+ */
+export async function buildChatServiceSystem(context) {
+    return [
+        CHAT_SERVICE_PROMPT,
+        await buildCurrentChatEnvironmentPrompt(context),
+        ...(await buildCurrentChannelPrompts(context)),
+    ]
+        .filter(Boolean)
+        .join("\n\n");
+}
+//# sourceMappingURL=ChatServiceSystem.js.map

package/bin/services/chat/runtime/ChatServiceSystem.js.map

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

package/bin/services/chat/runtime/ChatSession.d.ts

@@ -0,0 +1,73 @@
+/**
+ * ChatSession：chat 专用 Session 实现。
+ *
+ * 关键点（中文）
+ * - ChatSession 在实例化时持有自己的 execution composer 实例。
+ * - chat 当前 turn 的 step 合并/step 回发状态都绑定在 Session 自身，不再新增 `runChat` 一层入口。
+ * - 外层仍只调用标准 `run(...)`；chat 语义由 ChatSession 内部收敛。
+ */
+import { Session } from "../../../session/Session.js";
+import type { SessionHistoryComposer } from "../../../session/composer/history/SessionHistoryComposer.js";
+import type { ChatSessionExecutionComposer } from "../../chat/runtime/ChatSessionExecutionComposer.js";
+import type { SessionExecutor } from "../../../types/session/SessionExecutor.js";
+import type { SessionRunResult } from "../../../types/session/SessionRun.js";
+import type { ChatSessionTurnState } from "../../../types/chat/ChatSession.js";
+type ChatSessionOptions = {
+    /**
+     * 当前会话 ID。
+     */
+    sessionId: string;
+    /**
+     * 当前 session 的 history composer。
+     */
+    historyComposer: SessionHistoryComposer;
+    /**
+     * 当前 session 绑定的 chat execution composer。
+     */
+    executionComposer: ChatSessionExecutionComposer;
+    /**
+     * 创建当前 session 的执行器。
+     */
+    createExecutor: (historyComposer: SessionHistoryComposer, executionComposer: ChatSessionExecutionComposer) => SessionExecutor;
+    /**
+     * session 更新后的异步回调。
+     */
+    runAfterSessionUpdated?: (sessionId: string) => Promise<void>;
+};
+/**
+ * Chat 专用 Session。
+ */
+export declare class ChatSession extends Session {
+    /**
+     * ChatSession 持有的 composer 实例。
+     */
+    readonly executionComposer: ChatSessionExecutionComposer;
+    private activeTurnState;
+    constructor(options: ChatSessionOptions);
+    /**
+     * 读取当前绑定的 chat turn 状态。
+     */
+    getTurnState(): ChatSessionTurnState | null;
+    /**
+     * 处理一次 assistant step 回发。
+     *
+     * 关键点（中文）
+     * - step 持久化由基类 `Session.run` 先完成。
+     * - 这里仅负责把当前 turn 绑定的外部回发钩子继续调出去。
+     */
+    private readonly forwardAssistantStep;
+    /**
+     * 运行当前 chat session 的一次请求。
+     *
+     * 关键点（中文）
+     * - 外层继续走统一的 `session.run(...)` 入口。
+     * - ChatSession 只是在 run 生命周期里临时绑定 turn 状态给自己的 composer。
+     */
+    run(params: {
+        query: string;
+        onStepCallback?: ChatSessionTurnState["onStepCallback"];
+        onAssistantStepCallback?: ChatSessionTurnState["onAssistantStepCallback"];
+    }): Promise<SessionRunResult>;
+}
+export {};
+//# sourceMappingURL=ChatSession.d.ts.map

package/bin/services/chat/runtime/ChatSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSession.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/runtime/ChatSession.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAClG,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wDAAwD,CAAC;AAC3G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,KAAK,kBAAkB,GAAG;IACxB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,eAAe,EAAE,sBAAsB,CAAC;IAExC;;OAEG;IACH,iBAAiB,EAAE,4BAA4B,CAAC;IAEhD;;OAEG;IACH,cAAc,EAAE,CACd,eAAe,EAAE,sBAAsB,EACvC,iBAAiB,EAAE,4BAA4B,KAC5C,eAAe,CAAC;IAErB;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAY,SAAQ,OAAO;IACtC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;IAEzD,OAAO,CAAC,eAAe,CAAqC;gBAEhD,OAAO,EAAE,kBAAkB;IAcvC;;OAEG;IACH,YAAY,IAAI,oBAAoB,GAAG,IAAI;IAI3C;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAMnC;IAEF;;;;;;OAMG;IACY,GAAG,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;QACxD,uBAAuB,CAAC,EAAE,oBAAoB,CAAC,yBAAyB,CAAC,CAAC;KAC3E,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAmB9B"}