@agirails/sdk 2.0.1-beta → 2.0.2

package/dist/cli/index.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * ACTP CLI - Agent Commerce Transaction Protocol Command Line Interface
+ *
+ * The ACTP CLI is designed for AI agents - not humans clicking buttons.
+ * Key differentiators:
+ *
+ * 1. **Machine-readable output**: JSON by default for scripting
+ * 2. **Pipe-friendly**: Commands output just what you need
+ * 3. **Structured exit codes**: 0=success, 1=error, 2=pending
+ * 4. **Agent-first features**: watch, simulate, batch
+ *
+ * @module cli
+ * @see https://docs.agirails.io/cli
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const path_1 = require("path");
+// Read version from package.json (works in both src and dist)
+function getVersion() {
+    try {
+        // Try dist location first (when running compiled)
+        const distPath = (0, path_1.join)(__dirname, '../../package.json');
+        const pkg = JSON.parse((0, fs_1.readFileSync)(distPath, 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        try {
+            // Fallback to src location (when running ts-node)
+            const srcPath = (0, path_1.join)(__dirname, '../../../package.json');
+            const pkg = JSON.parse((0, fs_1.readFileSync)(srcPath, 'utf-8'));
+            return pkg.version;
+        }
+        catch {
+            return '0.0.0'; // Fallback if package.json not found
+        }
+    }
+}
+// Import commands
+const init_1 = require("./commands/init");
+const pay_1 = require("./commands/pay");
+const tx_1 = require("./commands/tx");
+const balance_1 = require("./commands/balance");
+const mint_1 = require("./commands/mint");
+const config_1 = require("./commands/config");
+const watch_1 = require("./commands/watch");
+const simulate_1 = require("./commands/simulate");
+const batch_1 = require("./commands/batch");
+const time_1 = require("./commands/time");
+// ============================================================================
+// Program Setup
+// ============================================================================
+const program = new commander_1.Command();
+program
+    .name('actp')
+    .description('ACTP CLI - Agent Commerce Transaction Protocol\n\n' +
+    'The payment layer for AI agents. Create escrow-backed transactions,\n' +
+    'track state changes, and settle payments programmatically.\n\n' +
+    'Quick Start:\n' +
+    '  $ actp init                     Initialize in current directory\n' +
+    '  $ actp pay 0xProvider 100       Create a payment\n' +
+    '  $ actp tx status <txId>         Check transaction status\n\n' +
+    'Output Modes:\n' +
+    '  --json     Machine-readable JSON output\n' +
+    '  --quiet    Minimal output (just the essential value)')
+    .version(getVersion(), '-v, --version', 'Output the version number')
+    .helpOption('-h, --help', 'Display help for command');
+// ============================================================================
+// Register Commands
+// ============================================================================
+// Core commands (most used)
+program.addCommand((0, init_1.createInitCommand)());
+program.addCommand((0, pay_1.createPayCommand)());
+program.addCommand((0, tx_1.createTxCommand)());
+program.addCommand((0, balance_1.createBalanceCommand)());
+program.addCommand((0, mint_1.createMintCommand)());
+program.addCommand((0, config_1.createConfigCommand)());
+// Agent-first features
+program.addCommand((0, watch_1.createWatchCommand)());
+program.addCommand((0, simulate_1.createSimulateCommand)());
+program.addCommand((0, batch_1.createBatchCommand)());
+// Mock mode utilities
+program.addCommand((0, time_1.createTimeCommand)());
+// ============================================================================
+// Error Handling
+// ============================================================================
+// Handle unknown commands
+program.on('command:*', (operands) => {
+    console.error(`Error: Unknown command '${operands[0]}'`);
+    console.error('');
+    console.error('Run "actp --help" for available commands.');
+    process.exit(1);
+});
+// ============================================================================
+// Parse & Execute
+// ============================================================================
+program.parse(process.argv);
+// If no arguments, show help
+if (process.argv.length === 2) {
+    program.outputHelp();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/utils/client.d.ts

@@ -0,0 +1,70 @@
+/**
+ * SDK Client Factory for CLI
+ *
+ * Creates and manages ACTPClient instances based on CLI configuration.
+ * Handles mode-specific initialization and error mapping.
+ *
+ * SECURITY: Error messages are sanitized to prevent information disclosure.
+ *
+ * @module cli/utils/client
+ */
+import { ACTPClient } from '../../ACTPClient';
+/**
+ * Create an ACTPClient instance from CLI configuration
+ *
+ * Reads configuration from .actp/config.json and creates
+ * an appropriate client instance for the configured mode.
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @returns Initialized ACTPClient
+ * @throws Error if config invalid or client creation fails
+ */
+export declare function createClient(projectRoot?: string): Promise<ACTPClient>;
+/**
+ * Error codes for CLI errors
+ */
+export declare const ErrorCode: {
+    readonly NOT_INITIALIZED: "NOT_INITIALIZED";
+    readonly CONFIG_CORRUPTED: "CONFIG_CORRUPTED";
+    readonly INVALID_CONFIG: "INVALID_CONFIG";
+    readonly INVALID_ADDRESS: "INVALID_ADDRESS";
+    readonly INVALID_AMOUNT: "INVALID_AMOUNT";
+    readonly INVALID_DEADLINE: "INVALID_DEADLINE";
+    readonly INVALID_TX_ID: "INVALID_TX_ID";
+    readonly TX_NOT_FOUND: "TX_NOT_FOUND";
+    readonly INVALID_STATE_TRANSITION: "INVALID_STATE_TRANSITION";
+    readonly INSUFFICIENT_BALANCE: "INSUFFICIENT_BALANCE";
+    readonly DEADLINE_PASSED: "DEADLINE_PASSED";
+    readonly DISPUTE_WINDOW_ACTIVE: "DISPUTE_WINDOW_ACTIVE";
+    readonly FILE_LOCK_ERROR: "FILE_LOCK_ERROR";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+export type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Structured CLI error with code and details
+ */
+export interface StructuredError {
+    code: ErrorCodeValue;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Map SDK errors to CLI-friendly structured errors.
+ *
+ * SECURITY: Sanitizes paths and stack traces to prevent information disclosure.
+ */
+export declare function mapError(error: unknown): StructuredError;
+/**
+ * Validate transaction ID format
+ */
+export declare function isValidTxId(txId: string): boolean;
+/**
+ * Format address for display (truncate middle)
+ */
+export declare function formatAddress(address: string, length?: number): string;
+/**
+ * Format transaction ID for display (truncate)
+ */
+export declare function formatTxId(txId: string, length?: number): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/cli/utils/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,UAAU,EAAoB,MAAM,kBAAkB,CAAC;AA4BhE;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAMD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;CAuBZ,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAsGxD;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,CAK1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAEnE"}

package/dist/cli/utils/client.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * SDK Client Factory for CLI
+ *
+ * Creates and manages ACTPClient instances based on CLI configuration.
+ * Handles mode-specific initialization and error mapping.
+ *
+ * SECURITY: Error messages are sanitized to prevent information disclosure.
+ *
+ * @module cli/utils/client
+ */
+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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTxId = exports.formatAddress = exports.isValidTxId = exports.mapError = exports.ErrorCode = exports.createClient = void 0;
+const os = __importStar(require("os"));
+const ACTPClient_1 = require("../../ACTPClient");
+const config_1 = require("./config");
+// ============================================================================
+// Security: Path Sanitization
+// ============================================================================
+/**
+ * Sanitize a file path for safe display in error messages.
+ *
+ * SECURITY: Replaces home directory with ~ to prevent disclosure of:
+ * - Full home directory paths
+ * - Usernames embedded in paths
+ * - System-specific directory structures
+ *
+ * @param fullPath - The full file path to sanitize
+ * @returns Sanitized path safe for display
+ */
+function sanitizePath(fullPath) {
+    const home = os.homedir();
+    // Replace home directory with ~ to avoid disclosing username/path
+    return fullPath.replace(home, '~');
+}
+// ============================================================================
+// Client Factory
+// ============================================================================
+/**
+ * Create an ACTPClient instance from CLI configuration
+ *
+ * Reads configuration from .actp/config.json and creates
+ * an appropriate client instance for the configured mode.
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @returns Initialized ACTPClient
+ * @throws Error if config invalid or client creation fails
+ */
+async function createClient(projectRoot = process.cwd()) {
+    // Load configuration
+    const config = (0, config_1.loadConfig)(projectRoot);
+    // Validate config for the mode
+    (0, config_1.validateConfigForMode)(config);
+    // Build client config
+    const clientConfig = {
+        mode: config.mode,
+        requesterAddress: config.address,
+        stateDirectory: projectRoot,
+    };
+    // Create and return client
+    return ACTPClient_1.ACTPClient.create(clientConfig);
+}
+exports.createClient = createClient;
+// ============================================================================
+// Error Mapping
+// ============================================================================
+/**
+ * Error codes for CLI errors
+ */
+exports.ErrorCode = {
+    // Configuration errors
+    NOT_INITIALIZED: 'NOT_INITIALIZED',
+    CONFIG_CORRUPTED: 'CONFIG_CORRUPTED',
+    INVALID_CONFIG: 'INVALID_CONFIG',
+    // Input validation errors
+    INVALID_ADDRESS: 'INVALID_ADDRESS',
+    INVALID_AMOUNT: 'INVALID_AMOUNT',
+    INVALID_DEADLINE: 'INVALID_DEADLINE',
+    INVALID_TX_ID: 'INVALID_TX_ID',
+    // Transaction errors
+    TX_NOT_FOUND: 'TX_NOT_FOUND',
+    INVALID_STATE_TRANSITION: 'INVALID_STATE_TRANSITION',
+    INSUFFICIENT_BALANCE: 'INSUFFICIENT_BALANCE',
+    DEADLINE_PASSED: 'DEADLINE_PASSED',
+    DISPUTE_WINDOW_ACTIVE: 'DISPUTE_WINDOW_ACTIVE',
+    // System errors
+    FILE_LOCK_ERROR: 'FILE_LOCK_ERROR',
+    NETWORK_ERROR: 'NETWORK_ERROR',
+    UNKNOWN_ERROR: 'UNKNOWN_ERROR',
+};
+/**
+ * Map SDK errors to CLI-friendly structured errors.
+ *
+ * SECURITY: Sanitizes paths and stack traces to prevent information disclosure.
+ */
+function mapError(error) {
+    const err = error;
+    // Sanitize the message to remove full paths
+    const rawMessage = err?.message || String(error);
+    const message = sanitizePath(rawMessage);
+    // Configuration errors
+    if (message.includes('not initialized') || message.includes('actp init')) {
+        return {
+            code: exports.ErrorCode.NOT_INITIALIZED,
+            message: 'ACTP not initialized. Run "actp init" first.',
+        };
+    }
+    if (message.includes('Config file corrupted')) {
+        return {
+            code: exports.ErrorCode.CONFIG_CORRUPTED,
+            message: 'Configuration file is corrupted.',
+            details: { suggestion: 'Run "actp init --force" to reinitialize.' },
+        };
+    }
+    // Transaction errors (from SDK error classes)
+    if (err?.name === 'TransactionNotFoundError' || message.includes('Transaction not found')) {
+        const txIdMatch = message.match(/Transaction not found: (0x[a-fA-F0-9]+)/);
+        return {
+            code: exports.ErrorCode.TX_NOT_FOUND,
+            message: 'Transaction not found.',
+            details: txIdMatch ? { txId: txIdMatch[1] } : undefined,
+        };
+    }
+    if (err?.name === 'InvalidStateTransitionError' || message.includes('Invalid state transition')) {
+        return {
+            code: exports.ErrorCode.INVALID_STATE_TRANSITION,
+            message: 'Invalid state transition.',
+            // SECURITY: Don't expose original message which may contain sensitive info
+        };
+    }
+    if (err?.name === 'InsufficientBalanceError' || message.includes('Insufficient balance')) {
+        return {
+            code: exports.ErrorCode.INSUFFICIENT_BALANCE,
+            message: 'Insufficient balance for this operation.',
+            // SECURITY: Don't expose balance details
+        };
+    }
+    if (err?.name === 'DeadlinePassedError' || message.includes('Deadline passed')) {
+        return {
+            code: exports.ErrorCode.DEADLINE_PASSED,
+            message: 'Transaction deadline has passed.',
+        };
+    }
+    if (err?.name === 'DisputeWindowActiveError' || message.includes('Dispute window')) {
+        return {
+            code: exports.ErrorCode.DISPUTE_WINDOW_ACTIVE,
+            message: 'Dispute window is still active.',
+            // SECURITY: Don't expose window timing details
+        };
+    }
+    // Validation errors
+    if (err?.name === 'ValidationError') {
+        if (message.includes('address')) {
+            return {
+                code: exports.ErrorCode.INVALID_ADDRESS,
+                message: sanitizePath(message),
+            };
+        }
+        if (message.includes('amount') || message.includes('Amount')) {
+            return {
+                code: exports.ErrorCode.INVALID_AMOUNT,
+                message: sanitizePath(message),
+            };
+        }
+        if (message.includes('deadline') || message.includes('Deadline')) {
+            return {
+                code: exports.ErrorCode.INVALID_DEADLINE,
+                message: sanitizePath(message),
+            };
+        }
+    }
+    // Lock errors
+    if (message.includes('lock') || message.includes('ELOCKED')) {
+        return {
+            code: exports.ErrorCode.FILE_LOCK_ERROR,
+            message: 'Could not acquire lock. Another process may be using ACTP.',
+            details: { suggestion: 'Wait a moment and try again.' },
+        };
+    }
+    // Default: unknown error
+    // SECURITY: Do NOT include stack traces in production - they reveal internal paths
+    return {
+        code: exports.ErrorCode.UNKNOWN_ERROR,
+        message: sanitizePath(message) || 'An unknown error occurred.',
+        // SECURITY FIX: Stack traces removed to prevent information disclosure
+        // In development mode, errors can be logged separately if needed
+    };
+}
+exports.mapError = mapError;
+// ============================================================================
+// Utilities
+// ============================================================================
+/**
+ * Validate transaction ID format
+ */
+function isValidTxId(txId) {
+    return /^0x[a-fA-F0-9]{64}$/.test(txId);
+}
+exports.isValidTxId = isValidTxId;
+/**
+ * Format address for display (truncate middle)
+ */
+function formatAddress(address, length = 10) {
+    if (address.length <= length * 2 + 2) {
+        return address;
+    }
+    return `${address.slice(0, length + 2)}...${address.slice(-length)}`;
+}
+exports.formatAddress = formatAddress;
+/**
+ * Format transaction ID for display (truncate)
+ */
+function formatTxId(txId, length = 8) {
+    return `${txId.slice(0, length + 2)}...`;
+}
+exports.formatTxId = formatTxId;
+//# sourceMappingURL=client.js.map

package/dist/cli/utils/client.js.map

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

package/dist/cli/utils/config.d.ts

@@ -0,0 +1,91 @@
+/**
+ * CLI Configuration Management
+ *
+ * Handles reading/writing CLI configuration stored in .actp/config.json.
+ * Supports mock, testnet, and mainnet modes with mode-specific validation.
+ *
+ * @module cli/utils/config
+ */
+/**
+ * CLI operating mode
+ */
+export type CLIMode = 'mock' | 'testnet' | 'mainnet';
+/**
+ * CLI configuration stored in .actp/config.json
+ */
+export interface CLIConfig {
+    /** Operating mode */
+    mode: CLIMode;
+    /** User's Ethereum address */
+    address: string;
+    /** Optional: Private key for testnet/mainnet mode */
+    privateKey?: string;
+    /** Optional: RPC URL override */
+    rpcUrl?: string;
+    /** Configuration version for migrations */
+    version: string;
+}
+/**
+ * Default configuration values
+ */
+export declare const CONFIG_DEFAULTS: CLIConfig;
+/**
+ * Get the .actp directory path
+ */
+export declare function getActpDir(projectRoot?: string): string;
+/**
+ * Get the config.json path
+ */
+export declare function getConfigPath(projectRoot?: string): string;
+/**
+ * Check if ACTP is initialized in the current directory
+ */
+export declare function isInitialized(projectRoot?: string): boolean;
+/**
+ * Load configuration from disk
+ *
+ * SECURITY: Warns about private key storage in config file.
+ *
+ * @throws Error if config doesn't exist or is corrupted
+ */
+export declare function loadConfig(projectRoot?: string): CLIConfig;
+/**
+ * Save configuration to disk
+ *
+ * Creates .actp directory if it doesn't exist.
+ * Uses atomic write (temp file + rename).
+ */
+export declare function saveConfig(config: CLIConfig, projectRoot?: string): void;
+/**
+ * Update specific config values
+ *
+ * Loads existing config, merges updates, and saves.
+ */
+export declare function updateConfig(updates: Partial<CLIConfig>, projectRoot?: string): CLIConfig;
+/**
+ * Get a specific config value
+ */
+export declare function getConfigValue<K extends keyof CLIConfig>(key: K, projectRoot?: string): CLIConfig[K];
+/**
+ * Set a specific config value
+ */
+export declare function setConfigValue<K extends keyof CLIConfig>(key: K, value: CLIConfig[K], projectRoot?: string): void;
+/**
+ * Validate Ethereum address format
+ */
+export declare function validateAddress(address: string): boolean;
+/**
+ * Validate private key format (64 hex chars, optionally with 0x prefix)
+ */
+export declare function validatePrivateKey(key: string): boolean;
+/**
+ * Validate config for the specified mode
+ *
+ * @throws Error if config is invalid for the mode
+ */
+export declare function validateConfigForMode(config: CLIConfig): void;
+/**
+ * Add .actp to .gitignore if not already present
+ */
+export declare function addToGitignore(projectRoot?: string): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,IAAI,EAAE,OAAO,CAAC;IAEd,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SAI7B,CAAC;AAMF;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,GAAE,MAAsB,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,GAAE,MAAsB,GAAG,MAAM,CAEzE;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,WAAW,GAAE,MAAsB,GAAG,SAAS,CAuCzE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,WAAW,GAAE,MAAsB,GAClC,IAAI,CA0BN;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,EAC3B,WAAW,GAAE,MAAsB,GAClC,SAAS,CAKX;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,SAAS,EACtD,GAAG,EAAE,CAAC,EACN,WAAW,GAAE,MAAsB,GAClC,SAAS,CAAC,CAAC,CAAC,CAGd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,SAAS,EACtD,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,WAAW,GAAE,MAAsB,GAClC,IAAI,CAEN;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAIvD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyB7D;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,GAAE,MAAsB,GAAG,IAAI,CAqBxE"}