@downcity/plugins 1.0.4

package/bin/chat/runtime/ChatQueueReplyDispatch.js

@@ -0,0 +1,168 @@
+/**
+ * ChatQueueReplyDispatch：chat queue worker 的回复分发模块。
+ *
+ * 关键点（中文）
+ * - 收敛 direct / fallback 两类 channel 回发逻辑。
+ * - ChatQueueWorker 主类只保留“何时分发”的决策，不再承载具体发消息细节。
+ */
+import { parseDirectDispatchAssistantText } from "./DirectDispatchParser.js";
+import { sendActionByChatKey } from "./ChatkeySend.js";
+import { sendChatTextByChatKey } from "../Action.js";
+import { emitChatReplyEffect, prepareChatReplyText, resolveChatReplyTarget, } from "./ReplyDispatch.js";
+/**
+ * 把 assistant 纯文本直接投递到 chat。
+ */
+export async function dispatchAssistantTextDirect(params) {
+    const plan = parseDirectDispatchAssistantText({
+        assistantText: params.assistantText,
+        fallbackChatKey: params.sessionId,
+    });
+    if (!plan)
+        return false;
+    let textDispatchSucceeded = false;
+    if (plan.text) {
+        const target = await resolveChatReplyTarget({
+            context: params.context,
+            chatKey: plan.text.chatKey,
+        });
+        const preparedText = await prepareChatReplyText({
+            context: params.context,
+            input: {
+                chatKey: plan.text.chatKey,
+                ...(target.channel ? { channel: target.channel } : {}),
+                ...(typeof target.chatId === "string" ? { chatId: target.chatId } : {}),
+                ...(typeof plan.text.messageId === "string"
+                    ? { messageId: plan.text.messageId }
+                    : typeof target.messageId === "string"
+                        ? { messageId: target.messageId }
+                        : {}),
+                text: plan.text.text,
+                phase: params.phase || "final",
+                mode: "direct",
+            },
+        });
+        const textResult = await sendChatTextByChatKey({
+            context: params.context,
+            chatKey: plan.text.chatKey,
+            text: preparedText,
+            replyToMessage: plan.text.replyToMessage,
+            messageId: plan.text.messageId,
+            ...(typeof plan.text.delayMs === "number"
+                ? { delayMs: plan.text.delayMs }
+                : {}),
+            ...(typeof plan.text.sendAtMs === "number"
+                ? { sendAtMs: plan.text.sendAtMs }
+                : {}),
+        });
+        await emitChatReplyEffect({
+            context: params.context,
+            input: {
+                chatKey: plan.text.chatKey,
+                ...(target.channel ? { channel: target.channel } : {}),
+                ...(typeof target.chatId === "string" ? { chatId: target.chatId } : {}),
+                ...(typeof plan.text.messageId === "string"
+                    ? { messageId: plan.text.messageId }
+                    : typeof target.messageId === "string"
+                        ? { messageId: target.messageId }
+                        : {}),
+                text: preparedText,
+                phase: params.phase || "final",
+                mode: "direct",
+                success: textResult.success,
+                ...(textResult.success ? {} : { error: textResult.error || "chat send failed" }),
+            },
+        });
+        if (!textResult.success) {
+            params.logger.warn("Direct chat text dispatch failed", {
+                sessionId: params.sessionId,
+                targetChatKey: plan.text.chatKey,
+                error: textResult.error || "chat send failed",
+            });
+        }
+        else {
+            textDispatchSucceeded = true;
+        }
+    }
+    for (const reaction of plan.reactions) {
+        const reactResult = await sendActionByChatKey({
+            context: params.context,
+            chatKey: reaction.chatKey,
+            action: "react",
+            messageId: reaction.messageId,
+            reactionEmoji: reaction.emoji,
+            reactionIsBig: reaction.big,
+        });
+        if (!reactResult.success) {
+            params.logger.warn("Direct chat reaction dispatch failed", {
+                sessionId: params.sessionId,
+                targetChatKey: reaction.chatKey,
+                error: reactResult.error || "chat react failed",
+            });
+        }
+    }
+    return textDispatchSucceeded;
+}
+/**
+ * 强制把文本回发到 channel。
+ */
+export async function dispatchTextToChannel(params) {
+    const text = String(params.text || "").trim();
+    if (!text)
+        return false;
+    const target = await resolveChatReplyTarget({
+        context: params.context,
+        chatKey: params.sessionId,
+    });
+    const preparedText = await prepareChatReplyText({
+        context: params.context,
+        input: {
+            chatKey: params.sessionId,
+            ...(target.channel ? { channel: target.channel } : {}),
+            ...(typeof target.chatId === "string" ? { chatId: target.chatId } : {}),
+            ...(typeof params.messageId === "string"
+                ? { messageId: params.messageId }
+                : typeof target.messageId === "string"
+                    ? { messageId: target.messageId }
+                    : {}),
+            text,
+            phase: params.phase || "final",
+            mode: "fallback",
+        },
+    });
+    const result = await sendChatTextByChatKey({
+        context: params.context,
+        chatKey: params.sessionId,
+        text: preparedText,
+        replyToMessage: true,
+        ...(typeof params.messageId === "string" && params.messageId
+            ? { messageId: params.messageId }
+            : {}),
+    });
+    await emitChatReplyEffect({
+        context: params.context,
+        input: {
+            chatKey: params.sessionId,
+            ...(target.channel ? { channel: target.channel } : {}),
+            ...(typeof target.chatId === "string" ? { chatId: target.chatId } : {}),
+            ...(typeof params.messageId === "string"
+                ? { messageId: params.messageId }
+                : typeof target.messageId === "string"
+                    ? { messageId: target.messageId }
+                    : {}),
+            text: preparedText,
+            phase: params.phase || "final",
+            mode: "fallback",
+            success: result.success,
+            ...(result.success ? {} : { error: result.error || "chat send failed" }),
+        },
+    });
+    if (!result.success) {
+        params.logger.warn("ChatQueueWorker forced channel dispatch failed", {
+            sessionId: params.sessionId,
+            error: result.error || "chat send failed",
+        });
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=ChatQueueReplyDispatch.js.map

package/bin/chat/runtime/ChatQueueReplyDispatch.js.map

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

package/bin/chat/runtime/ChatQueueStore.d.ts

@@ -0,0 +1,85 @@
+/**
+ * ChatQueueStore：chat plugin runtime 队列存储。
+ *
+ * 关键点（中文）
+ * - 这是 chat queue 的实例级状态容器。
+ * - 允许 `ChatPlugin` 持有自己的 queue store，而不是完全依赖模块级全局状态。
+ * - 旧的 `ChatQueue.ts` 会保留共享门面，逐步迁移到显式实例注入。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatQueueEnqueueParams, ChatQueueEnqueueResult, ChatQueueItem } from "../../chat/types/ChatQueue.js";
+/**
+ * 入队监听器。
+ */
+export type ChatQueueEnqueueListener = (laneKey: string) => void;
+/**
+ * ChatPlugin queue store 的最小能力接口。
+ */
+export interface ChatQueueStorePort {
+    /**
+     * 订阅入队事件。
+     */
+    onEnqueue(listener: ChatQueueEnqueueListener): () => void;
+    /**
+     * 入队。
+     */
+    enqueue(params: ChatQueueEnqueueParams): ChatQueueEnqueueResult;
+    /**
+     * 弹出一条队列项。
+     */
+    shift(laneKey: string): ChatQueueItem | null;
+    /**
+     * drain 指定 lane。
+     */
+    drain(laneKey: string, maxItems?: number): ChatQueueItem[];
+    /**
+     * 列出当前 lane keys。
+     */
+    listLanes(): string[];
+    /**
+     * 查询某个 lane 的长度。
+     */
+    getLaneSize(laneKey: string): number;
+    /**
+     * 清空某个 lane。
+     */
+    clear(laneKey: string): void;
+}
+/**
+ * 共享 queue store。
+ *
+ * 关键点（中文）
+ * - 迁移阶段仍保留一份共享实例，避免一次性改动所有旧入口。
+ * - 新代码应优先通过 `AgentContext.agent` 解析显式 queue store。
+ */
+/**
+ * Chat queue 实例级存储。
+ */
+export declare class ChatQueueStore implements ChatQueueStorePort {
+    private readonly lanes;
+    private readonly listeners;
+    private nextSeq;
+    private generateItemId;
+    private getLane;
+    private normalizeLaneKey;
+    onEnqueue(listener: ChatQueueEnqueueListener): () => void;
+    enqueue(params: ChatQueueEnqueueParams): ChatQueueEnqueueResult;
+    shift(laneKey: string): ChatQueueItem | null;
+    drain(laneKey: string, maxItems?: number): ChatQueueItem[];
+    listLanes(): string[];
+    getLaneSize(laneKey: string): number;
+    clear(laneKey: string): void;
+}
+/**
+ * 读取共享 chat queue store。
+ */
+export declare function getSharedChatQueueStore(): ChatQueueStore;
+/**
+ * 从运行时解析 chat queue store。
+ *
+ * 关键点（中文）
+ * - 新路径优先读取 `runtime.agent.pluginInstances.chat.queueStore`。
+ * - 迁移阶段若拿不到，则回退到共享 queue store，保证旧入口可继续工作。
+ */
+export declare function resolveChatQueueStore(runtime?: AgentContext): ChatQueueStorePort;
+//# sourceMappingURL=ChatQueueStore.d.ts.map

package/bin/chat/runtime/ChatQueueStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatQueueStore.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatQueueStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACd,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI,CAAC;IAC1D;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,CAAC;IAChE;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IAC7C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAC3D;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH;;GAEG;AACH,qBAAa,cAAe,YAAW,kBAAkB;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IACtE,OAAO,CAAC,OAAO,CAAK;IAEpB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,gBAAgB;IAMxB,SAAS,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAOzD,OAAO,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB;IAuB/D,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAS5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAa1D,SAAS,IAAI,MAAM,EAAE;IAIrB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAOpC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAK7B;AAID;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,kBAAkB,CAQhF"}

package/bin/chat/runtime/ChatQueueStore.js

@@ -0,0 +1,130 @@
+/**
+ * ChatQueueStore：chat plugin runtime 队列存储。
+ *
+ * 关键点（中文）
+ * - 这是 chat queue 的实例级状态容器。
+ * - 允许 `ChatPlugin` 持有自己的 queue store，而不是完全依赖模块级全局状态。
+ * - 旧的 `ChatQueue.ts` 会保留共享门面，逐步迁移到显式实例注入。
+ */
+/**
+ * 共享 queue store。
+ *
+ * 关键点（中文）
+ * - 迁移阶段仍保留一份共享实例，避免一次性改动所有旧入口。
+ * - 新代码应优先通过 `AgentContext.agent` 解析显式 queue store。
+ */
+/**
+ * Chat queue 实例级存储。
+ */
+export class ChatQueueStore {
+    lanes = new Map();
+    listeners = new Set();
+    nextSeq = 1;
+    generateItemId() {
+        const seq = this.nextSeq;
+        this.nextSeq += 1;
+        return `q:${Date.now().toString(36)}:${seq.toString(36)}`;
+    }
+    getLane(key) {
+        const lane = this.lanes.get(key);
+        if (lane)
+            return lane;
+        const created = [];
+        this.lanes.set(key, created);
+        return created;
+    }
+    normalizeLaneKey(raw) {
+        const key = String(raw || "").trim();
+        if (!key)
+            throw new Error("ChatQueueStore requires a non-empty lane key");
+        return key;
+    }
+    onEnqueue(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    enqueue(params) {
+        const laneKey = this.normalizeLaneKey(params.sessionId);
+        const lane = this.getLane(laneKey);
+        const item = {
+            ...params,
+            id: this.generateItemId(),
+            enqueuedAt: Date.now(),
+            kind: params.kind ?? "exec",
+        };
+        lane.push(item);
+        for (const listener of this.listeners) {
+            try {
+                listener(laneKey);
+            }
+            catch {
+                // ignore listener failure
+            }
+        }
+        return {
+            lanePosition: lane.length,
+            itemId: item.id,
+        };
+    }
+    shift(laneKey) {
+        const key = this.normalizeLaneKey(laneKey);
+        const lane = this.lanes.get(key);
+        if (!lane || lane.length === 0)
+            return null;
+        const item = lane.shift() || null;
+        if (lane.length === 0)
+            this.lanes.delete(key);
+        return item;
+    }
+    drain(laneKey, maxItems) {
+        const key = this.normalizeLaneKey(laneKey);
+        const lane = this.lanes.get(key);
+        if (!lane || lane.length === 0)
+            return [];
+        if (typeof maxItems === "number" && maxItems > 0 && maxItems < lane.length) {
+            return lane.splice(0, Math.floor(maxItems));
+        }
+        this.lanes.delete(key);
+        return lane.splice(0, lane.length);
+    }
+    listLanes() {
+        return Array.from(this.lanes.keys());
+    }
+    getLaneSize(laneKey) {
+        const key = String(laneKey || "").trim();
+        if (!key)
+            return 0;
+        const lane = this.lanes.get(key);
+        return lane ? lane.length : 0;
+    }
+    clear(laneKey) {
+        const key = String(laneKey || "").trim();
+        if (!key)
+            return;
+        this.lanes.delete(key);
+    }
+}
+const sharedChatQueueStore = new ChatQueueStore();
+/**
+ * 读取共享 chat queue store。
+ */
+export function getSharedChatQueueStore() {
+    return sharedChatQueueStore;
+}
+/**
+ * 从运行时解析 chat queue store。
+ *
+ * 关键点（中文）
+ * - 新路径优先读取 `runtime.agent.pluginInstances.chat.queueStore`。
+ * - 迁移阶段若拿不到，则回退到共享 queue store，保证旧入口可继续工作。
+ */
+export function resolveChatQueueStore(runtime) {
+    const chatService = runtime?.agent?.pluginInstances?.get?.("chat");
+    if (chatService?.queueStore) {
+        return chatService.queueStore;
+    }
+    return sharedChatQueueStore;
+}
+//# sourceMappingURL=ChatQueueStore.js.map

package/bin/chat/runtime/ChatQueueStore.js.map

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

package/bin/chat/runtime/ChatQueueWorker.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ChatQueueWorker：chat plugin runtime 侧队列执行器。
+ *
+ * 关键点（中文）
+ * - 消费 chat plugin runtime 持有的队列模块
+ * - 只负责把 lane 中的新输入持续提交给 `session.prompt()`
+ * - turn 并入策略、history 落盘、assistant 收敛统一交给 Session
+ */
+import type { Logger } from "@downcity/agent/internal/utils/logger/Logger.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatQueueWorkerConfig } from "../../chat/types/ChatQueueWorker.js";
+import type { ChatQueueStorePort } from "./ChatQueueStore.js";
+export declare class ChatQueueWorker {
+    private readonly logger;
+    private readonly context;
+    private readonly config;
+    private readonly queueStore;
+    private readonly lanes;
+    private readonly runnable;
+    private readonly runnableSet;
+    private runningTotal;
+    private unsubscribe?;
+    private stopped;
+    constructor(params: {
+        logger: Logger;
+        context: AgentContext;
+        queueStore?: ChatQueueStorePort;
+        config?: Partial<ChatQueueWorkerConfig>;
+    });
+    /**
+     * 启动 worker。
+     */
+    start(): void;
+    /**
+     * 停止 worker（不清队列）。
+     */
+    stop(): void;
+    private getOrCreateLane;
+    private markRunnable;
+    private pickNextRunnableLane;
+    private kick;
+    private runLaneOnce;
+    /**
+     * 若底层 runtime 支持取消当前 turn，则在新消息入队时立刻触发。
+     *
+     * 关键点（中文）
+     * - 只对支持显式取消的 runtime 生效（主要是 ACP）。
+     * - 失败不影响正常排队；worker 仍会走串行兜底。
+     */
+    private requestTurnCancelIfSupported;
+    private handleControl;
+    /**
+     * 在单次执行期间维持“正在输入”心跳。
+     *
+     * 关键点（中文）
+     * - 通过 chat plugin runtime 的 dispatcher 发送动作（不经过 main bindings）
+     * - 先发送一次，再按固定间隔续发
+     * - 发送失败不影响主执行流程（best-effort）
+     */
+    private startTypingHeartbeat;
+    /**
+     * 发送 step 文本到 chat。
+     *
+     * 关键点（中文）
+     * - step 必须在当前回调阶段真正送达，不能依赖 run 结束后的 final 兜底。
+     * - 先尝试 direct 路径，保留 frontmatter / reaction 等语义。
+     * - 若 direct 未送达，则立刻回退到普通 channel 文本发送。
+     */
+    private dispatchAssistantStepMessage;
+    private processOne;
+    private ensureLaneSessionSubscription;
+    private handleLaneSessionEvent;
+    private submitExecItem;
+    private handleObservedTurnFinish;
+    /**
+     * 读取 session 端口。
+     *
+     * 关键点（中文）
+     * - 在使用点显式校验，避免隐藏依赖来源。
+     */
+    private requireContext;
+}
+//# sourceMappingURL=ChatQueueWorker.d.ts.map

package/bin/chat/runtime/ChatQueueWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatQueueWorker.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatQueueWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iDAAiD,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAiB7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAuB9D,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,YAAY,CAAC;QACtB,UAAU,CAAC,EAAE,kBAAkB,CAAC;QAChC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;KACzC;IAOD;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAMZ,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,oBAAoB;YAYd,IAAI;YAyBJ,WAAW;IAMzB;;;;;;OAMG;YACW,4BAA4B;IAa1C,OAAO,CAAC,aAAa;IAWrB;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAyC5B;;;;;;;OAOG;YACW,4BAA4B;YA6B5B,UAAU;IAyCxB,OAAO,CAAC,6BAA6B;YAWvB,sBAAsB;YAqBtB,cAAc;YAsDd,wBAAwB;IAkEtC;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAGvB"}