@downcity/agent 1.1.1

package/bin/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js

@@ -0,0 +1,70 @@
+/**
+ * JsonlSessionCompactionComposer：默认上下文压缩 Composer。
+ *
+ * 关键点（中文）
+ * - 只负责压缩参数策略（retry 越多，窗口越紧）。
+ * - 真正的读写与 compact 执行交由 history Composer。
+ */
+import { SessionCompactionComposer } from "../../../composer/compaction/SessionCompactionComposer.js";
+/**
+ * JsonlSessionCompactionComposer 默认实现。
+ */
+export class JsonlSessionCompactionComposer extends SessionCompactionComposer {
+    name = "summary_compaction_composer";
+    options;
+    constructor(options) {
+        super();
+        this.options = options || {};
+    }
+    resolvePolicy(retryCount) {
+        const baseKeepLastMessages = typeof this.options.keepLastMessages === "number"
+            ? Math.max(6, Math.min(5000, Math.floor(this.options.keepLastMessages)))
+            : 30;
+        const baseMaxInputTokensApprox = typeof this.options.maxInputTokensApprox === "number"
+            ? Math.max(2000, Math.min(200_000, Math.floor(this.options.maxInputTokensApprox)))
+            : 128000;
+        const retryFactor = Math.max(1, Math.pow(2, retryCount));
+        const keepLastMessages = Math.max(6, Math.floor(baseKeepLastMessages / retryFactor));
+        const maxInputTokensApprox = Math.max(2000, Math.floor(baseMaxInputTokensApprox / retryFactor));
+        const archiveOnCompact = this.options.archiveOnCompact === undefined
+            ? true
+            : Boolean(this.options.archiveOnCompact);
+        const compactRatioRaw = typeof this.options.compactRatio === "number" &&
+            Number.isFinite(this.options.compactRatio)
+            ? this.options.compactRatio
+            : 0.5;
+        const compactRatio = Math.max(0.1, Math.min(0.9, compactRatioRaw));
+        return {
+            keepLastMessages,
+            maxInputTokensApprox,
+            archiveOnCompact,
+            compactRatio,
+        };
+    }
+    async run(input) {
+        const policy = this.resolvePolicy(input.retryCount);
+        return await input.historyComposer.compact({
+            model: input.model,
+            system: input.system,
+            keepLastMessages: policy.keepLastMessages,
+            maxInputTokensApprox: policy.maxInputTokensApprox,
+            archiveOnCompact: policy.archiveOnCompact,
+            compactRatio: policy.compactRatio,
+        });
+    }
+    /**
+     * 判断错误是否属于“应先 compact 再重试”的类型。
+     *
+     * 关键点（中文）
+     * - 当前实现基于主流模型 provider 的超限关键词。
+     * - 后续若接入新 provider，可在此处统一扩展识别规则。
+     */
+    shouldCompactOnError(error) {
+        const errorMsg = String(error ?? "");
+        return (errorMsg.includes("context_length") ||
+            errorMsg.includes("too long") ||
+            errorMsg.includes("maximum context") ||
+            errorMsg.includes("context window"));
+    }
+}
+//# sourceMappingURL=JsonlSessionCompactionComposer.js.map

package/bin/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonlSessionCompactionComposer.js","sourceRoot":"","sources":["../../../../../src/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.ts"],"names":[],"mappings":"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"}

package/bin/session/composer/compaction/jsonl/JsonlSessionCompactionExecutor.d.ts

@@ -0,0 +1,46 @@
+/**
+ * JsonlSessionCompactionExecutor：JSONL session 压缩执行模块。
+ *
+ * 关键职责（中文）
+ * - 评估当前消息是否超出输入预算。
+ * - 在锁外生成“更早历史摘要”，降低锁持有时间。
+ * - 在锁内完成归档与 messages.jsonl 重写，保证并发安全。
+ */
+import { type LanguageModel, type SystemModelMessage } from "ai";
+import type { SessionMessageV1, SessionMetadataV1 } from "../../../../types/session/SessionMessages.js";
+import type { SessionHistoryMetaV1 } from "../../../../types/session/SessionHistoryMeta.js";
+export type SessionCompactParams = {
+    model: LanguageModel;
+    system: Array<SystemModelMessage>;
+    keepLastMessages: number;
+    maxInputTokensApprox: number;
+    archiveOnCompact: boolean;
+    compactRatio: number;
+};
+type SessionCompactDeps = {
+    rootPath: string;
+    sessionId: string;
+    withWriteLock: <T>(fn: () => Promise<T>) => Promise<T>;
+    loadAll: () => Promise<SessionMessageV1[]>;
+    createSummaryMessage: (params: {
+        text: string;
+        sourceRange?: SessionMetadataV1["sourceRange"];
+    }) => SessionMessageV1;
+    getArchiveDirPath: () => string;
+    getMessagesFilePath: () => string;
+    readMetaUnsafe: () => Promise<SessionHistoryMetaV1>;
+    writeMetaUnsafe: (next: SessionHistoryMetaV1) => Promise<void>;
+};
+/**
+ * 对当前 session messages 做一次 best-effort compact（必要时）。
+ *
+ * 注意（中文）
+ * - compact 会 rewrite `messages.jsonl`（不是纯 append-only），因此必须防并发覆盖
+ * - 这里做两阶段锁：先 snapshot 再生成摘要，最后再锁定写入，降低锁持有时间
+ */
+export declare function compactSessionMessagesIfNeeded(deps: SessionCompactDeps, params: SessionCompactParams): Promise<{
+    compacted: boolean;
+    reason?: string;
+}>;
+export {};
+//# sourceMappingURL=JsonlSessionCompactionExecutor.d.ts.map

package/bin/session/composer/compaction/jsonl/JsonlSessionCompactionExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonlSessionCompactionExecutor.d.ts","sourceRoot":"","sources":["../../../../../src/session/composer/compaction/jsonl/JsonlSessionCompactionExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,IAAI,CAAC;AAGZ,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAElF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC3C,oBAAoB,EAAE,CAAC,MAAM,EAAE;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;KAChD,KAAK,gBAAgB,CAAC;IACvB,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC,cAAc,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8IlD"}

package/bin/session/composer/compaction/jsonl/JsonlSessionCompactionExecutor.js

@@ -0,0 +1,199 @@
+/**
+ * JsonlSessionCompactionExecutor：JSONL session 压缩执行模块。
+ *
+ * 关键职责（中文）
+ * - 评估当前消息是否超出输入预算。
+ * - 在锁外生成“更早历史摘要”，降低锁持有时间。
+ * - 在锁内完成归档与 messages.jsonl 重写，保证并发安全。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { generateText, isTextUIPart, } from "ai";
+import { generateId } from "../../../../shared/utils/Id.js";
+import { getLogger } from "../../../../shared/utils/logger/Logger.js";
+/**
+ * 对当前 session messages 做一次 best-effort compact（必要时）。
+ *
+ * 注意（中文）
+ * - compact 会 rewrite `messages.jsonl`（不是纯 append-only），因此必须防并发覆盖
+ * - 这里做两阶段锁：先 snapshot 再生成摘要，最后再锁定写入，降低锁持有时间
+ */
+export async function compactSessionMessagesIfNeeded(deps, params) {
+    const logger = getLogger(deps.rootPath, "info");
+    // 算法阶段（中文）
+    // phase 1：snapshot（短锁）
+    // - 仅负责拿一致性快照，不做耗时的模型调用。
+    // - 目的是把锁持有时间降到最低。
+    let snapshot = [];
+    let snapshotTailId = "";
+    await deps.withWriteLock(async () => {
+        snapshot = await deps.loadAll();
+        snapshotTailId =
+            snapshot.length > 0
+                ? String(snapshot[snapshot.length - 1].id || "")
+                : "";
+    });
+    if (snapshot.length < 4) {
+        return { compacted: false, reason: "small_messages" };
+    }
+    const systemText = (params.system || [])
+        .map((m) => String(m.content ?? ""))
+        .join("\n\n");
+    // 关键点（中文）：session messages 现在可能包含 tool parts / output，必须把它们计入预算估算，否则会低估 token。
+    let messagesJson = "";
+    try {
+        messagesJson = JSON.stringify(snapshot);
+    }
+    catch {
+        messagesJson = "";
+    }
+    const est = estimateTokensApproxFromText(systemText + "\n\n" + messagesJson);
+    if (est <= params.maxInputTokensApprox) {
+        return { compacted: false, reason: "under_budget" };
+    }
+    // 关键点（中文）：触发 compact 后，优先压缩“最早一段消息”，默认比例 50%。
+    const compactRatio = normalizeCompactRatio(params.compactRatio);
+    const compactCount = resolveCompactCount(snapshot.length, compactRatio);
+    const older = snapshot.slice(0, compactCount);
+    if (older.length === 0)
+        return { compacted: false, reason: "nothing_to_compact" };
+    const olderTextAll = extractPlainTextFromMessages(older);
+    const maxOlderChars = 24_000;
+    const olderText = olderTextAll.length > maxOlderChars
+        ? "（注意：更早历史过长，已截断保留末尾）\n" + olderTextAll.slice(-maxOlderChars)
+        : olderTextAll;
+    // phase 1.5：生成摘要（不持锁）
+    // - 这一步最耗时，必须在锁外执行，避免阻塞 append。
+    let summary = "";
+    try {
+        const r = await generateText({
+            model: params.model,
+            system: [
+                {
+                    role: "system",
+                    content: "你是对话压缩助手。请把更早的对话历史压缩成“可持续复用”的工作摘要。\n" +
+                        "要求：\n" +
+                        "- 输出中文\n" +
+                        "- 不要复述无关细节，不要输出工具原始日志\n" +
+                        "- 必须包含：已确认事实/用户偏好约束/已做决策/未完成事项\n" +
+                        "- 使用 Markdown 列表，控制在 300~800 字",
+                },
+            ],
+            prompt: `请压缩以下更早历史（按 user/assistant 交替记录）：\n\n${olderText}`,
+        });
+        summary = String(r.text || "").trim();
+    }
+    catch (e) {
+        await logger.log("warn", "Session messages compact summary failed, fallback to lossy truncation", {
+            sessionId: deps.sessionId,
+            error: String(e),
+        });
+        summary = "（系统自动压缩：摘要生成失败，已丢弃更早历史，仅保留最近对话。）";
+    }
+    const fromId = String(older[0]?.id || "");
+    const toId = String(older[older.length - 1]?.id || "");
+    const summaryMsg = deps.createSummaryMessage({
+        text: summary,
+        sourceRange: fromId && toId ? { fromId, toId, count: older.length } : undefined,
+    });
+    const archiveId = `compact-${Date.now()}-${generateId()}`;
+    // phase 2：写入（短锁，且避免覆盖新追加）
+    // - 以“当前最新 session messages”为准重算 currentOlder / currentKept，避免覆盖并发新消息。
+    await deps.withWriteLock(async () => {
+        const current = await deps.loadAll();
+        if (!current.length)
+            return;
+        // 如果 tail 不同，说明期间有新消息追加；我们仍可安全 compact：按“当前长度 + 相同比例”重算。
+        // snapshotTailId 用于 debug，不作为强一致性依赖。
+        void snapshotTailId;
+        const currentCompactCount = resolveCompactCount(current.length, compactRatio);
+        const currentOlder = current.slice(0, currentCompactCount);
+        const currentKept = current.slice(currentCompactCount);
+        if (currentOlder.length === 0)
+            return;
+        if (params.archiveOnCompact) {
+            const archivePath = path.join(deps.getArchiveDirPath(), `${encodeURIComponent(String(archiveId || "").trim())}.json`);
+            await fs.writeJson(archivePath, {
+                v: 1,
+                sessionId: deps.sessionId,
+                archivedAt: Date.now(),
+                messages: currentOlder,
+            }, { spaces: 2 });
+        }
+        const next = [summaryMsg, ...currentKept];
+        const messagesPath = deps.getMessagesFilePath();
+        const tmp = messagesPath + ".tmp";
+        await fs.writeFile(tmp, next.map((m) => JSON.stringify(m)).join("\n") + "\n", "utf8");
+        await fs.move(tmp, messagesPath, { overwrite: true });
+        const prevMeta = await deps.readMetaUnsafe();
+        await deps.writeMetaUnsafe({
+            ...prevMeta,
+            updatedAt: Date.now(),
+            lastArchiveId: params.archiveOnCompact ? archiveId : undefined,
+            keepLastMessages: Math.max(1, currentKept.length),
+            maxInputTokensApprox: params.maxInputTokensApprox,
+            compactRatio,
+        });
+    });
+    return { compacted: true };
+}
+/**
+ * 归一化压缩比例。
+ *
+ * 关键点（中文）
+ * - 仅允许 0.1~0.9，避免“几乎不压缩”或“几乎全压缩”。
+ */
+function normalizeCompactRatio(value) {
+    if (!Number.isFinite(value))
+        return 0.5;
+    return Math.max(0.1, Math.min(0.9, value));
+}
+/**
+ * 按比例计算前段压缩条数。
+ *
+ * 关键点（中文）
+ * - 至少压缩 1 条；
+ * - 至少保留 1 条未压缩消息。
+ */
+function resolveCompactCount(total, ratio) {
+    const n = Math.max(0, Math.floor(total));
+    if (n <= 1)
+        return 0;
+    const raw = Math.floor(n * ratio);
+    return Math.max(1, Math.min(n - 1, raw));
+}
+/**
+ * 近似 token 估算。
+ *
+ * 算法说明（中文）
+ * - 这里使用经验近似，不追求精确 tokenizer 一致性。
+ * - 目标是为 compact 提供保守预算，宁可略高估也不要低估。
+ */
+function estimateTokensApproxFromText(text) {
+    const t = String(text || "");
+    // 经验值：英文 ~4 chars/token；中文更接近 1-2 chars/token。这里用保守的 3 chars/token。
+    return Math.ceil(t.length / 3);
+}
+/**
+ * 从 UIMessage 提取可摘要的纯文本。
+ *
+ * 关键点（中文）
+ * - 统一把 user / assistant 内容线性化，作为 compact 摘要输入。
+ * - tool 原始结构不会原样输出，避免把噪声日志喂给摘要模型。
+ */
+function extractPlainTextFromMessages(messages) {
+    const lines = [];
+    for (const m of messages) {
+        if (!m || typeof m !== "object")
+            continue;
+        const role = m.role === "user" ? "user" : "assistant";
+        const parts = Array.isArray(m.parts) ? m.parts : [];
+        const textParts = parts.filter(isTextUIPart).map((p) => String(p.text ?? ""));
+        const text = textParts.join("\n").trim();
+        if (!text)
+            continue;
+        lines.push(`${role}: ${text}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=JsonlSessionCompactionExecutor.js.map

package/bin/session/composer/compaction/jsonl/JsonlSessionCompactionExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonlSessionCompactionExecutor.js","sourceRoot":"","sources":["../../../../../src/session/composer/compaction/jsonl/JsonlSessionCompactionExecutor.ts"],"names":[],"mappings":"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"}

package/bin/session/composer/execution/LocalSessionExecutionComposer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * LocalSessionExecutionComposer：本地 session 运行时编排 Composer 实现。
+ *
+ * 关键点（中文）
+ * - 统一组装 tools。
+ * - step 边界回调从 SessionRunScope 读取，LocalSessionCore 不直接管理来源。
+ */
+import type { ModelMessage } from "ai";
+import { SessionExecutionComposer } from "../../composer/execution/SessionExecutionComposer.js";
+import type { SessionExecutionComposeResult } from "../../composer/execution/SessionExecutionComposer.js";
+import type { SessionMessageV1 } from "../../../types/session/SessionMessages.js";
+import type { SessionSystemMessage } from "../../../types/session/SessionPrompts.js";
+import type { Tool } from "ai";
+type LocalSessionExecutionComposerOptions = {
+    /**
+     * 可选默认 session id。
+     */
+    sessionId?: string;
+    /**
+     * 读取当前可用工具集合。
+     */
+    getTools: () => Record<string, Tool>;
+};
+/**
+ * LocalSessionExecutionComposer 默认 Composer 实现。
+ */
+export declare class LocalSessionExecutionComposer extends SessionExecutionComposer {
+    readonly name = "runtime_execution_composer";
+    private readonly sessionId;
+    private readonly getTools;
+    constructor(options: LocalSessionExecutionComposerOptions);
+    compose(): Promise<SessionExecutionComposeResult>;
+    createPrepareStepHandler(input: {
+        system: SessionSystemMessage[];
+        appendMergedUserMessages: (messages: SessionMessageV1[]) => Promise<ModelMessage[]>;
+    }): (input: {
+        messages?: ModelMessage[];
+    }) => Promise<{
+        system: SessionSystemMessage[];
+        messages?: ModelMessage[];
+    }>;
+    createOnStepFinishHandler(): (stepResult: unknown) => Promise<void>;
+    /**
+     * 构造 fallback assistant 消息。
+     */
+    buildFallbackAssistantMessage(text: string): SessionMessageV1;
+}
+export {};
+//# sourceMappingURL=LocalSessionExecutionComposer.d.ts.map

package/bin/session/composer/execution/LocalSessionExecutionComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSessionExecutionComposer.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/execution/LocalSessionExecutionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAMvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yDAAyD,CAAC;AACnG,OAAO,KAAK,EACV,6BAA6B,EAC9B,MAAM,yDAAyD,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B,KAAK,oCAAoC,GAAG;IAC1C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,wBAAwB;IACzE,QAAQ,CAAC,IAAI,gCAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmD;gBAEhE,OAAO,EAAE,oCAAoC;IAMnD,OAAO,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAkBvD,wBAAwB,CACtB,KAAK,EAAE;QACL,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,wBAAwB,EAAE,CACxB,QAAQ,EAAE,gBAAgB,EAAE,KACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;KAC9B,GACA,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QACnD,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC;IA+CF,yBAAyB,IAAI,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC;IAqBnE;;OAEG;IACH,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;CAqB9D"}

package/bin/session/composer/execution/LocalSessionExecutionComposer.js

@@ -0,0 +1,117 @@
+/**
+ * LocalSessionExecutionComposer：本地 session 运行时编排 Composer 实现。
+ *
+ * 关键点（中文）
+ * - 统一组装 tools。
+ * - step 边界回调从 SessionRunScope 读取，LocalSessionCore 不直接管理来源。
+ */
+import { generateId } from "../../../shared/utils/Id.js";
+import { drainInjectedUserMessages, getSessionRunScope, } from "../../SessionRunScope.js";
+import { SessionExecutionComposer } from "../../composer/execution/SessionExecutionComposer.js";
+/**
+ * LocalSessionExecutionComposer 默认 Composer 实现。
+ */
+export class LocalSessionExecutionComposer extends SessionExecutionComposer {
+    name = "runtime_execution_composer";
+    sessionId;
+    getTools;
+    constructor(options) {
+        super();
+        this.sessionId = String(options.sessionId || "").trim();
+        this.getTools = options.getTools;
+    }
+    async compose() {
+        const tools = this.getTools();
+        const ctx = getSessionRunScope();
+        const sessionId = String(ctx?.sessionId || this.sessionId || "").trim();
+        if (!sessionId) {
+            throw new Error("LocalSessionExecutionComposer.compose requires a sessionId from sessionRunScope or options.sessionId");
+        }
+        // 关键点（中文）：sessionId 统一回填到请求上下文，后续组件直接读取。
+        if (ctx && typeof ctx === "object") {
+            if (!ctx.sessionId)
+                ctx.sessionId = sessionId;
+        }
+        return {
+            tools,
+        };
+    }
+    createPrepareStepHandler(input) {
+        return async ({ messages, }) => {
+            const injectedMessages = drainInjectedUserMessages();
+            const onStepCallback = getSessionRunScope()?.onStepCallback;
+            if (typeof onStepCallback !== "function" &&
+                injectedMessages.length === 0) {
+                return { system: input.system };
+            }
+            const incomingMessages = Array.isArray(messages)
+                ? messages
+                : [];
+            let outMessages;
+            try {
+                const mergedMessages = typeof onStepCallback === "function" ? await onStepCallback() : [];
+                const mergedWithInjected = [
+                    ...injectedMessages,
+                    ...(Array.isArray(mergedMessages) ? mergedMessages : []),
+                ];
+                const mergedModelMessages = await input.appendMergedUserMessages(mergedWithInjected);
+                if (mergedModelMessages.length > 0) {
+                    // 关键点（中文）：保持当前 step 已有消息顺序不变，只把新增 user 消息追加到末尾。
+                    outMessages = [...incomingMessages, ...mergedModelMessages];
+                }
+            }
+            catch {
+                // ignore merge hook failures
+            }
+            return {
+                system: input.system,
+                ...(Array.isArray(outMessages) ? { messages: outMessages } : {}),
+            };
+        };
+    }
+    createOnStepFinishHandler() {
+        const onAssistantStepCallback = getSessionRunScope()?.onAssistantStepCallback;
+        let assistantStepIndex = 0;
+        return async (stepResult) => {
+            const step = stepResult;
+            const stepText = String(step.text || "").trim();
+            if (typeof onAssistantStepCallback !== "function")
+                return;
+            try {
+                assistantStepIndex += 1;
+                await onAssistantStepCallback({
+                    text: stepText,
+                    // 关键点（中文）：1-based step 序号，按回调触发次数递增。
+                    stepIndex: assistantStepIndex,
+                    stepResult,
+                });
+            }
+            catch {
+                // ignore assistant step callback failures
+            }
+        };
+    }
+    /**
+     * 构造 fallback assistant 消息。
+     */
+    buildFallbackAssistantMessage(text) {
+        const ctx = getSessionRunScope();
+        const sessionId = String(ctx?.sessionId || this.sessionId || "").trim();
+        if (!sessionId) {
+            throw new Error("LocalSessionExecutionComposer.buildFallbackAssistantMessage requires a sessionId from sessionRunScope or options.sessionId");
+        }
+        return {
+            id: `a:${sessionId}:${generateId()}`,
+            role: "assistant",
+            metadata: {
+                v: 1,
+                ts: Date.now(),
+                sessionId,
+                source: "egress",
+                kind: "normal",
+            },
+            parts: [{ type: "text", text: String(text ?? "") }],
+        };
+    }
+}
+//# sourceMappingURL=LocalSessionExecutionComposer.js.map

package/bin/session/composer/execution/LocalSessionExecutionComposer.js.map

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

package/bin/session/composer/execution/SessionExecutionComposer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * SessionExecutionComposer：单次 Session run 编排 Composer 抽象。
+ *
+ * 关键点（中文）
+ * - 负责 tools/onStepCallback 等运行时编排。
+ * - 不负责历史读写，不负责 system 解析，不负责 compact。
+ */
+import type { ModelMessage, Tool } from "ai";
+import type { SessionMessageV1 } from "../../../types/session/SessionMessages.js";
+import type { SessionSystemMessage } from "../../../types/session/SessionPrompts.js";
+import { SessionComposer } from "../../composer/SessionComposer.js";
+/**
+ * 本轮运行编排输出。
+ */
+export type SessionExecutionComposeResult = {
+    /**
+     * 本轮工具集合。
+     */
+    tools: Record<string, Tool>;
+};
+/**
+ * 运行编排 Composer 抽象类。
+ */
+export declare abstract class SessionExecutionComposer extends SessionComposer {
+    /**
+     * Composer 名（由具体实现声明）。
+     */
+    abstract readonly name: string;
+    /**
+     * 组装一次 run 所需运行态。
+     */
+    abstract compose(): Promise<SessionExecutionComposeResult>;
+    /**
+     * 构造 prepareStep 回调。
+     */
+    abstract createPrepareStepHandler(input: {
+        /**
+         * 当前轮 system 消息。
+         */
+        system: SessionSystemMessage[];
+        /**
+         * 将新增 user 消息转换为可追加的模型消息。
+         */
+        appendMergedUserMessages: (messages: SessionMessageV1[]) => Promise<ModelMessage[]>;
+    }): (input: {
+        messages?: ModelMessage[];
+    }) => Promise<{
+        system: SessionSystemMessage[];
+        messages?: ModelMessage[];
+    }>;
+    /**
+     * 构造 onStepFinish 回调。
+     */
+    abstract createOnStepFinishHandler(): (stepResult: unknown) => Promise<void>;
+    /**
+     * 构造 fallback assistant 消息。
+     *
+     * 关键点（中文）
+   * - fallback 消息构造由 execution Composer 内部实现，LocalSessionCore 不直接依赖 history Composer。
+     */
+    abstract buildFallbackAssistantMessage(text: string): SessionMessageV1;
+}
+//# sourceMappingURL=SessionExecutionComposer.d.ts.map

package/bin/session/composer/execution/SessionExecutionComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionExecutionComposer.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/execution/SessionExecutionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,8BAAsB,wBAAyB,SAAQ,eAAe;IACpE;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAE1D;;OAEG;IACH,QAAQ,CAAC,wBAAwB,CAC/B,KAAK,EAAE;QACL;;WAEG;QACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B;;WAEG;QACH,wBAAwB,EAAE,CACxB,QAAQ,EAAE,gBAAgB,EAAE,KACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;KAC9B,GACA,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QACnD,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,yBAAyB,IAAI,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC;IAE5E;;;;;OAKG;IACH,QAAQ,CAAC,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;CACvE"}

package/bin/session/composer/execution/SessionExecutionComposer.js

@@ -0,0 +1,14 @@
+/**
+ * SessionExecutionComposer：单次 Session run 编排 Composer 抽象。
+ *
+ * 关键点（中文）
+ * - 负责 tools/onStepCallback 等运行时编排。
+ * - 不负责历史读写，不负责 system 解析，不负责 compact。
+ */
+import { SessionComposer } from "../../composer/SessionComposer.js";
+/**
+ * 运行编排 Composer 抽象类。
+ */
+export class SessionExecutionComposer extends SessionComposer {
+}
+//# sourceMappingURL=SessionExecutionComposer.js.map

package/bin/session/composer/execution/SessionExecutionComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionExecutionComposer.js","sourceRoot":"","sources":["../../../../src/session/composer/execution/SessionExecutionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAYvE;;GAEG;AACH,MAAM,OAAgB,wBAAyB,SAAQ,eAAe;CA4CrE"}