@0xinsider/mcp 1.0.2 → 1.2.0

package/README.md

@@ -1,8 +1,63 @@
 # @0xinsider/mcp
 
-MCP server for [0xinsider](https://0xinsider.com) — prediction market intelligence for AI agents.
+Official CLI and MCP server for [0xinsider](https://0xinsider.com) — prediction market intelligence for AI agents.
 
-Gives your AI agent access to trader grades, whale trades, smart money signals, market intelligence, and insider detection across prediction markets.
+Gives your AI agent and terminal scripts access to trader grades, whale trades, smart money signals, market intelligence, and insider-radar flags across prediction markets.
+
+## CLI and MCP entry points
+
+Install the official CLI globally when you want a stable terminal command:
+
+```bash
+npm install --global @0xinsider/mcp
+0xinsider --help
+```
+
+The package also exposes `0xinsider-mcp` as an explicit alias. Both commands
+run the same CLI, and `npx -y @0xinsider/mcp` remains the zero-install path.
+
+## Two ways to connect
+
+- **Remote HTTP (no install)** — `POST https://api.0xinsider.com/api/v1/mcp` with `Authorization: Bearer oxi_sk_live_...`. Implements the MCP Streamable HTTP transport (protocolVersion `2025-11-25`). Works with MCP clients that speak HTTP and can send headers. `?token=` remains a legacy URL-only compatibility path, but prefer headers because URL secrets can leak through shell history, browser history, proxy logs, and crash reports. Remote and stdio use the same read-only public V1 tool catalog, rate limits, and billing.
+- **Stdio (this npm package)** — run `npx -y @0xinsider/mcp` locally for Claude Code / Cursor / Codex / Gemini CLI. Best when the client can launch a child process and you prefer to keep the API key out of URLs.
+
+<!-- generated-mcp-catalog:start -->
+Both remote HTTP and stdio expose 33 read-only tools from the Rust canonical registry.
+
+- `get_leaderboard` — Get Trader Leaderboard (group: traders)
+- `get_trader` — Get Trader Intelligence (group: traders)
+- `batch_get_traders` — Batch Trader Intelligence (group: traders)
+- `get_whale_trades` — List Whale Trades (group: whale_activity)
+- `get_whale_trade` — Get Whale Trade (group: whale_activity)
+- `get_whale_trades_history` — Replay Historical Whale Trades (group: whale_activity)
+- `get_market_intel` — Get Market Intelligence (group: markets)
+- `batch_get_market_intel` — Batch Market Intelligence (group: markets)
+- `get_smart_money_flows` — List Smart-Money Flows (group: markets)
+- `get_sharp_money_flows` — List Sharp-Money Flows (group: markets)
+- `get_market_snapshot` — Get Market Snapshot (group: markets)
+- `get_insider_radar` — Get Insider Radar Flags (group: insider_radar)
+- `get_insider_radar_flag` — Get Insider Radar Flag (group: insider_radar)
+- `get_positions` — List Current Positions (group: traders)
+- `get_position_timeline` — Get Position Timeline (group: traders)
+- `get_position_timeline_by_id` — Get Position Timeline By Trader ID (group: traders)
+- `search_markets` — Search Markets (group: markets)
+- `search_content` — Search Editorial Content (group: content)
+- `explore_markets` — Explore Markets (group: markets)
+- `get_event_replay_since` — Replay Public Events (group: whale_activity)
+- `list_webhooks` — List Webhook Endpoints (group: webhooks)
+- `get_webhook` — Get Webhook Endpoint (group: webhooks)
+- `get_daily_report_snapshot` — Get Daily Report Snapshot (group: reports)
+- `get_weekly_report_snapshot` — Get Weekly Report Snapshot (group: reports)
+- `get_monthly_report_snapshot` — Get Monthly Report Snapshot (group: reports)
+- `get_report` — Get Report Snapshot (group: reports)
+- `get_trader_export_snapshot` — Get Trader Export Snapshot (group: traders)
+- `get_platforms` — Get Platform Capability Matrix (group: platforms)
+- `get_large_positions` — List Large Positions (group: markets)
+- `get_trending_wallets` — List Trending Wallets (group: traders)
+- `get_trader_pnl` — Get Trader P&L Time Series (group: traders)
+- `get_pick_of_the_day` — Get Pick of the Day (group: picks)
+- `get_pick_of_the_day_archive` — Get Pick of the Day Archive (group: picks)
+<!-- generated-mcp-catalog:end -->
 
 ## Quick Start
 
@@ -12,6 +67,8 @@ Gives your AI agent access to trader grades, whale trades, smart money signals,
 npx -y @0xinsider/mcp init
 ```
 
+`init` reads the key without echoing it. For non-interactive setup, set `OXINSIDER_API_KEY` in the process environment or pipe the key on stdin. Do not pass the key as a command-line argument.
+
 Or manually add to `~/.claude/settings.json`:
 
 ```json
@@ -65,7 +122,7 @@ OXINSIDER_API_KEY = "oxi_sk_live_..."
 
 ### Gemini CLI
 
-`npx -y @0xinsider/mcp init` can also configure Gemini CLI automatically when the `gemini` command is installed.
+`npx -y @0xinsider/mcp init` detects Gemini CLI when the `gemini` command is installed and prints a manual config template.
 
 Or add to `~/.gemini/settings.json`:
 
@@ -87,9 +144,7 @@ Or add to `~/.gemini/settings.json`:
 
 Any client that supports stdio transport:
 
-```bash
-OXINSIDER_API_KEY=oxi_sk_live_... npx -y @0xinsider/mcp
-```
+Set `OXINSIDER_API_KEY` in the process environment before starting the stdio server. Do not pass the key as a command-line argument.
 
 Need the command list? Run:
 
@@ -99,18 +154,48 @@ npx -y @0xinsider/mcp --help
 
 ## API Key
 
-Get your API key at [0xinsider.com/developers](https://0xinsider.com/developers). Requires an Insider subscription.
+Get your API key at [0xinsider.com/developers](https://0xinsider.com/developers). Requires a Pro subscription.
+
+## Security
+
+`init` never prints the API key. If an older version wrote the key to recorded terminal output, rotate the key before you use the new configuration.
 
 ## Tools
 
+<!-- The `batch_get_traders` and `batch_get_market_intel` rows below are GENERATED: they
+publish the batch item cap, which is owned by `MAX_BATCH_ITEMS` in
+`backend/src/api_v1/handlers/batch.rs` (#8103). Do not hand-edit those two rows; a
+`cd web && npm run generate:api-policy` run rewrites them. Every other row is written by
+hand. Markers are not used here because an HTML comment inside a table breaks it. -->
+
 | Tool | Description |
 |------|-------------|
 | `get_trader` | Look up a trader by wallet address or username — grade, P&L, win rate, strategy, quant metrics |
-| `get_whale_trades` | Recent large trades with signal scoring, filterable by size/category/grade |
+| `batch_get_traders` | Look up 1-25 traders in one call with per-item results and batch-item quota |
+| `get_whale_trades` | Recent large trades with signal scoring and persisted suspicion facts; filterable by size/category/grade/suspicious_only |
+| `get_whale_trade` | Read one whale trade by wt_ ID or raw whale_alerts.id, including persisted suspicion facts |
+| `get_whale_trades_history` | Replay historical whale trades with cursor, market, trader, category, grade, suspicious_only, platform, and time filters |
 | `get_leaderboard` | Top-ranked traders (S/A/B grades) with optional category/strategy filters |
 | `search_markets` | Search prediction markets by keyword |
+| `explore_markets` | Browse whale-active markets with facets and grouped discovery entries |
 | `get_market_intel` | Smart money flow analysis for a specific market |
-| `get_insider_radar` | Suspicious trading pattern detection |
+| `batch_get_market_intel` | Fetch market intelligence for 1-25 condition IDs in one call |
+| `get_smart_money_flows` | Deprecated alias of `get_sharp_money_flows` (byte-identical); kept for backward compatibility |
+| `get_sharp_money_flows` | Ranked sharp-money flow discovery across markets (timeframe, category, platform, min-grade, direction filters) |
+| `get_market_snapshot` | Live market-card snapshot with outcomes, liquidity, sports context, and freshness state |
+| `get_positions` | Current positions with trader, market, value, side, P&L, and freshness context |
+| `get_position_timeline` | Per-market trader fills with running amount and average entry price |
+| `get_position_timeline_by_id` | Per-market trader fills using an internal trader ID alias |
+| `get_insider_radar` | Suspicious trading pattern flags |
+| `get_insider_radar_flag` | Read one insider-radar flag by rf_ ID or raw radar_flags.id |
+| `get_event_replay_since` | Durable public event replay after an opaque cursor |
+| `list_webhooks` | Read webhook endpoints owned by the authenticated API-key user |
+| `get_webhook` | Read one webhook endpoint by ID |
+| `get_daily_report_snapshot` | Read a dated daily whale-activity report snapshot |
+| `get_weekly_report_snapshot` | Read a weekly whale-activity report snapshot by week token or date range |
+| `get_monthly_report_snapshot` | Read a monthly whale-activity report snapshot |
+| `get_trader_export_snapshot` | Read trader export metadata without starting an export job |
+| `get_platforms` | Provider capability matrix: which platforms support grade, P&L, strategy, timeline, whale signal, insider radar, and market snapshot |
 
 ## Resources
 

package/dist/catalog.generated.d.ts

@@ -0,0 +1,136 @@
+export declare const MCP_TOOL_CATALOG: readonly [{
+    readonly name: "get_leaderboard";
+    readonly title: "Get Trader Leaderboard";
+    readonly docsGroup: "traders";
+}, {
+    readonly name: "get_trader";
+    readonly title: "Get Trader Intelligence";
+    readonly docsGroup: "traders";
+}, {
+    readonly name: "batch_get_traders";
+    readonly title: "Batch Trader Intelligence";
+    readonly docsGroup: "traders";
+}, {
+    readonly name: "get_whale_trades";
+    readonly title: "List Whale Trades";
+    readonly docsGroup: "whale_activity";
+}, {
+    readonly name: "get_whale_trade";
+    readonly title: "Get Whale Trade";
+    readonly docsGroup: "whale_activity";
+}, {
+    readonly name: "get_whale_trades_history";
+    readonly title: "Replay Historical Whale Trades";
+    readonly docsGroup: "whale_activity";
+}, {
+    readonly name: "get_market_intel";
+    readonly title: "Get Market Intelligence";
+    readonly docsGroup: "markets";
+}, {
+    readonly name: "batch_get_market_intel";
+    readonly title: "Batch Market Intelligence";
+    readonly docsGroup: "markets";
+}, {
+    readonly name: "get_smart_money_flows";
+    readonly title: "List Smart-Money Flows";
+    readonly docsGroup: "markets";
+}, {
+    readonly name: "get_sharp_money_flows";
+    readonly title: "List Sharp-Money Flows";
+    readonly docsGroup: "markets";
+}, {
+    readonly name: "get_market_snapshot";
+    readonly title: "Get Market Snapshot";
+    readonly docsGroup: "markets";
+}, {
+    readonly name: "get_insider_radar";
+    readonly title: "Get Insider Radar Flags";
+    readonly docsGroup: "insider_radar";
+}, {
+    readonly name: "get_insider_radar_flag";
+    readonly title: "Get Insider Radar Flag";
+    readonly docsGroup: "insider_radar";
+}, {
+    readonly name: "get_positions";
+    readonly title: "List Current Positions";
+    readonly docsGroup: "traders";
+}, {
+    readonly name: "get_position_timeline";
+    readonly title: "Get Position Timeline";
+    readonly docsGroup: "traders";
+}, {
+    readonly name: "get_position_timeline_by_id";
+    readonly title: "Get Position Timeline By Trader ID";
+    readonly docsGroup: "traders";
+}, {
+    readonly name: "search_markets";
+    readonly title: "Search Markets";
+    readonly docsGroup: "markets";
+}, {
+    readonly name: "search_content";
+    readonly title: "Search Editorial Content";
+    readonly docsGroup: "content";
+}, {
+    readonly name: "explore_markets";
+    readonly title: "Explore Markets";
+    readonly docsGroup: "markets";
+}, {
+    readonly name: "get_event_replay_since";
+    readonly title: "Replay Public Events";
+    readonly docsGroup: "whale_activity";
+}, {
+    readonly name: "list_webhooks";
+    readonly title: "List Webhook Endpoints";
+    readonly docsGroup: "webhooks";
+}, {
+    readonly name: "get_webhook";
+    readonly title: "Get Webhook Endpoint";
+    readonly docsGroup: "webhooks";
+}, {
+    readonly name: "get_daily_report_snapshot";
+    readonly title: "Get Daily Report Snapshot";
+    readonly docsGroup: "reports";
+}, {
+    readonly name: "get_weekly_report_snapshot";
+    readonly title: "Get Weekly Report Snapshot";
+    readonly docsGroup: "reports";
+}, {
+    readonly name: "get_monthly_report_snapshot";
+    readonly title: "Get Monthly Report Snapshot";
+    readonly docsGroup: "reports";
+}, {
+    readonly name: "get_report";
+    readonly title: "Get Report Snapshot";
+    readonly docsGroup: "reports";
+}, {
+    readonly name: "get_trader_export_snapshot";
+    readonly title: "Get Trader Export Snapshot";
+    readonly docsGroup: "traders";
+}, {
+    readonly name: "get_platforms";
+    readonly title: "Get Platform Capability Matrix";
+    readonly docsGroup: "platforms";
+}, {
+    readonly name: "get_large_positions";
+    readonly title: "List Large Positions";
+    readonly docsGroup: "markets";
+}, {
+    readonly name: "get_trending_wallets";
+    readonly title: "List Trending Wallets";
+    readonly docsGroup: "traders";
+}, {
+    readonly name: "get_trader_pnl";
+    readonly title: "Get Trader P&L Time Series";
+    readonly docsGroup: "traders";
+}, {
+    readonly name: "get_pick_of_the_day";
+    readonly title: "Get Pick of the Day";
+    readonly docsGroup: "picks";
+}, {
+    readonly name: "get_pick_of_the_day_archive";
+    readonly title: "Get Pick of the Day Archive";
+    readonly docsGroup: "picks";
+}];
+export type McpToolName = (typeof MCP_TOOL_CATALOG)[number]["name"];
+export declare const MCP_TOOL_NAME_ENUM: readonly McpToolName[];
+//# sourceMappingURL=catalog.generated.d.ts.map

package/dist/catalog.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.generated.d.ts","sourceRoot":"","sources":["../src/catalog.generated.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsKnB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAEpD,CAAC"}

package/dist/catalog.generated.js

@@ -0,0 +1,171 @@
+// THIS FILE IS GENERATED. Do not edit it directly.
+// Source: backend/src/mcp/tools/contract.rs; run node scripts/generate-mcp-catalog.mjs.
+export const MCP_TOOL_CATALOG = [
+    {
+        "name": "get_leaderboard",
+        "title": "Get Trader Leaderboard",
+        "docsGroup": "traders"
+    },
+    {
+        "name": "get_trader",
+        "title": "Get Trader Intelligence",
+        "docsGroup": "traders"
+    },
+    {
+        "name": "batch_get_traders",
+        "title": "Batch Trader Intelligence",
+        "docsGroup": "traders"
+    },
+    {
+        "name": "get_whale_trades",
+        "title": "List Whale Trades",
+        "docsGroup": "whale_activity"
+    },
+    {
+        "name": "get_whale_trade",
+        "title": "Get Whale Trade",
+        "docsGroup": "whale_activity"
+    },
+    {
+        "name": "get_whale_trades_history",
+        "title": "Replay Historical Whale Trades",
+        "docsGroup": "whale_activity"
+    },
+    {
+        "name": "get_market_intel",
+        "title": "Get Market Intelligence",
+        "docsGroup": "markets"
+    },
+    {
+        "name": "batch_get_market_intel",
+        "title": "Batch Market Intelligence",
+        "docsGroup": "markets"
+    },
+    {
+        "name": "get_smart_money_flows",
+        "title": "List Smart-Money Flows",
+        "docsGroup": "markets"
+    },
+    {
+        "name": "get_sharp_money_flows",
+        "title": "List Sharp-Money Flows",
+        "docsGroup": "markets"
+    },
+    {
+        "name": "get_market_snapshot",
+        "title": "Get Market Snapshot",
+        "docsGroup": "markets"
+    },
+    {
+        "name": "get_insider_radar",
+        "title": "Get Insider Radar Flags",
+        "docsGroup": "insider_radar"
+    },
+    {
+        "name": "get_insider_radar_flag",
+        "title": "Get Insider Radar Flag",
+        "docsGroup": "insider_radar"
+    },
+    {
+        "name": "get_positions",
+        "title": "List Current Positions",
+        "docsGroup": "traders"
+    },
+    {
+        "name": "get_position_timeline",
+        "title": "Get Position Timeline",
+        "docsGroup": "traders"
+    },
+    {
+        "name": "get_position_timeline_by_id",
+        "title": "Get Position Timeline By Trader ID",
+        "docsGroup": "traders"
+    },
+    {
+        "name": "search_markets",
+        "title": "Search Markets",
+        "docsGroup": "markets"
+    },
+    {
+        "name": "search_content",
+        "title": "Search Editorial Content",
+        "docsGroup": "content"
+    },
+    {
+        "name": "explore_markets",
+        "title": "Explore Markets",
+        "docsGroup": "markets"
+    },
+    {
+        "name": "get_event_replay_since",
+        "title": "Replay Public Events",
+        "docsGroup": "whale_activity"
+    },
+    {
+        "name": "list_webhooks",
+        "title": "List Webhook Endpoints",
+        "docsGroup": "webhooks"
+    },
+    {
+        "name": "get_webhook",
+        "title": "Get Webhook Endpoint",
+        "docsGroup": "webhooks"
+    },
+    {
+        "name": "get_daily_report_snapshot",
+        "title": "Get Daily Report Snapshot",
+        "docsGroup": "reports"
+    },
+    {
+        "name": "get_weekly_report_snapshot",
+        "title": "Get Weekly Report Snapshot",
+        "docsGroup": "reports"
+    },
+    {
+        "name": "get_monthly_report_snapshot",
+        "title": "Get Monthly Report Snapshot",
+        "docsGroup": "reports"
+    },
+    {
+        "name": "get_report",
+        "title": "Get Report Snapshot",
+        "docsGroup": "reports"
+    },
+    {
+        "name": "get_trader_export_snapshot",
+        "title": "Get Trader Export Snapshot",
+        "docsGroup": "traders"
+    },
+    {
+        "name": "get_platforms",
+        "title": "Get Platform Capability Matrix",
+        "docsGroup": "platforms"
+    },
+    {
+        "name": "get_large_positions",
+        "title": "List Large Positions",
+        "docsGroup": "markets"
+    },
+    {
+        "name": "get_trending_wallets",
+        "title": "List Trending Wallets",
+        "docsGroup": "traders"
+    },
+    {
+        "name": "get_trader_pnl",
+        "title": "Get Trader P&L Time Series",
+        "docsGroup": "traders"
+    },
+    {
+        "name": "get_pick_of_the_day",
+        "title": "Get Pick of the Day",
+        "docsGroup": "picks"
+    },
+    {
+        "name": "get_pick_of_the_day_archive",
+        "title": "Get Pick of the Day Archive",
+        "docsGroup": "picks"
+    }
+];
+export const MCP_TOOL_NAME_ENUM = MCP_TOOL_CATALOG.map((tool) => tool.name);
+//# sourceMappingURL=catalog.generated.js.map

package/dist/catalog.generated.js.map

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

package/dist/cli-lib.d.ts

@@ -4,6 +4,9 @@ export type Environment = {
     type: EnvironmentType;
     configPath: string;
 };
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
 type McpConfig = {
     command: string;
     args: string[];
@@ -11,8 +14,14 @@ type McpConfig = {
 };
 export declare function buildMcpConfig(apiKey: string): McpConfig;
 export declare function formatCodexToml(apiKey: string): string;
+export declare function buildMcpConfigTemplate(): McpConfig;
+export declare function formatCodexTomlTemplate(): string;
 export declare function resolveCliCommand(args: readonly string[]): CliCommand;
 export declare function detectEnvironments(home?: string): Environment[];
+export declare function readJsonFile(path: string): Record<string, JsonValue>;
+export declare function writeJsonFile(path: string, data: Record<string, JsonValue>): void;
+export declare function addJsonMcpServer(configPath: string, apiKey: string): void;
+export declare function addCodexMcpServer(configPath: string, apiKey: string): void;
 export declare function runCli(args: readonly string[]): Promise<void>;
 export {};
 //# sourceMappingURL=cli-lib.d.ts.map

package/dist/cli-lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-lib.d.ts","sourceRoot":"","sources":["../src/cli-lib.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAEhF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,KAAK,SAAS,GAAG;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,CAAC;AAEF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAQxD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQtD;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAarE;AA0BD,wBAAgB,kBAAkB,CAChC,IAAI,SAAoD,GACvD,WAAW,EAAE,CAwBf;AAoLD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnE"}
+{"version":3,"file":"cli-lib.d.ts","sourceRoot":"","sources":["../src/cli-lib.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAEhF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/F,KAAK,SAAS,GAAG;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,CAAC;AASF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAQxD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,wBAAgB,sBAAsB,IAAI,SAAS,CAElD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAarE;AAyLD,wBAAgB,kBAAkB,CAChC,IAAI,SAAoD,GACvD,WAAW,EAAE,CAwBf;AAiCD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAYpE;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAEjF;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASzE;AA2CD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM1E;AA6CD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnE"}