@downcity/agent 1.1.43 → 1.1.62

package/bin/model/CityModelAdapter.js

@@ -0,0 +1,338 @@
+/**
+ * CityModel 到 AI SDK LanguageModel 的适配模块。
+ *
+ * 关键点（中文）
+ * - Agent 对外可以接收 CityModel，但 executor 内部仍只处理 AI SDK LanguageModel。
+ * - 适配逻辑集中在这里，避免 City 协议散落到 session/executor 各处。
+ * - 这里不依赖 @downcity/city，只依赖 @downcity/type 的共享协议。
+ */
+import { CITY_MODEL_INVOKER, isCityModel, } from "@downcity/type";
+function normalizeFinishReason(input) {
+    const text = typeof input === "string" ? input : "";
+    if (text === "stop" || text === "length" || text === "content-filter" || text === "tool-calls" || text === "error") {
+        return { unified: text, raw: text };
+    }
+    return { unified: "stop", raw: text || "stop" };
+}
+function stringifyToolInput(input) {
+    if (typeof input === "string")
+        return input;
+    try {
+        return JSON.stringify(input ?? {});
+    }
+    catch {
+        return "{}";
+    }
+}
+function textFromProviderContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((part) => part && typeof part === "object" && part.type === "text")
+        .map((part) => String(part.text ?? ""))
+        .join("\n")
+        .trim();
+}
+function fileUrlFromProviderPart(part) {
+    const data = part.data;
+    if (data instanceof URL)
+        return data.toString();
+    if (typeof data === "string")
+        return data;
+    return "";
+}
+function providerContentToUiParts(content) {
+    if (!Array.isArray(content)) {
+        return [{ type: "text", text: textFromProviderContent(content) }];
+    }
+    const parts = [];
+    for (const part of content) {
+        if (!part || typeof part !== "object")
+            continue;
+        const record = part;
+        if (record.type === "text") {
+            parts.push({ type: "text", text: String(record.text ?? "") });
+            continue;
+        }
+        if (record.type === "reasoning") {
+            parts.push({ type: "reasoning", text: String(record.text ?? "") });
+            continue;
+        }
+        if (record.type === "file") {
+            const url = fileUrlFromProviderPart(record);
+            if (!url)
+                continue;
+            parts.push({
+                type: "file",
+                mediaType: String(record.mediaType ?? "application/octet-stream"),
+                filename: typeof record.filename === "string" ? record.filename : undefined,
+                url,
+            });
+            continue;
+        }
+        if (record.type === "tool-call") {
+            parts.push({
+                type: "dynamic-tool",
+                toolName: String(record.toolName ?? ""),
+                toolCallId: String(record.toolCallId ?? ""),
+                state: "input-available",
+                input: record.input,
+                providerExecuted: Boolean(record.providerExecuted),
+            });
+        }
+    }
+    return parts;
+}
+function providerPromptToMessages(prompt) {
+    if (!Array.isArray(prompt))
+        return [];
+    return prompt
+        .map((message, index) => {
+        if (!message || typeof message !== "object")
+            return null;
+        const item = message;
+        const role = item.role === "system" || item.role === "assistant" ? item.role : "user";
+        const parts = providerContentToUiParts(item.content);
+        return {
+            id: `city-model-message-${String(index)}`,
+            role,
+            parts,
+        };
+    })
+        .filter((message) => Boolean(message));
+}
+function providerOptionsToInput(options) {
+    return {
+        messages: providerPromptToMessages(options.prompt),
+        tools: options.tools,
+        toolChoice: options.toolChoice,
+        providerOptions: options.providerOptions,
+    };
+}
+function textFromUiMessage(message) {
+    return message.parts
+        .filter((part) => part.type === "text")
+        .map((part) => String(part.text ?? ""))
+        .join("\n")
+        .trim();
+}
+function uiMessageToProviderContent(message) {
+    return message.parts.flatMap((part) => {
+        if (part.type === "text") {
+            return [{ type: "text", text: String(part.text ?? "") }];
+        }
+        if (part.type === "reasoning") {
+            return [{ type: "reasoning", text: String(part.text ?? "") }];
+        }
+        if (part.type === "dynamic-tool") {
+            const toolPart = part;
+            return [{
+                    type: "tool-call",
+                    toolCallId: String(toolPart.toolCallId ?? ""),
+                    toolName: String(toolPart.toolName ?? ""),
+                    input: stringifyToolInput(toolPart.input),
+                    providerExecuted: Boolean(toolPart.providerExecuted),
+                }];
+        }
+        return [];
+    });
+}
+function enqueueFinish(controller, finishReason) {
+    controller.enqueue({
+        type: "finish",
+        finishReason: normalizeFinishReason(finishReason),
+        usage: {
+            inputTokens: {
+                total: undefined,
+                noCache: undefined,
+                cacheRead: undefined,
+                cacheWrite: undefined,
+            },
+            outputTokens: {
+                total: undefined,
+                text: undefined,
+                reasoning: undefined,
+            },
+        },
+    });
+}
+function enqueueProviderParts(controller, parts, state) {
+    for (const part of parts) {
+        if (part.type !== "stream-start" && !state.sawStart) {
+            controller.enqueue({ type: "stream-start", warnings: [] });
+            state.sawStart = true;
+        }
+        if (part.type === "stream-start")
+            state.sawStart = true;
+        if (part.type === "finish")
+            state.sawFinish = true;
+        controller.enqueue(part);
+    }
+}
+function mapUiChunkToProviderParts(chunk) {
+    switch (chunk.type) {
+        case "start":
+            return [{ type: "stream-start", warnings: [] }];
+        case "text-start":
+            return [{ type: "text-start", id: chunk.id }];
+        case "text-delta":
+            return [{ type: "text-delta", id: chunk.id, delta: chunk.delta }];
+        case "text-end":
+            return [{ type: "text-end", id: chunk.id }];
+        case "reasoning-start":
+            return [{ type: "reasoning-start", id: chunk.id }];
+        case "reasoning-delta":
+            return [{ type: "reasoning-delta", id: chunk.id, delta: chunk.delta }];
+        case "reasoning-end":
+            return [{ type: "reasoning-end", id: chunk.id }];
+        case "tool-input-start":
+            return [{
+                    type: "tool-input-start",
+                    id: chunk.toolCallId,
+                    toolName: chunk.toolName,
+                    providerExecuted: chunk.providerExecuted,
+                    dynamic: chunk.dynamic,
+                }];
+        case "tool-input-delta":
+            return [{
+                    type: "tool-input-delta",
+                    id: chunk.toolCallId,
+                    delta: chunk.inputTextDelta,
+                }];
+        case "tool-input-available":
+            return [{
+                    type: "tool-call",
+                    toolCallId: chunk.toolCallId,
+                    toolName: chunk.toolName,
+                    input: stringifyToolInput(chunk.input),
+                    providerExecuted: chunk.providerExecuted,
+                    dynamic: chunk.dynamic,
+                }];
+        case "tool-output-available":
+            return [{
+                    type: "tool-result",
+                    toolCallId: chunk.toolCallId,
+                    toolName: "",
+                    output: { type: "json", value: chunk.output },
+                    providerExecuted: chunk.providerExecuted,
+                    dynamic: chunk.dynamic,
+                }];
+        case "error":
+            return [{ type: "error", error: new Error(chunk.errorText) }];
+        default:
+            return [];
+    }
+}
+function cityModelToLanguageModel(model) {
+    const invoker = model[CITY_MODEL_INVOKER];
+    const languageModel = {
+        specificationVersion: "v3",
+        provider: "downcity",
+        modelId: model.id,
+        supportedUrls: {},
+        async doGenerate(options) {
+            const message = await invoker.text(providerOptionsToInput(options));
+            return {
+                content: uiMessageToProviderContent(message),
+                finishReason: normalizeFinishReason("stop"),
+                usage: {
+                    inputTokens: {
+                        total: undefined,
+                        noCache: undefined,
+                        cacheRead: undefined,
+                        cacheWrite: undefined,
+                    },
+                    outputTokens: {
+                        total: undefined,
+                        text: undefined,
+                        reasoning: undefined,
+                    },
+                },
+                response: {
+                    modelId: model.id,
+                },
+                warnings: [],
+            };
+        },
+        async doStream(options) {
+            const cityStream = await invoker.stream(providerOptionsToInput(options));
+            return {
+                stream: new ReadableStream({
+                    async start(controller) {
+                        const reader = cityStream.getReader();
+                        const state = {
+                            sawStart: false,
+                            sawFinish: false,
+                        };
+                        try {
+                            while (true) {
+                                const { done, value } = await reader.read();
+                                if (done)
+                                    break;
+                                const parts = mapUiChunkToProviderParts(value);
+                                enqueueProviderParts(controller, parts, state);
+                            }
+                            if (!state.sawStart)
+                                controller.enqueue({ type: "stream-start", warnings: [] });
+                            if (!state.sawFinish)
+                                enqueueFinish(controller, "stop");
+                            controller.close();
+                        }
+                        catch (error) {
+                            controller.enqueue({ type: "error", error });
+                            if (!state.sawFinish)
+                                enqueueFinish(controller, "error");
+                            controller.close();
+                        }
+                        finally {
+                            reader.releaseLock();
+                        }
+                    },
+                }),
+                response: {
+                    modelId: model.id,
+                },
+            };
+        },
+    };
+    return languageModel;
+}
+/**
+ * 将 Agent 可接受的模型输入归一为 AI SDK LanguageModel。
+ */
+export function normalizeAgentModel(model) {
+    if (isCityModel(model))
+        return cityModelToLanguageModel(model);
+    return model;
+}
+/**
+ * 从 Agent 模型输入推导展示标签。
+ */
+export function inferAgentModelLabel(model) {
+    if (!model)
+        return undefined;
+    if (isCityModel(model))
+        return model.name || model.id;
+    if (typeof model !== "object")
+        return undefined;
+    const record = model;
+    const candidates = [
+        record.modelId,
+        record.model,
+        record.id,
+        record.name,
+        record.label,
+    ];
+    for (const candidate of candidates) {
+        const label = typeof candidate === "string" ? candidate.trim() : "";
+        if (label)
+            return label;
+    }
+    const constructorName = model.constructor && typeof model.constructor.name === "string"
+        ? model.constructor.name.trim()
+        : "";
+    return constructorName || "configured-model";
+}
+//# sourceMappingURL=CityModelAdapter.js.map

package/bin/model/CityModelAdapter.js.map

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

package/bin/plugin/core/PluginCommandRequest.d.ts

@@ -2,7 +2,7 @@
  * PluginCommandRequest：统一 plugin runtime command 请求解析模块。
  *
  * 关键点（中文）
- * - 统一收口 HTTP / RPC 两种入口的请求体解析。
+ * - 统一收口当前 HTTP 入口的请求体解析。
  * - plugin runtime 远程调用统一走 runtime command 协议，不再让 action 自带 HTTP route。
  * - ActionSchedule 参数（`schedule` / `delay` / `time`）也在这里一次性归一化。
  */

package/bin/plugin/core/PluginCommandRequest.js

@@ -2,7 +2,7 @@
  * PluginCommandRequest：统一 plugin runtime command 请求解析模块。
  *
  * 关键点（中文）
- * - 统一收口 HTTP / RPC 两种入口的请求体解析。
+ * - 统一收口当前 HTTP 入口的请求体解析。
  * - plugin runtime 远程调用统一走 runtime command 协议，不再让 action 自带 HTTP route。
  * - ActionSchedule 参数（`schedule` / `delay` / `time`）也在这里一次性归一化。
  */

package/bin/plugin/core/PluginLocalExecution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginLocalExecution.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginLocalExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACV,MAAM,EACN,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAGlC;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAuBzF;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6B9B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAoDzC"}
+{"version":3,"file":"PluginLocalExecution.d.ts","sourceRoot":"","sources":["../../../src/plugin/core/PluginLocalExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EACV,MAAM,EACN,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAGlC;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAmBzF;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6B9B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB,GAAG,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAoDzC"}

package/bin/plugin/core/PluginLocalExecution.js

@@ -8,7 +8,7 @@
  */
 import path from "node:path";
 import { logger as defaultLogger } from "../../utils/logger/Logger.js";
-import { loadAgentEnvSnapshot, loadDowncityConfig } from "../../config/Config.js";
+import { loadDowncityConfig, resolveAgentEnv } from "../../config/Config.js";
 import { isPluginEnabled } from "../../plugin/core/Activation.js";
 import { findPluginByName } from "../../plugin/core/PluginCatalog.js";
 import { createAgentPathRuntime, createAgentPluginConfigRuntime, } from "../../runtime/host/AgentHostRuntime.js";
@@ -17,12 +17,8 @@ import { createAgentPathRuntime, createAgentPluginConfigRuntime, } from "../../r
  */
 export function createLocalPluginCommandContext(projectRoot) {
     const rootPath = path.resolve(String(projectRoot || "").trim() || ".");
-    const env = loadAgentEnvSnapshot(rootPath);
-    const config = loadDowncityConfig(rootPath, {
-        projectEnv: env,
-        agentEnv: env,
-        globalEnv: {},
-    });
+    const env = resolveAgentEnv(rootPath);
+    const config = loadDowncityConfig(rootPath);
     defaultLogger.bindProjectRoot(rootPath);
     return {
         cwd: rootPath,
@@ -30,7 +26,7 @@ export function createLocalPluginCommandContext(projectRoot) {
         logger: defaultLogger,
         config,
         env,
-        paths: createAgentPathRuntime(rootPath, String(config.name || "").trim() || path.basename(rootPath) || "agent"),
+        paths: createAgentPathRuntime(rootPath, String(config.id || "").trim() || path.basename(rootPath) || "agent"),
         pluginConfig: createAgentPluginConfigRuntime(rootPath),
     };
 }

package/bin/plugin/core/PluginLocalExecution.js.map

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

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

@@ -148,7 +148,7 @@ export interface PluginCliBaseOptions {
      */
     json?: boolean;
     /**
-     * agent 名称（从 managed agent registry 解析到项目路径）。
+     * agent id（从 managed agent registry 解析到项目路径）。
      */
     agent?: string;
 }

package/bin/rpc/Client.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Agent 本机 RPC Client。
+ *
+ * 职责说明（中文）
+ * - 为 `RemoteAgent(rpc://...)` 提供最小客户端实现。
+ * - 复用逐行 JSON（NDJSON）协议，与本机 RPC Server 对接。
+ * - 当前只承载 Session actor 所需方法。
+ */
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentSessionHistoryInput, AgentSessionHistoryPage, AgentSessionInfo, AgentSessionSummaryPage, AgentSessionSystemSnapshot } from "../types/agent/AgentTypes.js";
+import type { AgentSessionEvent } from "../types/sdk/AgentSessionEvent.js";
+import type { AgentSessionPromptInput } from "../types/sdk/AgentSessionPrompt.js";
+/**
+ * RPC endpoint。
+ */
+export interface RpcClientEndpoint {
+    /** RPC host。 */
+    host: string;
+    /** RPC port。 */
+    port: number;
+}
+/**
+ * RPC Session 订阅句柄。
+ */
+export interface RpcSessionSubscription {
+    /** 当前订阅 id。 */
+    subscription_id: string;
+    /** 取消订阅。 */
+    unsubscribe(): Promise<void>;
+}
+/**
+ * RPC Client。
+ */
+export declare class RpcClient {
+    private readonly endpoint;
+    private socket;
+    private connect_promise;
+    private buffered;
+    private readonly pending_requests;
+    private readonly subscriptions;
+    private request_sequence;
+    constructor(endpoint: RpcClientEndpoint);
+    /**
+     * 列出远程 session。
+     */
+    list_sessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+    /**
+     * 创建远程 session。
+     */
+    create_session(input?: AgentCreateSessionInput): Promise<AgentSessionInfo>;
+    /**
+     * 获取远程 session 信息。
+     */
+    get_session(session_id: string): Promise<AgentSessionInfo>;
+    /**
+     * 发送 prompt。
+     */
+    prompt_session(params: {
+        session_id: string;
+        input: AgentSessionPromptInput;
+    }): Promise<{
+        id: string;
+    }>;
+    /**
+     * 读取 history。
+     */
+    get_session_history(params: {
+        session_id: string;
+        input?: AgentSessionHistoryInput;
+    }): Promise<AgentSessionHistoryPage>;
+    /**
+     * 读取 system snapshot。
+     */
+    get_session_system(session_id: string): Promise<AgentSessionSystemSnapshot>;
+    /**
+     * 分叉 session。
+     */
+    fork_session(params: {
+        session_id: string;
+        message_id?: string;
+    }): Promise<AgentSessionInfo>;
+    /**
+     * 订阅 session 事件。
+     */
+    subscribe_session(params: {
+        session_id: string;
+        on_ready: () => void;
+        on_event: (event: AgentSessionEvent) => void;
+    }): Promise<RpcSessionSubscription>;
+    /**
+     * 关闭底层连接。
+     */
+    close(): Promise<void>;
+    private request;
+    private ensure_connected;
+    private consume_data;
+    private consume_line;
+    private fail_all_pending;
+    private fail_all_subscriptions;
+}
+/**
+ * 解析 rpc url。
+ */
+export declare function parse_rpc_url(url_input: string): RpcClientEndpoint;
+//# sourceMappingURL=Client.d.ts.map

package/bin/rpc/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/rpc/Client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AA8FjF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,eAAe;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY;IACZ,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;IACtE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsC;IACpE,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,QAAQ,EAAE,iBAAiB;IAIvC;;OAEG;IACG,aAAa,CACjB,KAAK,CAAC,EAAE,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC;IAQnC;;OAEG;IACG,cAAc,CAClB,KAAK,CAAC,EAAE,uBAAuB,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAQ5B;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUhE;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,uBAAuB,CAAC;KAChC,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAW3B;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE;QAChC,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,wBAAwB,CAAC;KAClC,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAWpC;;OAEG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAUjF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW7B;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC9B,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;KAC9C,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA8BnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAgBd,OAAO;YAiCP,gBAAgB;IAmD9B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,sBAAsB;CAS/B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAiBlE"}