@zenalexa/unicli 0.219.0 → 0.220.0

package/dist/adapters/codex/projects.js

@@ -0,0 +1,147 @@
+/**
+ * @owner   src/adapters/codex/projects.ts
+ * @does    Register agent-facing Codex projects sidebar reader.
+ * @needs   Codex Electron DOM sidebar markers, project filtering, bounded conversation flattening.
+ * @feeds   surface coverage ledger, Codex project inventory workflows, visible thread selection context.
+ * @breaks  Codex sidebar DOM marker drift or weak filtering can hide visible projects.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { connectElectronApp } from "../_electron/shared.js";
+function cleanText(value) {
+    return String(value ?? "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function normalized(value) {
+    return cleanText(value).toLowerCase();
+}
+function matchesProject(project, query) {
+    const needle = normalized(query);
+    if (!needle)
+        return true;
+    const label = normalized(project.project);
+    const projectPath = normalized(project.projectPath);
+    return (label === needle ||
+        label.includes(needle) ||
+        projectPath === needle ||
+        projectPath.endsWith(`/${needle}`));
+}
+export function parseCodexProjectLimit(value) {
+    if (value === undefined || value === null || cleanText(value) === "")
+        return null;
+    const raw = cleanText(value);
+    if (!/^\d+$/.test(raw))
+        throw new Error("codex projects limit must be a positive integer.");
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isSafeInteger(n) || n < 1) {
+        throw new Error("codex projects limit must be a positive integer.");
+    }
+    return n;
+}
+export function flattenCodexProjectRows(projects, options = {}) {
+    const limit = parseCodexProjectLimit(options.limit);
+    const rows = [];
+    for (const project of projects) {
+        if (!matchesProject(project, options.project))
+            continue;
+        const conversations = limit
+            ? project.conversations.slice(0, limit)
+            : project.conversations;
+        if (conversations.length === 0) {
+            rows.push({
+                Project: project.project,
+                Index: 0,
+                Title: project.collapsed ? "(collapsed)" : "(no visible conversations)",
+                Updated: "",
+                Active: "",
+                ProjectPath: project.projectPath,
+                ThreadId: "",
+            });
+            continue;
+        }
+        for (const conversation of conversations) {
+            rows.push({
+                Project: project.project,
+                Index: conversation.index,
+                Title: conversation.title,
+                Updated: conversation.updated,
+                Active: conversation.active ? "yes" : "",
+                ProjectPath: project.projectPath,
+                ThreadId: conversation.threadId,
+            });
+        }
+    }
+    return rows;
+}
+function collectCodexProjectsScript() {
+    return `(() => {
+    const projectRows = Array.from(document.querySelectorAll('[data-app-action-sidebar-project-row]'));
+    const visibleText = (el) => (el?.innerText || el?.textContent || '').replace(/\\s+/g, ' ').trim();
+    const isRelativeTime = (text) => /^(?:(?:\\d+\\s*)?(?:刚刚|秒|分钟|小时|天|周|个月|年|sec|min|hr|hour|day|week|month|year|s|m|h|d|w)|.*\\bago)$/i.test(String(text || '').trim());
+    const updatedText = (row, title) => {
+      const candidates = Array.from(row.querySelectorAll('.tabular-nums, [class*="tabular-nums"], [class*="description"]')).map(visibleText).filter(Boolean);
+      const direct = candidates.find(isRelativeTime);
+      if (direct) return direct;
+      const suffix = visibleText(row).replace(title, '').trim();
+      return isRelativeTime(suffix) ? suffix : '';
+    };
+    return projectRows.map((projectRow, projectIndex) => {
+      const project = projectRow.getAttribute('data-app-action-sidebar-project-label') || projectRow.getAttribute('aria-label') || visibleText(projectRow);
+      const projectPath = projectRow.getAttribute('data-app-action-sidebar-project-id') || '';
+      const projectItem = projectRow.closest('[role="listitem"][aria-label]') || projectRow.parentElement;
+      const threadRows = projectItem ? Array.from(projectItem.querySelectorAll('[data-app-action-sidebar-thread-row]')) : [];
+      return {
+        index: projectIndex + 1,
+        project,
+        projectPath,
+        collapsed: projectRow.getAttribute('data-app-action-sidebar-project-collapsed') === 'true' || projectRow.getAttribute('aria-expanded') === 'false',
+        conversations: threadRows.map((row, index) => {
+          const title = row.getAttribute('data-app-action-sidebar-thread-title') || visibleText(row);
+          return {
+            index: index + 1,
+            title,
+            updated: updatedText(row, title),
+            active: row.getAttribute('data-app-action-sidebar-thread-active') === 'true',
+            threadId: row.getAttribute('data-app-action-sidebar-thread-id') || ''
+          };
+        })
+      };
+    });
+  })()`;
+}
+cli({
+    site: "codex",
+    name: "projects",
+    description: "List Codex projects and visible conversations from the sidebar",
+    domain: "localhost",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: "project",
+            type: "str",
+            description: "Filter by project label or path",
+        },
+        {
+            name: "limit",
+            type: "int",
+            description: "Max conversations per project",
+        },
+    ],
+    columns: ["Project", "Index", "Title", "Updated", "Active"],
+    func: async (_page, kwargs) => {
+        const page = await connectElectronApp("codex");
+        const projects = (await page.evaluate(collectCodexProjectsScript()));
+        if (!Array.isArray(projects)) {
+            throw new Error("Codex sidebar project extraction returned an invalid payload.");
+        }
+        const rows = flattenCodexProjectRows(projects, kwargs);
+        if (rows.length === 0) {
+            throw new Error(kwargs.project
+                ? `No Codex projects matched "${String(kwargs.project)}".`
+                : "No Codex projects were visible.");
+        }
+        return rows;
+    },
+});
+//# sourceMappingURL=projects.js.map

package/dist/adapters/codex/projects.js.map

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

package/dist/adapters/coingecko/markets.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @owner   src/adapters/coingecko/markets.ts
+ * @does    Register agent-facing CoinGecko market, coin, exchange, derivative, category, and global commands.
+ * @needs   Public CoinGecko API, TypeScript adapter loader, bounded market argument parsing.
+ * @feeds   surface coverage ledger, crypto market command surface, agent-readable market rows.
+ * @breaks  CoinGecko API drift, weak slug validation, or silent empty rows hide market data failures.
+ */
+export declare function requireCoinGeckoCurrency(value: unknown): string;
+export declare function requireCoinGeckoLimit(value: unknown, fallback: number, max: number, label?: string): number;
+export declare function mapCoinRow(data: Record<string, unknown>, currency: string): Record<string, unknown>;
+export declare function mapTopRows(rows: Array<Record<string, unknown>>): Array<Record<string, unknown>>;
+export declare function mapTrendingRows(coins: Array<{
+    item?: Record<string, unknown>;
+}>): Array<Record<string, unknown>>;
+export declare function mapCategoryRows(rows: Array<Record<string, unknown>>, limit: number): Array<Record<string, unknown>>;
+export declare function mapExchangeRows(rows: Array<Record<string, unknown>>, page: number, limit: number): Array<Record<string, unknown>>;
+export declare function mapDerivativeRows(rows: Array<Record<string, unknown>>, limit: number, symbolFilter?: string): Array<Record<string, unknown>>;
+export declare function mapGlobalRow(body: Record<string, unknown>, currency: string): Record<string, unknown>;
+//# sourceMappingURL=markets.d.ts.map

package/dist/adapters/coingecko/markets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../../src/adapters/coingecko/markets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuCH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ/D;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,SAAU,GACd,MAAM,CASR;AAYD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoCzB;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACnC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAYhC;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAC/C,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgBhC;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACpC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAYhC;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAWhC;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACpC,KAAK,EAAE,MAAM,EACb,YAAY,SAAK,GAChB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBhC;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB"}

package/dist/adapters/coingecko/markets.js

@@ -0,0 +1,474 @@
+/**
+ * @owner   src/adapters/coingecko/markets.ts
+ * @does    Register agent-facing CoinGecko market, coin, exchange, derivative, category, and global commands.
+ * @needs   Public CoinGecko API, TypeScript adapter loader, bounded market argument parsing.
+ * @feeds   surface coverage ledger, crypto market command surface, agent-readable market rows.
+ * @breaks  CoinGecko API drift, weak slug validation, or silent empty rows hide market data failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://api.coingecko.com/api/v3";
+const CATEGORY_SORTS = new Set([
+    "market_cap_desc",
+    "market_cap_asc",
+    "name_desc",
+    "name_asc",
+    "market_cap_change_24h_desc",
+    "market_cap_change_24h_asc",
+]);
+function stringField(value) {
+    return typeof value === "string" ? value : "";
+}
+function numberField(value) {
+    const n = typeof value === "number"
+        ? value
+        : typeof value === "string" && value.trim()
+            ? Number(value)
+            : NaN;
+    return Number.isFinite(n) ? n : null;
+}
+function slug(value, label) {
+    const text = String(value ?? "")
+        .trim()
+        .toLowerCase();
+    if (!text)
+        throw new Error(`coingecko ${label} cannot be empty.`);
+    if (!/^[a-z0-9][a-z0-9-]*$/.test(text)) {
+        throw new Error(`coingecko ${label} must be a lowercase slug.`);
+    }
+    return text;
+}
+export function requireCoinGeckoCurrency(value) {
+    const currency = String(value ?? "usd")
+        .trim()
+        .toLowerCase();
+    if (!/^[a-z0-9-]{2,20}$/.test(currency)) {
+        throw new Error(`coingecko currency must look like a currency slug.`);
+    }
+    return currency;
+}
+export function requireCoinGeckoLimit(value, fallback, max, label = "limit") {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > max) {
+        throw new Error(`coingecko ${label} must be an integer in [1, ${max}]. Got: ${String(value)}`);
+    }
+    return n;
+}
+function isoDate(value) {
+    return value ? String(value).slice(0, 10) : "";
+}
+function pickCurrency(map, currency) {
+    return map && typeof map === "object"
+        ? map[currency]
+        : null;
+}
+export function mapCoinRow(data, currency) {
+    const market = (data.market_data ?? {});
+    const price = pickCurrency(market.current_price, currency);
+    const marketCap = pickCurrency(market.market_cap, currency);
+    const volume24h = pickCurrency(market.total_volume, currency);
+    if (price == null && marketCap == null && volume24h == null) {
+        throw new Error(`coingecko returned no market data for currency "${currency}".`);
+    }
+    const homepage = Array.isArray(data.links?.homepage)
+        ? (data.links.homepage ?? []).find(Boolean)
+        : "";
+    return {
+        id: stringField(data.id),
+        symbol: stringField(data.symbol).toUpperCase(),
+        name: stringField(data.name),
+        rank: numberField(data.market_cap_rank),
+        price,
+        marketCap,
+        volume24h,
+        change24hPct: numberField(market.price_change_percentage_24h),
+        change7dPct: numberField(market.price_change_percentage_7d),
+        change30dPct: numberField(market.price_change_percentage_30d),
+        ath: pickCurrency(market.ath, currency),
+        athDate: isoDate(pickCurrency(market.ath_date, currency)),
+        atl: pickCurrency(market.atl, currency),
+        atlDate: isoDate(pickCurrency(market.atl_date, currency)),
+        circulatingSupply: numberField(market.circulating_supply),
+        totalSupply: numberField(market.total_supply),
+        maxSupply: numberField(market.max_supply),
+        genesisDate: stringField(data.genesis_date),
+        homepage: homepage ? String(homepage) : "",
+    };
+}
+export function mapTopRows(rows) {
+    return rows.map((coin) => ({
+        rank: numberField(coin.market_cap_rank),
+        symbol: stringField(coin.symbol).toUpperCase(),
+        name: stringField(coin.name),
+        price: numberField(coin.current_price),
+        change24hPct: numberField(coin.price_change_percentage_24h),
+        marketCap: numberField(coin.market_cap),
+        volume24h: numberField(coin.total_volume),
+        high24h: numberField(coin.high_24h),
+        low24h: numberField(coin.low_24h),
+    }));
+}
+export function mapTrendingRows(coins) {
+    return coins.map((entry, index) => {
+        const coin = entry.item ?? {};
+        return {
+            rank: index + 1,
+            id: stringField(coin.id),
+            symbol: stringField(coin.symbol).toUpperCase(),
+            name: stringField(coin.name),
+            marketCapRank: numberField(coin.market_cap_rank),
+            priceBtc: numberField(coin.price_btc),
+            thumb: stringField(coin.thumb) ||
+                stringField(coin.small) ||
+                stringField(coin.large),
+        };
+    });
+}
+export function mapCategoryRows(rows, limit) {
+    return rows.slice(0, limit).map((category, index) => ({
+        rank: index + 1,
+        id: stringField(category.id),
+        name: stringField(category.name),
+        marketCap: numberField(category.market_cap),
+        volume24h: numberField(category.volume_24h),
+        marketCapChange24hPct: numberField(category.market_cap_change_24h),
+        top3Coins: Array.isArray(category.top_3_coins_id)
+            ? category.top_3_coins_id.join(", ")
+            : "",
+    }));
+}
+export function mapExchangeRows(rows, page, limit) {
+    return rows.map((exchange, index) => ({
+        rank: (page - 1) * limit + index + 1,
+        id: stringField(exchange.id),
+        name: stringField(exchange.name),
+        trustScore: numberField(exchange.trust_score),
+        volume24hBtc: numberField(exchange.trade_volume_24h_btc),
+        country: stringField(exchange.country),
+        yearEstablished: numberField(exchange.year_established),
+        url: stringField(exchange.url),
+    }));
+}
+export function mapDerivativeRows(rows, limit, symbolFilter = "") {
+    const filter = symbolFilter.trim().toUpperCase();
+    const filtered = filter
+        ? rows.filter((row) => stringField(row.symbol).toUpperCase().includes(filter) ||
+            stringField(row.index_id).toUpperCase().includes(filter))
+        : rows;
+    if (filtered.length === 0) {
+        throw new Error(`No derivative tickers matched symbol="${filter}".`);
+    }
+    return filtered.slice(0, limit).map((row, index) => ({
+        rank: index + 1,
+        market: stringField(row.market),
+        symbol: stringField(row.symbol),
+        indexId: stringField(row.index_id),
+        contractType: stringField(row.contract_type),
+        price: numberField(row.price),
+        change24hPct: numberField(row.price_percentage_change_24h),
+        fundingRate: numberField(row.funding_rate),
+        openInterestUsd: numberField(row.open_interest),
+        volume24hUsd: numberField(row.volume_24h),
+        expired: row.expired_at ? String(row.expired_at) : "",
+    }));
+}
+export function mapGlobalRow(body, currency) {
+    const data = (body.data ?? {});
+    const totalMarketCap = pickCurrency(data.total_market_cap, currency);
+    const totalVolume = pickCurrency(data.total_volume, currency);
+    if (totalMarketCap == null && totalVolume == null) {
+        throw new Error(`coingecko has no market totals for currency "${currency}".`);
+    }
+    const dominance = (data.market_cap_percentage ?? {});
+    return {
+        currency: currency.toUpperCase(),
+        totalMarketCap: numberField(totalMarketCap),
+        totalVolume24h: numberField(totalVolume),
+        marketCapChange24hPct: numberField(data.market_cap_change_percentage_24h_usd),
+        btcDominancePct: numberField(dominance.btc),
+        ethDominancePct: numberField(dominance.eth),
+        activeCryptocurrencies: numberField(data.active_cryptocurrencies),
+        markets: numberField(data.markets),
+        ongoingIcos: numberField(data.ongoing_icos),
+        updatedAt: data.updated_at
+            ? new Date(Number(data.updated_at) * 1000).toISOString()
+            : "",
+    };
+}
+async function fetchJson(url, label) {
+    const response = await fetch(url, {
+        headers: { "User-Agent": "unicli (https://github.com/olo-dot-io/Uni-CLI)" },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "coingecko",
+    name: "coin",
+    description: "Fetch a single cryptocurrency's market data by CoinGecko id",
+    domain: "api.coingecko.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "CoinGecko coin id",
+        },
+        {
+            name: "currency",
+            type: "str",
+            default: "usd",
+            description: "Quote currency",
+        },
+    ],
+    columns: [
+        "id",
+        "symbol",
+        "name",
+        "rank",
+        "price",
+        "marketCap",
+        "volume24h",
+        "change24hPct",
+        "change7dPct",
+        "change30dPct",
+        "ath",
+        "athDate",
+        "atl",
+        "atlDate",
+        "circulatingSupply",
+        "totalSupply",
+        "maxSupply",
+        "genesisDate",
+        "homepage",
+    ],
+    func: async (_page, kwargs) => {
+        const id = slug(kwargs.id, "coin id");
+        const currency = requireCoinGeckoCurrency(kwargs.currency);
+        const url = new URL(`${API_BASE}/coins/${id}`);
+        url.searchParams.set("localization", "false");
+        url.searchParams.set("tickers", "false");
+        url.searchParams.set("market_data", "true");
+        url.searchParams.set("community_data", "false");
+        url.searchParams.set("developer_data", "false");
+        url.searchParams.set("sparkline", "false");
+        return [
+            mapCoinRow((await fetchJson(url, "coingecko coin")), currency),
+        ];
+    },
+});
+cli({
+    site: "coingecko",
+    name: "top",
+    description: "Top coins by market cap",
+    domain: "api.coingecko.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "currency",
+            type: "str",
+            default: "usd",
+            description: "Quote currency",
+        },
+        { name: "limit", type: "int", default: 10, description: "Number of coins" },
+    ],
+    columns: [
+        "rank",
+        "symbol",
+        "name",
+        "price",
+        "change24hPct",
+        "marketCap",
+        "volume24h",
+        "high24h",
+        "low24h",
+    ],
+    func: async (_page, kwargs) => {
+        const currency = requireCoinGeckoCurrency(kwargs.currency);
+        const limit = requireCoinGeckoLimit(kwargs.limit, 10, 250);
+        const url = new URL(`${API_BASE}/coins/markets`);
+        url.searchParams.set("vs_currency", currency);
+        url.searchParams.set("order", "market_cap_desc");
+        url.searchParams.set("per_page", String(limit));
+        url.searchParams.set("page", "1");
+        url.searchParams.set("sparkline", "false");
+        const rows = mapTopRows((await fetchJson(url, "coingecko top")));
+        if (rows.length === 0)
+            throw new Error("coingecko returned no market data.");
+        return rows;
+    },
+});
+cli({
+    site: "coingecko",
+    name: "trending",
+    description: "Top trending cryptocurrencies on CoinGecko",
+    domain: "api.coingecko.com",
+    strategy: Strategy.PUBLIC,
+    args: [],
+    columns: [
+        "rank",
+        "id",
+        "symbol",
+        "name",
+        "marketCapRank",
+        "priceBtc",
+        "thumb",
+    ],
+    func: async () => {
+        const body = (await fetchJson(`${API_BASE}/search/trending`, "coingecko trending"));
+        const rows = mapTrendingRows(Array.isArray(body.coins) ? body.coins : []);
+        if (rows.length === 0)
+            throw new Error("coingecko returned no trending coins.");
+        return rows;
+    },
+});
+cli({
+    site: "coingecko",
+    name: "categories",
+    description: "Crypto categories ranked by aggregated market cap",
+    domain: "api.coingecko.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "sort",
+            type: "str",
+            default: "market_cap_desc",
+            description: "Sort order",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of categories",
+        },
+    ],
+    columns: [
+        "rank",
+        "id",
+        "name",
+        "marketCap",
+        "volume24h",
+        "marketCapChange24hPct",
+        "top3Coins",
+    ],
+    func: async (_page, kwargs) => {
+        const sort = String(kwargs.sort ?? "market_cap_desc")
+            .trim()
+            .toLowerCase();
+        if (!CATEGORY_SORTS.has(sort))
+            throw new Error(`coingecko sort "${String(kwargs.sort)}" is not supported.`);
+        const limit = requireCoinGeckoLimit(kwargs.limit, 20, 100);
+        const rows = mapCategoryRows((await fetchJson(`${API_BASE}/coins/categories?order=${encodeURIComponent(sort)}`, "coingecko categories")), limit);
+        if (rows.length === 0)
+            throw new Error("CoinGecko returned no category data.");
+        return rows;
+    },
+});
+cli({
+    site: "coingecko",
+    name: "exchanges",
+    description: "Top crypto exchanges by 24h BTC trading volume",
+    domain: "api.coingecko.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of exchanges",
+        },
+        { name: "page", type: "int", default: 1, description: "Page number" },
+    ],
+    columns: [
+        "rank",
+        "id",
+        "name",
+        "trustScore",
+        "volume24hBtc",
+        "country",
+        "yearEstablished",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const limit = requireCoinGeckoLimit(kwargs.limit, 20, 250);
+        const page = requireCoinGeckoLimit(kwargs.page, 1, 10_000, "page");
+        const url = new URL(`${API_BASE}/exchanges`);
+        url.searchParams.set("per_page", String(limit));
+        url.searchParams.set("page", String(page));
+        const rows = mapExchangeRows((await fetchJson(url, "coingecko exchanges")), page, limit);
+        if (rows.length === 0)
+            throw new Error("CoinGecko returned no exchange data.");
+        return rows;
+    },
+});
+cli({
+    site: "coingecko",
+    name: "derivatives",
+    description: "Top crypto derivative markets by 24h volume",
+    domain: "api.coingecko.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        { name: "limit", type: "int", default: 20, description: "Max rows" },
+        {
+            name: "symbol",
+            type: "str",
+            description: "Optional symbol substring filter",
+        },
+    ],
+    columns: [
+        "rank",
+        "market",
+        "symbol",
+        "indexId",
+        "contractType",
+        "price",
+        "change24hPct",
+        "fundingRate",
+        "openInterestUsd",
+        "volume24hUsd",
+        "expired",
+    ],
+    func: async (_page, kwargs) => {
+        const limit = requireCoinGeckoLimit(kwargs.limit, 20, 500);
+        return mapDerivativeRows((await fetchJson(`${API_BASE}/derivatives`, "coingecko derivatives")), limit, String(kwargs.symbol ?? ""));
+    },
+});
+cli({
+    site: "coingecko",
+    name: "global",
+    description: "Aggregate crypto market stats",
+    domain: "api.coingecko.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "currency",
+            type: "str",
+            default: "usd",
+            description: "Quote currency",
+        },
+    ],
+    columns: [
+        "currency",
+        "totalMarketCap",
+        "totalVolume24h",
+        "marketCapChange24hPct",
+        "btcDominancePct",
+        "ethDominancePct",
+        "activeCryptocurrencies",
+        "markets",
+        "ongoingIcos",
+        "updatedAt",
+    ],
+    func: async (_page, kwargs) => [
+        mapGlobalRow((await fetchJson(`${API_BASE}/global`, "coingecko global")), requireCoinGeckoCurrency(kwargs.currency)),
+    ],
+});
+//# sourceMappingURL=markets.js.map