@0xinsider/sdk 0.22.0 → 0.24.0

package/dist/schema.d.ts

@@ -598,7 +598,7 @@ export type EdgeHunterObservation = {
     conviction_score: number;
     /** Whether the provider holder page came from the shared cache or a live provider read. */
     provider_read_source: "cached" | "live";
-    /** True only when neither provider outcome holder page hit the top-100 scan bound. False means the pile is a positive lower bound and cannot satisfy a future capital-promotion gate. */
+    /** True only when provider pagination proves exhaustion of both outcome holder populations. Observation collection may follow bounded cursor pages; hitting an individual 100-row page does not by itself prove incompleteness. Bounded or interrupted walks remain incomplete. False means holder counts and dollar totals measure the observed positive-holder subset. sharp_pct describes that observed subset and is not a lower bound on the full-population percentage. Incomplete scans cannot satisfy a future capital-promotion gate. */
     holder_scan_complete: boolean;
     /** Proven provider holder observation time. A warm cache hit uses only the original provider completion time from its companion metadata, never cache-read time. Null, malformed, future, or stale holder time fails in-play closed. */
     holder_snapshot_at: string | null;
@@ -615,7 +615,29 @@ export type EdgeHunterObservation = {
     /** Required nullable frozen metadata context. Null only during the legacy-generation transition; selected reads require sidecar readiness and fail closed with 503 instead. */
     market_context: EdgeHunterMarketContext | null;
 };
-/** Full Edge Hunter observations list envelope. The view literal distinguishes advanced collections, including empty pages. */
+/** Measured coverage of the frozen canonical observation generation and this requested page. For sports and esports reads, the first four counts remain global through category, cohort and all selectors. They are neither a census of all provider markets nor a count of successfully evaluated holders. Selected and returned counts describe the requested projection. An unmappable legacy category synthesizes a zero-work empty generation with all six counts zero and no degradation reasons; it does not read the all-sports cache. */
+export type EdgeHunterObservationCoverage = {
+    /** Sum of canonical source-generation funnel input across all sports, before category, cohort or selector projection. */
+    input_markets: number;
+    /** Canonical source-generation input assigned capacity_limited. These markets were intentionally outside the bounded holder-work admission and are not missing emitted rows. */
+    capacity_limited_markets: number;
+    /** All wider_holder and in_play observations emitted in the canonical source generation, before cohort, category or selector projection. Emerging pile is an overlapping projection and does not add source emissions. */
+    emitted_observations: number;
+    /** Canonical source-generation markets whose attempted holder scan did not establish complete coverage, including incomplete scans that did not emit an observation. */
+    incomplete_holder_markets: number;
+    /** Observations matching the requested cohort, category, selectors and applicable pinned projection cutoff before pagination. */
+    selected_observations: number;
+    /** Observation rows on this page; equals data.length. */
+    returned_observations: number;
+};
+/** One observed cause of operational degradation in the canonical all-sports observation generation. Reasons are independent of the one-terminal-per-input funnel and remain unchanged through category, cohort and selector projection. Intentional capacity limits and an unconfigured upcoming source are not degradation reasons. */
+export type EdgeHunterObservationDegradationReason = {
+    /** Recorded producer cause. holder_scan_incomplete means at least one attempted holder scan did not establish complete coverage; directional_unavailable can accompany an emitted wider_holder row; live_source_stale means provider live evidence exceeded its freshness bound. Other values identify reconciliation, applicable board-source or terminal failure evidence. */
+    reason: "holder_scan_incomplete" | "live_source_stale" | "directional_unavailable" | "funnel_unreconciled" | "board_live_unavailable" | "board_upcoming_unavailable" | "provider_unavailable" | "holder_deadline_unavailable" | "holder_computation_unavailable" | "missing_stored_market" | "price_unavailable" | "in_play_stale_observed" | "in_play_directional_unavailable" | "internal_unclassified" | "board_source_unavailable" | "board_deadline_unavailable";
+    /** Canonical sport for the recorded cause; null only for generation-wide evidence without a sport attribution. */
+    sport: string | null;
+};
+/** Full Edge Hunter observations list envelope. Required degradation_reasons explains the source-generation verdict; required coverage distinguishes source input, intentional capacity exclusions, source emissions, incomplete holder scans, selection and the returned page. The view literal distinguishes advanced collections, including empty pages. */
 export type EdgeHunterObservationsResponse = {
     object: "list";
     view: "observations";
@@ -625,8 +647,11 @@ export type EdgeHunterObservationsResponse = {
     next_cursor: string | null;
     /** Completion time of the shared observation snapshot pinned by the cursor. */
     snapshot_as_of: string;
-    /** True when an operational failure or unknown provider-board, holder, directional, reconciliation, or internal completeness state made this snapshot partial. This is snapshot-wide and can retain degradation that the funnel's one-terminal-per-input accounting cannot represent. Intentional bounded capacity_limited rows remain fully accounted in the funnel and do not by themselves set this field. */
+    /** True when an operational failure or unknown provider-board, holder, directional, reconciliation, or internal completeness state made this snapshot partial. This is snapshot-wide and can retain degradation that the funnel's one-terminal-per-input accounting cannot represent. Inspect degradation_reasons for every recorded source-generation cause and its nullable canonical sport attribution. Intentional bounded capacity_limited rows remain fully accounted in the funnel and do not by themselves set this field; board_upcoming_status=not_configured is not a failure. */
     degraded: boolean;
+    /** Sorted, deduplicated causes from the canonical all-sports generation, unchanged by category, cohort or selectors. Empty exactly when degraded is false. Capacity-limited input and board_upcoming_status=not_configured do not by themselves add a reason. */
+    degradation_reasons: EdgeHunterObservationDegradationReason[];
+    coverage: EdgeHunterObservationCoverage;
     funnel: EdgeHunterFunnelReport;
     meta: ResponseMeta;
     /** Normalized axes requested with a selector or category; omitted on an unselected default read. */
@@ -634,12 +659,14 @@ export type EdgeHunterObservationsResponse = {
 };
 /** Closed 25-value terminal-reason vocabulary for the accountable Edge Hunter observation funnel. capacity_limited is intentional bounded provider-work admission and does not itself set the snapshot degraded. board_source_unavailable is a completed board-source failure; board_deadline_unavailable means live-board work missed either an internal configured-scope deadline or the outer fair-wave deadline; both classify only already-started rows, so for the upcoming source read funnel.sports[].board_upcoming_status instead; provider_unavailable is reserved for an attempted holder-provider failure; holder_deadline_unavailable is holder cache/provider absolute-deadline exhaustion. */
 export type EdgeHunterObservationTerminalReason = "outside_horizon" | "resolved" | "provider_closed" | "provider_excluded" | "invalid_market" | "missing_token" | "missing_stored_market" | "not_provider_live" | "board_source_unavailable" | "board_deadline_unavailable" | "primary_slate_candidate" | "zero_indexed_holder_research" | "capacity_limited" | "provider_unavailable" | "holder_deadline_unavailable" | "holder_computation_unavailable" | "holder_scan_incomplete" | "no_current_graded_holder" | "split_holder_pile" | "price_unavailable" | "wider_holder_emitted" | "in_play_emitted" | "in_play_stale_observed" | "in_play_directional_unavailable" | "internal_unclassified";
-/** One provider outcome in YES/NO order. Null current_price means no verified current quote is available. */
+/** One provider outcome in fixed YES/NO order, including its frozen token identity and independently observed quote. Null current_price means no verified current quote is available. */
 export type EdgeHunterOutcome = {
     index: 0 | 1;
     label: string | null;
     provider_id: number | null;
-    current_price: EdgeHunterPrice;
+    /** Frozen provider CLOB token ID for this exact outcome in YES/NO order. Null when unavailable; not a participant identity. */
+    token_id: string | null;
+    current_price: EdgeHunterPrice | null;
 };
 export type EdgeHunterParticipant = {
     provider_id?: number;
@@ -754,7 +781,7 @@ export type EdgeHunterRow = {
     participants: EdgeHunterParticipant[];
     image: string | null;
     outcomes: EdgeHunterOutcome[];
-    signal: EdgeHunterSignal;
+    signal: EdgeHunterSignal | null;
     /** Required nullable frozen metadata context. Null only during the legacy-generation transition; selected reads require sidecar readiness and fail closed with 503 instead. */
     market_context: EdgeHunterMarketContext | null;
 };
@@ -776,7 +803,7 @@ export type EdgeHunterSelection = {
     /** Exact provider series slugs. Read market_context.series_slug; a missing selected series excludes the row. */
     series_slugs?: string[];
 };
-/** Backed-side analytics from the ranked snapshot, plus a separately dated current quote. Scores rank attention; they are not probabilities or order instructions. */
+/** Backed-side analytics, token identity, frozen ranked_at and aggregate category evidence from the ranked snapshot, plus a separately dated current quote. Scores rank attention; they are not probabilities or order instructions. */
 export type EdgeHunterSignal = {
     piled_side: string | null;
     piled_outcome_index: 0 | 1;
@@ -796,7 +823,13 @@ export type EdgeHunterSignal = {
     one_way_graded_usd: number | null;
     directional_confidence: number | null;
     directional_rank_score: number;
-    current_price: EdgeHunterPrice;
+    current_price: EdgeHunterPrice | null;
+    /** Frozen provider CLOB token ID for the backed outcome. Null when unavailable; matches outcomes[piled_outcome_index].token_id when the shared provider context is available. */
+    token_id: string | null;
+    /** UTC computation time copied from this ranked row's frozen signal_created_at. It dates the ranking, not the separately observed quote, metadata writer, or wallet entry. */
+    ranked_at: string;
+    /** Existing aggregate category evidence copied from the same ranked snapshot. Read its status, coverage and own clocks; it never changes admission or ordering and is not a predicted return. */
+    category_skill: EdgeHunterCategorySkill;
 };
 /** Full Edge Hunter signals list envelope. The view literal distinguishes advanced collections, including empty pages. */
 export type EdgeHunterSignalsResponse = {