@downcity/agent 1.1.32 → 1.1.35

package/bin/sdk/Agent.js.map

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

package/bin/sdk/AgentSdkTypes.d.ts

@@ -3,16 +3,22 @@
  *
  * 关键点（中文）
  * - 这里集中声明 `Agent` / `RemoteAgent` / `Session` 面向外部调用方的稳定接口。
- * - SDK 用户通过显式 `tools` / `runtimePlugins` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
+ * - SDK 用户通过显式 `tools` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
  * - 本地/远程 session 运行与基础落盘能力仍是 SDK 主路径。
  */
 import type { LanguageModel, Tool } from "ai";
 import type { BasePlugin } from "../plugin/core/BasePlugin.js";
-import type { Plugin } from "../plugin/types/Plugin.js";
 import type { AgentPlatformRuntime } from "../types/runtime/host/AgentHost.js";
 import type { LocalRpcServerHandle } from "../types/runtime/rpc/LocalRpc.js";
 import type { ServerInstance } from "../runtime/server/http/Server.js";
-import type { Session } from "../sdk/Session.js";
+import type { SessionMessageV1 } from "../executor/types/SessionMessages.js";
+import type { AgentSessionSubscriber, AgentSessionUnsubscribe } from "../types/sdk/AgentSessionEvent.js";
+import type { AgentSessionPromptInput } from "../types/sdk/AgentSessionPrompt.js";
+import type { AgentSessionTurnHandle } from "../types/sdk/AgentSessionTurn.js";
+/**
+ * SDK Agent 插件装配模式。
+ */
+export type AgentMode = "preset" | "custom";
 /**
  * 本地 Agent 构造参数。
  */
@@ -56,39 +62,23 @@ export interface AgentOptions {
      */
     model?: LanguageModel;
     /**
-     * 当前 agent 显式持有的 runtime plugin 实例集合。
-     *
-     * 关键点（中文）
-     * - 这里接收已经实例化好的 runtime plugin，而不是 plugin class。
-     * - `Agent` 会在构造阶段按名称注册这些实例，并在启动时自动绑定 runtime。
-     * - v1 推荐显式传入 `new ChatPlugin(...)` 这类实例，而不是依赖包内隐式注册表。
-     */
-    runtimePlugins?: BasePlugin[];
-    /**
-     * 是否自动装配全部内建 runtime plugin。
+     * 当前 agent 的插件装配模式。
      *
      * 关键点（中文）
-     * - 适合 city 这类宿主进程直接 `new Agent(...)` 的场景。
-     * - 未开启时，默认只使用显式传入的 `runtimePlugins`。
+     * - `preset` 会自动装配内建插件集合。
+     * - `custom` 只使用显式传入的 `plugins`。
+     * - 默认值为 `custom`，避免本地嵌入场景隐式打开额外能力。
      */
-    useBuiltinRuntimePlugins?: boolean;
+    mode?: AgentMode;
     /**
-     * 当前 agent 显式注册的 plugin 定义集合。
+     * 当前 agent 显式持有的插件实例集合。
      *
      * 关键点（中文）
-     * - 这里接收完整 plugin 定义对象，而不是 plugin 名称。
-     * - `Agent` 会为当前 SDK 实例创建独立 plugin registry，避免污染全局 runtime。
+     * - 这里接收已经实例化好的 `BasePlugin` 对象，而不是 plugin class。
+     * - `Agent` 会在构造阶段按名称注册这些实例，并自动绑定到当前 runtime。
      * - 同名 plugin 会直接报错，避免 action / hook / resolve 行为被静默覆盖。
      */
-    plugins?: Plugin[];
-    /**
-     * 是否自动装配全部内建 plugin。
-     *
-     * 关键点（中文）
-     * - 适合 city 这类宿主进程直接 `new Agent(...)` 的场景。
-     * - 未开启时，默认只使用显式传入的 `plugins`。
-     */
-    useBuiltinPlugins?: boolean;
+    plugins?: BasePlugin[];
     /**
      * 当前 agent 显式注入的平台能力集合。
      *
@@ -104,9 +94,9 @@ export interface AgentOptions {
      * - SDK 不负责默认模型策略，宿主可在这里统一为 session 注入 model 等运行配置。
      * - 若同时传入 `model`，则会先写入默认模型，再执行这里的宿主覆写逻辑。
      * - 该钩子对每个 session 只触发一次，适合做实例级默认装配。
-     * - 触发时机可能来自显式 `agent.session()`，也可能来自该 session 的首次执行入口。
+     * - 触发时机可能来自显式 `agent.createSession()` / `agent.getSession()`，也可能来自该 session 的首次执行入口。
      */
-    configureSession?: (session: Session) => Promise<void> | void;
+    configureSession?: (session: AgentSession) => Promise<void> | void;
 }
 /**
  * Agent 启动参数。
@@ -130,13 +120,13 @@ export interface AgentStartOptions {
      */
     rpc?: boolean;
     /**
-     * 是否启动当前 agent 的 runtime plugins。
+     * 是否启动当前 agent 的 plugins。
      *
      * 关键点（中文）
      * - 默认 `true`。
      * - `false` 适合只需要 session 能力、不希望启动后台能力的嵌入场景。
      */
-    runtimePlugins?: boolean;
+    plugins?: boolean;
 }
 /**
  * Agent 停止结果快照。
@@ -151,9 +141,9 @@ export interface AgentStopResult {
      */
     rpcStopped: boolean;
     /**
-     * 本次是否实际停止了 runtime plugins。
+     * 本次是否实际停止了 plugins。
      */
-    runtimePluginsStopped: boolean;
+    pluginsStopped: boolean;
 }
 /**
  * Agent 启动后的状态快照。
@@ -168,9 +158,9 @@ export interface AgentStartResult {
      */
     rpc?: AgentRpcBinding;
     /**
-     * 当前 agent 是否已启动 runtime plugins。
+     * 当前 agent 是否已启动 plugins。
      */
-    runtimePluginsStarted: boolean;
+    pluginsStarted: boolean;
 }
 /**
  * Agent HTTP 启动参数。
@@ -230,6 +220,49 @@ export interface RemoteAgentOptions {
      */
     baseUrl: string;
 }
+/**
+ * 新建 session 的输入参数。
+ */
+export interface AgentCreateSessionInput {
+    /**
+     * 可选显式 sessionId。
+     *
+     * 关键点（中文）
+     * - 传入时表达“创建意图”。
+     * - 若该 session 已存在，SDK 应直接报错，而不是静默复用。
+     * - 省略时由 SDK 自动生成稳定且不可推导的 sessionId。
+     */
+    sessionId?: string;
+}
+/**
+ * Session 列表查询输入。
+ */
+export interface AgentListSessionsInput {
+    /**
+     * 当前页返回上限。
+     *
+     * 说明（中文）
+     * - 省略时由 SDK 使用默认值。
+     * - 建议宿主 UI 明确传入，避免在大量 session 下拉取过多数据。
+     */
+    limit?: number;
+    /**
+     * 分页游标。
+     *
+     * 说明（中文）
+     * - 当前使用 SDK 自身生成的透明字符串游标。
+     * - 调用方只负责透传，不应自行解析其内部格式。
+     */
+    cursor?: string;
+    /**
+     * 关键词过滤。
+     *
+     * 说明（中文）
+     * - 推荐用于匹配 `sessionId`、标题与预览文本。
+     * - 属于轻量包含匹配，不承诺复杂搜索语义。
+     */
+    query?: string;
+}
 /**
  * Session 可变配置。
  */
@@ -256,6 +289,49 @@ export interface AgentSessionConfigSnapshot {
      */
     modelLabel?: string;
 }
+/**
+ * Session 历史视图类型。
+ */
+export type AgentSessionHistoryView = "message" | "timeline";
+/**
+ * Session 时间线事件。
+ */
+export interface AgentSessionTimelineEvent {
+    /**
+     * 当前事件唯一标识。
+     */
+    id: string;
+    /**
+     * 当前事件角色。
+     *
+     * 说明（中文）
+     * - `tool-call` / `tool-result` 用于把 assistant 内部工具过程平铺给 UI。
+     */
+    role: "user" | "assistant" | "tool-call" | "tool-result";
+    /**
+     * 事件时间戳（毫秒）。
+     */
+    ts?: number;
+    /**
+     * 事件所属消息种类。
+     */
+    kind?: string;
+    /**
+     * 事件来源。
+     */
+    source?: string;
+    /**
+     * 当前事件展示文本。
+     */
+    text: string;
+    /**
+     * 当前事件对应工具名称。
+     *
+     * 说明（中文）
+     * - 仅 `tool-call` / `tool-result` 这类事件通常会携带该字段。
+     */
+    toolName?: string;
+}
 /**
  * Session system block 来源类型。
  */
@@ -343,9 +419,9 @@ export interface AgentSessionSystemSnapshot {
     blocks: AgentSessionSystemBlock[];
 }
 /**
- * Session 元数据列表项。
+ * Session 摘要。
  */
-export interface AgentSessionMetadata {
+export interface AgentSessionSummary {
     /**
      * 当前 session 所属 agentId。
      */
@@ -354,6 +430,22 @@ export interface AgentSessionMetadata {
      * 当前 session 唯一标识。
      */
     sessionId: string;
+    /**
+     * 当前 session 可读标题。
+     *
+     * 说明（中文）
+     * - 当前 SDK 不要求标题一定存在。
+     * - 若调用方需要展示列表标题，可优先使用这里；为空时再回退到 `sessionId`。
+     */
+    title?: string;
+    /**
+     * 当前 session 的最近预览文本。
+     *
+     * 说明（中文）
+     * - 通常来自最后一条用户可见消息的裁剪文本。
+     * - 适合用于侧边栏、列表卡片或 session picker。
+     */
+    previewText?: string;
     /**
      * 当前 session 首次创建时间（ms）。
      */
@@ -370,6 +462,110 @@ export interface AgentSessionMetadata {
      * 当前 session 绑定模型的可读标签。
      */
     modelLabel?: string;
+    /**
+     * 当前 session 是否处于执行中。
+     */
+    executing?: boolean;
+}
+/**
+ * Session 详情。
+ */
+export interface AgentSessionInfo extends AgentSessionSummary {
+    /**
+     * 当前 session 初始化时记录的时区。
+     */
+    timezone?: string;
+}
+/**
+ * Session 摘要分页结果。
+ */
+export interface AgentSessionSummaryPage {
+    /**
+     * 当前页 session 摘要列表。
+     */
+    items: AgentSessionSummary[];
+    /**
+     * 当前页所对应的总条数。
+     *
+     * 说明（中文）
+     * - 这里表示过滤后的总数，不是仅当前页数量。
+     * - 对分页 UI、结果统计和空态判断更友好。
+     */
+    total: number;
+    /**
+     * 下一页游标。
+     */
+    nextCursor?: string;
+    /**
+     * 是否仍有更多结果。
+     */
+    hasMore: boolean;
+}
+/**
+ * Session 历史读取输入。
+ */
+export interface AgentSessionHistoryInput {
+    /**
+     * 当前页返回上限。
+     */
+    limit?: number;
+    /**
+     * 分页游标。
+     */
+    cursor?: string;
+    /**
+     * 返回顺序。
+     *
+     * 说明（中文）
+     * - `asc`：从旧到新
+     * - `desc`：从新到旧
+     */
+    order?: "asc" | "desc";
+    /**
+     * 返回视图类型。
+     *
+     * 说明（中文）
+     * - `message`：原始 session 消息
+     * - `timeline`：适合直接渲染 UI 的平铺事件
+     */
+    view?: AgentSessionHistoryView;
+}
+/**
+ * Session 历史分页结果。
+ */
+export interface AgentSessionHistoryPage {
+    /**
+     * 当前读取所对应的 session 信息。
+     */
+    session: AgentSessionInfo;
+    /**
+     * 当前页实际返回视图。
+     */
+    view: AgentSessionHistoryView;
+    /**
+     * 当前页数据列表。
+     *
+     * 说明（中文）
+     * - `view=message` 时返回 `SessionMessageV1[]`
+     * - `view=timeline` 时返回 `AgentSessionTimelineEvent[]`
+     */
+    items: SessionMessageV1[] | AgentSessionTimelineEvent[];
+    /**
+     * 过滤前后的总条数。
+     *
+     * 说明（中文）
+     * - 对 `view=message` 表示消息条数。
+     * - 对 `view=timeline` 表示时间线事件条数。
+     */
+    total: number;
+    /**
+     * 下一页游标。
+     */
+    nextCursor?: string;
+    /**
+     * 是否仍有更多数据。
+     */
+    hasMore: boolean;
 }
 /**
  * Session fork 输入。
@@ -384,4 +580,80 @@ export interface AgentSessionForkInput {
      */
     messageId?: string;
 }
+/**
+ * SDK Session 集合绑定。
+ */
+export interface AgentSessionCollection {
+    /**
+     * 新建一个 session。
+     */
+    createSession(input?: AgentCreateSessionInput): Promise<AgentSession>;
+    /**
+     * 获取一个已存在的 session。
+     */
+    getSession(sessionId: string): Promise<AgentSession>;
+    /**
+     * 列出当前 agent 的 session 摘要页。
+     */
+    listSessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+}
+/**
+ * Session actor 公共能力。
+ */
+export interface AgentSessionActor {
+    /**
+     * 当前 session 稳定标识。
+     */
+    readonly id: string;
+    /**
+     * 读取当前 session 详情。
+     */
+    getInfo(): Promise<AgentSessionInfo>;
+    /**
+     * 追加一条新的 prompt。
+     */
+    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
+    /**
+     * 订阅当前 session 的未来事件。
+     */
+    subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
+    /**
+     * 读取当前 session 历史分页。
+     */
+    history(input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage>;
+    /**
+     * 读取当前 session 生效的 system 快照。
+     */
+    system(): Promise<AgentSessionSystemSnapshot>;
+}
+/**
+ * 本地 Agent 返回的公开 session 接口。
+ */
+export interface AgentSession extends AgentSessionActor {
+    /**
+     * 当前 session 所属 agentId。
+     */
+    readonly agentId: string;
+    /**
+     * 当前 session 配置快照。
+     */
+    readonly config: AgentSessionConfigSnapshot;
+    /**
+     * 写入当前 session 默认配置。
+     */
+    set(input: AgentSessionSetInput): Promise<void>;
+    /**
+     * 从当前 session 创建一个分叉会话。
+     */
+    fork(input?: AgentSessionForkInput | string): Promise<AgentSession>;
+}
+/**
+ * 远程 Agent 返回的公开 session 接口。
+ */
+export interface RemoteAgentSession extends AgentSessionActor {
+    /**
+     * 从当前远程 session 创建一个分叉会话。
+     */
+    fork(input?: AgentSessionForkInput | string): Promise<RemoteAgentSession>;
+}
 //# sourceMappingURL=AgentSdkTypes.d.ts.map

package/bin/sdk/AgentSdkTypes.d.ts.map

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

package/bin/sdk/AgentSdkTypes.js

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里集中声明 `Agent` / `RemoteAgent` / `Session` 面向外部调用方的稳定接口。
- * - SDK 用户通过显式 `tools` / `runtimePlugins` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
+ * - SDK 用户通过显式 `tools` / `plugins` 装配能力，不直接依赖内部 runtime 单例。
  * - 本地/远程 session 运行与基础落盘能力仍是 SDK 主路径。
  */
 export {};

package/bin/sdk/RemoteAgent.d.ts

@@ -6,58 +6,7 @@
  * - 与本地 `Session` 保持同一套 Session actor 使用面：`prompt()` + `subscribe()`。
  * - `RemoteAgent` 只负责 transport 与本地 turn handle 合成，不重复实现第二套会话编排器。
  */
-import type { AgentSessionMetadata, AgentSessionSetInput, AgentSessionSystemSnapshot, RemoteAgentOptions } from "../sdk/AgentSdkTypes.js";
-import type { SessionMessageV1 } from "../session/types/SessionMessages.js";
-import type { AgentSessionSubscriber, AgentSessionUnsubscribe } from "../types/sdk/AgentSessionEvent.js";
-import type { AgentSessionPromptInput } from "../types/sdk/AgentSessionPrompt.js";
-import type { AgentSessionTurnHandle } from "../types/sdk/AgentSessionTurn.js";
-/**
- * 远程 Session 客户端。
- */
-declare class RemoteSession {
-    readonly id: string;
-    private readonly baseUrl;
-    private readonly eventHub;
-    private readonly turnsById;
-    private readonly completedTurnIds;
-    private eventPumpConnectPromise;
-    private eventPumpAbortController;
-    private eventPumpRunning;
-    private eventSubscriberCount;
-    constructor(baseUrl: string, sessionId: string);
-    /**
-     * 远程 session 当前不支持直接注入本地模型实例。
-     */
-    set(_input: AgentSessionSetInput): Promise<void>;
-    /**
-     * 向当前远程 session 追加一条新的 prompt。
-     */
-    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
-    /**
-     * 订阅当前远程 session 的 future 事件。
-     */
-    subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
-    /**
-     * 读取远程消息历史。
-     */
-    history(): Promise<SessionMessageV1[]>;
-    /**
-     * 读取远程 session 当前生效的 system prompt 快照。
-     */
-    system(): Promise<AgentSessionSystemSnapshot>;
-    /**
-     * 分叉远程 session。
-     */
-    fork(messageId?: string): Promise<RemoteSession>;
-    private ensureEventPump;
-    private consumeEventConnection;
-    private handleEventLine;
-    private handleEvent;
-    private ensureTurnLifecycle;
-    private failPendingTurns;
-    private rememberCompletedTurn;
-    private maybeStopEventPump;
-}
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentSessionSummaryPage, RemoteAgentSession, RemoteAgentOptions } from "../sdk/AgentSdkTypes.js";
 /**
  * RemoteAgent：远程 Agent 客户端。
  */
@@ -65,13 +14,16 @@ export declare class RemoteAgent {
     private readonly baseUrl;
     constructor(options: RemoteAgentOptions);
     /**
-     * 获取或创建一个远程 session。
+     * 新建一个远程 session。
+     */
+    createSession(input?: AgentCreateSessionInput): Promise<RemoteAgentSession>;
+    /**
+     * 获取一个已存在的远程 session。
      */
-    session(sessionId?: string): Promise<RemoteSession>;
+    getSession(sessionId: string): Promise<RemoteAgentSession>;
     /**
-     * 列出远程 agent 的全部 session 元数据。
+     * 列出远程 agent 的 session 摘要页。
      */
-    sessions(): Promise<AgentSessionMetadata[]>;
+    listSessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
 }
-export {};
 //# sourceMappingURL=RemoteAgent.d.ts.map

package/bin/sdk/RemoteAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteAgent.d.ts","sourceRoot":"","sources":["../../src/sdk/RemoteAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAEV,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,iCAAiC,CAAC;AAmDzC;;GAEG;AACH,cAAM,aAAa;IACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,uBAAuB,CAA8B;IAC7D,OAAO,CAAC,wBAAwB,CAAgC;IAChE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,oBAAoB,CAAK;gBAErB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAK9C;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtD;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmC7E;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,sBAAsB,GAAG,uBAAuB;IAgBtE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAe5C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAoBnD;;OAEG;IACG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;YAwBxC,eAAe;YAoDf,sBAAsB;IAmDpC,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,kBAAkB;CAO3B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,kBAAkB;IAQvC;;OAEG;IACG,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAqBzD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAYlD"}
+{"version":3,"file":"RemoteAgent.d.ts","sourceRoot":"","sources":["../../src/sdk/RemoteAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EAMtB,uBAAuB,EAEvB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAgbhC;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,kBAAkB;IAQvC;;OAEG;IACG,aAAa,CACjB,KAAK,CAAC,EAAE,uBAAuB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IAqB9B;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmBhE;;OAEG;IACG,YAAY,CAChB,KAAK,CAAC,EAAE,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC;CAkBpC"}