@conquest-eth/tools 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Ronan Sandford
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,259 @@
+# MCP for Conquest.eth v0
+
+A dual-mode CLI tool for interacting with the Conquest.eth blockchain game. It can run as an **MCP server** for AI assistant integration or execute **tools directly** from the command line.
+
+## Features
+
+- **MCP Server Mode**: Integrate with AI assistants via the Model Context Protocol
+- **CLI Mode**: Execute game commands directly from your terminal
+- **Dynamic Command Generation**: CLI commands are auto-generated from tool definitions
+- **Comprehensive Game Tools**: Acquire planets, send fleets, resolve fleets, manage exits, and more
+
+## Installation
+
+```bash
+pnpm install
+pnpm build
+```
+
+## Usage
+
+### CLI Mode (Direct Command Execution)
+
+Show help and available commands:
+
+```bash
+node dist/cli.js --help
+```
+
+#### Global Options
+
+| Option                      | Environment Variable | Description                      | Default                  |
+| --------------------------- | -------------------- | -------------------------------- | ------------------------ |
+| `--rpc-url <url>`           | `RPC_URL`            | RPC URL for the Ethereum network | (required)               |
+| `--game-contract <address>` | `GAME_CONTRACT`      | Game contract address            | (required)               |
+| `--storage <type>`          | `STORAGE_TYPE`       | Storage backend: json or sqlite  | json                     |
+| `--storage-path <path>`     | `STORAGE_PATH`       | Storage directory path           | ./data                   |
+| `--private-key <key>`       | `PRIVATE_KEY`        | Private key for transactions     | (required for write ops) |
+
+#### MCP Server Options
+
+| Option       | Environment Variable | Description                  | Default |
+| ------------ | -------------------- | ---------------------------- | ------- |
+| `--ethereum` | `ETHEREUM_TOOLS`     | Include tools-ethereum tools | false   |
+
+#### Using Environment Variables
+
+Set up your environment:
+
+```bash
+export RPC_URL=https://rpc.gnosischain.com
+export GAME_CONTRACT=0x322813fd9a801c5507c9de605d63cea4f2ce6c44
+export PRIVATE_KEY=0x...
+```
+
+Then run commands without repeating options:
+
+```bash
+node dist/cli.js get_my_planets --radius 10
+```
+
+#### Available Commands
+
+| Command              | Description                             |
+| -------------------- | --------------------------------------- |
+| `acquire_planets`    | Acquire/stake multiple planets          |
+| `send_fleet`         | Send a fleet from one planet to another |
+| `resolve_fleet`      | Resolve a committed fleet               |
+| `exit_planets`       | Start the exit process for planets      |
+| `get_my_planets`     | Get all planets owned by you            |
+| `get_planets_around` | Get planets near a location             |
+| `get_pending_exits`  | Get pending exit operations             |
+| `get_pending_fleets` | Get pending fleets                      |
+| `verify_exit_status` | Check a planet's exit status            |
+
+#### Examples
+
+```bash
+# Get your planets
+node dist/cli.js get_my_planets --radius 10
+
+# Find planets near a location
+node dist/cli.js get_planets_around --center-x 0 --center-y 0 --radius 20
+
+# Acquire planets
+node dist/cli.js acquire_planets --planet-ids 1,2,3,4,5
+
+# Send a fleet
+node dist/cli.js send_fleet --from-x 10 --from-y 20 --to-x 15 --to-y 25 --quantity 100
+
+# Resolve a fleet
+node dist/cli.js resolve_fleet --fleet-id "your-fleet-id"
+
+# Exit planets
+node dist/cli.js exit_planets --planet-ids 1,2,3
+```
+
+See [`EXAMPLES.md`](./EXAMPLES.md) for more detailed usage examples.
+
+### MCP Server Mode
+
+Start the MCP server for AI assistant integration:
+
+```bash
+node dist/cli.js mcp --rpc-url https://rpc.gnosischain.com --game-contract 0x322813fd9a801c5507c9de605d63cea4f2ce6c44
+```
+
+Or use the MCP Inspector for testing:
+
+```bash
+pnpm mcp:inspector node dist/cli.js --game-contract 0xD833d4dBBb0C19aF1EEf76540d66E2076a5e9D72 --rpc-url https://rpc.gnosis.gateway.fm
+```
+
+For Conquest 2025-1 edition, use:
+
+```bash
+pnpm mcp:inspector node dist/cli.js --game-contract 0xD833d4dBBb0C19aF1EEf76540d66E2076a5e9D72 --rpc-url https://rpc.gnosis.gateway.fm
+```
+
+## Architecture
+
+The CLI follows a dual-mode architecture:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                          CLI Tool                               │
+├─────────────────────────────────────────────────────────────────┤
+│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────┐  │
+│  │ Root Program │  │ MCP Command  │  │  Dynamic Tool Cmds   │  │
+│  │ --global-opt │  │  mcp server  │  │ (generated per tool) │  │
+│  └──────────────┘  └──────────────┘  └──────────────────────┘  │
+│         │                 │                     │               │
+│         ▼                 ▼                     ▼               │
+│   ┌─────────────────────────────────────────────────────────┐   │
+│   │                  Tool Definitions                       │   │
+│   │  - description  - Zod schema  - execute(env, params)    │   │
+│   └─────────────────────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Tool Development
+
+Tools are defined with a standardized pattern:
+
+```typescript
+import {z} from 'zod';
+import {createTool} from '../types.js';
+
+export const example_tool = createTool({
+	description: 'Description of what this tool does',
+	schema: z.object({
+		param1: z.string().describe('First parameter'),
+		param2: z.number().optional().describe('Optional parameter'),
+	}),
+	execute: async (env, {param1, param2}) => {
+		// Access fleetManager and planetManager via env
+		const result = await env.planetManager.getMyPlanets(10);
+
+		return {
+			success: true,
+			result: {
+				message: `Processed ${param1}`,
+				data: result,
+			},
+		};
+	},
+});
+```
+
+## Output Format
+
+All CLI commands return JSON output:
+
+**Success:**
+
+```json
+{
+	"planets": [
+		{
+			"planetId": "1",
+			"location": {"id": "1", "x": 10, "y": 20},
+			"numSpaceships": 500
+		}
+	]
+}
+```
+
+**Error:**
+
+```json
+{
+	"error": "No planet found at coordinates",
+	"stack": "Error: No planet found at coordinates\n    at ..."
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Watch for changes and rebuild
+pnpm dev
+
+# Run tests
+pnpm test
+
+# Format code
+pnpm format
+
+# Start the MCP server with auto-reload
+pnpm start
+```
+
+## Project Structure
+
+```
+lobsters/mcp/src/
+├── cli.ts                    # CLI entry point (dual-mode)
+├── cli-tool-generator.ts     # Dynamic CLI command generation
+├── index.ts                  # MCP server setup
+├── types.ts                  # Type definitions
+├── helpers/
+│   └── index.ts              # Helper functions
+├── tools/
+│   ├── index.ts              # Tool exports
+│   ├── acquire_planets.ts    # Tool implementations
+│   ├── send_fleet.ts
+│   ├── resolve_fleet.ts
+│   └── ...
+├── fleet/
+│   ├── manager.ts            # Fleet operations manager
+│   ├── send.ts
+│   └── resolve.ts
+├── planet/
+│   ├── manager.ts            # Planet operations manager
+│   ├── acquire.ts
+│   └── exit.ts
+└── storage/
+    ├── interface.ts          # Storage interface
+    └── json-storage.ts       # JSON storage implementation
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please read the project documentation and open issues for discussion.
+
+## Related Documentation
+
+- [`EXAMPLES.md`](./EXAMPLES.md) - Detailed usage examples
+- [`../../plans/cli-implementation-plan.md`](../../plans/cli-implementation-plan.md) - Implementation plan
+- [`../../plans/cli-refactoring-guide.md`](../../plans/cli-refactoring-guide.md) - Refactoring guide

package/dist/cli-tool-generator.d.ts

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+import { z } from 'zod';
+import type { Tool, StorageConfig } from './types.js';
+/**
+ * CLI configuration parameters
+ */
+export interface CliConfig {
+    chain: any;
+    privateKey?: `0x${string}`;
+    gameContract: `0x${string}`;
+    ethereum?: boolean;
+    storageConfig: StorageConfig;
+}
+/**
+ * Generate a single tool command from tool definition
+ */
+export declare function generateToolCommand(program: Command, toolName: string, tool: Tool<z.ZodObject<any>>): void;
+/**
+ * Register all tool commands from a tools object
+ */
+export declare function registerAllToolCommands(program: Command, tools: Record<string, Tool>): void;
+//# sourceMappingURL=cli-tool-generator.d.ts.map

package/dist/cli-tool-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-tool-generator.d.ts","sourceRoot":"","sources":["../src/cli-tool-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,IAAI,EAAmB,aAAa,EAAC,MAAM,YAAY,CAAC;AAWrE;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,GAAG,CAAC;IACX,UAAU,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;CAC7B;AA6HD;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAC1B,IAAI,CAuHN;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAQ3F"}

package/dist/cli-tool-generator.js

@@ -0,0 +1,217 @@
+import { z } from 'zod';
+import { getClients } from 'tools-ethereum/helpers';
+import { getChain } from 'tools-ethereum/helpers';
+import { createSpaceInfo } from './contracts/space-info.js';
+import { JsonFleetStorage } from './storage/json-storage.js';
+import { FleetManager } from './fleet/manager.js';
+import { PlanetManager } from './planet/manager.js';
+import { Abi_IOuterSpace } from 'conquest-eth-v0-contracts/abis/IOuterSpace.js';
+/**
+ * Convert Zod schema field to commander.js option definition
+ */
+function zodFieldToOption(name, field) {
+    if (field instanceof z.ZodBoolean) {
+        return `--${name}`;
+    }
+    return `--${name} <value>`;
+}
+/**
+ * Parse option value based on Zod type
+ */
+function parseOptionValue(field, value) {
+    if (field instanceof z.ZodArray) {
+        return typeof value === 'string' ? value.split(',').map((v) => v.trim()) : value;
+    }
+    if (field instanceof z.ZodNumber) {
+        return Number(value);
+    }
+    if (field instanceof z.ZodBoolean) {
+        return value === true || value === 'true';
+    }
+    return value;
+}
+/**
+ * Extract description from Zod schema field
+ */
+function getFieldDescription(field) {
+    return field.description || 'No description available';
+}
+/**
+ * Check if a Zod field is optional
+ */
+function isOptionalField(field) {
+    return field instanceof z.ZodOptional || field.isOptional?.();
+}
+/**
+ * Create a CLI tool environment for executing tools
+ */
+async function createCliToolEnvironment(config) {
+    const { gameContract: gameContractAddress, chain, storageConfig } = config;
+    // Get clients
+    const clients = getClients({ chain, privateKey: config.privateKey });
+    // Initialize game contract
+    const gameContract = {
+        address: gameContractAddress,
+        abi: Abi_IOuterSpace,
+    };
+    // Initialize SpaceInfo
+    const { spaceInfo, contractConfig } = await createSpaceInfo(clients, gameContract);
+    // Initialize storage
+    const storage = new JsonFleetStorage(storageConfig.dataDir || './data');
+    // Initialize managers
+    const fleetManager = new FleetManager(clients, gameContract, spaceInfo, contractConfig, storage);
+    const planetManager = new PlanetManager(clients, gameContract, spaceInfo, contractConfig, storage);
+    return {
+        fleetManager,
+        planetManager,
+        sendStatus: async (message) => {
+            console.log(`[Status] ${message}`);
+        },
+    };
+}
+/**
+ * Parse and validate parameters against Zod schema
+ */
+async function parseAndValidateParams(schema, options) {
+    try {
+        return await schema.parseAsync(options);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            console.error('Parameter validation error:');
+            for (const err of error.issues) {
+                console.error(`  - ${err.path.join('.')}: ${err.message}`);
+            }
+        }
+        throw error;
+    }
+}
+/**
+ * Format tool result for CLI output
+ */
+function formatToolResult(result) {
+    if (result.success) {
+        console.log(JSON.stringify(result.result, null, 2));
+    }
+    else {
+        console.error(JSON.stringify({ error: result.error, ...(result.stack ? { stack: result.stack } : {}) }, null, 2));
+        process.exit(1);
+    }
+}
+/**
+ * Generate a single tool command from tool definition
+ */
+export function generateToolCommand(program, toolName, tool) {
+    const shape = tool.schema.shape;
+    const cmd = program.command(toolName).description(tool.description);
+    // Add options for each schema field
+    for (const [fieldName, field] of Object.entries(shape)) {
+        const actualField = isOptionalField(field)
+            ? field.unwrap()
+            : field;
+        // Handle nested objects by flattening them
+        if (actualField instanceof z.ZodObject) {
+            const nestedShape = actualField.shape;
+            for (const [nestedKey, nestedField] of Object.entries(nestedShape)) {
+                const optionName = `${fieldName}-${nestedKey}`;
+                const optionDef = zodFieldToOption(optionName, nestedField);
+                const description = getFieldDescription(nestedField);
+                cmd.option(optionDef, description);
+            }
+        }
+        else {
+            const optionDef = zodFieldToOption(fieldName, actualField);
+            const description = getFieldDescription(actualField);
+            if (isOptionalField(field)) {
+                cmd.option(optionDef, description);
+            }
+            else {
+                cmd.requiredOption(optionDef, description);
+            }
+        }
+    }
+    cmd.action(async (options) => {
+        try {
+            const globalOptions = program.opts();
+            // Get global options
+            const rpcUrl = options.rpcUrl || globalOptions.rpcUrl || process.env.RPC_URL;
+            const gameContract = options.gameContract || globalOptions.gameContract || process.env.GAME_CONTRACT;
+            const ethereum = options.ethereum ?? globalOptions.ethereum ?? process.env.ETHEREUM_TOOLS === 'true';
+            const privateKey = options.privateKey || globalOptions.privateKey || process.env.PRIVATE_KEY;
+            const storageType = options.storage || globalOptions.storage || process.env.STORAGE_TYPE || 'json';
+            const storagePath = options.storagePath || globalOptions.storagePath || process.env.STORAGE_PATH || './data';
+            // Validate required options
+            if (!rpcUrl) {
+                console.error('Error: --rpc-url option or RPC_URL environment variable is required');
+                process.exit(1);
+            }
+            if (!gameContract) {
+                console.error('Error: --game-contract option or GAME_CONTRACT environment variable is required');
+                process.exit(1);
+            }
+            // Get chain
+            const chain = await getChain(rpcUrl);
+            // Parse and validate parameters
+            const params = {};
+            for (const [fieldName, field] of Object.entries(shape)) {
+                const actualField = isOptionalField(field)
+                    ? field.unwrap()
+                    : field;
+                if (actualField instanceof z.ZodObject) {
+                    // Handle nested object - reconstruct from flattened options
+                    const nestedResult = {};
+                    const nestedShape = actualField.shape;
+                    for (const [nestedKey, nestedField] of Object.entries(nestedShape)) {
+                        const optionName = `${fieldName}-${nestedKey}`;
+                        if (options[optionName] !== undefined) {
+                            nestedResult[nestedKey] = parseOptionValue(nestedField, options[optionName]);
+                        }
+                    }
+                    params[fieldName] = nestedResult;
+                }
+                else {
+                    const value = options[fieldName];
+                    if (value !== undefined) {
+                        params[fieldName] = parseOptionValue(actualField, value);
+                    }
+                }
+            }
+            const validatedParams = await parseAndValidateParams(tool.schema, params);
+            // Create environment and execute
+            const env = await createCliToolEnvironment({
+                chain,
+                privateKey: privateKey,
+                gameContract: gameContract,
+                ethereum,
+                storageConfig: {
+                    type: storageType,
+                    dataDir: storagePath,
+                },
+            });
+            const result = await tool.execute(env, validatedParams);
+            formatToolResult(result);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                console.error(JSON.stringify({ error: error.message, ...(error.stack ? { stack: error.stack } : {}) }, null, 2));
+            }
+            else {
+                console.error(JSON.stringify({ error: String(error) }, null, 2));
+            }
+            process.exit(1);
+        }
+    });
+}
+/**
+ * Register all tool commands from a tools object
+ */
+export function registerAllToolCommands(program, tools) {
+    for (const [toolName, tool] of Object.entries(tools)) {
+        // Skip the file that's not a tool
+        if (toolName === 'default')
+            continue;
+        // Keep snake_case for CLI command names (1:1 mapping with tool names)
+        generateToolCommand(program, toolName, tool);
+    }
+}
+//# sourceMappingURL=cli-tool-generator.js.map

package/dist/cli-tool-generator.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './index.js';
+import { Command } from 'commander';
+import pkg from '../package.json' with { type: 'json' };
+import { getChain } from 'tools-ethereum/helpers';
+import { loadEnv } from 'ldenv';
+import * as tools from './tools/index.js';
+import { registerAllToolCommands } from './cli-tool-generator.js';
+loadEnv();
+const program = new Command();
+// Get the binary name from package.json
+const binName = Object.keys(pkg.bin || {})[0];
+program
+    .name(binName)
+    .description(pkg.description || 'Conquest.eth CLI - MCP server and direct tool execution')
+    .version(pkg.version)
+    // Global options available to all commands
+    .option('--rpc-url <url>', 'RPC URL for the Ethereum network', process.env.RPC_URL || '')
+    .option('--game-contract <address>', 'Contract address of the game', process.env.GAME_CONTRACT || '')
+    .option('--storage <type>', 'Storage backend: json or sqlite', process.env.STORAGE_TYPE || 'json')
+    .option('--storage-path <path>', 'Path to storage directory', process.env.STORAGE_PATH || './data')
+    .option('--private-key <key>', 'Private key for sending transactions', process.env.PRIVATE_KEY || '')
+    .action(() => {
+    program.help();
+});
+// MCP subcommand - starts the MCP server
+program
+    .command('mcp')
+    .description('Start the MCP server')
+    .option('--ethereum', 'Whether to also provide tools-ethereum tools', process.env.ETHEREUM_TOOLS === 'true')
+    .action(async () => {
+    const options = program.opts();
+    const mcpOptions = program.commands.find((cmd) => cmd.name() === 'mcp')?.opts() || {};
+    const rpcUrl = options.rpcUrl;
+    const gameContract = options.gameContract;
+    const ethereum = mcpOptions.ethereum ?? process.env.ETHEREUM_TOOLS === 'true';
+    const privateKey = options.privateKey;
+    const storage = options.storage;
+    const storagePath = options.storagePath;
+    // Validate required options
+    if (!rpcUrl) {
+        console.error('Error: --rpc-url option or RPC_URL environment variable is required');
+        process.exit(1);
+    }
+    if (!gameContract) {
+        console.error('Error: --game-contract option or GAME_CONTRACT environment variable is required');
+        process.exit(1);
+    }
+    // Warn if private key is not provided for write operations
+    if (!privateKey) {
+        console.warn('Warning: PRIVATE_KEY environment variable is required for sending transactions');
+    }
+    else if (!privateKey.startsWith('0x')) {
+        console.error('Error: PRIVATE_KEY must start with 0x');
+        process.exit(1);
+    }
+    const chain = await getChain(rpcUrl);
+    const transport = new StdioServerTransport();
+    const server = createServer({
+        chain,
+        privateKey: privateKey,
+        gameContract: gameContract,
+    }, {
+        ethereum,
+        storageConfig: {
+            type: storage,
+            dataDir: storagePath,
+        },
+    });
+    await server.connect(transport);
+});
+// Register all tool commands dynamically
+registerAllToolCommands(program, tools);
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/contracts/space-info.d.ts

@@ -0,0 +1,7 @@
+import { SpaceInfo } from 'conquest-eth-v0-contracts';
+import type { ClientsWithOptionalWallet, ContractConfig, GameContract } from '../types.js';
+export declare function createSpaceInfo(clients: ClientsWithOptionalWallet, gameContract: GameContract): Promise<{
+    spaceInfo: SpaceInfo;
+    contractConfig: ContractConfig;
+}>;
+//# sourceMappingURL=space-info.d.ts.map

package/dist/contracts/space-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-info.d.ts","sourceRoot":"","sources":["../../src/contracts/space-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,EAAC,yBAAyB,EAAE,cAAc,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AAEzF,wBAAsB,eAAe,CACpC,OAAO,EAAE,yBAAyB,EAClC,YAAY,EAAE,YAAY,GACxB,OAAO,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,cAAc,EAAE,cAAc,CAAA;CAAC,CAAC,CAkCjE"}