@downcity/agent 1.1.408 → 1.1.437

package/bin/session/browse/SessionMessageTimeline.js

@@ -58,53 +58,77 @@ function project_tool_part(message, part, start_index) {
 }
 /** 把一条 canonical Session Message 投影为 UI 时间线事件。 */
 export function to_session_message_timeline_events(message) {
-    if (message.type === "action") {
-        return [{
-                id: `${message.message_id}:0`,
-                role: "action",
-                ts: message.updated_at,
-                text: message.description
-                    ? `${message.title}\n${message.description}`
-                    : message.title,
-                action_title: message.title,
-                ...(message.description ? { action_description: message.description } : {}),
-                action_state: message.status,
-            }];
-    }
-    if (message.type === "error") {
-        return [create_timeline_event({
-                message,
-                role: "assistant",
-                text: message.message,
-                index: 0,
-            })];
-    }
-    if (message.type === "user") {
-        const text = message.parts
-            .filter((part) => part.type === "text")
-            .map((part) => part.text.trim())
-            .filter(Boolean)
-            .join("\n");
+    if (message.role === "user") {
+        const text_parts = [];
+        for (const part of message.parts) {
+            switch (part.type) {
+                case "text":
+                    if (part.text.trim())
+                        text_parts.push(part.text.trim());
+                    break;
+                case "context":
+                case "file":
+                case "data":
+                    break;
+                default:
+                    assert_never(part);
+            }
+        }
+        const text = text_parts.join("\n");
         return [create_timeline_event({ message, role: "user", text, index: 0 })];
     }
     const events = [];
     for (const part of [...message.parts].sort((left, right) => left.sequence - right.sequence)) {
-        if (part.type === "text") {
-            const text = part.text.trim();
-            if (text) {
+        switch (part.type) {
+            case "text": {
+                const text = part.text.trim();
+                if (text) {
+                    events.push(create_timeline_event({
+                        message,
+                        role: "agent",
+                        text,
+                        index: events.length,
+                    }));
+                }
+                break;
+            }
+            case "action":
+                events.push({
+                    id: `${message.message_id}:${events.length}`,
+                    role: "action",
+                    ts: message.updated_at,
+                    text: part.description
+                        ? `${part.title}\n${part.description}`
+                        : part.title,
+                    action_title: part.title,
+                    ...(part.description ? { action_description: part.description } : {}),
+                    action_state: part.state,
+                });
+                break;
+            case "error":
                 events.push(create_timeline_event({
                     message,
-                    role: "assistant",
-                    text,
+                    role: "agent",
+                    text: part.message,
                     index: events.length,
                 }));
-            }
-            continue;
+                break;
+            case "tool":
+                events.push(...project_tool_part(message, part, events.length));
+                break;
+            case "reasoning":
+            case "interaction":
+            case "file":
+            case "data":
+                break;
+            default:
+                assert_never(part);
         }
-        if (part.type !== "tool")
-            continue;
-        events.push(...project_tool_part(message, part, events.length));
     }
     return events;
 }
+/** canonical Part 联合类型新增成员时强制时间线显式处理。 */
+function assert_never(value) {
+    throw new Error(`Unsupported timeline Session Part: ${String(value.type)}`);
+}
 //# sourceMappingURL=SessionMessageTimeline.js.map

package/bin/session/browse/SessionMessageTimeline.js.map

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

package/bin/session/composer/policies/AdaptivePartContextPolicy.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 基于稳定 Part 游标的自适应上下文策略。
+ *
+ * Message 仍是 canonical 持久化聚合，Part 是上下文取舍与摘要边界。策略只写自己的
+ * checkpoint 派生表，不修改 Message；单个 Agent Message 很大时也可以在
+ * Message 内部形成摘要边界。
+ */
+import type { SessionContextPolicy } from "../../../types/session/SessionContextPolicy.js";
+/** 默认 Part 级上下文策略。 */
+export declare class AdaptivePartContextPolicy implements SessionContextPolicy {
+    readonly name = "adaptive_part";
+    /** 创建当前策略独享的 checkpoint 表。 */
+    initialize(input: Parameters<SessionContextPolicy["initialize"]>[0]): Promise<void>;
+    /** 返回显式摘要 system block 与 Part 边界后的 canonical 历史。 */
+    resolve(input: Parameters<SessionContextPolicy["resolve"]>[0]): Promise<{
+        diagnostics: {
+            derivation_id?: string | undefined;
+            derived: boolean;
+            through_part_sequence?: number | undefined;
+            through_sequence?: number | undefined;
+            policy_name: string;
+        };
+        system_blocks?: {
+            source: "session";
+            name: string;
+            content: string;
+        }[] | undefined;
+        messages: import("@downcity/type").ModelMessage[];
+    }>;
+    /** 上下文压力出现时，按体积选择较旧稳定 Part 并合并进累计摘要。 */
+    recover(input: Parameters<SessionContextPolicy["recover"]>[0]): Promise<boolean>;
+    /** 读取当前版本位置最靠后的累计 checkpoint。 */
+    private read_latest_checkpoint;
+}
+//# sourceMappingURL=AdaptivePartContextPolicy.d.ts.map

package/bin/session/composer/policies/AdaptivePartContextPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptivePartContextPolicy.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/policies/AdaptivePartContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAepF,sBAAsB;AACtB,qBAAa,yBAA0B,YAAW,oBAAoB;IACpE,QAAQ,CAAC,IAAI,mBAAmB;IAEhC,8BAA8B;IACxB,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzF,oDAAoD;IAC9C,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;IA+BnE,wCAAwC;IAClC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAsDtF,iCAAiC;YACnB,sBAAsB;CAcrC"}

package/bin/session/composer/policies/AdaptivePartContextPolicy.js

@@ -0,0 +1,256 @@
+/**
+ * 基于稳定 Part 游标的自适应上下文策略。
+ *
+ * Message 仍是 canonical 持久化聚合，Part 是上下文取舍与摘要边界。策略只写自己的
+ * checkpoint 派生表，不修改 Message；单个 Agent Message 很大时也可以在
+ * Message 内部形成摘要边界。
+ */
+import { generate_id } from "../../../utils/Id.js";
+import { build_text_model_messages, generate_model } from "../../../executor/model/ModelGenerate.js";
+import { session_messages_to_model_messages } from "../../../executor/messages/SessionModelMessages.js";
+import { build_initial_session_summary_prompt, build_updated_session_summary_prompt, SESSION_SUMMARY_SYSTEM_PROMPT, } from "../../../session/composer/policies/SessionSummaryPrompts.js";
+const POLICY_VERSION = 1;
+const SUMMARY_MAX_OUTPUT_TOKENS = 4_000;
+const CHECKPOINT_TABLE = "composer_adaptive_part_checkpoints";
+/** 默认 Part 级上下文策略。 */
+export class AdaptivePartContextPolicy {
+    name = "adaptive_part";
+    /** 创建当前策略独享的 checkpoint 表。 */
+    async initialize(input) {
+        await input.storage.transaction((transaction) => {
+            transaction.execute(`
+        CREATE TABLE IF NOT EXISTS ${CHECKPOINT_TABLE} (
+          checkpoint_id TEXT PRIMARY KEY,
+          through_message_id TEXT NOT NULL REFERENCES messages(message_id) ON DELETE CASCADE,
+          through_message_sequence INTEGER NOT NULL,
+          through_part_sequence INTEGER NOT NULL,
+          summary TEXT NOT NULL,
+          policy_version INTEGER NOT NULL,
+          created_at INTEGER NOT NULL,
+          UNIQUE(through_message_sequence, through_part_sequence, policy_version)
+        )
+      `);
+        });
+    }
+    /** 返回显式摘要 system block 与 Part 边界后的 canonical 历史。 */
+    async resolve(input) {
+        const checkpoint = await this.read_latest_checkpoint(input.storage);
+        const canonical = await input.storage.list_messages();
+        const tail = checkpoint
+            ? slice_messages_after_checkpoint(canonical, checkpoint)
+            : canonical;
+        return {
+            messages: await session_messages_to_model_messages(tail, input.project_root),
+            ...(checkpoint?.summary.trim()
+                ? {
+                    system_blocks: [{
+                            source: "session",
+                            name: "context-summary",
+                            content: `<session-context-summary>\n${checkpoint.summary}\n</session-context-summary>`,
+                        }],
+                }
+                : {}),
+            diagnostics: {
+                policy_name: this.name,
+                ...(canonical.at(-1)?.sequence !== undefined
+                    ? { through_sequence: canonical.at(-1)?.sequence }
+                    : {}),
+                ...(checkpoint
+                    ? { through_part_sequence: checkpoint.through_part_sequence }
+                    : {}),
+                derived: Boolean(checkpoint),
+                ...(checkpoint ? { derivation_id: checkpoint.checkpoint_id } : {}),
+            },
+        };
+    }
+    /** 上下文压力出现时，按体积选择较旧稳定 Part 并合并进累计摘要。 */
+    async recover(input) {
+        if (!input.model)
+            return false;
+        const previous = await this.read_latest_checkpoint(input.storage);
+        const canonical = await input.storage.list_messages();
+        const candidates = collect_stable_parts(canonical, previous);
+        const compact_parts = select_compact_parts(candidates);
+        const boundary = compact_parts.at(-1);
+        if (!boundary)
+            return false;
+        const conversation_text = compact_parts
+            .map(candidate_to_summary_text)
+            .filter(Boolean)
+            .join("\n");
+        if (!conversation_text)
+            return false;
+        const prompt = previous?.summary.trim()
+            ? build_updated_session_summary_prompt({
+                previous_summary: previous.summary,
+                conversation_text,
+            })
+            : build_initial_session_summary_prompt({ conversation_text });
+        const result = await generate_model(input.model, {
+            messages: build_text_model_messages(SESSION_SUMMARY_SYSTEM_PROMPT, prompt),
+            max_output_tokens: SUMMARY_MAX_OUTPUT_TOKENS,
+        }, {
+            request_kind: "history_compaction",
+            on_failure: input.on_model_request_failure,
+        });
+        const summary = String(result.text || "").trim();
+        if (!summary)
+            throw new Error("Context summary model returned an empty result");
+        const checkpoint_id = `checkpoint:${generate_id()}`;
+        try {
+            await input.storage.transaction((transaction) => {
+                transaction.execute(`
+          INSERT INTO ${CHECKPOINT_TABLE} (
+            checkpoint_id, through_message_id, through_message_sequence,
+            through_part_sequence, summary, policy_version, created_at
+          ) VALUES (?, ?, ?, ?, ?, ?, ?)
+        `, [
+                    checkpoint_id,
+                    boundary.message.message_id,
+                    boundary.message.sequence,
+                    boundary.part.sequence,
+                    summary,
+                    POLICY_VERSION,
+                    Date.now(),
+                ]);
+            });
+            return true;
+        }
+        catch (error) {
+            const latest = await this.read_latest_checkpoint(input.storage);
+            if (latest && compare_position(latest, boundary) >= 0)
+                return true;
+            throw error;
+        }
+    }
+    /** 读取当前版本位置最靠后的累计 checkpoint。 */
+    async read_latest_checkpoint(storage) {
+        return await storage.transaction((transaction) => transaction.get(`
+        SELECT checkpoint_id, through_message_id, through_message_sequence,
+               through_part_sequence, summary, policy_version, created_at
+        FROM ${CHECKPOINT_TABLE}
+        WHERE policy_version = ?
+        ORDER BY through_message_sequence DESC, through_part_sequence DESC
+        LIMIT 1
+      `, [POLICY_VERSION]));
+    }
+}
+/** 收集 checkpoint 后适合进入摘要的稳定 Part。 */
+function collect_stable_parts(messages, checkpoint) {
+    return messages.flatMap((message) => message.parts.flatMap((part) => {
+        if (checkpoint && compare_part_position(message.sequence, part.sequence, checkpoint) <= 0) {
+            return [];
+        }
+        if (!is_stable_summary_part(message, part))
+            return [];
+        return [{ message, part }];
+    }));
+}
+/** 判断 Part 是否稳定且值得占据累计摘要。 */
+function is_stable_summary_part(message, part) {
+    switch (part.type) {
+        case "reasoning":
+        case "action":
+        case "interaction":
+            return false;
+        case "tool":
+            return part.state === "completed" || part.state === "failed";
+        case "text":
+            if (message.role === "user")
+                return true;
+            return "state" in part && part.state === "done" && message.state === "done";
+        case "context":
+        case "file":
+        case "data":
+        case "error":
+            return true;
+        default:
+            return assert_never(part);
+    }
+}
+/** 把单个 Part 收窄为摘要模型需要的稳定事实。 */
+function candidate_to_summary_text(candidate) {
+    return JSON.stringify({
+        role: candidate.message.role,
+        message_id: candidate.message.message_id,
+        part: summary_part(candidate.part),
+    });
+}
+/** 删除瞬时字段并保留 Tool 调用/结果原子。 */
+function summary_part(part) {
+    switch (part.type) {
+        case "text":
+            return { type: "text", text: part.text };
+        case "context":
+            return { type: "context", tag: part.tag, context: part.context };
+        case "file":
+            return { type: "file", media_type: part.media_type, url: part.url, filename: part.filename };
+        case "data":
+            return { type: "data", data_type: part.data_type, data: part.data };
+        case "tool":
+            return {
+                type: "tool",
+                tool_name: part.tool_name,
+                input: part.input,
+                output: part.output,
+                error: part.error,
+            };
+        case "error":
+            return { type: "error", code: part.code, message: part.message };
+        case "reasoning":
+        case "action":
+        case "interaction":
+            return { type: part.type };
+        default:
+            return assert_never(part);
+    }
+}
+/**
+ * 选择足以释放约一半原始上下文体积的最旧 Part。
+ *
+ * 关键点（中文）：Part 数量不能代表上下文压力。一个巨大 Tool/Text Part
+ * 可以独自占满窗口，因此使用送入摘要模型的序列化字符体积作为轻量估算，
+ * 并保证只有一个可用 Part 时仍能推进 checkpoint。
+ */
+function select_compact_parts(candidates) {
+    if (candidates.length === 0)
+        return [];
+    const sizes = candidates.map((candidate) => Math.max(candidate_to_summary_text(candidate).length, 1));
+    const target_size = Math.ceil(sizes.reduce((total, size) => total + size, 0) / 2);
+    let selected_size = 0;
+    let selected_count = 0;
+    while (selected_count < candidates.length && selected_size < target_size) {
+        selected_size += sizes[selected_count] ?? 0;
+        selected_count += 1;
+    }
+    return candidates.slice(0, Math.max(selected_count, 1));
+}
+/** 删除 checkpoint 以前的 Part；边界可以位于单个 Message 内部。 */
+function slice_messages_after_checkpoint(messages, checkpoint) {
+    return messages.flatMap((message) => {
+        if (message.sequence < checkpoint.through_message_sequence)
+            return [];
+        if (message.sequence > checkpoint.through_message_sequence)
+            return [message];
+        const parts = message.parts.filter((part) => part.sequence > checkpoint.through_part_sequence);
+        if (parts.length === 0)
+            return [];
+        return [{ ...message, parts }];
+    });
+}
+/** 比较 canonical Part 与 checkpoint 的全局线性位置。 */
+function compare_part_position(message_sequence, part_sequence, checkpoint) {
+    if (message_sequence !== checkpoint.through_message_sequence) {
+        return message_sequence - checkpoint.through_message_sequence;
+    }
+    return part_sequence - checkpoint.through_part_sequence;
+}
+/** 比较 checkpoint 与候选边界。 */
+function compare_position(checkpoint, candidate) {
+    return -compare_part_position(candidate.message.sequence, candidate.part.sequence, checkpoint);
+}
+/** canonical Part 联合类型新增成员时强制摘要策略显式选择语义。 */
+function assert_never(value) {
+    throw new Error(`Unsupported summary Session Part: ${String(value.type)}`);
+}
+//# sourceMappingURL=AdaptivePartContextPolicy.js.map

package/bin/session/composer/policies/AdaptivePartContextPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptivePartContextPolicy.js","sourceRoot":"","sources":["../../../../src/session/composer/policies/AdaptivePartContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC7F,OAAO,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AAMjG,OAAO,EACL,oCAAoC,EACpC,oCAAoC,EACpC,6BAA6B,GAC9B,MAAM,sDAAsD,CAAC;AAE9D,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,yBAAyB,GAAG,KAAK,CAAC;AACxC,MAAM,gBAAgB,GAAG,oCAAoC,CAAC;AAE9D,sBAAsB;AACtB,MAAM,OAAO,yBAAyB;IAC3B,IAAI,GAAG,eAAe,CAAC;IAEhC,8BAA8B;IAC9B,KAAK,CAAC,UAAU,CAAC,KAAwD;QACvE,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE;YAC9C,WAAW,CAAC,OAAO,CAAC;qCACW,gBAAgB;;;;;;;;;;OAU9C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,OAAO,CAAC,KAAqD;QACjE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,UAAU;YACrB,CAAC,CAAC,+BAA+B,CAAC,SAAS,EAAE,UAAU,CAAC;YACxD,CAAC,CAAC,SAAS,CAAC;QACd,OAAO;YACL,QAAQ,EAAE,MAAM,kCAAkC,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC;YAC5E,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC5B,CAAC,CAAC;oBACE,aAAa,EAAE,CAAC;4BACd,MAAM,EAAE,SAAkB;4BAC1B,IAAI,EAAE,iBAAiB;4BACvB,OAAO,EAAE,8BAA8B,UAAU,CAAC,OAAO,8BAA8B;yBACxF,CAAC;iBACH;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,WAAW,EAAE;gBACX,WAAW,EAAE,IAAI,CAAC,IAAI;gBACtB,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,SAAS;oBAC1C,CAAC,CAAC,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE;oBAClD,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,UAAU;oBACZ,CAAC,CAAC,EAAE,qBAAqB,EAAE,UAAU,CAAC,qBAAqB,EAAE;oBAC7D,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC;gBAC5B,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnE;SACF,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,OAAO,CAAC,KAAqD;QACjE,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC7D,MAAM,aAAa,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,MAAM,iBAAiB,GAAG,aAAa;aACpC,GAAG,CAAC,yBAAyB,CAAC;aAC9B,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,IAAI,CAAC,iBAAiB;YAAE,OAAO,KAAK,CAAC;QACrC,MAAM,MAAM,GAAG,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE;YACrC,CAAC,CAAC,oCAAoC,CAAC;gBACnC,gBAAgB,EAAE,QAAQ,CAAC,OAAO;gBAClC,iBAAiB;aAClB,CAAC;YACJ,CAAC,CAAC,oCAAoC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE;YAC/C,QAAQ,EAAE,yBAAyB,CAAC,6BAA6B,EAAE,MAAM,CAAC;YAC1E,iBAAiB,EAAE,yBAAyB;SAC7C,EAAE;YACD,YAAY,EAAE,oBAAoB;YAClC,UAAU,EAAE,KAAK,CAAC,wBAAwB;SAC3C,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChF,MAAM,aAAa,GAAG,cAAc,WAAW,EAAE,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE;gBAC9C,WAAW,CAAC,OAAO,CAAC;wBACJ,gBAAgB;;;;SAI/B,EAAE;oBACD,aAAa;oBACb,QAAQ,CAAC,OAAO,CAAC,UAAU;oBAC3B,QAAQ,CAAC,OAAO,CAAC,QAAQ;oBACzB,QAAQ,CAAC,IAAI,CAAC,QAAQ;oBACtB,OAAO;oBACP,cAAc;oBACd,IAAI,CAAC,GAAG,EAAE;iBACX,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChE,IAAI,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,iCAAiC;IACzB,KAAK,CAAC,sBAAsB,CAClC,OAAkE;QAElE,OAAO,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE,CAC/C,WAAW,CAAC,GAAG,CAA4B;;;eAGlC,gBAAgB;;;;OAIxB,EAAE,CAAC,cAAc,CAAC,CAAC,CACrB,CAAC;IACJ,CAAC;CACF;AAED,qCAAqC;AACrC,SAAS,oBAAoB,CAC3B,QAAmC,EACnC,UAA4C;IAE5C,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAClE,IAAI,UAAU,IAAI,qBAAqB,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1F,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACtD,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,6BAA6B;AAC7B,SAAS,sBAAsB,CAC7B,OAAuB,EACvB,IAAsD;IAEtD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,WAAW,CAAC;QACjB,KAAK,QAAQ,CAAC;QACd,KAAK,aAAa;YAChB,OAAO,KAAK,CAAC;QACf,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC;QAC/D,KAAK,MAAM;YACT,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC;YACzC,OAAO,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC;QAC9E,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,IAAI,CAAC;QACd;YACE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,+BAA+B;AAC/B,SAAS,yBAAyB,CAAC,SAA8B;IAC/D,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI;QAC5B,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,UAAU;QACxC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC;KACnC,CAAC,CAAC;AACL,CAAC;AAED,8BAA8B;AAC9B,SAAS,YAAY,CACnB,IAAsD;IAEtD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3C,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACnE,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/F,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACtE,KAAK,MAAM;YACT,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;QACJ,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACnE,KAAK,WAAW,CAAC;QACjB,KAAK,QAAQ,CAAC;QACd,KAAK,aAAa;YAChB,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B;YACE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,oBAAoB,CAC3B,UAA0C;IAE1C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACzC,IAAI,CAAC,GAAG,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CACzD,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAC3B,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CACnD,CAAC;IACF,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,OAAO,cAAc,GAAG,UAAU,CAAC,MAAM,IAAI,aAAa,GAAG,WAAW,EAAE,CAAC;QACzE,aAAa,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5C,cAAc,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,kDAAkD;AAClD,SAAS,+BAA+B,CACtC,QAAmC,EACnC,UAAqC;IAErC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAoB,EAAE;QACpD,IAAI,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,wBAAwB;YAAE,OAAO,EAAE,CAAC;QACtE,IAAI,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,wBAAwB;YAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAChC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,qBAAqB,CAC3D,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAoB,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8CAA8C;AAC9C,SAAS,qBAAqB,CAC5B,gBAAwB,EACxB,aAAqB,EACrB,UAAqC;IAErC,IAAI,gBAAgB,KAAK,UAAU,CAAC,wBAAwB,EAAE,CAAC;QAC7D,OAAO,gBAAgB,GAAG,UAAU,CAAC,wBAAwB,CAAC;IAChE,CAAC;IACD,OAAO,aAAa,GAAG,UAAU,CAAC,qBAAqB,CAAC;AAC1D,CAAC;AAED,2BAA2B;AAC3B,SAAS,gBAAgB,CACvB,UAAqC,EACrC,SAA8B;IAE9B,OAAO,CAAC,qBAAqB,CAC3B,SAAS,CAAC,OAAO,CAAC,QAAQ,EAC1B,SAAS,CAAC,IAAI,CAAC,QAAQ,EACvB,UAAU,CACX,CAAC;AACJ,CAAC;AAED,4CAA4C;AAC5C,SAAS,YAAY,CAAC,KAAY;IAChC,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAE,KAA4B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrG,CAAC"}

package/bin/session/composer/policies/FullHistoryContextPolicy.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 全量历史上下文策略。
+ *
+ * 该策略没有派生状态，适用于短会话、测试或拥有足够上下文窗口的模型。
+ */
+import type { SessionContextPolicy } from "../../../types/session/SessionContextPolicy.js";
+/** 直接把全部 canonical Message 转换为模型历史。 */
+export declare class FullHistoryContextPolicy implements SessionContextPolicy {
+    readonly name = "full_history";
+    /** 全量历史策略不需要创建派生表。 */
+    initialize(): Promise<void>;
+    /** 按 canonical 顺序返回完整模型历史。 */
+    resolve(input: Parameters<SessionContextPolicy["resolve"]>[0]): Promise<{
+        messages: import("@downcity/type").ModelMessage[];
+        diagnostics: {
+            derived: boolean;
+            through_sequence?: number | undefined;
+            policy_name: string;
+        };
+    }>;
+    /** 没有派生状态，因此无法通过恢复改变上下文。 */
+    recover(): Promise<boolean>;
+}
+//# sourceMappingURL=FullHistoryContextPolicy.d.ts.map

package/bin/session/composer/policies/FullHistoryContextPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FullHistoryContextPolicy.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/policies/FullHistoryContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAEpF,uCAAuC;AACvC,qBAAa,wBAAyB,YAAW,oBAAoB;IACnE,QAAQ,CAAC,IAAI,kBAAkB;IAE/B,sBAAsB;IAChB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjC,8BAA8B;IACxB,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;;;;;;;;IAcnE,4BAA4B;IACtB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAGlC"}

package/bin/session/composer/policies/FullHistoryContextPolicy.js

@@ -0,0 +1,31 @@
+/**
+ * 全量历史上下文策略。
+ *
+ * 该策略没有派生状态，适用于短会话、测试或拥有足够上下文窗口的模型。
+ */
+import { session_messages_to_model_messages } from "../../../executor/messages/SessionModelMessages.js";
+/** 直接把全部 canonical Message 转换为模型历史。 */
+export class FullHistoryContextPolicy {
+    name = "full_history";
+    /** 全量历史策略不需要创建派生表。 */
+    async initialize() { }
+    /** 按 canonical 顺序返回完整模型历史。 */
+    async resolve(input) {
+        const messages = await input.storage.list_messages();
+        return {
+            messages: await session_messages_to_model_messages(messages, input.project_root),
+            diagnostics: {
+                policy_name: this.name,
+                ...(messages.at(-1)?.sequence !== undefined
+                    ? { through_sequence: messages.at(-1)?.sequence }
+                    : {}),
+                derived: false,
+            },
+        };
+    }
+    /** 没有派生状态，因此无法通过恢复改变上下文。 */
+    async recover() {
+        return false;
+    }
+}
+//# sourceMappingURL=FullHistoryContextPolicy.js.map

package/bin/session/composer/policies/FullHistoryContextPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FullHistoryContextPolicy.js","sourceRoot":"","sources":["../../../../src/session/composer/policies/FullHistoryContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AAGjG,uCAAuC;AACvC,MAAM,OAAO,wBAAwB;IAC1B,IAAI,GAAG,cAAc,CAAC;IAE/B,sBAAsB;IACtB,KAAK,CAAC,UAAU,KAAmB,CAAC;IAEpC,8BAA8B;IAC9B,KAAK,CAAC,OAAO,CAAC,KAAqD;QACjE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACrD,OAAO;YACL,QAAQ,EAAE,MAAM,kCAAkC,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC;YAChF,WAAW,EAAE;gBACX,WAAW,EAAE,IAAI,CAAC,IAAI;gBACtB,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,SAAS;oBACzC,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE;oBACjD,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO,EAAE,KAAK;aACf;SACF,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,OAAO;QACX,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/bin/session/composer/policies/SessionSummaryPrompts.d.ts

@@ -0,0 +1,16 @@
+/** Session 累计摘要策略使用的稳定提示词。 */
+/** 上下文摘要 system prompt。 */
+export declare const SESSION_SUMMARY_SYSTEM_PROMPT: string;
+/** 构建第一次累计摘要的 prompt。 */
+export declare function build_initial_session_summary_prompt(input: {
+    /** 本次需要压缩的 canonical 对话文本。 */
+    conversation_text: string;
+}): string;
+/** 构建基于旧摘要的增量累计摘要 prompt。 */
+export declare function build_updated_session_summary_prompt(input: {
+    /** 上一次已经持久化的累计摘要。 */
+    previous_summary: string;
+    /** 本次新增的 canonical 对话文本。 */
+    conversation_text: string;
+}): string;
+//# sourceMappingURL=SessionSummaryPrompts.d.ts.map

package/bin/session/composer/policies/SessionSummaryPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionSummaryPrompts.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/policies/SessionSummaryPrompts.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,2BAA2B;AAC3B,eAAO,MAAM,6BAA6B,QAI9B,CAAC;AAEb,yBAAyB;AACzB,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,8BAA8B;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAQT;AAED,6BAA6B;AAC7B,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,qBAAqB;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAYT"}

package/bin/session/composer/policies/SessionSummaryPrompts.js

@@ -0,0 +1,32 @@
+/** Session 累计摘要策略使用的稳定提示词。 */
+/** 上下文摘要 system prompt。 */
+export const SESSION_SUMMARY_SYSTEM_PROMPT = [
+    "You are a context summarization assistant.",
+    "Read the conversation and produce only a structured checkpoint summary.",
+    "Do not continue the conversation or answer its questions.",
+].join("\n");
+/** 构建第一次累计摘要的 prompt。 */
+export function build_initial_session_summary_prompt(input) {
+    return [
+        input.conversation_text.trim(),
+        "",
+        "Create a concise checkpoint another model can use to continue the work.",
+        "Preserve exact requests, constraints, decisions, completed work, pending work, file paths, function names, and errors.",
+        "Use these headings: Goal, Constraints, Progress, Key Decisions, Next Steps, Critical Context.",
+    ].join("\n");
+}
+/** 构建基于旧摘要的增量累计摘要 prompt。 */
+export function build_updated_session_summary_prompt(input) {
+    return [
+        "<previous-summary>",
+        input.previous_summary.trim(),
+        "</previous-summary>",
+        "",
+        input.conversation_text.trim(),
+        "",
+        "Update the checkpoint with the new conversation.",
+        "Preserve still-relevant facts and exact requests, constraints, decisions, file paths, function names, and errors.",
+        "Use these headings: Goal, Constraints, Progress, Key Decisions, Next Steps, Critical Context.",
+    ].join("\n");
+}
+//# sourceMappingURL=SessionSummaryPrompts.js.map

package/bin/session/composer/policies/SessionSummaryPrompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionSummaryPrompts.js","sourceRoot":"","sources":["../../../../src/session/composer/policies/SessionSummaryPrompts.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,2BAA2B;AAC3B,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,4CAA4C;IAC5C,yEAAyE;IACzE,2DAA2D;CAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,yBAAyB;AACzB,MAAM,UAAU,oCAAoC,CAAC,KAGpD;IACC,OAAO;QACL,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC9B,EAAE;QACF,yEAAyE;QACzE,wHAAwH;QACxH,+FAA+F;KAChG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,oCAAoC,CAAC,KAKpD;IACC,OAAO;QACL,oBAAoB;QACpB,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC7B,qBAAqB;QACrB,EAAE;QACF,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC9B,EAAE;QACF,kDAAkD;QAClD,mHAAmH;QACnH,+FAA+F;KAChG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/bin/session/control/SessionInteractions.d.ts

@@ -4,8 +4,8 @@
  * 本模块只拥有 pending waiter、超时与恢复执行；Interaction 的权威状态由
  * SessionMessages 持久化。任何终态都必须先提交 canonical Message，再兑现等待 Promise。
  */
-import type { SessionMessages } from "../SessionMessages.js";
-import type { RespondSessionInteractionInput, SessionInteractionHandle, SessionInteractionLifecycle, SessionInteractionPort, SessionInteractionRequest, SessionInteractionResult, SessionPendingInteraction } from "../../types/session/SessionInteraction.js";
+import type { SessionMessages } from "../../session/SessionMessages.js";
+import type { RespondSessionInteractionInput, SessionInteractionHandle, SessionInteractionLifecycle, SessionInteractionPort, SessionInteractionRequest, SessionInteractionResult, SessionPendingInteraction } from "@downcity/type";
 /** 单个 Session 的异步用户交互入口。 */
 export declare class SessionInteractions implements SessionInteractionPort, SessionInteractionLifecycle {
     private readonly session_id;

package/bin/session/control/SessionInteractions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionInteractions.d.ts","sourceRoot":"","sources":["../../../src/session/control/SessionInteractions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,EAEzB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,uCAAuC,CAAC;AAG/C,4BAA4B;AAC5B,qBAAa,mBAAoB,YAAW,sBAAsB,EAAE,2BAA2B;IAC7F,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG1B;gBAEQ,OAAO,EAAE;QACnB,uCAAuC;QACvC,UAAU,EAAE,MAAM,CAAC;QACnB,yCAAyC;QACzC,QAAQ,EAAE,eAAe,CAAC;KAC3B;IAQD,wCAAwC;IAClC,OAAO,CACX,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAsCpC,gDAAgD;IAChD,IAAI,IAAI,yBAAyB,EAAE;IAMnC,2BAA2B;IACrB,OAAO,CACX,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,wBAAwB,CAAC;IAsBpC,4CAA4C;IACtC,UAAU,CACd,MAAM,EAAE,cAAc,GAAG,kBAAkB,GAAG,qBAAqB,GAClE,OAAO,CAAC,IAAI,CAAC;IAqBhB,6BAA6B;YACf,MAAM;IAgBpB,+BAA+B;IAC/B,OAAO,CAAC,gBAAgB;IAkExB,0BAA0B;IAC1B,OAAO,CAAC,iBAAiB;IAyDzB,oCAAoC;IACpC,OAAO,CAAC,eAAe;IAQvB,6BAA6B;IAC7B,OAAO,CAAC,cAAc;CAUvB"}
+{"version":3,"file":"SessionInteractions.d.ts","sourceRoot":"","sources":["../../../src/session/control/SessionInteractions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,EAEzB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AAGxB,4BAA4B;AAC5B,qBAAa,mBAAoB,YAAW,sBAAsB,EAAE,2BAA2B;IAC7F,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG1B;gBAEQ,OAAO,EAAE;QACnB,uCAAuC;QACvC,UAAU,EAAE,MAAM,CAAC;QACnB,yCAAyC;QACzC,QAAQ,EAAE,eAAe,CAAC;KAC3B;IAQD,wCAAwC;IAClC,OAAO,CACX,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAsCpC,gDAAgD;IAChD,IAAI,IAAI,yBAAyB,EAAE;IAMnC,2BAA2B;IACrB,OAAO,CACX,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,wBAAwB,CAAC;IAsBpC,4CAA4C;IACtC,UAAU,CACd,MAAM,EAAE,cAAc,GAAG,kBAAkB,GAAG,qBAAqB,GAClE,OAAO,CAAC,IAAI,CAAC;IAqBhB,6BAA6B;YACf,MAAM;IAgBpB,+BAA+B;IAC/B,OAAO,CAAC,gBAAgB;IAkExB,0BAA0B;IAC1B,OAAO,CAAC,iBAAiB;IAyDzB,oCAAoC;IACpC,OAAO,CAAC,eAAe;IAQvB,6BAA6B;IAC7B,OAAO,CAAC,cAAc;CAUvB"}

package/bin/session/execution/SessionAssistantOutputAdapter.d.ts

@@ -5,9 +5,9 @@
  * Action 内容转交给 Writer；`SessionMessages` 始终是唯一事实源。
  */
 import type { ModelStreamEvent } from "@downcity/type";
-import { SessionMessages } from "../SessionMessages.js";
-import type { SessionAssistantResultPart } from "../../types/session/SessionContent.js";
-import type { SessionAssistantMessagePart } from "../../types/session/SessionMessage.js";
+import { SessionMessages } from "../../session/SessionMessages.js";
+import type { SessionAgentContent } from "@downcity/type";
+import type { SessionAgentMessagePart } from "@downcity/type";
 import type { SessionAssistantOutput } from "../../types/executor/SessionAssistantOutput.js";
 import type { SessionToolExecutionResult, SessionToolInputReady } from "../../types/session/SessionTool.js";
 /** 单个 Turn 使用的 Assistant 输出 Adapter。 */
@@ -32,13 +32,24 @@ export declare class SessionAssistantOutputAdapter implements SessionAssistantOu
     /** 写入 Tool 执行终态。 */
     write_tool_result(result: SessionToolExecutionResult): Promise<void>;
     /** 使用模型聚合出的 canonical Parts 校验当前 Step。 */
-    finish_step(parts: SessionAssistantMessagePart[]): Promise<void>;
+    finish_step(parts: SessionAgentMessagePart[]): Promise<void>;
     /** 清理异常结束的 Step 作用域。 */
     abort_step(): Promise<void>;
     /** User steer 持久化后关闭它之前的当前 Assistant Message。 */
     close_current_message(): Promise<void>;
     /** 追加 Action 产生的封闭 Assistant 内容。 */
-    append_result_parts(parts: readonly SessionAssistantResultPart[]): Promise<void>;
+    append_result_parts(parts: readonly SessionAgentContent[]): Promise<SessionAgentMessagePart[]>;
+    /** 在 Turn 收口产物之前追加用户可见的 canonical Error Part。 */
+    append_error(input: {
+        /** 错误影响范围。 */
+        scope: "session" | "turn";
+        /** 稳定错误码。 */
+        code: string;
+        /** 用户可见错误信息。 */
+        message: string;
+        /** 当前错误是否允许重试恢复。 */
+        recoverable: boolean;
+    }): Promise<void>;
     /** 按 Turn 结果收口最后一个 canonical Message。 */
     finish(input: {
         /** Assistant 最终状态。 */