@downcity/agent 1.1.32 → 1.1.43

package/bin/executor/core-engine/CoreEngineLoopDecision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreEngineLoopDecision.js","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineLoopDecision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;;;;;GAQG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAA+B;IAE/B,IACE,KAAK,CAAC,qBAAqB;QAC3B,KAAK,CAAC,uBAAuB,GAAG,KAAK,CAAC,uBAAuB,EAC7D,CAAC;QACD,OAAO;YACL,IAAI,EAAE,oBAAoB;YAC1B,oBAAoB,EAAE,KAAK;YAC3B,mBAAmB,EAAE,KAAK;YAC1B,6BAA6B,EAAE,IAAI;SACpC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,yBAAyB;YAC/B,oBAAoB,EAAE,IAAI;YAC1B,mBAAmB,EAAE,KAAK;YAC1B,6BAA6B,EAAE,KAAK;SACrC,CAAC;IACJ,CAAC;IAED,IACE,KAAK,CAAC,0BAA0B,KAAK,IAAI;QACzC,KAAK,CAAC,QAAQ;QACd,KAAK,CAAC,yBAAyB,GAAG,KAAK,CAAC,wBAAwB,EAChE,CAAC;QACD,OAAO;YACL,IAAI,EAAE,wBAAwB;YAC9B,oBAAoB,EAAE,KAAK;YAC3B,mBAAmB,EAAE,IAAI;YACzB,6BAA6B,EAAE,KAAK;SACrC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,oBAAoB,EAAE,KAAK;QAC3B,mBAAmB,EAAE,KAAK;QAC1B,6BAA6B,EAAE,KAAK;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uCAAuC,CACrD,KAAwC;IAExC,OAAO,KAAK,CAAC,sBAAsB,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/bin/executor/core-engine/CoreEngineMessageState.d.ts

@@ -0,0 +1,63 @@
+/**
+ * CoreEngine 模型消息运行态。
+ *
+ * 关键点（中文）
+ * - CoreEngine 同时维护 session 语义消息与模型消息。
+ * - 新增 user 消息可优先做增量转换，失败时再回退为全量重算。
+ * - assistant UI 消息只需要进入 session 语义基线；模型侧使用 SDK 返回的 response messages。
+ */
+import type { ModelMessage, Tool } from "ai";
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+/**
+ * CoreEngine 单轮执行期间的消息基线。
+ */
+export declare class CoreEngineMessageState {
+    /**
+     * 当前运行时 session 语义消息。
+     */
+    private sessionMessages;
+    /**
+     * 当前模型侧消息基线。
+     */
+    private currentModelMessages;
+    /**
+     * 当前轮可用工具集合。
+     */
+    private readonly tools;
+    private constructor();
+    /**
+     * 基于初始 session 消息创建运行态。
+     */
+    static create(params: {
+        /**
+         * 初始 session 语义消息。
+         */
+        messages: SessionMessageV1[];
+        /**
+         * 当前轮可用工具集合。
+         */
+        tools: Record<string, Tool>;
+    }): Promise<CoreEngineMessageState>;
+    /**
+     * 读取当前模型消息。
+     */
+    get modelMessages(): ModelMessage[];
+    /**
+     * 把 step 间新增的 user 消息并入两份基线。
+     */
+    appendMergedUserMessages(messages: SessionMessageV1[]): Promise<ModelMessage[]>;
+    /**
+     * 追加内部生成的 user nudge 消息。
+     */
+    appendUserTextMessage(message: SessionMessageV1): Promise<void>;
+    /**
+     * 追加 assistant UI 消息到 session 语义基线。
+     */
+    appendRuntimeSessionMessage(message: SessionMessageV1): void;
+    /**
+     * 追加 SDK 返回的模型 response messages。
+     */
+    appendModelMessages(messages: ModelMessage[]): void;
+    private appendSessionMessagesAsModelMessages;
+}
+//# sourceMappingURL=CoreEngineMessageState.d.ts.map

package/bin/executor/core-engine/CoreEngineMessageState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreEngineMessageState.d.ts","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineMessageState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAM5E;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,OAAO,CAAC,eAAe,CAAqB;IAE5C;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAAiB;IAE7C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAE7C,OAAO;IAmBP;;OAEG;WACU,MAAM,CAAC,MAAM,EAAE;QAC1B;;WAEG;QACH,QAAQ,EAAE,gBAAgB,EAAE,CAAC;QAC7B;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;KAC7B,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAWnC;;OAEG;IACH,IAAI,aAAa,IAAI,YAAY,EAAE,CAElC;IAED;;OAEG;IACG,wBAAwB,CAC5B,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,YAAY,EAAE,CAAC;IAM1B;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;OAEG;IACH,2BAA2B,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI5D;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;YAKrC,oCAAoC;CAenD"}

package/bin/executor/core-engine/CoreEngineMessageState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreEngineMessageState.js","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineMessageState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,sBAAsB,EACtB,eAAe,GAChB,MAAM,2CAA2C,CAAC;AAEnD;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACjC;;OAEG;IACK,eAAe,CAAqB;IAE5C;;OAEG;IACK,oBAAoB,CAAiB;IAE7C;;OAEG;IACc,KAAK,CAAuB;IAE7C,YAAoB,MAanB;QACC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,aAAa,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MASnB;QACC,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YACpD,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;YACtB,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,IAAI,sBAAsB,CAAC;YAChC,eAAe;YACf,aAAa,EAAE,MAAM,eAAe,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC;YACnE,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,wBAAwB,CAC5B,QAA4B;QAE5B,MAAM,cAAc,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC3C,OAAO,MAAM,IAAI,CAAC,oCAAoC,CAAC,cAAc,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,OAAyB;QACnD,MAAM,IAAI,CAAC,oCAAoC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,2BAA2B,CAAC,OAAyB;QACnD,IAAI,CAAC,eAAe,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,QAAwB;QAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9D,IAAI,CAAC,oBAAoB,GAAG,CAAC,GAAG,IAAI,CAAC,oBAAoB,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,oCAAoC,CAChD,QAA4B;QAE5B,IAAI,CAAC,eAAe,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC9D,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,oBAAoB,GAAG,CAAC,GAAG,IAAI,CAAC,oBAAoB,EAAE,GAAG,aAAa,CAAC,CAAC;YAC7E,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,oBAAoB,GAAG,MAAM,eAAe,CAC/C,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,KAAK,CACX,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/bin/executor/core-engine/CoreEngineSignals.d.ts

@@ -0,0 +1,72 @@
+/**
+ * SessionLoopSignals：tool-loop 执行循环的信号判断与调试摘要工具。
+ *
+ * 关键点（中文）
+ * - 这里只放“如何判断继续执行 / 如何输出调试摘要”的纯函数。
+ * - 不放 tool-loop 主流程，避免执行内核被大量辅助细节淹没。
+ * - 目标是让 tool-loop 保持“只看主链路就能理解”的结构。
+ */
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+import type { JsonObject } from "../../types/common/Json.js";
+/**
+ * 单次 tool-loop 允许的最大 step 数。
+ */
+export declare const MAX_TOOL_LOOP_STEPS = 64;
+/**
+ * text-only 提醒续跑的最大次数。
+ *
+ * 关键点（中文）
+ * - 仅用于“模型明显承诺下一步、但没有实际调用工具”的兜底。
+ * - 设置较小上限，避免进入无界自催促循环。
+ */
+export declare const MAX_TEXT_ONLY_CONTINUATIONS = 3;
+/**
+ * 不完整响应自动恢复的最大次数。
+ *
+ * 关键点（中文）
+ * - 仅针对 provider 流异常结束这类“本该继续、但响应被截断”的情况。
+ * - 只补一次，避免在 provider 异常持续时进入长时间空转。
+ */
+export declare const MAX_INCOMPLETE_RESPONSE_RECOVERIES = 1;
+/**
+ * 生成日志友好的单行预览文本。
+ */
+export declare function toInlinePreview(value: unknown): string;
+/**
+ * 汇总单个 step 的关键信号，便于定位“为什么没有继续下一轮”。
+ */
+export declare function summarizeStepForDebug(stepResult: unknown): JsonObject;
+/**
+ * 汇总最终 assistant UI 消息的调试摘要。
+ */
+export declare function summarizeUiMessageForDebug(message: SessionMessageV1 | null | undefined): JsonObject;
+/**
+ * 合并多轮 assistant UI 消息。
+ *
+ * 关键点（中文）
+ * - 多 step 场景下，最终 assistant message 需要把各 step 的 UI part 串起来。
+ */
+export declare function mergeAssistantUiMessages(base: SessionMessageV1 | null, incoming: SessionMessageV1): SessionMessageV1;
+/**
+ * 构造“不完整响应恢复”提示。
+ */
+export declare function buildIncompleteResponseRecoveryNudge(recoveryIndex: number): string;
+/**
+ * 检测“响应被中断但模型没有正常完成”的情况。
+ */
+export declare function detectIncompleteResponse(params: {
+    stepResult: unknown;
+    assistantMessage: SessionMessageV1 | null | undefined;
+}): {
+    reason: string;
+    details: JsonObject;
+} | null;
+/**
+ * 检测“只有口头计划，没有真正执行”的续跑信号。
+ */
+export declare function detectTextOnlyContinuationReason(stepResult: unknown): string | null;
+/**
+ * 构造“text-only 续跑”提示。
+ */
+export declare function buildTextOnlyContinuationNudge(continuationIndex: number): string;
+//# sourceMappingURL=CoreEngineSignals.d.ts.map

package/bin/executor/core-engine/CoreEngineSignals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreEngineSignals.d.ts","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineSignals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAqDpD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMtD;AAsDD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CA+BrE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAC3C,UAAU,CA4BZ;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,gBAAgB,GAAG,IAAI,EAC7B,QAAQ,EAAE,gBAAgB,GACzB,gBAAgB,CAmBlB;AAiCD;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,aAAa,EAAE,MAAM,GACpB,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;CACvD,GAAG;IACF,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,CAAC;CACrB,GAAG,IAAI,CAmEP;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,OAAO,GAClB,MAAM,GAAG,IAAI,CAgBf;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAQR"}

package/bin/executor/core-engine/CoreEngineSignals.js.map

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

package/bin/executor/core-engine/CoreEngineUiStreamCollector.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Session UI stream 最终消息收敛器。
+ *
+ * 关键点（中文）
+ * - 必须完整消费 AI SDK UI stream，才能稳定触发 `onFinish`。
+ * - 优先使用结构化 `responseMessage`；缺失时才回退到纯文本。
+ * - UI chunk 回调是展示层副作用，失败不应阻断 session 执行。
+ */
+import type { streamText } from "ai";
+import type { Logger } from "../../utils/logger/Logger.js";
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+/**
+ * 收敛 UI stream 中的最终 assistant 消息。
+ */
+export declare function collectFinalAssistantMessageFromUiStream(params: {
+    /**
+     * 当前 `streamText` 执行结果。
+     */
+    result: ReturnType<typeof streamText>;
+    /**
+     * 当前 sessionId，用于日志关联。
+     */
+    sessionId: string;
+    /**
+     * 当前日志器。
+     */
+    logger: Logger;
+    /**
+     * 构造 fallback assistant 消息的工厂函数。
+     */
+    buildFallbackAssistantMessage: (text: string) => SessionMessageV1;
+}): Promise<SessionMessageV1>;
+//# sourceMappingURL=CoreEngineUiStreamCollector.d.ts.map

package/bin/executor/core-engine/CoreEngineUiStreamCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreEngineUiStreamCollector.d.ts","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineUiStreamCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAO5E;;GAEG;AACH,wBAAsB,wCAAwC,CAAC,MAAM,EAAE;IACrE;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACtC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,6BAA6B,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,CAAC;CACnE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwD5B"}

package/bin/executor/core-engine/CoreEngineUiStreamCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreEngineUiStreamCollector.js","sourceRoot":"","sources":["../../../src/executor/core-engine/CoreEngineUiStreamCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EACL,0BAA0B,EAC1B,eAAe,GAChB,MAAM,4CAA4C,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAAC,MAiB9D;IACC,IAAI,wBAAwB,GAA4B,IAAI,CAAC;IAC7D,IAAI,eAAe,GAAsB,IAAI,CAAC;IAE9C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAmB;QACjE,wEAAwE;QACxE,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,wBAAwB,GAAG,KAAK,CAAC,eAAe,IAAI,IAAI,CAAC;YACzD,eAAe,GAAG;gBAChB,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,YAAY,EACV,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI;gBACpE,GAAG,0BAA0B,CAAC,KAAK,CAAC,eAAe,CAAC;aACrD,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,wBAAwB,GAC5B,kBAAkB,EAAE,EAAE,wBAAwB,CAAC;IACjD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QACnC,IAAI,OAAO,wBAAwB,KAAK,UAAU;YAAE,SAAS;QAC7D,IAAI,CAAC;YACH,MAAM,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE;QACnD,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,CAAC,eAAe,IAAI;YACrB,sBAAsB,EAAE,IAAI;SAC7B,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,wBAAwB;QAAE,OAAO,wBAAwB,CAAC;IAE9D,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,gCAAgC,EAAE;QAChE,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,mBAAmB,EAAE,aAAa,CAAC,MAAM;QACzC,oBAAoB,EAAE,eAAe,CAAC,aAAa,CAAC;KACrD,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,6BAA6B,CACzC,aAAa,IAAI,qBAAqB,CACvC,CAAC;AACJ,CAAC"}

package/bin/executor/ids/resolveSessionId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSessionId.d.ts","sourceRoot":"","sources":["../../../src/executor/ids/resolveSessionId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,GAAG,SAAS,CAQrB"}

package/bin/executor/ids/resolveSessionId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSessionId.js","sourceRoot":"","sources":["../../../src/executor/ids/resolveSessionId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAEhC;IACC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/bin/executor/messages/AssistantResultPersistence.d.ts

@@ -0,0 +1,66 @@
+/**
+ * AssistantResultPersistence：统一处理一次 run 结束后的 assistant 落盘决策。
+ *
+ * 关键点（中文）
+ * - 负责收敛“写完整 assistant message / 写 fallback 文本 / 完全跳过”三种分支。
+ * - 避免 SDK、HTTP execute、control execute、chat queue 各自复制一套判断。
+ * - 一旦 step 消息已经单独持久化，最终 merged assistant 必须跳过，不能再补一条 fallback。
+ */
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+/**
+ * assistant 写入端口。
+ */
+export interface AssistantResultPersistenceWriter {
+    /**
+     * 追加 assistant 消息。
+     */
+    appendAssistantMessage(params: {
+        /**
+         * 已构造好的完整 assistant 消息。
+         */
+        message?: SessionMessageV1 | null;
+        /**
+         * 在没有完整 message 可写时的兜底文本。
+         */
+        fallbackText?: string;
+    }): Promise<void>;
+}
+/**
+ * 一次 run 结束后的 assistant 落盘参数。
+ */
+export interface PersistAssistantResultParams {
+    /**
+     * assistant 写入端口。
+     */
+    writer: AssistantResultPersistenceWriter;
+    /**
+     * 本轮执行得到的 assistant message。
+     */
+    assistantMessage: SessionMessageV1 | null | undefined;
+    /**
+     * 可选兜底文本。
+     *
+     * 关键点（中文）
+     * - 仅在没有完整 assistant message 且未发生 step 持久化时才允许写入。
+     * - 若 step 已单独落盘，这里必须被忽略，避免重复 assistant。
+     */
+    fallbackText?: string;
+}
+/**
+ * 解析本轮 run 最终应该如何持久化 assistant。
+ */
+export declare function buildAssistantResultPersistencePayload(params: Omit<PersistAssistantResultParams, "writer">): {
+    /**
+     * 已构造好的完整 assistant message。
+     */
+    message?: SessionMessageV1 | null;
+    /**
+     * 允许写入的兜底文本。
+     */
+    fallbackText?: string;
+} | null;
+/**
+ * 按统一规则持久化一次 run 的 assistant 结果。
+ */
+export declare function persistAssistantResult(params: PersistAssistantResultParams): Promise<boolean>;
+//# sourceMappingURL=AssistantResultPersistence.d.ts.map

package/bin/executor/messages/AssistantResultPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantResultPersistence.d.ts","sourceRoot":"","sources":["../../../src/executor/messages/AssistantResultPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAM5E;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE;QAC7B;;WAEG;QACH,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAClC;;WAEG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,MAAM,EAAE,gCAAgC,CAAC;IACzC;;OAEG;IACH,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAOD;;GAEG;AACH,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAC,GACnD;IACD;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CAoBP;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/bin/executor/messages/AssistantResultPersistence.js

@@ -0,0 +1,48 @@
+/**
+ * AssistantResultPersistence：统一处理一次 run 结束后的 assistant 落盘决策。
+ *
+ * 关键点（中文）
+ * - 负责收敛“写完整 assistant message / 写 fallback 文本 / 完全跳过”三种分支。
+ * - 避免 SDK、HTTP execute、control execute、chat queue 各自复制一套判断。
+ * - 一旦 step 消息已经单独持久化，最终 merged assistant 必须跳过，不能再补一条 fallback。
+ */
+import { hasPersistedAssistantSteps, resolveAssistantMessageForPersistence, } from "../../executor/messages/UserVisibleText.js";
+function normalizeFallbackText(input) {
+    const text = String(input || "").trim();
+    return text || undefined;
+}
+/**
+ * 解析本轮 run 最终应该如何持久化 assistant。
+ */
+export function buildAssistantResultPersistencePayload(params) {
+    const persistedMessage = resolveAssistantMessageForPersistence(params.assistantMessage);
+    if (persistedMessage) {
+        return {
+            message: persistedMessage,
+        };
+    }
+    // 关键点（中文）：step 已经单独落盘时，最终 merged assistant 必须完全跳过。
+    if (hasPersistedAssistantSteps(params.assistantMessage)) {
+        return null;
+    }
+    const fallbackText = normalizeFallbackText(params.fallbackText);
+    if (!fallbackText)
+        return null;
+    return {
+        fallbackText,
+    };
+}
+/**
+ * 按统一规则持久化一次 run 的 assistant 结果。
+ */
+export async function persistAssistantResult(params) {
+    const payload = buildAssistantResultPersistencePayload({
+        assistantMessage: params.assistantMessage,
+        fallbackText: params.fallbackText,
+    });
+    if (!payload)
+        return false;
+    await params.writer.appendAssistantMessage(payload);
+    return true;
+}
+//# sourceMappingURL=AssistantResultPersistence.js.map

package/bin/executor/messages/AssistantResultPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantResultPersistence.js","sourceRoot":"","sources":["../../../src/executor/messages/AssistantResultPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,0BAA0B,EAC1B,qCAAqC,GACtC,MAAM,wCAAwC,CAAC;AA2ChD,SAAS,qBAAqB,CAAC,KAAyB;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sCAAsC,CACpD,MAAoD;IAWpD,MAAM,gBAAgB,GAAG,qCAAqC,CAC5D,MAAM,CAAC,gBAAgB,CACxB,CAAC;IACF,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE,gBAAgB;SAC1B,CAAC;IACJ,CAAC;IAED,mDAAmD;IACnD,IAAI,0BAA0B,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,qBAAqB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAChE,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO;QACL,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAoC;IAEpC,MAAM,OAAO,GAAG,sCAAsC,CAAC;QACrD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAC,CAAC;IACH,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/bin/executor/messages/ChatMessageMarkup.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Chat 消息标记语法解析工具。
+ *
+ * 关键点（中文）
+ * - 统一处理 frontmatter metadata 与 `<file>` 附件标签。
+ * - 解析结果保留 `segments[]`，用于按正文与附件的真实顺序发送。
+ */
+import type { ChatMessageFileTag, ChatMessageFileType, ChatMessageSegment, ParsedChatMessageMarkup } from "./ChatMessageMarkupTypes.js";
+/**
+ * 归一化附件类型。
+ */
+export declare function normalizeChatMessageFileType(value: unknown): ChatMessageFileType;
+/**
+ * 提取 frontmatter metadata。
+ */
+export declare function extractChatMessageFrontmatter(params: {
+    source: string;
+}): {
+    metadata: Record<string, unknown>;
+    body: string;
+};
+/**
+ * 提取 `<file>` 标签，并保留正文/附件的真实顺序。
+ */
+export declare function extractChatMessageSegments(source: string): ChatMessageSegment[];
+/**
+ * 提取 `<file>` 标签列表。
+ */
+export declare function extractChatMessageFileTags(source: string): ChatMessageFileTag[];
+/**
+ * 移除正文中的 `<file>` 标签，仅保留文本段。
+ */
+export declare function stripChatMessageFileTags(source: string): string;
+/**
+ * 渲染一条标准化 `<file>` 标签。
+ */
+export declare function renderChatMessageFileTag(file: ChatMessageFileTag): string;
+/**
+ * 把附件列表渲染回统一的 `<file>` 文本块。
+ */
+export declare function buildChatMessageFileBlock(files: ChatMessageFileTag[]): string;
+/**
+ * 把片段重建成统一消息文本。
+ */
+export declare function buildChatMessageText(params: {
+    bodyText?: string;
+    files?: ChatMessageFileTag[];
+    segments?: ChatMessageSegment[];
+}): string;
+/**
+ * 统一解析一段 chat 消息文本。
+ */
+export declare function parseChatMessageMarkup(source: string): ParsedChatMessageMarkup;
+//# sourceMappingURL=ChatMessageMarkup.d.ts.map

package/bin/executor/messages/ChatMessageMarkup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMessageMarkup.d.ts","sourceRoot":"","sources":["../../../src/executor/messages/ChatMessageMarkup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAEV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAElB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AA6BrC;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAOhF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd,CA4BA;AA0BD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA6B/E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAI/E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM/D;AASD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAWzE;AAOD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAK7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACjC,GAAG,MAAM,CAsBT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAiB9E"}

package/bin/executor/messages/ChatMessageMarkup.js.map

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

package/bin/executor/messages/ChatMessageMarkupTypes.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Chat 消息标记语法类型。
+ *
+ * 关键点（中文）
+ * - 统一描述 chat plugin runtime 中可见的消息协议：frontmatter metadata + `<file>` 标签。
+ * - direct 模式、`city chat send`、入站附件注入、渠道出站解析都应复用本类型。
+ */
+/**
+ * `<file>` 标签支持的附件类型。
+ *
+ * 说明（中文）
+ * - 语义集合与 Telegram/Feishu 当前支持的附件能力保持一致。
+ * - 默认类型为 `document`。
+ */
+export type ChatMessageFileType = "document" | "photo" | "voice" | "audio" | "video";
+/**
+ * 一条 `<file>` 标签解析后的结构。
+ */
+export interface ChatMessageFileTag {
+    /**
+     * 附件路径。
+     *
+     * 说明（中文）
+     * - 当前主要使用项目内相对路径。
+     * - 渠道可自行决定是否支持绝对路径或远程 URL。
+     */
+    path: string;
+    /**
+     * 附件类型。
+     *
+     * 说明（中文）
+     * - 缺省时按 `document` 处理。
+     */
+    type: ChatMessageFileType;
+    /**
+     * 可选附件说明。
+     *
+     * 说明（中文）
+     * - 存在时由渠道决定如何发送给最终用户。
+     */
+    caption?: string;
+}
+/**
+ * 一段有序文本片段。
+ */
+export interface ChatMessageTextSegment {
+    /**
+     * 片段类型。
+     */
+    kind: "text";
+    /**
+     * 片段文本。
+     *
+     * 说明（中文）
+     * - 已做 trim，保证不会出现纯空白文本段。
+     */
+    text: string;
+}
+/**
+ * 一段有序附件片段。
+ */
+export interface ChatMessageFileSegment {
+    /**
+     * 片段类型。
+     */
+    kind: "file";
+    /**
+     * 附件内容。
+     */
+    file: ChatMessageFileTag;
+}
+/**
+ * 按消息真实顺序排列的片段。
+ */
+export type ChatMessageSegment = ChatMessageTextSegment | ChatMessageFileSegment;
+/**
+ * 一段 chat 消息正文解析后的结果。
+ */
+export interface ParsedChatMessageMarkup {
+    /**
+     * frontmatter metadata 原始对象。
+     *
+     * 说明（中文）
+     * - 只在正文最顶部存在合法 YAML frontmatter 时才会填充。
+     * - 解析失败时会退化为 `{}`，避免误删正文。
+     */
+    metadata: Record<string, unknown>;
+    /**
+     * 去掉 frontmatter 与 `<file>` 标签后的纯正文。
+     *
+     * 说明（中文）
+     * - 会把多段文本按消息原始顺序合并，中间使用空行分隔。
+     */
+    bodyText: string;
+    /**
+     * 按出现顺序提取出的附件标签列表。
+     */
+    files: ChatMessageFileTag[];
+    /**
+     * 按消息实际顺序提取出的有序片段。
+     */
+    segments: ChatMessageSegment[];
+}
+/**
+ * 由 frontmatter metadata 解析出的发送参数。
+ */
+export interface ChatMessageSendOptions {
+    /**
+     * 目标 chatKey。
+     *
+     * 说明（中文）
+     * - 未提供时由调用方回退到当前上下文或显式参数。
+     */
+    chatKey?: string;
+    /**
+     * 延迟发送毫秒数。
+     *
+     * 说明（中文）
+     * - 由 `delay/delayMs/delay-ms` 解析得到。
+     */
+    delayMs?: number;
+    /**
+     * 定时发送的绝对毫秒时间戳。
+     *
+     * 说明（中文）
+     * - 由 `time/sendAt/sendAtMs` 等字段解析得到。
+     */
+    sendAtMs?: number;
+    /**
+     * 是否使用 reply 语义发送。
+     *
+     * 说明（中文）
+     * - 允许仅设置布尔值，也允许结合 `messageId` 一起使用。
+     */
+    replyToMessage?: boolean;
+    /**
+     * 可选目标消息 ID。
+     *
+     * 说明（中文）
+     * - 当前主要用于 Telegram/Feishu reply 场景。
+     */
+    messageId?: string;
+}
+//# sourceMappingURL=ChatMessageMarkupTypes.d.ts.map

package/bin/executor/messages/ChatMessageMarkupTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMessageMarkupTypes.d.ts","sourceRoot":"","sources":["../../../src/executor/messages/ChatMessageMarkupTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,IAAI,EAAE,mBAAmB,CAAC;IAE1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAE5B;;OAEG;IACH,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/bin/executor/messages/ChatMessageMarkupTypes.js

@@ -0,0 +1,9 @@
+/**
+ * Chat 消息标记语法类型。
+ *
+ * 关键点（中文）
+ * - 统一描述 chat plugin runtime 中可见的消息协议：frontmatter metadata + `<file>` 标签。
+ * - direct 模式、`city chat send`、入站附件注入、渠道出站解析都应复用本类型。
+ */
+export {};
+//# sourceMappingURL=ChatMessageMarkupTypes.js.map

package/bin/executor/messages/ChatMessageMarkupTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMessageMarkupTypes.js","sourceRoot":"","sources":["../../../src/executor/messages/ChatMessageMarkupTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/executor/messages/SessionAttachmentMapper.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SessionAttachmentMapper：把 `<file>` 附件描述映射为模型可消费的 file parts。
+ *
+ * 关键点（中文）
+ * - 兼容 Telegram / Feishu / TUI 等统一的 `<file>` 协议入口。
+ * - 仅在本轮执行的内存消息上追加 file parts，不修改持久化历史。
+ * - 当前只为图片与 PDF 注入 file part，保持多模态模型可直接消费。
+ */
+import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+/**
+ * 在 user 消息上注入 FileUIPart，以便多模态模型直接消费本地附件。
+ */
+export declare function injectFilePartsFromAttachments(messages: SessionMessageV1[]): Promise<SessionMessageV1[]>;
+//# sourceMappingURL=SessionAttachmentMapper.d.ts.map

package/bin/executor/messages/SessionAttachmentMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionAttachmentMapper.d.ts","sourceRoot":"","sources":["../../../src/executor/messages/SessionAttachmentMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AA+C5E;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsF7B"}