@downcity/city 1.1.4 → 1.1.5

package/bin/cli/service/ServiceCommandRemote.js

@@ -0,0 +1,200 @@
+/**
+ * `city service` 远程 Agent server 调用辅助。
+ *
+ * 关键点（中文）
+ * - 统一处理 list/control/command 三类需要访问 Agent server 的命令。
+ * - 这里不负责命令注册，只负责 transport 调用与结果输出。
+ */
+import { callAgentTransport } from "@downcity/agent";
+import { printResult } from "../../utils/cli/CliOutput.js";
+import { parseCommandPayload, resolveServiceProjectRoot, validateAgentProjectRoot, } from "./ServiceCommandSupport.js";
+const SERVICE_COMMAND_TIMEOUT_MS = 120_000;
+/**
+ * 执行 `service list`。
+ */
+export async function runServiceListCommand(options) {
+    const resolved = await resolveServiceProjectRoot(options);
+    if (!resolved.projectRoot) {
+        printResult({
+            asJson: options.json,
+            success: false,
+            title: "service list failed",
+            payload: {
+                error: resolved.error || "Failed to resolve agent project path",
+            },
+        });
+        return;
+    }
+    const projectRoot = resolved.projectRoot;
+    const pathError = validateAgentProjectRoot(projectRoot);
+    if (pathError) {
+        printResult({
+            asJson: options.json,
+            success: false,
+            title: "service list failed",
+            payload: {
+                error: pathError,
+            },
+        });
+        return;
+    }
+    const remote = await callAgentTransport({
+        projectRoot,
+        path: "/api/services/list",
+        method: "GET",
+        host: options.host,
+        port: options.port,
+        authToken: options.token,
+    });
+    if (remote.success && remote.data) {
+        printResult({
+            asJson: options.json,
+            success: Boolean(remote.data.success),
+            title: remote.data.success ? "services listed" : "service list failed",
+            payload: {
+                ...(Array.isArray(remote.data.services) ? { services: remote.data.services } : {}),
+                ...(remote.data.error ? { error: remote.data.error } : {}),
+            },
+        });
+        return;
+    }
+    printResult({
+        asJson: options.json,
+        success: false,
+        title: "service list failed",
+        payload: {
+            error: remote.error || "Unknown error",
+        },
+    });
+}
+/**
+ * 执行 `service status/start/stop/restart`。
+ */
+export async function runServiceControlCommand(params) {
+    const resolved = await resolveServiceProjectRoot(params.options);
+    if (!resolved.projectRoot) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: `service ${params.action} failed`,
+            payload: {
+                error: resolved.error || "Failed to resolve agent project path",
+            },
+        });
+        return;
+    }
+    const projectRoot = resolved.projectRoot;
+    const pathError = validateAgentProjectRoot(projectRoot);
+    if (pathError) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: `service ${params.action} failed`,
+            payload: {
+                error: pathError,
+            },
+        });
+        return;
+    }
+    const remote = await callAgentTransport({
+        projectRoot,
+        path: "/api/services/control",
+        method: "POST",
+        host: params.options.host,
+        port: params.options.port,
+        authToken: params.options.token,
+        body: {
+            serviceName: params.serviceName,
+            action: params.action,
+        },
+    });
+    if (remote.success && remote.data) {
+        printResult({
+            asJson: params.options.json,
+            success: Boolean(remote.data.success),
+            title: remote.data.success ? `service ${params.action} ok` : `service ${params.action} failed`,
+            payload: {
+                ...(remote.data.service ? { service: remote.data.service } : {}),
+                ...(remote.data.error ? { error: remote.data.error } : {}),
+            },
+        });
+        return;
+    }
+    printResult({
+        asJson: params.options.json,
+        success: false,
+        title: `service ${params.action} failed`,
+        payload: {
+            error: remote.error || "Unknown error",
+        },
+    });
+}
+/**
+ * 执行 `service command` 桥接。
+ */
+export async function runServiceCommandBridge(params) {
+    const resolved = await resolveServiceProjectRoot(params.options);
+    if (!resolved.projectRoot) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service command failed",
+            payload: {
+                error: resolved.error || "Failed to resolve agent project path",
+            },
+        });
+        return;
+    }
+    const projectRoot = resolved.projectRoot;
+    const pathError = validateAgentProjectRoot(projectRoot);
+    if (pathError) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service command failed",
+            payload: {
+                error: pathError,
+            },
+        });
+        return;
+    }
+    const remote = await callAgentTransport({
+        projectRoot,
+        path: "/api/services/command",
+        method: "POST",
+        timeoutMs: SERVICE_COMMAND_TIMEOUT_MS,
+        host: params.options.host,
+        port: params.options.port,
+        authToken: params.options.token,
+        body: {
+            serviceName: params.serviceName,
+            command: params.command,
+            ...(params.payloadRaw !== undefined
+                ? { payload: parseCommandPayload(params.payloadRaw) }
+                : {}),
+        },
+    });
+    if (remote.success && remote.data) {
+        printResult({
+            asJson: params.options.json,
+            success: Boolean(remote.data.success),
+            title: remote.data.success ? "service command ok" : "service command failed",
+            payload: {
+                ...(remote.data.service ? { service: remote.data.service } : {}),
+                ...(remote.data.message ? { message: remote.data.message } : {}),
+                ...(remote.data.data !== undefined ? { data: remote.data.data } : {}),
+                ...(remote.data.error ? { error: remote.data.error } : {}),
+            },
+        });
+        return;
+    }
+    printResult({
+        asJson: params.options.json,
+        success: false,
+        title: "service command failed",
+        payload: {
+            error: remote.error || "Unknown error",
+        },
+    });
+}
+//# sourceMappingURL=ServiceCommandRemote.js.map

package/bin/cli/service/ServiceCommandRemote.js.map

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

package/bin/cli/service/ServiceCommandSupport.d.ts

@@ -0,0 +1,82 @@
+/**
+ * `city service` 命令共享辅助 + Agent 预检。
+ *
+ * 关键点（中文）
+ * - 统一承载 service 命令的参数解析、目标 agent 路径解析与项目目录校验。
+ * - 提供 `checkAgentPreflight` 供 start/restart/status 等命令统一使用。
+ * - 保持 command 注册层只关注命令树，不再直接承载路径解析细节。
+ */
+import type { Command } from "commander";
+import type { JsonValue } from "@downcity/agent";
+import type { ScheduledJobStatus } from "@downcity/agent";
+import type { ServiceCliBaseOptions } from "@downcity/agent";
+export declare function isRegistryEntryRunning(entry: {
+    status?: "running" | "stopped";
+}): boolean;
+/**
+ * Agent 启动前预检选项。
+ */
+export interface AgentPreflightOptions {
+    /** 是否要求 city runtime 已运行。 */
+    requireCityRunning?: boolean;
+}
+/**
+ * Agent 启动前统一预检。
+ *
+ * 关键点（中文）
+ * - 收敛 start/restart/status 等命令的前置校验逻辑。
+ * - 按顺序检查，首个失败即抛 CliError（city running → PROFILE.md → downcity.json → binding）。
+ *
+ * @throws {CliError} 任一校验失败时抛出。
+ */
+export declare function checkAgentPreflight(projectRoot: string, options?: AgentPreflightOptions): Promise<void>;
+/**
+ * 解析正整数参数。
+ */
+export declare function parsePositiveIntOption(value: string, fieldName: string): number;
+/**
+ * 归一化 schedule 状态过滤参数。
+ */
+export declare function normalizeScheduledJobStatus(value: string | undefined): ScheduledJobStatus | undefined;
+/**
+ * 解析项目根目录。
+ */
+export declare function resolveProjectRoot(pathInput?: string): string;
+/**
+ * 通过 agent 名称解析 projectRoot。
+ */
+export declare function resolveProjectRootByAgentName(agentName: string): Promise<{
+    projectRoot?: string;
+    error?: string;
+}>;
+/**
+ * 统一解析 service 命令目标路径（agent 优先于 path）。
+ */
+export declare function resolveServiceProjectRoot(options: ServiceCliBaseOptions): Promise<{
+    projectRoot?: string;
+    error?: string;
+}>;
+/**
+ * 解析 schedule 管理命令目标路径。
+ */
+export declare function resolveScheduleProjectRoot(options: ServiceCliBaseOptions): Promise<{
+    projectRoot?: string;
+    error?: string;
+}>;
+/**
+ * 校验路径是否为有效 agent 项目目录。
+ */
+export declare function validateAgentProjectRoot(projectRoot: string): string | null;
+/**
+ * 解析 service command payload。
+ */
+export declare function parseCommandPayload(raw?: string): JsonValue | undefined;
+/**
+ * 注入 service 目标解析通用选项。
+ */
+export declare function addServiceTargetOptions(command: Command): Command;
+/**
+ * 注入 schedule 管理命令通用选项。
+ */
+export declare function addServiceScheduleOptions(command: Command): Command;
+//# sourceMappingURL=ServiceCommandSupport.d.ts.map

package/bin/cli/service/ServiceCommandSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceCommandSupport.d.ts","sourceRoot":"","sources":["../../../src/cli/service/ServiceCommandSupport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG7D,wBAAgB,sBAAsB,CACpC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,GACxC,OAAO,CAET;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM/E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,kBAAkB,GAAG,SAAS,CAehC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA6BD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAkCD;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAQD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAUvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQjE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAKnE"}

package/bin/cli/service/ServiceCommandSupport.js

@@ -0,0 +1,224 @@
+/**
+ * `city service` 命令共享辅助 + Agent 预检。
+ *
+ * 关键点（中文）
+ * - 统一承载 service 命令的参数解析、目标 agent 路径解析与项目目录校验。
+ * - 提供 `checkAgentPreflight` 供 start/restart/status 等命令统一使用。
+ * - 保持 command 注册层只关注命令树，不再直接承载路径解析细节。
+ */
+import path from "node:path";
+import fs from "node:fs";
+import { getProfileMdPath, getDowncityJsonPath } from "../../config/Paths.js";
+import { listManagedAgentEntries } from "../../process/registry/CityRegistry.js";
+import { isCityRunning } from "../../process/registry/CityRuntime.js";
+import { ensureRuntimeExecutionBindingReady } from "@downcity/agent";
+import { parsePort, resolveAgentName } from "../shared/IndexSupport.js";
+import { CliError } from "../shared/CliError.js";
+import { parseBoolean } from "../shared/IndexSupport.js";
+export function isRegistryEntryRunning(entry) {
+    return entry.status !== "stopped";
+}
+/**
+ * Agent 启动前统一预检。
+ *
+ * 关键点（中文）
+ * - 收敛 start/restart/status 等命令的前置校验逻辑。
+ * - 按顺序检查，首个失败即抛 CliError（city running → PROFILE.md → downcity.json → binding）。
+ *
+ * @throws {CliError} 任一校验失败时抛出。
+ */
+export async function checkAgentPreflight(projectRoot, options) {
+    if (options?.requireCityRunning !== false) {
+        if (!(await isCityRunning())) {
+            throw new CliError({
+                title: "city runtime is not running",
+                fix: "city start",
+            });
+        }
+    }
+    const profilePath = getProfileMdPath(projectRoot);
+    if (!fs.existsSync(profilePath)) {
+        throw new CliError({
+            title: "Project not initialized",
+            note: `PROFILE.md not found at ${projectRoot}`,
+            fix: "city agent create",
+        });
+    }
+    const downcityJsonPath = getDowncityJsonPath(projectRoot);
+    if (!fs.existsSync(downcityJsonPath)) {
+        throw new CliError({
+            title: "downcity.json not found",
+            note: `project: ${projectRoot}`,
+            fix: "city agent create",
+        });
+    }
+    // 关键点（中文）：提前校验 execution binding，避免"启动成功后秒退"。
+    ensureRuntimeExecutionBindingReady(projectRoot);
+}
+/**
+ * 解析正整数参数。
+ */
+export function parsePositiveIntOption(value, fieldName) {
+    const parsed = Number.parseInt(String(value || "").trim(), 10);
+    if (!Number.isFinite(parsed) || Number.isNaN(parsed) || parsed <= 0) {
+        throw new Error(`Invalid ${fieldName}: ${value}`);
+    }
+    return parsed;
+}
+/**
+ * 归一化 schedule 状态过滤参数。
+ */
+export function normalizeScheduledJobStatus(value) {
+    const text = String(value || "").trim().toLowerCase();
+    if (!text)
+        return undefined;
+    if (text === "pending" ||
+        text === "running" ||
+        text === "succeeded" ||
+        text === "failed" ||
+        text === "cancelled") {
+        return text;
+    }
+    throw new Error(`Invalid schedule status: ${value}. Use pending|running|succeeded|failed|cancelled.`);
+}
+/**
+ * 解析项目根目录。
+ */
+export function resolveProjectRoot(pathInput) {
+    const raw = String(pathInput || ".").trim() || ".";
+    // 关键点（中文）：在 agent shell 中，默认 path="." 时优先使用注入的 DC_AGENT_PATH。
+    if (raw === ".") {
+        const envAgentPath = String(process.env.DC_AGENT_PATH || "").trim();
+        if (envAgentPath)
+            return path.resolve(envAgentPath);
+    }
+    return path.resolve(raw);
+}
+/**
+ * 通过 agent 名称解析 projectRoot。
+ */
+export async function resolveProjectRootByAgentName(agentName) {
+    const target = String(agentName || "").trim().toLowerCase();
+    if (!target) {
+        return { error: "--agent requires a non-empty value" };
+    }
+    const entries = await listManagedAgentEntries();
+    const matchedRoots = entries
+        .filter((entry) => isRegistryEntryRunning(entry))
+        .map((entry) => path.resolve(String(entry.projectRoot || "").trim() || "."))
+        .filter((root, index, all) => all.indexOf(root) === index)
+        .filter((root) => {
+        const byDirName = path.basename(root).toLowerCase() === target;
+        const byShipName = resolveAgentName(root).toLowerCase() === target;
+        return byDirName || byShipName;
+    });
+    if (matchedRoots.length === 0) {
+        return {
+            error: `Agent not found in managed agent registry: ${agentName}. Run "city agent list" to inspect names.`,
+        };
+    }
+    if (matchedRoots.length > 1) {
+        return {
+            error: `Agent name is ambiguous: ${agentName}. Matched paths: ${matchedRoots.join(", ")}`,
+        };
+    }
+    return { projectRoot: matchedRoots[0] };
+}
+/**
+ * 统一解析 service 命令目标路径（agent 优先于 path）。
+ */
+export async function resolveServiceProjectRoot(options) {
+    const explicitAgent = String(options.agent || "").trim();
+    if (explicitAgent) {
+        return resolveProjectRootByAgentName(explicitAgent);
+    }
+    const rawPath = String(options.path || ".").trim() || ".";
+    // 关键点（中文）：在 agent shell 中，未显式传 --agent 且 path 走默认值时，
+    // 优先使用注入的 DC_AGENT_NAME 走 registry 解析，确保多 agent 下目标稳定。
+    if (rawPath === ".") {
+        const envAgentName = String(process.env.DC_AGENT_NAME || "").trim();
+        if (envAgentName) {
+            const byName = await resolveProjectRootByAgentName(envAgentName);
+            if (byName.projectRoot) {
+                return byName;
+            }
+        }
+    }
+    const projectRoot = resolveProjectRoot(options.path);
+    const entries = await listManagedAgentEntries();
+    const registered = entries.some((entry) => isRegistryEntryRunning(entry) &&
+        path.resolve(String(entry.projectRoot || "").trim() || ".") === projectRoot);
+    if (!registered) {
+        return {
+            error: `Agent is not registered in managed agent registry: ${projectRoot}. ` +
+                `Run "city agent list" to inspect registered agents.`,
+        };
+    }
+    return { projectRoot };
+}
+/**
+ * 解析 schedule 管理命令目标路径。
+ */
+export async function resolveScheduleProjectRoot(options) {
+    const explicitAgent = String(options.agent || "").trim();
+    if (explicitAgent) {
+        return resolveProjectRootByAgentName(explicitAgent);
+    }
+    return {
+        projectRoot: resolveProjectRoot(options.path),
+    };
+}
+/**
+ * 校验路径是否为有效 agent 项目目录。
+ */
+export function validateAgentProjectRoot(projectRoot) {
+    const missing = [];
+    if (!fs.existsSync(getDowncityJsonPath(projectRoot))) {
+        missing.push("downcity.json");
+    }
+    if (!fs.existsSync(getProfileMdPath(projectRoot))) {
+        missing.push("PROFILE.md");
+    }
+    if (missing.length === 0)
+        return null;
+    return `Invalid agent path: ${projectRoot}. Missing: ${missing.join(", ")}`;
+}
+/**
+ * 解析 service command payload。
+ */
+export function parseCommandPayload(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const text = raw.trim();
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        // 关键点（中文）：payload 不是 JSON 时按字符串透传，避免强制格式。
+        return text;
+    }
+}
+/**
+ * 注入 service 目标解析通用选项。
+ */
+export function addServiceTargetOptions(command) {
+    return command
+        .option("--path <path>", "项目根目录（默认当前目录）", ".")
+        .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+        .option("--host <host>", "Server host（覆盖自动解析）")
+        .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
+        .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean, true);
+}
+/**
+ * 注入 schedule 管理命令通用选项。
+ */
+export function addServiceScheduleOptions(command) {
+    return command
+        .option("--path <path>", "项目根目录（默认当前目录）", ".")
+        .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean, true);
+}
+//# sourceMappingURL=ServiceCommandSupport.js.map

package/bin/cli/service/ServiceCommandSupport.js.map

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

package/bin/cli/service/ServiceScheduleCommand.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `city service schedule` 命令。
+ *
+ * 关键点（中文）
+ * - schedule 管理命令只依赖项目本地 schedule SQLite，不要求 runtime 在线。
+ * - 这里同时承载 schedule 子命令注册与本地存储读写流程。
+ */
+import type { Command } from "commander";
+import type { ServiceCliBaseOptions } from "@downcity/agent";
+/**
+ * 执行 `service schedule list`。
+ */
+export declare function runServiceScheduleListCommand(params: {
+    options: ServiceCliBaseOptions;
+    statusRaw?: string;
+    limitRaw?: string;
+}): Promise<void>;
+/**
+ * 执行 `service schedule info`。
+ */
+export declare function runServiceScheduleInfoCommand(params: {
+    jobId: string;
+    options: ServiceCliBaseOptions;
+}): Promise<void>;
+/**
+ * 执行 `service schedule cancel`。
+ */
+export declare function runServiceScheduleCancelCommand(params: {
+    jobId: string;
+    options: ServiceCliBaseOptions;
+}): Promise<void>;
+/**
+ * 注册 `service schedule` 子命令组。
+ */
+export declare function registerServiceScheduleCommands(service: Command): void;
+//# sourceMappingURL=ServiceScheduleCommand.d.ts.map

package/bin/cli/service/ServiceScheduleCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceScheduleCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/service/ServiceScheduleCommand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAS7D;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,qBAAqB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DhB;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,qBAAqB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEhB;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CAAC,MAAM,EAAE;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,qBAAqB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2FhB;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyCtE"}