@downcity/plugins 1.0.4

package/bin/chat/runtime/ChatQueueWorker.js

@@ -0,0 +1,406 @@
+/**
+ * ChatQueueWorker：chat plugin runtime 侧队列执行器。
+ *
+ * 关键点（中文）
+ * - 消费 chat plugin runtime 持有的队列模块
+ * - 只负责把 lane 中的新输入持续提交给 `session.prompt()`
+ * - turn 并入策略、history 落盘、assistant 收敛统一交给 Session
+ */
+import { getSharedChatQueueStore, } from "./ChatQueue.js";
+import { getChatSender } from "./ChatSendRegistry.js";
+import { hasPersistedAssistantSteps, pickLastSuccessfulChatSendText, } from "@downcity/agent/internal/executor/messages/UserVisibleText.js";
+import { buildChannelErrorText, collectInitialBurstItems, normalizeChatQueueWorkerConfig, } from "./ChatQueueWorkerSupport.js";
+import { dispatchAssistantTextDirect, dispatchTextToChannel, } from "./ChatQueueReplyDispatch.js";
+const TYPING_ACTION_INTERVAL_MS = 4_000;
+export class ChatQueueWorker {
+    logger;
+    context;
+    config;
+    queueStore;
+    lanes = new Map();
+    runnable = [];
+    runnableSet = new Set();
+    runningTotal = 0;
+    unsubscribe;
+    stopped = false;
+    constructor(params) {
+        this.logger = params.logger;
+        this.context = params.context;
+        this.config = normalizeChatQueueWorkerConfig(params.config);
+        this.queueStore = params.queueStore || getSharedChatQueueStore();
+    }
+    /**
+     * 启动 worker。
+     */
+    start() {
+        if (this.unsubscribe)
+            return;
+        this.stopped = false;
+        this.unsubscribe = this.queueStore.onEnqueue((laneKey) => {
+            this.markRunnable(laneKey);
+            void this.requestTurnCancelIfSupported(laneKey);
+            void this.kick();
+        });
+        // 初始化已有 lanes
+        for (const laneKey of this.queueStore.listLanes()) {
+            this.markRunnable(laneKey);
+        }
+        void this.kick();
+    }
+    /**
+     * 停止 worker（不清队列）。
+     */
+    stop() {
+        this.stopped = true;
+        if (this.unsubscribe)
+            this.unsubscribe();
+        this.unsubscribe = undefined;
+    }
+    getOrCreateLane(key) {
+        const existing = this.lanes.get(key);
+        if (existing)
+            return existing;
+        const lane = {
+            key,
+            running: false,
+            turnObservers: new Map(),
+        };
+        this.lanes.set(key, lane);
+        return lane;
+    }
+    markRunnable(key) {
+        if (this.runnableSet.has(key))
+            return;
+        this.runnableSet.add(key);
+        this.runnable.push(key);
+    }
+    pickNextRunnableLane() {
+        while (this.runnable.length > 0) {
+            const key = this.runnable.shift();
+            this.runnableSet.delete(key);
+            const lane = this.getOrCreateLane(key);
+            if (lane.running)
+                continue;
+            if (this.queueStore.getLaneSize(key) === 0)
+                continue;
+            return lane;
+        }
+        return null;
+    }
+    async kick() {
+        if (this.stopped)
+            return;
+        while (this.runningTotal < this.config.maxConcurrency) {
+            const lane = this.pickNextRunnableLane();
+            if (!lane)
+                return;
+            lane.running = true;
+            this.runningTotal += 1;
+            void this.runLaneOnce(lane)
+                .catch((err) => {
+                this.logger.error(`ChatQueueWorker lane failed: ${String(err)}`);
+            })
+                .finally(() => {
+                lane.running = false;
+                this.runningTotal -= 1;
+                if (!this.stopped) {
+                    if (this.queueStore.getLaneSize(lane.key) > 0) {
+                        this.markRunnable(lane.key);
+                    }
+                    void this.kick();
+                }
+            });
+        }
+    }
+    async runLaneOnce(lane) {
+        const first = this.queueStore.shift(lane.key);
+        if (!first)
+            return;
+        await this.processOne(lane.key, first);
+    }
+    /**
+     * 若底层 runtime 支持取消当前 turn，则在新消息入队时立刻触发。
+     *
+     * 关键点（中文）
+     * - 只对支持显式取消的 runtime 生效（主要是 ACP）。
+     * - 失败不影响正常排队；worker 仍会走串行兜底。
+     */
+    async requestTurnCancelIfSupported(sessionId) {
+        const sessionKey = String(sessionId || "").trim();
+        if (!sessionKey)
+            return;
+        try {
+            // ACP executor removed; cancel is no longer supported through session executor port.
+        }
+        catch {
+            // ignore
+            return;
+            // ignore
+        }
+    }
+    handleControl(item) {
+        const control = item.control;
+        if (!control)
+            return false;
+        if (control.type === "clear") {
+            this.requireContext(item.sessionId).clearExecutor();
+            this.queueStore.clear(item.sessionId);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 在单次执行期间维持“正在输入”心跳。
+     *
+     * 关键点（中文）
+     * - 通过 chat plugin runtime 的 dispatcher 发送动作（不经过 main bindings）
+     * - 先发送一次，再按固定间隔续发
+     * - 发送失败不影响主执行流程（best-effort）
+     */
+    startTypingHeartbeat(item) {
+        const chatId = String(item.targetId || "").trim();
+        if (!chatId)
+            return { stop: () => { } };
+        const dispatcher = getChatSender(item.channel);
+        const sendAction = dispatcher?.sendAction;
+        if (typeof sendAction !== "function") {
+            return { stop: () => { } };
+        }
+        const sendOnce = async () => {
+            try {
+                await sendAction({
+                    chatId,
+                    action: "typing",
+                    ...(typeof item.threadId === "number"
+                        ? { messageThreadId: item.threadId }
+                        : {}),
+                    ...(typeof item.targetType === "string" && item.targetType
+                        ? { chatType: item.targetType }
+                        : {}),
+                    ...(typeof item.messageId === "string" && item.messageId
+                        ? { messageId: item.messageId }
+                        : {}),
+                });
+            }
+            catch {
+                // ignore
+            }
+        };
+        void sendOnce();
+        const timer = setInterval(() => {
+            void sendOnce();
+        }, TYPING_ACTION_INTERVAL_MS);
+        if (typeof timer.unref === "function")
+            timer.unref();
+        return {
+            stop: () => clearInterval(timer),
+        };
+    }
+    /**
+     * 发送 step 文本到 chat。
+     *
+     * 关键点（中文）
+     * - step 必须在当前回调阶段真正送达，不能依赖 run 结束后的 final 兜底。
+     * - 先尝试 direct 路径，保留 frontmatter / reaction 等语义。
+     * - 若 direct 未送达，则立刻回退到普通 channel 文本发送。
+     */
+    async dispatchAssistantStepMessage(params) {
+        const stepText = String(params.text || "").trim();
+        if (!stepText)
+            return false;
+        const dispatchedDirectly = await dispatchAssistantTextDirect({
+            logger: this.logger,
+            context: this.context,
+            sessionId: params.sessionId,
+            assistantText: stepText,
+            phase: "step",
+        });
+        if (dispatchedDirectly) {
+            return true;
+        }
+        return await dispatchTextToChannel({
+            logger: this.logger,
+            context: this.context,
+            sessionId: params.sessionId,
+            text: stepText,
+            messageId: params.messageId,
+            phase: "step",
+        });
+    }
+    async processOne(laneKey, first) {
+        const lane = this.getOrCreateLane(laneKey);
+        if (first.kind === "control") {
+            this.handleControl(first);
+            return;
+        }
+        if (first.kind === "audit") {
+            return;
+        }
+        const serviceContext = this.requireContext(first.sessionId);
+        this.ensureLaneSessionSubscription(lane, first.sessionId);
+        let clearRequested = false;
+        const initialBurstItems = await collectInitialBurstItems({
+            laneKey,
+            first,
+            config: this.config,
+            queueStore: this.queueStore,
+        });
+        for (const item of initialBurstItems) {
+            if (item.kind === "control") {
+                if (item.control?.type === "clear")
+                    clearRequested = true;
+                continue;
+            }
+            if (item.kind === "exec") {
+                await this.submitExecItem({
+                    lane,
+                    item,
+                    serviceContext,
+                });
+            }
+        }
+        if (clearRequested) {
+            serviceContext.clearExecutor();
+            this.queueStore.clear(first.sessionId);
+        }
+    }
+    ensureLaneSessionSubscription(lane, sessionId) {
+        if (lane.unsubscribeSessionEvents)
+            return;
+        const session = this.requireContext(sessionId);
+        lane.unsubscribeSessionEvents = session.subscribe((event) => {
+            void this.handleLaneSessionEvent(lane, event);
+        });
+    }
+    async handleLaneSessionEvent(lane, event) {
+        if (!("turnId" in event))
+            return;
+        const observation = lane.turnObservers.get(event.turnId);
+        if (!observation)
+            return;
+        if (event.type !== "assistant-step")
+            return;
+        if (event.visibility === "internal")
+            return;
+        const stepText = String(event.text || "").trim();
+        if (!stepText)
+            return;
+        const dispatched = await this.dispatchAssistantStepMessage({
+            sessionId: observation.sessionId,
+            text: stepText,
+            messageId: observation.messageId,
+        });
+        if (dispatched) {
+            observation.assistantStepDispatched = true;
+        }
+    }
+    async submitExecItem(params) {
+        const item = params.item;
+        try {
+            const turn = await params.serviceContext.prompt({
+                query: item.text,
+            });
+            if (params.lane.turnObservers.has(turn.id)) {
+                return;
+            }
+            const observation = {
+                turnId: turn.id,
+                sessionId: item.sessionId,
+                messageId: item.messageId,
+                assistantStepDispatched: false,
+                typing: this.startTypingHeartbeat(item),
+            };
+            params.lane.turnObservers.set(turn.id, observation);
+            void turn.finished
+                .then(async (result) => {
+                await this.handleObservedTurnFinish(observation, result);
+            })
+                .finally(() => {
+                observation.typing.stop();
+                params.lane.turnObservers.delete(turn.id);
+                if (params.lane.turnObservers.size === 0 &&
+                    this.queueStore.getLaneSize(params.lane.key) === 0 &&
+                    params.lane.unsubscribeSessionEvents) {
+                    params.lane.unsubscribeSessionEvents();
+                    params.lane.unsubscribeSessionEvents = undefined;
+                }
+            });
+        }
+        catch (error) {
+            const channelErrorText = buildChannelErrorText(error);
+            this.logger.error("ChatQueueWorker prompt submit failed", {
+                sessionId: item.sessionId,
+                error: String(error),
+            });
+            await dispatchTextToChannel({
+                logger: this.logger,
+                context: this.context,
+                sessionId: item.sessionId,
+                text: channelErrorText,
+                messageId: item.messageId,
+                phase: "error",
+            });
+        }
+    }
+    async handleObservedTurnFinish(observation, result) {
+        const stopReason = String(result.assistantMessage?.metadata?.extra?.stopReason || "").trim();
+        if (stopReason === "cancelled") {
+            return;
+        }
+        if (!result.success) {
+            const resultErrorText = pickLastSuccessfulChatSendText(result.assistantMessage) ||
+                result.error ||
+                "Execution failed";
+            const channelErrorText = buildChannelErrorText(resultErrorText);
+            this.logger.error("ChatQueueWorker turn finished with failure", {
+                sessionId: observation.sessionId,
+                error: result.error || resultErrorText,
+            });
+            await dispatchTextToChannel({
+                logger: this.logger,
+                context: this.context,
+                sessionId: observation.sessionId,
+                text: channelErrorText,
+                messageId: observation.messageId,
+                phase: "error",
+            });
+            return;
+        }
+        if (observation.assistantStepDispatched ||
+            hasPersistedAssistantSteps(result.assistantMessage)) {
+            return;
+        }
+        const finalAssistantText = pickLastSuccessfulChatSendText(result.assistantMessage) || result.text;
+        if (!finalAssistantText) {
+            return;
+        }
+        const dispatchedDirectly = await dispatchAssistantTextDirect({
+            logger: this.logger,
+            context: this.context,
+            sessionId: observation.sessionId,
+            assistantText: finalAssistantText,
+            phase: "final",
+        });
+        if (dispatchedDirectly) {
+            return;
+        }
+        await dispatchTextToChannel({
+            logger: this.logger,
+            context: this.context,
+            sessionId: observation.sessionId,
+            text: finalAssistantText,
+            messageId: observation.messageId,
+            phase: "final",
+        });
+    }
+    /**
+     * 读取 session 端口。
+     *
+     * 关键点（中文）
+     * - 在使用点显式校验，避免隐藏依赖来源。
+     */
+    requireContext(sessionId) {
+        return this.context.session.get(sessionId);
+    }
+}
+//# sourceMappingURL=ChatQueueWorker.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * ChatQueueWorkerSupport：chat queue worker 的通用辅助模块。
+ *
+ * 关键点（中文）
+ * - 收敛 burst merge、错误文本构造、worker 配置归一化等辅助逻辑。
+ * - 这些逻辑与 lane 调度主流程正交，拆出后让 ChatQueueWorker 更聚焦。
+ */
+import type { ChatQueueWorkerConfig } from "../../chat/types/ChatQueueWorker.js";
+import type { ChatQueueItem } from "../../chat/types/ChatQueue.js";
+import type { ChatQueueStorePort } from "./ChatQueueStore.js";
+/**
+ * 归一化 worker 配置。
+ */
+export declare function normalizeChatQueueWorkerConfig(input?: Partial<ChatQueueWorkerConfig>): ChatQueueWorkerConfig;
+/**
+ * 判断是否启用“启动前消息合并”。
+ */
+export declare function isBurstMergeEnabled(config: ChatQueueWorkerConfig): boolean;
+/**
+ * 判断是否为上游模型服务临时不可用。
+ */
+export declare function isTemporaryModelServiceUnavailable(error: unknown): boolean;
+/**
+ * 构造回发到 channel 的失败文本。
+ */
+export declare function buildChannelErrorText(error: unknown): string;
+/**
+ * 等待一小段时间，让同 lane 的连续消息尽量在一次 run 前合并。
+ */
+export declare function collectInitialBurstItems(params: {
+    laneKey: string;
+    first: ChatQueueItem;
+    config: ChatQueueWorkerConfig;
+    queueStore: ChatQueueStorePort;
+}): Promise<ChatQueueItem[]>;
+//# sourceMappingURL=ChatQueueWorkerSupport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatQueueWorkerSupport.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatQueueWorkerSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAO9D;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACrC,qBAAqB,CAmBvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAE1E;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS1E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmB5D;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,UAAU,EAAE,kBAAkB,CAAC;CAChC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAwC3B"}

package/bin/chat/runtime/ChatQueueWorkerSupport.js

@@ -0,0 +1,101 @@
+/**
+ * ChatQueueWorkerSupport：chat queue worker 的通用辅助模块。
+ *
+ * 关键点（中文）
+ * - 收敛 burst merge、错误文本构造、worker 配置归一化等辅助逻辑。
+ * - 这些逻辑与 lane 调度主流程正交，拆出后让 ChatQueueWorker 更聚焦。
+ */
+const CHANNEL_ERROR_TEXT_MAX_LENGTH = 480;
+const DEFAULT_MERGE_DEBOUNCE_MS = 600;
+const DEFAULT_MERGE_MAX_WAIT_MS = 2_000;
+const BURST_MERGE_POLL_INTERVAL_MS = 20;
+/**
+ * 归一化 worker 配置。
+ */
+export function normalizeChatQueueWorkerConfig(input) {
+    const maxConcurrency = typeof input?.maxConcurrency === "number" && Number.isFinite(input.maxConcurrency)
+        ? Math.max(1, Math.min(32, Math.floor(input.maxConcurrency)))
+        : 2;
+    const mergeDebounceMs = typeof input?.mergeDebounceMs === "number" &&
+        Number.isFinite(input.mergeDebounceMs)
+        ? Math.max(0, Math.min(60_000, Math.floor(input.mergeDebounceMs)))
+        : DEFAULT_MERGE_DEBOUNCE_MS;
+    const mergeMaxWaitMs = typeof input?.mergeMaxWaitMs === "number" &&
+        Number.isFinite(input.mergeMaxWaitMs)
+        ? Math.max(0, Math.min(120_000, Math.floor(input.mergeMaxWaitMs)))
+        : DEFAULT_MERGE_MAX_WAIT_MS;
+    return { maxConcurrency, mergeDebounceMs, mergeMaxWaitMs };
+}
+/**
+ * 判断是否启用“启动前消息合并”。
+ */
+export function isBurstMergeEnabled(config) {
+    return config.mergeDebounceMs > 0 && config.mergeMaxWaitMs > 0;
+}
+/**
+ * 判断是否为上游模型服务临时不可用。
+ */
+export function isTemporaryModelServiceUnavailable(error) {
+    const msg = String(error ?? "");
+    return (/Service temporarily unavailable/i.test(msg) ||
+        /AI_RetryError/i.test(msg) ||
+        /AI_APICallError/i.test(msg) ||
+        /maxRetriesExceeded/i.test(msg) ||
+        /\b503\b/.test(msg));
+}
+/**
+ * 构造回发到 channel 的失败文本。
+ */
+export function buildChannelErrorText(error) {
+    if (isTemporaryModelServiceUnavailable(error)) {
+        return "⚠️ 模型服务暂时不可用（503），系统已自动重试但仍失败，请稍后再试。";
+    }
+    const normalized = String(error ?? "").replace(/\s+/g, " ").trim();
+    if (/AI_NoOutputGeneratedError|No output generated/i.test(normalized)) {
+        return "❌ 模型本轮没有生成可发送内容。系统已记录底层 stream 错误，请稍后重试。";
+    }
+    if (!normalized) {
+        return "❌ 执行失败，请稍后重试。";
+    }
+    const clipped = normalized.length > CHANNEL_ERROR_TEXT_MAX_LENGTH
+        ? `${normalized.slice(0, CHANNEL_ERROR_TEXT_MAX_LENGTH)}…`
+        : normalized;
+    return `❌ 执行失败：${clipped}`;
+}
+/**
+ * 等待一小段时间，让同 lane 的连续消息尽量在一次 run 前合并。
+ */
+export async function collectInitialBurstItems(params) {
+    if (params.first.kind !== "exec")
+        return [params.first];
+    if (!isBurstMergeEnabled(params.config))
+        return [params.first];
+    const startedAt = Date.now();
+    let lastInboundAt = startedAt;
+    let knownLaneSize = params.queueStore.getLaneSize(params.laneKey);
+    while (true) {
+        const now = Date.now();
+        const idleMs = now - lastInboundAt;
+        const elapsedMs = now - startedAt;
+        if (idleMs >= params.config.mergeDebounceMs)
+            break;
+        if (elapsedMs >= params.config.mergeMaxWaitMs)
+            break;
+        const remainingDebounceMs = params.config.mergeDebounceMs - idleMs;
+        const remainingMaxWaitMs = params.config.mergeMaxWaitMs - elapsedMs;
+        const sleepMs = Math.max(1, Math.min(BURST_MERGE_POLL_INTERVAL_MS, remainingDebounceMs, remainingMaxWaitMs));
+        await new Promise((resolve) => {
+            const timer = setTimeout(resolve, sleepMs);
+            if (typeof timer.unref === "function")
+                timer.unref();
+        });
+        const laneSize = params.queueStore.getLaneSize(params.laneKey);
+        if (laneSize > knownLaneSize) {
+            knownLaneSize = laneSize;
+            lastInboundAt = Date.now();
+        }
+    }
+    const drained = params.queueStore.drain(params.laneKey);
+    return drained.length > 0 ? [params.first, ...drained] : [params.first];
+}
+//# sourceMappingURL=ChatQueueWorkerSupport.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * Chat send action 输入映射。
+ *
+ * 关键点（中文）
+ * - 专门处理 `chat send` 的 CLI/API payload 标准化。
+ * - frontmatter metadata 与 `<file>` 协议在这里转换为统一正文。
+ */
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+import type { PluginActionCommandInput } from "@downcity/agent/internal/plugin/types/Plugin.js";
+import type { ChatSendActionPayload } from "../../chat/types/ChatPluginActionPayload.js";
+/**
+ * 解析 `chat send` 的命令输入。
+ *
+ * 关键点（中文）
+ * - `--text / --stdin / --text-file` 三选一
+ * - 文本读取失败直接抛错，由上层统一输出
+ */
+export declare function mapChatSendCommandInput(input: PluginActionCommandInput): Promise<ChatSendActionPayload>;
+/**
+ * 解析 `chat send` 的 API 输入。
+ */
+export declare function mapChatSendApiInput(body: JsonValue): ChatSendActionPayload;
+//# sourceMappingURL=ChatSendActionInput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSendActionInput.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatSendActionInput.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAChG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAmIrF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA6DhC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,qBAAqB,CAoC1E"}