@downcity/agent 1.1.437 → 1.1.445

package/bin/session/input/SessionHookRunner.js

@@ -0,0 +1,51 @@
+/**
+ * Session 检查点执行器。
+ *
+ * 扩展能力编译后提供三类普通函数；本模块负责按检查点取出处理器、串行执行，
+ * 并把失败隔离到单个检查点。Agent 内部只有这一个地方调用扩展处理器。
+ *
+ * 关键点（中文）
+ * - pipeline 变换值，guard 抛错即中断，effect 只产生副作用。
+ * - 没有处理器时返回原值，调用方不需要判断检查点是否存在。
+ * - 处理器失败不向上抛出：内容贡献是增强，不应阻断 Session 主链路。
+ */
+/** 运行一个 pipeline 检查点；处理器按顺序链式变换值。 */
+export async function run_pipeline_point(input) {
+    const handlers = input.hooks.pipeline[input.point_name];
+    if (!handlers || handlers.length === 0)
+        return input.value;
+    let current = input.value;
+    for (const handler of handlers) {
+        try {
+            current = await handler(current, input.context);
+        }
+        catch (error) {
+            await input.on_error?.(input.point_name, error);
+        }
+    }
+    return current;
+}
+/** 运行一个 guard 检查点；任一处理器抛错即中断。 */
+export async function run_guard_point(input) {
+    const handlers = input.hooks.guard[input.point_name];
+    if (!handlers || handlers.length === 0)
+        return;
+    for (const handler of handlers) {
+        await handler(input.value, input.context);
+    }
+}
+/** 运行一个 effect 检查点；失败被隔离，不影响后续处理器与主链路。 */
+export async function run_effect_point(input) {
+    const handlers = input.hooks.effect[input.point_name];
+    if (!handlers || handlers.length === 0)
+        return;
+    for (const handler of handlers) {
+        try {
+            await handler(input.value, input.context);
+        }
+        catch (error) {
+            await input.on_error?.(input.point_name, error);
+        }
+    }
+}
+//# sourceMappingURL=SessionHookRunner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHookRunner.js","sourceRoot":"","sources":["../../../src/session/input/SessionHookRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAA2B,KAWlE;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAEzC,CAAC;IACd,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IAC3D,IAAI,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KASrC;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAEtC,CAAC;IACd,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAWtC;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAEvC,CAAC;IACd,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;AACH,CAAC"}

package/bin/session/input/SessionSystem.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SDK Session 默认 system block 组装逻辑。
+ *
+ * 关键点（中文）
+ * - 面向 `Agent` SDK 的本地会话执行场景。
+ * - 注入调用方显式传入的静态 instruction 与 Power system blocks。
+ * - SDK 不在 system 中注入动态变量；动态上下文应由调用方放入 user message。
+ */
+import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js";
+import type { BuildSessionSystemBlocksInput, ResolveSessionPowerSystemBlocksInput } from "../../types/session/SessionSystem.js";
+/** 把 system pipeline 输出限制为稳定的 Power 命名内容块。 */
+export declare function normalize_power_system_blocks(input: unknown): AgentSessionSystemBlock[];
+/**
+ * 使用统一检查点解析当前 Session 的扩展 system blocks。
+ *
+ * 关键点（中文）
+ * - 只有一个入口：`session.system_context` pipeline。扩展能力不再有独立的
+ *   `system()` 通道，因此不需要判断「静态说明写哪里」。
+ * - 处理器失败降级为空集合，不阻断 Session 主链路。
+ */
+export declare function resolve_session_power_system_blocks(input: ResolveSessionPowerSystemBlocksInput): Promise<AgentSessionSystemBlock[]>;
+/**
+ * 解析 SDK session 当前生效的 system blocks。
+ */
+export declare function build_session_system_blocks(input: BuildSessionSystemBlocksInput): Promise<AgentSessionSystemBlock[]>;
+//# sourceMappingURL=SessionSystem.d.ts.map

package/bin/session/input/SessionSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionSystem.d.ts","sourceRoot":"","sources":["../../../src/session/input/SessionSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,6BAA6B,EAC7B,oCAAoC,EACrC,MAAM,kCAAkC,CAAC;AA+B1C,8CAA8C;AAC9C,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,uBAAuB,EAAE,CAU3B;AAED;;;;;;;GAOG;AACH,wBAAsB,mCAAmC,CACvD,KAAK,EAAE,oCAAoC,GAC1C,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAoBpC;AAoCD;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAmCpC"}

package/bin/session/{SessionSystem.js → input/SessionSystem.js}

@@ -3,10 +3,11 @@
  *
  * 关键点（中文）
  * - 面向 `Agent` SDK 的本地会话执行场景。
- * - 注入调用方显式传入的静态 instruction 与 Plugin system blocks。
+ * - 注入调用方显式传入的静态 instruction 与 Power system blocks。
  * - SDK 不在 system 中注入动态变量；动态上下文应由调用方放入 user message。
  */
-import { SESSION_HOOK_POINTS } from "../session/SessionHookPoints.js";
+import { SESSION_HOOK_POINTS } from "@downcity/type";
+import { run_pipeline_point } from "../../session/input/SessionHookRunner.js";
 function normalize_system_blocks(blocks) {
     if (!Array.isArray(blocks))
         return [];
@@ -18,7 +19,7 @@ function normalize_system_blocks(blocks) {
         const source = block.source;
         if (source !== "core" &&
             source !== "instruction" &&
-            source !== "plugin" &&
+            source !== "power" &&
             source !== "session") {
             return null;
         }
@@ -30,8 +31,8 @@ function normalize_system_blocks(blocks) {
     })
         .filter((block) => Boolean(block));
 }
-/** 把 system pipeline 输出限制为稳定的 Plugin 命名内容块。 */
-export function normalize_plugin_system_blocks(input) {
+/** 把 system pipeline 输出限制为稳定的 Power 命名内容块。 */
+export function normalize_power_system_blocks(input) {
     if (!Array.isArray(input))
         return [];
     return input.flatMap((item) => {
@@ -42,31 +43,35 @@ export function normalize_plugin_system_blocks(input) {
         const content = String(record.content || "").trim();
         if (!name || !content)
             return [];
-        return [{ source: "plugin", name, content }];
+        return [{ source: "power", name, content }];
     });
 }
-/** 使用统一 Hook 检查点解析当前 Session 的 Plugin system blocks。 */
-export async function resolve_session_plugin_system_blocks(input) {
-    let blocks;
-    try {
-        blocks = normalize_plugin_system_blocks(await input.hooks.system_blocks(input.context));
-    }
-    catch (error) {
-        await input.on_error?.(error);
-        return [];
-    }
+/**
+ * 使用统一检查点解析当前 Session 的扩展 system blocks。
+ *
+ * 关键点（中文）
+ * - 只有一个入口：`session.system_context` pipeline。扩展能力不再有独立的
+ *   `system()` 通道，因此不需要判断「静态说明写哪里」。
+ * - 处理器失败降级为空集合，不阻断 Session 主链路。
+ */
+export async function resolve_session_power_system_blocks(input) {
     const value = {
         session_id: input.session_id,
         ...(input.turn_id ? { turn_id: input.turn_id } : {}),
-        blocks,
+        blocks: [],
     };
     try {
-        const output = await input.hooks.pipeline(SESSION_HOOK_POINTS.system_context, value);
-        return normalize_plugin_system_blocks(output?.blocks);
+        const output = await run_pipeline_point({
+            hooks: input.hooks,
+            point_name: SESSION_HOOK_POINTS.system_context,
+            value: value,
+            context: input.context,
+        });
+        return normalize_power_system_blocks(output?.blocks);
     }
     catch (error) {
         await input.on_error?.(error);
-        return blocks;
+        return [];
     }
 }
 function create_session_info(input) {
@@ -82,7 +87,7 @@ function create_session_info(input) {
 function create_session_system_block(session) {
     const content = [
         "Current session context:",
-        `You are serving agent "${session.agent_id}" in session "${session.session_id}".`,
+        `This session is "${session.session_id}".`,
         `The current project root is "${session.project_root}".`,
         `This session was created at ${session.created_at}, with ${session.timezone} as its reference timezone.`,
         "This creation time is a stable reference for the session and does not represent the current time for every run.",
@@ -120,8 +125,7 @@ export async function build_session_system_blocks(input) {
     }
     return [
         ...normalize_system_blocks(input.get_instruction_system_blocks()),
-        ...normalize_system_blocks(await input.get_managed_plugin_system_blocks()),
-        ...normalize_system_blocks(await input.get_plugin_system_blocks()),
+        ...normalize_system_blocks(await input.get_power_system_blocks()),
         // session block 放在最后，尽量保留前缀 system blocks 的跨 session 缓存命中。
         create_session_system_block(create_session_info({
             agent_id,

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

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

package/bin/session/input/StepInput.d.ts

@@ -0,0 +1,77 @@
+/**
+ * StepInput：为每个 Step 准备发给模型的输入。
+ *
+ * 关键点（中文）
+ * - 同时拥有「冻结的 system 快照」与「每步宿主事实采集」，因为二者互为前提：首次组装
+ *   的结果就是快照，而快照一旦冻结就不再重新采集 Power system。
+ * - 只产出输入，不发请求、不判断是否继续；请求与循环归 `SessionExecutor`。
+ * - 不拥有 Message、Turn 或 Store 生命周期。
+ */
+import type { AgentSessionSystemBlock, AgentSessionSystemSnapshot } from "../../types/agent/SessionTypes.js";
+import type { SessionComposeIdentity } from "../../types/session/SessionComposer.js";
+import type { SessionStepExecutionInput } from "../../types/session/SessionExecution.js";
+import type { StepInputOptions } from "../../types/session/StepInput.js";
+import type { SessionTurnContext } from "../../types/turn/SessionTurnContext.js";
+/** 当前 Session 的每步模型输入装配者。 */
+export declare class StepInput {
+    private readonly options;
+    private effective_instruction_blocks;
+    /** 当前 Session 首次组装后冻结的完整 system；null 表示尚未冻结。 */
+    private frozen_blocks;
+    /** 当前 Session 的一次性初始化任务。 */
+    private initialize_promise;
+    /** 串行化 snapshot / syncshot 对 system 与 instruction.md 的修改。 */
+    private mutation_chain;
+    constructor(options: StepInputOptions);
+    /** 初始化派生 schema，并恢复显式固化的 system 快照。 */
+    initialize(): Promise<void>;
+    /**
+     * 为下一个 Provider Step 组装唯一一份输入。
+     *
+     * 关键点（中文）
+     * - 调用方必须先提交 Session 统一输入队列，再调用本方法。
+     * - 首次调用会把组装出的完整 system 冻结为当前 Session 的 system 快照。
+     */
+    build(turn_context: SessionTurnContext, advance_count: number): Promise<SessionStepExecutionInput>;
+    /** 把当前完整 system 显式固化到 instruction.md。 */
+    snapshot(): Promise<void>;
+    /** 使用 Agent 当前 instruction 与 Power 重新生成完整 system。 */
+    syncshot(): Promise<void>;
+    /** 读取当前 Session 生效的完整 system 快照。 */
+    read_system(): Promise<AgentSessionSystemSnapshot>;
+    /** 返回当前 Session 捕获的 instruction blocks 副本。 */
+    instruction_blocks(): AgentSessionSystemBlock[];
+    /** 创建 Composer 共用的稳定 Session 身份快照。 */
+    identity(): SessionComposeIdentity;
+    /** 采集当前 Step 的宿主事实，交给 Composer 组装。 */
+    private gather;
+    /** 返回当前 Composer 命名空间的派生存储视图。 */
+    private derived_store;
+    /**
+     * 冻结或套用当前 Session 的 system 快照。
+     *
+     * 关键点（中文）：首次调用把组装结果记成快照；之后每次都覆盖为快照，保证同一 Session
+     * 的 system 不再漂移。
+     */
+    private apply_frozen_system;
+    /** Power 上下文 Hook 失败只降级当前扩展内容。 */
+    private log_power_hook_warning;
+    /** 串行执行一次 Session system 修改。 */
+    private run_mutation;
+    /** 把指定完整 system blocks 原子写入 instruction.md。 */
+    private write_snapshot;
+    /**
+     * 把工具包装为已绑定调用环境的工具。
+     *
+     * 关键点（中文）
+     * - 包装层是上下文注入的唯一位置：捕获 Session 级信息，并在每次调用时
+     *   合并模型 Step 提供的调用身份与消息快照。
+     * - 每个 step 使用独立包装，不会在并行 Session 间共享可变指针。
+     */
+    private bind_turn_context_to_tools;
+    /** 构造不属任何 Turn 的调用环境；用于 system 查询。 */
+    private create_session_call_context;
+    /** 构造一次工具调用获得的值快照。 */
+    private create_tool_call_context;
+}
+//# sourceMappingURL=StepInput.d.ts.map

package/bin/session/input/StepInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepInput.d.ts","sourceRoot":"","sources":["../../../src/session/input/StepInput.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,OAAO,KAAK,EACV,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAO7E,6BAA6B;AAC7B,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,4BAA4B,CAA4B;IAChE,gDAAgD;IAChD,OAAO,CAAC,aAAa,CAA0C;IAC/D,4BAA4B;IAC5B,OAAO,CAAC,kBAAkB,CAA8B;IACxD,6DAA6D;IAC7D,OAAO,CAAC,cAAc,CAAoC;gBAE9C,OAAO,EAAE,gBAAgB;IAOrC,uCAAuC;IACjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CjC;;;;;;OAMG;IACG,KAAK,CACT,YAAY,EAAE,kBAAkB,EAChC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,yBAAyB,CAAC;IAqBrC,yCAAyC;IACnC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,qDAAqD;IAC/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB/B,oCAAoC;IAC9B,WAAW,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAkBxD,8CAA8C;IAC9C,kBAAkB,IAAI,uBAAuB,EAAE;IAI/C,sCAAsC;IACtC,QAAQ,IAAI,sBAAsB;IAUlC,sCAAsC;YACxB,MAAM;IA6FpB,iCAAiC;IACjC,OAAO,CAAC,aAAa;IAIrB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAc3B,kCAAkC;YACpB,sBAAsB;IAiBpC,gCAAgC;YAClB,YAAY;IAM1B,+CAA+C;YACjC,cAAc;IAQ5B;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAiDlC,sCAAsC;IACtC,OAAO,CAAC,2BAA2B;IAmBnC,sBAAsB;IACtB,OAAO,CAAC,wBAAwB;CAuBjC"}