melaya 0.1.2 → 0.2.0

data/lib/melaya/market.rb

@@ -1,156 +1,198 @@
-# frozen_string_literal: true
-
-module Melaya
-  # REST market-data API — normalized across all 70+ venues.
-  #
-  # Every method maps to a documented endpoint under
-  # https://api.melaya.org/api/v1/market/*. Unwraps the inner data key from the
-  # {ok, <data>} envelope.
-  class MarketAPI
-    def initialize(http)
-      @http = http
-    end
-
-    # List the exchanges Melaya supports right now (the source of truth).
-    def list_exchanges
-      @http.get("/api/v1/market/list-exchanges")["exchanges"]
-    end
-
-    # Best bid/ask, last price, and 24h aggregates for one symbol.
-    # @param exchange [String]
-    # @param symbol [String]
-    # @param market [String, nil] e.g. "spot", "future", "swap"
-    def ticker(exchange:, symbol:, market: nil)
-      @http.get("/api/v1/market/ticker",
-        "exchange" => exchange, "symbol" => symbol, "market" => market
-      )["ticker"]
-    end
-
-    # Order book to a given depth.
-    def orderbook(exchange:, symbol:, limit: nil, market: nil)
-      @http.get("/api/v1/market/orderbook",
-        "exchange" => exchange, "symbol" => symbol, "limit" => limit, "market" => market
-      )["orderbook"]
-    end
-
-    # OHLCV candles. Each candle is [timestamp, open, high, low, close, volume].
-    def ohlcv(exchange:, symbol:, timeframe:, limit: nil, market: nil)
-      @http.get("/api/v1/market/ohlcv",
-        "exchange" => exchange, "symbol" => symbol, "timeframe" => timeframe,
-        "limit" => limit, "market" => market
-      )["candles"]
-    end
-
-    # Recent public trades.
-    def trades(exchange:, symbol:, market: nil)
-      @http.get("/api/v1/market/trades",
-        "exchange" => exchange, "symbol" => symbol, "market" => market
-      )["trades"]
-    end
-
-    # Tradable markets on a venue.
-    def markets(exchange:)
-      @http.get("/api/v1/market/markets", "exchange" => exchange)["markets"]
-    end
-
-    # Listed currencies on a venue. (Not supported on every venue.)
-    def currencies(exchange:)
-      @http.get("/api/v1/market/currencies", "exchange" => exchange)["currencies"]
-    end
-
-    # Operational status: ok / maintenance / degraded.
-    def status(exchange:)
-      @http.get("/api/v1/market/status", "exchange" => exchange)["status"]
-    end
-
-    # Exchange server time.
-    def time(exchange:)
-      @http.get("/api/v1/market/time", "exchange" => exchange)["time"]
-    end
-
-    # ── Batch / derivatives (POST) ──────────────────────────────────────────
-
-    # Tickers for many symbols on one venue in a single call. Keyed by symbol.
-    def tickers(exchange:, symbols:, market: nil)
-      body = compact("exchange" => exchange, "symbols" => symbols, "market" => market)
-      @http.post("/api/v1/market/tickers", body)["tickers"]
-    end
-
-    # Latest funding rates for perpetuals. Keyed by symbol.
-    def funding_rates(exchange:, symbols:, market: nil)
-      body = compact("exchange" => exchange, "symbols" => symbols, "market" => market)
-      @http.post("/api/v1/market/funding-rates", body)["rates"]
-    end
-
-    # Funding-rate history.
-    def funding_rate_history(exchange:, symbol:, hours: nil, market: nil)
-      body = compact("exchange" => exchange, "symbol" => symbol, "hours" => hours, "market" => market)
-      @http.post("/api/v1/market/funding-rate-history", body)["history"]
-    end
-
-    # Open interest for one or more perpetuals. Keyed by symbol.
-    def open_interest(exchange:, symbols:, market: nil)
-      body = compact("exchange" => exchange, "symbols" => symbols, "market" => market)
-      @http.post("/api/v1/market/open-interest", body)["openInterest"]
-    end
-
-    # Open-interest history.
-    def open_interest_history(exchange:, symbol:, hours: nil, market: nil)
-      body = compact("exchange" => exchange, "symbol" => symbol, "hours" => hours, "market" => market)
-      @http.post("/api/v1/market/open-interest-history", body)["history"]
-    end
-
-    # Instrument list + trading constraints (tick size, min notional, qty step).
-    def instruments(exchange:, market: nil)
-      body = compact("exchange" => exchange, "market" => market)
-      @http.post("/api/v1/market/instruments", body)
-    end
-
-    # Cross-exchange liquidation events (historical query).
-    def liquidation_events(exchange: nil, symbol: nil, since_ms: nil, limit: nil)
-      body = compact("exchange" => exchange, "symbol" => symbol, "sinceMs" => since_ms, "limit" => limit)
-      @http.post("/api/v1/market/liquidation-events", body)["events"]
-    end
-
-    # Multi-symbol OHLCV in one call. Returns candle arrays keyed by symbol.
-    def ohlcv_multi(exchange:, symbols:, timeframe:, limit: nil, market: nil)
-      body = compact("exchange" => exchange, "symbols" => symbols, "timeframe" => timeframe,
-                     "limit" => limit, "market" => market)
-      @http.post("/api/v1/market/ohlcv-multi", body)["perSymbol"]
-    end
-
-    # Trading constraints for one symbol (tick size, min notional, qty step, leverage).
-    def market_constraints(exchange:, symbol:, market: nil)
-      body = compact("exchange" => exchange, "symbol" => symbol, "market" => market)
-      @http.post("/api/v1/market/market-constraints", body)["constraints"]
-    end
-
-    # Funding-rate history for one symbol across several venues. Keyed by exchange.
-    def funding_rate_history_multi(exchanges:, symbol:, hours: nil)
-      body = compact("exchanges" => exchanges, "symbol" => symbol, "hours" => hours)
-      @http.post("/api/v1/market/funding-rate-history-multi", body)["perExchange"]
-    end
-
-    # Open-interest history for one symbol across several venues. Keyed by exchange.
-    def open_interest_history_multi(exchanges:, symbol:, hours: nil)
-      body = compact("exchanges" => exchanges, "symbol" => symbol, "hours" => hours)
-      @http.post("/api/v1/market/open-interest-history-multi", body)["perExchange"]
-    end
-
-    # Prediction-market listings for a venue (polymarket, kalshi, drift_pm, sxbet, azuro, overtime).
-    def prediction_markets(venue: "polymarket")
-      @http.post("/api/v1/market/pm-markets", { "venue" => venue })["markets"]
-    end
-
-    # Live platform catalog counts (agentic tools, subagents, by category). Public.
-    def catalog_counts
-      @http.get("/api/v1/public/catalog-counts")
-    end
-
-    private
-
-    def compact(hash)
-      hash.reject { |_, v| v.nil? }
-    end
-  end
-end
+# frozen_string_literal: true
+
+module Melaya
+  # REST market-data API — normalized across all 70+ venues.
+  #
+  # Every method maps to a documented endpoint under
+  # https://api.melaya.org/api/v1/market/*. Unwraps the inner data key from the
+  # {ok, <data>} envelope.
+  class MarketAPI
+    def initialize(http)
+      @http = http
+    end
+
+    # List the exchanges Melaya supports right now (the source of truth).
+    def list_exchanges
+      @http.get("/api/v1/market/list-exchanges")["exchanges"]
+    end
+
+    # Best bid/ask, last price, and 24h aggregates for one symbol.
+    # @param exchange [String]
+    # @param symbol [String]
+    # @param market [String, nil] e.g. "spot", "future", "swap"
+    def ticker(exchange:, symbol:, market: nil)
+      @http.get("/api/v1/market/ticker",
+        "exchange" => exchange, "symbol" => symbol, "market" => market
+      )["ticker"]
+    end
+
+    # Order book to a given depth.
+    def orderbook(exchange:, symbol:, limit: nil, market: nil)
+      @http.get("/api/v1/market/orderbook",
+        "exchange" => exchange, "symbol" => symbol, "limit" => limit, "market" => market
+      )["orderbook"]
+    end
+
+    # OHLCV candles. Each candle is [timestamp, open, high, low, close, volume].
+    def ohlcv(exchange:, symbol:, timeframe:, limit: nil, market: nil)
+      @http.get("/api/v1/market/ohlcv",
+        "exchange" => exchange, "symbol" => symbol, "timeframe" => timeframe,
+        "limit" => limit, "market" => market
+      )["candles"]
+    end
+
+    # Recent public trades.
+    def trades(exchange:, symbol:, market: nil)
+      @http.get("/api/v1/market/trades",
+        "exchange" => exchange, "symbol" => symbol, "market" => market
+      )["trades"]
+    end
+
+    # Tradable markets on a venue.
+    def markets(exchange:)
+      @http.get("/api/v1/market/markets", "exchange" => exchange)["markets"]
+    end
+
+    # Listed currencies on a venue. (Not supported on every venue.)
+    def currencies(exchange:)
+      @http.get("/api/v1/market/currencies", "exchange" => exchange)["currencies"]
+    end
+
+    # Operational status: ok / maintenance / degraded.
+    def status(exchange:)
+      @http.get("/api/v1/market/status", "exchange" => exchange)["status"]
+    end
+
+    # Exchange server time.
+    def time(exchange:)
+      @http.get("/api/v1/market/time", "exchange" => exchange)["time"]
+    end
+
+    # ── Batch / derivatives (POST) ──────────────────────────────────────────
+
+    # Tickers for many symbols on one venue in a single call. Keyed by symbol.
+    def tickers(exchange:, symbols:, market: nil)
+      body = compact("exchange" => exchange, "symbols" => symbols, "market" => market)
+      @http.post("/api/v1/market/tickers", body)["tickers"]
+    end
+
+    # Latest funding rates for perpetuals. Keyed by symbol.
+    def funding_rates(exchange:, symbols:, market: nil)
+      body = compact("exchange" => exchange, "symbols" => symbols, "market" => market)
+      @http.post("/api/v1/market/funding-rates", body)["rates"]
+    end
+
+    # Funding-rate history.
+    def funding_rate_history(exchange:, symbol:, hours: nil, market: nil)
+      body = compact("exchange" => exchange, "symbol" => symbol, "hours" => hours, "market" => market)
+      @http.post("/api/v1/market/funding-rate-history", body)["history"]
+    end
+
+    # Open interest for one or more perpetuals. Keyed by symbol.
+    def open_interest(exchange:, symbols:, market: nil)
+      body = compact("exchange" => exchange, "symbols" => symbols, "market" => market)
+      @http.post("/api/v1/market/open-interest", body)["openInterest"]
+    end
+
+    # Open-interest history.
+    def open_interest_history(exchange:, symbol:, hours: nil, market: nil)
+      body = compact("exchange" => exchange, "symbol" => symbol, "hours" => hours, "market" => market)
+      @http.post("/api/v1/market/open-interest-history", body)["history"]
+    end
+
+    # Instrument list + trading constraints (tick size, min notional, qty step).
+    def instruments(exchange:, market: nil)
+      body = compact("exchange" => exchange, "market" => market)
+      @http.post("/api/v1/market/instruments", body)
+    end
+
+    # Cross-exchange liquidation events (historical query).
+    def liquidation_events(exchange: nil, symbol: nil, since_ms: nil, limit: nil)
+      body = compact("exchange" => exchange, "symbol" => symbol, "sinceMs" => since_ms, "limit" => limit)
+      @http.post("/api/v1/market/liquidation-events", body)["events"]
+    end
+
+    # Multi-symbol OHLCV in one call. Returns candle arrays keyed by symbol.
+    def ohlcv_multi(exchange:, symbols:, timeframe:, limit: nil, market: nil)
+      body = compact("exchange" => exchange, "symbols" => symbols, "timeframe" => timeframe,
+                     "limit" => limit, "market" => market)
+      @http.post("/api/v1/market/ohlcv-multi", body)["perSymbol"]
+    end
+
+    # Trading constraints for one symbol (tick size, min notional, qty step, leverage).
+    def market_constraints(exchange:, symbol:, market: nil)
+      body = compact("exchange" => exchange, "symbol" => symbol, "market" => market)
+      @http.post("/api/v1/market/market-constraints", body)["constraints"]
+    end
+
+    # Funding-rate history for one symbol across several venues. Keyed by exchange.
+    def funding_rate_history_multi(exchanges:, symbol:, hours: nil)
+      body = compact("exchanges" => exchanges, "symbol" => symbol, "hours" => hours)
+      @http.post("/api/v1/market/funding-rate-history-multi", body)["perExchange"]
+    end
+
+    # Open-interest history for one symbol across several venues. Keyed by exchange.
+    def open_interest_history_multi(exchanges:, symbol:, hours: nil)
+      body = compact("exchanges" => exchanges, "symbol" => symbol, "hours" => hours)
+      @http.post("/api/v1/market/open-interest-history-multi", body)["perExchange"]
+    end
+
+    # Prediction-market listings for a venue (polymarket, kalshi, drift_pm, sxbet, azuro, overtime).
+    def prediction_markets(venue: "polymarket")
+      @http.post("/api/v1/market/pm-markets", { "venue" => venue })["markets"]
+    end
+
+    # Live platform catalog counts (agentic tools, subagents, by category). Public.
+    def catalog_counts
+      @http.get("/api/v1/public/catalog-counts")
+    end
+
+    # ── restRoutes.ts market endpoints ──────────────────────────────────────────
+
+    # POST /api/v1/private/market/liquidations
+    # Get aggregated CEX liquidation data. (requireAuth)
+    # @param params [Hash] e.g. exchange, symbol, since_ms
+    def cex_liquidations(params = {})
+      @http.post("/api/v1/private/market/liquidations", params)
+    end
+
+    # GET /api/v1/market/mdd-pairs (public)
+    # Get max-drawdown pairs list (public screener data).
+    def mdd_pairs
+      @http.get("/api/v1/market/mdd-pairs")
+    end
+
+    # GET /api/v1/private/market/onchain-yields (Forge+ tier)
+    # Get on-chain yield data.
+    # @param params [Hash]
+    def onchain_yields(params = {})
+      @http.get("/api/v1/private/market/onchain-yields", params)
+    end
+
+    # GET /api/v1/private/market/onchain-liquidity (Forge+ tier)
+    # Get on-chain liquidity data.
+    # @param params [Hash]
+    def onchain_liquidity(params = {})
+      @http.get("/api/v1/private/market/onchain-liquidity", params)
+    end
+
+    # GET /api/v1/market/banner (public)
+    # Get marketing/notification banner content.
+    def banner
+      @http.get("/api/v1/market/banner")
+    end
+
+    # GET /api/v1/market/price-history (public)
+    # Get price history for chart display.
+    # @param params [Hash] e.g. exchange, symbol, timeframe
+    def price_history(params = {})
+      @http.get("/api/v1/market/price-history", params)
+    end
+
+    private
+
+    def compact(hash)
+      hash.reject { |_, v| v.nil? }
+    end
+  end
+end

data/lib/melaya/namespaces.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+
+module Melaya
+  # ── Domain namespace objects ─────────────────────────────────────────────────
+  #
+  # Three read-only namespace objects hang off every +Melaya::Client+ instance,
+  # grouping the flat module accessors into logical planes:
+  #
+  #   melaya.trading  — market data, account, sim, strategies, backtest, stream, trade
+  #   melaya.agents   — pipelines/runs, hitl, assistant, phone, evals, models
+  #   melaya.platform — projects, credentials, connectors, billing, team, templates,
+  #                     overview (via pipelines), runner, auth, mfa (via auth),
+  #                     accounts, bugs, events
+  #
+  # Every attribute on these objects is the *same* instance that is also reachable
+  # via the flat accessor on the client, so there is no duplication of state and
+  # no double HTTP calls.
+  #
+  # @example
+  #   melaya = Melaya::Client.new(api_key: ENV["MELAYA_API_KEY"])
+  #
+  #   # Namespaced (primary API)
+  #   melaya.trading.market.ticker(exchange: "binance", symbol: "BTC/USDT", market: "spot")
+  #   melaya.agents.pipelines.list(project: "my-project")
+  #   melaya.platform.projects.list
+  #
+  #   # Flat aliases still work (backward-compatible)
+  #   melaya.market.ticker(exchange: "binance", symbol: "BTC/USDT", market: "spot")
+
+  # Namespace grouping all trading-plane modules.
+  #
+  # Modules:
+  # - +market+     — REST market-data + reference endpoints (public + authenticated).
+  # - +account+    — Authenticated account reads: connected keys, tier limits, usage.
+  # - +sim+        — Paper trading (sim broker): virtual balance, positions, and orders.
+  # - +strategies+ — Launch, control, and inspect trading strategies (paper + live).
+  # - +backtest+   — Historical backtests + parameter sweeps on the Rust engine.
+  # - +stream+     — WebSocket streaming endpoints (public market data + private feeds).
+  # - +trade+      — Live trading — credentialed order placement on a connected exchange.
+  TradingNamespace = Struct.new(
+    :market,
+    :account,
+    :sim,
+    :strategies,
+    :backtest,
+    :stream,
+    :trade,
+    keyword_init: true
+  )
+
+  # Namespace grouping all agent-plane modules.
+  #
+  # Modules:
+  # - +pipelines+  — Pipeline runs, traces, schedules, and overview dashboard.
+  #                  (also aliased as +runs+ for ergonomics)
+  # - +hitl+       — Human-in-the-loop approval queue: list pending, approve, reject.
+  # - +assistant+  — Assistant onboarding profile (get + set).
+  # - +phone+      — Phone device control: pair, list, screen-tree, apps.
+  # - +evals+      — Agent evaluation runs and benchmarks.
+  # - +models+     — AI model list (reached via credentials#list_models; this is
+  #                  the CredentialsAPI instance filtered by convention — call
+  #                  +models.list_models(provider: "anthropic")+ etc.)
+  AgentsNamespace = Struct.new(
+    :pipelines,
+    :hitl,
+    :assistant,
+    :phone,
+    :evals,
+    :models,
+    keyword_init: true
+  ) do
+    # +runs+ is an ergonomic alias for +pipelines+ (agents call them "runs").
+    def runs
+      pipelines
+    end
+  end
+
+  # Namespace grouping all platform-plane modules.
+  #
+  # Modules:
+  # - +projects+     — Create and list agent projects.
+  # - +credentials+  — User-scoped credential storage (services, OAuth, env handles, models).
+  # - +connectors+   — Project-scoped connector credentials.
+  # - +billing+      — Subscription, Stripe checkout/portal, pricing plans, credit balances.
+  # - +team+         — Project team management: members, roles, invite links.
+  # - +templates+    — Pipeline templates: create, share, assign, and manage visibility.
+  # - +overview+     — Pipeline overview dashboard (same object as +agents.pipelines+,
+  #                    exposed here for discoverability on the platform plane).
+  # - +runner+       — Runner tokens: mint, list, revoke +mel_run_+ tokens.
+  # - +auth+         — Login, MFA, registration, password management, session tokens.
+  # - +mfa+          — Alias for +auth+ (MFA operations live on the same AuthAPI object).
+  # - +accounts+     — Account management: GDPR export, CEX key removal, profile updates.
+  # - +bugs+         — Bug reports: submit, track, and comment.
+  # - +events+       — Platform real-time events over Socket.IO.
+  PlatformNamespace = Struct.new(
+    :projects,
+    :credentials,
+    :connectors,
+    :billing,
+    :team,
+    :templates,
+    :overview,
+    :runner,
+    :auth,
+    :accounts,
+    :bugs,
+    :events,
+    keyword_init: true
+  ) do
+    # +mfa+ is an ergonomic alias for +auth+ (MFA methods live on AuthAPI).
+    def mfa
+      auth
+    end
+  end
+end

data/lib/melaya/phone.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Melaya
+  # Phone API — pair and control Android devices connected to the Melaya runner.
+  #
+  # Agents use these endpoints to drive a paired phone (tap, type, read
+  # screen state, launch apps) via the Melaya APK.
+  #
+  # Maps to /api/v1/private/phone/*.
+  #
+  # @example
+  #   result = melaya.phone.pair
+  #   puts "Pairing code: #{result["code"]}"
+  #   # User enters code in the Melaya APK on the phone
+  #
+  #   devices = melaya.phone.list_devices
+  #   tree = melaya.phone.screen_tree
+  class PhoneAPI
+    def initialize(http)
+      @http = http
+    end
+
+    # POST /api/v1/private/phone/pair
+    # Start phone device pairing — generates a pairing code for the Melaya APK.
+    def pair
+      @http.post("/api/v1/private/phone/pair")
+    end
+
+    # GET /api/v1/private/phone/devices
+    # List all paired phone devices for the authenticated user.
+    def list_devices
+      @http.get("/api/v1/private/phone/devices").fetch("devices", [])
+    end
+
+    # DELETE /api/v1/private/phone/devices/:deviceId
+    # Revoke a paired phone device by ID.
+    # @param device_id [String]
+    def revoke_device(device_id)
+      @http.delete("/api/v1/private/phone/devices/#{enc(device_id)}")
+    end
+
+    # GET /api/v1/private/phone/screen-tree
+    # Get the current accessibility tree from the paired phone's screen.
+    def screen_tree
+      @http.get("/api/v1/private/phone/screen-tree")
+    end
+
+    # GET /api/v1/private/phone/apps
+    # List installed apps on the paired phone.
+    def list_apps
+      @http.get("/api/v1/private/phone/apps").dig("result", "apps") || []
+    end
+
+    # PUT /api/v1/private/phone/apps/allowed
+    # Set the allowlist of apps that agents are permitted to interact with.
+    # @param package_names [Array<String>]
+    def set_allowed_apps(package_names)
+      apps = package_names.map { |package| { "package" => package } }
+      @http.put("/api/v1/private/phone/apps/allowed", "apps" => apps)
+    end
+
+    # POST /api/v1/private/phone/active-run
+    # Register the currently active pipeline run on the phone (used by agents).
+    # @param run_id [String]
+    def register_active_run(run_id)
+      @http.post("/api/v1/private/phone/active-run", "runId" => run_id)
+    end
+
+    private
+
+    def enc(s)
+      URI.encode_www_form_component(s.to_s)
+    end
+  end
+end