@downcity/agent 1.1.408 → 1.1.437

package/bin/session/DefaultSessionComposer.js

@@ -1,15 +1,56 @@
 /**
  * 默认 Session Composer。
  *
- * 负责把 Session 的只读状态与 canonical Message 快照组装为模型输入；
- * 压缩只生成计划，实际 Segment 提交仍由 SessionMessages 负责。
+ * 负责把 Session 运行快照与 Context Policy 结果组装为最终模型输入。
  */
-import { build_session_system_blocks } from "./SessionSystem.js";
-import { compose_session_compaction } from "./messages/SessionMessageCompaction.js";
-import { session_context_to_model_messages } from "../executor/messages/SessionModelMessages.js";
+import { build_session_system_blocks } from "../session/SessionSystem.js";
+import { AdaptivePartContextPolicy } from "../session/composer/policies/AdaptivePartContextPolicy.js";
+/** 把低权限 Plugin 内容渲染为与用户原文分离的模型参考区。 */
+function render_plugin_context_blocks(blocks) {
+    return blocks.map((block) => [
+        `<extension-context extension="${escape_xml_attribute(block.source_plugin)}" name="${escape_xml_attribute(block.name)}" trust="reference">`,
+        block.content,
+        "</extension-context>",
+    ].join("\n")).join("\n\n");
+}
+/** 转义模型上下文标签属性，避免 Plugin 名称破坏边界。 */
+function escape_xml_attribute(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;");
+}
+/** 只修改模型消息副本，把动态参考信息前置到当前最后一条 User Message。 */
+function inject_plugin_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_plugin_context_blocks(blocks) }, ...message.content],
+        };
+        break;
+    }
+    return messages;
+}
 /** 默认 Session 执行策略。 */
 export class DefaultSessionComposer {
     name = "default_session";
+    /** 当前 Composer 使用的上下文策略。 */
+    context_policy;
+    constructor(options) {
+        this.context_policy = options?.context_policy || new AdaptivePartContextPolicy();
+    }
+    /** 初始化内部 Context Policy 的派生 schema。 */
+    async initialize(input) {
+        await this.context_policy.initialize({
+            storage: input.storage.composer_storage(this.context_policy.name),
+        });
+    }
     /** 组装当前 Step 的 system、history 与 tools。 */
     async compose(input) {
         const system_blocks = await build_session_system_blocks({
@@ -19,42 +60,40 @@ export class DefaultSessionComposer {
             created_at: input.session.created_at,
             timezone: input.session.timezone,
             get_instruction_system_blocks: () => [
-                ...input.state.instruction_system_blocks,
+                ...(input.state.instruction_system_blocks ?? []),
             ],
             get_managed_plugin_system_blocks: async () => [
-                ...input.state.managed_plugin_system_blocks,
+                ...(input.state.managed_plugin_system_blocks ?? []),
             ],
             get_plugin_system_blocks: async () => [
-                ...input.state.plugin_system_blocks,
+                ...(input.state.plugin_system_blocks ?? []),
             ],
         });
+        const context = await this.context_policy.resolve({
+            storage: input.storage.composer_storage(this.context_policy.name),
+            project_root: input.session.project_root,
+        });
+        system_blocks.push(...(context.system_blocks ?? []));
         return {
             system: system_blocks.map((block) => ({
                 role: "system",
                 content: block.content,
             })),
             system_blocks,
-            messages: await session_context_to_model_messages(input.history, input.session.project_root),
+            messages: inject_plugin_context(context.messages, input.state.plugin_context_blocks ?? []),
             tools: { ...input.state.tools },
+            context_diagnostics: context.diagnostics,
         };
     }
-    /** 生成等待 SessionMessages 提交的压缩计划。 */
-    async compact(input) {
-        if (!input.model)
-            return null;
-        return await compose_session_compaction({
-            session_id: input.session.session_id,
-            snapshot: input.history,
+    /** 把上下文恢复委托给当前 Policy。 */
+    async recover_context(input) {
+        return await this.context_policy.recover({
+            storage: input.storage.composer_storage(this.context_policy.name),
+            project_root: input.session.project_root,
+            reason: input.reason,
             model: input.model,
+            on_model_request_failure: input.on_model_request_failure,
         });
     }
-    /** 判断错误是否属于模型上下文超限。 */
-    should_compact(error) {
-        const message = String(error ?? "");
-        return (message.includes("context_length") ||
-            message.includes("too long") ||
-            message.includes("maximum context") ||
-            message.includes("context window"));
-    }
 }
 //# sourceMappingURL=DefaultSessionComposer.js.map

package/bin/session/DefaultSessionComposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultSessionComposer.js","sourceRoot":"","sources":["../../src/session/DefaultSessionComposer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAS/F,uBAAuB;AACvB,MAAM,OAAO,sBAAsB;IACxB,IAAI,GAAG,iBAAiB,CAAC;IAElC,0CAA0C;IAC1C,KAAK,CAAC,OAAO,CAAC,KAA0B;QACtC,MAAM,aAAa,GAAG,MAAM,2BAA2B,CAAC;YACtD,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;YAChC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY;YACxC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU;YACpC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU;YACpC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;YAChC,6BAA6B,EAAE,GAAG,EAAE,CAAC;gBACnC,GAAG,KAAK,CAAC,KAAK,CAAC,yBAAyB;aACzC;YACD,gCAAgC,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC5C,GAAG,KAAK,CAAC,KAAK,CAAC,4BAA4B;aAC5C;YACD,wBAAwB,EAAE,KAAK,IAAI,EAAE,CAAC;gBACpC,GAAG,KAAK,CAAC,KAAK,CAAC,oBAAoB;aACpC;SACF,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACpC,IAAI,EAAE,QAAiB;gBACvB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YACH,aAAa;YACb,QAAQ,EAAE,MAAM,iCAAiC,CAC/C,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,OAAO,CAAC,YAAY,CAC3B;YACD,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;SAChC,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,OAAO,CACX,KAA6B;QAE7B,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC9B,OAAO,MAAM,0BAA0B,CAAC;YACtC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU;YACpC,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAED,uBAAuB;IACvB,cAAc,CAAC,KAAc;QAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CACnC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"DefaultSessionComposer.js","sourceRoot":"","sources":["../../src/session/DefaultSessionComposer.ts"],"names":[],"mappings":"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"}

package/bin/session/Session.d.ts

@@ -4,21 +4,19 @@
  * 关键点（中文）
  * - 面向 `new Agent(...)` 的本地会话使用场景。
  * - 对外保留稳定 Session facade，把状态、turn、view 逻辑下沉到独立 service。
- * - 内部使用 `SessionMessages` 统一管理 Active、Segment 与流式 Assistant 草稿。
+ * - 内部使用 `SessionMessages` 管理 SQLite 中的 canonical Message 聚合。
  */
-import type { ModelClient } from "@downcity/type";
+import { type ModelClient } from "@downcity/type";
 import type { AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionInfo, AgentSessionStatus, AgentSessionSetInput, AgentSessionSetOptions, AgentSessionSystemSnapshot } from "../types/agent/SessionTypes.js";
 import type { AgentSession } from "../types/agent/SessionActor.js";
 import type { SessionPort } from "../types/session/SessionPort.js";
-import type { SessionMutationSubscriber, SessionMutationUnsubscribe } from "../types/session/SessionMutation.js";
-import type { RespondSessionInteractionInput, SessionInteractionResult, SessionPendingInteraction } from "../types/session/SessionInteraction.js";
-import type { ListSessionMessagesInput, SessionMessagePage } from "../types/session/SessionMessage.js";
+import type { SessionMutationSubscriber, SessionMutationUnsubscribe } from "@downcity/type";
+import type { RespondSessionInteractionInput, SessionInteractionResult, SessionPendingInteraction } from "@downcity/type";
+import type { ListSessionMessagesInput, SessionMessagePage } from "@downcity/type";
 import type { AgentSessionPromptInput } from "../types/sdk/AgentSessionPrompt.js";
 import type { AgentSessionStopResult } from "../types/sdk/AgentSessionStop.js";
-import type { AgentSessionCompactHandle } from "../types/sdk/AgentSessionCompact.js";
 import type { AgentSessionTurnHandle } from "../types/sdk/AgentSessionTurn.js";
 import type { SessionOptions } from "../types/session/SessionOptions.js";
-import type { AgentPluginExecutionRuntime } from "../types/plugin/PluginRuntime.js";
 /**
  * SDK 本地 Session。
  */
@@ -28,15 +26,17 @@ export declare class Session implements AgentSession {
     /** 当前 Session 创建时绑定的 Workspace ID。 */
     readonly workspace_id?: string;
     /** 当前 Session 的创建来源。 */
-    readonly origin?: SessionOptions["origin"];
+    readonly origin: SessionOptions["origin"];
     private readonly workspace_path;
     private readonly store;
-    private readonly get_session_store;
-    private readonly tools;
+    private readonly create_session_store;
+    private readonly register_forked_session;
+    private readonly get_tools;
     private readonly logger;
     private readonly get_managed_plugin_system_blocks;
     private readonly ensure_configured_hook?;
     private readonly composer;
+    private readonly create_composer;
     private readonly session_messages;
     private readonly executor;
     private readonly events;
@@ -45,18 +45,12 @@ export declare class Session implements AgentSession {
     private readonly local_state;
     private readonly get_workspace_env;
     private readonly get_agent_model;
-    private readonly get_agent_plugins;
+    private readonly get_hooks;
     private readonly get_instruction_system_blocks;
-    private effective_instruction_system_blocks;
     /** 当前 Session 的一次性初始化任务，避免缓存实例被重复恢复运行时状态。 */
     private initialize_promise;
-    private instruction_initialize_promise;
-    private effective_workspace_env;
-    private effective_agent_plugins;
-    /** 当前 Session 首次生成后固定的完整 system snapshot。 */
-    private system_snapshot_blocks;
-    /** 串行化 snapshot / syncshot 对 system 与 instruction.md 的修改。 */
-    private system_mutation_chain;
+    /** 当前 Session 的 system snapshot 与 Step 组装边界。 */
+    private readonly session_composition;
     private readonly state;
     /** 当前 Session 独享的 Command FIFO。 */
     private readonly session_queue;
@@ -71,15 +65,15 @@ export declare class Session implements AgentSession {
      * 把当前 Session 首次生成后固定的完整 system 显式固化到 instruction.md。
      *
      * 关键点（中文）
-     * - 包含 instruction、SDK core、plugin system 与 Session context。
+     * - 包含 instruction、SDK core、Plugin system 与 Session context。
      * - 多个 system block 按原顺序合并为一个 Markdown 文档。
      */
     snapshot(): Promise<void>;
     /**
-     * 使用 Agent 当前 instruction 与 plugin 重新生成一次完整 system。
+     * 使用 Agent 当前 instruction 与 Plugin 重新生成一次完整 system。
      *
      * 关键点（中文）
-     * - 只替换内存 snapshot，不改变 plugin execution view。
+     * - 只替换内存 snapshot，不改变 Plugin execution view。
      * - instruction.md 已存在时同步覆盖；不存在时不自动创建。
      * - 当前已经发出的 provider 请求不受影响，后续 step 使用新 snapshot。
      */
@@ -102,28 +96,6 @@ export declare class Session implements AgentSession {
      * 停止当前 turn，并取消尚未被吸收的排队 prompt。
      */
     stop(): Promise<AgentSessionStopResult>;
-    /**
-     * 把一次显式历史压缩加入当前 Session 的有序输入队列。
-     */
-    compact(): Promise<AgentSessionCompactHandle>;
-    /** 把 Workspace env 快照加入当前 Session 的有序输入队列。 */
-    enqueue_workspace_env(input: {
-        /** 当前 Workspace env 修改的稳定标识。 */
-        command_id: string;
-        /** 下一 Session Step 使用的完整环境变量快照。 */
-        env: Record<string, string>;
-    }): void;
-    /** 把 Agent Plugin 执行视图加入当前 Session 的有序输入队列。 */
-    enqueue_agent_plugins(input: {
-        /** 当前 Plugin 修改的稳定标识。 */
-        command_id: string;
-        /** 当前 Plugin 修改的用户可读标题。 */
-        title: string;
-        /** 下一 Session Step 使用的 Plugin 执行视图。 */
-        plugins: AgentPluginExecutionRuntime;
-    }): void;
-    /** 创建一个具体 Session Command 对象并加入当前 FIFO。 */
-    private enqueue_command;
     /**
      * 订阅当前 Session 的未来事件。
      */
@@ -141,9 +113,9 @@ export declare class Session implements AgentSession {
         text: string;
     }): Promise<void>;
     /**
-     * 追加一条 assistant 文本消息。
+     * 追加一条 Agent 文本消息。
      */
-    append_assistant_message(input: {
+    append_agent_message(input: {
         text: string;
     }): Promise<void>;
     /**
@@ -166,10 +138,8 @@ export declare class Session implements AgentSession {
      * 从当前 session 创建一个分叉会话。
      */
     fork(input?: AgentSessionForkInput | string): Promise<this>;
-    /** 截取 Fork 目标 Message 之前的历史，并按调用语义决定是否包含锚点。 */
-    private resolve_fork_messages;
     /**
-     * 返回供受托管 plugin 使用的 session 端口。
+     * 返回供宿主运行时使用的 Session 端口。
      */
     get_runtime_port(): SessionPort;
     /** 取消并释放当前 Session 的标题后台任务。 */
@@ -187,38 +157,25 @@ export declare class Session implements AgentSession {
      * - 子类仍可覆盖该方法，接管更特殊的子会话创建逻辑。
      */
     protected create_child_session(options: SessionOptions): this;
-    /** 恢复显式固化的完整 system snapshot；文件不存在时等待首次生成。 */
-    private initialize_instruction;
-    private create_local_state;
     /** 创建只依赖统一 Composer 的 Turn Executor。 */
     private create_executor;
-    /** 为 Composer 创建当前 Step 的只读 Session 快照。 */
-    private create_compose_input;
-    /** 创建 Composer 共用的稳定 Session 身份快照。 */
-    private create_compose_identity;
-    /** 生成并提交 canonical 历史压缩；该职责不进入 Executor。 */
-    private compact_history;
-    /** 使用统一 Composer 生成只读 system/history 查询结果。 */
-    private compose_for_view;
-    /** 固定或应用当前 Session 的 system snapshot。 */
-    private apply_system_snapshot;
-    /** 串行执行一次 Session system 修改。 */
-    private run_system_mutation;
-    /** 把指定完整 system blocks 原子写入 instruction.md。 */
-    private write_system_snapshot;
-    /** 提交 Composer 生成的 Segment 压缩计划。 */
-    private commit_compaction_plan;
+    /** 让 Composer 的 Context Policy 尝试推进派生上下文状态。 */
+    private recover_context;
     /**
      * 返回当前 Session 实际使用的模型实例。
      *
      * 解析顺序固定为 Session 覆盖模型，其次回退到 Agent 模型。
      */
     get_model(): ModelClient | undefined;
-    /** 按 Session 优先、Agent 兜底规则读取当前配置的 AgentModel。 */
+    /** 按 Session 优先、Agent 兜底规则读取当前配置的 ModelClient。 */
     private get_selected_model;
     /** 读取当前有效模型对应的上下文窗口。 */
     private get_model_context_window;
-    /** 持久化并发布一条 canonical Action Message。 */
+    /** 追加外部 User Message，并统一触发 Metadata 与标题更新。 */
+    private append_external_user_message;
+    /** 追加外部 Assistant Message，并统一提交 Metadata。 */
+    private append_external_agent_message;
+    /** 持久化并发布一条只包含 Action Part 的 canonical Agent Message。 */
     private emit_action_event;
 }
 //# sourceMappingURL=Session.d.ts.map

package/bin/session/Session.d.ts.map

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