pmxt-core 2.50.16 → 2.51.0

package/dist/exchanges/hunch/api.d.ts

@@ -0,0 +1,736 @@
+/**
+ * Embedded Hunch agent-platform OpenAPI spec (subset).
+ *
+ * SOURCED VERBATIM from the LIVE spec at https://www.playhunch.xyz/openapi.json
+ * (fetched while authoring this adapter), trimmed to the operations the Hunch
+ * adapter actually drives. operationIds are preserved exactly so the implicit
+ * API generated by parseOpenApiSpec() exposes them under the same names:
+ *   listMarkets, getMarket, researchMarket, quoteBet, placeBet,
+ *   listPositions, getResult, checkWallet, getStats, getHealth.
+ *
+ * MAINTAINER NOTE: regenerate by re-fetching /openapi.json (the project would
+ * normally do this via `npm run fetch:openapi`; this exchange was authored
+ * against the live prod spec directly). Hunch reads are keyless (no security
+ * scheme); the trade route settles via x402 / EIP-3009 — see index.ts createOrder.
+ */
+export declare const hunchApiSpec: {
+    readonly openapi: "3.1.0";
+    readonly info: {
+        readonly title: "Hunch agent platform API";
+        readonly version: "hunch-agent-api-v1";
+    };
+    readonly servers: readonly [{
+        readonly url: "https://www.playhunch.xyz";
+    }];
+    readonly paths: {
+        readonly "/api/agent/v1/markets": {
+            readonly get: {
+                readonly operationId: "listMarkets";
+                readonly summary: "List tradeable markets with live odds.";
+                readonly description: "List tradeable markets with live odds.";
+                readonly tags: readonly ["markets"];
+                readonly "x-hunch-status": "live";
+                readonly parameters: readonly [{
+                    readonly name: "status";
+                    readonly in: "query";
+                    readonly required: false;
+                    readonly description: "open (default) = tradeable now; all includes settled markets.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly enum: readonly ["open", "all"];
+                        readonly default: "open";
+                    };
+                }, {
+                    readonly name: "type";
+                    readonly in: "query";
+                    readonly required: false;
+                    readonly description: "Exact targetMetric filter (e.g. market_cap, price_direction, token_mcap_flip).";
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }, {
+                    readonly name: "token";
+                    readonly in: "query";
+                    readonly required: false;
+                    readonly description: "Case-insensitive token symbol filter (e.g. BNKR).";
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }, {
+                    readonly name: "ids";
+                    readonly in: "query";
+                    readonly required: false;
+                    readonly description: "Comma-separated batch of market ids or slugs.";
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }, {
+                    readonly name: "limit";
+                    readonly in: "query";
+                    readonly required: false;
+                    readonly description: "Maximum results (≤ 200).";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 200;
+                    };
+                }];
+                readonly responses: {
+                    readonly "200": {
+                        readonly description: "The Base-only tradeable market list with live odds.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly meta: {
+                                            readonly $ref: "#/components/schemas/AgentMeta";
+                                        };
+                                        readonly count: {
+                                            readonly type: "integer";
+                                        };
+                                        readonly markets: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly $ref: "#/components/schemas/AgentMarketRef";
+                                            };
+                                        };
+                                    };
+                                    readonly required: readonly ["meta", "count", "markets"];
+                                };
+                            };
+                        };
+                    };
+                    readonly "404": {
+                        readonly description: "Not found — an unknown id/slug, or the agent platform flag is off (the entire /api/agent/v1 surface returns 404 while dark).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly "/api/agent/v1/markets/{id}": {
+            readonly get: {
+                readonly operationId: "getMarket";
+                readonly summary: "One market's full reference: question, odds, outcomes, deadline, fee, links.";
+                readonly description: "One market's full reference: question, odds, outcomes, deadline, fee, links.";
+                readonly tags: readonly ["markets"];
+                readonly "x-hunch-status": "live";
+                readonly parameters: readonly [{
+                    readonly name: "id";
+                    readonly in: "path";
+                    readonly required: true;
+                    readonly description: "Market id or slug.";
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }];
+                readonly responses: {
+                    readonly "200": {
+                        readonly description: "The market's enriched reference (live odds + stats folded in).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly meta: {
+                                            readonly $ref: "#/components/schemas/AgentMeta";
+                                        };
+                                        readonly market: {
+                                            readonly $ref: "#/components/schemas/AgentMarketRef";
+                                        };
+                                    };
+                                    readonly required: readonly ["meta", "market"];
+                                };
+                            };
+                        };
+                    };
+                    readonly "404": {
+                        readonly description: "Not found — an unknown id/slug, or the agent platform flag is off (the entire /api/agent/v1 surface returns 404 while dark).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly "/api/agent/v1/markets/{id}/research": {
+            readonly get: {
+                readonly operationId: "researchMarket";
+                readonly summary: "Decision-grade research: resolution rules, odds history, observations, price impact, related markets.";
+                readonly description: "Decision-grade research: resolution rules, odds history, observations, price impact, related markets.";
+                readonly tags: readonly ["markets"];
+                readonly "x-hunch-status": "live";
+                readonly parameters: readonly [{
+                    readonly name: "id";
+                    readonly in: "path";
+                    readonly required: true;
+                    readonly description: "Market id or slug.";
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }];
+                readonly responses: {
+                    readonly "200": {
+                        readonly description: "Decision-grade research. The advisory field is DATA ONLY (always null in Phase 1) — the betting decision is the agent's own.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly meta: {
+                                            readonly $ref: "#/components/schemas/AgentMeta";
+                                        };
+                                        readonly research: {
+                                            readonly $ref: "#/components/schemas/AgentResearch";
+                                        };
+                                    };
+                                    readonly required: readonly ["meta", "research"];
+                                };
+                            };
+                        };
+                    };
+                    readonly "404": {
+                        readonly description: "Not found — an unknown id/slug, or the agent platform flag is off (the entire /api/agent/v1 surface returns 404 while dark).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly "/api/agent/v1/quote": {
+            readonly get: {
+                readonly operationId: "quoteBet";
+                readonly summary: "Price a bet: tier, priceCents, estimatedShares, fee breakdown, 60s quoteId.";
+                readonly description: "Price a bet: tier, priceCents, estimatedShares, fee breakdown, 60s quoteId.";
+                readonly tags: readonly ["trading"];
+                readonly "x-hunch-status": "live";
+                readonly parameters: readonly [{
+                    readonly name: "marketId";
+                    readonly in: "query";
+                    readonly required: true;
+                    readonly description: "Market id or slug.";
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }, {
+                    readonly name: "side";
+                    readonly in: "query";
+                    readonly required: false;
+                    readonly description: "yes | no | up | down | <bucketKey> — validated against the market's outcome keys.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly default: "yes";
+                    };
+                }, {
+                    readonly name: "sizeUsd";
+                    readonly in: "query";
+                    readonly required: false;
+                    readonly description: "Bet size in USD. $1 floor, NO maximum — a quote above $10 persists a verifiable 60-second lock behind its quoteId.";
+                    readonly schema: {
+                        readonly type: "number";
+                        readonly minimum: 1;
+                        readonly default: 1;
+                    };
+                }];
+                readonly responses: {
+                    readonly "200": {
+                        readonly description: "The live quote. Always carries a quoteId; pass suggestedMinSharesOut back as minSharesOut on a locked-tier trade.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly meta: {
+                                            readonly $ref: "#/components/schemas/AgentMeta";
+                                        };
+                                        readonly quote: {
+                                            readonly $ref: "#/components/schemas/AgentQuote";
+                                        };
+                                    };
+                                    readonly required: readonly ["meta", "quote"];
+                                };
+                            };
+                        };
+                    };
+                    readonly "400": {
+                        readonly description: "invalid_request — marketId missing, or sizeUsd above the $1,000,000,000 technical precision bound (split the bet).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "404": {
+                        readonly description: "Not found — an unknown id/slug, or the agent platform flag is off (the entire /api/agent/v1 surface returns 404 while dark).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "422": {
+                        readonly description: "size_below_min (the $1 floor) or invalid_side.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "429": {
+                        readonly description: "rate_limited — 30 quotes/min per IP.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "500": {
+                        readonly description: "internal_error — the book or quote storage was unreadable; retry shortly.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly "/api/agent/v1/trade": {
+            readonly post: {
+                readonly operationId: "placeBet";
+                readonly summary: "Place a bet via x402 (USDC on Base). simulate:true = $0 dry-run of the full pipeline. $1 floor, NO maximum.";
+                readonly description: "Settle a real USDC bet on Base via x402 — or dry-run it for $0 with \"simulate\": true (runs the FULL validation pipeline, including locked-tier quote verification, but moves nothing). Flow: POST the bet body with no payment header → HTTP 402 challenge → sign an EIP-3009 transferWithAuthorization for exactly accepts[0].maxAmountRequired → retry the SAME body with the X-PAYMENT header. Keyless: the paying wallet IS the account. $1 floor, NO maximum; above $10 the body must also carry quoteId plus minSharesOut or maxPriceCents (from GET /api/agent/v1/quote). Idempotent on idemKey — a replay returns the original receipt and never double-settles.";
+                readonly tags: readonly ["trading"];
+                readonly "x-hunch-status": "live";
+                readonly parameters: readonly [{
+                    readonly name: "X-PAYMENT";
+                    readonly in: "header";
+                    readonly required: false;
+                    readonly description: "base64(JSON x402 envelope) carrying the signed EIP-3009 transferWithAuthorization. Omit on the first call to receive the 402 challenge; retry the SAME body with this header to settle. Not needed when simulate is true.";
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }];
+                readonly requestBody: {
+                    readonly required: true;
+                    readonly content: {
+                        readonly "application/json": {
+                            readonly schema: {
+                                readonly $ref: "#/components/schemas/AgentTradeRequest";
+                            };
+                        };
+                    };
+                };
+                readonly responses: {
+                    readonly "200": {
+                        readonly description: "The trade receipt. simulated:true receipts carry txHash:null — no funds moved.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly meta: {
+                                            readonly $ref: "#/components/schemas/AgentMeta";
+                                        };
+                                        readonly replay: {
+                                            readonly type: "boolean";
+                                            readonly description: "true when this idemKey had already settled — the ORIGINAL receipt is returned (no double-settle).";
+                                        };
+                                        readonly receipt: {
+                                            readonly $ref: "#/components/schemas/AgentTradeReceipt";
+                                        };
+                                    };
+                                    readonly required: readonly ["meta", "receipt"];
+                                };
+                            };
+                        };
+                        readonly headers: {
+                            readonly "X-Payment-Response": {
+                                readonly description: "base64 settlement summary {success, transaction, network, payer}. Present after real settlement; absent on a simulate receipt.";
+                                readonly schema: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                    };
+                    readonly "400": {
+                        readonly description: "invalid_request — the body is not valid JSON or fails the strict AgentTradeRequest schema (per-field problems are listed in the error's issues extra).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "402": {
+                        readonly description: "x402 payment challenge — the request carried no (or an invalid) X-PAYMENT header. Sign an EIP-3009 transferWithAuthorization for exactly accepts[0].maxAmountRequired to accepts[0].payTo on Base, then retry the SAME POST body with the X-PAYMENT header (base64 of the signed envelope). The challenge resource embeds this trade's intent hash for audit.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/X402Challenge";
+                                };
+                            };
+                        };
+                    };
+                    readonly "404": {
+                        readonly description: "Not found — an unknown id/slug, or the agent platform flag is off (the entire /api/agent/v1 surface returns 404 while dark).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "409": {
+                        readonly description: "market_closed (no longer accepts bets) or idem_conflict (this idemKey was used for a DIFFERENT trade — generate a fresh one).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "422": {
+                        readonly description: "invalid_side / invalid_wallet / size_below_min / quote_required / quote_expired / quote_mismatch / slippage_exceeded / insufficient_balance / pool_impact_exceeded / unsupported_market / payment_invalid — the error code + hint say exactly what to change.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "429": {
+                        readonly description: "rate_limited — 10 trades/min per wallet (also returned with status 409 semantics when the same idemKey is already settling — retry it shortly to fetch the receipt).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "500": {
+                        readonly description: "internal_error — possibly reconcilable: if the tx WAS submitted but recording failed, the body carries txHash; retry with the SAME idemKey to fetch the receipt (settlement is idempotent).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "503": {
+                        readonly description: "platform_paused — trading is temporarily paused (kill switch) or settlement is unavailable. Poll GET /api/agent/v1/health.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly "/api/agent/v1/positions": {
+            readonly get: {
+                readonly operationId: "listPositions";
+                readonly summary: "A wallet's open + resolved positions with live PnL (merges the Bankr partner rail).";
+                readonly description: "A wallet's open + resolved positions with live PnL (merges the Bankr partner rail).";
+                readonly tags: readonly ["positions"];
+                readonly "x-hunch-status": "live";
+                readonly parameters: readonly [{
+                    readonly name: "wallet";
+                    readonly in: "query";
+                    readonly required: true;
+                    readonly description: "The betting wallet (0x + 40 hex). Merges BOTH rail identities (agent: and bankr:) so the full book is visible.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly pattern: "^0x[0-9a-fA-F]{40}$";
+                    };
+                }];
+                readonly responses: {
+                    readonly "200": {
+                        readonly description: "Open + resolved positions with live PnL, newest first.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly meta: {
+                                            readonly $ref: "#/components/schemas/AgentMeta";
+                                        };
+                                        readonly wallet: {
+                                            readonly type: "string";
+                                        };
+                                        readonly count: {
+                                            readonly type: "integer";
+                                        };
+                                        readonly summary: {
+                                            readonly $ref: "#/components/schemas/AgentPositionsSummary";
+                                        };
+                                        readonly positions: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly $ref: "#/components/schemas/AgentPosition";
+                                            };
+                                        };
+                                    };
+                                    readonly required: readonly ["meta", "wallet", "count", "summary", "positions"];
+                                };
+                            };
+                        };
+                    };
+                    readonly "404": {
+                        readonly description: "Not found — an unknown id/slug, or the agent platform flag is off (the entire /api/agent/v1 surface returns 404 while dark).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "422": {
+                        readonly description: "invalid_wallet — not a 0x + 40-hex Base address.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly "/api/agent/v1/result": {
+            readonly get: {
+                readonly operationId: "getResult";
+                readonly summary: "A market's resolution status, winning outcome, and payout-per-share.";
+                readonly description: "A market's resolution status, winning outcome, and payout-per-share.";
+                readonly tags: readonly ["positions"];
+                readonly "x-hunch-status": "live";
+                readonly parameters: readonly [{
+                    readonly name: "marketId";
+                    readonly in: "query";
+                    readonly required: true;
+                    readonly description: "Market id or slug — resolved against the FULL catalogue (anything the agent may hold).";
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }];
+                readonly responses: {
+                    readonly "200": {
+                        readonly description: "The resolution view. An unresolved market returns status \"pending\" with null outcome fields.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly meta: {
+                                            readonly $ref: "#/components/schemas/AgentMeta";
+                                        };
+                                        readonly result: {
+                                            readonly $ref: "#/components/schemas/AgentResult";
+                                        };
+                                    };
+                                    readonly required: readonly ["meta", "result"];
+                                };
+                            };
+                        };
+                    };
+                    readonly "400": {
+                        readonly description: "invalid_request — marketId is required.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "404": {
+                        readonly description: "Not found — an unknown id/slug, or the agent platform flag is off (the entire /api/agent/v1 surface returns 404 while dark).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly "/api/agent/v1/wallet/{address}/readiness": {
+            readonly get: {
+                readonly operationId: "checkWallet";
+                readonly summary: "Wallet readiness: Base USDC balance, min-bet coverage, funding guidance (gas never needed).";
+                readonly description: "Wallet readiness: Base USDC balance, min-bet coverage, funding guidance (gas never needed).";
+                readonly tags: readonly ["platform"];
+                readonly "x-hunch-status": "live";
+                readonly parameters: readonly [{
+                    readonly name: "address";
+                    readonly in: "path";
+                    readonly required: true;
+                    readonly description: "Base wallet address (0x + 40 hex).";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly pattern: "^0x[0-9a-fA-F]{40}$";
+                    };
+                }];
+                readonly responses: {
+                    readonly "200": {
+                        readonly description: "Funding readiness: Base USDC balance, min-bet coverage, funding guidance. Gas is NEVER needed — transfers are relayed; the wallet only holds USDC.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly meta: {
+                                            readonly $ref: "#/components/schemas/AgentMeta";
+                                        };
+                                        readonly readiness: {
+                                            readonly $ref: "#/components/schemas/AgentReadiness";
+                                        };
+                                    };
+                                    readonly required: readonly ["meta", "readiness"];
+                                };
+                            };
+                        };
+                    };
+                    readonly "404": {
+                        readonly description: "Not found — an unknown id/slug, or the agent platform flag is off (the entire /api/agent/v1 surface returns 404 while dark).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                    readonly "422": {
+                        readonly description: "invalid_wallet — not a 0x + 40-hex Base address.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly "/api/agent/v1/stats": {
+            readonly get: {
+                readonly operationId: "getStats";
+                readonly summary: "Platform trust stats: markets, volume, payouts, auto-payout rate, proof samples.";
+                readonly description: "Platform trust stats: markets, volume, payouts, auto-payout rate, proof samples.";
+                readonly tags: readonly ["platform"];
+                readonly "x-hunch-status": "live";
+                readonly responses: {
+                    readonly "200": {
+                        readonly description: "Platform trust stats (cached ~60s): markets, lifetime bets + volume, paid-out USD, auto-payout rate, on-chain proof samples.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly meta: {
+                                            readonly $ref: "#/components/schemas/AgentMeta";
+                                        };
+                                        readonly stats: {
+                                            readonly $ref: "#/components/schemas/AgentStats";
+                                        };
+                                    };
+                                    readonly required: readonly ["meta", "stats"];
+                                };
+                            };
+                        };
+                    };
+                    readonly "404": {
+                        readonly description: "Not found — an unknown id/slug, or the agent platform flag is off (the entire /api/agent/v1 surface returns 404 while dark).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly "/api/agent/v1/health": {
+            readonly get: {
+                readonly operationId: "getHealth";
+                readonly summary: "Liveness + trading status. 200 even when degraded; ok:false means paused.";
+                readonly description: "Liveness + trading status. Deliberately HTTP 200 even when degraded — branch on the BODY's health.ok (false = trading paused), never on the status code.";
+                readonly tags: readonly ["platform"];
+                readonly "x-hunch-status": "live";
+                readonly responses: {
+                    readonly "200": {
+                        readonly description: "Always 200 while the platform flag is on; health.ok carries the signal.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly meta: {
+                                            readonly $ref: "#/components/schemas/AgentMeta";
+                                        };
+                                        readonly health: {
+                                            readonly $ref: "#/components/schemas/AgentHealth";
+                                        };
+                                    };
+                                    readonly required: readonly ["meta", "health"];
+                                };
+                            };
+                        };
+                    };
+                    readonly "404": {
+                        readonly description: "Not found — an unknown id/slug, or the agent platform flag is off (the entire /api/agent/v1 surface returns 404 while dark).";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly $ref: "#/components/schemas/AgentError";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+};