pax8-cta 0.1.0

package/dist/commands/resolve-url.js

@@ -0,0 +1,126 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Command } from "commander";
+import { resolve, join } from "node:path";
+import chalk from "chalk";
+import { createSpinner } from "../lib/spinner.js";
+import Table from "cli-table3";
+import { loadConfig, TokenManager, DataverseClient, SolutionOperations, AgentResolver, } from "@pax8-cta/core";
+import { getClientSecretWithFallback } from "../lib/credentials.js";
+import { handleCommandError } from "../lib/errors.js";
+export const resolveUrlCommand = new Command("resolve-url")
+    .description("Find which solution contains a given M365 agent URL")
+    .requiredOption("-u, --url <url>", "M365 agent URL (e.g., https://m365.cloud.microsoft/chat/?titleId=...)")
+    .option("-o, --output <path>", "Output directory for the solution", "./agent packages")
+    .option("-c, --config <path>", "Path to config file", "./config/tenants.yaml")
+    .option("--unmanaged", "Export as unmanaged solution (default: managed)")
+    .option("--list-bots", "List all bots in the environment instead of resolving")
+    .option("--dry-run", "Parse URL and show info without exporting")
+    .action(async (options) => {
+    const spinner = createSpinner("Loading configuration...").start();
+    try {
+        // Load config
+        const configPath = resolve(process.cwd(), options.config);
+        const config = await loadConfig(configPath);
+        spinner.succeed("Configuration loaded");
+        // Authenticate
+        spinner.start("Authenticating...");
+        const clientSecret = await getClientSecretWithFallback();
+        const tokenManager = new TokenManager({
+            tenantId: config.partner.tenantId,
+            clientId: config.partner.clientId,
+            clientSecret,
+        });
+        const dataverseClient = new DataverseClient({
+            environmentUrl: config.source.environmentUrl,
+            tokenManager,
+        });
+        const resolver = new AgentResolver(dataverseClient);
+        spinner.succeed("Connected to source environment");
+        // List bots mode
+        if (options.listBots) {
+            spinner.start("Fetching bots...");
+            const botsWithSolutions = await resolver.listBotsWithSolutions();
+            spinner.succeed(`Found ${botsWithSolutions.length} bot(s)`);
+            console.log();
+            const table = new Table({
+                head: ["Bot Name", "Bot ID", "Solution", "Status", "Modified"],
+                style: { head: ["cyan"] },
+            });
+            for (const { bot, solution } of botsWithSolutions) {
+                table.push([
+                    bot.name || "(unnamed)",
+                    bot.botid.slice(0, 8) + "...",
+                    solution?.uniquename || chalk.gray("(no solution)"),
+                    bot.statecode === 0 ? chalk.green("Active") : chalk.gray("Inactive"),
+                    new Date(bot.modifiedon).toLocaleDateString(),
+                ]);
+            }
+            console.log(table.toString());
+            return;
+        }
+        // Parse URL
+        spinner.start("Parsing agent URL...");
+        const parsed = resolver.parseAgentUrl(options.url);
+        spinner.succeed("URL parsed");
+        console.log();
+        console.log(chalk.bold("Parsed URL Info:"));
+        console.log(`  Title ID:     ${chalk.cyan(parsed.titleId)}`);
+        console.log(`  Prefix:       ${parsed.prefix || "(none)"}`);
+        console.log(`  Possible Bot: ${parsed.possibleBotId || "(not a direct GUID)"}`);
+        console.log();
+        if (options.dryRun) {
+            console.log(chalk.yellow("Dry run - not resolving or exporting"));
+            return;
+        }
+        // Resolve to solution
+        spinner.start("Resolving agent to solution...");
+        const resolved = await resolver.resolveUrlToSolution(options.url);
+        spinner.succeed("Agent resolved");
+        console.log(chalk.bold("Resolved Agent:"));
+        console.log(`  Bot Name:     ${chalk.green(resolved.bot.name)}`);
+        console.log(`  Bot ID:       ${resolved.bot.botid}`);
+        console.log(`  Solution:     ${chalk.cyan(resolved.solution.uniquename)}`);
+        console.log(`  Version:      ${resolved.solution.version}`);
+        console.log(`  Managed:      ${resolved.solution.ismanaged ? "Yes" : "No"}`);
+        console.log();
+        // Export solution
+        const solutionOps = new SolutionOperations(dataverseClient);
+        const managed = !options.unmanaged;
+        const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+        const suffix = managed ? "managed" : "unmanaged";
+        const outputDir = resolve(options.output);
+        const outputPath = join(outputDir, `${resolved.solution.uniquename}_${timestamp}_${suffix}.zip`);
+        spinner.start(`Exporting solution '${resolved.solution.uniquename}'...`);
+        const metadata = await solutionOps.exportSolution(resolved.solution.uniquename, {
+            managed,
+            outputPath,
+        });
+        spinner.succeed(`Solution exported: ${chalk.green(metadata.friendlyName)} v${metadata.version}`);
+        console.log();
+        console.log(chalk.bold("Export Complete:"));
+        console.log(`  Solution:  ${metadata.friendlyName}`);
+        console.log(`  Version:   ${metadata.version}`);
+        console.log(`  Type:      ${managed ? "Managed" : "Unmanaged"}`);
+        console.log(`  Output:    ${chalk.cyan(outputPath)}`);
+        console.log();
+        console.log(chalk.gray(`Use 'deploy <solution> --all' to deploy to your tenants`));
+    }
+    catch (error) {
+        handleCommandError(error, spinner, "URL resolution failed");
+    }
+});
+//# sourceMappingURL=resolve-url.js.map

package/dist/commands/resolve-url.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Command } from "commander";
+export declare const setupCommand: Command;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,eAAO,MAAM,YAAY,SA+MrB,CAAC"}

package/dist/commands/setup.js

@@ -0,0 +1,239 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Command } from "commander";
+import { resolve } from "node:path";
+import chalk from "chalk";
+import { createSpinner } from "../lib/spinner.js";
+import Table from "cli-table3";
+import { loadConfig, TokenManager, DataverseClient, environmentSetupService, } from "@pax8-cta/core";
+import { getClientSecretWithFallback } from "../lib/credentials.js";
+import { UsageError, CliError, handleCommandError } from "../lib/errors.js";
+import { isInteractivePrompt, pickFromList, printRunningCommand } from "../lib/picker.js";
+export const setupCommand = new Command("setup")
+    .description("Register your app as an application user in tenant environments")
+    .option("-c, --config <path>", "Path to config file", "./config/tenants.yaml")
+    .option("--check", "Check setup status without making changes")
+    .option("--all", "Setup all environments")
+    .option("-t, --tenant <name>", "Setup specific environment by name")
+    .addHelpText("after", `
+Examples:
+  setup --check                             Check setup status without making changes
+  setup --all                               Register app user in all environments
+  setup -t Pax8CTA-Test2                  Setup a specific tenant environment
+`)
+    .action(async (options, cmd) => {
+    // Pull global flags (--json, --quiet) so the interactive picker check
+    // doesn't fire when the caller explicitly opted out of prompts.
+    const globalOpts = cmd?.optsWithGlobals?.() ?? {};
+    const interactiveOpts = { json: globalOpts.json, quiet: globalOpts.quiet };
+    const spinner = createSpinner("Loading configuration...").start();
+    try {
+        const configPath = resolve(process.cwd(), options.config);
+        let config;
+        // No selector flag in an interactive terminal? Try to load the config
+        // and offer a picker drawn from the enabled tenants. Scripts (--json,
+        // --quiet, non-TTY) fall through to the existing UsageError below so
+        // they fail fast instead of hanging on stdin.
+        if (!options.check &&
+            !options.all &&
+            !options.tenant &&
+            isInteractivePrompt(interactiveOpts)) {
+            try {
+                config = await loadConfig(configPath);
+                spinner.succeed("Configuration loaded");
+            }
+            catch {
+                // No config available — let validation below produce the friendly
+                // UsageError instead of a config-not-found error.
+                spinner.stop();
+            }
+            if (config) {
+                const enabledTenants = config.tenants.filter((t) => t.enabled);
+                const picked = await pickFromList(enabledTenants, {
+                    prompt: "Pick a tenant to set up:",
+                    label: (t) => t.name,
+                    hint: (t) => (t.tags?.length ? t.tags.join(", ") : undefined),
+                });
+                if (picked) {
+                    options.tenant = picked.name;
+                    printRunningCommand(["setup", "--tenant", picked.name]);
+                }
+            }
+        }
+        // Validate options (after the picker has had a chance to populate them).
+        if (!options.check && !options.all && !options.tenant) {
+            spinner.stop();
+            throw new UsageError("Must specify --check, --all, or --tenant <name>. Run 'setup --help' for usage.");
+        }
+        // Load config if the picker didn't already.
+        if (!config) {
+            config = await loadConfig(configPath);
+            spinner.succeed("Configuration loaded");
+        }
+        // Get target tenants
+        let targets;
+        if (options.all) {
+            targets = config.tenants.filter((t) => t.enabled);
+        }
+        else if (options.tenant) {
+            const tenant = config.tenants.find((t) => t.name.toLowerCase() === options.tenant.toLowerCase());
+            if (!tenant) {
+                spinner.stop();
+                throw new CliError(`Tenant '${options.tenant}' not found in configuration. Run 'tenants list' to see available tenants.`);
+            }
+            targets = [tenant];
+        }
+        else {
+            // Check mode - check all enabled tenants
+            targets = config.tenants.filter((t) => t.enabled);
+        }
+        if (targets.length === 0) {
+            spinner.fail(chalk.red("No environments matched the selection criteria"));
+            process.exit(1);
+        }
+        // Verify client secret is available
+        await getClientSecretWithFallback();
+        console.log();
+        console.log(chalk.bold(`Checking ${targets.length} environment(s)...`));
+        console.log();
+        // Check setup status for each tenant
+        const clientSecret = await getClientSecretWithFallback();
+        const statuses = [];
+        for (const tenant of targets) {
+            const tokenManager = new TokenManager({
+                tenantId: tenant.tenantId,
+                clientId: config.partner.clientId,
+                clientSecret,
+            });
+            const client = new DataverseClient({
+                environmentUrl: tenant.environmentUrl,
+                tokenManager,
+            });
+            const status = await environmentSetupService.checkSetupStatus(client, config.partner.clientId, tenant.name, tenant.environmentUrl);
+            statuses.push(status);
+        }
+        // Display results
+        displaySetupStatus(statuses);
+        // If in check mode, we're done
+        if (options.check) {
+            const needsSetup = statuses.filter((s) => s.status === "needs_setup" || s.status === "partial").length;
+            if (needsSetup > 0) {
+                console.log();
+                console.log(chalk.yellow(`${needsSetup} environment(s) need setup. Run 'setup --all' to configure them.`));
+            }
+            return;
+        }
+        // Setup environments that need it
+        const needsSetup = statuses.filter((s) => s.status === "needs_setup" || s.status === "partial");
+        if (needsSetup.length === 0) {
+            console.log();
+            console.log(chalk.green("All environments are properly configured!"));
+            return;
+        }
+        console.log();
+        console.log(chalk.bold(`Setting up ${needsSetup.length} environment(s)...`));
+        console.log();
+        let successCount = 0;
+        let errorCount = 0;
+        for (const status of needsSetup) {
+            const tenant = targets.find((t) => t.name === status.tenantName);
+            if (!tenant)
+                continue;
+            const setupSpinner = createSpinner(`Setting up ${status.tenantName}...`).start();
+            try {
+                const tokenManager = new TokenManager({
+                    tenantId: tenant.tenantId,
+                    clientId: config.partner.clientId,
+                    clientSecret,
+                });
+                const client = new DataverseClient({
+                    environmentUrl: tenant.environmentUrl,
+                    tokenManager,
+                });
+                await environmentSetupService.setupTenant(client, config.partner.clientId, tenant.environmentUrl, status);
+                setupSpinner.succeed(chalk.green(`Setup completed: ${status.tenantName}`));
+                successCount++;
+            }
+            catch (error) {
+                setupSpinner.fail(chalk.red(`Setup failed: ${status.tenantName}`));
+                console.error(chalk.red(`  Error: ${error instanceof Error ? error.message : String(error)}`));
+                errorCount++;
+            }
+        }
+        console.log();
+        console.log(chalk.bold("Setup Summary:"));
+        console.log(`  ${chalk.green(`✓ ${successCount} successful`)}`);
+        if (errorCount > 0) {
+            console.log(`  ${chalk.red(`✗ ${errorCount} failed`)}`);
+        }
+    }
+    catch (error) {
+        handleCommandError(error, spinner, "Setup failed");
+    }
+});
+/**
+ * Display setup status in a table
+ */
+function displaySetupStatus(statuses) {
+    const table = new Table({
+        head: ["Environment", "App Registered", "Role", "Status"],
+        style: { head: ["cyan"] },
+    });
+    for (const status of statuses) {
+        const appRegistered = status.appRegistered ? chalk.green("✓") : chalk.red("✗");
+        const roleAssigned = status.roleAssigned
+            ? chalk.green("System Admin")
+            : status.appRegistered
+                ? chalk.yellow("None")
+                : chalk.gray("-");
+        let statusText;
+        if (status.status === "ready") {
+            statusText = chalk.green("Ready");
+        }
+        else if (status.status === "needs_setup") {
+            statusText = chalk.yellow("Needs setup");
+        }
+        else if (status.status === "partial") {
+            statusText = chalk.yellow("Needs role");
+        }
+        else {
+            statusText = chalk.red("Error");
+        }
+        const row = [status.tenantName, appRegistered, roleAssigned, statusText];
+        table.push(row);
+    }
+    console.log(table.toString());
+    // Show errors if any
+    const errors = statuses.filter((s) => s.error);
+    if (errors.length > 0) {
+        console.log();
+        console.log(chalk.bold("Notes:"));
+        for (const status of errors) {
+            console.log(chalk.yellow(`  ${status.tenantName}: ${status.error}`));
+        }
+    }
+    // Show bootstrap message if needed
+    const needsBootstrap = statuses.filter((s) => s.status === "needs_setup" && s.error?.includes("bootstrap"));
+    if (needsBootstrap.length > 0) {
+        console.log();
+        console.log(chalk.bold("Bootstrap Required:"));
+        console.log(chalk.gray("  Some environments require manual app user setup first (one-time bootstrap)."));
+        console.log(chalk.gray("  Go to: https://admin.powerplatform.microsoft.com"));
+        console.log(chalk.gray("  → Environment → Settings → Users + permissions → Application users"));
+        console.log(chalk.gray(`  → Add app: ${statuses[0]?.environmentUrl ? "your app ID" : ""}`));
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/commands/solutions/drift-analysis.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { FleetDriftAnalysis, TenantConfig, TenantDeploymentHistory, TenantDriftAnalysis, TenantVersionStatus, VersionChecker, VersionDriftSummary } from "@pax8-cta/core";
+import type { UnmanagedCustomizationResult } from "@pax8-cta/core";
+/**
+ * The set of tenants in a fleet drift analysis that are "outdated" — i.e. the
+ * report's actionable rows. We treat anything that isn't `current` as
+ * outdated; this matches what the table-mode renderer surfaces and what
+ * `--fix` would touch.
+ */
+export declare function selectOutdated(fleet: FleetDriftAnalysis): TenantDriftAnalysis[];
+/**
+ * Build the after-action hint shown beneath the drift table.
+ *
+ * Mirrors the analyze → test-deploy nudge: a one-paragraph "what should I do
+ * about this?" string driven by the result shape. Returns an empty string
+ * when there is nothing to suggest, so the caller can `if (hint) console.log`.
+ *
+ * Pure / side-effect-free so the unit tests can pin the wording without
+ * shelling out.
+ *
+ * @param solutionLabel  The solution name to interpolate into per-tenant
+ *                       suggestions. When the drift run wasn't scoped to a
+ *                       single solution we fall back to `<solution>` so the
+ *                       user knows to substitute.
+ */
+export declare function buildAfterActionHint(outdated: TenantDriftAnalysis[], solutionLabel?: string): string;
+export declare function displayTenantStatus(status: TenantVersionStatus): void;
+export declare function buildSummary(statuses: TenantVersionStatus[], expectedSolutions: Array<{
+    uniqueName: string;
+    friendlyName: string;
+    version: string;
+}>): VersionDriftSummary;
+export declare function displayTenantRiskAnalysis(analysis: TenantDriftAnalysis): void;
+export declare function displayFleetRiskAnalysis(fleet: FleetDriftAnalysis, riskFilter?: string | true): void;
+export declare function generateDemoDeployHistory(tenantId: string): TenantDeploymentHistory;
+export declare function displayFleetSummary(summary: VersionDriftSummary, options: {
+    agent?: string;
+    outdated?: boolean;
+}, tenants: TenantConfig[], statuses: TenantVersionStatus[], _checker: VersionChecker, _expectedSolutions: Array<{
+    uniqueName: string;
+    friendlyName: string;
+    version: string;
+}>): void;
+/**
+ * Display unmanaged customization details for a single tenant
+ */
+export declare function displayCustomizationDetails(result: UnmanagedCustomizationResult): void;
+/**
+ * Display fleet-wide unmanaged customization summary
+ */
+export declare function displayCustomizationFleetSummary(summary: {
+    totalTenants: number;
+    tenantsWithCustomizations: number;
+    tenantsClean: number;
+    totalCustomizations: number;
+    highRiskTenants: string[];
+    results: UnmanagedCustomizationResult[];
+}): void;
+//# sourceMappingURL=drift-analysis.d.ts.map

package/dist/commands/solutions/drift-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-analysis.d.ts","sourceRoot":"","sources":["../../../src/commands/solutions/drift-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAEV,kBAAkB,EAElB,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAGnE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,EAAE,CAE/E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,aAAa,GAAE,MAAqB,GACnC,MAAM,CAyBR;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAmCrE;AAiBD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,iBAAiB,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACtF,mBAAmB,CAsCrB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAsD7E;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,kBAAkB,EACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,IAAI,CAiEN;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAuCnF;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAC/C,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,QAAQ,EAAE,cAAc,EACxB,kBAAkB,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACvF,IAAI,CAqEN;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CA+CtF;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB,EAAE,MAAM,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,4BAA4B,EAAE,CAAC;CACzC,GAAG,IAAI,CA4CP"}