@downcity/agent 1.1.437 → 1.1.445

package/bin/session/runtime/SessionTurnFileDiff.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionTurnFileDiff.js","sourceRoot":"","sources":["../../../src/session/runtime/SessionTurnFileDiff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,GACrC,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,gCAAgC,EAAE,MAAM,+CAA+C,CAAC;AAOjG,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAAqC;IAErC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,4BAA4B,CAC5C,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CACtC,CAAC;QACF,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,KAAK,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;gBAChD,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,gCAAgC;gBAC3C,OAAO,EAAE,kBAAkB,KAAK,CAAC,OAAO,EAAE;gBAC1C,IAAI,EAAE;oBACJ,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBACpC,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,KAAK,EAAE,IAAI,CAAC,KAAK;qBAClB,CAAC,CAAC;oBACH,SAAS,EAAE,SAAS,CAAC,SAAS;oBAC9B,SAAS,EAAE,SAAS,CAAC,SAAS;iBAC/B;aACF,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,qBAAqB,CACzB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,OAAO,EACb,yCAAyC,EACzC,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,8BAA8B,CAC5C,KAAsC;IAEtC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,oCAAoC,CAClD,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,OAAO,CACd,CAAC;QACF,IAAI,OAAO,CAAC,WAAW,KAAK,CAAC;YAAE,OAAO;QACtC,KAAK,CAAC,OAAO,CAAC;YACZ,WAAW,EAAE,MAAM,EAAE;YACrB,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,qBAAqB,CACxB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,OAAO,EACb,0CAA0C,EAC1C,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED,oCAAoC;AACpC,KAAK,UAAU,qBAAqB,CAClC,MAAc,EACd,UAAkB,EAClB,OAAe,EACf,OAAe,EACf,KAAc;IAEd,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,OAAO,EAAE,EAAE;YAC7C,UAAU;YACV,OAAO;YACP,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;AACH,CAAC"}

package/bin/types/action/ActionResult.d.ts

@@ -1,35 +0,0 @@
-/**
- * Action 与 Session Tool 共用的执行结果协议。
- *
- * 关键点（中文）
- * - `output` 是标准 Tool Result，原样交给模型执行器和 canonical Tool Part。
- * - `messages` 是执行后产生的运行期 User 输入或 canonical Agent 内容。
- * - `effects` 是当前 Turn 只追加收集、并在收口检查点解释的已发生副作用。
- * - Message Parts 复用 Downcity Session UI 协议，不再建立文件、图片或 Plugin 专用桥接。
- */
-import type { RuntimeToolEffect } from "@downcity/type";
-import type { SessionAgentContent, SessionModelUserContent } from "@downcity/type";
-/** Action 执行后产生的一条 Session 消息。 */
-export type ActionResultMessage = {
-    /** User 内容在下一 Step 生效。 */
-    role: "user";
-    /** 只在当前 Turn 生效、不会伪装成 canonical Message 的模型输入。 */
-    parts: SessionModelUserContent[];
-} | {
-    /** Agent 内容写入当前 canonical 回复。 */
-    role: "agent";
-    /** 等待追加到 canonical Agent Message 的内容。 */
-    parts: SessionAgentContent[];
-};
-/** Action 或 Tool 内部实现返回的统一结果。 */
-export interface ActionResult<TOutput = unknown> {
-    /** 返回给调用方、模型执行器与 canonical Tool Part 的标准执行输出。 */
-    output: TOutput;
-    /** 执行产生的运行期 User 输入或 Agent 输出；没有附加内容时传入空数组。 */
-    messages: ActionResultMessage[];
-    /** 已经发生且需要由当前 Turn 收集的副作用；不会发送给模型或直接持久化。 */
-    effects?: readonly RuntimeToolEffect[];
-}
-/** 判断未知 Tool 输出是否使用统一 ActionResult 协议。 */
-export declare function is_action_result(value: unknown): value is ActionResult;
-//# sourceMappingURL=ActionResult.d.ts.map

package/bin/types/action/ActionResult.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionResult.d.ts","sourceRoot":"","sources":["../../../src/types/action/ActionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,kCAAkC;AAClC,MAAM,MAAM,mBAAmB,GAC3B;IACE,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,KAAK,EAAE,uBAAuB,EAAE,CAAC;CAClC,GACD;IACE,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,yCAAyC;IACzC,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B,CAAC;AAEN,iCAAiC;AACjC,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,OAAO;IAC7C,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAEhB,+CAA+C;IAC/C,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAEhC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACxC;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAKtE"}

package/bin/types/action/ActionResult.js

@@ -1,18 +0,0 @@
-/**
- * Action 与 Session Tool 共用的执行结果协议。
- *
- * 关键点（中文）
- * - `output` 是标准 Tool Result，原样交给模型执行器和 canonical Tool Part。
- * - `messages` 是执行后产生的运行期 User 输入或 canonical Agent 内容。
- * - `effects` 是当前 Turn 只追加收集、并在收口检查点解释的已发生副作用。
- * - Message Parts 复用 Downcity Session UI 协议，不再建立文件、图片或 Plugin 专用桥接。
- */
-/** 判断未知 Tool 输出是否使用统一 ActionResult 协议。 */
-export function is_action_result(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        return false;
-    const record = value;
-    return Object.prototype.hasOwnProperty.call(record, "output") &&
-        Array.isArray(record.messages);
-}
-//# sourceMappingURL=ActionResult.js.map

package/bin/types/action/ActionResult.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionResult.js","sourceRoot":"","sources":["../../../src/types/action/ActionResult.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmCH,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC3D,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}

package/bin/types/executor/ModelRequest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ModelRequest.d.ts","sourceRoot":"","sources":["../../../src/types/executor/ModelRequest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEhE,kBAAkB;AAClB,MAAM,MAAM,2BAA2B,GAAG,CACxC,MAAM,EAAE,yBAAyB;AACjC,6BAA6B;AAC7B,KAAK,EAAE,OAAO,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/bin/types/executor/ModelRequest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ModelRequest.js","sourceRoot":"","sources":["../../../src/types/executor/ModelRequest.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/bin/types/executor/SessionAssistantOutput.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionAssistantOutput.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionAssistantOutput.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EACV,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,qBAAqB;IACrB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,2BAA2B;IAC3B,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,oBAAoB;IACpB,iBAAiB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,2CAA2C;IAC3C,WAAW,CAAC,KAAK,EAAE,uBAAuB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,2BAA2B;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,8CAA8C;IAC9C,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,+CAA+C;IAC/C,mBAAmB,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC/F,iDAAiD;IACjD,YAAY,CAAC,KAAK,EAAE;QAClB,cAAc;QACd,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;QAC1B,aAAa;QACb,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,oBAAoB;QACpB,WAAW,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,kCAAkC;IAClC,MAAM,CAAC,KAAK,EAAE;QACZ,sBAAsB;QACtB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC3C,qCAAqC;QACrC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB"}

package/bin/types/executor/SessionAssistantOutput.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionAssistantOutput.js","sourceRoot":"","sources":["../../../src/types/executor/SessionAssistantOutput.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/bin/types/executor/SessionToolExecutionContext.d.ts

@@ -1,23 +0,0 @@
-/**
- * Session tool 显式执行上下文。
- *
- * 关键点（中文）
- * - 该对象由 Executor 在每个 Session step 绑定到 tool.execute。
- * - Agent 工具读取 session_turn_context，Shell 工具只读取 shell_execution_context。
- * - 上下文归属当前 Turn，不通过进程级或异步全局容器共享。
- */
-import type { ShellExecutionContext } from "@downcity/type/shell";
-import type { SessionTurnContext } from "../../types/executor/SessionTurnContext.js";
-import type { ToolActionExecutionContext } from "../../types/tools/ToolActionExecutionContext.js";
-/**
- * Agent 与 Shell 工具共用的单次执行上下文。
- */
-export interface SessionToolExecutionContext {
-    /** 业务 Tool 读取的最小执行上下文。 */
-    action_execution_context: ToolActionExecutionContext;
-    /** 当前 Shell Tool 的 canonical 执行上下文。 */
-    shell_execution_context: ShellExecutionContext;
-    /** 当前工具调用所属的完整 Session Turn 上下文。 */
-    session_turn_context: SessionTurnContext;
-}
-//# sourceMappingURL=SessionToolExecutionContext.d.ts.map

package/bin/types/executor/SessionToolExecutionContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionToolExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionToolExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B;IAC1B,wBAAwB,EAAE,0BAA0B,CAAC;IACrD,uCAAuC;IACvC,uBAAuB,EAAE,qBAAqB,CAAC;IAC/C,oCAAoC;IACpC,oBAAoB,EAAE,kBAAkB,CAAC;CAC1C"}

package/bin/types/executor/SessionToolExecutionContext.js

@@ -1,10 +0,0 @@
-/**
- * Session tool 显式执行上下文。
- *
- * 关键点（中文）
- * - 该对象由 Executor 在每个 Session step 绑定到 tool.execute。
- * - Agent 工具读取 session_turn_context，Shell 工具只读取 shell_execution_context。
- * - 上下文归属当前 Turn，不通过进程级或异步全局容器共享。
- */
-export {};
-//# sourceMappingURL=SessionToolExecutionContext.js.map

package/bin/types/executor/SessionToolExecutionContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionToolExecutionContext.js","sourceRoot":"","sources":["../../../src/types/executor/SessionToolExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/types/executor/SessionTurnContext.d.ts.map

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

package/bin/types/executor/SessionTurnContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionTurnContext.js","sourceRoot":"","sources":["../../../src/types/executor/SessionTurnContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/types/session/AdaptivePartContextPolicy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AdaptivePartContextPolicy.d.ts","sourceRoot":"","sources":["../../../src/types/session/AdaptivePartContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAExB,6BAA6B;AAC7B,MAAM,WAAW,yBAAyB;IACxC,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,yBAAyB;IACzB,IAAI,EAAE,sBAAsB,GAAG,uBAAuB,CAAC;CACxD"}

package/bin/types/session/AdaptivePartContextPolicy.js

@@ -1,7 +0,0 @@
-/**
- * AdaptivePartContextPolicy 内部持久化与候选类型。
- *
- * 类型集中在 types 目录，策略模块只保留上下文选择行为。
- */
-export {};
-//# sourceMappingURL=AdaptivePartContextPolicy.js.map

package/bin/types/session/AdaptivePartContextPolicy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AdaptivePartContextPolicy.js","sourceRoot":"","sources":["../../../src/types/session/AdaptivePartContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/bin/types/session/SessionComposition.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionComposition.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionComposition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,+BAA+B;AAC/B,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,cAAc,EAAE,aAAa,CAAC;IAC9B,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,KAAK,EAAE,cAAc,CAAC;IACtB,iCAAiC;IACjC,QAAQ,EAAE,eAAe,CAAC;IAC1B,kCAAkC;IAClC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,mDAAmD;IACnD,yBAAyB,EAAE,uBAAuB,EAAE,CAAC;IACrD,0DAA0D;IAC1D,6BAA6B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAC/D,sCAAsC;IACtC,SAAS,EAAE,MAAM,kBAAkB,CAAC;IACpC,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,yCAAyC;IACzC,gCAAgC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC3E,4BAA4B;IAC5B,SAAS,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACzC,sBAAsB;IACtB,wBAAwB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACnD,2BAA2B;IAC3B,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,0BAA0B;IAC1B,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/bin/types/session/SessionComposition.js

@@ -1,8 +0,0 @@
-/**
- * Session system 快照与模型输入组装的依赖类型。
- *
- * 这些字段共同描述 composition 领域所需的最小只读资源；SessionComposition 不拥有
- * Message、Store、Model 或 Plugin 生命周期。
- */
-export {};
-//# sourceMappingURL=SessionComposition.js.map

package/bin/types/session/SessionComposition.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionComposition.js","sourceRoot":"","sources":["../../../src/types/session/SessionComposition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/bin/types/session/SessionContextPolicy.d.ts

@@ -1,70 +0,0 @@
-/**
- * Session Composer 的上下文策略协议。
- *
- * Policy 只读取 canonical Message，并在自己的命名空间维护可删除、可重建的派生数据；
- * 它不修改 Session Message、State 或 Turn 生命周期。
- */
-import type { ModelClient, ModelMessage, SessionSystemBlock } from "@downcity/type";
-import type { ModelRequestFailureReporter } from "../../types/executor/ModelRequest.js";
-import type { SessionComposerStorage } from "../../types/store/SessionStorage.js";
-/** Composer 可以处理的上下文恢复原因。 */
-export type SessionContextRecoveryReason = 
-/** Provider 明确拒绝超出上下文窗口的请求。 */
-"provider_context_limit"
-/** Provider usage 已达到主动压缩阈值。 */
- | "usage_pressure";
-/** Policy 初始化输入。 */
-export interface SessionContextPolicyInitializeInput {
-    /** 当前 Policy 已限定命名空间的派生存储。 */
-    storage: SessionComposerStorage;
-}
-/** Policy 正常解析上下文的输入。 */
-export interface SessionContextPolicyInput {
-    /** 当前 Policy 已限定命名空间的派生存储。 */
-    storage: SessionComposerStorage;
-    /** 解析文件 Part 时使用的 Workspace 根目录。 */
-    project_root: string;
-}
-/** 上下文恢复输入。 */
-export interface SessionContextPolicyRecoveryInput extends SessionContextPolicyInput {
-    /** 触发当前恢复的稳定领域原因。 */
-    reason: SessionContextRecoveryReason;
-    /** 用于生成派生摘要的当前模型。 */
-    model?: ModelClient;
-    /** 模型请求逐次失败的可选观测入口。 */
-    on_model_request_failure?: ModelRequestFailureReporter;
-}
-/** Policy 对本次模型上下文的只读诊断。 */
-export interface SessionResolvedContextDiagnostics {
-    /** 生成当前上下文的 Policy 名称。 */
-    policy_name: string;
-    /** 当前上下文覆盖到的最新 canonical Message sequence。 */
-    through_sequence?: number;
-    /** 当前派生边界在 Message 内覆盖到的 Part sequence。 */
-    through_part_sequence?: number;
-    /** 当前上下文是否使用了派生摘要或检索结果。 */
-    derived: boolean;
-    /** 当前使用的可选派生记录标识。 */
-    derivation_id?: string;
-}
-/** Policy 已确定顺序的最终模型历史。 */
-export interface SessionResolvedContext {
-    /** 送入模型的标准历史消息。 */
-    messages: ModelMessage[];
-    /** 由 Policy 生成、且不伪装成普通历史消息的显式 system 上下文。 */
-    system_blocks?: SessionSystemBlock[];
-    /** 不进入 canonical history 的策略诊断。 */
-    diagnostics: SessionResolvedContextDiagnostics;
-}
-/** Session Composer 内部可替换的上下文策略。 */
-export interface SessionContextPolicy {
-    /** Policy 稳定名称，同时作为派生表命名空间。 */
-    readonly name: string;
-    /** 初始化当前 Policy 的派生 schema。 */
-    initialize(input: SessionContextPolicyInitializeInput): Promise<void>;
-    /** 从 canonical history 与派生数据生成模型历史。 */
-    resolve(input: SessionContextPolicyInput): Promise<SessionResolvedContext>;
-    /** 模型上下文失败后尝试推进派生状态；发生有效变化时返回 true。 */
-    recover(input: SessionContextPolicyRecoveryInput): Promise<boolean>;
-}
-//# sourceMappingURL=SessionContextPolicy.d.ts.map

package/bin/types/session/SessionContextPolicy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionContextPolicy.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E,6BAA6B;AAC7B,MAAM,MAAM,4BAA4B;AACtC,+BAA+B;AAC7B,wBAAwB;AAC1B,gCAAgC;GAC9B,gBAAgB,CAAC;AAErB,oBAAoB;AACpB,MAAM,WAAW,mCAAmC;IAClD,8BAA8B;IAC9B,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED,yBAAyB;AACzB,MAAM,WAAW,yBAAyB;IACxC,8BAA8B;IAC9B,OAAO,EAAE,sBAAsB,CAAC;IAChC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAe;AACf,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF,qBAAqB;IACrB,MAAM,EAAE,4BAA4B,CAAC;IACrC,qBAAqB;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,uBAAuB;IACvB,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;CACxD;AAED,4BAA4B;AAC5B,MAAM,WAAW,iCAAiC;IAChD,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,2BAA2B;AAC3B,MAAM,WAAW,sBAAsB;IACrC,mBAAmB;IACnB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACrC,mCAAmC;IACnC,WAAW,EAAE,iCAAiC,CAAC;CAChD;AAED,oCAAoC;AACpC,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,UAAU,CAAC,KAAK,EAAE,mCAAmC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,uCAAuC;IACvC,OAAO,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC3E,uCAAuC;IACvC,OAAO,CAAC,KAAK,EAAE,iCAAiC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE"}

package/bin/types/session/SessionContextPolicy.js

@@ -1,8 +0,0 @@
-/**
- * Session Composer 的上下文策略协议。
- *
- * Policy 只读取 canonical Message，并在自己的命名空间维护可删除、可重建的派生数据；
- * 它不修改 Session Message、State 或 Turn 生命周期。
- */
-export {};
-//# sourceMappingURL=SessionContextPolicy.js.map

package/bin/types/session/SessionContextPolicy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionContextPolicy.js","sourceRoot":"","sources":["../../../src/types/session/SessionContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/bin/types/tools/ToolActionExecutionContext.d.ts

@@ -1,30 +0,0 @@
-/**
- * 普通 Tool 一次调用获得的最小执行上下文。
- *
- * 该类型只暴露业务 Tool 需要的调用身份、取消、Workspace 快照和可选
- * Session Interaction，不暴露 SessionTurnContext、消息写入器或 Plugin lease。
- */
-import type { SessionInteractionPort } from "@downcity/type";
-/** 普通 Tool 所属的 Session 范围。 */
-export interface ToolSessionExecutionScope {
-    /** 当前 Session 标识。 */
-    readonly session_id: string;
-    /** 当前 Turn 标识。 */
-    readonly turn_id: string;
-    /** 当前 Session 的用户交互端口；未启用 Interaction 时为空。 */
-    readonly interactions?: SessionInteractionPort;
-}
-/** 普通 Tool 的单次调用上下文。 */
-export interface ToolActionExecutionContext {
-    /** 当前 Tool Call 标识。 */
-    readonly call_id: string;
-    /** 当前 Tool 调用的取消信号。 */
-    readonly abort_signal: AbortSignal;
-    /** 当前 Tool 所属 Session 范围。 */
-    readonly session: ToolSessionExecutionScope;
-    /** 当前 Workspace 项目根目录。 */
-    readonly workspace_path?: string;
-    /** 当前 Step 已提交生效的 Workspace env。 */
-    readonly workspace_env?: Readonly<Record<string, string>>;
-}
-//# sourceMappingURL=ToolActionExecutionContext.d.ts.map

package/bin/types/tools/ToolActionExecutionContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolActionExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/tools/ToolActionExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,8BAA8B;AAC9B,MAAM,WAAW,yBAAyB;IACxC,qBAAqB;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;CAChD;AAED,wBAAwB;AACxB,MAAM,WAAW,0BAA0B;IACzC,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,0BAA0B;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3D"}

package/bin/types/tools/ToolActionExecutionContext.js

@@ -1,8 +0,0 @@
-/**
- * 普通 Tool 一次调用获得的最小执行上下文。
- *
- * 该类型只暴露业务 Tool 需要的调用身份、取消、Workspace 快照和可选
- * Session Interaction，不暴露 SessionTurnContext、消息写入器或 Plugin lease。
- */
-export {};
-//# sourceMappingURL=ToolActionExecutionContext.js.map

package/bin/types/tools/ToolActionExecutionContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolActionExecutionContext.js","sourceRoot":"","sources":["../../../src/types/tools/ToolActionExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/src/executor/Executor.ts

@@ -1,319 +0,0 @@
-/**
- * Executor：单个 session 的执行编排器。
- *
- * 关键点（中文）
- * - SDK 对外对象叫 `Session`，这里是内部执行层。
- * - 一个 Executor 只对应一个固定的 `session_id`。
- * - 负责显式 Turn 上下文消费、executing 状态、Composer 编排与 Tool Loop 执行。
- */
-
-import type {
-  ModelClient,
-  RuntimeTool as Tool,
-  RuntimeToolExecutionOptions as ToolExecutionOptions,
-  SessionHookRuntime,
-} from "@downcity/type";
-import { CoreEngineRunner } from "@executor/core-engine/CoreEngineRunner.js";
-import { ExecutorRecoveryPolicy } from "@executor/services/ExecutorRecoveryPolicy.js";
-import type { Logger } from "@/utils/logger/Logger.js";
-import type { SessionExecutor } from "@/types/session/SessionExecution.js";
-import type { SessionTurnContext } from "@/types/executor/SessionTurnContext.js";
-import type { SessionToolExecutionContext } from "@/types/executor/SessionToolExecutionContext.js";
-import { is_action_result } from "@/types/action/ActionResult.js";
-import type {
-  SessionStepExecutionInput,
-  SessionTurnExecutionResult,
-} from "@/types/session/SessionExecution.js";
-import type {
-  SessionComposer,
-  SessionComposeInput,
-  SessionStepInput,
-} from "@/types/session/SessionComposer.js";
-import type { SessionContextRecoveryReason } from "@/types/session/SessionContextPolicy.js";
-
-type ExecutorOptions = {
-  /**
-   * 当前会话 ID。
-   */
-  session_id: string;
-
-  /** 当前 Session 使用的统一 Composer。 */
-  composer: SessionComposer;
-
-  /** 为 Composer 创建当前 Step 的只读输入快照。 */
-  get_compose_input: (
-    turn_context: SessionTurnContext,
-    retry_count: number,
-  ) => Promise<SessionComposeInput>;
-
-  /** 请求当前 Composer 推进派生上下文状态。 */
-  recover_context: (reason: SessionContextRecoveryReason) => Promise<boolean>;
-
-  /** 应用 Session 级固定 system snapshot。 */
-  apply_system_snapshot?: (input: SessionStepInput) => SessionStepInput;
-
-  /**
-   * 统一日志器。
-   */
-  logger: Logger;
-
-  /** 创建当前 Session effective City 扩展执行视图。 */
-  get_hooks?: () => SessionHookRuntime;
-};
-
-/**
- * Executor 单实例实现。
- */
-export class Executor implements SessionExecutor {
-  /**
-   * 当前 session 标识。
-   */
-  readonly session_id: string;
-
-  private readonly composer: SessionComposer;
-  private readonly get_compose_input: ExecutorOptions["get_compose_input"];
-  private readonly recover_context: ExecutorOptions["recover_context"];
-  private readonly apply_system_snapshot?: ExecutorOptions["apply_system_snapshot"];
-  private readonly get_hooks: ExecutorOptions["get_hooks"];
-  private readonly logger: Logger;
-  private readonly recovery_policy: ExecutorRecoveryPolicy;
-  private readonly core_engine_runner: CoreEngineRunner;
-
-  private executing = false;
-
-  constructor(options: ExecutorOptions) {
-    const session_id = String(options.session_id || "").trim();
-    if (!session_id) {
-      throw new Error("Executor requires a non-empty session_id");
-    }
-
-    this.session_id = session_id;
-    this.composer = options.composer;
-    this.get_compose_input = options.get_compose_input;
-    this.recover_context = options.recover_context;
-    this.apply_system_snapshot = options.apply_system_snapshot;
-    this.get_hooks = options.get_hooks;
-    this.logger = options.logger;
-    this.recovery_policy = new ExecutorRecoveryPolicy({
-      session_id: this.session_id,
-      recover_context: async (error) =>
-        is_provider_context_limit_error(error)
-          ? await this.recover_context("provider_context_limit")
-          : false,
-      logger: this.logger,
-    });
-    this.core_engine_runner = new CoreEngineRunner({
-      session_id: this.session_id,
-      logger: this.logger,
-      should_compact_on_error: (error) =>
-        is_provider_context_limit_error(error),
-    });
-  }
-
-  /**
-   * 返回当前 session 是否正在执行。
-   */
-  is_executing(): boolean {
-    return this.executing;
-  }
-
-  /**
-   * 执行当前 Session 的一次 Turn。
-   *
-   * 关键点（中文）
-   * - 这里直接承接单个 Session 实例的一次 Turn 执行编排。
-   * - scope 绑定、assistant step 持久化、executing 状态都收在实例内部。
-   */
-  async execute(params: {
-    turn_context: SessionTurnContext;
-  }): Promise<SessionTurnExecutionResult> {
-    if (this.executing) {
-      // 关键点（中文）：同一个 Session 实例只允许一个活跃 Turn 执行，
-      // 否则 step 回调、scope 与执行器状态都会互相污染。
-      throw new Error("Executor.execute does not support concurrent execution");
-    }
-    const turn_context = params.turn_context;
-    this.executing = true;
-    try {
-      const result = await this.recovery_policy.execute_with_retry({
-        execute_turn: async (retry_count) =>
-          await this.core_engine_runner.execute({
-            turn_context,
-            resolve_step_input: async () =>
-              await this.resolve_step_input(turn_context, retry_count),
-          }),
-      });
-      return result;
-    } finally {
-      this.executing = false;
-    }
-  }
-
-  /**
-   * 为下一 Provider Step 生成唯一一份完整输入。
-   *
-   * 关键点（中文）
-   * - 调用方必须先提交 Session 统一输入队列，再调用本方法。
-   * - 每次调用只读取一次 model、system 与 tools，并把它们传给同一个模型 step。
-   */
-  private async resolve_step_input(
-    turn_context: SessionTurnContext,
-    retry_count: number,
-  ): Promise<SessionStepExecutionInput> {
-    const composed = await this.compose_step(turn_context, retry_count);
-    return {
-      model: composed.model,
-      system: composed.input.system,
-      messages: composed.input.messages,
-      tools: this.bind_turn_context_to_tools(
-        composed.input.tools,
-        turn_context,
-      ),
-      ...(composed.context_window !== undefined
-        ? {
-            context_window: composed.context_window,
-          }
-        : {}),
-    };
-  }
-
-  /** 读取只读 Session 快照并交给统一 Composer。 */
-  private async compose_step(
-    turn_context: SessionTurnContext,
-    retry_count: number,
-  ): Promise<{
-    input: SessionStepInput;
-    model: ModelClient;
-    context_window?: number;
-  }> {
-    await this.refresh_step_runtime(turn_context);
-    const compose_input = await this.get_compose_input(
-      turn_context,
-      retry_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 raw_input = await this.composer.compose(compose_input);
-    return {
-      input: this.apply_system_snapshot
-        ? this.apply_system_snapshot(raw_input)
-        : raw_input,
-      model,
-      ...(compose_input.state.model_context_window !== undefined
-        ? { context_window: compose_input.state.model_context_window }
-        : {}),
-    };
-  }
-
-  /**
-   * 刷新当前 Session step 的 effective Agent 运行视图。
-   */
-  private async refresh_step_runtime(
-    turn_context: SessionTurnContext,
-  ): Promise<void> {
-    const hooks = await this.get_hooks?.().open();
-    await turn_context.step.replace_hooks(hooks);
-  }
-
-  /**
-   * 为所有 tool execute callback 绑定显式 Session 运行上下文。
-   *
-   * 关键点（中文）
-   * - 每个 step 使用独立包装工具，不会在并行 Session 间共享可变指针。
-   * - Agent 与 Shell 工具通过 RuntimeToolExecutionOptions.context 读取显式快照。
-   */
-  private bind_turn_context_to_tools(
-    tools: Record<string, Tool>,
-    turn_context: SessionTurnContext,
-  ): Record<string, Tool> {
-    const wrapped: Record<string, Tool> = {};
-    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: unknown, options: ToolExecutionOptions) => {
-          const tool_call_id = String(options.tool_call_id || "").trim();
-          if (!tool_call_id) {
-            throw new Error(`Tool execution requires toolCallId: ${name}`);
-          }
-          if (tool_call_id && turn_context.output.assistant) {
-            await turn_context.output.assistant.prepare_tool_input({
-              tool_call_id,
-              tool_name: name,
-              input: args,
-            });
-          }
-          const abort_signal = options.abort_signal ||
-            turn_context.lifecycle.abort_signal;
-          const execution_context: SessionToolExecutionContext = {
-            session_turn_context: turn_context,
-            action_execution_context: {
-              call_id: tool_call_id,
-              abort_signal,
-              session: {
-                session_id: turn_context.session.session_id,
-                turn_id: turn_context.session.turn_id,
-                interactions: turn_context.interactions,
-              },
-              ...(turn_context.session.project_root
-                ? { workspace_path: turn_context.session.project_root }
-                : {}),
-              ...(turn_context.step.workspace_env
-                ? { workspace_env: turn_context.step.workspace_env }
-                : {}),
-            },
-            shell_execution_context: {
-              session: {
-                session_id: turn_context.session.session_id,
-                turn_id: turn_context.session.turn_id,
-              },
-              call_id: tool_call_id,
-              abort_signal,
-              ...(turn_context.step.workspace_env
-                ? { workspace_env: turn_context.step.workspace_env }
-                : {}),
-              ...(turn_context.shell.approval_gateway
-                ? { approval_gateway: turn_context.shell.approval_gateway }
-                : {}),
-            },
-          };
-          const output = await original_execute(args, {
-            ...options,
-            context: execution_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;
-  }
-
-}
-
-/** Core Engine 的单 Step 内恢复仍需同步识别 Provider 上下文错误。 */
-function is_provider_context_limit_error(error: unknown): boolean {
-  const message = String(error ?? "").toLowerCase();
-  return message.includes("context_length") ||
-    message.includes("too long") ||
-    message.includes("maximum context") ||
-    message.includes("context window");
-}