@downcity/agent 1.1.438 → 1.1.446

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

@@ -0,0 +1,124 @@
+/**
+ * 上下文 checkpoint 的纯算法部分。
+ *
+ * 这里没有任何存储或模型调用：调用方提供 canonical history 快照与 checkpoint，
+ * 本模块只决定哪些 Part 值得进入摘要、边界落在哪里、以及裁剪后剩下什么。
+ *
+ * 关键点（中文）：Part 数量不代表上下文压力。一个巨大的 Tool/Text Part 可以独自占满
+ * 窗口，因此选择使用送入摘要模型的序列化字符体积作为轻量估算。
+ */
+/** 收集 checkpoint 之后适合进入摘要的稳定 Part。 */
+export 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。
+ *
+ * 关键点（中文）：至少推进一个 Part，保证只有一个可用 Part 时仍能建立边界。
+ */
+export 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));
+}
+/** 把单个 Part 收窄为摘要模型需要的稳定事实。 */
+export function candidate_to_summary_text(candidate) {
+    return JSON.stringify({
+        role: candidate.message.role,
+        message_id: candidate.message.message_id,
+        part: summary_part(candidate.part),
+    });
+}
+/** 删除 checkpoint 以前的 Part；边界可以位于单个 Message 内部。 */
+export 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 }];
+    });
+}
+/** 比较 checkpoint 与候选边界，checkpoint 位于候选之前时返回负数。 */
+export function compare_position(checkpoint, candidate) {
+    return -compare_part_position(candidate.message.sequence, candidate.part.sequence, checkpoint);
+}
+/** 判断 Part 是否稳定且值得占据累计摘要。 */
+function is_stable_summary_part(message, part) {
+    switch (part.type) {
+        case "reasoning":
+        case "action":
+            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);
+    }
+}
+/** 删除瞬时字段并保留 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":
+            return { type: part.type };
+        default:
+            return assert_never(part);
+    }
+}
+/** 比较 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;
+}
+/** canonical Part 联合类型新增成员时强制摘要算法显式选择语义。 */
+function assert_never(value) {
+    throw new Error(`Unsupported summary Session Part: ${String(value.type)}`);
+}
+//# sourceMappingURL=AdaptiveContextParts.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Composer 共用的组装原语。
+ *
+ * 本模块只做无状态的纯组装：把已冻结的 Step 状态转成 system blocks，并把 Power 动态
+ * 参考内容注入模型消息副本。所有内置 Composer 都复用这里，避免各自复制 system 与
+ * Power 拼接逻辑。
+ */
+import type { AgentSessionSystemBlock } from "../../../types/agent/SessionTypes.js";
+import type { SessionHookContextBlock } from "@downcity/type";
+import type { SessionComposeInput } from "../../../types/session/SessionComposer.js";
+import type { SessionSystemMessage } from "@downcity/type";
+import type { ModelMessage } from "@downcity/type";
+/** 把当前 Step 生效的 instruction 与 Power blocks 组装成 system blocks。 */
+export declare function build_composer_system_blocks(input: SessionComposeInput): Promise<AgentSessionSystemBlock[]>;
+/** 把 system blocks 投影为模型 system messages。 */
+export declare function to_system_messages(blocks: readonly AgentSessionSystemBlock[]): SessionSystemMessage[];
+/** 把低权限 Power 内容渲染为与用户原文分离的模型参考区。 */
+export declare function render_power_context_blocks(blocks: readonly SessionHookContextBlock[]): string;
+/** 只修改模型消息副本，把动态参考信息前置到当前最后一条 User Message。 */
+export declare function inject_power_context(messages: ModelMessage[], blocks: readonly SessionHookContextBlock[]): ModelMessage[];
+//# sourceMappingURL=ComposerAssembly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerAssembly.d.ts","sourceRoot":"","sources":["../../../../src/session/input/composer/ComposerAssembly.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,iEAAiE;AACjE,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAcpC;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,uBAAuB,EAAE,GACzC,oBAAoB,EAAE,CAKxB;AAED,qCAAqC;AACrC,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,uBAAuB,EAAE,GACzC,MAAM,CAMR;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,EAAE,SAAS,uBAAuB,EAAE,GACzC,YAAY,EAAE,CAYhB"}

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

@@ -0,0 +1,64 @@
+/**
+ * Composer 共用的组装原语。
+ *
+ * 本模块只做无状态的纯组装：把已冻结的 Step 状态转成 system blocks，并把 Power 动态
+ * 参考内容注入模型消息副本。所有内置 Composer 都复用这里，避免各自复制 system 与
+ * Power 拼接逻辑。
+ */
+import { build_session_system_blocks } from "../../../session/input/SessionSystem.js";
+/** 把当前 Step 生效的 instruction 与 Power blocks 组装成 system blocks。 */
+export async function build_composer_system_blocks(input) {
+    return await build_session_system_blocks({
+        agent_id: input.session.agent_id,
+        project_root: input.session.project_root,
+        session_id: input.session.session_id,
+        created_at: input.session.created_at,
+        timezone: input.session.timezone,
+        get_instruction_system_blocks: () => [
+            ...(input.state.instruction_system_blocks ?? []),
+        ],
+        get_power_system_blocks: async () => [
+            ...(input.state.power_system_blocks ?? []),
+        ],
+    });
+}
+/** 把 system blocks 投影为模型 system messages。 */
+export function to_system_messages(blocks) {
+    return blocks.map((block) => ({
+        role: "system",
+        content: block.content,
+    }));
+}
+/** 把低权限 Power 内容渲染为与用户原文分离的模型参考区。 */
+export function render_power_context_blocks(blocks) {
+    return blocks.map((block) => [
+        `<extension-context extension="${escape_xml_attribute(block.source_power)}" name="${escape_xml_attribute(block.name)}" trust="reference">`,
+        block.content,
+        "</extension-context>",
+    ].join("\n")).join("\n\n");
+}
+/** 只修改模型消息副本，把动态参考信息前置到当前最后一条 User Message。 */
+export function inject_power_context(messages, blocks) {
+    if (blocks.length === 0)
+        return messages;
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (!message || message.role !== "user")
+            continue;
+        messages[index] = {
+            ...message,
+            content: [{ type: "text", text: render_power_context_blocks(blocks) }, ...message.content],
+        };
+        break;
+    }
+    return messages;
+}
+/** 转义模型上下文标签属性，避免 Power 名称破坏边界。 */
+function escape_xml_attribute(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("\"", "&quot;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;");
+}
+//# sourceMappingURL=ComposerAssembly.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerAssembly.js","sourceRoot":"","sources":["../../../../src/session/input/composer/ComposerAssembly.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,KAA0B;IAE1B,OAAO,MAAM,2BAA2B,CAAC;QACvC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;QAChC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY;QACxC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU;QACpC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU;QACpC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;QAChC,6BAA6B,EAAE,GAAG,EAAE,CAAC;YACnC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC;SACjD;QACD,uBAAuB,EAAE,KAAK,IAAI,EAAE,CAAC;YACnC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC;SAC3C;KACF,CAAC,CAAC;AACL,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,kBAAkB,CAChC,MAA0C;IAE1C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,QAAiB;QACvB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,2BAA2B,CACzC,MAA0C;IAE1C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3B,iCAAiC,oBAAoB,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB;QAC1I,KAAK,CAAC,OAAO;QACb,sBAAsB;KACvB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,oBAAoB,CAClC,QAAwB,EACxB,MAA0C;IAE1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzC,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QAClD,QAAQ,CAAC,KAAK,CAAC,GAAG;YAChB,GAAG,OAAO;YACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;SAC3F,CAAC;QACF,MAAM;IACR,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,mCAAmC;AACnC,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;SAC1B,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/bin/session/{composer/policies/SessionSummaryPrompts.d.ts → input/composer/ContextSummaryPrompts.d.ts}

@@ -1,6 +1,8 @@
-/** Session 累计摘要策略使用的稳定提示词。 */
+/** Session 累计摘要使用的稳定提示词。 */
+/** 摘要模型可使用的最大输出 token。 */
+export declare const CONTEXT_SUMMARY_MAX_OUTPUT_TOKENS = 4000;
 /** 上下文摘要 system prompt。 */
-export declare const SESSION_SUMMARY_SYSTEM_PROMPT: string;
+export declare const CONTEXT_SUMMARY_SYSTEM_PROMPT: string;
 /** 构建第一次累计摘要的 prompt。 */
 export declare function build_initial_session_summary_prompt(input: {
     /** 本次需要压缩的 canonical 对话文本。 */
@@ -13,4 +15,4 @@ export declare function build_updated_session_summary_prompt(input: {
     /** 本次新增的 canonical 对话文本。 */
     conversation_text: string;
 }): string;
-//# sourceMappingURL=SessionSummaryPrompts.d.ts.map
+//# sourceMappingURL=ContextSummaryPrompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextSummaryPrompts.d.ts","sourceRoot":"","sources":["../../../../src/session/input/composer/ContextSummaryPrompts.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,0BAA0B;AAC1B,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD,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 → input/composer/ContextSummaryPrompts.js}

@@ -1,6 +1,8 @@
-/** Session 累计摘要策略使用的稳定提示词。 */
+/** Session 累计摘要使用的稳定提示词。 */
+/** 摘要模型可使用的最大输出 token。 */
+export const CONTEXT_SUMMARY_MAX_OUTPUT_TOKENS = 4_000;
 /** 上下文摘要 system prompt。 */
-export const SESSION_SUMMARY_SYSTEM_PROMPT = [
+export const CONTEXT_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.",
@@ -29,4 +31,4 @@ export function build_updated_session_summary_prompt(input) {
         "Use these headings: Goal, Constraints, Progress, Key Decisions, Next Steps, Critical Context.",
     ].join("\n");
 }
-//# sourceMappingURL=SessionSummaryPrompts.js.map
+//# sourceMappingURL=ContextSummaryPrompts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextSummaryPrompts.js","sourceRoot":"","sources":["../../../../src/session/input/composer/ContextSummaryPrompts.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,0BAA0B;AAC1B,MAAM,CAAC,MAAM,iCAAiC,GAAG,KAAK,CAAC;AAEvD,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/input/composer/DefaultSessionComposer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 默认 Session Composer。
+ *
+ * 负责组装当前 Step 的 system、messages 与 tools，并在上下文压力出现时把较旧的稳定
+ * Part 折叠进累计摘要 checkpoint。
+ *
+ * 关键点（中文）
+ * - canonical history 由调用方传入，本模块只读取它，从不改写。
+ * - 压缩结果只写自己的 checkpoint 派生表；下一次 compose 才会读到新边界。
+ * - 自定义压缩算法可以继承本类并只覆盖 `advance_context()`。
+ */
+import type { SessionComposer, SessionComposeInput, SessionContextAdvanceInput, SessionStepInput } from "../../../types/session/SessionComposer.js";
+/** 基于 Part 级 checkpoint 的默认 Composer。 */
+export declare class DefaultSessionComposer implements SessionComposer {
+    /** Composer 名称，同时作为派生表命名空间。 */
+    readonly name = "adaptive_part";
+    /** 创建累计摘要 checkpoint 派生表。 */
+    initialize(input: Parameters<SessionComposer["initialize"]>[0]): Promise<void>;
+    /** 返回显式摘要 system block 与 checkpoint 边界后的 canonical 历史。 */
+    compose(input: SessionComposeInput): Promise<SessionStepInput>;
+    /** 按体积选择较旧稳定 Part，合并进累计摘要并推进 checkpoint。 */
+    advance_context(input: SessionContextAdvanceInput): Promise<boolean>;
+}
+//# sourceMappingURL=DefaultSessionComposer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultSessionComposer.d.ts","sourceRoot":"","sources":["../../../../src/session/input/composer/DefaultSessionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAE1B,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AA0B5C,yCAAyC;AACzC,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,mBAAmB;IAEhC,6BAA6B;IACvB,UAAU,CACd,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC;IAIhB,0DAA0D;IACpD,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyBpE,4CAA4C;IACtC,eAAe,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC;CA6C3E"}

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

@@ -0,0 +1,108 @@
+/**
+ * 默认 Session Composer。
+ *
+ * 负责组装当前 Step 的 system、messages 与 tools，并在上下文压力出现时把较旧的稳定
+ * Part 折叠进累计摘要 checkpoint。
+ *
+ * 关键点（中文）
+ * - canonical history 由调用方传入，本模块只读取它，从不改写。
+ * - 压缩结果只写自己的 checkpoint 派生表；下一次 compose 才会读到新边界。
+ * - 自定义压缩算法可以继承本类并只覆盖 `advance_context()`。
+ */
+import { build_text_model_messages, generate_model } from "../../../model/ModelGenerate.js";
+import { session_messages_to_model_messages } from "../../../model/messages/SessionModelMessages.js";
+import { build_composer_system_blocks, inject_power_context, to_system_messages, } from "../../../session/input/composer/ComposerAssembly.js";
+import { initialize_checkpoint_schema, insert_checkpoint, read_latest_checkpoint, } from "../../../session/input/composer/AdaptiveContextCheckpoint.js";
+import { candidate_to_summary_text, collect_stable_parts, compare_position, select_compact_parts, slice_messages_after_checkpoint, } from "../../../session/input/composer/AdaptiveContextParts.js";
+import { build_initial_session_summary_prompt, build_updated_session_summary_prompt, CONTEXT_SUMMARY_MAX_OUTPUT_TOKENS, CONTEXT_SUMMARY_SYSTEM_PROMPT, } from "../../../session/input/composer/ContextSummaryPrompts.js";
+/** 基于 Part 级 checkpoint 的默认 Composer。 */
+export class DefaultSessionComposer {
+    /** Composer 名称，同时作为派生表命名空间。 */
+    name = "adaptive_part";
+    /** 创建累计摘要 checkpoint 派生表。 */
+    async initialize(input) {
+        await initialize_checkpoint_schema(input.derived, this.name);
+    }
+    /** 返回显式摘要 system block 与 checkpoint 边界后的 canonical 历史。 */
+    async compose(input) {
+        const checkpoint = await read_latest_checkpoint(input.derived, this.name);
+        const system_blocks = await build_composer_system_blocks(input);
+        if (checkpoint?.summary.trim()) {
+            system_blocks.push({
+                source: "session",
+                name: "context-summary",
+                content: `<session-context-summary>\n${checkpoint.summary}\n</session-context-summary>`,
+            });
+        }
+        const tail = checkpoint
+            ? slice_messages_after_checkpoint(input.history, checkpoint)
+            : input.history;
+        return {
+            system: to_system_messages(system_blocks),
+            system_blocks,
+            messages: inject_power_context(await session_messages_to_model_messages(tail, input.session.project_root), input.state.power_context_blocks ?? []),
+            tools: { ...input.state.tools },
+            context_diagnostics: build_diagnostics(this.name, input.history, checkpoint),
+        };
+    }
+    /** 按体积选择较旧稳定 Part，合并进累计摘要并推进 checkpoint。 */
+    async advance_context(input) {
+        if (!input.model)
+            return false;
+        const previous = await read_latest_checkpoint(input.derived, this.name);
+        const compact_parts = select_compact_parts(collect_stable_parts(input.history, previous));
+        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(CONTEXT_SUMMARY_SYSTEM_PROMPT, prompt),
+            max_output_tokens: CONTEXT_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");
+        try {
+            await insert_checkpoint(input.derived, this.name, {
+                through_message_id: boundary.message.message_id,
+                through_message_sequence: boundary.message.sequence,
+                through_part_sequence: boundary.part.sequence,
+                summary,
+            });
+            return true;
+        }
+        catch (error) {
+            // 并发推进：只要有别人把边界推过本次位置，本次推进就已经生效。
+            const latest = await read_latest_checkpoint(input.derived, this.name);
+            if (latest && compare_position(latest, boundary) >= 0)
+                return true;
+            throw error;
+        }
+    }
+}
+/** 组装当前上下文的只读诊断。 */
+function build_diagnostics(composer_name, history, checkpoint) {
+    const latest_sequence = history.at(-1)?.sequence;
+    return {
+        composer_name,
+        ...(latest_sequence !== undefined ? { through_sequence: latest_sequence } : {}),
+        ...(checkpoint ? { through_part_sequence: checkpoint.through_part_sequence } : {}),
+        derived: Boolean(checkpoint),
+        ...(checkpoint ? { derivation_id: checkpoint.checkpoint_id } : {}),
+    };
+}
+//# sourceMappingURL=DefaultSessionComposer.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * 全量历史 Session Composer。
+ *
+ * 不做任何上下文推进：每次交给模型的都是完整 canonical history，也没有派生表。
+ * 适用于短会话、测试或上下文窗口足够大的模型。
+ */
+import type { SessionComposer, SessionComposeInput, SessionStepInput } from "../../../types/session/SessionComposer.js";
+/** 直接投影全部 canonical history 的 Composer。 */
+export declare class FullHistorySessionComposer implements SessionComposer {
+    /** Composer 名称；该实现不建立派生表。 */
+    readonly name = "full_history";
+    /** 没有派生 schema 需要初始化。 */
+    initialize(): Promise<void>;
+    /** 返回完整 canonical 历史与当前 Step 的工具集合。 */
+    compose(input: SessionComposeInput): Promise<SessionStepInput>;
+    /** 没有派生状态可以推进。 */
+    advance_context(): Promise<boolean>;
+}
+//# sourceMappingURL=FullHistorySessionComposer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FullHistorySessionComposer.d.ts","sourceRoot":"","sources":["../../../../src/session/input/composer/FullHistorySessionComposer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAO5C,2CAA2C;AAC3C,qBAAa,0BAA2B,YAAW,eAAe;IAChE,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,kBAAkB;IAE/B,yBAAyB;IACnB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjC,uCAAuC;IACjC,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsBpE,kBAAkB;IACZ,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAG1C"}

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

@@ -0,0 +1,36 @@
+/**
+ * 全量历史 Session Composer。
+ *
+ * 不做任何上下文推进：每次交给模型的都是完整 canonical history，也没有派生表。
+ * 适用于短会话、测试或上下文窗口足够大的模型。
+ */
+import { session_messages_to_model_messages } from "../../../model/messages/SessionModelMessages.js";
+import { build_composer_system_blocks, inject_power_context, to_system_messages, } from "../../../session/input/composer/ComposerAssembly.js";
+/** 直接投影全部 canonical history 的 Composer。 */
+export class FullHistorySessionComposer {
+    /** Composer 名称；该实现不建立派生表。 */
+    name = "full_history";
+    /** 没有派生 schema 需要初始化。 */
+    async initialize() { }
+    /** 返回完整 canonical 历史与当前 Step 的工具集合。 */
+    async compose(input) {
+        const system_blocks = await build_composer_system_blocks(input);
+        const latest_sequence = input.history.at(-1)?.sequence;
+        return {
+            system: to_system_messages(system_blocks),
+            system_blocks,
+            messages: inject_power_context(await session_messages_to_model_messages(input.history, input.session.project_root), input.state.power_context_blocks ?? []),
+            tools: { ...input.state.tools },
+            context_diagnostics: {
+                composer_name: this.name,
+                ...(latest_sequence !== undefined ? { through_sequence: latest_sequence } : {}),
+                derived: false,
+            },
+        };
+    }
+    /** 没有派生状态可以推进。 */
+    async advance_context() {
+        return false;
+    }
+}
+//# sourceMappingURL=FullHistorySessionComposer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FullHistorySessionComposer.js","sourceRoot":"","sources":["../../../../src/session/input/composer/FullHistorySessionComposer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAM9F,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,8CAA8C,CAAC;AAEtD,2CAA2C;AAC3C,MAAM,OAAO,0BAA0B;IACrC,6BAA6B;IACpB,IAAI,GAAG,cAAc,CAAC;IAE/B,yBAAyB;IACzB,KAAK,CAAC,UAAU,KAAmB,CAAC;IAEpC,uCAAuC;IACvC,KAAK,CAAC,OAAO,CAAC,KAA0B;QACtC,MAAM,aAAa,GAAG,MAAM,4BAA4B,CAAC,KAAK,CAAC,CAAC;QAChE,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;QACvD,OAAO;YACL,MAAM,EAAE,kBAAkB,CAAC,aAAa,CAAC;YACzC,aAAa;YACb,QAAQ,EAAE,oBAAoB,CAC5B,MAAM,kCAAkC,CACtC,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,OAAO,CAAC,YAAY,CAC3B,EACD,KAAK,CAAC,KAAK,CAAC,oBAAoB,IAAI,EAAE,CACvC;YACD,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;YAC/B,mBAAmB,EAAE;gBACnB,aAAa,EAAE,IAAI,CAAC,IAAI;gBACxB,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/E,OAAO,EAAE,KAAK;aACf;SACF,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,eAAe;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/bin/session/{SessionLoop.d.ts → loop/SessionLoop.d.ts}

@@ -6,11 +6,11 @@
  * - 不把调度逻辑塞进 Executor；Executor 继续只负责单次执行。
  * - Queue 由 Session 持有；这里不解释配置种类，只执行出队 Command。
  */
-import type { AgentSessionPromptInput } from "../types/sdk/AgentSessionPrompt.js";
-import type { AgentSessionStopResult } from "../types/sdk/AgentSessionStop.js";
-import type { AgentSessionTurnHandle } from "../types/sdk/AgentSessionTurn.js";
-import type { SessionLoopOptions } from "../types/session/SessionLoop.js";
-import type { SessionCommand } from "../types/session/SessionCommand.js";
+import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
+import type { AgentSessionStopResult } from "../../types/sdk/AgentSessionStop.js";
+import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
+import type { SessionLoopOptions } from "../../types/session/SessionLoop.js";
+import type { SessionCommand } from "../../types/session/SessionCommand.js";
 /**
  * Session 输入队列与 Turn 编排器。
  */
@@ -18,14 +18,18 @@ export declare class SessionLoop {
     private readonly session_id;
     private readonly session_origin;
     private readonly workspace_path;
-    private readonly executor;
+    private readonly step_input;
+    private readonly session_executor;
     private readonly maintain_context;
     private readonly state;
     private readonly messages;
     private readonly events;
     private readonly logger;
+    /** 读取当前生效的扩展处理器集合。 */
+    private readonly get_hooks;
+    /** 构造当前 Turn 的调用环境快照。 */
+    private readonly create_call_context;
     private readonly interactions;
-    private readonly shell_approval_gateway;
     private readonly queue;
     private pending_prompt_count;
     private processing_promise;
@@ -33,6 +37,8 @@ export declare class SessionLoop {
     /** 尚未完成 canonical 接收的幂等 Prompt，防止进程内并发重复入队。 */
     private readonly pending_request_handles;
     constructor(options: SessionLoopOptions);
+    /** 返回当前 Session 是否正在执行模型请求。 */
+    is_executing(): boolean;
     /**
      * 追加一条新的 prompt。
      */
@@ -76,6 +82,14 @@ export declare class SessionLoop {
      * 在下一 Session step 检查点按入队顺序提交配置并持久化 steer。
      */
     private drain_queued_inputs;
+    /**
+     * 在 Turn 收口前抽干尚未处理的 Maintenance Command。
+     *
+     * 关键点（中文）
+     * - 收尾窗口内到达的配置变更 Action 借此与当前 Agent Message 共享同一条 Message。
+     * - 只抽 Maintenance；Prompt 继续留在 FIFO 里由下一 Turn 消费。
+     */
+    private drain_queued_maintenance_commands;
     /** 执行 Command，并尽力持久化其声明的 canonical 完成信息。 */
     private execute_command;
     /** 持久化 Command 完成信息；观测失败不能反向改变已经提交的领域状态。 */
@@ -90,6 +104,19 @@ export declare class SessionLoop {
     private resolve_cancelled_prompt;
     /** 执行一个 Turn 内的模型与 Tool Step Loop。 */
     private execute_prompt_turn;
+    /**
+     * 执行 Turn；上下文推进与重试由执行器内部负责。
+     *
+     * 关键点（中文）：每次重试都重新装配 Step 输入，保证读到刚推进的上下文。
+     */
+    private run_turn_with_context_advance;
+    /**
+     * 解析当前 Step 的输入。
+     *
+     * 关键点（中文）：注入执行器时本 Loop 不拥有输入装配能力；回调一旦被调用即说明注入契约
+     * 被破坏，因此直接报错而不是静默返回空输入。
+     */
+    private require_step_input;
     /** 在 Turn 创建时建立其唯一执行上下文和 Assistant 输出端口。 */
     private create_turn_context;
     /** 持久化本轮 User 输入，并同步刷新标题与 metadata。 */

package/bin/session/loop/SessionLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionLoop.d.ts","sourceRoot":"","sources":["../../../src/session/loop/SessionLoop.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,iCAAiC,CAAC;AAwBzC,OAAO,KAAK,EAGV,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,mCAAmC,CAAC;AAgB3C;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuC;IACtE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyC;IAC1E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,yBAAyB;IACzB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4C;IAChF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAC0B;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAAE,OAAO,CAAC,oBAAoB,CAAK;IACxE,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,WAAW,CAAuC;IAC1D,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAsD;gBAElF,OAAO,EAAE,kBAAkB;IA6BvC,+BAA+B;IAC/B,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAoB7E,oCAAoC;YACtB,oBAAoB;IAYlC,sCAAsC;YACxB,cAAc;IA0B5B,2CAA2C;IAC3C,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAK9C;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B,0CAA0C;IAC1C,kBAAkB,IAAI,MAAM;IAI5B,mDAAmD;IACnD,eAAe,IAAI,MAAM,GAAG,SAAS;IAIrC;;;;;;OAMG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAsB7C,OAAO,CAAC,iBAAiB;YAUX,YAAY;IA+B1B,yCAAyC;YAC3B,2BAA2B;IAezC,OAAO,CAAC,qBAAqB;IAI7B;;OAEG;YACW,mBAAmB;IAgBjC;;;;;;OAMG;YACW,iCAAiC;IAc/C,4CAA4C;YAC9B,eAAe;IAO7B,4CAA4C;YAC9B,0BAA0B;IA8BxC,6DAA6D;YAC/C,sBAAsB;IAgDpC,8CAA8C;IAC9C,OAAO,CAAC,mBAAmB;IAK3B,iEAAiE;YACnD,gBAAgB;IAa9B,iCAAiC;IACjC,OAAO,CAAC,wBAAwB;IAoChC,sCAAsC;YACxB,mBAAmB;IA8DjC;;;;OAIG;YACW,6BAA6B;IAU3C;;;;;OAKG;YACW,kBAAkB;IAahC,4CAA4C;IAC5C,OAAO,CAAC,mBAAmB;IAoD3B,uCAAuC;YACzB,sBAAsB;IAepC,8BAA8B;YAChB,yBAAyB;IAgBvC,kDAAkD;YACpC,oBAAoB;IAOlC,2BAA2B;IAC3B,OAAO,CAAC,uBAAuB;CAWhC"}