@downcity/plugins 1.0.56 → 1.0.57

package/src/web/runtime/Install.ts

@@ -0,0 +1,241 @@
+/**
+ * WebPlugin 安装器。
+ *
+ * 关键点（中文）
+ * - install 只负责准备联网相关 skill / CLI 依赖，不写 provider 配置。
+ * - skill 安装复用 SkillPlugin 的 `npx skills` 通道，避免 web 自建 registry。
+ * - agent-browser 额外准备 npm CLI 包，因为其 skill 需要 `agent-browser` 命令可用。
+ */
+
+import { execa } from "execa";
+import fs from "node:fs";
+import path from "node:path";
+import type {
+  JsonObject,
+  JsonValue,
+} from "@downcity/agent/internal/types/common/Json.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import { skillInstallCommand } from "@/skill/Command.js";
+import type {
+  WebPluginInstallPayload,
+  WebPluginInstallScope,
+  WebPluginInstallTarget,
+} from "@/web/types/WebPlugin.js";
+
+/**
+ * 单个安装步骤结果。
+ */
+interface WebPluginInstallStep {
+  /**
+   * 步骤名称。
+   */
+  name: string;
+  /**
+   * 步骤是否成功。
+   */
+  success: boolean;
+  /**
+   * 人类可读说明。
+   */
+  message: string;
+}
+
+/**
+ * 读取字符串字段。
+ */
+function read_string(value: JsonValue | undefined): string | undefined {
+  if (typeof value !== "string") return undefined;
+  const trimmed = value.trim();
+  return trimmed || undefined;
+}
+
+/**
+ * 读取布尔字段。
+ */
+function read_boolean(value: JsonValue | undefined): boolean | undefined {
+  return typeof value === "boolean" ? value : undefined;
+}
+
+/**
+ * 归一化安装目标。
+ */
+function resolve_install_target(value: JsonValue | undefined): WebPluginInstallTarget {
+  const target = read_string(value);
+  if (target === "web-access" || target === "agent-browser" || target === "all") {
+    return target;
+  }
+  return "web-access";
+}
+
+/**
+ * 归一化安装作用域。
+ */
+function resolve_install_scope(value: JsonValue | undefined): WebPluginInstallScope {
+  const scope = read_string(value);
+  return scope === "project" ? "project" : "user";
+}
+
+/**
+ * 判断命令是否已经可用。
+ */
+async function command_exists(command: string): Promise<boolean> {
+  try {
+    const result = await execa(command, ["--help"], {
+      reject: false,
+      timeout: 15_000,
+    });
+    return (result.exitCode ?? 1) === 0;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 执行 npm 包安装。
+ */
+async function install_npm_package(params: {
+  root_path: string;
+  package_name: string;
+  scope: WebPluginInstallScope;
+}): Promise<void> {
+  if (params.scope === "project") {
+    const package_manager = resolve_project_package_manager(params.root_path);
+    const args =
+      package_manager === "pnpm"
+        ? ["add", "-D", params.package_name]
+        : package_manager === "yarn"
+          ? ["add", "-D", params.package_name]
+          : ["install", "--save-dev", params.package_name];
+    await execa(package_manager, args, {
+      cwd: params.root_path,
+      stdio: "inherit",
+    });
+    return;
+  }
+
+  await execa("npm", ["install", "-g", params.package_name], {
+    stdio: "inherit",
+  });
+}
+
+/**
+ * 根据锁文件推断项目包管理器。
+ */
+function resolve_project_package_manager(root_path: string): "pnpm" | "yarn" | "npm" {
+  if (fs.existsSync(path.join(root_path, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs.existsSync(path.join(root_path, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+
+/**
+ * 将步骤列表转成 JSON。
+ */
+function serialize_steps(steps: WebPluginInstallStep[]): JsonValue[] {
+  return steps.map((step) => ({
+    name: step.name,
+    success: step.success,
+    message: step.message,
+  }));
+}
+
+/**
+ * 安装 skill。
+ */
+async function install_skill(params: {
+  spec: string;
+  scope: WebPluginInstallScope;
+  yes: boolean;
+  agent: string;
+  steps: WebPluginInstallStep[];
+}): Promise<void> {
+  await skillInstallCommand(params.spec, {
+    global: params.scope === "user",
+    yes: params.yes,
+    agent: params.agent,
+  });
+  params.steps.push({
+    name: `${params.spec}:skill`,
+    success: true,
+    message:
+      params.scope === "user"
+        ? `Installed ${params.spec} skill in user scope.`
+        : `Installed ${params.spec} skill in project scope.`,
+  });
+}
+
+/**
+ * 准备 agent-browser CLI。
+ */
+async function install_agent_browser_cli(params: {
+  context: AgentContext;
+  scope: WebPluginInstallScope;
+  steps: WebPluginInstallStep[];
+}): Promise<void> {
+  if (await command_exists("agent-browser")) {
+    params.steps.push({
+      name: "agent-browser:cli",
+      success: true,
+      message: "agent-browser CLI is already available.",
+    });
+    return;
+  }
+
+  await install_npm_package({
+    root_path: params.context.rootPath,
+    package_name: "agent-browser",
+    scope: params.scope,
+  });
+
+  params.steps.push({
+    name: "agent-browser:cli",
+    success: true,
+    message:
+      params.scope === "user"
+        ? "Installed agent-browser CLI globally with npm."
+        : "Installed agent-browser as a project devDependency.",
+  });
+}
+
+/**
+ * 执行 WebPlugin install action。
+ */
+export async function installWebPluginTargets(params: {
+  context: AgentContext;
+  payload?: WebPluginInstallPayload | null;
+}): Promise<JsonObject> {
+  const payload = params.payload || {};
+  const target = resolve_install_target(payload.target);
+  const scope = resolve_install_scope(payload.scope);
+  const yes = read_boolean(payload.yes) ?? true;
+  const agent = read_string(payload.agent) || "claude-code";
+  const targets =
+    target === "all" ? (["web-access", "agent-browser"] as const) : ([target] as const);
+  const steps: WebPluginInstallStep[] = [];
+
+  for (const item of targets) {
+    await install_skill({
+      spec: item,
+      scope,
+      yes,
+      agent,
+      steps,
+    });
+
+    if (item === "agent-browser") {
+      await install_agent_browser_cli({
+        context: params.context,
+        scope,
+        steps,
+      });
+    }
+  }
+
+  return {
+    target,
+    scope,
+    agent,
+    steps: serialize_steps(steps),
+    nextAction:
+      "Use SkillPlugin lookup/list to inspect installed skills, then let the agent choose the concrete web path during task execution.",
+  };
+}

package/src/web/types/WebPlugin.ts

@@ -1,141 +1,65 @@
 /**
- * Web Plugin 协议类型。
+ * WebPlugin 协议类型。
  *
  * 关键点（中文）
- * - `web` plugin 只负责选择 provider、管理少量配置，并注入对应项目的提示词。
- * - 联网能力本身由外部实现承担：`web-access` 或 `agent-browser`。
+ * - web plugin 只注入联网方法论，不维护 provider 运行态。
+ * - install action 仅用于准备联网相关 skill 与工具依赖。
+ * - target 表示要准备的联网能力，不表示 agent 运行时默认选择。
  */
 
 import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
 
 /**
- * Web plugin 默认依赖仓库地址。
+ * WebPlugin 可安装目标。
  */
-export const WEB_PLUGIN_DEFAULT_REPOSITORY_URL =
-  "https://github.com/eze-is/web-access";
+export type WebPluginInstallTarget = "web-access" | "agent-browser" | "all";
 
 /**
- * Web plugin provider。
- */
-export type WebPluginProvider = "web-access" | "agent-browser";
-
-/**
- * Web plugin 安装作用域。
+ * WebPlugin 安装作用域。
  */
 export type WebPluginInstallScope = "user" | "project";
 
 /**
- * Web plugin 配置。
- */
-export interface WebPluginConfig {
-  /**
-   * 兼容统一结构化配置约束的索引签名。
-   */
-  [key: string]: JsonValue | undefined;
-  /**
-   * 当前使用的 provider。
-   */
-  provider?: WebPluginProvider;
-  /**
-   * 是否向 agent 注入 provider 提示词。
-   */
-  injectPrompt?: boolean;
-  /**
-   * provider 来源仓库地址。
-   */
-  repositoryUrl?: string;
-  /**
-   * provider 版本标签或备注。
-   */
-  sourceVersion?: string;
-  /**
-   * agent-browser 命令名（可选）。
-   */
-  browserCommand?: string;
-  /**
-   * skill 安装作用域。
-   */
-  installScope?: WebPluginInstallScope;
-}
-
-/**
- * 归一化后的 web plugin 配置。
- */
-export interface ResolvedWebPluginConfig {
-  /**
-   * 当前 provider。
-   */
-  provider: WebPluginProvider;
-  /**
-   * 是否注入 prompt。
-   */
-  injectPrompt: boolean;
-  /**
-   * 仓库地址。
-   */
-  repositoryUrl: string;
-  /**
-   * provider 版本标签（可选）。
-   */
-  sourceVersion?: string;
-  /**
-   * 浏览器命令。
-   */
-  browserCommand: string;
-  /**
-   * skill 安装作用域。
-   */
-  installScope: WebPluginInstallScope;
-}
-
-/**
- * web plugin setup/install 输入。
+ * WebPlugin install action 输入。
  */
-export interface WebPluginInstallInput {
-  /**
-   * provider。
-   */
-  provider?: WebPluginProvider;
+export interface WebPluginInstallPayload {
   /**
-   * 是否注入 prompt。
+   * 要准备的联网能力。
+   *
+   * 说明（中文）
+   * - `web-access`：安装 web-access skill。
+   * - `agent-browser`：安装 agent-browser skill，并准备 agent-browser CLI 包。
+   * - `all`：同时准备以上能力。
+   * - 默认值为 `web-access`，避免默认安装额外 CLI。
    */
-  injectPrompt?: boolean;
+  target?: WebPluginInstallTarget;
   /**
-   * 来源仓库地址。
+   * 安装作用域。
+   *
+   * 说明（中文）
+   * - `user`：安装到用户级 skill / npm 全局环境。
+   * - `project`：安装到当前项目级 skill / devDependency。
+   * - 默认值为 `user`，避免默认修改项目依赖。
    */
-  repositoryUrl?: string;
+  scope?: WebPluginInstallScope;
   /**
-   * 版本标签。
+   * 是否跳过安装确认。
+   *
+   * 说明（中文）
+   * - 会透传给底层 skill installer。
+   * - 默认值为 `true`，适合 agent 自动执行。
    */
-  sourceVersion?: string;
+  yes?: boolean;
   /**
-   * 浏览器命令（可选）。
+   * skill installer 的目标 agent 名称。
+   *
+   * 说明（中文）
+   * - 默认使用 `claude-code`，与现有 SkillPlugin 安装行为保持一致。
    */
-  browserCommand?: string;
+  agent?: string;
   /**
-   * 安装作用域（可选）。
+   * 允许保留额外 JSON 字段，便于未来扩展安装器参数。
    */
-  installScope?: WebPluginInstallScope;
+  [key: string]: JsonValue | undefined;
 }
 
-/**
- * web plugin 依赖检查结果。
- */
-export interface WebPluginDependencyCheckResult {
-  /**
-   * 当前 provider 是否可用。
-   */
-  available: boolean;
-  /**
-   * 当前 provider 是否已就绪。
-   */
-  installed: boolean;
-  /**
-   * 不可用原因列表。
-   */
-  reasons: string[];
-  /**
-   * 结构化详情（可选）。
-   */
-  details?: JsonValue;
-}

package/bin/asr/Config.d.ts

@@ -1,43 +0,0 @@
-/**
- * ASR plugin 配置读写工具。
- *
- * 关键点（中文）
- * - 行为配置与转写依赖配置统一收敛到 `plugins.asr`。
- * - 写入前将输入规范化为 JSON object，避免 undefined 进入项目配置。
- */
-import type { VoicePluginConfig } from "../voice/types/VoicePlugin.js";
-import type { AgentPluginConfigRuntime } from "@downcity/agent/internal/types/agent/AgentRuntimeAssembly.js";
-import type { JsonObject, JsonValue } from "@downcity/agent/internal/types/common/Json.js";
-/**
- * 将普通对象转为可持久化 JSON object。
- */
-export declare function toJsonObject(input: Record<string, unknown> | null | undefined): JsonObject | null;
-/**
- * 读取字符串选项。
- */
-export declare function getStringOpt(opts: Record<string, JsonValue>, key: string): string | undefined;
-/**
- * 读取布尔选项。
- */
-export declare function getBooleanOpt(opts: Record<string, JsonValue>, key: string, defaultValue: boolean): boolean;
-/**
- * 读取 ASR Plugin 配置。
- */
-export declare function readVoicePluginConfig(runtime: {
-    config: {
-        plugins?: Record<string, unknown>;
-    };
-}): VoicePluginConfig;
-/**
- * 写入完整 ASR plugin 配置。
- */
-export declare function writeVoicePluginConfig(params: {
-    agentState: {
-        config: {
-            plugins?: Record<string, unknown>;
-        };
-        pluginConfig: AgentPluginConfigRuntime;
-    };
-    value: VoicePluginConfig;
-}): Promise<void>;
-//# sourceMappingURL=Config.d.ts.map

package/bin/asr/Config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/asr/Config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8DAA8D,CAAC;AAC7G,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE3F;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAChD,UAAU,GAAG,IAAI,CAyBnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAKpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,OAAO,GACpB,OAAO,CAST;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH,GAAG,iBAAiB,CA8BpB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,UAAU,EAAE;QACV,MAAM,EAAE;YACN,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACnC,CAAC;QACF,YAAY,EAAE,wBAAwB,CAAC;KACxC,CAAC;IACF,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB"}

package/bin/asr/Config.js

@@ -1,107 +0,0 @@
-/**
- * ASR plugin 配置读写工具。
- *
- * 关键点（中文）
- * - 行为配置与转写依赖配置统一收敛到 `plugins.asr`。
- * - 写入前将输入规范化为 JSON object，避免 undefined 进入项目配置。
- */
-/**
- * 将普通对象转为可持久化 JSON object。
- */
-export function toJsonObject(input) {
-    if (!input)
-        return null;
-    const out = {};
-    for (const [key, value] of Object.entries(input)) {
-        if (value === undefined)
-            continue;
-        if (value === null ||
-            typeof value === "string" ||
-            typeof value === "number" ||
-            typeof value === "boolean") {
-            out[key] = value;
-            continue;
-        }
-        if (Array.isArray(value)) {
-            out[key] = value
-                .filter((item) => item !== undefined)
-                .map((item) => item);
-            continue;
-        }
-        if (typeof value === "object") {
-            out[key] = toJsonObject(value) || {};
-        }
-    }
-    return out;
-}
-/**
- * 读取字符串选项。
- */
-export function getStringOpt(opts, key) {
-    const value = opts[key];
-    if (typeof value !== "string")
-        return undefined;
-    const trimmed = value.trim();
-    return trimmed || undefined;
-}
-/**
- * 读取布尔选项。
- */
-export function getBooleanOpt(opts, key, defaultValue) {
-    const value = opts[key];
-    if (typeof value === "boolean")
-        return value;
-    if (typeof value === "string") {
-        const normalized = value.trim().toLowerCase();
-        if (["1", "true", "yes", "y", "on"].includes(normalized))
-            return true;
-        if (["0", "false", "no", "n", "off"].includes(normalized))
-            return false;
-    }
-    return defaultValue;
-}
-/**
- * 读取 ASR Plugin 配置。
- */
-export function readVoicePluginConfig(runtime) {
-    const current = runtime.config.plugins?.asr;
-    const normalized = current && typeof current === "object" && !Array.isArray(current)
-        ? current
-        : {};
-    return {
-        injectPrompt: typeof normalized.injectPrompt === "boolean"
-            ? normalized.injectPrompt
-            : true,
-        augmentMessage: typeof normalized.augmentMessage === "boolean"
-            ? normalized.augmentMessage
-            : true,
-        provider: normalized.provider === "command" || normalized.provider === "local"
-            ? normalized.provider
-            : "local",
-        ...(typeof normalized.modelId === "string" ? { modelId: normalized.modelId } : {}),
-        ...(typeof normalized.modelsDir === "string" ? { modelsDir: normalized.modelsDir } : {}),
-        ...(typeof normalized.pythonBin === "string" ? { pythonBin: normalized.pythonBin } : {}),
-        ...(typeof normalized.command === "string" ? { command: normalized.command } : {}),
-        ...(typeof normalized.language === "string" ? { language: normalized.language } : {}),
-        ...(typeof normalized.timeoutMs === "number" ? { timeoutMs: normalized.timeoutMs } : {}),
-        ...(typeof normalized.strategy === "string" ? { strategy: normalized.strategy } : {}),
-        ...(Array.isArray(normalized.installedModels)
-            ? { installedModels: normalized.installedModels }
-            : {}),
-    };
-}
-/**
- * 写入完整 ASR plugin 配置。
- */
-export async function writeVoicePluginConfig(params) {
-    if (!params.agentState.config.plugins) {
-        params.agentState.config.plugins = {};
-    }
-    const next = {
-        ...params.value,
-    };
-    delete next.enabled;
-    params.agentState.config.plugins.asr = (toJsonObject(next) || {});
-    await params.agentState.pluginConfig.persistProjectPlugins(params.agentState.config.plugins);
-}
-//# sourceMappingURL=Config.js.map

package/bin/asr/Config.js.map

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

package/bin/asr/Dependency.d.ts

@@ -1,77 +0,0 @@
-/**
- * ASR Plugin Dependency Helper。
- *
- * 关键点（中文）
- * - ASR 的转写依赖现在内聚在 plugin 内部，不再暴露独立依赖端口心智。
- * - 这里统一管理检查、安装、配置读写与转写句柄解析。
- */
-import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
-import type { PluginCommandContext } from "@downcity/agent/internal/plugin/types/Plugin.js";
-import type { VoicePluginConfig, VoiceTranscriberConfig, VoiceTranscriberInstallInput, VoiceTranscriberHandle } from "../voice/types/VoicePlugin.js";
-export interface VoiceDependencyCheckResult {
-    /**
-     * 当前依赖是否可用。
-     */
-    available: boolean;
-    /**
-     * 不可用原因列表。
-     */
-    reasons: string[];
-    /**
-     * 结构化附加数据（可选）。
-     */
-    details?: JsonValue;
-}
-export interface VoiceDependencyInstallResult {
-    /**
-     * 安装是否成功。
-     */
-    success: boolean;
-    /**
-     * 人类可读消息（可选）。
-     */
-    message?: string;
-    /**
-     * 结构化附加数据（可选）。
-     */
-    details?: JsonValue;
-}
-/**
- * 读取 ASR 转写依赖配置。
- */
-export declare function readVoiceTranscriberConfig(context: PluginCommandContext): VoiceTranscriberConfig;
-/**
- * 写入 ASR 转写依赖配置。
- */
-export declare function writeVoiceTranscriberConfig(params: {
-    context: PluginCommandContext;
-    value: Partial<VoiceTranscriberConfig>;
-}): Promise<VoicePluginConfig>;
-/**
- * 检查 ASR 转写依赖可用性。
- */
-export declare function checkVoiceTranscriber(context: PluginCommandContext): Promise<VoiceDependencyCheckResult>;
-/**
- * 安装或修复 ASR 转写依赖。
- */
-export declare function installVoiceTranscriber(params: {
-    context: PluginCommandContext;
-    input?: VoiceTranscriberInstallInput;
-}): Promise<VoiceDependencyInstallResult>;
-/**
- * 解析 ASR 转写句柄。
- */
-export declare function resolveVoiceTranscriber(context: PluginCommandContext): Promise<VoiceTranscriberHandle>;
-/**
- * 执行一次 ASR 转写。
- */
-export declare function transcribeWithVoiceDependency(params: {
-    context: PluginCommandContext;
-    audioPath: string;
-    language?: string;
-}): Promise<{
-    success: boolean;
-    text?: string;
-    error?: string;
-}>;
-//# sourceMappingURL=Dependency.d.ts.map

package/bin/asr/Dependency.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Dependency.d.ts","sourceRoot":"","sources":["../../src/asr/Dependency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AAoBtC,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAqCD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,oBAAoB,GAC5B,sBAAsB,CAUxB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACxC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAe7B;AA4CD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,0BAA0B,CAAC,CAUrC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,CAAC,EAAE,4BAA4B,CAAC;CACtC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAqFxC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAqBjC;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAM/D"}