@downcity/agent 1.1.337 → 1.1.399

package/bin/types/plugin/PluginContext.d.ts

@@ -2,28 +2,39 @@
  * PluginContext：Agent 向 Plugin 投影的稳定能力视图。
  *
  * 边界说明（中文）
- * - Plugin 只依赖本接口，不持有 Agent 实例，也不参与 Session 内核编排。
+ * - Plugin 只依赖本接口，不持有 Agent、City 实例，也不参与 Session 内核编排。
  * - 动态状态通过只读 getter 暴露，保证 Workspace env 与 instruction 始终来自唯一状态源。
  */
-import type { AgentSessions } from "../../agent/AgentSessions.js";
-import type { AgentPlugins } from "../../types/plugin/PluginRuntime.js";
-import type { FileSystem } from "../../types/workspace/FileSystem.js";
+import type { AgentSessionCollection } from "../agent/AgentSessionCollection.js";
+import type { AgentPlugins } from "./PluginRuntime.js";
+import type { FileSystem, WorkspaceShell } from "@downcity/workspace";
 import type { Logger } from "../../utils/logger/Logger.js";
-import type { Shell } from "@downcity/shell";
+import type { PluginWebServices } from "./PluginServices.js";
+import type { Embassy } from "@downcity/federation";
 /** Agent 向 Plugin 开放的最小、稳定运行时能力。 */
 export interface PluginContext {
     /** 当前 Agent 的稳定标识。 */
     readonly agent_id: string;
+    /** 当前 Workspace 的稳定标识。 */
+    readonly workspace_id: string;
     /** 当前 Workspace 的绝对根目录。 */
     readonly workspace_path: string;
+    /** 当前 Plugin 在 Agent 内的运行时私有数据根路径。 */
+    readonly data_path: string;
     /** 当前 Workspace 的统一文件能力。 */
     readonly files: FileSystem;
+    /** 当前 Plugin 运行时私有数据目录的统一文件能力。 */
+    readonly data_files: FileSystem;
     /** 当前 Workspace 显式挂载的 Shell；未启用时为空。 */
-    readonly shell?: Shell;
-    /** 当前 Agent 独享的统一日志器。 */
+    readonly shell?: WorkspaceShell;
+    /** 当前 Agent 在当前 Workspace 执行上下文中使用的统一日志器。 */
     readonly logger: Logger;
+    /** 当前 Agent 持有的 Web 搜索与文档能力。 */
+    readonly web?: PluginWebServices;
+    /** City 注入的 Embassy 能力；Agent 未加入 City 时为空。 */
+    readonly embassy?: Embassy;
     /** 当前 Agent 的 Session 集合入口。 */
-    readonly sessions: AgentSessions;
+    readonly sessions: AgentSessionCollection;
     /** 当前 Agent 唯一的 Plugin 调用与注册入口。 */
     readonly plugins: AgentPlugins;
     /** 当前 Workspace 已配置环境变量的只读快照。 */

package/bin/types/plugin/PluginContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginContext.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,2BAA2B;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAEvB,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAE/B,iCAAiC;IACjC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEzD,6BAA6B;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C"}
+{"version":3,"file":"PluginContext.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,0BAA0B;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,2BAA2B;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAEhC,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,gCAAgC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,iBAAiB,CAAC;IAEjC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAE1C,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAE/B,iCAAiC;IACjC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEzD,6BAA6B;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C"}

package/bin/types/plugin/PluginContext.js

@@ -2,7 +2,7 @@
  * PluginContext：Agent 向 Plugin 投影的稳定能力视图。
  *
  * 边界说明（中文）
- * - Plugin 只依赖本接口，不持有 Agent 实例，也不参与 Session 内核编排。
+ * - Plugin 只依赖本接口，不持有 Agent、City 实例，也不参与 Session 内核编排。
  * - 动态状态通过只读 getter 暴露，保证 Workspace env 与 instruction 始终来自唯一状态源。
  */
 export {};

package/bin/types/plugin/PluginDefinition.d.ts

@@ -5,12 +5,12 @@
  * - 这里只组合 plugin 的各类能力，不展开每个能力的细节。
  * - 细节类型分散在 State / Action / Runtime / Lifecycle / HTTP 模块。
  */
-import type { PluginContext } from "../../types/plugin/PluginContext.js";
-import type { PluginActions } from "../../types/plugin/PluginAction.js";
-import type { PluginAvailability, PluginHooks, PluginResolves } from "../../types/plugin/PluginRuntime.js";
-import type { PluginLifecycle } from "../../types/plugin/PluginCommand.js";
-import type { PluginHttpDefinition } from "../../types/plugin/PluginHttp.js";
-import type { PluginExecutionContext } from "../../types/plugin/PluginExecutionContext.js";
+import type { PluginContext } from "./PluginContext.js";
+import type { PluginActions } from "./PluginAction.js";
+import type { PluginAvailability, PluginHooks, PluginResolves } from "./PluginRuntime.js";
+import type { PluginLifecycle } from "./PluginCommand.js";
+import type { PluginHttpDefinition } from "./PluginHttp.js";
+import type { PluginExecutionContext } from "./PluginExecutionContext.js";
 /**
  * Plugin 定义。
  */

package/bin/types/plugin/PluginExecutionContext.d.ts

@@ -1,11 +1,3 @@
-/**
- * Plugin 单次调用的执行上下文。
- *
- * 关键点（中文）
- * - 只暴露 plugin 业务需要的只读 Session 快照。
- * - 不暴露 Executor 内部队列、callback 或 plugin lease。
- * - CLI、HTTP 与 scheduler 等非 Session 调用可能不提供该对象。
- */
 /**
  * Plugin action 与 system provider 可读取的执行快照。
  *
@@ -13,8 +5,8 @@
  * scheduler 等非 Session 调用也可以提供自己的调用快照或完全缺省。
  */
 export interface PluginExecutionContext {
-    /** 当前调用所属的 Session 标识。 */
-    readonly session_id: string;
+    /** 当前调用所属的 Session 标识；非 Session 调用可以缺省。 */
+    readonly session_id?: string;
     /** 当前调用所属的 Turn 标识。 */
     readonly turn_id?: string;
     /** 当前 Agent 绑定的项目根目录。 */
@@ -25,5 +17,7 @@ export interface PluginExecutionContext {
     readonly agent_systems?: readonly string[];
     /** 当前 Turn 的取消信号。 */
     readonly abort_signal?: AbortSignal;
+    /** 当前 Action 调用标识；仅 Action 执行时存在。 */
+    readonly call_id?: string;
 }
 //# sourceMappingURL=PluginExecutionContext.d.ts.map

package/bin/types/plugin/PluginExecutionContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,uBAAuB;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,yBAAyB;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAE1D,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE3C,qBAAqB;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC;CACrC"}
+{"version":3,"file":"PluginExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,uBAAuB;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,yBAAyB;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAE1D,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE3C,qBAAqB;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC;IAEpC,qCAAqC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/bin/types/plugin/PluginExecutionContext.js

@@ -1,10 +1,8 @@
 /**
- * Plugin 单次调用的执行上下文。
+ * Plugin action 与 system provider 可读取的执行快照。
  *
- * 关键点（中文）
- * - 只暴露 plugin 业务需要的只读 Session 快照。
- * - 不暴露 Executor 内部队列、callback 或 plugin lease。
- * - CLI、HTTP 与 scheduler 等非 Session 调用可能不提供该对象。
+ * Session 调用时，该对象是当前 Turn 的只读 Plugin 投影；CLI、HTTP 与
+ * scheduler 等非 Session 调用也可以提供自己的调用快照或完全缺省。
  */
 export {};
 //# sourceMappingURL=PluginExecutionContext.js.map

package/bin/types/plugin/PluginExecutionContext.js.map

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

package/bin/types/plugin/PluginHttp.d.ts

@@ -6,7 +6,7 @@
  * - server 装配、代理和鉴权执行仍由宿主负责。
  */
 import type { Hono } from "hono";
-import type { PluginContext } from "../../types/plugin/PluginContext.js";
+import type { PluginContext } from "./PluginContext.js";
 import type { AuthRoutePolicy } from "@downcity/type";
 /**
  * Plugin HTTP 注入参数。

package/bin/types/plugin/PluginRuntime.d.ts

@@ -5,14 +5,15 @@
  * - 这里描述 Agent runtime 如何查看、调用、检查 plugin。
  * - setup/usage UI 协议与 action 输入适配不放在这里。
  */
-import type { PluginContext } from "../../types/plugin/PluginContext.js";
-import type { JsonValue } from "../../types/common/Json.js";
-import type { PluginActionResult } from "../../types/plugin/PluginAction.js";
-import type { PluginActionExample } from "../../types/plugin/PluginAction.js";
-import type { Plugin } from "../../types/plugin/PluginDefinition.js";
-import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js";
-import type { PluginSnapshot } from "../../types/plugin/PluginState.js";
-import type { PluginExecutionContext } from "../../types/plugin/PluginExecutionContext.js";
+import type { PluginContext } from "./PluginContext.js";
+import type { JsonValue } from "../common/Json.js";
+import type { PluginActionResult } from "./PluginAction.js";
+import type { PluginActionExample } from "./PluginAction.js";
+import type { Plugin } from "./PluginDefinition.js";
+import type { AgentSessionSystemBlock } from "../agent/SessionTypes.js";
+import type { PluginSnapshot } from "./PluginState.js";
+import type { PluginExecutionContext } from "./PluginExecutionContext.js";
+import type { SessionInteractionPort } from "../session/SessionInteraction.js";
 /**
  * Plugin 概览视图。
  */
@@ -130,6 +131,8 @@ export interface AgentPlugins {
         payload?: JsonValue;
         /** 当前 action 所属 Session Turn 的只读 Plugin 执行快照。 */
         execution_context?: PluginExecutionContext;
+        /** 当前 Session 的 Interaction 端口；非 Session 调用时为空。 */
+        interactions?: SessionInteractionPort;
     }): Promise<PluginActionResult<JsonValue>>;
     /** 读取当前生效的 plugin system blocks。 */
     system_blocks(execution_context?: PluginExecutionContext): Promise<AgentSessionSystemBlock[]>;
@@ -165,6 +168,8 @@ export interface AgentPluginExecutionView {
         payload?: JsonValue;
         /** 当前 action 所属 Session Turn 的只读 Plugin 执行快照。 */
         execution_context?: PluginExecutionContext;
+        /** 当前 Session 的 Interaction 端口；非 Session 调用时为空。 */
+        interactions?: SessionInteractionPort;
     }): Promise<PluginActionResult<JsonValue>>;
     /** 解析当前视图中捕获的 plugin system blocks。 */
     system_blocks(execution_context?: PluginExecutionContext): Promise<AgentSessionSystemBlock[]>;

package/bin/types/plugin/PluginRuntime.d.ts.map

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

package/bin/types/plugin/PluginServices.d.ts

@@ -0,0 +1,10 @@
+/** Agent 向 Plugin 提供的可选外部服务能力。 */
+import type { JsonObject, JsonValue } from "../common/Json.js";
+/** Plugin 可使用的 Web 服务最小协议。 */
+export interface PluginWebServices {
+    /** 搜索公开 Web 内容。 */
+    search(input: JsonObject): Promise<JsonValue>;
+    /** 读取指定 Web 文档。 */
+    open(input: JsonObject): Promise<JsonValue>;
+}
+//# sourceMappingURL=PluginServices.d.ts.map

package/bin/types/plugin/PluginServices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginServices.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginServices.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEpE,8BAA8B;AAC9B,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9C,mBAAmB;IACnB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC7C"}

package/bin/types/plugin/PluginServices.js

@@ -0,0 +1,3 @@
+/** Agent 向 Plugin 提供的可选外部服务能力。 */
+export {};
+//# sourceMappingURL=PluginServices.js.map

package/bin/types/plugin/PluginServices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginServices.js","sourceRoot":"","sources":["../../../src/types/plugin/PluginServices.ts"],"names":[],"mappings":"AAAA,kCAAkC"}

package/bin/types/plugin/PluginState.d.ts

@@ -2,15 +2,15 @@
  * Plugin 注册状态类型。
  *
  * 关键点（中文）
- * - Plugin 只属于 Agent：注册即生效，卸载即不可见。
+ * - Plugin 只属于 Agent：完成 lifecycle.start 后生效，卸载后立即不可见。
  * - 不再暴露 start / stop / restart 这类生命周期状态。
  * - `error` 只表示最近一次注册后运行发生错误，方便开发者诊断。
  */
-import type { Plugin } from "../../types/plugin/PluginDefinition.js";
+import type { Plugin } from "./PluginDefinition.js";
 /**
  * Plugin 当前可观察状态。
  */
-export type PluginState = "ready" | "error";
+export type PluginState = "initializing" | "ready" | "error";
 /**
  * 单个已注册 plugin 的运行时记录。
  */

package/bin/types/plugin/PluginState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginState.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,gCAAgC;IAChC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,uBAAuB,EAAE,MAAM,CAAC;IAChC,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,mBAAmB;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"PluginState.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,gCAAgC;IAChC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,uBAAuB,EAAE,MAAM,CAAC;IAChC,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,mBAAmB;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/bin/types/plugin/PluginState.js

@@ -2,7 +2,7 @@
  * Plugin 注册状态类型。
  *
  * 关键点（中文）
- * - Plugin 只属于 Agent：注册即生效，卸载即不可见。
+ * - Plugin 只属于 Agent：完成 lifecycle.start 后生效，卸载后立即不可见。
  * - 不再暴露 start / stop / restart 这类生命周期状态。
  * - `error` 只表示最近一次注册后运行发生错误，方便开发者诊断。
  */

package/bin/types/plugin/PluginTool.d.ts

@@ -5,10 +5,10 @@
  * - 这里描述模型通过 plugin_call 提交的最低层调用协议。
  * - payload 保持 JSON 对象，避免 tool 层理解具体 plugin 的业务字段。
  */
-import type { Tool } from "ai";
-import type { JsonObject } from "../../types/common/Json.js";
-import type { AgentPlugins } from "../../types/plugin/PluginRuntime.js";
-import type { SessionTurnContext } from "../../types/executor/SessionTurnContext.js";
+import type { RuntimeTool as Tool } from "@downcity/type";
+import type { JsonObject } from "../common/Json.js";
+import type { AgentPlugins } from "./PluginRuntime.js";
+import type { SessionTurnContext } from "../executor/SessionTurnContext.js";
 /**
  * plugin_call 输入。
  */
@@ -75,6 +75,8 @@ export interface InvokePluginCallToolOptions {
     plugins: AgentPlugins;
     /** Executor 为当前 Tool Call 绑定的 Session Turn Context。 */
     turn_context: SessionTurnContext;
+    /** Downcity Model Protocol 为当前 plugin_call 分配的稳定 Tool Call 标识。 */
+    call_id: string;
     /** 模型提交给 plugin_call 的结构化输入。 */
     input: PluginCallInput;
 }

package/bin/types/plugin/PluginTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginTool.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginTool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,sCAAsC;AACtC,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,WAAW,EAAE,IAAI,CAAC;IAElB,iDAAiD;IACjD,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,+BAA+B;AAC/B,MAAM,WAAW,2BAA2B;IAC1C,+BAA+B;IAC/B,OAAO,EAAE,YAAY,CAAC;IAEtB,uDAAuD;IACvD,YAAY,EAAE,kBAAkB,CAAC;IAEjC,gCAAgC;IAChC,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,+BAA+B;AAC/B,MAAM,WAAW,2BAA2B;IAC1C,+BAA+B;IAC/B,OAAO,EAAE,YAAY,CAAC;IAEtB,uDAAuD;IACvD,YAAY,EAAE,kBAAkB,CAAC;IAEjC,gCAAgC;IAChC,KAAK,EAAE,eAAe,CAAC;CACxB"}
+{"version":3,"file":"PluginTool.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginTool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,sCAAsC;AACtC,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,WAAW,EAAE,IAAI,CAAC;IAElB,iDAAiD;IACjD,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,+BAA+B;AAC/B,MAAM,WAAW,2BAA2B;IAC1C,+BAA+B;IAC/B,OAAO,EAAE,YAAY,CAAC;IAEtB,uDAAuD;IACvD,YAAY,EAAE,kBAAkB,CAAC;IAEjC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,+BAA+B;AAC/B,MAAM,WAAW,2BAA2B;IAC1C,+BAA+B;IAC/B,OAAO,EAAE,YAAY,CAAC;IAEtB,uDAAuD;IACvD,YAAY,EAAE,kBAAkB,CAAC;IAEjC,gCAAgC;IAChC,KAAK,EAAE,eAAe,CAAC;CACxB"}

package/bin/types/rpc/RpcProtocol.d.ts

@@ -6,12 +6,12 @@
  * - Client 与 Server 共享同一份 request/frame 类型，避免协议两边漂移。
  * - 字段名保持现有协议格式，兼容已发布的 downcity 托管 runtime 调用。
  */
-import type { AgentCreateSessionInput, AgentListSessionsInput, AgentArchiveSessionsInput, AgentSessionSetOptions, RemoteSessionSetInput, AgentSessionSystemSnapshot } from "../../types/agent/SessionTypes.js";
-import type { SessionMutation } from "../../types/session/SessionMutation.js";
-import type { RespondSessionInteractionInput } from "../../types/session/SessionInteraction.js";
-import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
-import type { ListSessionMessagesInput } from "../../types/session/SessionMessage.js";
-import type { JsonValue } from "../../types/common/Json.js";
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentArchiveSessionsInput, AgentSessionSetOptions, RemoteSessionSetInput, AgentSessionSystemSnapshot } from "../agent/SessionTypes.js";
+import type { SessionMutation } from "../session/SessionMutation.js";
+import type { RespondSessionInteractionInput } from "../session/SessionInteraction.js";
+import type { AgentSessionPromptInput } from "../sdk/AgentSessionPrompt.js";
+import type { ListSessionMessagesInput } from "../session/SessionMessage.js";
+import type { JsonValue } from "../common/Json.js";
 /**
  * RPC 请求。
  *
@@ -19,7 +19,7 @@ import type { JsonValue } from "../../types/common/Json.js";
  * - `sdk.*` 面向 RemoteAgent 的稳定会话 SDK。
  * - `internal.*` 面向 downcity 本机管理通道。
  */
-export type RpcRequest = {
+type RpcRequestPayload = {
     /** 请求 id，用于匹配响应。 */
     id: string;
     /** 列出 sessions。 */
@@ -169,6 +169,8 @@ export type RpcRequest = {
         session_id: string;
         /** 可选源消息 id。 */
         message_id?: string;
+        /** 是否包含源消息；默认包含。 */
+        include_message?: boolean;
     };
 } | {
     /** 请求 id，用于匹配响应。 */
@@ -265,6 +267,19 @@ export type RpcRequest = {
         payload?: JsonValue;
     };
 };
+/**
+ * RPC 请求。
+ *
+ * `agent_id` 与 `workspace_id` 由 `RemoteAgent(rpc://host:port/<agent_id>/<workspace_id>)`
+ * 自动附加，供 City 级
+ * RPC Server 在同一端口内选择 Agent。独立 `AgentRPC` 不要求该字段。
+ */
+export type RpcRequest = RpcRequestPayload & {
+    /** 目标 Agent 的稳定 ID；CityRPC 请求必须提供。 */
+    agent_id?: string;
+    /** 目标 Workspace 的稳定 ID；CityRPC 请求必须提供。 */
+    workspace_id?: string;
+};
 /**
  * RPC 成功响应帧。
  */
@@ -327,6 +342,10 @@ export interface RpcClientEndpoint {
     host: string;
     /** RPC port。 */
     port: number;
+    /** City RPC 中的目标 Agent ID；独立 AgentRPC 可省略。 */
+    agent_id?: string;
+    /** City RPC 中的目标 Workspace ID；独立 AgentRPC 可省略。 */
+    workspace_id?: string;
 }
 /** Agent 本机 internal.status.get 返回的进程身份。 */
 export interface RpcInternalStatus {
@@ -336,7 +355,9 @@ export interface RpcInternalStatus {
     pid: number;
     /** 当前 Agent 的稳定全局 ID。 */
     agent_id: string;
-    /** 当前 Agent 绑定的 Workspace 绝对路径。 */
+    /** 当前执行使用的 Workspace 稳定 ID。 */
+    workspace_id: string;
+    /** 当前请求执行所在的 Workspace 绝对路径。 */
     workspace_path: string;
     /** daemon 启动实例 ID；非 daemon 前台进程返回空字符串。 */
     instance_id: string;
@@ -392,4 +413,5 @@ export interface RpcSessionSystemResult {
     /** system snapshot。 */
     system: AgentSessionSystemSnapshot;
 }
+export {};
 //# sourceMappingURL=RpcProtocol.d.ts.map

package/bin/types/rpc/RpcProtocol.d.ts.map

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

package/bin/types/sdk/AgentSessionAction.d.ts

@@ -2,23 +2,22 @@
  * Agent Session action 公开类型。
  *
  * 关键点（中文）
- * - action 是 session records 中的 `type: "action"` 记录。
- * - 同一份结构同时用于 JSONL 持久化与 `session.subscribe()` 实时事件。
- * - action 不进入 LLM 输入；组装模型消息前必须过滤。
+ * - Action 运行事件由 Session 收口为 canonical `SessionActionMessage`。
+ * - Action 不进入模型输入。
  */
-import type { SessionActionRecordV1, SessionActionStateV1 } from "../../executor/types/SessionRecords.js";
+import type { SessionActionEvent, SessionActionStatus } from "../session/SessionAction.js";
 /**
  * Session action 当前状态。
  */
-export type AgentSessionActionState = SessionActionStateV1;
+export type AgentSessionActionState = SessionActionStatus;
 /**
  * Session action 记录。
  */
-export type AgentSessionActionRecord = SessionActionRecordV1;
+export type AgentSessionActionRecord = SessionActionEvent;
 /**
  * Session action 订阅事件。
  */
-export type AgentSessionActionEvent = SessionActionRecordV1;
+export type AgentSessionActionEvent = SessionActionEvent;
 /**
  * Session action 发布回调。
  */

package/bin/types/sdk/AgentSessionAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionAction.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionAction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"AgentSessionAction.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionAction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/bin/types/sdk/AgentSessionAction.js

@@ -2,9 +2,8 @@
  * Agent Session action 公开类型。
  *
  * 关键点（中文）
- * - action 是 session records 中的 `type: "action"` 记录。
- * - 同一份结构同时用于 JSONL 持久化与 `session.subscribe()` 实时事件。
- * - action 不进入 LLM 输入；组装模型消息前必须过滤。
+ * - Action 运行事件由 Session 收口为 canonical `SessionActionMessage`。
+ * - Action 不进入模型输入。
  */
 export {};
 //# sourceMappingURL=AgentSessionAction.js.map

package/bin/types/sdk/AgentSessionAction.js.map

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

package/bin/types/sdk/AgentSessionPrompt.d.ts

@@ -5,15 +5,15 @@
  * - `prompt()` 是 Session actor 模型下唯一的输入入口。
  * - 首条输入、运行中补充输入、排队到下一轮的输入，调用侧都使用同一结构。
  */
-import type { UIDataTypes, UITools, UIMessagePart } from "ai";
+import type { SessionPromptPart } from "../session/SessionContent.js";
 /**
  * Session user message part 类型。
  *
  * 说明（中文）
- * - 与 AI SDK 标准 `UIMessagePart` 等价，但已固定泛型参数，避免调用侧引入 `ai` 包。
+ * - 这是 Downcity Session 输入边界，不依赖模型协议或第三方 SDK。
  * - 可直接用于 `session.prompt({ query: [...parts] })` 传入 text parts、file parts 等。
  */
-export type SessionUserMessagePart = UIMessagePart<UIDataTypes, UITools>;
+export type SessionUserMessagePart = SessionPromptPart;
 /**
  * Session prompt 输入。
  *
@@ -24,7 +24,7 @@ export type SessionUserMessagePart = UIMessagePart<UIDataTypes, UITools>;
  *     { type: "text", text: "请分析这个附件" },
  *     {
  *       type: "file",
- *       mediaType: "image/png",
+ *       media_type: "image/png",
  *       url: "data:image/png;base64,...",
  *       filename: "image.png",
  *     },
@@ -36,7 +36,7 @@ export type SessionUserMessagePart = UIMessagePart<UIDataTypes, UITools>;
  * - `string` 会直接成为新的文本 User Message。
  * - `file` part 如果携带 Data URL，会在 Message 入库前解码到 Session 的 attachments 目录。
  * - 持久化 Message 里的 `url` 变成相对 Workspace 根目录的文件路径，而不是 Base64 内容。
- * - 模型执行前，Executor 再按该路径读取文件，并转换成 AI SDK / Provider 可消费的 ModelMessage。
+ * - 模型执行前，Executor 再按该路径读取文件，并转换成 Downcity `ModelMessage`。
  * - 远程 Session 中，Data URL 在服务端落盘；调用方本地路径必须对服务端可访问。
  */
 export interface AgentSessionPromptInput {
@@ -45,8 +45,8 @@ export interface AgentSessionPromptInput {
      *
      * 说明（中文）
      * - 支持两种格式：
-     *   1. `string`：纯文本用户输入，Session 会将其包装为 `role="user"` 的 UIMessage。
-     *   2. `SessionUserMessagePart[]`：AI SDK 标准 user message parts 数组，可直接携带 text parts、file parts 等。
+     *   1. `string`：纯文本用户输入，Session 会将其包装为用户消息。
+     *   2. `SessionUserMessagePart[]`：Downcity Session user parts，可直接携带 text、file 等内容。
      * - 调用侧永远只传"新的用户输入"。
      * - 它是否并入当前 turn，还是排到下一 turn，由 Session 内部决定。
      */

package/bin/types/sdk/AgentSessionPrompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionPrompt.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;OASG;IACH,KAAK,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAkB3F"}
+{"version":3,"file":"AgentSessionPrompt.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;OASG;IACH,KAAK,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAe3F"}

package/bin/types/sdk/AgentSessionPrompt.js

@@ -23,10 +23,7 @@ export function is_agent_session_prompt_input_empty(input) {
         }
         // 如果所有 parts 都是空文本，也视为空
         return query.every((part) => {
-            if (part && typeof part === "object" && "type" in part && part.type === "text") {
-                return String(part.text ?? "").trim() === "";
-            }
-            return false; // 非文本 part（如 file）不算空
+            return part.type === "text" && part.text.trim() === "";
         });
     }
     return true;

package/bin/types/sdk/AgentSessionPrompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionPrompt.js","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoDH;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC,CAAC,KAA8B;IAChF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,wBAAwB;QACxB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC/E,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YAC/C,CAAC;YACD,OAAO,KAAK,CAAC,CAAC,sBAAsB;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"AgentSessionPrompt.js","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoDH;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC,CAAC,KAA8B;IAChF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,wBAAwB;QACxB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1B,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Session Action 运行事件协议。
+ *
+ * Action 事件描述尚未持久化或正在更新的领域事实；`SessionMessages` 负责把它收口为
+ * canonical `SessionActionMessage`。该协议不属于模型消息。
+ */
+/** Session Action 生命周期状态。 */
+export type SessionActionStatus = "running" | "completed" | "failed";
+/** Session Action 运行事件。 */
+export interface SessionActionEvent {
+    /** 同一 Action 生命周期内稳定复用的标识。 */
+    action_id: string;
+    /** Action 的业务类别。 */
+    action_type: string;
+    /** Action 所属 Turn；独立 Session 操作允许省略。 */
+    turn_id?: string;
+    /** Action 的用户可读标题。 */
+    title: string;
+    /** Action 的可选用户可读说明。 */
+    description?: string;
+    /** Action 当前生命周期状态。 */
+    status: SessionActionStatus;
+}
+/** 创建 Session Action 事件的输入。 */
+export interface SessionActionEventInput {
+    /** 可选稳定标识；省略时由 Session 分配。 */
+    action_id?: string;
+    /** Action 的业务类别。 */
+    action_type: string;
+    /** Action 所属 Turn；独立 Session 操作允许省略。 */
+    turn_id?: string;
+    /** Action 的用户可读标题。 */
+    title: string;
+    /** Action 的可选用户可读说明。 */
+    description?: string;
+    /** Action 当前生命周期状态。 */
+    status: SessionActionStatus;
+}
+//# sourceMappingURL=SessionAction.d.ts.map