agentplane 0.1.4 → 0.1.6

package/dist/{run-cli.test-helpers.d.ts → cli/run-cli.test-helpers.d.ts}

@@ -6,6 +6,8 @@ export declare function captureStdIO(): {
     readonly stderr: string;
     restore(): void;
 };
+export declare function silenceStdIO(): () => void;
+export declare function runCliSilent(args: string[]): Promise<number>;
 export declare function mkGitRepoRoot(): Promise<string>;
 export declare function mkTempDir(): Promise<string>;
 export declare function writeDefaultConfig(root: string): Promise<void>;
@@ -30,6 +32,10 @@ export declare function createRecipeArchiveWithManifest(opts: {
     format?: "tar" | "zip";
     wrapDir?: boolean;
 }): Promise<string>;
+export declare function createUnsafeRecipeArchive(opts: {
+    format: "tar" | "zip";
+    entryPath?: string;
+}): Promise<string>;
 export declare function createUpgradeBundle(files: Record<string, string>): Promise<{
     bundlePath: string;
     checksumPath: string;

package/dist/cli/run-cli.test-helpers.d.ts.map

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

package/dist/{run-cli.test-helpers.js → cli/run-cli.test-helpers.js}

@@ -6,10 +6,14 @@ import path from "node:path";
 import { promisify } from "node:util";
 import { afterAll, beforeAll } from "vitest";
 import { defaultConfig } from "@agentplaneorg/core";
+import { runCli } from "./run-cli.js";
 const execFileAsync = promisify(execFile);
 let agentplaneHome = null;
 const originalAgentplaneHome = process.env.AGENTPLANE_HOME;
 const originalNoUpdateCheck = process.env.AGENTPLANE_NO_UPDATE_CHECK;
+const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+const originalStderrWrite = process.stderr.write.bind(process.stderr);
+let stdioSilenceDepth = 0;
 const recipeArchiveCache = new Map();
 let gitTemplateRoot = null;
 let gitTemplatePromise = null;
@@ -85,6 +89,34 @@ export function captureStdIO() {
         },
     };
 }
+export function silenceStdIO() {
+    if (stdioSilenceDepth === 0) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        process.stdout.write = () => true;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        process.stderr.write = () => true;
+    }
+    stdioSilenceDepth += 1;
+    return () => {
+        stdioSilenceDepth -= 1;
+        if (stdioSilenceDepth <= 0) {
+            stdioSilenceDepth = 0;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            process.stdout.write = originalStdoutWrite;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            process.stderr.write = originalStderrWrite;
+        }
+    };
+}
+export async function runCliSilent(args) {
+    const io = captureStdIO();
+    try {
+        return await runCli(args);
+    }
+    finally {
+        io.restore();
+    }
+}
 export async function mkGitRepoRoot() {
     const template = await ensureGitTemplateRoot();
     const root = await mkdtemp(path.join(os.tmpdir(), "agentplane-cli-test-"));
@@ -215,6 +247,41 @@ export async function createRecipeArchiveWithManifest(opts) {
     }
     return archivePath;
 }
+export async function createUnsafeRecipeArchive(opts) {
+    const baseDir = await mkdtemp(path.join(os.tmpdir(), "agentplane-recipe-unsafe-"));
+    const recipeDir = path.join(baseDir, "recipe");
+    await mkdir(recipeDir, { recursive: true });
+    const manifest = {
+        schema_version: "1",
+        id: "unsafe",
+        version: "0.0.1",
+        name: "Unsafe",
+        summary: "Unsafe recipe",
+        description: "Used for archive validation tests.",
+        agents: [{ id: "RECIPE_AGENT", summary: "Recipe agent", file: "agents/recipe.json" }],
+        tools: [
+            { id: "RECIPE_TOOL", summary: "Recipe tool", runtime: "bash", entrypoint: "tools/run.sh" },
+        ],
+        scenarios: [{ id: "RECIPE_SCENARIO", summary: "Recipe scenario" }],
+    };
+    await writeFile(path.join(recipeDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
+    const agentsDir = path.join(recipeDir, "agents");
+    await mkdir(agentsDir, { recursive: true });
+    await writeFile(path.join(agentsDir, "recipe.json"), JSON.stringify({ id: "RECIPE_AGENT", role: "Recipe agent" }, null, 2), "utf8");
+    const toolsDir = path.join(recipeDir, "tools");
+    await mkdir(toolsDir, { recursive: true });
+    await writeFile(path.join(toolsDir, "run.sh"), "#!/usr/bin/env bash\n", "utf8");
+    const scenariosDir = path.join(recipeDir, "scenarios");
+    await mkdir(scenariosDir, { recursive: true });
+    await writeFile(path.join(scenariosDir, "recipe-scenario.json"), JSON.stringify({ schema_version: "1", id: "RECIPE_SCENARIO", summary: "Recipe scenario" }, null, 2), "utf8");
+    const entryPath = opts.entryPath ?? "../evil.txt";
+    await writeFile(path.join(baseDir, "evil.txt"), "evil", "utf8");
+    const archivePath = opts.format === "zip" ? path.join(baseDir, "unsafe.zip") : path.join(baseDir, "unsafe.tar.gz");
+    await (opts.format === "zip"
+        ? execFileAsync("zip", ["-qr", archivePath, ".", entryPath], { cwd: recipeDir })
+        : execFileAsync("tar", ["-czf", archivePath, "-C", recipeDir, ".", entryPath]));
+    return archivePath;
+}
 export async function createUpgradeBundle(files) {
     const baseDir = await mkdtemp(path.join(os.tmpdir(), "agentplane-upgrade-bundle-"));
     const bundleDir = path.join(baseDir, "bundle");

package/dist/cli/update-check.d.ts

@@ -0,0 +1,31 @@
+export declare const UPDATE_CHECK_SCHEMA_VERSION: 1;
+export declare const UPDATE_CHECK_TTL_MS: number;
+export declare const UPDATE_CHECK_TIMEOUT_MS = 1500;
+export type UpdateCheckStatus = "ok" | "error" | "not_modified";
+export type UpdateCheckCache = {
+    schema_version: typeof UPDATE_CHECK_SCHEMA_VERSION;
+    checked_at: string;
+    latest_version: string | null;
+    etag: string | null;
+    status: UpdateCheckStatus;
+};
+export type UpdateCheckFetchResult = {
+    status: "ok";
+    latestVersion: string;
+    etag: string | null;
+} | {
+    status: "not_modified";
+    etag: string | null;
+} | {
+    status: "error";
+};
+export declare function resolveUpdateCheckCachePath(agentplaneHome: string): string;
+export declare function shouldCheckNow(checkedAt: string | null | undefined, now: Date, ttlMs: number): boolean;
+export declare function readUpdateCheckCache(filePath: string): Promise<UpdateCheckCache | null>;
+export declare function writeUpdateCheckCache(filePath: string, cache: UpdateCheckCache): Promise<void>;
+export declare function fetchLatestNpmVersion(opts: {
+    url: string;
+    timeoutMs: number;
+    etag?: string | null;
+}): Promise<UpdateCheckFetchResult>;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/cli/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/cli/update-check.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,2BAA2B,EAAG,CAAU,CAAC;AACtD,eAAO,MAAM,mBAAmB,QAAsB,CAAC;AACvD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,OAAO,GAAG,cAAc,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,OAAO,2BAA2B,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAIF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAExB,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,MAAM,GACZ,OAAO,CAKT;AAED,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAU7F;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAsBlC"}

package/dist/cli/update-check.js

@@ -0,0 +1,86 @@
+import { randomBytes } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+export const UPDATE_CHECK_SCHEMA_VERSION = 1;
+export const UPDATE_CHECK_TTL_MS = 24 * 60 * 60 * 1000;
+export const UPDATE_CHECK_TIMEOUT_MS = 1500;
+export function resolveUpdateCheckCachePath(agentplaneHome) {
+    return path.join(agentplaneHome, "cache", "update-check.json");
+}
+export function shouldCheckNow(checkedAt, now, ttlMs) {
+    if (!checkedAt)
+        return true;
+    const timestamp = Date.parse(checkedAt);
+    if (!Number.isFinite(timestamp))
+        return true;
+    return now.getTime() - timestamp >= ttlMs;
+}
+export async function readUpdateCheckCache(filePath) {
+    try {
+        const raw = await readFile(filePath, "utf8");
+        const parsed = JSON.parse(raw);
+        return coerceCache(parsed);
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return null;
+        return null;
+    }
+}
+export async function writeUpdateCheckCache(filePath, cache) {
+    const dir = path.dirname(filePath);
+    await mkdir(dir, { recursive: true });
+    const tmpName = `.update-check.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
+    const tmpPath = path.join(dir, tmpName);
+    const payload = JSON.stringify(cache, null, 2);
+    await writeFile(tmpPath, payload, "utf8");
+    await rename(tmpPath, filePath);
+}
+export async function fetchLatestNpmVersion(opts) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), opts.timeoutMs);
+    try {
+        const headers = { "User-Agent": "agentplane" };
+        if (opts.etag)
+            headers["If-None-Match"] = opts.etag;
+        const res = await fetch(opts.url, { headers, signal: controller.signal });
+        const responseEtag = res.headers.get("etag");
+        const normalizedEtag = responseEtag && responseEtag.trim().length > 0 ? responseEtag : null;
+        if (res.status === 304) {
+            return { status: "not_modified", etag: normalizedEtag ?? opts.etag ?? null };
+        }
+        if (!res.ok)
+            return { status: "error" };
+        const data = (await res.json());
+        const version = typeof data.version === "string" ? data.version.trim() : "";
+        if (!version)
+            return { status: "error" };
+        return { status: "ok", latestVersion: version, etag: normalizedEtag };
+    }
+    catch {
+        return { status: "error" };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function coerceCache(raw) {
+    if (raw.schema_version !== UPDATE_CHECK_SCHEMA_VERSION)
+        return null;
+    const checkedAt = typeof raw.checked_at === "string" ? raw.checked_at : null;
+    if (!checkedAt)
+        return null;
+    const status = raw.status;
+    if (status !== "ok" && status !== "error" && status !== "not_modified")
+        return null;
+    const latestVersion = typeof raw.latest_version === "string" ? raw.latest_version : null;
+    const etag = typeof raw.etag === "string" ? raw.etag : null;
+    return {
+        schema_version: UPDATE_CHECK_SCHEMA_VERSION,
+        checked_at: checkedAt,
+        latest_version: latestVersion,
+        etag,
+        status,
+    };
+}

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { runCli } from "./run-cli.js";
+import { runCli } from "./cli/run-cli.js";
 void runCli(process.argv.slice(2)).then((code) => {
     process.exit(code);
 });

package/dist/commands/backend.d.ts

@@ -0,0 +1,15 @@
+export declare const BACKEND_SYNC_USAGE = "Usage: agentplane backend sync <id> --direction <push|pull> [--conflict <diff|prefer-local|prefer-remote|fail>] [--yes] [--quiet]";
+export declare const BACKEND_SYNC_USAGE_EXAMPLE = "agentplane backend sync local --direction pull";
+export declare const SYNC_USAGE = "Usage: agentplane sync [<id>] [--direction <push|pull>] [--conflict <diff|prefer-local|prefer-remote|fail>] [--yes] [--quiet]";
+export declare const SYNC_USAGE_EXAMPLE = "agentplane sync --direction push --yes";
+export declare function cmdBackendSync(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+export declare function cmdSync(opts: {
+    cwd: string;
+    rootOverride?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=backend.d.ts.map

package/dist/commands/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/commands/backend.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,kBAAkB,sIACsG,CAAC;AACtI,eAAO,MAAM,0BAA0B,mDAAmD,CAAC;AAC3F,eAAO,MAAM,UAAU,kIAC0G,CAAC;AAClI,eAAO,MAAM,kBAAkB,2CAA2C,CAAC;AA8J3E,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgClB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgClB"}

package/dist/commands/backend.js

@@ -0,0 +1,211 @@
+import { backendNotSupportedMessage, usageMessage } from "../cli/output.js";
+import { mapBackendError } from "../cli/error-map.js";
+import { CliError } from "../shared/errors.js";
+import { loadTaskBackend } from "../backends/task-backend.js";
+export const BACKEND_SYNC_USAGE = "Usage: agentplane backend sync <id> --direction <push|pull> [--conflict <diff|prefer-local|prefer-remote|fail>] [--yes] [--quiet]";
+export const BACKEND_SYNC_USAGE_EXAMPLE = "agentplane backend sync local --direction pull";
+export const SYNC_USAGE = "Usage: agentplane sync [<id>] [--direction <push|pull>] [--conflict <diff|prefer-local|prefer-remote|fail>] [--yes] [--quiet]";
+export const SYNC_USAGE_EXAMPLE = "agentplane sync --direction push --yes";
+function parseBackendSyncArgs(args) {
+    let backendId = "";
+    let direction = null;
+    let conflict = "diff";
+    let confirm = false;
+    let quiet = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (!arg.startsWith("--")) {
+            if (backendId) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: usageMessage(BACKEND_SYNC_USAGE, BACKEND_SYNC_USAGE_EXAMPLE),
+                });
+            }
+            backendId = arg;
+            continue;
+        }
+        if (arg === "--direction") {
+            const next = args[i + 1];
+            if (!next || (next !== "push" && next !== "pull")) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: usageMessage(BACKEND_SYNC_USAGE, BACKEND_SYNC_USAGE_EXAMPLE),
+                });
+            }
+            direction = next;
+            i++;
+            continue;
+        }
+        if (arg === "--conflict") {
+            const next = args[i + 1];
+            if (!next || !["diff", "prefer-local", "prefer-remote", "fail"].includes(next)) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: usageMessage(BACKEND_SYNC_USAGE, BACKEND_SYNC_USAGE_EXAMPLE),
+                });
+            }
+            conflict = next;
+            i++;
+            continue;
+        }
+        if (arg === "--yes") {
+            confirm = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            quiet = true;
+            continue;
+        }
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(BACKEND_SYNC_USAGE, BACKEND_SYNC_USAGE_EXAMPLE),
+        });
+    }
+    if (!backendId || !direction) {
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(BACKEND_SYNC_USAGE, BACKEND_SYNC_USAGE_EXAMPLE),
+        });
+    }
+    return { backendId, direction, conflict, confirm, quiet };
+}
+function parseSyncArgs(args) {
+    let backendId = null;
+    let direction = "push";
+    let conflict = "diff";
+    let confirm = false;
+    let quiet = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (!arg.startsWith("--")) {
+            if (backendId) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: usageMessage(SYNC_USAGE, SYNC_USAGE_EXAMPLE),
+                });
+            }
+            backendId = arg;
+            continue;
+        }
+        if (arg === "--direction") {
+            const next = args[i + 1];
+            if (!next || (next !== "push" && next !== "pull")) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: usageMessage(SYNC_USAGE, SYNC_USAGE_EXAMPLE),
+                });
+            }
+            direction = next;
+            i++;
+            continue;
+        }
+        if (arg === "--conflict") {
+            const next = args[i + 1];
+            if (!next || !["diff", "prefer-local", "prefer-remote", "fail"].includes(next)) {
+                throw new CliError({
+                    exitCode: 2,
+                    code: "E_USAGE",
+                    message: usageMessage(SYNC_USAGE, SYNC_USAGE_EXAMPLE),
+                });
+            }
+            conflict = next;
+            i++;
+            continue;
+        }
+        if (arg === "--yes") {
+            confirm = true;
+            continue;
+        }
+        if (arg === "--quiet") {
+            quiet = true;
+            continue;
+        }
+        throw new CliError({
+            exitCode: 2,
+            code: "E_USAGE",
+            message: usageMessage(SYNC_USAGE, SYNC_USAGE_EXAMPLE),
+        });
+    }
+    return { backendId, direction, conflict, confirm, quiet };
+}
+export async function cmdBackendSync(opts) {
+    const flags = parseBackendSyncArgs(opts.args);
+    try {
+        const { backend, backendId } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        if (flags.backendId && backendId && flags.backendId !== backendId) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Configured backend is "${backendId}", not "${flags.backendId}"`,
+            });
+        }
+        if (!backend.sync) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: backendNotSupportedMessage("sync()"),
+            });
+        }
+        await backend.sync({
+            direction: flags.direction,
+            conflict: flags.conflict,
+            quiet: flags.quiet,
+            confirm: flags.confirm,
+        });
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "backend sync", root: opts.rootOverride ?? null });
+    }
+}
+export async function cmdSync(opts) {
+    const flags = parseSyncArgs(opts.args);
+    try {
+        const { backend, backendId } = await loadTaskBackend({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+        });
+        if (flags.backendId && backendId && flags.backendId !== backendId) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: `Configured backend is "${backendId}", not "${flags.backendId}"`,
+            });
+        }
+        if (!backend.sync) {
+            throw new CliError({
+                exitCode: 2,
+                code: "E_USAGE",
+                message: backendNotSupportedMessage("sync()"),
+            });
+        }
+        await backend.sync({
+            direction: flags.direction,
+            conflict: flags.conflict,
+            quiet: flags.quiet,
+            confirm: flags.confirm,
+        });
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, { command: "sync", root: opts.rootOverride ?? null });
+    }
+}

package/dist/commands/recipes.d.ts

@@ -0,0 +1,13 @@
+export declare function cmdRecipes(opts: {
+    cwd: string;
+    rootOverride?: string;
+    command?: string;
+    args: string[];
+}): Promise<number>;
+export declare function cmdScenario(opts: {
+    cwd: string;
+    rootOverride?: string;
+    command?: string;
+    args: string[];
+}): Promise<number>;
+//# sourceMappingURL=recipes.d.ts.map

package/dist/commands/recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../src/commands/recipes.ts"],"names":[],"mappings":"AA2kEA,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwGlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDlB"}