@downcity/agent 1.1.408 → 1.1.437

package/bin/types/group/{GroupDispatchSession.d.ts → GroupDispatch.d.ts}

@@ -1,15 +1,14 @@
 /**
- * Group Dispatch Session 领域类型。
+ * GroupSession 内部调度协议。
  *
- * Dispatch Session 只记录群聊调度 Turn，不复制 GroupMessage 正文；消息正文仍由
- * GroupSession 的消息日志作为唯一事实源，调度记录通过消息 ID 建立稳定引用。
+ * 调度不是独立 Session，只是 GroupSession 根据共享消息和成员画像计算下一步阶段计划的
+ * 内部运行过程。本模块描述该过程的输入、结果与持久化记录。
  */
-import type { Agent } from "../../agent/Agent.js";
-import type { GroupMessage } from "./Group.js";
-import type { DispatchDecision, DispatchStrategy, DispatchTrigger } from "./DispatchStrategy.js";
-/** Dispatch Session 中一次调度 Turn 的持久化状态。 */
+import type { GroupMessage } from "../../types/group/Group.js";
+import type { DispatchGroupProfile, DispatchMemberProfile, DispatchDecision, DispatchStrategy, DispatchTrigger } from "../../types/group/DispatchStrategy.js";
+/** GroupSession 中一次调度 Turn 的持久化状态。 */
 export type GroupDispatchTurnStatus = "queued" | "running" | "completed" | "failed" | "stopped";
-/** Dispatch Session 中一次调度 Turn 的完整持久化快照。 */
+/** GroupSession 中一次调度 Turn 的完整持久化快照。 */
 export interface GroupDispatchTurnRecord {
     /** 当前调度 Turn 的稳定标识。 */
     readonly dispatch_id: string;
@@ -30,36 +29,31 @@ export interface GroupDispatchTurnRecord {
     /** 当前状态最近一次提交的 Unix 毫秒时间戳。 */
     readonly updated_at: number;
 }
-/** Dispatch Session 持久化所需的最小数据能力。 */
-export interface GroupDispatchSessionDataStore {
-    /** 读取每个 dispatch_id 的最新调度 Turn 快照。 */
-    list_turns(): Promise<GroupDispatchTurnRecord[]>;
-    /** 以追加日志方式提交一个调度 Turn 的最新完整快照。 */
-    append_turn(turn: GroupDispatchTurnRecord): Promise<void>;
-}
-/** Dispatch Session 成功完成一次调度后的运行结果。 */
-export interface GroupDispatchSessionResult {
+/** GroupSession 完成一次调度后的内部运行结果。 */
+export interface GroupDispatchResult {
     /** 当前调度 Turn 的稳定标识。 */
     readonly dispatch_id: string;
     /** 已经校验并持久化的成员投递决定。 */
     readonly decision: DispatchDecision;
 }
-/** 创建 Group Dispatch Session 的运行依赖。 */
-export interface GroupDispatchSessionOptions {
+/** 创建 Group 调度运行器的内部依赖。 */
+export interface GroupDispatchRuntimeOptions {
     /** 当前 GroupSession 使用的消息调度策略。 */
     readonly dispatch_strategy: DispatchStrategy;
 }
-/** 向 Group Dispatch Session 提交一次调度判断的输入快照。 */
-export interface GroupDispatchSessionInput {
+/** GroupSession 提交给调度策略的一次不可变输入快照。 */
+export interface GroupDispatchInput {
+    /** 当前 Group 的只读语义画像。 */
+    readonly group: DispatchGroupProfile;
     /** 本次调度由用户消息还是自动传播触发。 */
     readonly trigger: DispatchTrigger;
     /** 当前调度所围绕的 GroupMessage。 */
-    readonly message: GroupMessage;
+    readonly current_message: GroupMessage;
     /** 当前调度需要一起判断的新增 GroupMessage。 */
     readonly pending_messages: readonly GroupMessage[];
-    /** 当前 GroupSession 的完整共享消息快照。 */
-    readonly messages: readonly GroupMessage[];
-    /** 当前 Group 的成员快照。 */
-    readonly members: readonly Agent[];
+    /** 本批新增消息之前的最近 Group 对话。 */
+    readonly history: readonly GroupMessage[];
+    /** 当前 Group 成员的只读语义画像。 */
+    readonly members: readonly DispatchMemberProfile[];
 }
-//# sourceMappingURL=GroupDispatchSession.d.ts.map
+//# sourceMappingURL=GroupDispatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GroupDispatch.d.ts","sourceRoot":"","sources":["../../../src/types/group/GroupDispatch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAChB,MAAM,mCAAmC,CAAC;AAE3C,sCAAsC;AACtC,MAAM,MAAM,uBAAuB,GAC/B,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,wCAAwC;AACxC,MAAM,WAAW,uBAAuB;IACtC,uBAAuB;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,2BAA2B;AAC3B,MAAM,WAAW,2BAA2B;IAC1C,iCAAiC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;CAC9C;AAED,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,6BAA6B;IAC7B,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC;IACvC,kCAAkC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;IACnD,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACpD"}

package/bin/types/group/GroupDispatch.js

@@ -0,0 +1,8 @@
+/**
+ * GroupSession 内部调度协议。
+ *
+ * 调度不是独立 Session，只是 GroupSession 根据共享消息和成员画像计算下一步阶段计划的
+ * 内部运行过程。本模块描述该过程的输入、结果与持久化记录。
+ */
+export {};
+//# sourceMappingURL=GroupDispatch.js.map

package/bin/types/group/GroupDispatch.js.map

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

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

@@ -1,9 +1,9 @@
 /** GroupSession 的公开领域类型：一次 Group 的独立群聊上下文。 */
-import type { AgentSession } from "../agent/SessionActor.js";
-import type { GroupMessage } from "./Group.js";
+import type { AgentSession } from "../../types/agent/SessionActor.js";
+import type { GroupMessage } from "../../types/group/Group.js";
 import type { Agent } from "../../agent/Agent.js";
-import type { WorkspaceBase } from "@downcity/workspace";
-import type { RespondSessionInteractionInput, SessionInteractionRequest } from "../session/SessionInteraction.js";
+import type { WorkspaceRuntime } from "@downcity/type";
+import type { RespondSessionInteractionInput, SessionInteractionRequest } from "@downcity/type";
 /** Group 成员运行态。 */
 export interface GroupMemberRuntime {
     /** 成员 Agent 标识。 */
@@ -17,6 +17,9 @@ export type GroupStatusPhase = "idle" | "dispatching" | "dispatched" | "executin
 export type GroupEvent = {
     readonly type: "message"; /** 新增的共享消息。 */
     readonly message: GroupMessage;
+} | {
+    readonly type: "title"; /** 当前 GroupSession 最新的 canonical 标题。 */
+    readonly title: string;
 } | {
     readonly type: "interaction"; /** 发起交互的成员 Agent。 */
     readonly agent_id: string; /** 成员 Session 的交互请求。 */
@@ -61,18 +64,20 @@ export interface GroupSessionSummary {
     readonly message_count: number;
     /** 当前 GroupSession 绑定的 Workspace 标识。 */
     readonly workspace_id?: string;
+    /** 当前 GroupSession 持久化的用户可见标题。 */
+    readonly title?: string;
     /** 最后一条消息的用户可见预览。 */
     readonly preview_text?: string;
 }
 /** GroupSession 的创建输入；第一阶段不允许调用方指定 session_id。 */
 export interface GroupSessionCreateInput {
     /** 当前群聊使用的 Workspace；省略时使用内存执行上下文。 */
-    readonly workspace?: WorkspaceBase;
+    readonly workspace?: WorkspaceRuntime;
 }
 /** 恢复 GroupSession 时的上下文输入。 */
 export interface GroupSessionGetInput {
     /** 当前群聊使用的 Workspace；必须与持久化 metadata 一致。 */
-    readonly workspace?: WorkspaceBase;
+    readonly workspace?: WorkspaceRuntime;
 }
 /** GroupSession 列表过滤条件。 */
 export interface GroupSessionListInput {
@@ -87,6 +92,8 @@ export interface GroupSessionContract {
     readonly group_id: string;
     /** 当前 GroupSession 绑定的 Workspace ID；未绑定时为空。 */
     readonly workspace_id?: string;
+    /** 修改当前 GroupSession 的 canonical 用户可见标题。 */
+    rename(title: string): Promise<string>;
     /** 立即追加用户消息并开始异步群聊调度。 */
     prompt(input: GroupPromptInput): Promise<GroupPromptResult>;
     /** 读取共享消息事实快照。 */
@@ -121,7 +128,7 @@ export interface GroupSessionRuntimeContext {
     /** 当前 Group 的协作说明。 */
     readonly instruction?: string;
     /** 当前 Group 的消息调度策略。 */
-    readonly dispatch_strategy: import("./DispatchStrategy.js").DispatchStrategy;
+    readonly dispatch_strategy: import("../../types/group/DispatchStrategy.js").DispatchStrategy;
     /** 当前 Group 的稳定标识。 */
     readonly group_id: string;
     /** 当前 Group 的展示名称。 */

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

@@ -1 +1 @@
-{"version":3,"file":"GroupSession.d.ts","sourceRoot":"","sources":["../../../src/types/group/GroupSession.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAEvH,mBAAmB;AACnB,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,kBAAkB;AAClB,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1G,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAClB;IAAe,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,eAAe;IAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GACzF;IAAe,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,qBAAqB;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,wBAAwB;IAAC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAA;CAAE,GACpK;IAAe,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,cAAc;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,mBAAmB;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,cAAc;IAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,+BAA+B;IAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,eAAe;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAAE,CAAC;AAE/U,oBAAoB;AACpB,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/E,qBAAqB;AACrB,MAAM,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC;AAE/C,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mBAAmB;IACnB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,4BAA4B;AAC5B,MAAM,WAAW,gBAAgB;IAC/B,cAAc;IACd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,eAAe;IACf,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,eAAe;IACf,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gBAAgB;IAChB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;CACpC;AAED,+BAA+B;AAC/B,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;CACpC;AAED,2BAA2B;AAC3B,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yBAAyB;IACzB,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5D,kBAAkB;IAClB,QAAQ,IAAI,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAC7C,cAAc;IACd,SAAS,CAAC,UAAU,EAAE,oBAAoB,GAAG,qBAAqB,CAAC;IACnE,4CAA4C;IAC5C,mBAAmB,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,mCAAmC;IACnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,6BAA6B;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,4BAA4B;AAC5B,MAAM,WAAW,YAAa,SAAQ,oBAAoB;CAAG;AAE7D,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,MAAM,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,qCAAqC;IACrC,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACpF,qCAAqC;IACrC,IAAI,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;IAC7E,oBAAoB;IACpB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CACxF;AAED,4BAA4B;AAC5B,MAAM,WAAW,0BAA0B;IACzC,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,sBAAsB;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,iBAAiB,EAAE,OAAO,mCAAmC,EAAE,gBAAgB,CAAC;IACzF,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,qCAAqC;AACrC,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE9C,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,eAAe;IACf,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,yBAAyB;IACzB,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,gCAAgC;IAChC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,sDAAsD;IACtD,YAAY,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B"}
+{"version":3,"file":"GroupSession.d.ts","sourceRoot":"","sources":["../../../src/types/group/GroupSession.ts"],"names":[],"mappings":"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"}

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

@@ -1,7 +1,7 @@
 /** GroupSession 持久化协议：只描述 GroupSession 所需的底层数据能力。 */
-import type { GroupMessage } from "./Group.js";
-import type { GroupDispatchSessionDataStore } from "./GroupDispatchSession.js";
-import type { FileSystem } from "@downcity/workspace";
+import type { GroupMessage } from "../../types/group/Group.js";
+import type { GroupDispatchTurnRecord } from "../../types/group/GroupDispatch.js";
+import type { FileSystem } from "@downcity/type";
 /** GroupSession 的持久化元数据。 */
 export interface GroupSessionHistoryMeta {
     /** metadata schema 版本。 */
@@ -12,6 +12,8 @@ export interface GroupSessionHistoryMeta {
     readonly group_id: string;
     /** 当前 GroupSession 绑定的 Workspace 标识；未绑定时为空。 */
     readonly workspace_id?: string;
+    /** 当前 GroupSession 持久化的用户可见标题。 */
+    readonly title?: string;
     /** 首次创建时间戳。 */
     readonly created_at: number;
     /** 最近更新时间戳。 */
@@ -42,8 +44,6 @@ export interface GroupSessionTurnCheckpoint {
 export interface GroupSessionDataStore {
     /** 当前 GroupSession 标识。 */
     readonly session_id: string;
-    /** 当前 GroupSession 独享的 Dispatch Session 持久化视图。 */
-    readonly dispatch_session: GroupDispatchSessionDataStore;
     /** 初始化当前 GroupSession 的存储布局。 */
     initialize(): Promise<void>;
     /** 读取完整共享消息历史。 */
@@ -56,6 +56,10 @@ export interface GroupSessionDataStore {
     write_metadata(metadata: GroupSessionHistoryMeta): Promise<void>;
     /** 在文件锁内合并更新当前 GroupSession metadata。 */
     update_metadata(patch: Partial<GroupSessionHistoryMeta>): Promise<GroupSessionHistoryMeta>;
+    /** 读取当前 GroupSession 中每个 dispatch_id 的最新调度 Turn 快照。 */
+    list_dispatch_turns(): Promise<GroupDispatchTurnRecord[]>;
+    /** 向当前 GroupSession 的调度审计日志追加一个 Turn 状态快照。 */
+    append_dispatch_turn(turn: GroupDispatchTurnRecord): Promise<void>;
 }
 /** Group 所拥有的全部 GroupSession 持久化入口。 */
 export interface GroupSessionStore {

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

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

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

@@ -2,10 +2,10 @@
  * Agent Session action 公开类型。
  *
  * 关键点（中文）
- * - Action 运行事件由 Session 收口为 canonical `SessionActionMessage`。
+ * - Action 运行事件由 Session 收口为 canonical `SessionAgentActionPart`。
  * - Action 不进入模型输入。
  */
-import type { SessionActionEvent, SessionActionStatus } from "../session/SessionAction.js";
+import type { SessionActionEvent, SessionActionStatus } from "@downcity/type";
 /**
  * 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;;;;;;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"}
+{"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,gBAAgB,CAAC;AAExB;;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,7 +2,7 @@
  * Agent Session action 公开类型。
  *
  * 关键点（中文）
- * - Action 运行事件由 Session 收口为 canonical `SessionActionMessage`。
+ * - Action 运行事件由 Session 收口为 canonical `SessionAgentActionPart`。
  * - Action 不进入模型输入。
  */
 export {};

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

@@ -5,15 +5,15 @@
  * - `prompt()` 是 Session actor 模型下唯一的输入入口。
  * - 首条输入、运行中补充输入、排队到下一轮的输入，调用侧都使用同一结构。
  */
-import type { SessionPromptPart } from "../session/SessionContent.js";
+import type { SessionUserContent } from "@downcity/type";
 /**
  * Session user message part 类型。
  *
  * 说明（中文）
  * - 这是 Downcity Session 输入边界，不依赖模型协议或第三方 SDK。
- * - 可直接用于 `session.prompt({ query: [...parts] })` 传入 text parts、file parts 等。
+ * - 可直接用于 `session.prompt({ query: [...parts] })` 传入 text、context、file 等 parts。
  */
-export type SessionUserMessagePart = SessionPromptPart;
+export type AgentSessionPromptContent = SessionUserContent;
 /**
  * Session prompt 输入。
  *
@@ -21,6 +21,7 @@ export type SessionUserMessagePart = SessionPromptPart;
  * ```ts
  * session.prompt({
  *   query: [
+ *     { type: "context", tag: "reference", context: "此前引用的消息" },
  *     { type: "text", text: "请分析这个附件" },
  *     {
  *       type: "file",
@@ -40,24 +41,33 @@ export type SessionUserMessagePart = SessionPromptPart;
  * - 远程 Session 中，Data URL 在服务端落盘；调用方本地路径必须对服务端可访问。
  */
 export interface AgentSessionPromptInput {
+    /**
+     * 调用方为同一业务输入提供的稳定幂等标识。
+     *
+     * 说明（中文）
+     * - 相同 Session 内重复提交同一个 `request_id`，只会创建一条 canonical User Message。
+     * - 已完成的请求直接返回原 Turn 结果；进程重启后未完成的请求会复用原 Turn 恢复执行。
+     * - 不同业务输入不得复用同一个值；不需要跨进程重试的交互式调用可以省略。
+     */
+    request_id?: string;
     /**
      * 当前这次要追加到 Session 的用户文本或 parts 数组。
      *
      * 说明（中文）
      * - 支持两种格式：
      *   1. `string`：纯文本用户输入，Session 会将其包装为用户消息。
-     *   2. `SessionUserMessagePart[]`：Downcity Session user parts，可直接携带 text、file 等内容。
+     *   2. `AgentSessionPromptContent[]`：Downcity Session 内容，可直接携带 text、context、file 等内容。
      * - 调用侧永远只传"新的用户输入"。
      * - 它是否并入当前 turn，还是排到下一 turn，由 Session 内部决定。
      */
-    query: string | SessionUserMessagePart[];
+    query: string | AgentSessionPromptContent[];
 }
 /**
  * 判断 prompt 输入是否为空。
  *
  * 说明（中文）
  * - `string`：trim 后为空即视为空。
- * - `SessionUserMessagePart[]`：数组为空或仅包含空文本时视为空。
+ * - `AgentSessionPromptContent[]`：数组为空，或仅包含空文本和空 Context 时视为空。
  */
 export declare function is_agent_session_prompt_input_empty(input: AgentSessionPromptInput): boolean;
 //# sourceMappingURL=AgentSessionPrompt.d.ts.map

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,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"}
+{"version":3,"file":"AgentSessionPrompt.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;OASG;IACH,KAAK,EAAE,MAAM,GAAG,yBAAyB,EAAE,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAiB3F"}

package/bin/types/sdk/AgentSessionPrompt.js

@@ -10,7 +10,7 @@
  *
  * 说明（中文）
  * - `string`：trim 后为空即视为空。
- * - `SessionUserMessagePart[]`：数组为空或仅包含空文本时视为空。
+ * - `AgentSessionPromptContent[]`：数组为空，或仅包含空文本和空 Context 时视为空。
  */
 export function is_agent_session_prompt_input_empty(input) {
     const query = input.query;
@@ -21,9 +21,13 @@ export function is_agent_session_prompt_input_empty(input) {
         if (query.length === 0) {
             return true;
         }
-        // 如果所有 parts 都是空文本，也视为空
+        // 只有空文本与空 Context 的输入没有可执行语义。
         return query.every((part) => {
-            return part.type === "text" && part.text.trim() === "";
+            if (part.type === "text")
+                return part.text.trim() === "";
+            if (part.type === "context")
+                return part.context.trim() === "";
+            return false;
         });
     }
     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,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"}
+{"version":3,"file":"AgentSessionPrompt.js","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+DH;;;;;;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,8BAA8B;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YACzD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * AdaptivePartContextPolicy 内部持久化与候选类型。
+ *
+ * 类型集中在 types 目录，策略模块只保留上下文选择行为。
+ */
+import type { SessionAgentMessagePart, SessionMessage, SessionUserMessagePart } from "@downcity/type";
+/** Part 级累计摘要 checkpoint。 */
+export interface AdaptivePartCheckpointRow {
+    /** checkpoint 稳定标识。 */
+    checkpoint_id: string;
+    /** 边界所属 Message 标识。 */
+    through_message_id: string;
+    /** 边界所属 Message sequence。 */
+    through_message_sequence: number;
+    /** 边界 Part sequence。 */
+    through_part_sequence: number;
+    /** 累计摘要正文。 */
+    summary: string;
+    /** 生成派生结果的策略版本。 */
+    policy_version: number;
+    /** 派生记录创建时间。 */
+    created_at: number;
+}
+/** 可参与摘要的稳定 Part 及其 canonical 位置。 */
+export interface StablePartCandidate {
+    /** Part 所属完整 Message。 */
+    message: SessionMessage;
+    /** 具体 canonical Part。 */
+    part: SessionUserMessagePart | SessionAgentMessagePart;
+}
+//# sourceMappingURL=AdaptivePartContextPolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"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

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

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * Assistant Message 状态转换器的依赖类型。
+ *
+ * 该类型只暴露 canonical Message 所有者允许使用的最小能力，避免内部协作者
+ * 复制 SessionMessages 的消息索引或 Mutation 发布状态。
+ */
+import type { SessionStorage } from "../../types/store/SessionStorage.js";
+import type { SessionMessage } from "@downcity/type";
+import type { SessionMutation } from "@downcity/type";
+/** Assistant Message 状态转换器的构造参数。 */
+export interface SessionAgentMessageStateOptions {
+    /** 当前 Assistant Message 所属 Session 的稳定标识。 */
+    session_id: string;
+    /** 负责持久化 canonical Message 稳定检查点的 Store。 */
+    store: SessionStorage;
+    /** 读取 SessionMessages 当前持有的 canonical Message 集合。 */
+    list_messages: () => Iterable<SessionMessage>;
+    /** 接受已持久化的完整 Message 快照，并按需发布 Mutation。 */
+    accept_message: (message: SessionMessage, publish_mutation?: boolean) => void;
+    /** 接受未持久化的实时 Mutation，并只更新当前运行投影。 */
+    project_mutation: (mutation: SessionMutation, message: SessionMessage) => void;
+}
+//# sourceMappingURL=SessionAgentMessageState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionAgentMessageState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionAgentMessageState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,oCAAoC;AACpC,MAAM,WAAW,+BAA+B;IAC9C,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,EAAE,cAAc,CAAC;IACtB,qDAAqD;IACrD,aAAa,EAAE,MAAM,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9C,2CAA2C;IAC3C,cAAc,EAAE,CACd,OAAO,EAAE,cAAc,EACvB,gBAAgB,CAAC,EAAE,OAAO,KACvB,IAAI,CAAC;IACV,qCAAqC;IACrC,gBAAgB,EAAE,CAChB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,cAAc,KACpB,IAAI,CAAC;CACX"}

package/bin/types/session/SessionAgentMessageState.js

@@ -0,0 +1,8 @@
+/**
+ * Assistant Message 状态转换器的依赖类型。
+ *
+ * 该类型只暴露 canonical Message 所有者允许使用的最小能力，避免内部协作者
+ * 复制 SessionMessages 的消息索引或 Mutation 发布状态。
+ */
+export {};
+//# sourceMappingURL=SessionAgentMessageState.js.map

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

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

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

@@ -3,8 +3,18 @@
  *
  * Command 只存在于 Session 运行进程内，不属于 Remote Transport 协议，也不持久化。
  */
-/** Session Command 构造参数。 */
-export interface SessionCommandOptions {
+/** Session Command 的执行类别。 */
+export type SessionCommandKind = 
+/** Prompt Command 需要创建或加入一个 Turn。 */
+"prompt"
+/** Maintenance Command 可以在 Session 空闲期独立执行。 */
+ | "maintenance";
+/** Session 有序输入队列中的 Command。 */
+export interface SessionCommand {
+    /** 当前 Command 的执行类别。 */
+    kind: SessionCommandKind;
+    /** Prompt 恢复执行时要求复用的稳定 Turn ID。 */
+    turn_id?: string;
     /** Command 出队后执行的完整行为。 */
     execute: () => Promise<void>;
     /** Session stop 时取消该 Command 的可选行为；未提供时 Command 继续保留。 */
@@ -12,17 +22,19 @@ export interface SessionCommandOptions {
     /** Command 成功执行后需要持久化的完成信息；未提供时静默完成。 */
     completion?: SessionCommandCompletion;
 }
+/** Session facade 创建 Command 时使用的输入。 */
+export type SessionCommandOptions = SessionCommand;
 /** Session Command 成功执行后的 canonical 持久化信息。 */
 export interface SessionCommandCompletion {
-    /** 完成信息固定持久化为 Action Message。 */
+    /** 完成信息固定持久化为 Agent Message 内的 Action Part。 */
     type: "action";
-    /** Action Message 使用的稳定业务标识。 */
+    /** Action Part 及其所属 Agent Message 共用的稳定业务标识。 */
     id: string;
-    /** Action Message 展示的用户可读标题。 */
+    /** Action Part 展示的用户可读标题。 */
     title: string;
-    /** Action Message 展示的可选结果说明。 */
+    /** Action Part 展示的可选结果说明。 */
     description?: string;
-    /** Action Message 持久化后是否发布对应 Session Mutation。 */
+    /** Action Part 所属 Agent Message 持久化后是否发布对应 Session Mutation。 */
     publish_mutation?: boolean;
 }
 //# sourceMappingURL=SessionCommand.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SessionCommand.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4BAA4B;AAC5B,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC;AAED,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC,iCAAiC;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B"}
+{"version":3,"file":"SessionCommand.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6BAA6B;AAC7B,MAAM,MAAM,kBAAkB;AAC5B,qCAAqC;AACnC,QAAQ;AACV,+CAA+C;GAC7C,aAAa,CAAC;AAElB,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,IAAI,EAAE,kBAAkB,CAAC;IACzB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,wCAAwC;IACxC,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC;AAED,wCAAwC;AACxC,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAEnD,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC,+CAA+C;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B"}