@0xinsider/mcp 1.0.2 → 1.2.0

package/dist/server.js

@@ -1,15 +1,67 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { ApiClient } from "./client.js";
+import { MCP_TOOL_CATALOG, } from "./catalog.generated.js";
 import { registerGetTrader } from "./tools/get-trader.js";
 import { registerGetWhaleTrades } from "./tools/get-whale-trades.js";
 import { registerGetLeaderboard } from "./tools/get-leaderboard.js";
 import { registerSearchMarkets } from "./tools/search-markets.js";
 import { registerGetMarketIntel } from "./tools/get-market-intel.js";
 import { registerGetInsiderRadar } from "./tools/get-insider-radar.js";
+import { registerGetPositions } from "./tools/get-positions.js";
+import { registerGetPositionTimeline } from "./tools/get-position-timeline.js";
+import { registerGetLargePositions } from "./tools/get-large-positions.js";
+import { registerGetTrendingWallets } from "./tools/get-trending-wallets.js";
+import { registerGetTraderPnl } from "./tools/get-trader-pnl.js";
+import { registerExploreMarkets } from "./tools/explore-markets.js";
+import { registerGetPickOfTheDay, registerGetPickOfTheDayArchive, } from "./tools/pick-of-the-day.js";
+import { registerBatchGetMarketIntel, registerBatchGetTraders, registerGetDailyReportSnapshot, registerGetEventReplaySince, registerGetInsiderRadarFlag, registerGetMarketSnapshot, registerGetMonthlyReportSnapshot, registerGetPlatforms, registerGetPositionTimelineById, registerGetSharpMoneyFlows, registerGetReport, registerSearchContent, registerGetSmartMoneyFlows, registerGetTraderExportSnapshot, registerGetWebhook, registerGetWeeklyReportSnapshot, registerGetWhaleTrade, registerGetWhaleTradesHistory, registerListWebhooks, } from "./tools/read-parity.js";
 import { registerResources } from "./resources/index.js";
 import { registerPrompts } from "./prompts/index.js";
 import { API_KEY_ENV_VAR, API_URL_ENV_VAR, DEVELOPERS_URL, SERVER_NAME, SITE_URL, VERSION, } from "./constants.js";
+// Handler modules own schemas and request behavior. This adapter map only binds
+// those implementations to the Rust-generated identity catalog, so a new Rust
+// tool cannot silently disappear from stdio registration.
+const TOOL_REGISTRATIONS = {
+    get_leaderboard: registerGetLeaderboard,
+    get_trader: registerGetTrader,
+    batch_get_traders: registerBatchGetTraders,
+    get_whale_trades: registerGetWhaleTrades,
+    get_whale_trade: registerGetWhaleTrade,
+    get_whale_trades_history: registerGetWhaleTradesHistory,
+    get_market_intel: registerGetMarketIntel,
+    batch_get_market_intel: registerBatchGetMarketIntel,
+    get_smart_money_flows: registerGetSmartMoneyFlows,
+    get_sharp_money_flows: registerGetSharpMoneyFlows,
+    get_market_snapshot: registerGetMarketSnapshot,
+    get_insider_radar: registerGetInsiderRadar,
+    get_insider_radar_flag: registerGetInsiderRadarFlag,
+    get_positions: registerGetPositions,
+    get_position_timeline: registerGetPositionTimeline,
+    get_position_timeline_by_id: registerGetPositionTimelineById,
+    search_markets: registerSearchMarkets,
+    search_content: registerSearchContent,
+    explore_markets: registerExploreMarkets,
+    get_event_replay_since: registerGetEventReplaySince,
+    list_webhooks: registerListWebhooks,
+    get_webhook: registerGetWebhook,
+    get_daily_report_snapshot: registerGetDailyReportSnapshot,
+    get_weekly_report_snapshot: registerGetWeeklyReportSnapshot,
+    get_monthly_report_snapshot: registerGetMonthlyReportSnapshot,
+    get_report: registerGetReport,
+    get_trader_export_snapshot: registerGetTraderExportSnapshot,
+    get_platforms: registerGetPlatforms,
+    get_large_positions: registerGetLargePositions,
+    get_trending_wallets: registerGetTrendingWallets,
+    get_trader_pnl: registerGetTraderPnl,
+    get_pick_of_the_day: registerGetPickOfTheDay,
+    get_pick_of_the_day_archive: registerGetPickOfTheDayArchive,
+};
+function registerCatalogTools(server, client) {
+    for (const tool of MCP_TOOL_CATALOG) {
+        TOOL_REGISTRATIONS[tool.name](server, client);
+    }
+}
 async function fetchInstructions() {
     try {
         const response = await fetch(`${SITE_URL}/agents.md`);
@@ -29,12 +81,7 @@ export async function createServer(apiKey, baseUrl) {
     const client = new ApiClient(apiKey, baseUrl);
     const instructions = await fetchInstructions();
     const server = new McpServer({ name: SERVER_NAME, version: VERSION }, { instructions });
-    registerGetTrader(server, client);
-    registerGetWhaleTrades(server, client);
-    registerGetLeaderboard(server, client);
-    registerSearchMarkets(server, client);
-    registerGetMarketIntel(server, client);
-    registerGetInsiderRadar(server, client);
+    registerCatalogTools(server, client);
     registerResources(server, client);
     registerPrompts(server);
     return server;

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,WAAW,EACX,QAAQ,EACR,OAAO,GACR,MAAM,gBAAgB,CAAC;AAExB,KAAK,UAAU,iBAAiB;IAC9B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,0CAA0C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3E,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,uEAAuE;QACvE,OAAO,CAAC,KAAK,CAAC,oDAAoD,QAAQ,aAAa,EAAE,KAAK,CAAC,CAAC;QAChG,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,OAAgB;IACjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAE/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EACvC,EAAE,YAAY,EAAE,CACjB,CAAC;IAEF,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,GAAG,eAAe,0DAA0D,cAAc,EAAE,CAC7F,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,+BAA+B,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/explore-markets.d.ts

@@ -0,0 +1,51 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ApiClient } from "../client.js";
+export declare const exploreMarketsParamsSchema: {
+    limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+        all: "all";
+    }>>;
+    platform: z.ZodDefault<z.ZodEnum<{
+        all: "all";
+        polymarket: "polymarket";
+        kalshi: "kalshi";
+    }>>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        trending: "trending";
+        hot: "hot";
+        expiring: "expiring";
+        whales: "whales";
+        volume: "volume";
+        newest: "newest";
+    }>>;
+    q: z.ZodOptional<z.ZodString>;
+};
+export declare function buildExploreMarketsParams(args: {
+    limit?: number;
+    cursor?: string;
+    category?: string;
+    status?: "active" | "closed" | "all";
+    platform?: "polymarket" | "kalshi" | "all";
+    sort?: "trending" | "hot" | "expiring" | "whales" | "volume" | "newest";
+    q?: string;
+}): Record<string, string | number | undefined>;
+export declare function buildExploreMarketsResult(response: {
+    data: unknown;
+    has_more?: boolean;
+    next_cursor?: string | null;
+    total?: number | null;
+    facets?: unknown;
+}): {
+    data: unknown;
+    has_more?: boolean;
+    next_cursor?: string | null;
+    total?: number | null;
+    facets?: unknown;
+};
+export declare function registerExploreMarkets(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=explore-markets.d.ts.map

package/dist/tools/explore-markets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-markets.d.ts","sourceRoot":"","sources":["../../src/tools/explore-markets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAY,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;CAetC,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;IACrC,QAAQ,CAAC,EAAE,YAAY,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC3C,IAAI,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxE,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAU9C;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE;IAClD,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG;IACF,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAQA;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA6CjF"}

package/dist/tools/explore-markets.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { ApiError } from "../client.js";
+export const exploreMarketsParamsSchema = {
+    limit: z.number().int().min(1).max(48).default(24)
+        .describe("Max discovery entries (1-48, default 24)"),
+    cursor: z.string().optional()
+        .describe("Pagination cursor from previous response"),
+    category: z.string().optional()
+        .describe("Filter by provider-native market category"),
+    status: z.enum(["active", "closed", "all"]).default("all")
+        .describe("Filter by market status"),
+    platform: z.enum(["polymarket", "kalshi", "all"]).default("all")
+        .describe("Filter by platform"),
+    sort: z.enum(["trending", "hot", "expiring", "whales", "volume", "newest"]).default("trending")
+        .describe("Discovery sort order"),
+    q: z.string().optional()
+        .describe("Keyword search against market titles"),
+};
+export function buildExploreMarketsParams(args) {
+    return {
+        limit: args.limit,
+        cursor: args.cursor,
+        category: args.category,
+        status: args.status,
+        platform: args.platform,
+        sort: args.sort,
+        q: args.q,
+    };
+}
+export function buildExploreMarketsResult(response) {
+    return {
+        data: response.data,
+        has_more: response.has_more,
+        next_cursor: response.next_cursor,
+        total: response.total,
+        facets: response.facets,
+    };
+}
+export function registerExploreMarkets(server, client) {
+    server.registerTool("explore_markets", {
+        title: "Explore Markets",
+        description: `Browse whale-active titled markets for discovery surfaces. Returns grouped event clusters or standalone markets plus live facets. Cursor-paginated over visible discovery entries.
+
+Args:
+  - limit (number, 1-48, default 24): Max discovery entries per page
+  - cursor (string, optional): Pagination cursor from previous response
+  - category (string, optional): Filter by provider-native market category
+  - status (string, optional): Filter by status: "active", "closed", or "all"
+  - platform (string, optional): Filter by platform: "polymarket", "kalshi", or "all"
+  - sort (string, optional): Sort by "trending", "hot", "expiring", "whales", "volume", or "newest"
+  - q (string, optional): Keyword search against market titles
+
+Returns: Market discovery entries, facets, and pagination metadata.`,
+        inputSchema: exploreMarketsParamsSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => {
+        try {
+            const response = await client.request("/api/v1/markets/explore", buildExploreMarketsParams(args));
+            const result = buildExploreMarketsResult(response);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: error instanceof ApiError ? error.message : `Unexpected error: ${error}` }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=explore-markets.js.map

package/dist/tools/explore-markets.js.map

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

package/dist/tools/get-insider-radar.js

@@ -3,7 +3,7 @@ import { ApiError } from "../client.js";
 export function registerGetInsiderRadar(server, client) {
     server.registerTool("get_insider_radar", {
         title: "Get Insider Radar Flags",
-        description: `Suspicious trading pattern detection — pre-resolution accumulation, coordinated wallets, unusual timing. Cursor-paginated by suspicion score (highest first).
+        description: `Suspicious trading pattern flags — pre-resolution accumulation and coordinated wallets. Each flag carries recorded per-signal component scores; they are nullable and historical. Cursor-paginated by suspicion score (highest first).
 
 Each flag includes:
 - suspicion_score (0-100)

package/dist/tools/get-large-positions.d.ts

@@ -0,0 +1,28 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ApiClient } from "../client.js";
+export declare const largePositionsParamsSchema: {
+    limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    min_size: z.ZodOptional<z.ZodNumber>;
+    category: z.ZodOptional<z.ZodString>;
+    min_grade: z.ZodOptional<z.ZodEnum<{
+        S: "S";
+        A: "A";
+        B: "B";
+        C: "C";
+        D: "D";
+        F: "F";
+    }>>;
+    condition_id: z.ZodOptional<z.ZodString>;
+};
+export declare function buildLargePositionsParams(args: {
+    limit?: number;
+    cursor?: string;
+    min_size?: number;
+    category?: string;
+    min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
+    condition_id?: string;
+}): Record<string, string | number | undefined>;
+export declare function registerGetLargePositions(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=get-large-positions.d.ts.map

package/dist/tools/get-large-positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-large-positions.d.ts","sourceRoot":"","sources":["../../src/tools/get-large-positions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAY,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;CAatC,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAS9C;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAgDpF"}

package/dist/tools/get-large-positions.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { ApiError } from "../client.js";
+export const largePositionsParamsSchema = {
+    limit: z.number().int().min(1).max(100).default(20)
+        .describe("Max results (1-100, default 20)"),
+    cursor: z.string().optional()
+        .describe("Pagination cursor from previous response"),
+    min_size: z.number().min(0).optional()
+        .describe("Minimum current position value in USD"),
+    category: z.string().optional()
+        .describe("Filter by provider-backed market category"),
+    min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).optional()
+        .describe("Minimum trader grade"),
+    condition_id: z.string().optional()
+        .describe("Scope to one market: raw provider condition_id or mkt_-prefixed market id"),
+};
+export function buildLargePositionsParams(args) {
+    return {
+        limit: args.limit,
+        cursor: args.cursor,
+        min_size: args.min_size,
+        category: args.category,
+        min_grade: args.min_grade,
+        condition_id: args.condition_id,
+    };
+}
+export function registerGetLargePositions(server, client) {
+    server.registerTool("get_large_positions", {
+        title: "List Large Positions",
+        description: `List the largest current open positions from graded traders, value-descending, with cursor pagination. Polymarket-only by design: the scanner filters platform = 'polymarket', so a Kalshi or unknown condition_id returns an empty list (never fabricated rows).
+
+Args:
+  - limit (number, 1-100, default 20): Max results per page
+  - cursor (string, optional): Pagination cursor from previous response
+  - min_size (number, optional): Minimum current position value in USD
+  - category (string, optional): Filter by provider-backed market category
+  - min_grade (string, optional): Minimum trader grade (S, A, B, C, D, F)
+  - condition_id (string, optional): Scope to one market by raw condition_id or mkt_-prefixed market id
+
+Returns: List of large positions with trader, market, value, P&L, and freshness context plus pagination metadata.`,
+        inputSchema: largePositionsParamsSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => {
+        try {
+            const response = await client.request("/api/v1/large-positions", buildLargePositionsParams(args));
+            const result = {
+                data: response.data,
+                has_more: response.has_more,
+                next_cursor: response.next_cursor,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: error instanceof ApiError ? error.message : `Unexpected error: ${error}` }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-large-positions.js.map

package/dist/tools/get-large-positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-large-positions.js","sourceRoot":"","sources":["../../src/tools/get-large-positions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;SAChD,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC1B,QAAQ,CAAC,0CAA0C,CAAC;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SACnC,QAAQ,CAAC,uCAAuC,CAAC;IACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC5B,QAAQ,CAAC,2CAA2C,CAAC;IACxD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE;SACzD,QAAQ,CAAC,sBAAsB,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAChC,QAAQ,CAAC,2EAA2E,CAAC;CACzF,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,IAOzC;IACC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,MAAiB;IAC5E,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE;;;;;;;;;;kHAU+F;QAC5G,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,yBAAyB,EACzB,yBAAyB,CAAC,IAAI,CAAC,CAChC,CAAC;YAEF,MAAM,MAAM,GAAG;gBACb,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;aAClC,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,KAAK,EAAE,EAAE,CAAC;aACrH,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-position-timeline.d.ts

@@ -0,0 +1,24 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ApiClient } from "../client.js";
+type PositionTimelineArgs = {
+    condition_id: string;
+    address?: string;
+    trader_id?: number;
+    limit?: number;
+    cursor?: string;
+};
+export declare const positionTimelineParamsSchema: {
+    condition_id: z.ZodString;
+    address: z.ZodOptional<z.ZodString>;
+    trader_id: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+};
+export declare function buildPositionTimelineRequest(args: PositionTimelineArgs): {
+    path: string;
+    params: Record<string, string | number | undefined>;
+};
+export declare function registerGetPositionTimeline(server: McpServer, client: ApiClient): void;
+export {};
+//# sourceMappingURL=get-position-timeline.d.ts.map

package/dist/tools/get-position-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-position-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/get-position-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAY,MAAM,cAAc,CAAC;AAEnD,KAAK,oBAAoB,GAAG;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;CAWxC,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,oBAAoB,GAAG;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CACrD,CA0BA;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA6CtF"}

package/dist/tools/get-position-timeline.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { ApiError } from "../client.js";
+export const positionTimelineParamsSchema = {
+    condition_id: z.string().trim().min(1)
+        .describe("Market condition ID"),
+    address: z.string().trim().min(1).max(100).optional()
+        .describe("Trader identity: 0x... wallet, username, trd_-prefixed id, or bare integer traders.id"),
+    trader_id: z.number().int().positive().optional()
+        .describe("Internal traders.id alias"),
+    limit: z.number().int().min(1).max(100).default(20)
+        .describe("Max events (1-100, default 20)"),
+    cursor: z.string().optional()
+        .describe("Pagination cursor from previous response"),
+};
+export function buildPositionTimelineRequest(args) {
+    const conditionId = args.condition_id.trim();
+    if (!conditionId) {
+        throw new Error("condition_id is required");
+    }
+    const address = args.address?.trim();
+    const hasAddress = Boolean(address);
+    const hasTraderId = args.trader_id !== undefined;
+    if (hasAddress === hasTraderId) {
+        throw new Error("Provide exactly one of address or trader_id");
+    }
+    const path = hasTraderId
+        ? `/api/v1/traders/${args.trader_id}/position-timeline`
+        : `/api/v1/trader/${encodeURIComponent(address ?? "")}/position-timeline`;
+    return {
+        path,
+        params: {
+            condition_id: conditionId,
+            limit: args.limit,
+            cursor: args.cursor,
+        },
+    };
+}
+export function registerGetPositionTimeline(server, client) {
+    server.registerTool("get_position_timeline", {
+        title: "Get Position Timeline",
+        description: `Get stored Polymarket fills available for one tracked trader in one market, newest first, with server-computed running_amount and running_avg_price. Only HOT and WARM tier traders are tracked.
+
+Args:
+  - condition_id (string, required): Market condition ID
+  - address (string, optional): Trader identity: 0x... wallet, username, trd_-prefixed id, or bare integer traders.id
+  - trader_id (number, optional): Internal traders.id alias; provide exactly one of address or trader_id
+  - limit (number, 1-100, default 20): Max events per page
+  - cursor (string, optional): Pagination cursor from previous response
+
+Returns: List of position timeline events with pagination metadata.`,
+        inputSchema: positionTimelineParamsSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => {
+        try {
+            const request = buildPositionTimelineRequest(args);
+            const response = await client.request(request.path, request.params);
+            const result = {
+                data: response.data,
+                has_more: response.has_more,
+                next_cursor: response.next_cursor,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: error instanceof ApiError ? error.message : `Unexpected error: ${error}` }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-position-timeline.js.map

package/dist/tools/get-position-timeline.js.map

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

package/dist/tools/get-positions.d.ts

@@ -0,0 +1,31 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ApiClient } from "../client.js";
+export declare const positionsParamsSchema: {
+    limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    min_size: z.ZodDefault<z.ZodNumber>;
+    category: z.ZodOptional<z.ZodString>;
+    min_grade: z.ZodOptional<z.ZodEnum<{
+        S: "S";
+        A: "A";
+        B: "B";
+        C: "C";
+        D: "D";
+        F: "F";
+    }>>;
+    side: z.ZodOptional<z.ZodEnum<{
+        yes: "yes";
+        no: "no";
+    }>>;
+};
+export declare function buildPositionsParams(args: {
+    limit?: number;
+    cursor?: string;
+    min_size?: number;
+    category?: string;
+    min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
+    side?: "yes" | "no";
+}): Record<string, string | number | undefined>;
+export declare function registerGetPositions(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=get-positions.d.ts.map

package/dist/tools/get-positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-positions.d.ts","sourceRoot":"","sources":["../../src/tools/get-positions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAY,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;CAajC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC9C,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAS9C;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAgD/E"}

package/dist/tools/get-positions.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { ApiError } from "../client.js";
+export const positionsParamsSchema = {
+    limit: z.number().int().min(1).max(100).default(20)
+        .describe("Max results (1-100, default 20)"),
+    cursor: z.string().optional()
+        .describe("Pagination cursor from previous response"),
+    min_size: z.number().min(0).default(100)
+        .describe("Minimum current position value in USD"),
+    category: z.string().optional()
+        .describe("Filter by provider-backed market category"),
+    min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).optional()
+        .describe("Minimum trader grade"),
+    side: z.enum(["yes", "no"]).optional()
+        .describe("Filter by binary outcome side"),
+};
+export function buildPositionsParams(args) {
+    return {
+        limit: args.limit,
+        cursor: args.cursor,
+        min_size: args.min_size,
+        category: args.category,
+        min_grade: args.min_grade,
+        side: args.side,
+    };
+}
+export function registerGetPositions(server, client) {
+    server.registerTool("get_positions", {
+        title: "List Current Positions",
+        description: `List current prediction-market positions from the public positions-board feed. Returns trader, market, value, side, share, P&L, and freshness context. Cursor-paginated by current value descending.
+
+Args:
+  - limit (number, 1-100, default 20): Max results per page
+  - cursor (string, optional): Pagination cursor from previous response
+  - min_size (number, default 100): Minimum current value in USD
+  - category (string, optional): Filter by provider-backed market category
+  - min_grade (string, optional): Minimum trader grade (S, A, B, C, D, F)
+  - side (string, optional): Filter by binary side: "yes" or "no"
+
+Returns: List of current positions with pagination metadata.`,
+        inputSchema: positionsParamsSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => {
+        try {
+            const response = await client.request("/api/v1/positions", buildPositionsParams(args));
+            const result = {
+                data: response.data,
+                has_more: response.has_more,
+                next_cursor: response.next_cursor,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: error instanceof ApiError ? error.message : `Unexpected error: ${error}` }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-positions.js.map

package/dist/tools/get-positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-positions.js","sourceRoot":"","sources":["../../src/tools/get-positions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;SAChD,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC1B,QAAQ,CAAC,0CAA0C,CAAC;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;SACrC,QAAQ,CAAC,uCAAuC,CAAC;IACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC5B,QAAQ,CAAC,2CAA2C,CAAC;IACxD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE;SACzD,QAAQ,CAAC,sBAAsB,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;SACnC,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,IAOpC;IACC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAiB;IACvE,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE;;;;;;;;;;6DAU0C;QACvD,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,mBAAmB,EACnB,oBAAoB,CAAC,IAAI,CAAC,CAC3B,CAAC;YAEF,MAAM,MAAM,GAAG;gBACb,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;aAClC,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,KAAK,EAAE,EAAE,CAAC;aACrH,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-trader-pnl.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ApiClient } from "../client.js";
+export declare const traderPnlLookupSchema: z.ZodString;
+export declare function registerGetTraderPnl(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=get-trader-pnl.d.ts.map

package/dist/tools/get-trader-pnl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trader-pnl.d.ts","sourceRoot":"","sources":["../../src/tools/get-trader-pnl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAY,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,qBAAqB,aAAoC,CAAC;AAEvE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAwC/E"}

package/dist/tools/get-trader-pnl.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { ApiError } from "../client.js";
+export const traderPnlLookupSchema = z.string().trim().min(1).max(100);
+export function registerGetTraderPnl(server, client) {
+    server.registerTool("get_trader_pnl", {
+        title: "Get Trader P&L Time Series",
+        description: `Get a trader's daily P&L time series and pre-derived stats from the precomputed daily_pnl read model: daily cumulative entries, period stats (all/90d/30d/7d), monthly aggregation, per-year totals, and the drawdown series. A resolved trader with no daily P&L returns an empty structured object; an unknown address returns an error.
+
+Args:
+  - address (string, required): Ethereum wallet address (0x...), trader username, or trd_-prefixed trader id
+
+Returns: Trader daily P&L time series with period stats, monthly aggregation, per-year totals, and drawdown series.`,
+        inputSchema: {
+            address: traderPnlLookupSchema
+                .describe("Ethereum wallet address (0x...), username, or trd_-prefixed trader id"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ address }) => {
+        try {
+            const traderLookup = address.trim();
+            const response = await client.request(`/api/v1/trader/${encodeURIComponent(traderLookup)}/pnl`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: error instanceof ApiError ? error.message : `Unexpected error: ${error}` }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-trader-pnl.js.map

package/dist/tools/get-trader-pnl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trader-pnl.js","sourceRoot":"","sources":["../../src/tools/get-trader-pnl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvE,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAiB;IACvE,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE;;;;;oHAKiG;QAC9G,WAAW,EAAE;YACX,OAAO,EAAE,qBAAqB;iBAC3B,QAAQ,CAAC,uEAAuE,CAAC;SACrF;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACnC,kBAAkB,kBAAkB,CAAC,YAAY,CAAC,MAAM,CACzD,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,KAAK,EAAE,EAAE,CAAC;aACrH,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}