@downcity/agent 1.1.1

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

@@ -0,0 +1,36 @@
+/**
+ * ChatQueueWorkerSupport：chat queue worker 的通用辅助模块。
+ *
+ * 关键点（中文）
+ * - 收敛 burst merge、错误文本构造、worker 配置归一化等辅助逻辑。
+ * - 这些逻辑与 lane 调度主流程正交，拆出后让 ChatQueueWorker 更聚焦。
+ */
+import type { ChatQueueWorkerConfig } from "../../../shared/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/services/chat/runtime/ChatQueueWorkerSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatQueueWorkerSupport.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/runtime/ChatQueueWorkerSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,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/services/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/services/chat/runtime/ChatQueueWorkerSupport.js.map

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

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

@@ -0,0 +1,20 @@
+/**
+ * Chat send frontmatter metadata 解析工具。
+ *
+ * 关键点（中文）
+ * - frontmatter 中的字段语义与 `city chat send` 参数保持一致。
+ * - direct 模式也复用同一解析逻辑，避免 metadata 协议分叉。
+ */
+import type { ChatMessageSendOptions } from "../../chat/types/ChatMessageMarkup.js";
+/**
+ * 从 frontmatter metadata 中解析发送参数。
+ *
+ * 说明（中文）
+ * - `strict=true` 时，非法 delay/time 会直接抛错，适用于 CLI/API 输入。
+ * - `strict=false` 时，非法字段会被忽略，适用于 direct 模式的宽容解析。
+ */
+export declare function parseChatSendOptionsFromMetadata(params: {
+    metadata: Record<string, unknown>;
+    strict?: boolean;
+}): ChatMessageSendOptions;
+//# sourceMappingURL=ChatSendMetadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSendMetadata.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/runtime/ChatSendMetadata.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AA8GxF;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,sBAAsB,CAyCzB"}

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

@@ -0,0 +1,130 @@
+/**
+ * Chat send frontmatter metadata 解析工具。
+ *
+ * 关键点（中文）
+ * - frontmatter 中的字段语义与 `city chat send` 参数保持一致。
+ * - direct 模式也复用同一解析逻辑，避免 metadata 协议分叉。
+ */
+function normalizeText(value) {
+    return String(value ?? "").trim();
+}
+function pickMetadataValue(metadata, keys) {
+    for (const key of keys) {
+        if (Object.hasOwn(metadata, key)) {
+            return metadata[key];
+        }
+    }
+    return undefined;
+}
+function parseBoolean(value) {
+    if (typeof value === "boolean")
+        return value;
+    const text = normalizeText(value).toLowerCase();
+    if (!text)
+        return undefined;
+    if (text === "true" || text === "1" || text === "yes")
+        return true;
+    if (text === "false" || text === "0" || text === "no")
+        return false;
+    return undefined;
+}
+function parseOptionalMessageId(value) {
+    if (typeof value === "number" && Number.isFinite(value) && !Number.isNaN(value)) {
+        const text = String(Math.trunc(value)).trim();
+        return text ? text : undefined;
+    }
+    if (typeof value === "string") {
+        const text = value.trim();
+        return text ? text : undefined;
+    }
+    return undefined;
+}
+function looksLikeIsoDatetimeWithoutTimezone(value) {
+    const text = String(value || "").trim();
+    if (!text)
+        return false;
+    const isoLike = /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}/.test(text);
+    if (!isoLike)
+        return false;
+    return !/(?:Z|[+-]\d{2}:\d{2})$/i.test(text);
+}
+function parseNonNegativeInt(value, fieldName, strict) {
+    const text = normalizeText(value);
+    if (!text)
+        return undefined;
+    if (!/^\d+$/.test(text)) {
+        if (strict) {
+            throw new Error(`Invalid ${fieldName}: ${String(value)}`);
+        }
+        return undefined;
+    }
+    const parsed = Number.parseInt(text, 10);
+    if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed < 0) {
+        if (strict) {
+            throw new Error(`Invalid ${fieldName}: ${String(value)}`);
+        }
+        return undefined;
+    }
+    return parsed;
+}
+function parseSendAtMs(value, fieldName, strict) {
+    const text = normalizeText(value);
+    if (!text)
+        return undefined;
+    if (/^\d+$/.test(text)) {
+        const parsed = Number.parseInt(text, 10);
+        if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed <= 0) {
+            if (strict) {
+                throw new Error(`Invalid ${fieldName}: ${String(value)}`);
+            }
+            return undefined;
+        }
+        return parsed < 1_000_000_000_000 ? parsed * 1000 : parsed;
+    }
+    if (looksLikeIsoDatetimeWithoutTimezone(text)) {
+        if (strict) {
+            throw new Error(`Invalid ${fieldName}: ${String(value)}. ISO datetime must include timezone offset (e.g. +08:00 or Z).`);
+        }
+        return undefined;
+    }
+    const parsed = Date.parse(text);
+    if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed <= 0) {
+        if (strict) {
+            throw new Error(`Invalid ${fieldName}: ${String(value)}. Use Unix timestamp (seconds/ms) or ISO datetime.`);
+        }
+        return undefined;
+    }
+    return parsed;
+}
+/**
+ * 从 frontmatter metadata 中解析发送参数。
+ *
+ * 说明（中文）
+ * - `strict=true` 时，非法 delay/time 会直接抛错，适用于 CLI/API 输入。
+ * - `strict=false` 时，非法字段会被忽略，适用于 direct 模式的宽容解析。
+ */
+export function parseChatSendOptionsFromMetadata(params) {
+    const metadata = params.metadata && typeof params.metadata === "object" && !Array.isArray(params.metadata)
+        ? params.metadata
+        : {};
+    const strict = params.strict === true;
+    const chatKey = normalizeText(pickMetadataValue(metadata, ["chatKey", "chat-key"]));
+    const delayMs = parseNonNegativeInt(pickMetadataValue(metadata, ["delayMs", "delay-ms", "delay"]), "delay", strict);
+    const sendAtMs = parseSendAtMs(pickMetadataValue(metadata, ["sendAtMs", "send-at-ms", "sendAt", "send-at", "time"]), "time", strict);
+    if (typeof delayMs === "number" && typeof sendAtMs === "number") {
+        throw new Error("`delay` and `time` cannot be used together.");
+    }
+    const explicitMessageId = parseOptionalMessageId(pickMetadataValue(metadata, ["messageId", "message-id"]));
+    const replyRaw = pickMetadataValue(metadata, ["reply"]);
+    const replyAsBoolean = parseBoolean(replyRaw);
+    const replyAsMessageId = explicitMessageId || (replyAsBoolean === undefined ? parseOptionalMessageId(replyRaw) : undefined);
+    const replyToMessage = replyAsBoolean === true || typeof replyAsMessageId === "string";
+    return {
+        ...(chatKey ? { chatKey } : {}),
+        ...(typeof delayMs === "number" ? { delayMs } : {}),
+        ...(typeof sendAtMs === "number" ? { sendAtMs } : {}),
+        ...(replyToMessage ? { replyToMessage: true } : {}),
+        ...(typeof replyAsMessageId === "string" ? { messageId: replyAsMessageId } : {}),
+    };
+}
+//# sourceMappingURL=ChatSendMetadata.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * Chat egress dispatcher registry（按 channel 路由回包能力）。
+ *
+ * 关键点（中文）
+ * - tool（如 `chat_send`）通过 dispatcher 把消息发回对应平台
+ * - dispatcher 本身不关心 chatKey/history，只关心“怎么把一段 text 发出去”
+ */
+import type { ChatDispatchChannel, ChatDispatcher } from "../../chat/types/ChatDispatcher.js";
+/**
+ * 注册 channel -> dispatcher 映射。
+ *
+ * 约束（中文）
+ * - 同一 channel 重复注册时以后者覆盖，便于 server 启动阶段统一重建。
+ */
+export declare function registerChatSender(channel: ChatDispatchChannel, dispatcher: ChatDispatcher): void;
+/**
+ * 移除 channel 的 dispatcher 映射。
+ *
+ * 关键点（中文）
+ * - 主要用于测试场景回收全局注册状态。
+ */
+export declare function unregisterChatSender(channel: ChatDispatchChannel): void;
+/**
+ * 获取指定 channel 的 dispatcher。
+ */
+export declare function getChatSender(channel: ChatDispatchChannel): ChatDispatcher | undefined;
+//# sourceMappingURL=ChatSendRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSendRegistry.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/runtime/ChatSendRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,wCAAwC,CAAC;AAIhD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,cAAc,GACzB,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,GAAG,SAAS,CAEtF"}

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

@@ -0,0 +1,26 @@
+const dispatchers = new Map();
+/**
+ * 注册 channel -> dispatcher 映射。
+ *
+ * 约束（中文）
+ * - 同一 channel 重复注册时以后者覆盖，便于 server 启动阶段统一重建。
+ */
+export function registerChatSender(channel, dispatcher) {
+    dispatchers.set(channel, dispatcher);
+}
+/**
+ * 移除 channel 的 dispatcher 映射。
+ *
+ * 关键点（中文）
+ * - 主要用于测试场景回收全局注册状态。
+ */
+export function unregisterChatSender(channel) {
+    dispatchers.delete(channel);
+}
+/**
+ * 获取指定 channel 的 dispatcher。
+ */
+export function getChatSender(channel) {
+    return dispatchers.get(channel);
+}
+//# sourceMappingURL=ChatSendRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSendRegistry.js","sourceRoot":"","sources":["../../../../src/services/chat/runtime/ChatSendRegistry.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,GAAG,IAAI,GAAG,EAAuC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA4B,EAC5B,UAA0B;IAE1B,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAC/D,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAA4B;IACxD,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * ChatServiceActions：chat service 的 action 注册表模块。
+ *
+ * 关键点（中文）
+ * - 这里专门负责把 chat 的 CLI/API/execute 定义装配成 `ServiceActions`。
+ * - ChatService 本体只保留实例状态与 lifecycle，不再承载大段 action 声明。
+ * - action 执行仍然复用各 runtime 模块，确保行为与现有实现保持一致。
+ */
+import type { ServiceActions } from "../../../shared/types/Service.js";
+import type { ChatChannelState } from "../../../shared/types/ChatRuntime.js";
+/**
+ * 创建 chat service 的 action 定义表。
+ */
+export declare function createChatServiceActions(params: {
+    channelState: ChatChannelState;
+}): ServiceActions;
+//# sourceMappingURL=ChatServiceActions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatServiceActions.d.ts","sourceRoot":"","sources":["../../../../src/services/chat/runtime/ChatServiceActions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAkBhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA8EtE;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,YAAY,EAAE,gBAAgB,CAAC;CAChC,GAAG,cAAc,CAoXjB"}