@downcity/agent 1.1.438 → 1.1.446

package/bin/session/input/StepInput.js

@@ -0,0 +1,429 @@
+/**
+ * StepInput：为每个 Step 准备发给模型的输入。
+ *
+ * 关键点（中文）
+ * - 同时拥有「冻结的 system 快照」与「每步宿主事实采集」，因为二者互为前提：首次组装
+ *   的结果就是快照，而快照一旦冻结就不再重新采集 Power system。
+ * - 只产出输入，不发请求、不判断是否继续；请求与循环归 `SessionExecutor`。
+ * - 不拥有 Message、Turn 或 Store 生命周期。
+ */
+import { is_action_result } from "@downcity/type";
+import { SESSION_HOOK_POINTS } from "@downcity/type";
+import { run_pipeline_point } from "../../session/input/SessionHookRunner.js";
+import { resolve_session_power_system_blocks } from "../../session/input/SessionSystem.js";
+/** 当前 Session 的每步模型输入装配者。 */
+export class StepInput {
+    options;
+    effective_instruction_blocks;
+    /** 当前 Session 首次组装后冻结的完整 system；null 表示尚未冻结。 */
+    frozen_blocks = null;
+    /** 当前 Session 的一次性初始化任务。 */
+    initialize_promise = null;
+    /** 串行化 snapshot / syncshot 对 system 与 instruction.md 的修改。 */
+    mutation_chain = Promise.resolve();
+    constructor(options) {
+        this.options = options;
+        this.effective_instruction_blocks = options.instruction_system_blocks.map((block) => ({ ...block }));
+    }
+    /** 初始化派生 schema，并恢复显式固化的 system 快照。 */
+    async initialize() {
+        if (!this.initialize_promise) {
+            this.initialize_promise = (async () => {
+                await this.options.store.initialize();
+                await this.options.composer.initialize({ derived: this.derived_store() });
+                const persisted_instruction = await this.options.store.read_instruction();
+                if (persisted_instruction === null)
+                    return;
+                const instruction = persisted_instruction.trim();
+                this.frozen_blocks = instruction
+                    ? [{
+                            source: "instruction",
+                            name: "snapshot",
+                            content: instruction,
+                        }]
+                    : [];
+                const stable_system_blocks = this.effective_instruction_blocks
+                    .filter((block) => block.source !== "instruction")
+                    .map((block) => ({ ...block }));
+                this.effective_instruction_blocks = [
+                    ...(instruction
+                        ? [{
+                                source: "instruction",
+                                name: "agent",
+                                content: instruction,
+                            }]
+                        : []),
+                    ...stable_system_blocks,
+                ];
+            })();
+        }
+        const initialize_promise = this.initialize_promise;
+        try {
+            await initialize_promise;
+        }
+        catch (error) {
+            if (this.initialize_promise === initialize_promise) {
+                this.initialize_promise = null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * 为下一个 Provider Step 组装唯一一份输入。
+     *
+     * 关键点（中文）
+     * - 调用方必须先提交 Session 统一输入队列，再调用本方法。
+     * - 首次调用会把组装出的完整 system 冻结为当前 Session 的 system 快照。
+     */
+    async build(turn_context, advance_count) {
+        const compose_input = await this.gather(turn_context, advance_count);
+        const model = compose_input.state.model;
+        if (!model)
+            throw new Error("requires a configured model.");
+        turn_context.step.commit({
+            workspace_env: compose_input.state.env,
+            agent_systems: compose_input.state.systems,
+        });
+        const composed = await this.options.composer.compose(compose_input);
+        const frozen = this.apply_frozen_system(composed);
+        return {
+            model,
+            system: frozen.system,
+            messages: frozen.messages,
+            tools: this.bind_turn_context_to_tools(frozen.tools, turn_context),
+            ...(compose_input.state.model_context_window !== undefined
+                ? { context_window: compose_input.state.model_context_window }
+                : {}),
+        };
+    }
+    /** 把当前完整 system 显式固化到 instruction.md。 */
+    async snapshot() {
+        await this.run_mutation(async () => {
+            const system_snapshot = await this.read_system();
+            await this.write_snapshot(system_snapshot.blocks);
+        });
+    }
+    /** 使用 Agent 当前 instruction 与 Power 重新生成完整 system。 */
+    async syncshot() {
+        await this.run_mutation(async () => {
+            await this.initialize();
+            const should_persist = await this.options.store.has_instruction();
+            const composed = await this.options.composer.compose(await this.gather(undefined, 0, true));
+            const next_blocks = resolve_composed_system_blocks(composed);
+            if (should_persist)
+                await this.write_snapshot(next_blocks);
+            this.effective_instruction_blocks =
+                this.options.get_instruction_system_blocks().map((block) => ({ ...block }));
+            this.frozen_blocks = next_blocks;
+        });
+    }
+    /** 读取当前 Session 生效的完整 system 快照。 */
+    async read_system() {
+        await this.initialize();
+        const composed = await this.options.composer.compose(await this.gather(undefined, 0));
+        return {
+            session_id: this.options.session_id,
+            session: {
+                agent_id: this.options.agent_id,
+                session_id: this.options.session_id,
+                project_root: this.options.workspace_path,
+                created_at: new Date(this.options.get_created_at()).toISOString(),
+                timezone: this.options.get_timezone(),
+            },
+            blocks: resolve_composed_system_blocks(this.apply_frozen_system(composed)),
+        };
+    }
+    /** 返回当前 Session 捕获的 instruction blocks 副本。 */
+    instruction_blocks() {
+        return this.effective_instruction_blocks.map((block) => ({ ...block }));
+    }
+    /** 创建 Composer 共用的稳定 Session 身份快照。 */
+    identity() {
+        return {
+            agent_id: this.options.agent_id,
+            session_id: this.options.session_id,
+            project_root: this.options.workspace_path,
+            created_at: this.options.get_created_at(),
+            timezone: this.options.get_timezone(),
+        };
+    }
+    /** 采集当前 Step 的宿主事实，交给 Composer 组装。 */
+    async gather(turn_context, advance_count, refresh_system = false) {
+        const instruction_system_blocks = refresh_system
+            ? this.options.get_instruction_system_blocks().map((block) => ({ ...block }))
+            : this.instruction_blocks();
+        const workspace_env = Object.freeze({ ...this.options.get_workspace_env() });
+        // Power system 参与 Compose，必须先看到当前检查点已确定的 env 与 instruction。
+        turn_context?.step.commit({
+            workspace_env,
+            agent_systems: instruction_system_blocks.map((block) => block.content),
+        });
+        const call_context = turn_context
+            ? this.create_tool_call_context(turn_context, {
+                tool_call_id: "",
+                messages: [],
+            })
+            : this.create_session_call_context(workspace_env);
+        const hooks = this.options.get_hooks();
+        const resolved_power_system_blocks = this.frozen_blocks && !refresh_system
+            ? []
+            : await resolve_session_power_system_blocks({
+                session_id: this.options.session_id,
+                ...(turn_context?.session.turn_id
+                    ? { turn_id: turn_context.session.turn_id }
+                    : {}),
+                hooks,
+                context: call_context,
+                on_error: async (error) => await this.log_power_hook_warning(SESSION_HOOK_POINTS.system_context, error, turn_context?.session.turn_id),
+            });
+        const power_context_blocks = turn_context
+            ? await turn_context.step.resolve_power_context_blocks(async () => {
+                const value = {
+                    session_id: this.options.session_id,
+                    turn_id: turn_context.session.turn_id,
+                    user_messages: turn_context.input.user_messages().map((message) => ({
+                        message_id: message.message_id,
+                        text: message.parts
+                            .filter((part) => part.type === "text")
+                            .map((part) => part.text)
+                            .join("\n"),
+                    })),
+                    blocks: [],
+                };
+                try {
+                    const output = await run_pipeline_point({
+                        hooks,
+                        point_name: SESSION_HOOK_POINTS.turn_context,
+                        value: value,
+                        context: call_context,
+                    });
+                    return normalize_power_context_blocks(output?.blocks);
+                }
+                catch (error) {
+                    await this.log_power_hook_warning(SESSION_HOOK_POINTS.turn_context, error, turn_context.session.turn_id);
+                    return [];
+                }
+            })
+            : [];
+        return {
+            session: this.identity(),
+            state: {
+                model: this.options.get_model(),
+                model_context_window: this.options.get_model_context_window(),
+                env: workspace_env,
+                systems: Object.freeze(instruction_system_blocks.map((block) => block.content)),
+                tools: Object.freeze({ ...this.options.get_tools() }),
+                instruction_system_blocks,
+                power_system_blocks: resolved_power_system_blocks,
+                power_context_blocks,
+            },
+            history: await this.options.store.list_messages(),
+            derived: this.derived_store(),
+            turn: {
+                ...(turn_context ? { turn_id: turn_context.session.turn_id } : {}),
+                advance_count,
+            },
+        };
+    }
+    /** 返回当前 Composer 命名空间的派生存储视图。 */
+    derived_store() {
+        return this.options.store.derived_store(this.options.composer.name);
+    }
+    /**
+     * 冻结或套用当前 Session 的 system 快照。
+     *
+     * 关键点（中文）：首次调用把组装结果记成快照；之后每次都覆盖为快照，保证同一 Session
+     * 的 system 不再漂移。
+     */
+    apply_frozen_system(input) {
+        if (!this.frozen_blocks) {
+            this.frozen_blocks = resolve_composed_system_blocks(input);
+        }
+        return {
+            ...input,
+            system: this.frozen_blocks.map((block) => ({
+                role: "system",
+                content: block.content,
+            })),
+            system_blocks: this.frozen_blocks.map((block) => ({ ...block })),
+        };
+    }
+    /** Power 上下文 Hook 失败只降级当前扩展内容。 */
+    async log_power_hook_warning(point_name, error, turn_id) {
+        try {
+            await this.options.logger.log("warn", "[agent] session power hook failed", {
+                session_id: this.options.session_id,
+                ...(turn_id ? { turn_id } : {}),
+                point_name,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        catch {
+            // Power 已经降级，日志失败不能反向阻断 Session。
+        }
+    }
+    /** 串行执行一次 Session system 修改。 */
+    async run_mutation(operation) {
+        const next = this.mutation_chain.then(operation, operation);
+        this.mutation_chain = next.catch(() => undefined);
+        await next;
+    }
+    /** 把指定完整 system blocks 原子写入 instruction.md。 */
+    async write_snapshot(blocks) {
+        await this.options.store.write_instruction(blocks.map((block) => block.content).join("\n\n"));
+    }
+    /**
+     * 把工具包装为已绑定调用环境的工具。
+     *
+     * 关键点（中文）
+     * - 包装层是上下文注入的唯一位置：捕获 Session 级信息，并在每次调用时
+     *   合并模型 Step 提供的调用身份与消息快照。
+     * - 每个 step 使用独立包装，不会在并行 Session 间共享可变指针。
+     */
+    bind_turn_context_to_tools(tools, turn_context) {
+        const wrapped = {};
+        for (const [name, tool] of Object.entries(tools)) {
+            const original_execute = tool.execute;
+            if (typeof original_execute !== "function") {
+                wrapped[name] = tool;
+                continue;
+            }
+            wrapped[name] = {
+                ...tool,
+                execute: async (args, site) => {
+                    const tool_call_id = String(site.tool_call_id || "").trim();
+                    if (!tool_call_id) {
+                        throw new Error(`Tool execution requires toolCallId: ${name}`);
+                    }
+                    if (turn_context.output.assistant) {
+                        await turn_context.output.assistant.prepare_tool_input({
+                            tool_call_id,
+                            tool_name: name,
+                            input: args,
+                        });
+                    }
+                    const context = this.create_tool_call_context(turn_context, {
+                        tool_call_id,
+                        abort_signal: site.abort_signal || turn_context.lifecycle.abort_signal,
+                        messages: site.messages,
+                    });
+                    const output = await original_execute(args, context);
+                    if (!is_action_result(output))
+                        return output;
+                    if (Array.isArray(output.effects)) {
+                        turn_context.effects.append(output.effects);
+                    }
+                    for (const message of output.messages) {
+                        if (message.role === "agent") {
+                            turn_context.output.enqueue_assistant_parts(message.parts);
+                            continue;
+                        }
+                        await turn_context.input.append_internal(message.parts);
+                    }
+                    return output.output;
+                },
+            };
+        }
+        return wrapped;
+    }
+    /** 构造不属任何 Turn 的调用环境；用于 system 查询。 */
+    create_session_call_context(workspace_env) {
+        const workspace = this.options.get_workspace?.();
+        return Object.freeze({
+            agent_id: this.options.agent_id,
+            agent_name: this.options.agent_name,
+            agent_description: this.options.agent_description,
+            agent_instructions: Object.freeze(this.effective_instruction_blocks.map((block) => block.content)),
+            session_id: this.options.session_id,
+            session_origin: this.options.session_origin,
+            ...(workspace ? { workspace } : {}),
+            messages: Object.freeze([]),
+            workspace_env,
+        });
+    }
+    /** 构造一次工具调用获得的值快照。 */
+    create_tool_call_context(turn_context, site) {
+        const workspace_env = turn_context.step.workspace_env;
+        const agent_systems = turn_context.step.agent_systems;
+        const workspace = this.options.get_workspace?.();
+        return Object.freeze({
+            agent_id: this.options.agent_id,
+            agent_name: this.options.agent_name,
+            agent_description: this.options.agent_description,
+            agent_instructions: Object.freeze([...(agent_systems ?? [])]),
+            session_id: this.options.session_id,
+            session_origin: this.options.session_origin,
+            ...(workspace ? { workspace } : {}),
+            turn_id: turn_context.session.turn_id,
+            abort_signal: site.abort_signal,
+            tool_call_id: site.tool_call_id,
+            messages: site.messages,
+            interactions: turn_context.interactions,
+            ...(workspace_env ? { workspace_env } : {}),
+        });
+    }
+}
+/** 把 Turn pipeline 输出限制为低权限动态参考内容块。 */
+function normalize_power_context_blocks(input) {
+    if (!Array.isArray(input))
+        return [];
+    return input.flatMap((item) => {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            return [];
+        const record = item;
+        const source_power = String(record.source_power || "").trim();
+        const name = String(record.name || "").trim();
+        const content = String(record.content || "").trim();
+        if (!source_power ||
+            !name ||
+            !content ||
+            record.trust_level !== "reference")
+            return [];
+        const citations = Array.isArray(record.citations)
+            ? record.citations
+                .map((citation) => String(citation || "").trim())
+                .filter(Boolean)
+            : [];
+        const version = String(record.version || "").trim();
+        return [{
+                source_power,
+                name,
+                content,
+                trust_level: "reference",
+                ...(citations.length > 0 ? { citations } : {}),
+                ...(version ? { version } : {}),
+            }];
+    });
+}
+/** 把自定义 Composer 的 system content 转为可展示文本。 */
+function stringify_system_content(content) {
+    if (typeof content === "string")
+        return content.trim();
+    if (content === null || content === undefined)
+        return "";
+    try {
+        return JSON.stringify(content);
+    }
+    catch {
+        return String(content || "").trim();
+    }
+}
+/** 以实际模型输入为准，保留仍与其一致的 system block 来源信息。 */
+function resolve_composed_system_blocks(composed) {
+    const declared_blocks = composed.system_blocks || [];
+    return composed.system.flatMap((message, index) => {
+        const content = stringify_system_content(message.content);
+        if (!content)
+            return [];
+        const declared = declared_blocks[index];
+        if (declared && declared.content.trim() === content) {
+            return [{ ...declared, content }];
+        }
+        return [{
+                source: "session",
+                name: `custom_system:${index + 1}`,
+                content,
+            }];
+    });
+}
+//# sourceMappingURL=StepInput.js.map

package/bin/session/input/StepInput.js.map

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

package/bin/session/input/composer/AdaptiveContextCheckpoint.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 上下文 checkpoint 的派生表读写。
+ *
+ * checkpoint 只记录「累计摘要覆盖到哪个 canonical Part」。它属于 Composer 自己的派生
+ * 数据：结构不兼容时直接丢弃重建，因为摘要可以从 canonical history 重新累积。
+ */
+import type { ContextCheckpointRow } from "../../../types/session/ContextCheckpoint.js";
+import type { SessionDerivedStore } from "../../../types/store/SessionStorage.js";
+/** checkpoint schema 版本；版本或列结构变化时旧派生表会被重建。 */
+export declare const CHECKPOINT_SCHEMA_VERSION = 1;
+/** 返回指定 Composer 命名空间的 checkpoint 表名。 */
+export declare function checkpoint_table(composer_name: string): string;
+/**
+ * 建立 checkpoint schema。
+ *
+ * 关键点（中文）：派生表可以重建，因此旧结构的表在初始化时被丢弃；新表从当前
+ * canonical history 重新累积摘要，不需要迁移脚本。
+ */
+export declare function initialize_checkpoint_schema(derived: SessionDerivedStore, composer_name: string): Promise<void>;
+/** 读取当前版本位置最靠后的累计 checkpoint。 */
+export declare function read_latest_checkpoint(derived: SessionDerivedStore, composer_name: string): Promise<ContextCheckpointRow | null>;
+/** 追加一条累计 checkpoint。 */
+export declare function insert_checkpoint(derived: SessionDerivedStore, composer_name: string, input: {
+    /** 边界所属 Message 标识。 */
+    through_message_id: string;
+    /** 边界所属 Message sequence。 */
+    through_message_sequence: number;
+    /** 边界 Part sequence。 */
+    through_part_sequence: number;
+    /** 截至边界的累计摘要正文。 */
+    summary: string;
+}): Promise<void>;
+//# sourceMappingURL=AdaptiveContextCheckpoint.d.ts.map

package/bin/session/input/composer/AdaptiveContextCheckpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptiveContextCheckpoint.d.ts","sourceRoot":"","sources":["../../../../src/session/input/composer/AdaptiveContextCheckpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,iCAAiC;AACjC,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAYtC;AAED,yBAAyB;AACzB,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE;IACL,uBAAuB;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/bin/session/input/composer/AdaptiveContextCheckpoint.js

@@ -0,0 +1,83 @@
+/**
+ * 上下文 checkpoint 的派生表读写。
+ *
+ * checkpoint 只记录「累计摘要覆盖到哪个 canonical Part」。它属于 Composer 自己的派生
+ * 数据：结构不兼容时直接丢弃重建，因为摘要可以从 canonical history 重新累积。
+ */
+import { generate_id } from "../../../utils/Id.js";
+/** checkpoint schema 版本；版本或列结构变化时旧派生表会被重建。 */
+export const CHECKPOINT_SCHEMA_VERSION = 1;
+/** 返回指定 Composer 命名空间的 checkpoint 表名。 */
+export function checkpoint_table(composer_name) {
+    return `composer_${composer_name}_checkpoints`;
+}
+/**
+ * 建立 checkpoint schema。
+ *
+ * 关键点（中文）：派生表可以重建，因此旧结构的表在初始化时被丢弃；新表从当前
+ * canonical history 重新累积摘要，不需要迁移脚本。
+ */
+export async function initialize_checkpoint_schema(derived, composer_name) {
+    const table = checkpoint_table(composer_name);
+    const compatible = await has_compatible_schema(derived, table);
+    await derived.transaction((transaction) => {
+        if (!compatible)
+            transaction.execute(`DROP TABLE IF EXISTS ${table}`);
+        transaction.execute(`
+      CREATE TABLE IF NOT EXISTS ${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,
+        schema_version INTEGER NOT NULL,
+        created_at INTEGER NOT NULL,
+        UNIQUE(through_message_sequence, through_part_sequence, schema_version)
+      )
+    `);
+    });
+}
+/** 读取当前版本位置最靠后的累计 checkpoint。 */
+export async function read_latest_checkpoint(derived, composer_name) {
+    const table = checkpoint_table(composer_name);
+    return await derived.transaction((transaction) => transaction.get(`
+      SELECT checkpoint_id, through_message_id, through_message_sequence,
+             through_part_sequence, summary, schema_version, created_at
+      FROM ${table}
+      WHERE schema_version = ?
+      ORDER BY through_message_sequence DESC, through_part_sequence DESC
+      LIMIT 1
+    `, [CHECKPOINT_SCHEMA_VERSION]));
+}
+/** 追加一条累计 checkpoint。 */
+export async function insert_checkpoint(derived, composer_name, input) {
+    const table = checkpoint_table(composer_name);
+    await derived.transaction((transaction) => {
+        transaction.execute(`
+      INSERT INTO ${table} (
+        checkpoint_id, through_message_id, through_message_sequence,
+        through_part_sequence, summary, schema_version, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?)
+    `, [
+            `checkpoint:${generate_id()}`,
+            input.through_message_id,
+            input.through_message_sequence,
+            input.through_part_sequence,
+            input.summary,
+            CHECKPOINT_SCHEMA_VERSION,
+            Date.now(),
+        ]);
+    });
+}
+/** 探测现有派生表是否具备当前列结构。 */
+async function has_compatible_schema(derived, table) {
+    try {
+        await derived.transaction((transaction) => transaction.get(`SELECT schema_version FROM ${table} LIMIT 1`));
+        return true;
+    }
+    catch {
+        // 表缺失或列结构不兼容都由建表语句一次性收敛。
+        return false;
+    }
+}
+//# sourceMappingURL=AdaptiveContextCheckpoint.js.map

package/bin/session/input/composer/AdaptiveContextCheckpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptiveContextCheckpoint.js","sourceRoot":"","sources":["../../../../src/session/input/composer/AdaptiveContextCheckpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,aAAqB;IACpD,OAAO,YAAY,aAAa,cAAc,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAA4B,EAC5B,aAAqB;IAErB,MAAM,KAAK,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/D,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE;QACxC,IAAI,CAAC,UAAU;YAAE,WAAW,CAAC,OAAO,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;QACtE,WAAW,CAAC,OAAO,CAAC;mCACW,KAAK;;;;;;;;;;KAUnC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA4B,EAC5B,aAAqB;IAErB,MAAM,KAAK,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,OAAO,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE,CAC/C,WAAW,CAAC,GAAG,CAAuB;;;aAG7B,KAAK;;;;KAIb,EAAE,CAAC,yBAAyB,CAAC,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA4B,EAC5B,aAAqB,EACrB,KASC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE;QACxC,WAAW,CAAC,OAAO,CAAC;oBACJ,KAAK;;;;KAIpB,EAAE;YACD,cAAc,WAAW,EAAE,EAAE;YAC7B,KAAK,CAAC,kBAAkB;YACxB,KAAK,CAAC,wBAAwB;YAC9B,KAAK,CAAC,qBAAqB;YAC3B,KAAK,CAAC,OAAO;YACb,yBAAyB;YACzB,IAAI,CAAC,GAAG,EAAE;SACX,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,wBAAwB;AACxB,KAAK,UAAU,qBAAqB,CAClC,OAA4B,EAC5B,KAAa;IAEb,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE,CACxC,WAAW,CAAC,GAAG,CAAC,8BAA8B,KAAK,UAAU,CAAC,CAC/D,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/bin/session/input/composer/AdaptiveContextParts.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 上下文 checkpoint 的纯算法部分。
+ *
+ * 这里没有任何存储或模型调用：调用方提供 canonical history 快照与 checkpoint，
+ * 本模块只决定哪些 Part 值得进入摘要、边界落在哪里、以及裁剪后剩下什么。
+ *
+ * 关键点（中文）：Part 数量不代表上下文压力。一个巨大的 Tool/Text Part 可以独自占满
+ * 窗口，因此选择使用送入摘要模型的序列化字符体积作为轻量估算。
+ */
+import type { SessionMessage } from "@downcity/type";
+import type { ContextCheckpointRow, StableContextPart } from "../../../types/session/ContextCheckpoint.js";
+/** 收集 checkpoint 之后适合进入摘要的稳定 Part。 */
+export declare function collect_stable_parts(messages: readonly SessionMessage[], checkpoint: ContextCheckpointRow | null): StableContextPart[];
+/**
+ * 选择足以释放约一半原始上下文体积的最旧 Part。
+ *
+ * 关键点（中文）：至少推进一个 Part，保证只有一个可用 Part 时仍能建立边界。
+ */
+export declare function select_compact_parts(candidates: readonly StableContextPart[]): StableContextPart[];
+/** 把单个 Part 收窄为摘要模型需要的稳定事实。 */
+export declare function candidate_to_summary_text(candidate: StableContextPart): string;
+/** 删除 checkpoint 以前的 Part；边界可以位于单个 Message 内部。 */
+export declare function slice_messages_after_checkpoint(messages: readonly SessionMessage[], checkpoint: ContextCheckpointRow): SessionMessage[];
+/** 比较 checkpoint 与候选边界，checkpoint 位于候选之前时返回负数。 */
+export declare function compare_position(checkpoint: ContextCheckpointRow, candidate: StableContextPart): number;
+//# sourceMappingURL=AdaptiveContextParts.d.ts.map

package/bin/session/input/composer/AdaptiveContextParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptiveContextParts.d.ts","sourceRoot":"","sources":["../../../../src/session/input/composer/AdaptiveContextParts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAEV,cAAc,EAEf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,sCAAsC,CAAC;AAE9C,sCAAsC;AACtC,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,UAAU,EAAE,oBAAoB,GAAG,IAAI,GACtC,iBAAiB,EAAE,CAQrB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,SAAS,iBAAiB,EAAE,GACvC,iBAAiB,EAAE,CAerB;AAED,+BAA+B;AAC/B,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAM9E;AAED,kDAAkD;AAClD,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,UAAU,EAAE,oBAAoB,GAC/B,cAAc,EAAE,CAUlB;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,oBAAoB,EAChC,SAAS,EAAE,iBAAiB,GAC3B,MAAM,CAMR"}