@downcity/agent 1.1.1

package/bin/services/chat/Action.js

@@ -0,0 +1,376 @@
+/**
+ * Chat command services.
+ *
+ * 关键点（中文）
+ * - chat 语义（chatKey 与 sessionId 映射）统一收口在本模块
+ * - 通过 SessionRunScope（ALS）读取当前请求上下文
+ */
+import { getSessionRunScope } from "../../session/SessionRunScope.js";
+import { sendActionByChatKey, sendTextByChatKey, } from "./runtime/ChatkeySend.js";
+import { deleteChatSessionById } from "./runtime/ChatSessionDelete.js";
+/**
+ * 读取字符串环境变量。
+ *
+ * 关键点（中文）
+ * - 自动 trim；空字符串视为未设置。
+ */
+function readEnvString(name) {
+    const value = String(process.env[name] || "").trim();
+    return value ? value : undefined;
+}
+/**
+ * 读取数字环境变量。
+ *
+ * 关键点（中文）
+ * - 解析失败返回 undefined，不抛错。
+ */
+function readEnvNumber(name) {
+    const raw = readEnvString(name);
+    if (!raw)
+        return undefined;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || Number.isNaN(parsed))
+        return undefined;
+    return parsed;
+}
+/**
+ * 解析 chat 上下文快照。
+ *
+ * 优先级（中文）
+ * 1) 显式参数
+ * 2) SessionRunScope（ALS）
+ * 3) 环境变量回退
+ */
+export function resolveChatSessionSnapshot(input) {
+    const requestCtx = getSessionRunScope();
+    const explicitSessionId = String(input?.sessionId || "").trim();
+    const explicitChatKey = String(input?.chatKey || "").trim();
+    const requestSessionId = typeof requestCtx?.sessionId === "string" && requestCtx.sessionId.trim()
+        ? requestCtx.sessionId.trim()
+        : undefined;
+    const envSessionId = readEnvString("DC_SESSION_ID");
+    const envChatKey = readEnvString("DC_CTX_CHAT_KEY");
+    const channel = readEnvString("DC_CTX_CHANNEL") || undefined;
+    const chatId = readEnvString("DC_CTX_TARGET_ID") || readEnvString("DC_CTX_CHAT_ID");
+    const messageThreadId = readEnvNumber("DC_CTX_THREAD_ID") ||
+        readEnvNumber("DC_CTX_MESSAGE_THREAD_ID");
+    const chatType = readEnvString("DC_CTX_TARGET_TYPE") ||
+        readEnvString("DC_CTX_CHAT_TYPE");
+    const userId = readEnvString("DC_CTX_ACTOR_ID") ||
+        readEnvString("DC_CTX_USER_ID");
+    const messageId = readEnvString("DC_CTX_MESSAGE_ID");
+    const sessionId = explicitSessionId ||
+        requestSessionId ||
+        envSessionId ||
+        explicitChatKey ||
+        envChatKey;
+    const chatKey = explicitChatKey ||
+        mapSessionIdToChatKey(sessionId) ||
+        envChatKey;
+    const snapshot = {
+        ...(sessionId ? { sessionId } : {}),
+        ...(chatKey ? { chatKey } : {}),
+        channel,
+        chatId,
+        messageThreadId,
+        chatType,
+        userId,
+        messageId,
+    };
+    return snapshot;
+}
+/**
+ * 将 sessionId 映射为可发送的 chatKey。
+ *
+ * 关键点（中文）
+ * - 当前实现下：chat service 内部把 sessionId 视作可发送 chatKey。
+ * - 不再依赖字符串规则推导（sessionId 可为随机值）。
+ */
+export function mapSessionIdToChatKey(sessionId) {
+    const key = String(sessionId || "").trim();
+    if (!key)
+        return undefined;
+    return key;
+}
+/**
+ * 提取最终 sessionId。
+ */
+export function resolveSessionId(input) {
+    const snapshot = resolveChatSessionSnapshot({
+        sessionId: input?.sessionId,
+        chatKey: input?.chatKey,
+        context: input?.context,
+    });
+    const key = String(snapshot.sessionId || "").trim();
+    return key ? key : undefined;
+}
+/**
+ * 提取最终 chatKey（用于发送路径）。
+ */
+export function resolveChatKey(input) {
+    const snapshot = resolveChatSessionSnapshot({
+        chatKey: input?.chatKey,
+        sessionId: input?.sessionId,
+        context: input?.context,
+    });
+    const key = String(snapshot.chatKey || "").trim();
+    return key ? key : undefined;
+}
+/**
+ * 解析当前发送应绑定的 reply messageId。
+ *
+ * 关键点（中文）
+ * - 只有显式 reply 且未手动传入 messageId 时才尝试补全。
+ * - 仅在目标 chatKey 与当前请求上下文一致时，才复用 `DC_CTX_MESSAGE_ID` / ALS 快照。
+ * - 这样可把一次 run 固定到触发它的那条消息，避免处理中被后续新消息覆盖。
+ */
+function resolveReplyMessageIdForChatSend(params) {
+    const explicitMessageId = typeof params.explicitMessageId === "string" && params.explicitMessageId.trim()
+        ? params.explicitMessageId.trim()
+        : undefined;
+    if (explicitMessageId)
+        return explicitMessageId;
+    if (params.replyToMessage !== true)
+        return undefined;
+    const snapshot = resolveChatSessionSnapshot({
+        context: params.context,
+    });
+    const snapshotChatKey = String(snapshot.chatKey || "").trim();
+    const snapshotMessageId = String(snapshot.messageId || "").trim();
+    if (!snapshotChatKey || !snapshotMessageId)
+        return undefined;
+    return snapshotChatKey === params.chatKey ? snapshotMessageId : undefined;
+}
+/**
+ * 规范化 `chat send` 文本。
+ *
+ * 关键点（中文）
+ * - 当文本只包含字面量转义（如 `\n`）且没有真实换行时，自动解码为真实控制字符。
+ * - 这样可兼容模型/脚本把多行文本写成 `\\n` 的场景，避免用户看到原样 `\n`。
+ */
+export function normalizeChatSendText(raw) {
+    const text = String(raw ?? "");
+    if (!text)
+        return text;
+    const hasRealLineBreak = text.includes("\n") || text.includes("\r");
+    let normalized = text;
+    if (!hasRealLineBreak &&
+        (text.includes("\\n") || text.includes("\\r") || text.includes("\\t"))) {
+        normalized = text
+            .replace(/\\r\\n/g, "\n")
+            .replace(/\\n/g, "\n")
+            .replace(/\\r/g, "\r")
+            .replace(/\\t/g, "\t");
+    }
+    return normalized;
+}
+/**
+ * 发送前延迟。
+ *
+ * 关键点（中文）
+ * - 支持延迟毫秒（delayMs）或绝对时间（sendAtMs）
+ * - 超长等待按分片 setTimeout，避免超出 Node 单次定时器上限
+ */
+function resolveTargetWaitMs(params) {
+    const delayMs = params.delayMs;
+    const sendAtMs = params.sendAtMs;
+    const rawWaitMs = typeof sendAtMs === "number" ? Math.max(0, sendAtMs - Date.now()) : delayMs;
+    if (!Number.isFinite(rawWaitMs) || Number.isNaN(rawWaitMs) || rawWaitMs <= 0)
+        return 0;
+    return Math.trunc(rawWaitMs);
+}
+async function waitByTimeoutChunks(waitMs) {
+    if (!Number.isFinite(waitMs) || Number.isNaN(waitMs) || waitMs <= 0)
+        return;
+    const MAX_TIMEOUT_MS = 2_147_483_647;
+    let remaining = Math.trunc(waitMs);
+    while (remaining > 0) {
+        const chunk = Math.min(remaining, MAX_TIMEOUT_MS);
+        await new Promise((resolve) => {
+            setTimeout(resolve, chunk);
+        });
+        remaining -= chunk;
+    }
+}
+async function waitBeforeSend(params) {
+    await waitByTimeoutChunks(resolveTargetWaitMs(params));
+}
+/**
+ * 按 chatKey 发送文本。
+ *
+ * 关键点（中文）
+ * - service 不关心具体平台；由 runtime sender 做 channel 分发。
+ * - 返回统一结构，便于上层链路做可观测与错误汇总。
+ */
+export async function sendChatTextByChatKey(params) {
+    const chatKey = String(params.chatKey || "").trim();
+    const text = normalizeChatSendText(String(params.text ?? ""));
+    const delayMs = typeof params.delayMs === "number" && Number.isFinite(params.delayMs)
+        ? Math.max(0, Math.trunc(params.delayMs))
+        : 0;
+    const sendAtMs = typeof params.sendAtMs === "number" && Number.isFinite(params.sendAtMs)
+        ? Math.max(0, Math.trunc(params.sendAtMs))
+        : undefined;
+    if (!chatKey) {
+        return {
+            success: false,
+            error: "Missing chatKey",
+        };
+    }
+    if (delayMs > 0 && typeof sendAtMs === "number") {
+        return {
+            success: false,
+            chatKey,
+            error: "delayMs and sendAtMs cannot be used together",
+        };
+    }
+    const replyToMessage = params.replyToMessage === true;
+    const messageId = resolveReplyMessageIdForChatSend({
+        context: params.context,
+        chatKey,
+        replyToMessage,
+        explicitMessageId: params.messageId,
+    });
+    const targetWaitMs = resolveTargetWaitMs({ delayMs, sendAtMs });
+    if (params.nonBlockingDelay === true && targetWaitMs > 0) {
+        // 关键点（中文）：异步调度延迟发送，让调用方可立即结束当前 run。
+        void (async () => {
+            try {
+                await waitByTimeoutChunks(targetWaitMs);
+                const delayed = await sendTextByChatKey({
+                    context: params.context,
+                    chatKey,
+                    text,
+                    replyToMessage,
+                    ...(messageId ? { messageId } : {}),
+                });
+                if (!delayed.success) {
+                    params.context.logger.warn("Delayed chat send failed", {
+                        chatKey,
+                        error: delayed.error || "chat send failed",
+                    });
+                }
+            }
+            catch (error) {
+                params.context.logger.warn("Delayed chat send failed", {
+                    chatKey,
+                    error: String(error),
+                });
+            }
+        })();
+        return {
+            success: true,
+            chatKey,
+        };
+    }
+    await waitBeforeSend({ delayMs, sendAtMs });
+    const result = await sendTextByChatKey({
+        context: params.context,
+        chatKey,
+        text,
+        replyToMessage,
+        ...(messageId ? { messageId } : {}),
+    });
+    return {
+        success: Boolean(result.success),
+        chatKey,
+        ...(result.success ? {} : { error: result.error || "chat send failed" }),
+    };
+}
+/**
+ * 按 chatKey 发送平台动作（typing/react）。
+ *
+ * 关键点（中文）
+ * - 动作分发与文本发送复用同一 chatKey 解析与 channel dispatcher。
+ */
+export async function sendChatActionByChatKey(params) {
+    const chatKey = String(params.chatKey || "").trim();
+    if (!chatKey) {
+        return {
+            success: false,
+            error: "Missing chatKey",
+        };
+    }
+    const result = await sendActionByChatKey({
+        context: params.context,
+        chatKey,
+        action: params.action,
+        messageId: params.messageId,
+        reactionEmoji: params.reactionEmoji,
+        reactionIsBig: params.reactionIsBig,
+    });
+    const messageId = String(params.messageId || "").trim();
+    return {
+        success: Boolean(result.success),
+        chatKey,
+        ...(messageId ? { messageId } : {}),
+        ...(result.success ? {} : { error: result.error || "chat action failed" }),
+    };
+}
+/**
+ * 按 sessionId 发送文本。
+ *
+ * 关键点（中文）
+ * - sessionId -> chatKey 映射关系只在 chat service 内部维护。
+ */
+export async function sendChatTextBySessionId(params) {
+    const sessionId = String(params.sessionId || "").trim();
+    if (!sessionId) {
+        return {
+            success: false,
+            sessionId: "",
+            error: "Missing sessionId",
+        };
+    }
+    const result = await sendChatTextByChatKey({
+        context: params.context,
+        chatKey: sessionId,
+        text: params.text,
+        delayMs: params.delayMs,
+        sendAtMs: params.sendAtMs,
+        replyToMessage: params.replyToMessage === true,
+        ...(typeof params.messageId === "string" && params.messageId.trim()
+            ? { messageId: params.messageId.trim() }
+            : {}),
+    });
+    return {
+        success: Boolean(result.success),
+        sessionId,
+        ...(result.success ? {} : { error: result.error || "chat send failed" }),
+    };
+}
+/**
+ * 按 chatKey/sessionId 彻底删除 chat 会话。
+ *
+ * 关键点（中文）
+ * - chatKey 与 sessionId 在 chat service 内部等价使用。
+ * - 删除包含：路由映射 + chat 审计目录 + session 目录 + 渠道状态清理。
+ */
+export async function deleteChatByChatKey(params) {
+    const chatKey = resolveChatKey({
+        context: params.context,
+        chatKey: params.chatKey,
+        sessionId: params.sessionId,
+    });
+    const sessionId = String(chatKey || "").trim();
+    if (!sessionId) {
+        return {
+            success: false,
+            error: "Missing chatKey/sessionId. Provide --chat-key or --session-id, or ensure DC_CTX_CHAT_KEY/DC_SESSION_ID is injected.",
+        };
+    }
+    const result = await deleteChatSessionById({
+        context: params.context,
+        sessionId,
+    });
+    return {
+        success: result.success,
+        sessionId: result.sessionId,
+        deleted: result.deleted,
+        removedMeta: result.removedMeta,
+        removedChatDir: result.removedChatDir,
+        removedSessionDir: result.removedSessionDir,
+        ...(result.success ? {} : { error: result.error || "chat delete failed" }),
+    };
+}
+//# sourceMappingURL=Action.js.map

package/bin/services/chat/Action.js.map

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

package/bin/services/chat/ChatService.d.ts

@@ -0,0 +1,63 @@
+/**
+ * ChatService：chat service 的类实现。
+ *
+ * 关键点（中文）
+ * - chat 的渠道 bot 状态归属于 ChatService 实例。
+ * - chat 的 queue worker 也归属于 ChatService 实例，而不是 agent 入口。
+ * - Index 只保留静态导出入口，这里承接真正的 service class 实现。
+ * - action 注册表已经拆到独立模块，当前文件只保留实例骨架。
+ */
+import type { AgentRuntime } from "../../types/agent/AgentRuntime.js";
+import { BaseService } from "../BaseService.js";
+import type { ServiceActions } from "../../shared/types/Service.js";
+import type { AgentContext } from "../../types/agent/AgentContext.js";
+import type { ChatChannelState } from "../../shared/types/ChatRuntime.js";
+import { ChatQueueWorker } from "./runtime/ChatQueueWorker.js";
+import { ChatQueueStore } from "./runtime/ChatQueueStore.js";
+/**
+ * Chat service 类实现。
+ */
+export declare class ChatService extends BaseService {
+    /**
+     * service 名称。
+     */
+    readonly name = "chat";
+    /**
+     * 当前实例持有的渠道状态。
+     */
+    readonly channelState: ChatChannelState;
+    /**
+     * 当前实例持有的 chat queue worker。
+     *
+     * 关键点（中文）
+     * - worker 生命周期与 chat service 保持一致。
+     * - 这样 agent 只负责装配，不直接持有 chat 领域长期状态。
+     */
+    queueWorker: ChatQueueWorker | null;
+    /**
+     * 当前实例持有的 chat queue store。
+     *
+     * 关键点（中文）
+     * - 这是 chat queue 状态的实例归属起点。
+     * - 迁移完成后，入队路径也会统一走这里，而不是模块级全局 queue。
+     */
+    readonly queueStore: ChatQueueStore;
+    /**
+     * 当前 service 的 system 文本构建器。
+     */
+    readonly system: (context: AgentContext) => Promise<string>;
+    /**
+     * 当前 service 的 action 定义表。
+     */
+    readonly actions: ServiceActions;
+    /**
+     * 启动当前实例的 queue worker。
+     */
+    private startQueueWorker;
+    /**
+     * 停止当前实例的 queue worker。
+     */
+    private stopQueueWorker;
+    constructor(agent: AgentRuntime | null);
+}
+//# sourceMappingURL=ChatService.d.ts.map

package/bin/services/chat/ChatService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatService.d.ts","sourceRoot":"","sources":["../../../src/services/chat/ChatService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOtE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACH,QAAQ,CAAC,IAAI,UAAU;IAEvB;;OAEG;IACH,SAAgB,YAAY,EAAE,gBAAgB,CAA4B;IAE1E;;;;;;OAMG;IACI,WAAW,EAAE,eAAe,GAAG,IAAI,CAAQ;IAElD;;;;;;OAMG;IACH,SAAgB,UAAU,iBAAwB;IAElD;;OAEG;IACH,QAAQ,CAAC,MAAM,GAAU,SAAS,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,CAE9D;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,eAAe;gBAOX,KAAK,EAAE,YAAY,GAAG,IAAI;CAgBvC"}

package/bin/services/chat/ChatService.js

@@ -0,0 +1,96 @@
+/**
+ * ChatService：chat service 的类实现。
+ *
+ * 关键点（中文）
+ * - chat 的渠道 bot 状态归属于 ChatService 实例。
+ * - chat 的 queue worker 也归属于 ChatService 实例，而不是 agent 入口。
+ * - Index 只保留静态导出入口，这里承接真正的 service class 实现。
+ * - action 注册表已经拆到独立模块，当前文件只保留实例骨架。
+ */
+import { BaseService } from "../BaseService.js";
+import { createChatChannelState, startChatChannels, stopChatChannels, } from "./runtime/ChatChannelFacade.js";
+import { createChatServiceActions } from "./runtime/ChatServiceActions.js";
+import { ChatQueueWorker } from "./runtime/ChatQueueWorker.js";
+import { buildChatServiceSystem } from "./runtime/ChatServiceSystem.js";
+import { ChatQueueStore } from "./runtime/ChatQueueStore.js";
+/**
+ * Chat service 类实现。
+ */
+export class ChatService extends BaseService {
+    /**
+     * service 名称。
+     */
+    name = "chat";
+    /**
+     * 当前实例持有的渠道状态。
+     */
+    channelState = createChatChannelState();
+    /**
+     * 当前实例持有的 chat queue worker。
+     *
+     * 关键点（中文）
+     * - worker 生命周期与 chat service 保持一致。
+     * - 这样 agent 只负责装配，不直接持有 chat 领域长期状态。
+     */
+    queueWorker = null;
+    /**
+     * 当前实例持有的 chat queue store。
+     *
+     * 关键点（中文）
+     * - 这是 chat queue 状态的实例归属起点。
+     * - 迁移完成后，入队路径也会统一走这里，而不是模块级全局 queue。
+     */
+    queueStore = new ChatQueueStore();
+    /**
+     * 当前 service 的 system 文本构建器。
+     */
+    system = async (context) => {
+        return await buildChatServiceSystem(context);
+    };
+    /**
+     * 当前 service 的 action 定义表。
+     */
+    actions;
+    /**
+     * 启动当前实例的 queue worker。
+     */
+    startQueueWorker(context) {
+        if (this.queueWorker)
+            return;
+        const worker = new ChatQueueWorker({
+            logger: context.logger,
+            context,
+            queueStore: this.queueStore,
+            config: context.config.services?.chat?.queue,
+        });
+        worker.start();
+        this.queueWorker = worker;
+    }
+    /**
+     * 停止当前实例的 queue worker。
+     */
+    stopQueueWorker() {
+        const worker = this.queueWorker;
+        this.queueWorker = null;
+        if (!worker)
+            return;
+        worker.stop();
+    }
+    constructor(agent) {
+        super(agent);
+        this.actions = createChatServiceActions({
+            channelState: this.channelState,
+        });
+        this.lifecycle = {
+            start: async (context) => {
+                this.startQueueWorker(context);
+                await startChatChannels(this.channelState, context);
+            },
+            stop: async () => {
+                this.stopQueueWorker();
+                await stopChatChannels(this.channelState);
+            },
+        };
+    }
+}
+//# sourceMappingURL=ChatService.js.map

package/bin/services/chat/ChatService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatService.js","sourceRoot":"","sources":["../../../src/services/chat/ChatService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAIvD,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACM,IAAI,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACa,YAAY,GAAqB,sBAAsB,EAAE,CAAC;IAE1E;;;;;;OAMG;IACI,WAAW,GAA2B,IAAI,CAAC;IAElD;;;;;;OAMG;IACa,UAAU,GAAG,IAAI,cAAc,EAAE,CAAC;IAElD;;OAEG;IACM,MAAM,GAAG,KAAK,EAAE,OAAqB,EAAmB,EAAE;QACjE,OAAO,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC;IAEF;;OAEG;IACM,OAAO,CAAiB;IAEjC;;OAEG;IACK,gBAAgB,CAAC,OAAqB;QAC5C,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK;SAC7C,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,YAAY,KAA0B;QACpC,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,wBAAwB,CAAC;YACtC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG;YACf,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBACvB,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBAC/B,MAAM,iBAAiB,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE;gBACf,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvB,MAAM,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC5C,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/bin/services/chat/Index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Chat Service 导出入口。
+ *
+ * 关键点（中文）
+ * - Index 只负责导出类实现。
+ * - 真正的类实现位于 `ChatService.ts`。
+ */
+export { ChatService } from "./ChatService.js";
+//# sourceMappingURL=Index.d.ts.map

package/bin/services/chat/Index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.d.ts","sourceRoot":"","sources":["../../../src/services/chat/Index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/services/chat/Index.js

@@ -0,0 +1,9 @@
+/**
+ * Chat Service 导出入口。
+ *
+ * 关键点（中文）
+ * - Index 只负责导出类实现。
+ * - 真正的类实现位于 `ChatService.ts`。
+ */
+export { ChatService } from "./ChatService.js";
+//# sourceMappingURL=Index.js.map

package/bin/services/chat/Index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.js","sourceRoot":"","sources":["../../../src/services/chat/Index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/services/chat/PROMPT.direct.txt

@@ -0,0 +1,55 @@
+# Chat Service 使用说明
+
+## 用户可见回复规则
+
+- 当前模式下，直接输出，即会发送消息给到用户对应的channel
+
+## 输出协议
+
+- 需要普通回复时，直接输出文本即可。文本顶部可用 frontmatter metadata (optional)，字段语义与 `city chat send` 保持一致：
+
+- `delay` / `delayMs`：延迟发送毫秒数。
+- `time` / `sendAt` / `sendAtMs`：定时发送时间。
+- `reply`：是否使用 reply 语义发送。
+- `messageId`：目标 `message_id`（群聊推荐）。
+- `react`：发送表情反应。
+  - 单个字符串：`react: "👍"`
+  - 或对象/数组：`emoji/big`
+  - 设置 `messageId` 时，`react` 会优先复用该消息作为目标消息。
+- 附件使用 `<file type="...">path</file>`（支持 `document/photo/voice/audio/video`）。
+- 附件路径必须是项目内可访问的相对路径。多附件可输出多个 `<file>` 标签。
+
+### 示例
+
+```text
+---
+reply: true
+messageId: "128"
+react:
+  - emoji: "✅"
+---
+这是今天的报告。
+<file type="document">reports/daily.md</file>
+```
+
+### 协议约束
+
+- frontmatter 必须位于文本最开头（`---` 包裹）。
+- 除 `<file>` 附件标签外，不要使用尖括号格式做控制参数。
+
+## 跨协议/跨平台操作
+
+- 当任务需要跨会话、跨平台或复杂路由，必须使用 `city chat send` / `city chat react`。
+- metadata 只适用于当前会话内的 direct 出站，不要拿 metadata 做跨 chat 路由。
+- 如果需要跨 chat 发送，或者不清楚怎么发送，直接先调用 `city chat --help` 查看方法。
+- 如不确定参数或正文协议，先自行调用：
+  - `city chat --help`
+  - `city chat send --help`
+  - `city chat react --help`
+
+## 入站消息结构（仅供内部理解）
+
+- 每条入队用户消息包含 `<info>...</info>` 元信息块 + 用户正文。
+- `<info>` 仅保留 user/request 元信息，例如 `user_id`、`username`、`message_id`、`permissions`、`received_at`。
+- 当前 chat 路由环境（例如 `channel`、`session_id`、`chat_key`、`chat_id`）会通过 system prompt 单独注入，不再混在 `<info>` 里。
+- `<info>` 不要原样回传给用户。