@downcity/agent 1.1.338 → 1.1.400

package/bin/types/agent/AgentSessionCollection.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Agent 面向 SDK 用户的 Session 集合类型。
+ *
+ * Session 归 Agent 所有；Workspace 只在创建时声明本次执行使用的资源环境。
+ */
+import type { WorkspaceBase } from "@downcity/workspace";
+import type { SessionOrigin } from "../session/SessionOrigin.js";
+import type { AgentSession } from "./SessionActor.js";
+import type { AgentCreateSessionInput } from "./SessionTypes.js";
+import type { SessionPort } from "../session/SessionPort.js";
+import type { AgentArchiveSessionInput, AgentArchiveSessionResult, AgentArchiveSessionsInput, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionSummaryPage } from "./SessionTypes.js";
+/** 创建 Agent Session 的公开参数。 */
+export interface AgentCreateSessionOptions extends AgentCreateSessionInput {
+    /** 本次 Session 可选使用的 Workspace 资源；未传入时使用内存执行上下文。 */
+    workspace?: WorkspaceBase;
+    /** 当前 Session 的创建来源；未填写时视为用户直接创建。 */
+    origin?: SessionOrigin;
+}
+/** Agent 公开的 Session 创建入口。 */
+export interface AgentSessionCollection {
+    /** 在指定 Workspace 中创建一个属于当前 Agent 的 Session。 */
+    create(options?: AgentCreateSessionOptions): Promise<AgentSession>;
+    /** 在指定 Workspace 中恢复一个已经属于当前 Agent 的 Session。 */
+    get(session_id: string, options?: AgentCreateSessionOptions): Promise<AgentSession>;
+    /** 列出当前 Agent 的活动 Session。 */
+    list(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+    /** 归档一个 Session。 */
+    archive(input: AgentArchiveSessionInput): Promise<AgentArchiveSessionResult>;
+    /** 列出已归档 Session。 */
+    archived(input?: AgentArchiveSessionsInput): Promise<AgentArchiveSessionsResult>;
+    /** 清空已归档 Session。 */
+    clean_archive(): Promise<AgentCleanArchiveResult>;
+    /** 获取 Session runtime port。 */
+    runtime(session_id: string): SessionPort;
+    /** 返回当前 Agent 正在执行的 Session 标识。 */
+    list_executing_session_ids(): string[];
+    /** 永久删除 Session。 */
+    remove(session_id: string): Promise<boolean>;
+    /** 清空 Session 消息。 */
+    clear_messages(session_id: string): Promise<boolean>;
+}
+//# sourceMappingURL=AgentSessionCollection.d.ts.map

package/bin/types/agent/AgentSessionCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSessionCollection.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentSessionCollection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,8BAA8B;AAC9B,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,mDAAmD;IACnD,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,qCAAqC;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,8BAA8B;AAC9B,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,MAAM,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEnE,iDAAiD;IACjD,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEpF,8BAA8B;IAC9B,IAAI,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEvE,oBAAoB;IACpB,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAE7E,qBAAqB;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEjF,qBAAqB;IACrB,aAAa,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAElD,+BAA+B;IAC/B,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;IAEzC,mCAAmC;IACnC,0BAA0B,IAAI,MAAM,EAAE,CAAC;IAEvC,oBAAoB;IACpB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7C,qBAAqB;IACrB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtD"}

package/bin/types/agent/AgentSessionCollection.js

@@ -0,0 +1,7 @@
+/**
+ * Agent 面向 SDK 用户的 Session 集合类型。
+ *
+ * Session 归 Agent 所有；Workspace 只在创建时声明本次执行使用的资源环境。
+ */
+export {};
+//# sourceMappingURL=AgentSessionCollection.js.map

package/bin/types/agent/AgentSessionCollection.js.map

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

package/bin/types/agent/AgentStorage.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Agent 级持久化存储。
+ *
+ * Agent 在 City 中使用持久化文件系统；未加入 City 时使用进程内文件系统。
+ * Workspace 只提供执行上下文，不拥有这份存储。
+ */
+import type { SessionStore } from "../store/SessionStore.js";
+import type { FileSystem } from "@downcity/workspace";
+/** Agent 持有的 Session、日志与调度共享存储。 */
+export interface AgentStorage {
+    /** Agent 内部数据的稳定根路径。 */
+    root_path: string;
+    /** 受当前 Agent 根路径约束的文件能力。 */
+    files: FileSystem;
+    /** 当前 Agent 的 Session 集合存储。 */
+    sessions: SessionStore;
+}
+//# sourceMappingURL=AgentStorage.d.ts.map

package/bin/types/agent/AgentStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentStorage.d.ts","sourceRoot":"","sources":["../../../src/types/agent/AgentStorage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,YAAY,CAAC;CACxB"}

package/bin/types/agent/AgentStorage.js

@@ -0,0 +1,8 @@
+/**
+ * Agent 级持久化存储。
+ *
+ * Agent 在 City 中使用持久化文件系统；未加入 City 时使用进程内文件系统。
+ * Workspace 只提供执行上下文，不拥有这份存储。
+ */
+export {};
+//# sourceMappingURL=AgentStorage.js.map

package/bin/types/agent/AgentStorage.js.map

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

package/bin/types/agent/RemoteAgentOptions.d.ts

@@ -13,7 +13,7 @@ export interface RemoteAgentOptions {
      * 远程 agent 访问地址。
      *
      * 例如：`https://city.example.com/agents/lucas`、`http://127.0.0.1:5314/agents/lucas`
-     * 或 `rpc://127.0.0.1:15314`
+     * 或 `rpc://127.0.0.1:15314/lucas`
      */
     url: string;
     /**

package/bin/types/agent/RemoteAgentPluginAction.d.ts

@@ -5,8 +5,8 @@
  * - RemoteAgent 是远程 runtime 的瘦客户端，因此这里只描述远程调用协议。
  * - 业务 action 的具体 payload 与 data 由目标 plugin 自己定义。
  */
-import type { JsonValue } from "../../types/common/Json.js";
-import type { PluginActionResult } from "../../types/plugin/PluginAction.js";
+import type { JsonValue } from "../common/Json.js";
+import type { PluginActionResult } from "../plugin/PluginAction.js";
 /**
  * RemoteAgent 远程 plugin action 调用输入。
  */

package/bin/types/agent/SessionActor.d.ts

@@ -5,14 +5,15 @@
  * - 这里只描述 session 的可调用能力。
  * - session 的数据结构、history/system payload 放在 `SessionTypes.ts`。
  */
-import type { AgentCreateSessionInput, AgentArchiveSessionInput, AgentArchiveSessionsInput, AgentArchiveSessionResult, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionInfo, AgentSessionSetInput, AgentSessionSetOptions, AgentSessionStatus, AgentSessionSummaryPage, AgentSessionSystemSnapshot, RemoteSessionSetInput } from "../../types/agent/SessionTypes.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 { 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 { AgentCreateSessionInput, AgentArchiveSessionInput, AgentArchiveSessionsInput, AgentArchiveSessionResult, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentListSessionsInput, AgentSessionConfigSnapshot, AgentSessionForkInput, AgentSessionInfo, AgentSessionSetInput, AgentSessionSetOptions, AgentSessionStatus, AgentSessionSummaryPage, AgentSessionSystemSnapshot, RemoteSessionSetInput } from "./SessionTypes.js";
+import type { SessionMutationSubscriber, SessionMutationUnsubscribe } from "../session/SessionMutation.js";
+import type { RespondSessionInteractionInput, SessionInteractionResult, SessionPendingInteraction } from "../session/SessionInteraction.js";
+import type { ListSessionMessagesInput, SessionMessagePage } from "../session/SessionMessage.js";
+import type { AgentSessionPromptInput } from "../sdk/AgentSessionPrompt.js";
+import type { AgentSessionStopResult } from "../sdk/AgentSessionStop.js";
+import type { AgentSessionCompactHandle } from "../sdk/AgentSessionCompact.js";
+import type { AgentSessionTurnHandle } from "../sdk/AgentSessionTurn.js";
+import type { SessionOrigin } from "../session/SessionOrigin.js";
 /**
  * SDK Session 集合入口。
  */
@@ -36,6 +37,10 @@ export interface AgentSessions<TSession extends AgentSessionActor = AgentSession
 export interface AgentSessionActor {
     /** 当前 session 稳定标识。 */
     readonly id: string;
+    /** 当前 Session 创建时绑定的 Workspace ID；无 Workspace 时为空。 */
+    readonly workspace_id?: string;
+    /** 当前 Session 的创建来源。 */
+    readonly origin?: SessionOrigin;
     /** 读取当前 session 详情。 */
     get_info(): Promise<AgentSessionInfo>;
     /** 追加一条新的 prompt。 */
@@ -73,6 +78,8 @@ export interface AgentSession extends AgentSessionActor {
     readonly config: AgentSessionConfigSnapshot;
     /** 写入当前 session 默认配置。 */
     set(input: AgentSessionSetInput, options?: AgentSessionSetOptions): Promise<void>;
+    /** 修改当前 Session 的用户可见标题并发布 canonical mutation。 */
+    rename(title: string): Promise<string>;
     /** 把当前 Session 首次生成后固定的完整 system 显式固化到 instruction.md。 */
     snapshot(): Promise<void>;
     /** 使用 Agent 当前 instruction 与 plugin 显式重新生成 Session system。 */

package/bin/types/agent/SessionActor.d.ts.map

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

package/bin/types/agent/SessionTypes.d.ts

@@ -6,25 +6,29 @@
  * - session actor 方法接口拆到 `SessionActor.ts`。
  */
 import type { AgentModel } from "../../agent/AgentModel.js";
-import type { SessionApprovalMode } from "../../types/session/SessionInteraction.js";
+import type { SessionApprovalMode } from "../session/SessionInteraction.js";
+import type { SessionOrigin } from "../session/SessionOrigin.js";
 /**
- * 新建 session 的输入参数。
+ * 新建 Session 的输入参数。
+ *
+ * Session ID 由 AgentSessions 在创建时生成，调用方只能在恢复时通过
+ * `sessions.get(session_id)` 指定已有 ID。
  */
 export interface AgentCreateSessionInput {
-    /**
-     * 可选显式 session_id。
-     *
-     * 关键点（中文）
-     * - 传入时表达“创建意图”。
-     * - 若该 session 已存在，SDK 应直接报错，而不是静默复用。
-     * - 省略时由 SDK 自动生成稳定且不可推导的 session_id。
-     */
-    session_id?: string;
+    /** 保持创建输入为无配置字段的协议对象。 */
+    readonly __create_session_input?: never;
 }
 /**
  * Session 列表查询输入。
  */
 export interface AgentListSessionsInput {
+    /**
+     * 只返回绑定到指定 Workspace 的 Session。
+     *
+     * 省略时查询当前 Agent 的全部 Session；传入时没有 Workspace metadata 的
+     * 历史 Session 不会匹配任何 Workspace。
+     */
+    workspace_id?: string;
     /**
      * 当前页返回上限。
      *
@@ -295,6 +299,8 @@ export interface AgentSessionSummary {
     message_count: number;
     /** 当前 session 绑定模型的可读标签。 */
     model_label?: string;
+    /** 当前 Session 的创建来源。 */
+    origin?: SessionOrigin;
     /** 当前 session 是否处于执行中。 */
     executing?: boolean;
 }
@@ -336,6 +342,12 @@ export interface AgentSessionForkInput {
      * - 传入时复制到该消息为止（包含该消息）。
      */
     message_id?: string;
+    /**
+     * 是否将 `message_id` 指向的锚点消息复制到新 Session。
+     *
+     * 省略时默认为 `true`；编辑并重新发送历史消息时传入 `false`，避免新旧消息同时出现。
+     */
+    include_message?: boolean;
 }
 /**
  * 归档单个 session 的输入参数。
@@ -354,6 +366,13 @@ export interface AgentArchiveSessionInput {
  * 列出已归档 session 的输入参数。
  */
 export interface AgentArchiveSessionsInput {
+    /**
+     * 只返回绑定到指定 Workspace 的归档 Session。
+     *
+     * 省略时查询当前 Agent 的全部归档 Session；传入时没有 Workspace metadata
+     * 的历史 Session 不会匹配任何 Workspace。
+     */
+    workspace_id?: string;
     /**
      * 当前页返回上限。
      *

package/bin/types/agent/SessionTypes.d.ts.map

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

package/bin/types/agent/WorkspaceEntryOptions.d.ts

@@ -0,0 +1,16 @@
+/**
+ * WorkspaceEntry 装配参数。
+ *
+ * WorkspaceEntry 只表达 Agent 已进入某个 Workspace，不拥有 Agent 身份或 Plugin
+ * 定义。Workspace 资源的生命周期在离开时由该作用域统一关闭。
+ */
+import type { Agent } from "../../agent/Agent.js";
+import type { WorkspaceBase } from "@downcity/workspace";
+/** Agent 进入 Workspace 时使用的内部装配参数。 */
+export interface WorkspaceEntryOptions {
+    /** 拥有当前作用域的 Agent。 */
+    agent: Agent;
+    /** 当前进入的项目资源容器。 */
+    workspace: WorkspaceBase;
+}
+//# sourceMappingURL=WorkspaceEntryOptions.d.ts.map

package/bin/types/agent/WorkspaceEntryOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceEntryOptions.d.ts","sourceRoot":"","sources":["../../../src/types/agent/WorkspaceEntryOptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qCAAqC;AACrC,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,KAAK,EAAE,KAAK,CAAC;IAEb,mBAAmB;IACnB,SAAS,EAAE,aAAa,CAAC;CAC1B"}

package/bin/types/agent/WorkspaceEntryOptions.js

@@ -0,0 +1,8 @@
+/**
+ * WorkspaceEntry 装配参数。
+ *
+ * WorkspaceEntry 只表达 Agent 已进入某个 Workspace，不拥有 Agent 身份或 Plugin
+ * 定义。Workspace 资源的生命周期在离开时由该作用域统一关闭。
+ */
+export {};
+//# sourceMappingURL=WorkspaceEntryOptions.js.map

package/bin/types/agent/WorkspaceEntryOptions.js.map

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

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

@@ -1,28 +1,30 @@
 /**
- * Executor 到 Session canonical Message 的 Assistant 输出端口。
+ * Executor 到 canonical Session Assistant Message 的输出端口。
  *
- * 该端口集中隔离 AI SDK 流协议。SessionLoop 只装配端口，不解析 Chunk，具体转换
- * 由 execution Adapter 完成，SessionMessages 仍是唯一 Assistant Message 事实源。
+ * 该端口直接消费 Downcity Model Protocol 事件，不定义或转发 UI-shaped chunk。
  */
-import type { UIMessage, UIMessageChunk } from "ai";
-import type { SessionMessageRecordV1 } from "../../executor/types/SessionRecords.js";
-import type { SessionToolInputReady } from "../../types/session/SessionTool.js";
-/** 单次 Turn 的 Assistant 输出写入端口。 */
+import type { ModelStreamEvent } from "@downcity/type";
+import type { SessionAssistantResultPart } from "../session/SessionContent.js";
+import type { SessionAssistantMessagePart } from "../session/SessionMessage.js";
+import type { SessionToolExecutionResult, SessionToolInputReady } from "../session/SessionTool.js";
+/** Executor 写入当前 Turn Assistant Message 的稳定能力。 */
 export interface SessionAssistantOutput {
-    /** 开始一个 Provider Step 的独立 Part 作用域。 */
+    /** 开始一个模型 Step 的独立 Part 作用域。 */
     begin_step(): Promise<void>;
-    /** 写入一个 AI SDK 流式 Chunk。 */
-    write_chunk(chunk: UIMessageChunk): Promise<void>;
-    /** 使用 Provider 最终快照校验并补齐当前 Step metadata。 */
-    finish_step(message: SessionMessageRecordV1): Promise<void>;
+    /** 直接写入单个标准模型流事件。 */
+    write_model_event(event: ModelStreamEvent): Promise<void>;
+    /** 在 Tool 审批或执行前提交完整输入。 */
+    prepare_tool_input(input: SessionToolInputReady): Promise<void>;
+    /** 写入 Tool 执行终态。 */
+    write_tool_result(result: SessionToolExecutionResult): Promise<void>;
+    /** 使用模型流聚合出的 canonical Parts 校验当前 Step。 */
+    finish_step(parts: SessionAssistantMessagePart[]): Promise<void>;
     /** 放弃当前未完成 Step 的临时作用域。 */
     abort_step(): Promise<void>;
-    /** 在 Tool 实现执行前提交完整输入。 */
-    prepare_tool_input(input: SessionToolInputReady): Promise<void>;
-    /** User steer 已插入会话后，关闭它之前的当前 Assistant Message。 */
+    /** User steer 插入前关闭当前连续 Assistant Message。 */
     close_current_message(): Promise<void>;
-    /** 把 Action 产生的完整 Parts 追加到当前 canonical Assistant Message。 */
-    append_parts(parts: UIMessage["parts"]): Promise<void>;
+    /** 把 Action 产生的封闭内容追加到当前 Assistant Message。 */
+    append_result_parts(parts: readonly SessionAssistantResultPart[]): Promise<void>;
     /** 按 Turn 最终结果收口 Assistant 输出。 */
     finish(input: {
         /** Assistant 最终状态。 */

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

@@ -1 +1 @@
-{"version":3,"file":"SessionAssistantOutput.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionAssistantOutput.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,kCAAkC;AAClC,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,4BAA4B;IAC5B,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,6CAA6C;IAC7C,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,2BAA2B;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,0BAA0B;IAC1B,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,oDAAoD;IACpD,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,8DAA8D;IAC9D,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,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"}
+{"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,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACrF,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,2BAA2B,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,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,0BAA0B,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,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

@@ -1,8 +1,7 @@
 /**
- * Executor 到 Session canonical Message 的 Assistant 输出端口。
+ * Executor 到 canonical Session Assistant Message 的输出端口。
  *
- * 该端口集中隔离 AI SDK 流协议。SessionLoop 只装配端口，不解析 Chunk，具体转换
- * 由 execution Adapter 完成，SessionMessages 仍是唯一 Assistant Message 事实源。
+ * 该端口直接消费 Downcity Model Protocol 事件，不定义或转发 UI-shaped chunk。
  */
 export {};
 //# sourceMappingURL=SessionAssistantOutput.js.map

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"SessionToolExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionToolExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8BAA8B;IAC9B,iBAAiB,EAAE,mBAAmB,CAAC;IACvC,oCAAoC;IACpC,oBAAoB,EAAE,kBAAkB,CAAC;CAC1C"}
+{"version":3,"file":"SessionToolExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionToolExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,iDAAiD,CAAC;AACzD,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

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

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

@@ -6,14 +6,14 @@
  * - 分区用于表达领域职责，不引入多套彼此独立的 Context。
  * - 可变状态只能通过行为方法更新，消费者不能直接操作内部数组、lease 或 callback。
  */
-import type { UIMessage } from "ai";
-import type { ShellApprovalGateway } from "@downcity/shell";
-import type { SessionUserMessageV1 } from "../../executor/types/SessionRecords.js";
-import type { SessionAssistantOutput } from "../../types/executor/SessionAssistantOutput.js";
-import type { AgentPluginExecutionLease } from "../../types/plugin/PluginRuntime.js";
-import type { PluginExecutionContext } from "../../types/plugin/PluginExecutionContext.js";
-import type { AgentSessionActionCallback, AgentSessionActionEvent, AgentSessionActionRecord } from "../../types/sdk/AgentSessionAction.js";
-import type { SessionInteractionPort } from "../../types/session/SessionInteraction.js";
+import type { ShellApprovalGateway } from "@downcity/workspace";
+import type { SessionUserMessage } from "../session/SessionMessage.js";
+import type { SessionAssistantResultPart } from "../session/SessionContent.js";
+import type { SessionAssistantOutput } from "./SessionAssistantOutput.js";
+import type { AgentPluginExecutionLease } from "../plugin/PluginRuntime.js";
+import type { PluginExecutionContext } from "../plugin/PluginExecutionContext.js";
+import type { AgentSessionActionCallback, AgentSessionActionEvent, AgentSessionActionRecord } from "../sdk/AgentSessionAction.js";
+import type { SessionInteractionPort } from "../session/SessionInteraction.js";
 /**
  * 创建一个 Session Turn 上下文所需的稳定输入。
  *
@@ -29,7 +29,7 @@ export interface SessionTurnContextInit {
     /** 上游取消信号；上下文会把它转发到自身拥有的运行生命周期。 */
     abort_signal?: AbortSignal;
     /** 在 Step 检查点消费 Session 队列，并返回应并入模型上下文的 User 消息。 */
-    merge_step_input?: () => Promise<SessionUserMessageV1[]>;
+    merge_step_input?: () => Promise<SessionUserMessage[]>;
     /** 判断是否仍有等待下一个 Step 消费的 User prompt。 */
     has_pending_step_input?: () => boolean;
     /** 消费一次 canonical history 重载请求。 */
@@ -85,20 +85,20 @@ export interface SessionTurnContext {
         /** 释放当前 Step 持有的 Plugin lease。 */
         release(): Promise<void>;
         /** 为 Plugin 生成只包含稳定、只读运行快照的新对象。 */
-        plugin_execution_context(): PluginExecutionContext;
+        plugin_execution_context(call_id?: string): PluginExecutionContext;
     };
     /** 当前运行的动态 User 输入及延迟持久化输入。 */
     readonly input: {
         /** 在 Step 边界消费运行期注入消息与 Session 队列消息。 */
-        checkpoint(): Promise<SessionUserMessageV1[]>;
+        checkpoint(): Promise<SessionUserMessage[]>;
         /** 判断是否有等待下一个 Step 消费的 Session prompt。 */
         has_pending(): boolean;
         /** 注入一条只影响当前运行、在下一 Step 生效的 User 消息。 */
-        inject_user_message(message: SessionUserMessageV1): void;
+        inject_user_message(message: SessionUserMessage): void;
         /** 延迟到 Assistant 结果落盘后再持久化一条 User 消息。 */
-        defer_user_message(message: SessionUserMessageV1): void;
+        defer_user_message(message: SessionUserMessage): void;
         /** 返回延迟持久化 User 消息的不可变快照。 */
-        deferred_user_messages(): readonly SessionUserMessageV1[];
+        deferred_user_messages(): readonly SessionUserMessage[];
         /** 消费一次 canonical history 重载请求。 */
         consume_history_reload(): boolean;
     };
@@ -107,9 +107,9 @@ export interface SessionTurnContext {
         /** canonical Assistant Message 的唯一写入端口。 */
         readonly assistant?: SessionAssistantOutput;
         /** 把 Action 产生的 Assistant Parts 加入当前 Step 收口队列。 */
-        enqueue_assistant_parts(parts: readonly UIMessage["parts"][number][]): void;
+        enqueue_assistant_parts(parts: readonly SessionAssistantResultPart[]): void;
         /** 消费当前 Step 中等待写入 canonical Assistant Message 的 Parts。 */
-        take_assistant_parts(): UIMessage["parts"];
+        take_assistant_parts(): SessionAssistantResultPart[];
         /** 发布一条不进入 LLM 输入的 Session Action。 */
         publish_action(event: AgentSessionActionEvent): Promise<void>;
     };

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

@@ -1 +1 @@
-{"version":3,"file":"SessionTurnContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionTurnContext.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SessionTurnContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionTurnContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IAEnB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,mCAAmC;IACnC,YAAY,CAAC,EAAE,WAAW,CAAC;IAE3B,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEvD,wCAAwC;IACxC,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC;IAEvC,mCAAmC;IACnC,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC;IAEvC,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAE1C,iCAAiC;IACjC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IAEtC,8CAA8C;IAC9C,sBAAsB,CAAC,EAAE,oBAAoB,CAAC;IAE9C,wCAAwC;IACxC,cAAc,CAAC,EAAE,0BAA0B,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE;QAChB,0BAA0B;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAE5B,uBAAuB;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAEzB,yBAAyB;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;IAEF,sBAAsB;IACtB,QAAQ,CAAC,SAAS,EAAE;QAClB,+BAA+B;QAC/B,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;QAEnC,yBAAyB;QACzB,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAE9B,oCAAoC;QACpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1B,CAAC;IAEF,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE;QACb,uCAAuC;QACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAE1D,2CAA2C;QAC3C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;QAE1C,qDAAqD;QACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,CAAC;QAE7C,4CAA4C;QAC5C,MAAM,CAAC,KAAK,EAAE;YACZ,oCAAoC;YACpC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAEhD,wCAAwC;YACxC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;SAClC,GAAG,IAAI,CAAC;QAET,8CAA8C;QAC9C,eAAe,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAEpE,kCAAkC;QAClC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAEzB,mCAAmC;QACnC,wBAAwB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;KACpE,CAAC;IAEF,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE;QACd,wCAAwC;QACxC,UAAU,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAE5C,0CAA0C;QAC1C,WAAW,IAAI,OAAO,CAAC;QAEvB,wCAAwC;QACxC,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;QAEvD,yCAAyC;QACzC,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;QAEtD,6BAA6B;QAC7B,sBAAsB,IAAI,SAAS,kBAAkB,EAAE,CAAC;QAExD,mCAAmC;QACnC,sBAAsB,IAAI,OAAO,CAAC;KACnC,CAAC;IAEF,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE;QACf,2CAA2C;QAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,CAAC;QAE5C,mDAAmD;QACnD,uBAAuB,CAAC,KAAK,EAAE,SAAS,0BAA0B,EAAE,GAAG,IAAI,CAAC;QAE5E,2DAA2D;QAC3D,oBAAoB,IAAI,0BAA0B,EAAE,CAAC;QAErD,sCAAsC;QACtC,cAAc,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/D,CAAC;IAEF,iCAAiC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IAE/C,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE;QACd,wCAAwC;QACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;KAClD,CAAC;CACH;AAED,YAAY,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,GACzB,CAAC"}

package/bin/types/group/DispatchStrategy.d.ts

@@ -0,0 +1,62 @@
+/** Group 调度策略：为当前消息上下文生成一组有依赖关系的成员投递节点。 */
+import type { GroupMessage } from "./Group.js";
+import type { Agent } from "../../agent/Agent.js";
+import type { AgentModel } from "../../agent/AgentModel.js";
+/** 一个投递节点内成员的发言方式。 */
+export type DispatchResponseMode = "single" | "parallel";
+/** 本次调度的触发来源。 */
+export type DispatchTrigger = "user" | "auto";
+/** 调度图中的一个成员投递节点。 */
+export interface DispatchNode {
+    /** 当前调度图内的稳定节点标识。 */
+    readonly node_id: string;
+    /** 当前节点允许接收消息的成员标识。 */
+    readonly member_ids: readonly string[];
+    /** 当前节点只运行首个成员，还是允许全部成员并行运行。 */
+    readonly response_mode: DispatchResponseMode;
+    /** 当前节点依赖的前置节点标识；依赖完成后才能投递。 */
+    readonly depends_on_node_ids: readonly string[];
+    /** 注入成员 AgentSession 的发言约束。 */
+    readonly instruction: string;
+}
+/** 一次调度生成的当前最佳响应图。 */
+export interface DispatchDecision {
+    /** 当前调度图中的投递节点。 */
+    readonly nodes: readonly DispatchNode[];
+    /** 当前图完成后是否允许唯一的 GroupSession auto dispatch 继续判断。 */
+    readonly terminal: boolean;
+}
+/** Group 调度策略协议。 */
+export interface DispatchStrategy {
+    /** 根据触发来源、当前消息、历史和成员关系生成当前最佳响应图。 */
+    decide_dispatch(input: {
+        /** 本次调度由用户消息触发，还是由 GroupSession 自动收口触发。 */
+        readonly trigger: DispatchTrigger;
+        /** 当前待调度的 Group 消息；auto dispatch 时为本批新增消息中的最后一条。 */
+        readonly message: GroupMessage;
+        /** 当前 auto dispatch 尚未消费的新增消息。 */
+        readonly pending_messages: readonly GroupMessage[];
+        /** 当前 Group 已存在的消息历史。 */
+        readonly messages: readonly GroupMessage[];
+        /** 当前 Group 成员快照。 */
+        readonly members: readonly Agent[];
+    }): Promise<DispatchDecision> | DispatchDecision;
+}
+/** AI 调度策略的构造参数。 */
+export interface AiDispatchStrategyOptions {
+    /** Group 用于理解群聊意图并生成调度图的模型。 */
+    readonly model?: AgentModel;
+}
+/** 使用 Group.model 理解群聊意图并通过内部 tool call 生成成员投递决定。 */
+export declare class AiDispatchStrategy implements DispatchStrategy {
+    private readonly model?;
+    constructor(options?: AiDispatchStrategyOptions);
+    decide_dispatch(input: {
+        readonly trigger: DispatchTrigger;
+        readonly message: GroupMessage;
+        readonly pending_messages: readonly GroupMessage[];
+        readonly messages: readonly GroupMessage[];
+        readonly members: readonly Agent[];
+    }): Promise<DispatchDecision>;
+}
+//# sourceMappingURL=DispatchStrategy.d.ts.map

package/bin/types/group/DispatchStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DispatchStrategy.d.ts","sourceRoot":"","sources":["../../../src/types/group/DispatchStrategy.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxD,sBAAsB;AACtB,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzD,iBAAiB;AACjB,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,gCAAgC;IAChC,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,+BAA+B;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,sBAAsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,oBAAoB;AACpB,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,eAAe,CAAC,KAAK,EAAE;QACrB,2CAA2C;QAC3C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;QAClC,oDAAoD;QACpD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;QAC/B,kCAAkC;QAClC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;QACnD,yBAAyB;QACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;QAC3C,qBAAqB;QACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;KACpC,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;CAClD;AAED,oBAAoB;AACpB,MAAM,WAAW,yBAAyB;IACxC,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC7B;AASD,qDAAqD;AACrD,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAc;gBAEzB,OAAO,GAAE,yBAA8B;IAI7C,eAAe,CAAC,KAAK,EAAE;QAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;QAClC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;QAC/B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;QACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;QAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;KACpC,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA4B9B"}