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

package/dist/cli.js

@@ -219,6 +219,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(
@@ -265,7 +284,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
       }
     });
   }
@@ -276,7 +296,8 @@ var ReleaseResource = class {
         name: params.name,
         version: params.version,
         feeds: params.feeds,
-        changelog: params.changelog
+        changelog: params.changelog,
+        readme_url: params.readme_url
       }
     });
   }
@@ -349,8 +370,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;
   }
@@ -360,7 +1433,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);
@@ -375,7 +1453,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);
@@ -394,7 +1477,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;
   }
 };
 
@@ -458,7 +1637,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
       }
     });
   }
@@ -698,6 +1880,69 @@ var PushSubscriptionsResource = class {
   }
 };
 
+// src/resources/channelGroupSubscriptions.ts
+var ChannelGroupSubscriptionsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async context(params) {
+    this.client._requireAuth();
+    return this.client._request(
+      "GET",
+      "/api/v1/channel/group-subscriptions/context",
+      {
+        query: { session_id: params.session_id }
+      }
+    );
+  }
+  async list(params) {
+    this.client._requireAuth();
+    return this.client._request("GET", "/api/v1/channel/group-subscriptions", {
+      query: { session_id: params.session_id }
+    });
+  }
+  async subscribe(params) {
+    this.client._requireAuth();
+    return this.client._request("POST", "/api/v1/channel/group-subscriptions", {
+      jsonBody: mutationBody(params)
+    });
+  }
+  async unsubscribe(params) {
+    this.client._requireAuth();
+    return this.client._request(
+      "DELETE",
+      "/api/v1/channel/group-subscriptions",
+      {
+        jsonBody: mutationBody(params)
+      }
+    );
+  }
+};
+function mutationBody(params) {
+  return `{"session_id":${idLiteral(params.session_id)},"target_type":${JSON.stringify(params.target_type)},"target_id":${idLiteral(params.target_id)}}`;
+}
+function idLiteral(value) {
+  if (typeof value === "number") {
+    if (!Number.isInteger(value) || value <= 0 || !Number.isSafeInteger(value)) {
+      throw new AlvaError(
+        "INVALID_ARGUMENT",
+        "channel group subscription ids must be positive safe integers; pass large int64 ids as strings",
+        0
+      );
+    }
+    return String(value);
+  }
+  if (!/^[1-9]\d*$/.test(value)) {
+    throw new AlvaError(
+      "INVALID_ARGUMENT",
+      "channel group subscription ids must be positive integer strings",
+      0
+    );
+  }
+  return value;
+}
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api-llm.prd.alva.ai";
 var DEFAULT_ARRAYS_BASE_URL = "https://data-tools.prd.space.id";
@@ -712,7 +1957,8 @@ var AlvaClient = class {
   _release;
   _secrets;
   _sdk;
-  _skills;
+  _dataSkills;
+  _playbookSkills;
   _comments;
   _remix;
   _screenshot;
@@ -721,6 +1967,7 @@ var AlvaClient = class {
   _arraysJwt;
   _notifications;
   _pushSubscriptions;
+  _channelGroupSubscriptions;
   constructor(config) {
     this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
     this.arraysBaseUrl = config.arraysBaseUrl ?? DEFAULT_ARRAYS_BASE_URL;
@@ -745,8 +1992,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);
@@ -772,6 +2022,9 @@ var AlvaClient = class {
   get pushSubscriptions() {
     return this._pushSubscriptions ??= new PushSubscriptionsResource(this);
   }
+  get channelGroupSubscriptions() {
+    return this._channelGroupSubscriptions ??= new ChannelGroupSubscriptionsResource(this);
+  }
   _requireAuth() {
     if (!this.viewer_token && !this.apiKey) {
       throw new AlvaError(
@@ -808,6 +2061,9 @@ var AlvaClient = class {
     if (options?.rawBody !== void 0) {
       headers["Content-Type"] = "application/octet-stream";
       fetchBody = options.rawBody;
+    } else if (options?.jsonBody !== void 0) {
+      headers["Content-Type"] = "application/json";
+      fetchBody = options.jsonBody;
     } else if (options?.body !== void 0) {
       headers["Content-Type"] = "application/json";
       fetchBody = JSON.stringify(options.body);
@@ -1127,11 +2383,168 @@ async function runPostConfigureHooks(client, deps) {
   }
 }
 
+// src/cli/dataSkillsFormat.ts
+var TIER_ORDER = [
+  "public",
+  "alternative",
+  "unstructured"
+];
+function formatTierCounts(counts) {
+  if (!counts) return "";
+  const parts = [];
+  for (const tier of TIER_ORDER) {
+    const n = counts[tier];
+    if (n) parts.push(`${tier}=${n}`);
+  }
+  return parts.join(" ");
+}
+function formatSkillsList(payload) {
+  const skills = payload.skills ?? [];
+  if (skills.length === 0) return "(no skills)\n";
+  const lines = [`${skills.length} skill(s):`, ""];
+  for (const s of skills) {
+    const meta = s.metadata;
+    let tag = "";
+    if (meta) {
+      const parts = [`${meta.endpoint_count} endpoints`];
+      const tiers = formatTierCounts(meta.endpoint_tier_counts);
+      if (tiers) parts.push(tiers);
+      if (meta.pro_count > 0) parts.push(`${meta.pro_count} pro`);
+      tag = `[${parts.join("; ")}]`;
+    }
+    lines.push(`\u2022 ${s.name}${tag ? ` ${tag}` : ""}`);
+    if (s.description) lines.push(`    ${s.description}`);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatEndpointMetadataTable(endpoints) {
+  if (endpoints.length === 0) return "";
+  const rows = endpoints.map((e) => ({
+    method: e.method,
+    path: e.path,
+    file: e.file,
+    tier: e.tier,
+    access: e.pro_required ? "pro" : "free"
+  }));
+  const headers = ["METHOD", "PATH", "FILE", "TIER", "ACCESS"];
+  const widths = headers.map((h, i) => {
+    const key = ["method", "path", "file", "tier", "access"][i];
+    return Math.max(h.length, ...rows.map((r) => String(r[key]).length));
+  });
+  const pad2 = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
+  const lines = [
+    headers.map((h, i) => pad2(h, widths[i])).join("  "),
+    widths.map((w) => "-".repeat(w)).join("  "),
+    ...rows.map(
+      (r) => [r.method, r.path, r.file, r.tier, r.access].map((v, i) => pad2(String(v), widths[i])).join("  ")
+    )
+  ];
+  return lines.join("\n");
+}
+function formatSingleEndpointMetadata(meta) {
+  if (!meta) return "";
+  return [
+    "Endpoint metadata:",
+    `  ${meta.method} ${meta.path}`,
+    `  file:   ${meta.file}`,
+    `  tier:   ${meta.tier}`,
+    `  access: ${meta.pro_required ? "pro only" : "free and pro"} (requires ${meta.required_subscription_tier})`
+  ].join("\n");
+}
+function isEndpointMetadata(m) {
+  return !!m && typeof m === "object" && "path" in m && "method" in m;
+}
+function formatSkillSummary(doc) {
+  const sections = [];
+  sections.push(`# ${doc.name}`);
+  if (doc.description) sections.push(doc.description);
+  if (doc.metadata && !isEndpointMetadata(doc.metadata)) {
+    const m = doc.metadata;
+    const parts = [`${m.endpoint_count} endpoints`];
+    const counts = formatTierCounts(m.endpoint_tier_counts);
+    if (counts) parts.push(counts);
+    if (m.pro_count > 0) parts.push(`${m.pro_count} pro`);
+    sections.push(`(${parts.join("; ")})`);
+  }
+  sections.push("---");
+  sections.push((doc.content ?? "").trimEnd());
+  if (doc.endpoint_metadata && doc.endpoint_metadata.length > 0) {
+    sections.push("---");
+    sections.push(formatEndpointMetadataTable(doc.endpoint_metadata));
+  }
+  return sections.join("\n\n") + "\n";
+}
+function formatSkillEndpoint(doc) {
+  const sections = [];
+  sections.push(`# ${doc.name}`);
+  if (doc.description) sections.push(doc.description);
+  if (isEndpointMetadata(doc.metadata)) {
+    sections.push(formatSingleEndpointMetadata(doc.metadata));
+  }
+  sections.push("---");
+  sections.push((doc.content ?? "").trimEnd());
+  return sections.join("\n\n") + "\n";
+}
+
+// src/cli/playbookSkillsFormat.ts
+function pad(s, w) {
+  return s + " ".repeat(Math.max(0, w - s.length));
+}
+function formatPlaybookSkillsList(result) {
+  const skills = result.skills ?? [];
+  if (skills.length === 0) return "No playbook skills found.\n";
+  const rows = skills.map((s) => ({
+    id: `${s.username}/${s.name}`,
+    description: s.description ?? "",
+    tags: (s.tags ?? []).join(","),
+    updated_at: s.updated_at ?? ""
+  }));
+  const headers = ["USERNAME/NAME", "DESCRIPTION", "TAGS", "UPDATED_AT"];
+  const keys = ["id", "description", "tags", "updated_at"];
+  const widths = headers.map(
+    (h, i) => Math.max(h.length, ...rows.map((r) => r[keys[i]].length))
+  );
+  const lines = [
+    headers.map((h, i) => pad(h, widths[i])).join("  "),
+    widths.map((w) => "-".repeat(w)).join("  "),
+    ...rows.map((r) => keys.map((k, i) => pad(r[k], widths[i])).join("  "))
+  ];
+  return lines.join("\n") + "\n";
+}
+function formatPlaybookSkillsTags(result) {
+  const tags = result.tags ?? [];
+  if (tags.length === 0) return "No tags.\n";
+  return tags.map((t) => `\u2022 ${t.name}`).join("\n") + "\n";
+}
+function formatPlaybookSkillGet(meta) {
+  const lines = [];
+  lines.push(`${meta.username}/${meta.name}`);
+  if (meta.description) lines.push(meta.description);
+  lines.push(`tags:        ${(meta.tags ?? []).join(", ") || "(none)"}`);
+  lines.push(`creator_uid: ${meta.creator_uid}`);
+  lines.push(`updated_at:  ${meta.updated_at}`);
+  lines.push("");
+  lines.push("Files:");
+  const files = meta.files ?? [];
+  if (files.length === 0) {
+    lines.push("  (no files)");
+  } else {
+    for (const f of files) {
+      lines.push(`  ${f.path}  (${f.size_bytes} B)`);
+    }
+  }
+  return lines.join("\n") + "\n";
+}
+function formatPlaybookSkillFile(file) {
+  return file.content;
+}
+
 // src/cli/index.ts
 import * as fs from "fs";
 import * as os2 from "os";
 import * as fsPromises2 from "fs/promises";
-var CLI_VERSION = true ? "0.4.2" : "dev";
+var CLI_VERSION = true ? "0.7.0-beta.0" : "dev";
 function isVersionOlderThan(a, b) {
   const parse = (v) => {
     if (!v) return null;
@@ -1161,9 +2574,11 @@ Commands:
   release     Feed and playbook releases (feed, playbook-draft, playbook)
   secrets     Secret management (create, list, get, update, delete)
   sdk         SDK documentation (doc, partitions, partition-summary)
-  skills      Data-skill documentation from the Arrays backend (list, summary, endpoint)
+  skillhub    Playbook skills (list, tags, get, file)
+  data-skills Data-skill documentation from the Arrays backend (list, summary, endpoint)
   comments    Playbook comments (create, pin, unpin)
   push-subscriptions  Personal push opt-in (subscribe-playbook, unsubscribe-playbook, subscribe-feed, unsubscribe-feed, list)
+  channel     Channel group operations (group-subscriptions context, list, subscribe, unsubscribe)
   remix       Save playbook remix lineage
   trading     Trading operations (accounts, portfolio, orders, subscriptions, equity-history, risk-rules, subscribe, unsubscribe, execute, update-risk-rules)
   auth        Authentication (login)
@@ -1362,7 +2777,7 @@ Examples:
   deploy: `Usage: alva deploy <subcommand> [options]
 
 Manage scheduled cronjobs that run your scripts on a cron schedule.
-Max 20 cronjobs per user. Min interval: 1 minute.
+Min interval: 1 minute.
 
 Subcommands:
   create     Create a new cronjob
@@ -1372,6 +2787,8 @@ Subcommands:
   delete     Delete a cronjob
   pause      Pause a running cronjob
   resume     Resume a paused cronjob
+  trigger    Fire the cronjob once, immediately, bypassing the schedule
+             (returns workflow_run_id; poll 'runs' to verify completion)
   runs       List runs for a cronjob (cursor-paginated)
   run-logs   Get stdout/stderr logs for a single cronjob run
 
@@ -1387,7 +2804,7 @@ List flags:
   --limit <n>            Max results per page (default: 20)
   --cursor <cursor>      Pagination cursor from previous response
 
-Get/Update/Delete/Pause/Resume flags:
+Get/Update/Delete/Pause/Resume/Trigger flags:
   --id <id>              Cronjob ID (required)
 
 Runs flags:
@@ -1421,7 +2838,17 @@ Examples:
   alva deploy delete --id 42
   alva deploy runs --id 42
   alva deploy runs --id 42 --first 10
-  alva deploy run-logs --id 42 --run-id 123`,
+  alva deploy run-logs --id 42 --run-id 123
+
+Build-time verify (fire once, then poll until your run completes):
+  WF=$(alva deploy trigger --id 42 | jq -r .workflow_run_id)
+  while ! ROW=$(alva deploy runs --id 42 --first 5 \\
+                 | jq -e ".runs[] | select(.workflow_run_id==\\"$WF\\")"); do
+    sleep 5
+  done
+  STATUS=$(echo "$ROW" | jq -r .status)
+  [ "$STATUS" = completed ] || alva deploy run-logs --id 42 \\
+                                  --run-id "$(echo "$ROW" | jq -r .id)"`,
   release: `Usage: alva release <subcommand> [options]
 
 Publish feeds and playbooks to the Alva platform. The typical workflow:
@@ -1429,7 +2856,8 @@ Publish feeds and playbooks to the Alva platform. The typical workflow:
   2. Register feed (alva release feed)
   3. Create playbook draft (alva release playbook-draft)
   4. Write HTML to ALFS (alva fs write --path ~/playbooks/{name}/index.html)
-  5. Release playbook (alva release playbook)
+  5. Write README to ALFS (alva fs write --path ~/playbooks/{name}/README.md)
+  6. Release playbook (alva release playbook --readme-url "/alva/home/<username>/playbooks/{name}/README.md")
 
 Subcommands:
   feed              Register a feed after deploying its cronjob
@@ -1450,12 +2878,19 @@ Playbook-draft flags:
   --feeds <json>             JSON array of {feed_id, feed_major?} (required)
   --description <text>       Playbook description
   --trading-symbols <json>   JSON array of tickers, e.g. '["BTC","ETH"]' (max 50)
+  --template-id <id>         Source-template reference "username/name", e.g.
+                             "alva/screener". Persisted set-once on first draft.
 
 Playbook flags:
   --name <name>          Playbook name, must already exist as draft (required)
   --version <version>    Semantic version, e.g. "v1.0.0" (required)
   --feeds <json>         JSON array of {feed_id, feed_major?} (required)
   --changelog <text>     Release changelog (required)
+  --readme-url <url>     Owner-attested README location (required). Must be
+                         the absolute ALFS path
+                         "/alva/home/<username>/playbooks/<name>/README.md".
+                         The README must already be written to ALFS at that
+                         path before publish.
 
 Display name conventions:
   Format: [subject/theme] [analysis angle/strategy logic]
@@ -1467,7 +2902,8 @@ Examples:
   alva release feed --name btc-ema --version 1.0.0 --cronjob-id 42
   alva release feed --name nvda-insiders --version 1.0.0 --cronjob-id 43 --description "NVDA insider trading activity"
   alva release playbook-draft --name btc-dashboard --display-name "BTC Trend Dashboard" --feeds '[{"feed_id":100}]' --trading-symbols '["BTC"]'
-  alva release playbook --name btc-dashboard --version v1.0.0 --feeds '[{"feed_id":100}]' --changelog "Initial release"`,
+  alva release playbook-draft --name btc-dashboard --display-name "BTC Trend Dashboard" --feeds '[{"feed_id":100}]' --template-id alva/screener
+  alva release playbook --name btc-dashboard --version v1.0.0 --feeds '[{"feed_id":100}]' --changelog "Initial release" --readme-url "/alva/home/<username>/playbooks/btc-dashboard/README.md"`,
   secrets: `Usage: alva secrets <subcommand> [options]
 
 Manage encrypted secrets for use in Alva scripts. Secrets are stored
@@ -1524,28 +2960,59 @@ Examples:
   alva sdk partition-summary --partition feed_widgets
   alva sdk doc --name "@arrays/data/widget-scrap/twitter:v1.0.0"
   alva sdk doc --name "@arrays/data/search/search-grok-x:v1.0.0"`,
-  skills: `Usage: alva skills <subcommand> [options]
+  "data-skills": `Usage: alva data-skills <subcommand> [args]
 
 Browse the Arrays backend's data-skill documentation. These endpoints are
 public \u2014 no Alva credentials required.
 
 Subcommands:
-  list       List all available data skills
-  summary    Get the endpoints table for a skill (requires --name)
-  endpoint   Get full documentation for a specific endpoint (requires --name and --file)
+  list                            List all available data skills
+  summary <skill>                 Get the endpoints table for a skill, plus local tier metadata
+  endpoint <skill> <file>         Get full documentation and local tier metadata for a specific endpoint
 
 Flags:
-  --name <name>      Skill name (required for summary and endpoint)
-  --file <file>      Endpoint file name from the "File" column of 'skills summary' (required for endpoint)
+  --json             Emit raw JSON instead of the readable rendering (for scripting / jq)
+
+Output: by default, summary/endpoint print the skill's markdown content directly,
+and list prints a name \u2192 description summary. Pass --json to get the raw JSON
+shape (same as before this CLI version) for piping into jq or other tools.
 
 Global override:
   --arrays-endpoint <url>   Arrays backend URL (or ARRAYS_ENDPOINT env)
                             Default: https://data-tools.prd.space.id
 
 Examples:
-  alva skills list
-  alva skills summary --name <skill>
-  alva skills endpoint --name <skill> --file <endpoint-file>`,
+  alva data-skills list
+  alva data-skills list --json
+  alva data-skills summary <skill>
+  alva data-skills endpoint <skill> <endpoint-file>
+  alva data-skills summary <skill> --json | jq '.content'`,
+  skillhub: `Usage: alva skillhub <subcommand> [options]
+
+Browse playbook skills (system templates + user-created) from the
+alva-gateway public API. Skills are namespaced as "<username>/<name>".
+The "get" subcommand returns metadata + file listing; use "file" to
+fetch individual file contents (progressive loading).
+
+Subcommands:
+  list       List skill summaries (filter by --tag and/or --username)
+  tags       Distinct tag set used across all skills
+  get        Get one skill's metadata + file listing (path + size_bytes only)
+  file       Get one file's content from a skill
+
+Flags:
+  --tag <tag>           (list) filter by tag
+  --username <user>     (list) filter by owner username
+  --json                Return raw envelope instead of pretty output
+
+Examples:
+  alva skillhub list
+  alva skillhub list --tag research
+  alva skillhub list --username alva
+  alva skillhub tags
+  alva skillhub get alva/ai-digest
+  alva skillhub file alva/ai-digest README.md
+  alva skillhub file alva/ai-digest references/api/example.md > out.md`,
   comments: `Usage: alva comments <subcommand> [options]
 
 Manage comments on Alva playbooks. Supports top-level comments and threaded
@@ -1597,6 +3064,31 @@ Examples:
   alva push-subscriptions subscribe-feed     --username alice --name btc-ema-cross
   alva push-subscriptions unsubscribe-feed   --username alice --name btc-ema-cross
   alva push-subscriptions list --include-history`,
+  channel: `Usage: alva channel group-subscriptions <subcommand> [options]
+
+Manage push notifications delivered into the external group chat attached
+to a channel session. The group can subscribe to public feeds and playbooks.
+Subscribe/unsubscribe are idempotent no-ops unless the authenticated caller
+is that group's Alva admin.
+
+Subcommands:
+  context       Show group admin status and current subscriptions
+  list          List active subscriptions for the group
+  subscribe     Subscribe the group to a public feed or playbook
+  unsubscribe   Unsubscribe the group from a feed or playbook
+
+Common flags:
+  --session-id <id>      Channel session id for the group (required)
+
+Subscribe/unsubscribe flags:
+  --target-type <type>   feed or playbook (required)
+  --target-id <id>       Numeric feed_id or playbook_id (required)
+
+Examples:
+  alva channel group-subscriptions context --session-id 123
+  alva channel group-subscriptions list --session-id 123
+  alva channel group-subscriptions subscribe --session-id 123 --target-type feed --target-id 8169
+  alva channel group-subscriptions unsubscribe --session-id 123 --target-type playbook --target-id 42`,
   remix: `Usage: alva remix --child-username <u> --child-name <n> --parents <json>
 
 Record remix lineage when creating a playbook based on existing playbooks.
@@ -1610,22 +3102,26 @@ Required:
 
 Examples:
   alva remix --child-username bob --child-name my-btc --parents '[{"username":"alice","name":"btc-signals"}]'`,
-  screenshot: `Usage: alva screenshot --url <url> --out <file> [--selector <css>] [--xpath <xpath>]
+  screenshot: `Usage: alva screenshot --url <url> --out <file> [--selector <css>] [--xpath <xpath>] [--compress] [--compress-quality <n>] [--compress-max-width <px>]
 
 Capture a screenshot of an Alva page and save it as PNG. Useful for verifying
 playbook rendering before release.
 
 Required:
-  --url <url>          URL or path to capture (e.g. /playbook/alice/dashboard)
-  --out <file>         Local file path to write the PNG output
+  --url <url>                URL or path to capture (e.g. /playbook/alice/dashboard)
+  --out <file>               Local file path to write the PNG output
 
 Optional:
-  --selector <css>     CSS selector to capture a specific element
-  --xpath <xpath>      XPath selector to capture a specific element
+  --selector <css>           CSS selector to capture a specific element
+  --xpath <xpath>            XPath selector to capture a specific element
+  --compress                 Re-encode the PNG to reduce file size
+  --compress-quality <n>     Compression quality 1-100 (gateway default applies if omitted)
+  --compress-max-width <px>  Downscale to at most this width in pixels
 
 Examples:
   alva screenshot --url /playbook/alice/btc-dashboard --out dashboard.png
-  alva screenshot --url /playbook/alice/btc-dashboard --out chart.png --selector ".chart-container"`,
+  alva screenshot --url /playbook/alice/btc-dashboard --out chart.png --selector ".chart-container"
+  alva screenshot --url /playbook/alice/btc-dashboard --out small.png --compress --compress-quality 70 --compress-max-width 1280`,
   trading: `Usage: alva trading <subcommand> [options]
 
 Manage trading accounts, portfolios, orders, subscriptions, and risk rules.
@@ -1751,7 +3247,9 @@ var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "push-notify",
   "help",
   "execute-latest",
-  "dry-run"
+  "dry-run",
+  "json",
+  "compress"
 ]);
 function parseFlags2(argv) {
   const flags = {};
@@ -1798,6 +3296,25 @@ function requireNumericFlag(flags, name, command) {
   }
   return n;
 }
+function requirePositiveIntegerStringFlag(flags, name, command) {
+  const val = requireFlag(flags, name, command);
+  if (!/^[1-9]\d*$/.test(val)) {
+    const group = command.split(" ")[0];
+    throw new CliUsageError(
+      `--${name} must be a positive integer for '${command}', got '${val}'`,
+      group
+    );
+  }
+  return val;
+}
+function requireGroupSubscriptionTargetType(flags, command) {
+  const val = requireFlag(flags, "target-type", command).trim().toLowerCase();
+  if (val === "feed" || val === "playbook") return val;
+  throw new CliUsageError(
+    `--target-type must be feed or playbook for '${command}', got '${val}'`,
+    command.split(" ")[0]
+  );
+}
 function num(val) {
   if (val === void 0) return void 0;
   const n = Number(val);
@@ -2005,6 +3522,10 @@ async function dispatch(client, args, meta) {
           return client.deploy.resume({
             id: requireNumericFlag(flags, "id", "deploy resume")
           });
+        case "trigger":
+          return client.deploy.trigger({
+            id: requireNumericFlag(flags, "id", "deploy trigger")
+          });
         case "runs":
           return client.deploy.listRuns({
             cronjob_id: requireNumericFlag(flags, "id", "deploy runs"),
@@ -2048,7 +3569,8 @@ async function dispatch(client, args, meta) {
             feeds: jsonParse(
               requireFlag(flags, "feeds", "release playbook-draft")
             ),
-            trading_symbols: flags["trading-symbols"] ? jsonParse(flags["trading-symbols"]) : void 0
+            trading_symbols: flags["trading-symbols"] ? jsonParse(flags["trading-symbols"]) : void 0,
+            template_id: flags["template-id"]
           });
         case "playbook":
           return client.release.playbook({
@@ -2057,7 +3579,8 @@ async function dispatch(client, args, meta) {
             feeds: jsonParse(
               requireFlag(flags, "feeds", "release playbook")
             ),
-            changelog: requireFlag(flags, "changelog", "release playbook")
+            changelog: requireFlag(flags, "changelog", "release playbook"),
+            readme_url: requireFlag(flags, "readme-url", "release playbook")
           });
         default:
           throw new CliUsageError(
@@ -2118,25 +3641,103 @@ async function dispatch(client, args, meta) {
           );
       }
     }
-    case "skills": {
+    case "data-skills": {
       if (!subcommand)
-        throw new CliUsageError("Missing subcommand for skills", "skills");
+        throw new CliUsageError(
+          "Missing subcommand for data-skills",
+          "data-skills"
+        );
+      const asJson = boolFlag(flags["json"]) ?? false;
       switch (subcommand) {
-        case "list":
-          return client.skills.list();
-        case "summary":
-          return client.skills.summary({
-            name: requireFlag(flags, "name", "skills summary")
-          });
-        case "endpoint":
-          return client.skills.endpoint({
-            name: requireFlag(flags, "name", "skills endpoint"),
-            file: requireFlag(flags, "file", "skills endpoint")
+        case "list": {
+          const result = await client.dataSkills.list();
+          return asJson ? result : formatSkillsList(result);
+        }
+        case "summary": {
+          const name = args[2];
+          if (!name || name.startsWith("--")) {
+            throw new CliUsageError(
+              "Missing skill name for data-skills summary",
+              "data-skills"
+            );
+          }
+          const result = await client.dataSkills.summary({ name });
+          return asJson ? result : formatSkillSummary(result);
+        }
+        case "endpoint": {
+          const name = args[2];
+          if (!name || name.startsWith("--")) {
+            throw new CliUsageError(
+              "Missing skill name for data-skills endpoint",
+              "data-skills"
+            );
+          }
+          const file = args[3];
+          if (!file || file.startsWith("--")) {
+            throw new CliUsageError(
+              "Missing endpoint file for data-skills endpoint",
+              "data-skills"
+            );
+          }
+          const result = await client.dataSkills.endpoint({ name, file });
+          return asJson ? result : formatSkillEndpoint(result);
+        }
+        default:
+          throw new CliUsageError(
+            `Unknown subcommand: data-skills ${subcommand}`,
+            "data-skills"
+          );
+      }
+    }
+    case "skillhub": {
+      if (!subcommand)
+        throw new CliUsageError("Missing subcommand for skillhub", "skillhub");
+      const asJson = boolFlag(flags["json"]) ?? false;
+      switch (subcommand) {
+        case "list": {
+          const result = await client.playbookSkills.list({
+            tag: flags["tag"],
+            username: flags["username"]
           });
+          return asJson ? result : formatPlaybookSkillsList(result);
+        }
+        case "tags": {
+          const result = await client.playbookSkills.tags();
+          return asJson ? result : formatPlaybookSkillsTags(result);
+        }
+        case "get": {
+          const id = args[2];
+          if (!id || id.startsWith("--")) {
+            throw new CliUsageError(
+              "Missing playbook skill identifier for skillhub get",
+              "skillhub"
+            );
+          }
+          const result = await client.playbookSkills.get(id);
+          return asJson ? result : formatPlaybookSkillGet(result);
+        }
+        case "file": {
+          const id = args[2];
+          if (!id || id.startsWith("--")) {
+            throw new CliUsageError(
+              "Missing playbook skill identifier for skillhub file",
+              "skillhub"
+            );
+          }
+          const path = args[3];
+          if (!path || path.startsWith("--")) {
+            throw new CliUsageError(
+              "Missing file path for skillhub file",
+              "skillhub"
+            );
+          }
+          const result = await client.playbookSkills.file(id, path);
+          return asJson ? result : formatPlaybookSkillFile(result);
+        }
         default:
           throw new CliUsageError(
-            `Unknown subcommand: skills ${subcommand}`,
-            "skills"
+            `Unknown subcommand: skillhub ${subcommand}`,
+            "skillhub"
           );
       }
     }
@@ -2240,6 +3841,80 @@ async function dispatch(client, args, meta) {
           );
       }
     }
+    case "channel": {
+      if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+        return { _help: true, text: COMMAND_HELP.channel };
+      }
+      if (subcommand !== "group-subscriptions") {
+        throw new CliUsageError(
+          `Unknown subcommand: channel ${subcommand}`,
+          "channel"
+        );
+      }
+      const leaf = args[2];
+      if (!leaf || leaf === "--help" || leaf === "-h") {
+        return { _help: true, text: COMMAND_HELP.channel };
+      }
+      const channelFlags = parseFlags2(args.slice(3));
+      const commandName = `channel group-subscriptions ${leaf}`;
+      switch (leaf) {
+        case "context":
+          return client.channelGroupSubscriptions.context({
+            session_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "session-id",
+              commandName
+            )
+          });
+        case "list":
+          return client.channelGroupSubscriptions.list({
+            session_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "session-id",
+              commandName
+            )
+          });
+        case "subscribe":
+          return client.channelGroupSubscriptions.subscribe({
+            session_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "session-id",
+              commandName
+            ),
+            target_type: requireGroupSubscriptionTargetType(
+              channelFlags,
+              commandName
+            ),
+            target_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "target-id",
+              commandName
+            )
+          });
+        case "unsubscribe":
+          return client.channelGroupSubscriptions.unsubscribe({
+            session_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "session-id",
+              commandName
+            ),
+            target_type: requireGroupSubscriptionTargetType(
+              channelFlags,
+              commandName
+            ),
+            target_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "target-id",
+              commandName
+            )
+          });
+        default:
+          throw new CliUsageError(
+            `Unknown subcommand: channel group-subscriptions ${leaf}`,
+            "channel"
+          );
+      }
+    }
     case "remix":
       return client.remix.save({
         child: {
@@ -2274,10 +3949,15 @@ async function dispatch(client, args, meta) {
     }
     case "screenshot": {
       const outFile = requireFlag(flags, "out", "screenshot");
+      const compressQuality = flags["compress-quality"];
+      const compressMaxWidth = flags["compress-max-width"];
       const result = await client.screenshot.capture({
         url: requireFlag(flags, "url", "screenshot"),
         selector: flags["selector"],
-        xpath: flags["xpath"]
+        xpath: flags["xpath"],
+        compress: boolFlag(flags["compress"]),
+        compressQuality: compressQuality !== void 0 ? Number(compressQuality) : void 0,
+        compressMaxWidth: compressMaxWidth !== void 0 ? Number(compressMaxWidth) : void 0
       });
       const buf = Buffer.from(result);
       if (buf.length === 0) {