lobstercage-cli 0.1.0

package/dist/lib/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../src/lib/docker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,QAAQ,EAAE,MAAM,UAAU,CAAC;AAS3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA4CD;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDzF;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAMjD;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAazD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3D;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7D;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAyB7F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/lib/docker.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Local Docker Engine for cage management
+ *
+ * Implements cage operations using Docker instead of the remote API.
+ * Used when --local flag is set or no API is configured.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deployCage = deployCage;
+exports.listCages = listCages;
+exports.getCage = getCage;
+exports.startCage = startCage;
+exports.stopCage = stopCage;
+exports.destroyCage = destroyCage;
+exports.getCageLogs = getCageLogs;
+exports.getContainerName = getContainerName;
+const dockerode_1 = __importDefault(require("dockerode"));
+const crypto_1 = require("crypto");
+const docker = new dockerode_1.default();
+const LABEL_PREFIX = 'lobstercage';
+const CONTAINER_PREFIX = 'lobster-';
+const DEFAULT_IMAGE = 'lobstercage/sandbox:latest';
+const WORKSPACE_MOUNT = '/home/agent/workspace';
+function containerName(name) {
+    return `${CONTAINER_PREFIX}${name}`;
+}
+function generateCageId() {
+    return `cage_local_${(0, crypto_1.randomBytes)(8).toString('hex')}`;
+}
+function containerToCage(container) {
+    const labels = container.Labels;
+    const name = labels[`${LABEL_PREFIX}.cage-name`] || container.Names[0]?.replace(/^\/lobster-/, '') || 'unknown';
+    const cageId = labels[`${LABEL_PREFIX}.cage-id`] || 'unknown';
+    let status;
+    const state = container.State;
+    if (state === 'running') {
+        status = 'running';
+    }
+    else if (state === 'exited' || state === 'dead') {
+        status = 'stopped';
+    }
+    else if (state === 'created' || state === 'restarting') {
+        status = 'pending';
+    }
+    else {
+        status = 'stopped';
+    }
+    return {
+        id: cageId,
+        name,
+        status,
+        image: container.Image,
+        resources: {
+            cpu: 1024,
+            memory: 2048,
+            storage: 20,
+        },
+        network: {
+            egressPolicy: 'allow-all',
+        },
+        createdAt: new Date(container.Created * 1000).toISOString(),
+    };
+}
+/**
+ * Deploy a new cage as a local Docker container
+ */
+async function deployCage(name, options = {}) {
+    const cageId = generateCageId();
+    const cName = containerName(name);
+    // Determine image
+    let image = DEFAULT_IMAGE;
+    if (options.template) {
+        image = `lobstercage/sandbox:${options.template}`;
+    }
+    else if (options.image) {
+        image = options.image;
+    }
+    const cpuLimit = (options.cpu || 1) * 1e9; // nanoCPUs
+    const memoryLimit = (options.memory || 2048) * 1024 * 1024; // bytes
+    const volumeName = `lobster-${name}-workspace`;
+    const env = [
+        `CAGE_ID=${cageId}`,
+        `CAGE_NAME=${name}`,
+        `USER_ID=local`,
+        ...Object.entries(options.env || {}).map(([k, v]) => `${k}=${v}`),
+    ];
+    const container = await docker.createContainer({
+        name: cName,
+        Image: image,
+        Env: env,
+        Labels: {
+            [LABEL_PREFIX]: 'true',
+            [`${LABEL_PREFIX}.cage-name`]: name,
+            [`${LABEL_PREFIX}.cage-id`]: cageId,
+        },
+        HostConfig: {
+            NanoCpus: cpuLimit,
+            Memory: memoryLimit,
+            Binds: [`${volumeName}:${WORKSPACE_MOUNT}`],
+        },
+        Tty: true,
+        OpenStdin: true,
+    });
+    await container.start();
+    return {
+        id: cageId,
+        name,
+        status: 'running',
+        image,
+        resources: {
+            cpu: ((options.cpu || 1) * 1024),
+            memory: (options.memory || 2048),
+            storage: 20,
+        },
+        network: { egressPolicy: 'allow-all' },
+        createdAt: new Date().toISOString(),
+        startedAt: new Date().toISOString(),
+    };
+}
+/**
+ * List all local cages
+ */
+async function listCages() {
+    const containers = await docker.listContainers({
+        all: true,
+        filters: { label: [`${LABEL_PREFIX}=true`] },
+    });
+    return containers.map(containerToCage);
+}
+/**
+ * Get a single cage by name
+ */
+async function getCage(name) {
+    const containers = await docker.listContainers({
+        all: true,
+        filters: {
+            label: [`${LABEL_PREFIX}=true`, `${LABEL_PREFIX}.cage-name=${name}`],
+        },
+    });
+    if (containers.length === 0) {
+        throw new Error(`Cage not found: ${name}`);
+    }
+    return containerToCage(containers[0]);
+}
+/**
+ * Start a stopped cage
+ */
+async function startCage(name) {
+    const container = docker.getContainer(containerName(name));
+    await container.start();
+    return getCage(name);
+}
+/**
+ * Stop a running cage
+ */
+async function stopCage(name, force = false) {
+    const container = docker.getContainer(containerName(name));
+    if (force) {
+        await container.kill();
+    }
+    else {
+        await container.stop();
+    }
+    return getCage(name);
+}
+/**
+ * Destroy a cage (remove container and optionally volume)
+ */
+async function destroyCage(name) {
+    const container = docker.getContainer(containerName(name));
+    await container.remove({ force: true });
+}
+/**
+ * Get cage logs
+ */
+async function getCageLogs(name, options = {}) {
+    const container = docker.getContainer(containerName(name));
+    const logStream = await container.logs({
+        stdout: true,
+        stderr: true,
+        tail: options.tail ?? 100,
+        since: options.since ? Math.floor(new Date(options.since).getTime() / 1000) : undefined,
+        timestamps: true,
+    });
+    const logStr = typeof logStream === 'string' ? logStream : logStream.toString('utf-8');
+    if (!logStr.trim())
+        return [];
+    return logStr.trim().split('\n').map(line => {
+        // Docker log lines may have 8-byte header prefix in multiplexed streams
+        const cleaned = line.replace(/^[\x00-\x08].{7}/, '');
+        const spaceIdx = cleaned.indexOf(' ');
+        const timestamp = spaceIdx > 0 ? cleaned.slice(0, spaceIdx) : new Date().toISOString();
+        const message = spaceIdx > 0 ? cleaned.slice(spaceIdx + 1) : cleaned;
+        return {
+            timestamp,
+            stream: 'stdout',
+            message,
+        };
+    });
+}
+/**
+ * Get the container name for exec (used by exec command with child_process)
+ */
+function getContainerName(name) {
+    return containerName(name);
+}
+//# sourceMappingURL=docker.js.map

package/dist/lib/docker.js.map

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

package/dist/lib/error-handler.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Centralized Error Handler
+ *
+ * Replaces repeated try/catch boilerplate across CLI commands with a single
+ * `handleError()` function that handles spinner cleanup, contextual suggestions,
+ * JSON output, debug stack traces, and process.exit.
+ */
+import type { Ora } from 'ora';
+export interface HandleErrorOptions {
+    spinner?: Ora;
+    exitCode?: number;
+    json?: boolean;
+    context?: string;
+}
+/**
+ * Check if debug mode is enabled via --debug flag or DEBUG env var.
+ */
+export declare function isDebug(): boolean;
+/**
+ * Centralized error handler. Call from catch blocks to replace boilerplate.
+ *
+ * - Stops the spinner if provided
+ * - For ApiClientError: prints message + contextual suggestion
+ * - For generic Error: prints context-aware message
+ * - In --json mode: outputs structured JSON error
+ * - In --debug mode: prints stack trace
+ * - Calls process.exit(exitCode)
+ */
+export declare function handleError(err: unknown, options?: HandleErrorOptions): never;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/lib/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/lib/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAkB/B,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,KAAK,CAmCjF"}

package/dist/lib/error-handler.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * Centralized Error Handler
+ *
+ * Replaces repeated try/catch boilerplate across CLI commands with a single
+ * `handleError()` function that handles spinner cleanup, contextual suggestions,
+ * JSON output, debug stack traces, and process.exit.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDebug = isDebug;
+exports.handleError = handleError;
+const api_1 = require("./api");
+const output = __importStar(require("./output"));
+/**
+ * Error code → actionable suggestion mapping
+ */
+const SUGGESTIONS = {
+    CAGE_NOT_FOUND: 'Check cage name with `lobster list`',
+    CAGE_NOT_RUNNING: 'Start the cage first with `lobster start <name>`',
+    CAGE_RUNNING: 'Stop the cage first with `lobster stop <name>`',
+    NETWORK_ERROR: 'Check your internet connection and API URL',
+    AUTH_REQUIRED: 'Run `lobster login` first',
+    FORBIDDEN: "You don't have permission. Check your API key",
+    RATE_LIMITED: 'Too many requests. Wait a moment and try again',
+    INSUFFICIENT_CREDITS: 'Add credits with `lobster upgrade`',
+};
+/**
+ * Check if debug mode is enabled via --debug flag or DEBUG env var.
+ */
+function isDebug() {
+    return !!(process.env.DEBUG || process.argv.includes('--debug'));
+}
+/**
+ * Centralized error handler. Call from catch blocks to replace boilerplate.
+ *
+ * - Stops the spinner if provided
+ * - For ApiClientError: prints message + contextual suggestion
+ * - For generic Error: prints context-aware message
+ * - In --json mode: outputs structured JSON error
+ * - In --debug mode: prints stack trace
+ * - Calls process.exit(exitCode)
+ */
+function handleError(err, options = {}) {
+    const { spinner, exitCode = 1, json, context } = options;
+    if (spinner) {
+        spinner.stop();
+    }
+    if (err instanceof api_1.ApiClientError) {
+        if (json) {
+            output.json({ error: err.code, message: err.message });
+        }
+        else {
+            output.error(err.message);
+            const suggestion = SUGGESTIONS[err.code];
+            if (suggestion) {
+                output.info(suggestion);
+            }
+        }
+    }
+    else if (err instanceof Error) {
+        if (json) {
+            output.json({ error: 'UNKNOWN_ERROR', message: err.message });
+        }
+        else if (context) {
+            output.error(`Failed ${context}: ${err.message}`);
+        }
+        else {
+            output.error(err.message);
+        }
+    }
+    else {
+        output.error('An unexpected error occurred');
+    }
+    if (isDebug() && err instanceof Error && err.stack) {
+        console.error('\nStack trace:');
+        console.error(err.stack);
+    }
+    process.exit(exitCode);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/lib/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/lib/error-handler.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BH,0BAEC;AAYD,kCAmCC;AA5ED,+BAAuC;AACvC,iDAAmC;AAEnC;;GAEG;AACH,MAAM,WAAW,GAA2B;IAC1C,cAAc,EAAE,qCAAqC;IACrD,gBAAgB,EAAE,kDAAkD;IACpE,YAAY,EAAE,gDAAgD;IAC9D,aAAa,EAAE,4CAA4C;IAC3D,aAAa,EAAE,2BAA2B;IAC1C,SAAS,EAAE,+CAA+C;IAC1D,YAAY,EAAE,gDAAgD;IAC9D,oBAAoB,EAAE,oCAAoC;CAC3D,CAAC;AASF;;GAEG;AACH,SAAgB,OAAO;IACrB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,WAAW,CAAC,GAAY,EAAE,UAA8B,EAAE;IACxE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAEzD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IAED,IAAI,GAAG,YAAY,oBAAc,EAAE,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1B,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,IAAI,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,EAAE,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACnD,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Output Formatting Utilities
+ *
+ * Consistent output formatting for the CLI.
+ */
+import type { Cage, CageStatus, EnvVar, SecurityWarning, LogEntry, ApiKey } from '../types';
+/**
+ * Format cage status with color
+ */
+export declare function formatStatus(status: CageStatus): string;
+/**
+ * Format a cage for display
+ */
+export declare function formatCage(cage: Cage, verbose?: boolean): string;
+/**
+ * Format a list of cages as a table
+ */
+export declare function formatCageTable(cages: Cage[]): string;
+/**
+ * Format environment variables
+ */
+export declare function formatEnvVars(vars: EnvVar[]): string;
+/**
+ * Format security warnings
+ */
+export declare function formatSecurityWarnings(warnings: SecurityWarning[]): string;
+/**
+ * Format security severity
+ */
+export declare function formatSeverity(severity: string): string;
+/**
+ * Format log entries
+ */
+export declare function formatLogs(logs: LogEntry[]): string;
+/**
+ * Format API keys
+ */
+export declare function formatApiKeys(keys: ApiKey[]): string;
+/**
+ * Format a date string
+ */
+export declare function formatDate(dateStr: string): string;
+/**
+ * Format a relative date (e.g., "2 hours ago")
+ */
+export declare function formatRelativeDate(dateStr: string): string;
+/**
+ * Print success message
+ */
+export declare function success(message: string): void;
+/**
+ * Print error message
+ */
+export declare function error(message: string): void;
+/**
+ * Print warning message
+ */
+export declare function warning(message: string): void;
+/**
+ * Print info message
+ */
+export declare function info(message: string): void;
+/**
+ * Print a section header
+ */
+export declare function header(title: string): void;
+/**
+ * Print JSON output (for --json flag)
+ */
+export declare function json(data: unknown): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAE5F;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAevD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,UAAQ,GAAG,MAAM,CAyB9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAerD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAUpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CAY1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAavD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAMnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAoBpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoB1D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI1C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAExC"}