@0xinsider/sdk 0.25.0 → 0.27.0

package/dist/retry.d.ts

@@ -55,6 +55,25 @@ export declare const RETRY_AFTER_CEILING_MS = 60000;
 export declare function parseRetryAfter(header: string | null | undefined, nowMs?: number): number | null;
 /** `parseRetryAfter` over a response's `Retry-After` header. */
 export declare function retryAfterSeconds(response: Response): number | null;
+/**
+ * Parse a `Retry-After` header value by the RFC 9110 grammar alone into whole
+ * seconds, or `null` when it does not match.
+ *
+ * `parseRetryAfter` drives this module's own waits and keeps its documented
+ * extensions (a fractional delay, any date `Date.parse` reads). This one is
+ * for a caller that hands the seconds on as a validated fact rather than
+ * waiting on them: the stdio MCP server's `retry_after_seconds` field and its
+ * "Retry after Ns." text (#19729), which must agree and must never present a
+ * malformed header as an instruction.
+ *
+ * - delay-seconds: digits only (`"60"`). A sign, fraction, exponent, trailing
+ *   text, or a value past `Number.MAX_SAFE_INTEGER` is `null`.
+ * - HTTP-date: IMF-fixdate, the obsolete RFC 850 form and asctime, with the
+ *   calendar date and the weekday checked. The delay counts from `nowMs` and
+ *   rounds up to a whole second; a date already past is `0`.
+ * - Anything else, an empty value included, is `null`.
+ */
+export declare function parseRetryAfterStrict(header: string | null | undefined, nowMs?: number): number | null;
 /**
  * Resolve after `ms`, or reject with the signal's reason the moment it
  * aborts. A wait longer than `MAX_TIMER_DELAY_MS` runs as consecutive timers

package/dist/retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAAgB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,KAAK,GAAE,MAAmB,GACzB,MAAM,GAAG,IAAI,CAaf;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAEnE;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wEAAwE;AACxE,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,OAAO,CAAC,CAQlB"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAAgB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,KAAK,GAAE,MAAmB,GACzB,MAAM,GAAG,IAAI,CAaf;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAEnE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,KAAK,GAAE,MAAmB,GACzB,MAAM,GAAG,IAAI,CAWf;AA4FD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wEAAwE;AACxE,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/retry.js

@@ -73,6 +73,117 @@ export function parseRetryAfter(header, nowMs = Date.now()) {
 export function retryAfterSeconds(response) {
     return parseRetryAfter(response.headers.get("retry-after"));
 }
+/**
+ * Parse a `Retry-After` header value by the RFC 9110 grammar alone into whole
+ * seconds, or `null` when it does not match.
+ *
+ * `parseRetryAfter` drives this module's own waits and keeps its documented
+ * extensions (a fractional delay, any date `Date.parse` reads). This one is
+ * for a caller that hands the seconds on as a validated fact rather than
+ * waiting on them: the stdio MCP server's `retry_after_seconds` field and its
+ * "Retry after Ns." text (#19729), which must agree and must never present a
+ * malformed header as an instruction.
+ *
+ * - delay-seconds: digits only (`"60"`). A sign, fraction, exponent, trailing
+ *   text, or a value past `Number.MAX_SAFE_INTEGER` is `null`.
+ * - HTTP-date: IMF-fixdate, the obsolete RFC 850 form and asctime, with the
+ *   calendar date and the weekday checked. The delay counts from `nowMs` and
+ *   rounds up to a whole second; a date already past is `0`.
+ * - Anything else, an empty value included, is `null`.
+ */
+export function parseRetryAfterStrict(header, nowMs = Date.now()) {
+    if (header === null || header === undefined)
+        return null;
+    const value = header.trim();
+    if (/^\d+$/.test(value)) {
+        const seconds = Number(value);
+        return Number.isSafeInteger(seconds) ? seconds : null;
+    }
+    const dateMs = httpDateMs(value, nowMs);
+    if (dateMs === null)
+        return null;
+    const seconds = Math.max(0, Math.ceil((dateMs - nowMs) / 1000));
+    return Number.isSafeInteger(seconds) ? seconds : null;
+}
+/** RFC 9110 section 5.6.7: all three HTTP-date forms, with UTC calendar validation. */
+function httpDateMs(value, nowMs) {
+    const shortDay = "(Mon|Tue|Wed|Thu|Fri|Sat|Sun)";
+    const month = "(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)";
+    const clock = "(\\d{2}):(\\d{2}):(\\d{2})";
+    let match = new RegExp(`^${shortDay}, (\\d{2}) ${month} (\\d{4}) ${clock} GMT$`).exec(value);
+    let obsoleteYear = false;
+    if (!match) {
+        match = new RegExp(`^(Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday), (\\d{2})-${month}-(\\d{2}) ${clock} GMT$`).exec(value);
+        obsoleteYear = match !== null;
+    }
+    let captures;
+    if (!match) {
+        const asctime = new RegExp(`^${shortDay} ${month} (\\d{2}| \\d) ${clock} (\\d{4})$`).exec(value);
+        if (!asctime)
+            return null;
+        captures = [
+            asctime[1],
+            asctime[3],
+            asctime[2],
+            asctime[7],
+            asctime[4],
+            asctime[5],
+            asctime[6],
+        ];
+    }
+    else {
+        captures = match.slice(1);
+    }
+    const [weekday, dayText, monthText, yearText, hourText, minuteText, secondText] = captures;
+    if (weekday === undefined ||
+        dayText === undefined ||
+        monthText === undefined ||
+        yearText === undefined ||
+        hourText === undefined ||
+        minuteText === undefined ||
+        secondText === undefined)
+        return null;
+    const day = Number(dayText);
+    const monthIndex = [
+        "Jan",
+        "Feb",
+        "Mar",
+        "Apr",
+        "May",
+        "Jun",
+        "Jul",
+        "Aug",
+        "Sep",
+        "Oct",
+        "Nov",
+        "Dec",
+    ].indexOf(monthText);
+    let year = Number(yearText);
+    const hour = Number(hourText);
+    const minute = Number(minuteText);
+    const second = Number(secondText);
+    if (hour > 23 || minute > 59 || second > 60)
+        return null;
+    const date = new Date(0);
+    const future = new Date(nowMs);
+    future.setUTCFullYear(future.getUTCFullYear() + 50);
+    if (obsoleteYear)
+        year += Math.floor(future.getUTCFullYear() / 100) * 100;
+    date.setUTCFullYear(year, monthIndex, day);
+    date.setUTCHours(hour, minute, Math.min(second, 59), 0);
+    if (obsoleteYear && date.getTime() > future.getTime()) {
+        year -= 100;
+        date.setUTCFullYear(year, monthIndex, day);
+    }
+    if (date.getUTCFullYear() !== year ||
+        date.getUTCMonth() !== monthIndex ||
+        date.getUTCDate() !== day)
+        return null;
+    if (["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"][date.getUTCDay()] !==
+        weekday.slice(0, 3))
+        return null;
+    return date.getTime() + (second === 60 ? 1000 : 0);
+}
 /**
  * Resolve after `ms`, or reject with the signal's reason the moment it
  * aborts. A wait longer than `MAX_TIMER_DELAY_MS` runs as consecutive timers

package/dist/retry.js.map

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

package/dist/schema.d.ts

@@ -1046,7 +1046,7 @@ export type ExploreMarket = {
     no_change_pct_24h: number | null;
     /** Backend-owned deterministic market discovery score used by the hot sort. */
     discover_score: number | null;
-    score_components?: {
+    score_components: {
         volume_signal: number | null;
         /** Canonical key since #16304; whale_signal is its deprecated spelling, emitted beside it with the same value. */
         large_trade_signal: number | null;
@@ -1063,7 +1063,7 @@ export type ExploreMarket = {
         price_move_signal: number | null;
         missing_price_penalty: number;
     };
-    freshness?: {
+    freshness: {
         enrichment_status: "available" | "unavailable";
         price_status: "available" | "unavailable";
     };
@@ -1298,19 +1298,19 @@ export type LargeExportPolicy = {
     /** Programmatic API-key-gated export routes (submit/status/download/cancel) and supported formats (json, ndjson, csv). */
     v1_async: {
         /** POST route template to submit an export job. fresh=true asks for a snapshot read after the submit instead of reusing a finished one. */
-        submit_route?: string;
+        submit_route: string;
         /** GET route template to poll job status. */
-        status_route?: string;
+        status_route: string;
         /** GET route template that 302-redirects to the file. */
-        download_route?: string;
+        download_route: string;
         /** POST route template to cancel a queued or running job. */
-        cancel_route?: string;
+        cancel_route: string;
         /** Supported ?format= values. */
-        formats?: ("json" | "ndjson" | "csv")[];
+        formats: ("json" | "ndjson" | "csv")[];
         /** Possible job status values. */
-        status_values?: ("queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled")[];
+        status_values: ("queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled")[];
         /** How long a finished export is retained before expiry. */
-        retention?: string;
+        retention: string;
     };
     direct_streaming: Record<string, unknown>;
     async_job: Record<string, unknown>;
@@ -1520,7 +1520,7 @@ export type MarketFlow = {
         /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the net-flow direction outcome; null when unavailable (e.g. unsynced markets). */
         token_id: string | null;
         /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
-        large_trade_count?: number;
+        large_trade_count: number;
         whale_trade_count: number;
         buy_volume_usd: number;
         sell_volume_usd: number;
@@ -1547,7 +1547,7 @@ export type MarketFlow = {
         /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the net-flow direction outcome; null when unavailable (e.g. unsynced markets). */
         token_id: string | null;
         /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
-        large_trade_count?: number;
+        large_trade_count: number;
         whale_trade_count: number;
         buy_volume_usd: number;
         sell_volume_usd: number;
@@ -1706,6 +1706,7 @@ export type MarketSnapshot = {
         side: "yes" | "no";
         label: string;
         token_id?: string;
+        /** The outcome's display price, the probability Polymarket shows for it: the midpoint of the cached top of book when the spread is at most 0.10, otherwise the token's last trade price. Omitted when neither is known, including a book wider than 0.10 with no last trade on record; top_of_book still carries that book's best_bid and best_ask. expand=trust explains a missing value in trust.current_price. */
         current_price?: number;
         top_of_book: MarketSnapshotTopOfBook;
     })[];
@@ -1766,7 +1767,7 @@ export type MarketSnapshotTrust = {
 };
 export type McpJsonRpcError = {
     jsonrpc: "2.0";
-    id?: string | number | null;
+    id: string | number | null;
     error: {
         code: number;
         message: string;
@@ -2048,7 +2049,7 @@ export type PickOfTheDayArchiveEntry = {
      * Deprecated compatibility daily release slot; use pick_id for identity and publication_order for scheduling.
      * @deprecated
      */
-    pick_rank?: number;
+    pick_rank: number;
     /** When this selection was published, as RFC3339 UTC. Use this instant for publication feeds and timelines; pick_date is the America/New_York product day, not a publication timestamp. Automatic picks publish from 03:00 America/New_York on pick_date. Absent only for historical rows whose publication instant is unknown. */
     published_at?: string;
     /** Human-readable matchup (e.g. "Portugal vs. Uzbekistan"). */
@@ -2170,7 +2171,7 @@ export type PickOfTheDayHitRate = {
     /** Number of picks still pending resolution (excluded from the hit rate). */
     pending: number;
     /** The flat stake every money figure here assumes, in USD: 1000 since 2026-09-22 (100 before). Always present. */
-    stake_usd?: number;
+    stake_usd: number;
     /** Cumulative profit (USD) of a stake_usd-per-pick strategy over visible valued decided picks: a priced win pays stake_usd/backed_price - stake_usd, every visible loss pays -stake_usd independent of price, and a void pays 0. An unpriced visible win and a current non-Insider row whose price is gated remain in wins/losses but are excluded from price-derived totals. */
     net_profit_usd: number;
     /** Total staked (USD) = stake_usd * count of visible valued decided picks: every visible loss plus every priced win. Void, unpriced wins, and current non-Insider rows whose price is gated are excluded. */
@@ -2222,7 +2223,7 @@ export type PickOfTheDayHitRate = {
     /** Measured public rows where close exactly equals entry. */
     clv_ties: number;
     /** Cumulative track-record series, one point per decided (win/loss) pick in ascending pick_date order (void and pending add no point). A non-valued decided row carries cumulative profit forward while advancing hit rate. The last point's net_profit_usd and hit_rate_pct equal the headline net_profit_usd and pct by construction. Empty when nothing is decided. */
-    series?: {
+    series: {
         /** The decided pick's publish date (YYYY-MM-DD). */
         date: string;
         /** Running cumulative stake_usd-per-pick profit (USD) through this pick; valued losses and priced wins are booked, while a non-valued decided row carries profit forward unchanged. */
@@ -2813,7 +2814,7 @@ export type SmartMoneyFlowMarket = {
         /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the net-flow direction outcome; null when unavailable (e.g. unsynced markets). */
         token_id: string | null;
         /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
-        large_trade_count?: number;
+        large_trade_count: number;
         whale_trade_count: number;
         buy_volume_usd: number;
         sell_volume_usd: number;
@@ -2828,7 +2829,7 @@ export type SmartMoneyFlowMarket = {
         /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the net-flow direction outcome; null when unavailable (e.g. unsynced markets). */
         token_id: string | null;
         /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
-        large_trade_count?: number;
+        large_trade_count: number;
         whale_trade_count: number;
         buy_volume_usd: number;
         sell_volume_usd: number;
@@ -2841,7 +2842,7 @@ export type SnapshotCompleteness = {
     reason: string;
     expected_days: number;
     /** Canonical key since #16304; covered_days_with_whale_activity is its deprecated spelling, emitted beside it with the same value. */
-    covered_days_with_large_trade_activity?: number;
+    covered_days_with_large_trade_activity: number;
     covered_days_with_whale_activity: number;
 };
 export type SnapshotState = {
@@ -2973,7 +2974,7 @@ export type Trader = {
     };
     strategy?: {
         /** Observed trading style identifier. New rows use two_sided, category_focused, high_activity, diversified, mixed, or unclassified. Historical identifiers remain readable during normal reclassification; style does not predict skill or intent. */
-        strategy_type?: string;
+        strategy_type: string;
         description?: string;
         confidence?: number;
     };
@@ -3501,8 +3502,6 @@ export type Usage = {
             pay_as_you_go: boolean;
             /** The most requests this account is admitted in a UTC calendar month once enforcement has begun: limit, or four times limit with pay as you go on (2,000,000 for Pro). null for an admin account, which no number stops. Additive since 2026-09-22. */
             ceiling: number | null;
-            /** A historical usage price has not been reconciled to this plan allowance. Pay as you go remains unavailable until billing reconciliation. */
-            unavailable_reason?: "usage_price_reconciliation_required" | null;
         } | null;
     };
     meta: ResponseMeta;
@@ -3853,6 +3852,8 @@ export interface OperationData {
         error?: {
             code: number;
             message: string;
+            /** Optional JSON-serializable error data. */
+            data?: Record<string, unknown> | unknown[] | string | number | boolean | null;
         };
     };
     createWebhook: WebhookEndpoint;
@@ -3882,10 +3883,10 @@ export interface OperationData {
     getEventReplaySince: EventReplayEvent[];
     getGame: Game;
     getHealth: {
-        status?: "ok" | "degraded" | "down" | "maintenance";
-        db?: boolean;
-        cache?: boolean;
-        subsystems?: {
+        status: "ok" | "degraded" | "down" | "maintenance";
+        db: boolean;
+        cache: boolean;
+        subsystems: {
             /** Whether the webhook outbox schema validated on this probe. false lowers status to degraded. true during a maintenance window, when nothing is probed. */
             webhook_compatibility: boolean;
             /** Public-safe aggregate status for expected background job successful-completion heartbeats. Does not expose Redis keys, job names, raw errors, provider payloads, wallet addresses, or condition IDs. */
@@ -4011,8 +4012,6 @@ export interface OperationData {
             pay_as_you_go: boolean;
             /** The most requests this account is admitted in a UTC calendar month once enforcement has begun: limit, or four times limit with pay as you go on (2,000,000 for Pro). null for an admin account, which no number stops. Additive since 2026-09-22. */
             ceiling: number | null;
-            /** A historical usage price has not been reconciled to this plan allowance. Pay as you go remains unavailable until billing reconciliation. */
-            unavailable_reason?: "usage_price_reconciliation_required" | null;
         } | null;
     };
     getWebhook: WebhookEndpoint;
@@ -5118,6 +5117,8 @@ export interface OperationResponse {
         error?: {
             code: number;
             message: string;
+            /** Optional JSON-serializable error data. */
+            data?: Record<string, unknown> | unknown[] | string | number | boolean | null;
         };
     };
     createWebhook: {