@alva-ai/toolkit 0.4.3 → 0.7.0-beta.0

package/dist/index.js

@@ -209,6 +209,25 @@ var DeployResource = class {
       `/api/v1/deploy/cronjob/${params.id}/resume`
     );
   }
+  /**
+   * Fire the cronjob workflow once, immediately, bypassing the schedule.
+   * Async — returns the Hatchet workflow run id at enqueue. The
+   * `cronjob_runs` row appears only after the worker finishes the run;
+   * callers verify completion by polling `listRuns({cronjob_id})` and
+   * matching `runs[].workflow_run_id` against the returned id.
+   *
+   * Surfaces backend status as HTTP errors (handled by AlvaClient):
+   * - 404 not found / cross-user
+   * - 412 cronjob is paused (resume before triggering)
+   * - 503 worker workflow handle not yet connected (startup race)
+   */
+  async trigger(params) {
+    this.client._requireAuth();
+    return this.client._request(
+      "POST",
+      `/api/v1/deploy/cronjob/${params.id}/trigger`
+    );
+  }
   async listRuns(params) {
     this.client._requireAuth();
     return this.client._request(
@@ -255,7 +274,8 @@ var ReleaseResource = class {
         display_name: params.display_name,
         description: params.description,
         feeds: params.feeds,
-        trading_symbols: params.trading_symbols
+        trading_symbols: params.trading_symbols,
+        template_id: params.template_id
       }
     });
   }
@@ -266,7 +286,8 @@ var ReleaseResource = class {
         name: params.name,
         version: params.version,
         feeds: params.feeds,
-        changelog: params.changelog
+        changelog: params.changelog,
+        readme_url: params.readme_url
       }
     });
   }
@@ -339,8 +360,1060 @@ var SdkDocsResource = class {
   }
 };
 
-// src/resources/skills.ts
-var SkillsResource = class {
+// src/resources/skillTiers.ts
+var SKILL_ENDPOINT_METADATA = [
+  {
+    skill: "arrays-data-api-spot-market-price-and-volume",
+    file: "crypto-detail",
+    method: "GET",
+    path: "/api/v1/crypto/detail",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "fear-greed-index",
+    method: "GET",
+    path: "/api/v1/crypto/fear-greed-index",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-futures-data",
+    file: "funding-rate",
+    method: "GET",
+    path: "/api/v1/crypto/funding-rate",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-spot-market-price-and-volume",
+    file: "crypto-futures-ohlcv",
+    method: "GET",
+    path: "/api/v1/crypto/futures/ohlcv",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-spot-market-price-and-volume",
+    file: "crypto-kline",
+    method: "GET",
+    path: "/api/v1/crypto/kline",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "list",
+    method: "GET",
+    path: "/api/v1/crypto/list",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-futures-data",
+    file: "long-short-ratio",
+    method: "GET",
+    path: "/api/v1/crypto/long-short-ratio",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "crypto-market-cap",
+    method: "GET",
+    path: "/api/v1/crypto/market-cap",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "market-metrics",
+    method: "GET",
+    path: "/api/v1/crypto/market-metrics",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-spot-market-price-and-volume",
+    file: "crypto-ohlcv",
+    method: "GET",
+    path: "/api/v1/crypto/ohlcv",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-futures-data",
+    file: "open-interest",
+    method: "GET",
+    path: "/api/v1/crypto/open-interest",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "screener-metrics",
+    method: "GET",
+    path: "/api/v1/crypto/screener/metrics",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "screener-metrics-timerange",
+    method: "GET",
+    path: "/api/v1/crypto/screener/metrics/timerange",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "trading-pair",
+    method: "GET",
+    path: "/api/v1/crypto/trading-pair",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-etf-fundamentals",
+    file: "country-weightings",
+    method: "GET",
+    path: "/api/v1/etf/country-weightings",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-etf-fundamentals",
+    file: "holdings",
+    method: "GET",
+    path: "/api/v1/etf/holdings",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-etf-fundamentals",
+    file: "info",
+    method: "GET",
+    path: "/api/v1/etf/info",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-etf-fundamentals",
+    file: "sector-weightings",
+    method: "GET",
+    path: "/api/v1/etf/sector-weightings",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-macro-and-economics",
+    file: "macro-commodity-historical",
+    method: "GET",
+    path: "/api/v1/macro/commodity/historical",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-macro-and-economics",
+    file: "macro-commodity-real-time",
+    method: "GET",
+    path: "/api/v1/macro/commodity/real-time",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-macro-and-economics",
+    file: "macro-commodity-symbol-list",
+    method: "GET",
+    path: "/api/v1/macro/commodity/symbols",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-macro-and-economics",
+    file: "economic-indicators",
+    method: "GET",
+    path: "/api/v1/macro/economic-indicators",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-macro-and-economics",
+    file: "macro-forex-historical",
+    method: "GET",
+    path: "/api/v1/macro/forex/historical",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-macro-and-economics",
+    file: "macro-forex-real-time",
+    method: "GET",
+    path: "/api/v1/macro/forex/real-time",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-macro-and-economics",
+    file: "macro-forex-symbol-list",
+    method: "GET",
+    path: "/api/v1/macro/forex/symbols",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-macro-and-economics",
+    file: "macro-index-historical",
+    method: "GET",
+    path: "/api/v1/macro/index/historical",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-macro-and-economics",
+    file: "macro-index-real-time",
+    method: "GET",
+    path: "/api/v1/macro/index/real-time",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-macro-and-economics",
+    file: "rates",
+    method: "GET",
+    path: "/api/v1/macro/treasury-rates",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-fundamentals",
+    file: "company-balance-sheets",
+    method: "GET",
+    path: "/api/v1/stocks/company/balance-sheets",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-fundamentals",
+    file: "company-cashflow-statements",
+    method: "GET",
+    path: "/api/v1/stocks/company/cashflow-statements",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-fundamentals",
+    file: "company-detail",
+    method: "GET",
+    path: "/api/v1/stocks/company/detail",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-fundamentals",
+    file: "company-income-statements",
+    method: "GET",
+    path: "/api/v1/stocks/company/income-statements",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-fundamentals",
+    file: "company-kpi",
+    method: "GET",
+    path: "/api/v1/stocks/company/kpi",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-events",
+    file: "crowdfunding-offerings",
+    method: "GET",
+    path: "/api/v1/stocks/crowdfunding/offerings",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-events",
+    file: "dividends",
+    method: "GET",
+    path: "/api/v1/stocks/dividends",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-events",
+    file: "earnings-calendar",
+    method: "GET",
+    path: "/api/v1/stocks/earnings-calendar",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-events",
+    file: "equity-offering",
+    method: "GET",
+    path: "/api/v1/stocks/equity-offering",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-stock-metrics",
+    file: "financial-metrics",
+    method: "GET",
+    path: "/api/v1/stocks/financial-metrics",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-fundamentals",
+    file: "fiscal-dates",
+    method: "GET",
+    path: "/api/v1/stocks/fiscal-dates",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-fundamentals",
+    file: "fiscal-dates-range",
+    method: "GET",
+    path: "/api/v1/stocks/fiscal-dates/range",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-events",
+    file: "ipo-calendar",
+    method: "GET",
+    path: "/api/v1/stocks/ipo-calendar",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-events",
+    file: "ipo-confirmed-calendar",
+    method: "GET",
+    path: "/api/v1/stocks/ipo-confirmed-calendar",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-spot-market-price-and-volume",
+    file: "stocks-kline",
+    method: "GET",
+    path: "/api/v1/stocks/kline",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-stock-metrics",
+    file: "market-metrics",
+    method: "GET",
+    path: "/api/v1/stocks/market-metrics",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-events",
+    file: "mergers-acquisitions",
+    method: "GET",
+    path: "/api/v1/stocks/mergers-acquisitions",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-fundamentals",
+    file: "outstanding-shares",
+    method: "GET",
+    path: "/api/v1/stocks/outstanding-shares",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-stock-metrics",
+    file: "ratings",
+    method: "GET",
+    path: "/api/v1/stocks/ratings",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-stock-screener",
+    file: "basic-info-screener",
+    method: "GET",
+    path: "/api/v1/stocks/screener/basic-info/{sub}",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-stock-screener",
+    file: "event-screener",
+    method: "GET",
+    path: "/api/v1/stocks/screener/events",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-stock-screener",
+    file: "screener-financial-metrics",
+    method: "GET",
+    path: "/api/v1/stocks/screener/financial-metrics",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-stock-screener",
+    file: "screener-financial-metrics-timerange",
+    method: "GET",
+    path: "/api/v1/stocks/screener/financial-metrics/timerange",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-stock-screener",
+    file: "screener-technical-metrics",
+    method: "GET",
+    path: "/api/v1/stocks/screener/technical-metrics",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-stock-screener",
+    file: "screener-technical-metrics-timerange",
+    method: "GET",
+    path: "/api/v1/stocks/screener/technical-metrics/timerange",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-events",
+    file: "sec-earnings-release",
+    method: "GET",
+    path: "/api/v1/stocks/sec-earnings-release",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-fundamentals",
+    file: "shares-float",
+    method: "GET",
+    path: "/api/v1/stocks/shares-float",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-equity-events",
+    file: "splits",
+    method: "GET",
+    path: "/api/v1/stocks/splits",
+    tier: "public",
+    required_subscription_tier: "free",
+    access: "free_and_pro",
+    pro_required: false
+  },
+  {
+    skill: "arrays-data-api-crypto-exchange-flow",
+    file: "exchange-flows",
+    method: "GET",
+    path: "/api/v1/crypto/exchange-flows",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-company-crypto-holdings",
+    file: "crypto-holdings",
+    method: "GET",
+    path: "/api/v1/crypto/holdings",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "metrics-inflow-cdd",
+    method: "GET",
+    path: "/api/v1/crypto/metrics/inflow-cdd",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "metrics-leverage-ratio",
+    method: "GET",
+    path: "/api/v1/crypto/metrics/leverage-ratio",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "metrics-miner-to-exchange",
+    method: "GET",
+    path: "/api/v1/crypto/metrics/miner-to-exchange",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "metrics-mvrv",
+    method: "GET",
+    path: "/api/v1/crypto/metrics/mvrv",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "metrics-nupl",
+    method: "GET",
+    path: "/api/v1/crypto/metrics/nupl",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "metrics-puell-multiple",
+    method: "GET",
+    path: "/api/v1/crypto/metrics/puell-multiple",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "metrics-realized-price",
+    method: "GET",
+    path: "/api/v1/crypto/metrics/realized-price",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "metrics-sopr",
+    method: "GET",
+    path: "/api/v1/crypto/metrics/sopr",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "metrics-ssr",
+    method: "GET",
+    path: "/api/v1/crypto/metrics/ssr",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "metrics-whale-ratio",
+    method: "GET",
+    path: "/api/v1/crypto/metrics/whale-ratio",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "crypto-supply",
+    method: "GET",
+    path: "/api/v1/crypto/supply",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-futures-data",
+    file: "taker-buy-sell-volume",
+    method: "GET",
+    path: "/api/v1/crypto/taker-buy-sell-volume",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-crypto-metrics-and-screener",
+    file: "unlock-events",
+    method: "GET",
+    path: "/api/v1/crypto/unlock-events",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-etf-fundamentals",
+    file: "flow",
+    method: "GET",
+    path: "/api/v1/etf/flow",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-options",
+    file: "contracts",
+    method: "GET",
+    path: "/api/v1/options/contracts",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-options",
+    file: "kline",
+    method: "GET",
+    path: "/api/v1/options/kline",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-equity-fundamentals",
+    file: "company-executives",
+    method: "GET",
+    path: "/api/v1/stocks/company/executives",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-equity-estimates-and-targets",
+    file: "company-price-target-consensus",
+    method: "GET",
+    path: "/api/v1/stocks/company/price-target-consensus",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-equity-estimates-and-targets",
+    file: "company-price-target-news",
+    method: "GET",
+    path: "/api/v1/stocks/company/price-target-news",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-equity-estimates-and-targets",
+    file: "company-price-target-summary",
+    method: "GET",
+    path: "/api/v1/stocks/company/price-target-summary",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-equity-ownership-and-flow",
+    file: "congress-recent-trades",
+    method: "GET",
+    path: "/api/v1/stocks/congress/recent-trades",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-equity-ownership-and-flow",
+    file: "senate-trade",
+    method: "GET",
+    path: "/api/v1/stocks/company/senate-trade",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-stock-metrics",
+    file: "darkpool",
+    method: "GET",
+    path: "/api/v1/stocks/darkpool",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-equity-estimates-and-targets",
+    file: "estimates-guidance",
+    method: "GET",
+    path: "/api/v1/stocks/estimates-guidance",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-equity-ownership-and-flow",
+    file: "insider-transactions",
+    method: "GET",
+    path: "/api/v1/stocks/insider/transactions",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-equity-ownership-and-flow",
+    file: "institution-holder",
+    method: "GET",
+    path: "/api/v1/stocks/institution-holder",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "activity",
+    method: "GET",
+    path: "polymarket:/activity",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "book",
+    method: "GET",
+    path: "polymarket:/book",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "closed-positions",
+    method: "GET",
+    path: "polymarket:/closed-positions",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "events",
+    method: "GET",
+    path: "polymarket:/events",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "holders",
+    method: "GET",
+    path: "polymarket:/holders",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "markets",
+    method: "GET",
+    path: "polymarket:/markets",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "midpoint",
+    method: "GET",
+    path: "polymarket:/midpoint",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "oi",
+    method: "GET",
+    path: "polymarket:/oi",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "positions",
+    method: "GET",
+    path: "polymarket:/positions",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "price",
+    method: "GET",
+    path: "polymarket:/price",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "prices-history",
+    method: "GET",
+    path: "polymarket:/prices-history",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "public-search",
+    method: "GET",
+    path: "polymarket:/public-search",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "series",
+    method: "GET",
+    path: "polymarket:/series",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "sports",
+    method: "GET",
+    path: "polymarket:/sports",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "spread",
+    method: "GET",
+    path: "polymarket:/spread",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "tags",
+    method: "GET",
+    path: "polymarket:/tags",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "trades",
+    method: "GET",
+    path: "polymarket:/trades",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-polymarket",
+    file: "value",
+    method: "GET",
+    path: "polymarket:/value",
+    tier: "alternative",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-equity-events",
+    file: "earnings-transcript",
+    method: "GET",
+    path: "/api/v1/stocks/earnings-transcript",
+    tier: "unstructured",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  },
+  {
+    skill: "arrays-data-api-news",
+    file: "market-news",
+    method: "GET",
+    path: "/api/v1/stocks/market-news",
+    tier: "unstructured",
+    required_subscription_tier: "pro",
+    access: "pro_only",
+    pro_required: true
+  }
+];
+function getSkillEndpointMetadata(skill, file) {
+  return SKILL_ENDPOINT_METADATA.find(
+    (item) => item.skill === skill && item.file === file
+  );
+}
+function listSkillEndpointMetadata(skill) {
+  return SKILL_ENDPOINT_METADATA.filter((item) => item.skill === skill);
+}
+
+// src/resources/dataSkills.ts
+var DataSkillsResource = class {
   constructor(client) {
     this.client = client;
   }
@@ -350,7 +1423,12 @@ var SkillsResource = class {
       baseUrl: this.client.arraysBaseUrl,
       noAuth: true
     });
-    return { skills: res.data ?? [] };
+    return {
+      skills: (res.data ?? []).map((skill) => ({
+        ...skill,
+        ...metadataSummaryForSkill(skill.name)
+      }))
+    };
   }
   async summary(params) {
     const encoded = encodeURIComponent(params.name);
@@ -365,7 +1443,12 @@ var SkillsResource = class {
     const doc = res.data?.[0];
     if (!doc)
       throw new Error(`empty skills summary response for "${params.name}"`);
-    return doc;
+    const endpointMetadata = listSkillEndpointMetadata(params.name);
+    return {
+      ...doc,
+      ...metadataSummaryForSkill(params.name),
+      ...endpointMetadata.length > 0 ? { endpoint_metadata: endpointMetadata } : {}
+    };
   }
   async endpoint(params) {
     const encoded = encodeURIComponent(params.name);
@@ -384,7 +1467,103 @@ var SkillsResource = class {
         `empty skills endpoint response for "${params.name}" file "${params.file}"`
       );
     }
-    return doc;
+    const metadata = getSkillEndpointMetadata(params.name, params.file);
+    return {
+      ...doc,
+      ...metadata ? { metadata } : {}
+    };
+  }
+};
+function metadataSummaryForSkill(skill) {
+  const endpointMetadata = listSkillEndpointMetadata(skill);
+  if (endpointMetadata.length === 0) {
+    return {};
+  }
+  const counts = {};
+  let proCount = 0;
+  for (const endpoint of endpointMetadata) {
+    counts[endpoint.tier] = (counts[endpoint.tier] ?? 0) + 1;
+    if (endpoint.pro_required) proCount += 1;
+  }
+  return {
+    endpoint_tier_counts: counts,
+    metadata: {
+      endpoint_count: endpointMetadata.length,
+      endpoint_tier_counts: counts,
+      pro_count: proCount
+    }
+  };
+}
+
+// src/resources/playbookSkills.ts
+function parsePlaybookSkillId(s) {
+  const parts = s.split("/");
+  if (parts.length !== 2 || !parts[0] || !parts[1]) {
+    throw new AlvaError(
+      "INVALID_ARGUMENT",
+      `playbook skill identifier must be "<user>/<name>", got "${s}"`,
+      0
+    );
+  }
+  return { username: parts[0], name: parts[1] };
+}
+var PlaybookSkillsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async list(params) {
+    const query = {};
+    if (params?.tag) query.tag = params.tag;
+    if (params?.username) query.username = params.username;
+    const res = await this.client._request("GET", "/api/v1/skills", {
+      query
+    });
+    return { skills: res.data ?? [] };
+  }
+  async tags() {
+    const res = await this.client._request(
+      "GET",
+      "/api/v1/skills/tags"
+    );
+    return { tags: res.data ?? [] };
+  }
+  async get(id) {
+    const { username, name } = parsePlaybookSkillId(id);
+    const u = encodeURIComponent(username);
+    const n = encodeURIComponent(name);
+    const res = await this.client._request(
+      "GET",
+      `/api/v1/skills/${u}/${n}`
+    );
+    const meta = res.data?.[0];
+    if (!meta) {
+      throw new AlvaError(
+        "NOT_FOUND",
+        `empty playbook skills get response for ${id}`,
+        0
+      );
+    }
+    return meta;
+  }
+  async file(id, path) {
+    const { username, name } = parsePlaybookSkillId(id);
+    const u = encodeURIComponent(username);
+    const n = encodeURIComponent(name);
+    const p = path.split("/").map(encodeURIComponent).join("/");
+    const res = await this.client._request(
+      "GET",
+      `/api/v1/skills/${u}/${n}/files/${p}`
+    );
+    const out = res.data?.[0];
+    if (!out) {
+      throw new AlvaError(
+        "NOT_FOUND",
+        `empty playbook skills file response for ${id} path ${path}`,
+        0
+      );
+    }
+    return out;
   }
 };
 
@@ -448,7 +1627,10 @@ var ScreenshotResource = class {
       query: {
         url: params.url,
         selector: params.selector,
-        xpath: params.xpath
+        xpath: params.xpath,
+        compress: params.compress,
+        compress_quality: params.compressQuality,
+        compress_max_width: params.compressMaxWidth
       }
     });
   }
@@ -765,7 +1947,8 @@ var AlvaClient = class {
   _release;
   _secrets;
   _sdk;
-  _skills;
+  _dataSkills;
+  _playbookSkills;
   _comments;
   _remix;
   _screenshot;
@@ -799,8 +1982,11 @@ var AlvaClient = class {
   get sdk() {
     return this._sdk ??= new SdkDocsResource(this);
   }
-  get skills() {
-    return this._skills ??= new SkillsResource(this);
+  get dataSkills() {
+    return this._dataSkills ??= new DataSkillsResource(this);
+  }
+  get playbookSkills() {
+    return this._playbookSkills ??= new PlaybookSkillsResource(this);
   }
   get comments() {
     return this._comments ??= new CommentsResource(this);
@@ -921,7 +2107,7 @@ var AlvaClient = class {
 };
 
 // src/index.ts
-var VERSION = true ? "0.4.3" : "dev";
+var VERSION = true ? "0.7.0-beta.0" : "dev";
 export {
   AlvaClient,
   AlvaError,