rpc

type AccountDataAuthority struct {
	Scope        AccountDataScope          `json:"scope"`
	Source       AccountDataSource         `json:"source"`
	Availability AccountDataAvailability   `json:"availability"`
	Freshness    AccountDataFreshness      `json:"freshness"`
	Reason       AccountDataReason         `json:"reason,omitempty"`
	AsOf         time.Time                 `json:"as_of,omitzero"`
	Fields       *AccountFieldAvailability `json:"fields,omitempty"`
}

type AccountDataAvailability string

type AccountDataFreshness string

type AccountDataReason string

type AccountDataScope struct {
	AccountID   string `json:"account_id"`
	AccountMode string `json:"account_mode"`
}

type AccountDataSource string

type AccountFieldAvailability struct {
	AccountType          bool `json:"account_type"`
	BaseCurrency         bool `json:"base_currency"`
	NetLiquidation       bool `json:"net_liquidation"`
	BuyingPower          bool `json:"buying_power"`
	AvailableFunds       bool `json:"available_funds"`
	ExcessLiquidity      bool `json:"excess_liquidity"`
	TotalCash            bool `json:"total_cash"`
	MaintenanceMargin    bool `json:"maintenance_margin"`
	InitialMargin        bool `json:"initial_margin"`
	GrossPositionValue   bool `json:"gross_position_value"`
	UnrealizedPnL        bool `json:"unrealized_pnl"`
	RealizedPnL          bool `json:"realized_pnl"`
	Cushion              bool `json:"cushion"`
	LookAheadInitMargin  bool `json:"look_ahead_init_margin"`
	LookAheadMaintMargin bool `json:"look_ahead_maint_margin"`
	LookAheadAvailable   bool `json:"look_ahead_available_funds"`
	LookAheadExcess      bool `json:"look_ahead_excess_liquidity"`
	DailyPnL             bool `json:"daily_pnl"`
	PnLUnrealizedTotal   bool `json:"pnl_unrealized_total"`
	PnLRealizedTotal     bool `json:"pnl_realized_total"`
	CurrencyExposure     bool `json:"currency_exposure"`
}

type AccountResult struct {
	AccountID            string               `json:"account_id"`
	AccountType          string               `json:"account_type,omitempty"`
	BaseCurrency         string               `json:"base_currency"`
	NetLiquidation       float64              `json:"net_liquidation"`
	BuyingPower          float64              `json:"buying_power"`
	AvailableFunds       float64              `json:"available_funds"`
	ExcessLiquidity      float64              `json:"excess_liquidity"`
	TotalCash            float64              `json:"total_cash"`
	MaintenanceMargin    float64              `json:"maintenance_margin"`
	InitialMargin        float64              `json:"initial_margin"`
	GrossPositionValue   float64              `json:"gross_position_value"`
	UnrealizedPnL        float64              `json:"unrealized_pnl"`
	RealizedPnL          float64              `json:"realized_pnl"`
	Cushion              float64              `json:"cushion"`
	LookAheadInitMargin  float64              `json:"look_ahead_init_margin"`
	LookAheadMaintMargin float64              `json:"look_ahead_maint_margin"`
	LookAheadAvailable   float64              `json:"look_ahead_available_funds"`
	LookAheadExcess      float64              `json:"look_ahead_excess_liquidity"`
	DailyPnL             *float64             `json:"daily_pnl,omitempty"`
	DailyPnLObservation  *DailyPnLObservation `json:"daily_pnl_observation,omitempty"`
	PnLUnrealizedTotal   *float64             `json:"pnl_unrealized_total,omitempty"`
	PnLRealizedTotal     *float64             `json:"pnl_realized_total,omitempty"`
	CurrencyExposure     []CurrencyExposure   `json:"currency_exposure,omitempty"`
	// DataType is reserved for account-feed state; the account-summary
	// path is gateway-direct with no live/delayed dimension and the field
	// is currently left empty (omitted). Kept for shape parity with the
	// market-data surfaces.
	DataType string    `json:"data_type,omitempty"`
	AsOf     time.Time `json:"as_of"`
	// Authority carries the concrete account/mode, producer, freshness, and
	// per-field availability. Current daemon responses always populate it.
	Authority *AccountDataAuthority `json:"authority,omitempty"`
}

type AlertAuthorityUniverse string

type AlertCandidate = risk.AlertCandidate

type AlertCandidateSnapshot = risk.AlertCandidateSnapshot

type AlertCandidatesParams struct{}

type AlertCoverage = risk.AlertCoverage

type AlertCoverageFreshness = risk.AlertCoverageFreshness

type AlertCoverageState = risk.AlertCoverageState

type AlertDestination = risk.AlertDestination

type AlertEpisodeState = risk.AlertEpisodeState

type AlertEvidenceHealth = risk.AlertEvidenceHealth

type AlertKind = risk.AlertKind

type AlertMeasurements struct {
	Evaluations              uint64  `json:"evaluations"`
	CoveredEvaluations       uint64  `json:"covered_evaluations"`
	ActiveEvaluations        uint64  `json:"active_evaluations"`
	ActiveObservations       uint64  `json:"active_observations"`
	EpisodesOpened           uint64  `json:"episodes_opened"`
	EpisodesEscalated        uint64  `json:"episodes_escalated"`
	EpisodesRecovered        uint64  `json:"episodes_recovered"`
	EpisodesReopened         uint64  `json:"episodes_reopened"`
	DuplicateInputs          uint64  `json:"duplicate_inputs"`
	DuplicateCandidates      uint64  `json:"duplicate_candidates"`
	RepeatedActive           uint64  `json:"repeated_active_observations"`
	ActiveEvidenceChurn      uint64  `json:"active_evidence_revisions"`
	Equivocations            uint64  `json:"equivocations"`
	StaleSuppressions        uint64  `json:"stale_suppressions"`
	CoverageFailures         uint64  `json:"coverage_failures"`
	TimeToObserveSamples     uint64  `json:"time_to_observe_samples"`
	TimeToObserveTotalSecond float64 `json:"time_to_observe_total_seconds"`
	TimeToObserveMaxSecond   float64 `json:"time_to_observe_max_seconds"`
}

type AlertPresentationCode = risk.AlertPresentationCode

type AlertSeverity = risk.AlertSeverity

type AlertSnapshotState = risk.AlertSnapshotState

type AlertSource = risk.AlertSource

type AlertSourceCoverage = risk.AlertSourceCoverage

type AlertSourceStatus struct {
	Source            AlertSource            `json:"source"`
	Status            string                 `json:"status"`
	Reason            string                 `json:"reason"`
	AuthorityUniverse AlertAuthorityUniverse `json:"authority_universe,omitempty"`
	InputAsOf         time.Time              `json:"input_as_of,omitzero"`
	ObservedAt        time.Time              `json:"observed_at,omitzero"`
	Covered           bool                   `json:"covered"`
	// UncoveredRules lists canonical rule IDs whose per-rule coverage failed in
	// the source's latest evaluation while the source itself stayed covered.
	// Rule IDs are policy vocabulary — never candidate or account identity.
	UncoveredRules []string          `json:"uncovered_rules,omitempty"`
	Active         int               `json:"active_candidates"`
	Measurements   AlertMeasurements `json:"measurements"`
}

type AlertStatusParams struct{}

type AlertStatusResult struct {
	AsOf                  time.Time           `json:"as_of,omitzero"`
	ExpectedSources       []AlertSource       `json:"expected_sources"`
	Evaluations           uint64              `json:"evaluations"`
	RegistryApplyFailures uint64              `json:"registry_apply_failures"`
	Equivocations         uint64              `json:"equivocations"`
	LastErrorCode         string              `json:"last_error_code,omitempty"`
	Sources               []AlertSourceStatus `json:"sources"`
}

type ArtefactParams struct {
	// Artefact is morning | eod | weekly.
	Artefact string `json:"artefact"`
	Note     string `json:"note,omitempty"`
	Origin   string `json:"origin,omitempty"`
	// BriefFingerprint is set only by brief.ack. The existing policy
	// artefact verb leaves it empty and remains wire-compatible.
	BriefFingerprint string `json:"brief_fingerprint,omitempty"`
}

type ArtefactRecord struct {
	Artefact         string    `json:"artefact"`
	Class            string    `json:"class,omitempty"`
	CompletedAt      time.Time `json:"completed_at,omitzero"`
	Note             string    `json:"note,omitempty"`
	Origin           string    `json:"origin,omitempty"`
	BriefFingerprint string    `json:"brief_fingerprint,omitempty"`
	// PolicyFingerprint is daemon-authored by later monthly brief.ack handling.
	// A monthly completion applies only to this policy identity; a changed
	// policy reopens the local month. The generic policy artefact verb does not
	// populate monthly metadata.
	PolicyFingerprint string `json:"policy_fingerprint,omitempty"`
	// Evidence is render-only monthly metadata populated by later brief.ack
	// handling. Origin alone is never stronger attention proof.
	Evidence string `json:"evidence,omitempty"`
}

type AutoTradeStatus struct {
	Kind             string                 `json:"kind,omitempty"`
	AsOf             time.Time              `json:"as_of,omitzero"`
	Trading          TradingStatus          `json:"trading"`
	ProposalsEnabled bool                   `json:"proposals_enabled"`
	FastPathEnabled  bool                   `json:"fast_path_enabled"`
	HotReload        bool                   `json:"hot_reload"`
	ReloadInterval   string                 `json:"reload_interval,omitempty"`
	ProposalCadence  string                 `json:"proposal_cadence,omitempty"`
	Policy           ProtectionPolicyStatus `json:"policy"`
	Blocked          bool                   `json:"blocked"`
	Blockers         []TradingBlocker       `json:"blockers,omitempty"`
}

type BackgroundTaskStatus struct {
	// Name is a stable token identifying the task. Stable across
	// daemon versions; one of the documented values above.
	Name       string    `json:"name"`
	Status     string    `json:"status,omitempty"`
	Scope      string    `json:"scope,omitempty"`
	StartedAt  time.Time `json:"started_at,omitzero"`
	EtaSeconds int       `json:"eta_seconds,omitempty"`
	Progress   int       `json:"progress,omitempty"`
}

type BreadthDailyValue struct {
	Date           string  `json:"date"` // YYYY-MM-DD
	PctAbove50DMA  float64 `json:"pct_above_50dma"`
	PctAbove200DMA float64 `json:"pct_above_200dma,omitempty"`
	NewHighs       int     `json:"new_highs,omitempty"`
	NewLows        int     `json:"new_lows,omitempty"`
}

type BreadthRefreshFailure string

type BreadthRefreshProgress struct {
	SessionKey  string                `json:"session_key"`
	StartedAt   time.Time             `json:"started_at"`
	Processed   int                   `json:"processed"`
	Total       int                   `json:"total"`
	Deadline    time.Time             `json:"deadline,omitzero"`
	LastFailure BreadthRefreshFailure `json:"last_failure,omitempty"`
}

type BreadthSPXParams struct {
	// HistoryDays bounds the trailing daily series. Default 30 when
	// zero or negative; capped at 90 to keep the wire payload bounded.
	HistoryDays int `json:"history_days,omitempty"`
	// TimeoutMs bounds the wait when the engine has a fresh value but
	// the wire envelope is still being assembled. Default 5000 ms when
	// zero. Does not affect the multi-minute cold-start fan-out; that
	// path returns immediately with State="computing".
	TimeoutMs int `json:"timeout_ms,omitempty"`
}

type BreadthSPXResult struct {
	// State classifies the engine pipeline at the moment this envelope
	// was assembled (cold / computing / ready / degraded). Consumers
	// should branch on this, not on (value==0 && history==[]) heuristics.
	// See BreadthState docs for semantics.
	State BreadthState `json:"state"`
	// Refreshing is true when a newer breadth run is in flight or waiting to
	// retry while this envelope serves the last good snapshot.
	Refreshing bool `json:"refreshing,omitempty"`
	// Refresh is the current or most recently completed paced-pass progress.
	// It remains available after completion so operators can distinguish a
	// slow advancing run, a stopped run, and the last classified failure.
	Refresh *BreadthRefreshProgress `json:"refresh,omitempty"`
	// PctAbove50DMA is the current fast-window reading: percentage of
	// S&P 500 constituents trading above their own 50-day SMA. 0-100;
	// 50 is the symmetric midpoint. Spec rule of thumb: > 55 healthy,
	// 40-55 watch, < 40 with SPX at highs is the classic late-cycle
	// divergence. Zero is meaningful only when State == "ready" (a
	// State other than "ready" can carry the field at 0 as the "no
	// data yet" sentinel).
	PctAbove50DMA float64 `json:"pct_above_50dma"`
	// PctAbove200DMA is the slow-window reading: percentage above the
	// 200-day SMA. Caught the 1999 and 2021 cyclical tops cleanly.
	// Bands per locked plan: below 40% = red / 40-60% = yellow / above
	// 60% = green (calibrated to the post-Mag-7 era).
	PctAbove200DMA float64 `json:"pct_above_200dma"`
	// NewHighsToday is the count of constituents whose latest close
	// strictly exceeded their trailing 252-bar max (~1 year of
	// trading sessions ≈ "52-week high"). Names with < 252 sessions
	// of cached history are skipped.
	NewHighsToday int `json:"new_highs_today"`
	// NewLowsToday is the symmetric count for new 252-bar lows.
	NewLowsToday int `json:"new_lows_today"`
	// NetNewHighsPct is (NewHighsToday - NewLowsToday) / coverage × 100
	// where coverage is the count of names with enough history to
	// contribute. The classic "narrow rally" pattern is SPX near
	// highs with NetNewHighsPct near zero or negative — a small
	// number of mega-caps carrying the index while the median name
	// is rolling over.
	NetNewHighsPct float64 `json:"net_new_highs_pct"`
	// History is the trailing daily series, oldest first. Length is
	// bounded by BreadthSPXParams.HistoryDays. Each point carries
	// both SMA readings plus the new-highs/lows counts.
	History []BreadthDailyValue `json:"history,omitempty"`
	// Source identifies the data provenance for the headline value.
	// Free-form; renderers display verbatim.
	Source string `json:"source"`
	// Method is a short token naming the computation path so renderers
	// can disclose methodology. Current token:
	// "constituent-fanout-50/200dma+nh-v2"
	// (50-DMA + 200-DMA + new highs/lows over 252-bar rolling
	// max/min — all computed locally from constituent daily closes
	// pulled via IBKR's historical-bar feed, since IBKR doesn't
	// redistribute the underlying S&P DJI / NYSE breadth indices on
	// retail subscriptions).
	Method string `json:"method"`
	// AsOf is the daemon's wall-clock when the result was assembled.
	AsOf time.Time `json:"as_of"`
	// SessionKey is the US-equity session date represented by the
	// computed daily bars. It may differ from AsOf on weekends,
	// holidays, and before the current session's close is settled.
	SessionKey string `json:"session_key,omitempty"`
	// Stale reports that SessionKey is not the latest completed US-equity
	// session — the reading is a real past close, not the current one.
	// The engine withholds a below-coverage refresh and keeps serving the
	// previous snapshot, so a lane that stops producing serves plausible
	// numbers indefinitely; this is the field that dates them. It is
	// deliberately separate from State, which stays "ready" for a stale
	// snapshot: State gates whether regime, composite, and the brief
	// consume breadth at all, and a stale close is still evidence there.
	Stale bool `json:"stale,omitempty"`
	// SpotAt is the gateway-observation timestamp for the headline,
	// distinct from AsOf which covers history + headline.
	SpotAt time.Time `json:"spot_at,omitzero"`
	// DataType reflects the gateway's feed state when the headline
	// was captured — "live", "delayed", "frozen", "delayed-frozen",
	// or "" when no notice has arrived yet. Renderers use this to
	// dim the headline.
	DataType string `json:"data_type,omitempty"`
}

type BreadthState string

type BriefAccountRow struct {
	BriefRowState
	EquityBase   *float64  `json:"equity_base,omitempty"`
	DailyPnLBase *float64  `json:"daily_pnl_base,omitempty"`
	BaseCurrency string    `json:"base_currency,omitempty"`
	AsOf         time.Time `json:"as_of,omitzero"`
}

type BriefAckParams struct {
	Kind             string `json:"kind"`
	BriefFingerprint string `json:"brief_fingerprint"`
	Month            string `json:"month,omitempty"`
	Evidence         string `json:"evidence,omitempty"`
	Origin           string `json:"origin,omitempty"`
}

type BriefAckResult struct {
	OK               bool      `json:"ok"`
	Kind             string    `json:"kind"`
	Day              string    `json:"day"`
	At               time.Time `json:"at"`
	AlreadyStamped   bool      `json:"already_stamped,omitempty"`
	BriefFingerprint string    `json:"brief_fingerprint,omitempty"`
	Month            string    `json:"month,omitempty"`
	Evidence         string    `json:"evidence,omitempty"`
	Message          string    `json:"message,omitempty"`
}

type BriefArtefact struct {
	BriefRowState
	Kind        string    `json:"kind"`
	Cadence     string    `json:"cadence"` // daily | weekly
	Declared    bool      `json:"declared"`
	Completed   bool      `json:"completed"`
	CompletedAt time.Time `json:"completed_at,omitzero"`
}

type BriefArtefactsRow struct {
	BriefRowState
	Rows []BriefArtefact `json:"rows"`
}

type BriefAutoExtendRow struct {
	BriefRowState
	ReportID string    `json:"report_id,omitempty"`
	At       time.Time `json:"at,omitzero"`
}

type BriefBreadthRow struct {
	BriefRowState
	PctAbove50DMA  *float64  `json:"pct_above_50dma,omitempty"`
	PctAbove200DMA *float64  `json:"pct_above_200dma,omitempty"`
	NetNewHighsPct *float64  `json:"net_new_highs_pct,omitempty"`
	AsOf           time.Time `json:"as_of,omitzero"`
	DataType       string    `json:"data_type,omitempty"`
}

type BriefCalendarSection struct {
	BriefRowState
	Session      BriefSessionRow       `json:"session"`
	MarketEvents []BriefMarketEventRow `json:"market_events"`
}

type BriefCapitalEventsRow struct {
	BriefRowState
	Latched            bool      `json:"latched"`
	LatchedAt          time.Time `json:"latched_at,omitzero"`
	LatchAgeDays       *int      `json:"latch_age_days,omitempty"`
	ConsumedPctAtLatch *float64  `json:"consumed_pct_at_latch,omitempty"`
	AdjustedPeakBase   *float64  `json:"adjusted_peak_base,omitempty"`
	PeakAsOf           time.Time `json:"peak_as_of,omitzero"`
	BaseCurrency       string    `json:"base_currency,omitempty"`
}

type BriefCapitalRow struct {
	BriefRowState
	Tier             string   `json:"tier,omitempty"`
	Enforcement      string   `json:"enforcement,omitempty"`
	ConsumedPct      *float64 `json:"consumed_pct,omitempty"`
	DrawdownBase     *float64 `json:"drawdown_base,omitempty"`
	AdjustedPeakBase *float64 `json:"adjusted_peak_base,omitempty"`
	// PeakAsOf is when the current adjusted peak was observed. Provenance,
	// not decoration: a peak stamped during a closed session or a reconnect
	// window is the tell that exposes a poisoned observation.
	PeakAsOf     time.Time `json:"peak_as_of,omitzero"`
	BaseCurrency string    `json:"base_currency,omitempty"`
}

type BriefCountRow struct {
	BriefRowState
	Count *int `json:"count,omitempty"`
}

type BriefGammaRow struct {
	BriefRowState
	Spot      *float64  `json:"spot,omitempty"`
	ZeroGamma *float64  `json:"zero_gamma,omitempty"`
	GapPct    *float64  `json:"gap_pct,omitempty"`
	GammaSign string    `json:"gamma_sign,omitempty"`
	AsOf      time.Time `json:"as_of,omitzero"`
}

type BriefLastSessionRow struct {
	BriefRowState
	SessionDate  string    `json:"session_date,omitempty"`
	DailyPnLBase *float64  `json:"daily_pnl_base,omitempty"`
	BaseCurrency string    `json:"base_currency,omitempty"`
	SessionClose time.Time `json:"session_close,omitzero"`
	CapturedAt   time.Time `json:"captured_at,omitzero"`
}

type BriefLatchRow struct {
	BriefRowState
	Latched bool      `json:"latched"`
	At      time.Time `json:"latched_at,omitzero"`
	AgeDays *int      `json:"age_days,omitempty"`
	// ConsumedPctAtLatch is the consumed share recorded when the latch
	// engaged, so later data glitches cannot rewrite why it fired.
	ConsumedPctAtLatch *float64 `json:"consumed_pct_at_latch,omitempty"`
}

type BriefMarketEventRow struct {
	BriefRowState
	Kind    string   `json:"kind"` // earnings | halt | ssr | borrow
	Count   int      `json:"count"`
	Symbols []string `json:"symbols,omitempty"`
}

type BriefMarketSection struct {
	BriefRowState
	Regime  BriefRegimeRow  `json:"regime"`
	Breadth BriefBreadthRow `json:"breadth"`
	Gamma   BriefGammaRow   `json:"gamma"`
	Stress  BriefStressRow  `json:"stress"`
}

type BriefMoneyCoverageRow struct {
	BriefRowState
	AmountBase   *float64 `json:"amount_base,omitempty"`
	BaseCurrency string   `json:"base_currency,omitempty"`
	IncludedLegs int      `json:"included_legs"`
	ExcludedLegs int      `json:"excluded_legs"`
}

type BriefMonthlyPulseRow struct {
	Status      string    `json:"status"` // not_due | due | completed | blocked
	Month       string    `json:"month,omitempty"`
	DueAt       time.Time `json:"due_at,omitzero"`
	CompletedAt time.Time `json:"completed_at,omitzero"`
}

type BriefMover struct {
	Symbol       string  `json:"symbol"`
	DailyPnLBase float64 `json:"daily_pnl_base"`
}

type BriefMoversRow struct {
	BriefRowState
	Rows         []BriefMover `json:"rows"`
	OtherPnLBase *float64     `json:"other_daily_pnl_base,omitempty"`
	OtherCount   int          `json:"other_count,omitempty"`
}

type BriefNarrative struct {
	Lead   []BriefRun       `json:"lead,omitempty"`
	Review []BriefParagraph `json:"review,omitempty"`
	Ready  []BriefParagraph `json:"ready,omitempty"`
	Coda   []BriefRun       `json:"coda,omitempty"`
}

type BriefOneTapRow struct {
	BriefRowState
	ReportID string   `json:"report_id,omitempty"`
	Signable bool     `json:"signable"`
	Blockers []string `json:"blockers,omitempty"`
}

type BriefOverride struct {
	Control   string    `json:"control"`
	ExpiresAt time.Time `json:"expires_at"`
}

type BriefOverridesRow struct {
	BriefRowState
	Rows []BriefOverride `json:"rows"`
}

type BriefParagraph struct {
	Runs []BriefRun `json:"runs,omitempty"`
}

type BriefPolicyDriftRow struct {
	BriefRowState
	Rows []PolicyPinStatus `json:"rows"`
}

type BriefPortfolioSection struct {
	BriefRowState
	Account       BriefAccountRow       `json:"account"`
	Movers        BriefMoversRow        `json:"movers"`
	PremiumAtRisk BriefMoneyCoverageRow `json:"premium_at_risk"`
	HedgeCost     BriefMoneyCoverageRow `json:"hedge_cost"`
	WorkingOrders BriefCountRow         `json:"working_orders"`
}

type BriefProcessSection struct {
	BriefRowState
	Reconcile    BriefReconcileRow     `json:"reconcile"`
	AutoExtend   BriefAutoExtendRow    `json:"auto_extend"`
	OneTap       BriefOneTapRow        `json:"one_tap"`
	RulesDelta   BriefRulesDeltaRow    `json:"rules_delta"`
	Artefacts    BriefArtefactsRow     `json:"artefacts"`
	MonthlyPulse *BriefMonthlyPulseRow `json:"monthly_pulse,omitempty"`
}

type BriefProposalsRow struct {
	BriefRowState
	Day     string `json:"day,omitempty"`
	Offered int    `json:"offered"`
	Acted   int    `json:"acted"`
}

type BriefReadyProposalsRow struct {
	BriefRowState
	// Actionable is the served count of proposals with no blockers; Blocked
	// is the remainder of Total. Zero is a measured zero only when the
	// embedded row state is OK.
	Actionable int `json:"actionable"`
	Blocked    int `json:"blocked"`
	Total      int `json:"total"`
}

type BriefReadySection struct {
	BriefRowState
	Regime        BriefRegimeRow         `json:"regime"`
	Breadth       BriefBreadthRow        `json:"breadth"`
	Gamma         BriefGammaRow          `json:"gamma"`
	Stress        BriefStressRow         `json:"stress"`
	Session       BriefSessionRow        `json:"session"`
	MarketEvents  []BriefMarketEventRow  `json:"market_events"`
	Capital       BriefCapitalRow        `json:"capital"`
	Latch         BriefLatchRow          `json:"latch"`
	PremiumAtRisk BriefMoneyCoverageRow  `json:"premium_at_risk"`
	HedgeCost     BriefMoneyCoverageRow  `json:"hedge_cost"`
	Proposals     BriefReadyProposalsRow `json:"proposals"`
	PolicyDrift   BriefPolicyDriftRow    `json:"policy_drift"`
	Artefacts     BriefArtefactsRow      `json:"artefacts"`
	MonthlyPulse  *BriefMonthlyPulseRow  `json:"monthly_pulse,omitempty"`
}

type BriefReconcileRow struct {
	BriefRowState
	LastReconciledAt time.Time `json:"last_reconciled_at,omitzero"`
	Source           string    `json:"source,omitempty"`
	Deadline         time.Time `json:"deadline,omitzero"`
	DaysRemaining    *int      `json:"days_remaining,omitempty"`
}

type BriefRegimeRow struct {
	BriefRowState
	Stage   string `json:"stage,omitempty"`
	Verdict string `json:"verdict,omitempty"`
}

type BriefResult struct {
	AsOf              time.Time          `json:"as_of"`
	BriefFingerprint  string             `json:"brief_fingerprint"`
	StampTarget       string             `json:"stamp_target,omitempty"`
	StampTargetReason string             `json:"stamp_target_reason,omitempty"`
	Review            BriefReviewSection `json:"review"`
	Ready             BriefReadySection  `json:"ready"`
	Narrative         *BriefNarrative    `json:"narrative,omitempty"`
}

type BriefReviewSection struct {
	BriefRowState
	SessionPnL    BriefAccountRow       `json:"session_pnl"`
	LastSession   BriefLastSessionRow   `json:"last_session"`
	Attribution   BriefMoversRow        `json:"attribution"`
	RulesDelta    BriefRulesDeltaRow    `json:"rules_delta"`
	Proposals     BriefProposalsRow     `json:"proposals"`
	Overrides     BriefOverridesRow     `json:"overrides"`
	CapitalEvents BriefCapitalEventsRow `json:"capital_events"`
	Reconcile     BriefReconcileRow     `json:"reconcile"`
	AutoExtend    BriefAutoExtendRow    `json:"auto_extend"`
	OneTap        BriefOneTapRow        `json:"one_tap"`
	WorkingOrders BriefCountRow         `json:"working_orders"`
}

type BriefRiskSection struct {
	BriefRowState
	Capital     BriefCapitalRow     `json:"capital"`
	Latch       BriefLatchRow       `json:"latch"`
	Overrides   BriefOverridesRow   `json:"overrides"`
	PolicyDrift BriefPolicyDriftRow `json:"policy_drift"`
}

type BriefRowState struct {
	Status string `json:"status"`
	Detail string `json:"detail"`
}

type BriefRuleTransition struct {
	RuleID string `json:"rule_id"`
	From   string `json:"from"`
	To     string `json:"to"`
}

type BriefRulesDeltaRow struct {
	BriefRowState
	BaselineAt                 time.Time             `json:"baseline_at,omitzero"`
	Transitions                []BriefRuleTransition `json:"transitions,omitempty"`
	Added                      []string              `json:"added,omitempty"`
	Removed                    []string              `json:"removed,omitempty"`
	RulebookFingerprintChanged bool                  `json:"rulebook_fingerprint_changed"`
	BaselineFingerprint        string                `json:"baseline_fingerprint,omitempty"`
	CurrentFingerprint         string                `json:"current_fingerprint,omitempty"`
}

type BriefRun struct {
	Text string `json:"text"`
	Role string `json:"role,omitempty"`
}

type BriefSessionRow struct {
	BriefRowState
	Market   string    `json:"market,omitempty"`
	State    string    `json:"state,omitempty"`
	IsOpen   bool      `json:"is_open"`
	Open     time.Time `json:"open,omitzero"`
	Close    time.Time `json:"close,omitzero"`
	NextOpen time.Time `json:"next_open,omitzero"`
}

type BriefSnapshotParams struct{}

type BriefStressRow struct {
	BriefRowState
	Action   string `json:"action,omitempty"`
	Severity string `json:"severity,omitempty"`
	Summary  string `json:"summary,omitempty"`
}

type CancelParams struct {
	ID string `json:"id"`
}

type CapitalEventEntry struct {
	At          time.Time `json:"at"`
	Type        string    `json:"type"`
	AmountBase  float64   `json:"amount_base,omitempty"`
	EffectiveAt time.Time `json:"effective_at,omitzero"`
	Note        string    `json:"note,omitempty"`
	Origin      string    `json:"origin,omitempty"`
	ReportID    string    `json:"report_id,omitempty"`
}

type CapitalEventParams struct {
	// Type is deposit | withdrawal | reconcile.
	Type string `json:"type"`
	// AmountBase is required for deposit/withdrawal (positive), ignored
	// for reconcile.
	AmountBase float64 `json:"amount_base,omitempty"`
	// EffectiveAt is when the flow hit the account; zero means now. A
	// deposit declared after the peak already reflected it corrects the
	// peak downward (never-inflate discipline).
	EffectiveAt time.Time `json:"effective_at,omitzero"`
	Note        string    `json:"note,omitempty"`
	// Report is required for type reconcile since phase 3a: the recon
	// report id being signed off. The daemon refuses a reconcile whose
	// report is missing, stale, superseded, or carries unresolved
	// exceptions (internal-docs/design/post-trade-truth.md).
	Report string `json:"report,omitempty"`
	// Origin is the write-origin claim; the daemon rejects non-human
	// origins for every risk-policy write.
	Origin string `json:"origin,omitempty"`
}

type CapitalStateReport struct {
	Tier string `json:"tier"` // ok | warn | block | unknown | unapproved
	// Enforcement echoes the block tier's class so a "block" tier is
	// legible as shadow/advisory until promotion.
	Enforcement string `json:"enforcement"`
	// BoundAccount is the broker account this capital document adopted at its
	// first live observation. The drawdown ladder follows this account, not
	// the session pin: a session connected to a different account or mode
	// reads Tier "unknown" with this field naming the binding, rather than a
	// drawdown computed from one account's equity against another account's
	// peak. Empty until first adoption.
	BoundAccount             string    `json:"bound_account,omitempty"`
	EquityBase               *float64  `json:"equity_base,omitempty"`
	EquityAsOf               time.Time `json:"equity_as_of,omitzero"`
	EquityStale              bool      `json:"equity_stale,omitempty"`
	EffectiveRiskCapitalBase *float64  `json:"effective_risk_capital_base,omitempty"`
	AdjustedPeakBase         *float64  `json:"adjusted_peak_base,omitempty"`
	PeakAsOf                 time.Time `json:"peak_as_of,omitzero"`
	CumExternalFlowsBase     *float64  `json:"cum_external_flows_base,omitempty"`
	DeclaredCumFlowsBase     *float64  `json:"declared_cum_flows_base,omitempty"`
	StatementCumFlowsBase    *float64  `json:"statement_cum_flows_base,omitempty"`
	FlowSource               string    `json:"flow_source,omitempty"` // declared | statement
	DrawdownBase             *float64  `json:"drawdown_base,omitempty"`
	ConsumedPct              *float64  `json:"consumed_pct,omitempty"`
	BlockLatched             bool      `json:"block_latched"`
	LatchedAt                time.Time `json:"latched_at,omitzero"`
	// LatchConsumedPct is the consumed share at the moment the latch engaged.
	// Disclosed so a later data glitch inflating the live ConsumedPct cannot
	// retroactively misrepresent why the latch fired.
	LatchConsumedPct      *float64  `json:"latch_consumed_pct,omitempty"`
	LastReconciledAt      time.Time `json:"last_reconciled_at,omitzero"`
	LastReconcileReportID string    `json:"last_reconcile_report_id,omitempty"`
	LastReconcileSource   string    `json:"last_reconcile_source,omitempty"` // human | automatic
	ReconcileStale        bool      `json:"reconcile_stale,omitempty"`
	Reasons               []string  `json:"reasons,omitempty"`
	BaseCurrency          string    `json:"base_currency,omitempty"`
}

type ChainExpiriesParams struct {
	Symbol        string `json:"symbol"`
	WithIV        bool   `json:"with_iv,omitempty"`
	AllExpiries   bool   `json:"all_expiries,omitempty"`
	RequireLiveIV bool   `json:"require_live_iv,omitempty"`
	MinDTE        int    `json:"min_dte,omitempty"`
	MaxDTE        int    `json:"max_dte,omitempty"`
	TargetDTE     int    `json:"target_dte,omitempty"`
}

type ChainExpiriesResult struct {
	Symbol         string        `json:"symbol"`
	Spot           float64       `json:"spot,omitempty"`
	SpotSource     string        `json:"spot_source,omitempty"`
	SpotAsOf       time.Time     `json:"spot_as_of,omitzero"`
	Expiries       []ChainExpiry `json:"expiries"`
	WarningDetails []DataWarning `json:"warning_details,omitempty"`
	AsOf           time.Time     `json:"as_of"`
}

type ChainExpiry struct {
	Date           string    `json:"date"` // YYYY-MM-DD
	DTE            int       `json:"dte,omitempty"`
	IV             *float64  `json:"iv,omitempty"`
	IVStatus       string    `json:"iv_status,omitempty"`
	IVSource       string    `json:"iv_source,omitempty"`
	IVQuality      string    `json:"iv_quality,omitempty"`
	IVAsOf         time.Time `json:"iv_as_of,omitzero"`
	ImpliedMove    *float64  `json:"implied_move,omitempty"`
	ImpliedMovePct *float64  `json:"implied_move_pct,omitempty"`
}

type ChainFetchParams struct {
	Symbol       string `json:"symbol"`
	Expiry       string `json:"expiry"`                  // YYYY-MM-DD
	Width        int    `json:"width"`                   // ATM ± width
	Side         string `json:"side"`                    // calls | puts | both
	TradingClass string `json:"trading_class,omitempty"` // SPX | SPXW for multi-class index chains; empty = auto
}

type ChainLegSummary struct {
	Right     string   `json:"right"` // C | P
	Strike    float64  `json:"strike"`
	Bid       float64  `json:"bid,omitempty"`
	Ask       float64  `json:"ask,omitempty"`
	Mid       float64  `json:"mid,omitempty"`
	Spread    float64  `json:"spread,omitempty"`
	SpreadPct float64  `json:"spread_pct,omitempty"`
	OI        *int64   `json:"oi,omitempty"`
	Delta     *float64 `json:"delta,omitempty"`
}

type ChainLiquiditySummary struct {
	LiquidityGrade           string           `json:"liquidity_grade"` // good | fair | poor | untradable
	ATMSpreadPct             *float64         `json:"atm_spread_pct,omitempty"`
	NearestLiveCall          *ChainLegSummary `json:"nearest_live_call,omitempty"`
	NearestLivePut           *ChainLegSummary `json:"nearest_live_put,omitempty"`
	MinSpreadLiveStrike      *ChainLegSummary `json:"min_spread_live_strike,omitempty"`
	OICoveragePct            float64          `json:"oi_coverage_pct"`
	RecommendedStructureHint string           `json:"recommended_structure_hint"` // stock_only | shares_or_spreads | calls_ok | untradable_chain
}

type ChainResult struct {
	Symbol           string                 `json:"symbol"`
	TradingClass     string                 `json:"trading_class,omitempty"`
	Spot             float64                `json:"spot"`
	SpotSource       string                 `json:"spot_source,omitempty"`
	SpotAsOf         time.Time              `json:"spot_as_of,omitzero"`
	Expiry           string                 `json:"expiry"`
	DTE              int                    `json:"dte"`
	DataType         string                 `json:"data_type"`
	FeedType         string                 `json:"feed_type,omitempty"`
	SessionState     string                 `json:"session_state,omitempty"`
	TradableSummary  *ChainTradableSummary  `json:"tradable_summary,omitempty"`
	LiquiditySummary *ChainLiquiditySummary `json:"liquidity_summary,omitempty"`
	Strikes          []ChainStrike          `json:"strikes"`
	WarningDetails   []DataWarning          `json:"warning_details,omitempty"`
	AsOf             time.Time              `json:"as_of"`
}

type ChainStrike struct {
	Strike float64 `json:"strike"`
	IsATM  bool    `json:"is_atm,omitempty"`

	CallBid        *float64  `json:"call_bid"`
	CallAsk        *float64  `json:"call_ask"`
	CallLast       *float64  `json:"call_last"`
	CallPrevClose  *float64  `json:"call_prev_close,omitempty"`
	CallIV         *float64  `json:"call_iv"`
	CallDelta      *float64  `json:"call_delta"`
	CallOI         *int64    `json:"call_oi"`
	CallAsOf       time.Time `json:"call_as_of,omitzero"`
	CallDataStatus string    `json:"call_data_status,omitempty"`
	CallIVStatus   string    `json:"call_iv_status,omitempty"`
	CallOIStatus   string    `json:"call_oi_status,omitempty"`

	PutBid        *float64  `json:"put_bid"`
	PutAsk        *float64  `json:"put_ask"`
	PutLast       *float64  `json:"put_last"`
	PutPrevClose  *float64  `json:"put_prev_close,omitempty"`
	PutIV         *float64  `json:"put_iv"`
	PutDelta      *float64  `json:"put_delta"`
	PutOI         *int64    `json:"put_oi"`
	PutAsOf       time.Time `json:"put_as_of,omitzero"`
	PutDataStatus string    `json:"put_data_status,omitempty"`
	PutIVStatus   string    `json:"put_iv_status,omitempty"`
	PutOIStatus   string    `json:"put_oi_status,omitempty"`
}

type ChainTradableSummary struct {
	TotalLegs          int     `json:"total_legs"`
	LiveBidAskLegs     int     `json:"live_bid_ask_legs"`
	OneSidedLiveLegs   int     `json:"one_sided_live_legs"`
	StaleLegs          int     `json:"stale_legs"`
	ModelOnlyLegs      int     `json:"model_only_legs"`
	SubscribeErrorLegs int     `json:"subscribe_error_legs"`
	NoQuoteLegs        int     `json:"no_quote_legs"`
	OICoveredLegs      int     `json:"oi_covered_legs"`
	OICoveragePct      float64 `json:"oi_coverage_pct"`
	OptionsTradable    bool    `json:"options_tradable"`
	FeedGap            string  `json:"feed_gap,omitempty"` // stale_close_only | thin_contract | unknown_feed_gap
}

type CompactSourceHealth struct {
	Source       string         `json:"source"`
	Status       string         `json:"status"`
	AsOf         time.Time      `json:"as_of,omitzero"`
	Confidence   string         `json:"confidence,omitempty"`
	RefreshState string         `json:"refresh_state,omitempty"`
	NextAttempt  *time.Time     `json:"next_attempt,omitempty"`
	LastFailure  *SourceFailure `json:"last_failure,omitempty"`
	Notes        []string       `json:"notes,omitempty"`
}

type ContractParams struct {
	ConID        int     `json:"con_id,omitempty"`
	Symbol       string  `json:"symbol"`
	SecType      string  `json:"sec_type,omitempty"` // STK | OPT | FUT | IND (request-side; see asymmetry note)
	Market       string  `json:"market,omitempty"`   // us | de
	Exchange     string  `json:"exchange,omitempty"` // SMART, IBIS, ...
	PrimaryExch  string  `json:"primary_exchange,omitempty"`
	Currency     string  `json:"currency,omitempty"`
	LocalSymbol  string  `json:"local_symbol,omitempty"`
	TradingClass string  `json:"trading_class,omitempty"`
	Expiry       string  `json:"expiry,omitempty"` // YYYYMMDD
	Strike       float64 `json:"strike,omitempty"`
	Right        string  `json:"right,omitempty"` // C | P
	Multiplier   int     `json:"multiplier,omitempty"`
	// MinTick is the venue minimum price increment, enriched daemon-side from
	// broker contract details when known. Zero means unresolved: price
	// rounding falls back to a static grid (US 0.01 / EUR MiFID band).
	MinTick float64 `json:"min_tick,omitempty"`
}

type CorrectPeakParams struct {
	FromStatements bool    `json:"from_statements,omitempty"`
	PeakBase       float64 `json:"peak_base,omitempty"`
	Reason         string  `json:"reason"`
	Origin         string  `json:"origin,omitempty"`
}

type CurrencyExposure struct {
	Currency             string  `json:"currency"`
	NetLiquidationCcy    float64 `json:"net_liquidation_ccy"`
	CashCcy              float64 `json:"cash_ccy"`
	StockMarketValueCcy  float64 `json:"stock_market_value_ccy"`
	OptionMarketValueCcy float64 `json:"option_market_value_ccy"`
	UnrealizedPnLCcy     float64 `json:"unrealized_pnl_ccy"`
	RealizedPnLCcy       float64 `json:"realized_pnl_ccy"`
	ExchangeRate         float64 `json:"exchange_rate"`
	NetLiquidationBase   float64 `json:"net_liquidation_base"`
}

type DailyPnLObservation struct {
	Status     DailyPnLObservationStatus `json:"status"`
	SessionKey string                    `json:"session_key,omitempty"`
	AsOf       time.Time                 `json:"as_of"`
}

type DailyPnLObservationStatus string

type DataFarmHealth struct {
	Name    string    `json:"name"`
	Type    string    `json:"type,omitempty"`
	Status  string    `json:"status"`
	Code    int       `json:"code,omitempty"`
	Message string    `json:"message,omitempty"`
	AsOf    time.Time `json:"as_of,omitzero"`
}

type DataQualityHealth struct {
	Surface          string    `json:"surface"`
	Status           string    `json:"status"`
	CadenceState     string    `json:"cadence_state,omitempty"`
	Summary          string    `json:"summary,omitempty"`
	StaleClusters    []string  `json:"stale_clusters,omitempty"`
	PartialClusters  []string  `json:"partial_clusters,omitempty"`
	DegradedClusters []string  `json:"degraded_clusters,omitempty"`
	AsOf             time.Time `json:"as_of,omitzero"`
}

type DataWarning struct {
	Code     string `json:"code"`
	Scope    string `json:"scope,omitempty"`
	Severity string `json:"severity,omitempty"`
	Message  string `json:"message"`
	Impact   string `json:"impact,omitempty"`
	Action   string `json:"action,omitempty"`
}

type EarningsEvidenceReference struct {
	Authority string `json:"authority"`
	Document  string `json:"document"`
	URL       string `json:"url"`
}

type EarningsIdentityInfo struct {
	Outcome              string         `json:"outcome"`
	NotApplicable        bool           `json:"not_applicable,omitempty"`
	AttemptedAt          time.Time      `json:"attempted_at,omitzero"`
	ProofObservedAt      time.Time      `json:"proof_observed_at,omitzero"`
	ProofOutcome         string         `json:"proof_outcome,omitempty"`
	AuthorityRevision    int64          `json:"authority_revision,omitempty"`
	AuthorityFingerprint string         `json:"authority_fingerprint,omitempty"`
	ObservationID        string         `json:"observation_id,omitempty"`
	AuthorityBinding     string         `json:"authority_binding,omitempty"`
	NextAttempt          *time.Time     `json:"next_attempt,omitempty"`
	LastFailure          *SourceFailure `json:"last_failure,omitempty"`
}

type EarningsInfo struct {
	Symbol string `json:"symbol"`
	// Date is the next earnings date in ET (YYYY-MM-DD), empty when unknown.
	Date string `json:"date,omitempty"`
	// TimeOfDay is "amc", "bmo", or "" when unspecified.
	TimeOfDay string `json:"time_of_day,omitempty"`
	// Estimated marks provider-flagged estimated (unconfirmed) dates.
	Estimated bool `json:"estimated,omitempty"`
	// Source is fetched | override | broker_identity | security_type |
	// verified_terminal | unknown. Provider-level provenance lives in Providers;
	// Terminal carries the exact-contract evidence when no future issuer earnings
	// event applies.
	Source string `json:"source"`
	// SecurityType names the held security type when Source is security_type —
	// the canonical spelling of a type that has no issuer earnings at all. It is
	// the whole authority behind that classification, so consumers re-derive the
	// exemption from this field rather than trusting Source alone.
	SecurityType string `json:"security_type,omitempty"`
	// Status is date or a typed unresolved outcome. Conflicting provider
	// dates never populate Date.
	Status string `json:"status,omitempty"`
	// Reason is a stable aggregate explanation such as single_source or
	// conflicting_sources; it never contains provider free text.
	Reason string `json:"reason,omitempty"`
	// ObservedAt is when the fetched value was last confirmed from the
	// provider; zero for overrides and unknowns.
	ObservedAt time.Time              `json:"observed_at,omitzero"`
	Stale      bool                   `json:"stale,omitempty"`
	Providers  []EarningsProviderInfo `json:"providers,omitempty"`
	Identity   *EarningsIdentityInfo  `json:"identity,omitempty"`
	Terminal   *EarningsTerminalInfo  `json:"terminal,omitempty"`
}

type EarningsProviderInfo struct {
	Provider     string         `json:"provider"`
	Status       string         `json:"status"`
	Date         string         `json:"date,omitempty"`
	TimeOfDay    string         `json:"time_of_day,omitempty"`
	Estimated    bool           `json:"estimated,omitempty"`
	ObservedAt   time.Time      `json:"observed_at,omitzero"`
	AttemptedAt  time.Time      `json:"attempted_at,omitzero"`
	NextAttempt  *time.Time     `json:"next_attempt,omitempty"`
	LastGoodDate string         `json:"last_good_date,omitempty"`
	LastFailure  *SourceFailure `json:"last_failure,omitempty"`
}

type EarningsTerminalInfo struct {
	ContractConID        int                         `json:"contract_con_id"`
	Issuer               string                      `json:"issuer"`
	CIK                  string                      `json:"cik,omitempty"`
	Classification       string                      `json:"classification"`
	EffectiveDate        string                      `json:"effective_date"`
	VerifiedAt           time.Time                   `json:"verified_at"`
	RevalidateAfter      time.Time                   `json:"revalidate_after"`
	AuthorityRevision    int64                       `json:"authority_revision"`
	AuthorityReviewedAt  time.Time                   `json:"authority_reviewed_at"`
	AuthorityFingerprint string                      `json:"authority_fingerprint"`
	AuthorityBinding     string                      `json:"authority_binding,omitempty"`
	Evidence             []EarningsEvidenceReference `json:"evidence"`
}

type EquityDayEntry struct {
	Day           string    `json:"day"`
	AccountID     string    `json:"account_id"`
	EquityBase    float64   `json:"equity_base"`
	SourceStmt    string    `json:"source_stmt"`
	WhenGenerated time.Time `json:"when_generated,omitzero"`
}

type Error struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

type EstablishedAlertProjection struct {
	SchemaVersion        string              `json:"schema_version"`
	CanonicalFingerprint Fingerprint         `json:"canonical_fingerprint"`
	OccurrenceEligible   bool                `json:"occurrence_eligible"`
	ActOnlyEligible      bool                `json:"act_only_eligible"`
	Action               string              `json:"action"`
	MarketConfirmation   string              `json:"market_confirmation"`
	Severity             risk.SignalSeverity `json:"severity"`
	PortfolioRelevant    bool                `json:"portfolio_relevant"`
}

type Fingerprint struct {
	Version string `json:"version"`
	Key     string `json:"key"`
}

type Frame struct {
	T        time.Time   `json:"t"`
	Bid      *float64    `json:"bid,omitempty"`
	Ask      *float64    `json:"ask,omitempty"`
	Last     *float64    `json:"last,omitempty"`
	BidSize  *int        `json:"bid_size,omitempty"`
	AskSize  *int        `json:"ask_size,omitempty"`
	DataType string      `json:"data_type,omitempty"`
	Error    *FrameError `json:"error,omitempty"`
}

type FrameError struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

type GammaCollectionDiagnostic struct {
	Underlying               string `json:"underlying"`
	TradingClass             string `json:"trading_class,omitempty"`
	Expiry                   string `json:"expiry,omitempty"` // YYYY-MM-DD
	QualifiedContracts       int    `json:"qualified_contracts"`
	RequestedLegs            int    `json:"requested_legs"`
	PricedLegs               int    `json:"priced_legs"`
	ModelTickLegs            int    `json:"model_tick_legs,omitempty"`
	DerivedLiveMidLegs       int    `json:"derived_live_mid_legs,omitempty"`
	DerivedPrevCloseLegs     int    `json:"derived_prev_close_legs,omitempty"`
	MarketDataGenericTicks   string `json:"market_data_generic_ticks,omitempty"`
	OIGenericTickRequested   bool   `json:"oi_generic_tick_101_requested,omitempty"`
	OILiveObservedLegs       int    `json:"oi_live_observed_legs,omitempty"`
	OICarriedForwardLegs     int    `json:"oi_carried_forward_legs,omitempty"`
	OIPositiveLegs           int    `json:"oi_positive_legs,omitempty"`
	OIMissingLegs            int    `json:"oi_missing_legs,omitempty"`
	ContractMissingLegs      int    `json:"contract_missing_legs,omitempty"`
	Timeouts                 int    `json:"timeouts,omitempty"`
	PacingErrors             int    `json:"pacing_errors,omitempty"`
	FarmErrors               int    `json:"farm_errors,omitempty"`
	EntitlementErrors        int    `json:"entitlement_errors,omitempty"`
	SubscriptionRejects      int    `json:"subscription_rejects,omitempty"`
	StrikeCandidates         int    `json:"strike_candidates,omitempty"`
	StrikeSelected           int    `json:"strike_selected,omitempty"`
	StrikeCap                int    `json:"strike_cap,omitempty"`
	StrikeCapTruncated       bool   `json:"strike_cap_truncated,omitempty"`
	ExpiryCapTruncated       bool   `json:"expiry_cap_truncated,omitempty"`
	CollectionDurationMS     int64  `json:"collection_duration_ms,omitempty"`
	OISourceStatus           string `json:"oi_source_status,omitempty"` // live_observed | carried_forward | mixed | missing
	CarriedForwardSource     string `json:"carried_forward_source,omitempty"`
	CarriedForwardObservedAt string `json:"carried_forward_observed_at,omitempty"`
}

type GammaIndexSummary struct {
	Underlying      string   `json:"underlying,omitempty"`
	SpotUnderlying  float64  `json:"spot_underlying,omitempty"`
	DataType        string   `json:"data_type,omitempty"`
	ZeroGamma       *float64 `json:"zero_gamma,omitempty"`
	ZeroGammaStatus string   `json:"zero_gamma_status,omitempty"`
	Regime          string   `json:"regime,omitempty"`
	SweepLowAbs     float64  `json:"sweep_low_abs,omitempty"`
	SweepHighAbs    float64  `json:"sweep_high_abs,omitempty"`
	LegCount        int      `json:"leg_count,omitempty"`
	PricedLegCount  int      `json:"priced_leg_count,omitempty"`
	GammaTotalAbs   float64  `json:"gamma_total_abs,omitempty"`
	Confidence      string   `json:"confidence,omitempty"`
	Interpretation  string   `json:"interpretation,omitempty"`
}

type GammaLegDiagnosticCounts struct {
	PricedLegs               int `json:"priced_legs"`
	ModelTickLegs            int `json:"model_tick_legs,omitempty"`
	DerivedLiveMidLegs       int `json:"derived_live_mid_legs,omitempty"`
	DerivedPrevCloseLegs     int `json:"derived_prev_close_legs,omitempty"`
	OpenInterestObservedLegs int `json:"oi_observed_legs,omitempty"`
	OILiveObservedLegs       int `json:"oi_live_observed_legs,omitempty"`
	OICarriedForwardLegs     int `json:"oi_carried_forward_legs,omitempty"`
	OpenInterestLegs         int `json:"oi_positive_legs"`
	GammaPositiveLegs        int `json:"gamma_positive_legs"`
	AbsGEXLegs               int `json:"abs_gex_positive_legs"`
}

type GammaLegDiagnostics struct {
	Total          GammaLegDiagnosticCounts            `json:"total"`
	ByUnderlying   map[string]GammaLegDiagnosticCounts `json:"by_underlying,omitempty"`
	ByTradingClass map[string]GammaLegDiagnosticCounts `json:"by_trading_class,omitempty"`
}

type GammaProfilePoint struct {
	Spot float64 `json:"spot"`
	GEX  float64 `json:"gex"`
}

type GammaQualityCoverage struct {
	PricedLegs           int     `json:"priced_legs"`
	RequestedLegs        int     `json:"requested_legs,omitempty"`
	FanoutCompletePct    float64 `json:"fanout_complete_pct,omitempty"`
	ModelTickLegs        int     `json:"model_tick_legs,omitempty"`
	DerivedLiveMidLegs   int     `json:"derived_live_mid_legs,omitempty"`
	DerivedPrevCloseLegs int     `json:"derived_prev_close_legs,omitempty"`
	OIObservedLegs       int     `json:"oi_observed_legs"`
	OILiveObservedLegs   int     `json:"oi_live_observed_legs,omitempty"`
	OICarriedForwardLegs int     `json:"oi_carried_forward_legs,omitempty"`
	OIPositiveLegs       int     `json:"oi_positive_legs"`
	GEXLegs              int     `json:"gex_legs"`
	OIObservedPct        float64 `json:"oi_observed_pct,omitempty"`
	OILiveObservedPct    float64 `json:"oi_live_observed_pct,omitempty"`
	OICarriedForwardPct  float64 `json:"oi_carried_forward_pct,omitempty"`
	OIPositivePct        float64 `json:"oi_positive_pct,omitempty"`
	DerivedIVPct         float64 `json:"derived_iv_pct,omitempty"`
	TopConcentrationPct  float64 `json:"top_concentration_pct,omitempty"`
	ExpirationCount      int     `json:"expiration_count,omitempty"`
	Has0DTE              bool    `json:"has_0dte"`
	Has1To7DTE           bool    `json:"has_1to7_dte"`
	HasTerm              bool    `json:"has_term"`
	SkewFitExpiries      int     `json:"skew_fit_expiries,omitempty"`
	MedianSkewRSquared   float64 `json:"median_skew_r_squared,omitempty"`
	MinSkewRSquared      float64 `json:"min_skew_r_squared,omitempty"`
}

type GammaQualityGate struct {
	Name   string `json:"name"`
	Status string `json:"status"`
	Reason string `json:"reason,omitempty"`
}

type GammaSignalQuality struct {
	Rankability       string                        `json:"rankability"`
	RankabilityReason string                        `json:"rankability_reason,omitempty"`
	Freshness         string                        `json:"freshness,omitempty"`
	Session           string                        `json:"session,omitempty"`
	SessionKey        string                        `json:"session_key,omitempty"`
	CurrentSessionKey string                        `json:"current_session_key,omitempty"`
	AsOf              time.Time                     `json:"as_of,omitzero"`
	AgeSeconds        int64                         `json:"age_seconds,omitempty"`
	MaxAgeSeconds     int64                         `json:"max_age_seconds,omitempty"`
	Coverage          GammaQualityCoverage          `json:"coverage"`
	Gates             []GammaQualityGate            `json:"gates,omitempty"`
	Blockers          []string                      `json:"blockers,omitempty"`
	Context           []string                      `json:"context,omitempty"`
	ByUnderlying      map[string]GammaSignalQuality `json:"by_underlying,omitempty"`
}

type GammaWarningDetail struct {
	// Code is the stable warning token, without lossy prose parsing.
	// Examples: "throttled", "0dte_no_legs",
	// "spx_unavailable:354", "oi_missing".
	Code string `json:"code"`
	// Scope names the affected slice: "SPY", "SPX", "SPY+SPX", or a
	// narrower trading class / expiry when the condition is that local.
	Scope string `json:"scope,omitempty"`
	// Severity is one of "info", "data_quality", or "methodology".
	// Renderers can show data_quality prominently and tuck info under
	// an expanded view.
	Severity string `json:"severity,omitempty"`
	// Message is a short user-facing explanation of the condition.
	Message string `json:"message"`
	// Impact explains how to read the gamma result in light of the
	// warning. Empty when the message is self-contained.
	Impact string `json:"impact,omitempty"`
	// Action is an optional non-advisory operational next step, such as
	// retrying during RTH or suppressing a known SPX entitlement banner.
	Action string `json:"action,omitempty"`
}

type GammaZeroComputed struct {
	// SpotUnderlying is the price of the underlying instrument
	// (currently SPY — see Source) at which the aggregation was
	// anchored. Field was renamed from SpotSPX when the compute moved
	// from SPX to the more liquid SPY chain (SPY has continuous
	// extended-hours quoting and a single trading class, which keeps
	// the compute robust off-hours).
	SpotUnderlying float64 `json:"spot_underlying,omitempty"`
	// SpotAt is the gateway-observation timestamp for SpotUnderlying.
	// Distinct from AsOf which covers the whole computation.
	SpotAt time.Time `json:"spot_at,omitzero"`
	// DataType is the gateway feed state shared by the underlying spot and
	// option-model inputs. Delayed results are accepted only when the option
	// fan-out used IBKR's delayed model-computation tick 83 throughout.
	DataType string `json:"data_type,omitempty"`

	// ZeroGamma is the dealer γ-zero level under the Perfiliev convention
	// (the spot where dealer net gamma crosses zero). nil when no
	// crossing exists within the sweep window — inspect GammaSign in
	// that case to learn whether the whole sweep is long-γ or short-γ.
	ZeroGamma *float64 `json:"zero_gamma,omitempty"`
	// GapPct is (SpotUnderlying − ZeroGamma) / ZeroGamma × 100. nil iff
	// ZeroGamma is nil. Sign convention: positive = spot above γ-zero
	// (dampening regime); negative = below γ-zero (amplifying regime).
	GapPct *float64 `json:"gap_pct,omitempty"`
	// GammaSign is "positive" or "negative" and is meaningful only when
	// ZeroGamma is nil — it tells the renderer which side of zero the
	// whole sweep landed on so the UI can say "all long-gamma" or "all
	// short-gamma in window."
	GammaSign string `json:"gamma_sign,omitempty"`
	// Profile is the full (spot, gex) sweep, oldest first. 60 points
	// over [0.85, 1.15] × SpotUnderlying. Renderers chart this as the
	// gamma-exposure curve and visually confirm the zero crossing.
	Profile []GammaProfilePoint `json:"profile,omitempty"`

	// GammaTotalAbs is the sign-agnostic magnitude signal at
	// SpotUnderlying: Σ |Γ| × OI × 100 × SpotUnderlying² × 0.01. In
	// dollar gamma terms — the total notional dealer hedging flow for
	// a 1% underlying move, independent of any positioning assumption.
	// Larger = market is more sensitive to dealer rebalancing.
	GammaTotalAbs float64 `json:"gamma_total_abs"`
	// GammaTotalAbsConvention names the sign-handling for GammaTotalAbs
	// so downstream renderers can label it without re-deriving
	// methodology. Today's value is "sign-agnostic" — every leg's
	// magnitude |Γ|·OI·100·spot²·0.01 is summed unconditionally. This
	// is the convention-free read the M2 methodology refresh promotes
	// to co-primary alongside the signed γ-zero level.
	GammaTotalAbsConvention string `json:"gamma_total_abs_convention,omitempty"`
	// TopStrikes is the top-N strikes ranked by absolute gamma notional.
	// Concentration here is more reliable than the signed ZeroGamma in
	// regimes where the dealer-sign assumption may invert.
	TopStrikes []StrikeConcentration `json:"top_strikes"`
	// TopConcentrationPct is TopStrikes[0].AbsGEX / GammaTotalAbs × 100 —
	// what share of the sign-agnostic |Γ|·OI sum is parked at the single
	// largest strike. Renderers surface it as a one-line "this strike
	// dominates" cue alongside the table. Zero when TopStrikes is empty
	// or GammaTotalAbs is zero.
	TopConcentrationPct float64 `json:"top_concentration_pct,omitempty"`

	// SweepLowAbs / SweepHighAbs are the absolute spot bounds of the
	// sweep window in dollars: SpotUnderlying × (1 ± Params.SweepRangePct).
	// Surfaced for renderers that want to print "γ-zero outside swept
	// range $A.AA-$C.CC" without re-deriving the multiplication.
	SweepLowAbs  float64 `json:"sweep_low_abs,omitempty"`
	SweepHighAbs float64 `json:"sweep_high_abs,omitempty"`

	// Expirations is the YYYY-MM-DD list of expirations actually
	// included in the aggregation (after 0DTE-post-settlement filtering
	// and SPXW/SPX merging).
	Expirations []string `json:"expirations"`
	// LegCount is the number of option legs that contributed non-zero
	// open-interest-weighted gamma exposure to the profile. It excludes
	// priced legs whose IV landed but whose OI was missing/zero. Missing
	// OI is unknown, not zero, so those legs are omitted from dealer GEX
	// rather than zero-substituted.
	LegCount int `json:"leg_count"`
	// PricedLegCount is the number of option legs that delivered IV (or
	// a BS-IV fallback) and were usable for skew fitting. It can exceed
	// LegCount when IBKR supplied prices/IV but not open interest.
	PricedLegCount int `json:"priced_leg_count,omitempty"`
	// DerivedIVLegs counts how many priced legs used the BS-IV
	// Newton-Raphson fallback because the gateway never pushed a
	// model-computation tick. Pre-market this is often equal to
	// PricedLegCount (the model engine is idle); during regular hours it
	// should stay at 0. Renderers surface a "compute used N derived
	// IVs" disclosure so readers can tell those IVs came from option
	// quote/close inversion rather than live model ticks.
	DerivedIVLegs int `json:"derived_iv_legs,omitempty"`
	// ModelTickLegs counts priced legs whose IV came from IBKR's
	// option model-computation tick. DerivedLiveMidLegs and
	// DerivedPrevCloseLegs split the BS-IV fallback by price anchor:
	// live bid/ask midpoint versus prior-session option close. The
	// split is optional and additive; legacy consumers can continue to
	// read DerivedIVLegs as the total fallback count.
	ModelTickLegs        int `json:"model_tick_legs,omitempty"`
	DerivedLiveMidLegs   int `json:"derived_live_mid_legs,omitempty"`
	DerivedPrevCloseLegs int `json:"derived_prev_close_legs,omitempty"`
	// LegDiagnostics explains how priced legs flowed through the
	// GEX-contribution funnel. It is especially useful when a forced
	// off-hours run prices legs but every row has missing/zero OI.
	LegDiagnostics *GammaLegDiagnostics `json:"leg_diagnostics,omitempty"`
	// CollectionDiagnostics exposes the source-level request funnel per
	// underlying/tradingClass/expiry: contracts qualified, market-data legs
	// requested, priced legs, live-vs-carried OI, timeouts, rejects, and cap
	// truncation. This is the production diagnostic surface for deciding
	// whether gamma is source-limited or merely gate-blocked.
	CollectionDiagnostics []GammaCollectionDiagnostic `json:"collection_diagnostics,omitempty"`
	// Quality is the explicit rankability contract for gamma as an
	// algo-trading signal. Result can be present while Quality says
	// "context_only" or "blocked"; regime/Stress consumers must not
	// count the gamma band unless this says "rankable".
	Quality *GammaSignalQuality `json:"quality,omitempty"`
	// Warnings is the daemon-internal list of non-fatal condition codes:
	// "no_crossing_in_window", "spxw_partial_oi", "throttled",
	// "all_iv_derived". Empty when the computation was clean. It is not
	// serialized; wire consumers read WarningDetails instead.
	// Runs whose leg coverage falls below the MinLegCoverageFraction
	// persist threshold are surfaced as Status="error" with no
	// Result, not as a warning — see gamma_zero_compute's coverage
	// gate (mirror of breadth's MinCoverageFraction=0.80 pattern).
	Warnings []string `json:"-"`
	// WarningDetails is the serialized warning surface: scoped,
	// user-facing explanations plus optional impact/action text.
	WarningDetails []GammaWarningDetail `json:"warning_details,omitempty"`
	// Summary is a compact interpretation of the result. It is designed
	// for CLI/MCP consumers that need to answer "what did the model
	// identify?" before drilling into profile arrays.
	Summary *GammaZeroSummary `json:"summary,omitempty"`

	// ZeroGamma0DTE / Profile0DTE / GammaSign0DTE / LegCount0DTE are the
	// same headline triple computed over legs with DTE == 0 only —
	// same-day expiries before their settlement cutoff. Captures the
	// short-fuse flow that Cboe's 2025 data shows is ~59% of SPX
	// volume, isolated from the longer-dated weeklies and monthlies.
	// Nil when no 0DTE legs fell in the bucket (e.g. mid-week after
	// Monday's daily settled, before the next daily lists) OR when
	// the sweep over those legs had no crossing inside the ±10% band.
	// GammaSign0DTE="no_data" plus a "0dte_no_legs" warning communicate
	// the empty-bucket case.
	ZeroGamma0DTE *float64            `json:"zero_gamma_0dte,omitempty"`
	Profile0DTE   []GammaProfilePoint `json:"profile_0dte,omitempty"`
	GammaSign0DTE string              `json:"gamma_sign_0dte,omitempty"`
	LegCount0DTE  int                 `json:"leg_count_0dte,omitempty"`

	// ZeroGamma1to7 / Profile1to7 / GammaSign1to7 / LegCount1to7 are the
	// matching triple for legs with 0 < DTE ≤ 7 days — overnight
	// through one calendar week. Captures end-of-week dynamics
	// (weeklies, EOW Friday flow) without commingling with the 0DTE
	// term that swamps the bucket on a third Friday.
	ZeroGamma1to7 *float64            `json:"zero_gamma_1to7,omitempty"`
	Profile1to7   []GammaProfilePoint `json:"profile_1to7,omitempty"`
	GammaSign1to7 string              `json:"gamma_sign_1to7,omitempty"`
	LegCount1to7  int                 `json:"leg_count_1to7,omitempty"`

	// ZeroGammaTerm / ProfileTerm / GammaSignTerm / LegCountTerm are the
	// matching triple for legs with DTE > 7 days — monthly OPEX and
	// quarterly horizons. Slower-moving than the two near buckets;
	// dominated by collar/structured-product positioning rather than
	// dealer-flow speed.
	ZeroGammaTerm *float64            `json:"zero_gamma_term,omitempty"`
	ProfileTerm   []GammaProfilePoint `json:"profile_term,omitempty"`
	GammaSignTerm string              `json:"gamma_sign_term,omitempty"`
	LegCountTerm  int                 `json:"leg_count_term,omitempty"`

	// MethodologyCitations is the short bibliography backing the
	// methodology disclosure. Each entry is a single line of the form
	// "Author (Year) — short claim". Surfaced on the result envelope so
	// renderers can show the citations alongside the headline numbers
	// without the user having to consult out-of-band documentation.
	MethodologyCitations []string `json:"methodology_citations,omitempty"`

	// SkewModel names the IV model used during the sweep. v2 cutover:
	// "sticky-moneyness-v1" means a quadratic skew curve in
	// log-moneyness was fitted per expiry and σ was looked up at each
	// (scenario spot, strike) pair. Empty when the curve fell back to
	// sticky-IV everywhere (degenerate fits across every expiry); a
	// per-expiry fallback shows up in warning_details.
	SkewModel string `json:"skew_model,omitempty"`
	// SkewFitQuality is one SkewFitInfo per expiry that fitted a curve
	// successfully. Keyed by compact YYYYMMDD. Renderers can show fit
	// quality alongside the headline so the reader can audit how
	// confident the underlying skew curve is.
	SkewFitQuality map[string]SkewFitInfo `json:"skew_fit_quality,omitempty"`

	// Params echoes the v1 calibration window so a renderer can show
	// "computed over 6 expirations inside ATM ± 10%" without consulting
	// out-of-band documentation. The daemon caps the live fan-out to
	// the nearest 80 listed strikes per expiry; warning_details includes
	// strike_budget_capped when the candidate window exceeded that cap.
	Params GammaZeroParams `json:"params"`
	// Source identifies the data provenance for the headline numbers.
	Source string `json:"source"`
	// AuthorityProvenance is empty for a current-code compute. A non-empty
	// value identifies an explicit persistence recovery path and is consumed
	// by the gamma quality gate; recovered evidence remains displayable but
	// cannot become a rankable trading signal merely because its timestamp is
	// inside the current session.
	AuthorityProvenance string `json:"authority_provenance,omitempty"`
	// Method is a short stable token for the computation path. v3:
	// "bs-gamma-profile-v3-stickymoneyness-0dte-split". The v3 bump
	// signals two semantic changes from v2:
	//   - horizon split is now 0DTE / 1-7 / >7 (was ≤7 / >7), because
	//     Cboe 2025 data shows 0DTE = ~59% of SPX volume and lumping
	//     it with weeklies muddies the signal.
	//   - the per-leg snapshot gamma is BS-recomputed from captured IV
	//     rather than read from the gateway's optional Greeks tick;
	//     fixes a v2 race where IV-but-no-Greeks legs contributed 0 to
	//     GammaTotalAbs.
	// "perfiliev" is dropped from the token because Perfiliev's
	// published method used sticky-IV; the sticky-moneyness refinement
	// is citable to Derman / Daglish-Hull-Suo (see MethodologyCitations).
	// Full disclosure lives in docs/docs/internals/regime-dashboard.md so
	// renderers can deep-link.
	Method string `json:"method"`
	// AsOf is the daemon's wall-clock when the compute finished.
	AsOf time.Time `json:"as_of"`
	// DurationMS is honest about how long the compute took on the wall
	// clock; useful for tuning ExpiryCount / StrikeWidthPct.
	DurationMS int64 `json:"duration_ms"`

	// Scope is the discriminator for combined-vs-single-underlying
	// payloads:
	//   "spy"     — SPY-only; PerIndex is nil
	//   "spx"     — SPX-only (--only=spx); PerIndex is nil
	//   "spy+spx" — combined; price-level fields stay under PerIndex
	//               because there is no meaningful combined price scale.
	// Empty is treated as Scope="spy" by legacy renderers only.
	Scope string `json:"scope,omitempty"`

	// PerIndex carries the per-underlying detail when Scope="spy+spx".
	// Nil for single-underlying scopes. Keys are uppercased symbols
	// ("SPY", "SPX"). Each entry is a self-contained GammaZeroComputed
	// with its own Scope ("spy" or "spx"), so a renderer can recurse on
	// the per-index slice and reuse the single-underlying formatting.
	//
	// Pointer values rather than struct values so the field can be
	// nil-checked rather than length-tested in renderers, and so the
	// recursive type doesn't bloat the SPY-only path's payload.
	PerIndex map[string]*GammaZeroComputed `json:"per_index,omitempty"`

	// PartialClasses surfaces per-trading-class entitlement gaps when
	// one class of an underlying lands but the other 354s. Keyed by
	// the unreachable trading class (e.g. {"SPX": "354"} when SPX-class
	// AM-monthlies return "not subscribed" but SPXW-class weeklies
	// land). Empty when both classes land cleanly OR when neither
	// lands (the latter surfaces as Status="error" upstream).
	PartialClasses map[string]string `json:"partial_classes,omitempty"`

	// RegimeAgreement classifies whether the SPY and SPX dealer-gamma
	// regimes agree, populated only on Scope="spy+spx" runs. One of:
	//
	//   "agree:long-gamma"  — both indices' sweeps stay positive (dealer
	//                         long-γ across the ±15% window, stabilizing).
	//   "agree:short-gamma" — both stay negative (short-γ, amplifying).
	//   "agree:transition-gamma" — both are within ±2% of their γ-zero
	//                         crossings. The per-index ZeroGamma levels
	//                         carry the precise prices.
	//   "disagree"          — one index is long-γ, the other short-γ
	//                         (or transition while the other isn't).
	//                         The actionable signal: institutional SPX
	//                         book and retail/ETF SPY book are positioned
	//                         opposite, which the regime-call use case
	//                         cares about more than any combined number.
	//   ""                  — at least one bucket has no data; can't
	//                         classify. Renderers fall back to per-index.
	//
	// Replaces the earlier DecoupledCorr field, which gated on 20-day
	// price correlation. Price correlation stays > 0.99 essentially
	// always; that gate never fired and missed the actual case worth
	// flagging — gamma regimes that decouple while prices stay tightly
	// correlated.
	RegimeAgreement string `json:"regime_agreement,omitempty"`
}

type GammaZeroParams struct {
	// ExpiryCount is the number of nearest non-0DTE-post-settlement
	// expirations included in the aggregation.
	ExpiryCount int `json:"expiry_count"`
	// StrikeWidthPct is the half-width of the strike grid around spot,
	// expressed as a fraction (0.10 = ATM ± 10 %).
	StrikeWidthPct float64 `json:"strike_width_pct"`
	// SweepRangePct is the half-range of the spot sweep used to find
	// the zero-crossing (0.15 = [0.85, 1.15] × spot).
	SweepRangePct float64 `json:"sweep_range_pct"`
	// WorkerCount is the per-leg fan-out concurrency. 4 matches the
	// documented safe gateway throttle; bumping it requires retuning
	// AcquireMarketDataSlot.
	WorkerCount int `json:"worker_count"`
}

type GammaZeroSPXParams struct {
	// WaitMs is the maximum time the daemon blocks on an in-flight or
	// just-kicked-off compute before returning the current state. 0
	// (the default) means "return immediately with whatever state we
	// have." A non-zero value is capped daemon-side to keep the RPC
	// under the per-method deadline.
	WaitMs int `json:"wait_ms,omitempty"`
	// Force, when true, starts a fresh diagnostic compute. If a good
	// cached result is already serving, the daemon keeps serving it and
	// promotes the forced compute only on success. Useful for diagnostics;
	// dashboards should leave this off and let the daily cache handle
	// freshness.
	Force bool `json:"force,omitempty"`
	// Scope selects which underlying(s) to compute. One of GammaZeroScopeSPY
	// ("spy"), GammaZeroScopeSPX ("spx"), or GammaZeroScopeCombined ("spy+spx").
	// Empty defaults to "spy+spx" with SPX-skipped fallback.
	Scope string `json:"scope,omitempty"`
	// IncludeProfiles asks clients/renderers to retain the full profile
	// arrays in JSON/MCP responses. The daemon compute always produces
	// profiles where meaningful; thin adapters may strip them by default
	// to keep agent/tool payloads compact.
	IncludeProfiles bool `json:"include_profiles,omitempty"`
}

type GammaZeroSPXResult struct {
	// Status is one of GammaZeroStatusComputing / Ready / Error.
	Status string `json:"status"`
	// Refreshing is true when a newer compute is in flight while this
	// envelope serves the last good result. Ready + StartedAt cannot express
	// that: StartedAt describes the compute that produced Result, so without
	// this field a consumer cannot tell a current-session compute in flight
	// from one that never started. Mirrors BreadthSPXResult.Refreshing.
	Refreshing bool `json:"refreshing,omitempty"`
	// StartedAt is when the currently-relevant compute kicked off — for
	// "computing", that's the in-flight job; for "ready", it's the
	// compute that produced Result. Nil if no compute has ever started.
	StartedAt *time.Time `json:"started_at,omitempty"`
	// EtaSeconds is an initial estimate of the total wall-clock the
	// compute will need from kickoff. Used by renderers to show a
	// progress meter or set a polling cadence. 0 when Status != computing.
	EtaSeconds int `json:"eta_seconds,omitempty"`
	// Progress is a 0-100 hint, best-effort. 0 when Status != computing.
	Progress int `json:"progress,omitempty"`
	// Result is populated when Status == "ready".
	Result *GammaZeroComputed `json:"result,omitempty"`
	// DiagnosticResult is populated when a compute failed after collecting
	// source-level evidence (for example priced option legs with no usable OI),
	// or when a preserved ready cache has a newer failed diagnostic refresh.
	// It must not be treated as a trading signal; it exists to expose the
	// option-chain/OI source blocker that prevented Result from updating.
	DiagnosticResult *GammaZeroComputed `json:"diagnostic_result,omitempty"`
	// Error is populated when Status == "error".
	Error string `json:"error,omitempty"`
	// ColdReasonCode / ColdReason / ColdAction are populated when the
	// daemon knows why no fresh result can be served, and say when the
	// next attempt is due. On Status == "cold" they distinguish a
	// first-run cache from a persisted snapshot that existed but was
	// rejected by schema, methodology, or data-quality gates. They are
	// also populated on Status == "error" when the failed attempt is
	// being retained across a closed options session, where no automatic
	// retry runs until the next regular session — Error still carries the
	// failure itself and is not softened.
	ColdReasonCode string `json:"cold_reason_code,omitempty"`
	ColdReason     string `json:"cold_reason,omitempty"`
	ColdAction     string `json:"cold_action,omitempty"`
	// RetryOfErrorAt + RetryOfErrorSummary are non-nil/non-empty only
	// when Status == "computing" AND the in-flight compute was kicked
	// because the previous attempt failed past gammaErrorRetryTTL. The
	// renderer surfaces them as "computing · retry of <summary> at
	// HH:MM:SS" so the user sees the prior failure context — without
	// this, the dashboard silently switched from "error" to "computing"
	// and the user had to grep the daemon log to understand why.
	RetryOfErrorAt      *time.Time `json:"retry_of_error_at,omitempty"`
	RetryOfErrorSummary string     `json:"retry_of_error_summary,omitempty"`
}

type GammaZeroSummary struct {
	PrimaryStatement string                       `json:"primary_statement,omitempty"`
	ZeroGammaStatus  string                       `json:"zero_gamma_status,omitempty"`
	Regime           string                       `json:"regime,omitempty"`
	Confidence       string                       `json:"confidence,omitempty"`
	NotAdvice        string                       `json:"not_advice,omitempty"`
	PerIndex         map[string]GammaIndexSummary `json:"per_index,omitempty"`
}

type GovernorAction struct {
	Action   string   `json:"action"`
	From     string   `json:"from,omitempty"`
	To       string   `json:"to,omitempty"`
	Reason   string   `json:"reason,omitempty"`
	Clusters []string `json:"clusters,omitempty"`
}

type HealthResult struct {
	DaemonVersion string    `json:"daemon_version"`
	DaemonStarted time.Time `json:"daemon_started"`
	UptimeSeconds int64     `json:"uptime_seconds"`
	Account       string    `json:"account,omitempty"`
	// ConnectedAccount is the one account the connected TWS/Gateway session is
	// scoped to, never a list. It is the code the session advertises via
	// managedAccounts / accountSummary when that is a single account, and the
	// configured [gateway].account pin when the login holds several and the
	// advertised value is the comma-joined inventory. It is empty when neither
	// is one concrete account — an unpinned multi-account login has no account
	// to name. It differs from Account when [gateway].account is empty and the
	// daemon auto-detected the account after handshake. The session's full
	// inventory is not served here.
	ConnectedAccount string `json:"connected_account,omitempty"`
	// AccountMode is the daemon's best classification of the connected
	// endpoint/account: "paper", "live", or "unknown".
	AccountMode   string `json:"account_mode,omitempty"`
	GatewayHost   string `json:"gateway_host"`
	GatewayPort   int    `json:"gateway_port"`
	GatewayTLS    bool   `json:"gateway_tls"`
	NegotiatedTLS bool   `json:"negotiated_tls"`
	PortOrigin    string `json:"port_origin"`
	TLSOrigin     string `json:"tls_origin"`
	Alternates    []int  `json:"alternates,omitempty"`
	ClientID      int    `json:"client_id"`
	Connected     bool   `json:"connected"`
	// GatewayPhase classifies which connectivity boundary currently blocks
	// service. A backend_link_down phase can coexist with Connected=true: the
	// local API session is ready while TWS reports its IBKR backend link lost.
	GatewayPhase   string    `json:"gateway_phase"`
	GatewayPhaseAt time.Time `json:"gateway_phase_at,omitzero"`
	DataType       string    `json:"data_type,omitempty"`
	ServerVersion  int       `json:"server_version,omitempty"`
	LastError      string    `json:"last_error,omitempty"`
	// BackgroundTasks lists daemon-internal long-running computes that
	// are running or waiting for a scheduled retry. Empty when nothing
	// is active. Always present on the wire (never omitted) so
	// consumers can rely on `len(result.background_tasks) == 0` to
	// mean "idle" without inferring from absence.
	BackgroundTasks []BackgroundTaskStatus `json:"background_tasks"`
	Subsystems      []SubsystemHealth      `json:"subsystems,omitempty"`
	DataQuality     []DataQualityHealth    `json:"data_quality,omitempty"`
	DataFarms       []DataFarmHealth       `json:"data_farms,omitempty"`
	// MarketDataAccess lists route keys the gateway is currently refusing
	// market data for. Empty is the normal case and the only claim absence
	// makes is that nothing was refused inside the window — not that every
	// name is entitled.
	MarketDataAccess []MarketDataAccessHealth `json:"market_data_access,omitempty"`
	// Members carries the runtime SPX-membership state: source
	// (cache vs embedded), count, as-of timestamp, refresh health.
	// Populated unconditionally — even when the daemon falls back
	// to the embedded list, the user needs to see WHICH list it's
	// using so silent parser rot / disabled-refresh shows up in
	// `canary status`. Zero-value Source means the daemon doesn't
	// know yet (engine construction failed); the CLI hides the row
	// in that case.
	Members MembersHealth `json:"members"`
	Trading TradingStatus `json:"trading"`
}

type HeldStress struct {
	Underlying            string            `json:"underlying"`
	MaterialReasons       []string          `json:"material_reasons,omitempty"`
	MarketValuePctNLV     *float64          `json:"market_value_pct_nlv,omitempty"`
	DeltaPctNLV           *float64          `json:"delta_pct_nlv,omitempty"`
	DailyPnLPctNLV        *float64          `json:"daily_pnl_pct_nlv,omitempty"`
	NearExpiryDeltaPctNLV *float64          `json:"near_expiry_delta_pct_nlv,omitempty"`
	NearExpiryGamma       *float64          `json:"near_expiry_gamma,omitempty"`
	NearExpiryMinDTE      *int              `json:"near_expiry_min_dte,omitempty"`
	LiquidityFlags        []string          `json:"liquidity_flags,omitempty"`
	MarketFlags           []MarketEventFlag `json:"market_flags,omitempty"`
	SignalIDs             []risk.SignalID   `json:"signal_ids,omitempty"`
}

type HistoryBar struct {
	Date   string  `json:"date"` // YYYY-MM-DD
	Open   float64 `json:"open"`
	High   float64 `json:"high"`
	Low    float64 `json:"low"`
	Close  float64 `json:"close"`
	Volume int64   `json:"volume"`
}

type HistoryDailyParams struct {
	Symbol     string `json:"symbol"`
	Days       int    `json:"days,omitempty"` // default 90 when zero
	WhatToShow string `json:"what_to_show,omitempty"`
}

type HistoryDailyResult struct {
	Symbol     string       `json:"symbol"`
	Days       int          `json:"days"`
	WhatToShow string       `json:"what_to_show,omitempty"`
	DataType   string       `json:"data_type,omitempty"`
	Bars       []HistoryBar `json:"bars"`
	AsOf       time.Time    `json:"as_of"`
}

type HistoryIndexHealth struct {
	// LastIngestAt is a retired legacy-ingest field and is zero for direct
	// daemon.db history reads.
	LastIngestAt time.Time `json:"last_ingest_at,omitzero"`
	// IngestedBytes is a retired legacy journal watermark.
	IngestedBytes int64 `json:"ingested_bytes"`
	// JournalBytes is a retired legacy journal-size field.
	JournalBytes int64 `json:"journal_bytes"`
}

type HistoryRotationSettings struct {
	Enabled SettingsBool `json:"enabled"`
	// KeepRawMonths is retained for wire compatibility and has no live
	// journal-retention effect.
	KeepRawMonths SettingsInt `json:"keep_raw_months"`
}

type LifecycleEvidence struct {
	Source    string `json:"source,omitempty"`
	Signal    string `json:"signal,omitempty"`
	Bucket    string `json:"bucket,omitempty"`
	Timing    string `json:"timing,omitempty"`
	Severity  string `json:"severity,omitempty"`
	Confirmed bool   `json:"confirmed,omitempty"`
}

type LifecycleState struct {
	Stage       string              `json:"stage,omitempty"`
	Scope       string              `json:"scope,omitempty"`
	Severity    string              `json:"severity,omitempty"`
	Readiness   string              `json:"readiness,omitempty"`
	Timing      string              `json:"timing,omitempty"`
	Confidence  string              `json:"confidence,omitempty"`
	Evidence    []LifecycleEvidence `json:"evidence,omitempty"`
	ConfirmedBy []string            `json:"confirmed_by,omitempty"`
	Unconfirmed []string            `json:"unconfirmed,omitempty"`
	Suppressed  []string            `json:"suppressed,omitempty"`
	RejectedBy  []string            `json:"rejected_by,omitempty"`
	// Governors discloses every policy downgrade applied after stage
	// selection (provenance gate, evidence-keyed quality cap). Nothing is
	// silently weakened: when severity reads lower than the stage suggests,
	// this is where the reason lives.
	Governors    []GovernorAction `json:"governors,omitempty"`
	Fingerprint  Fingerprint      `json:"fingerprint,omitzero"`
	NotExecution string           `json:"not_execution,omitempty"`
}

type MarketCalendarParams struct {
	Market string    `json:"market,omitempty"`
	Date   string    `json:"date,omitempty"`
	At     time.Time `json:"at,omitzero"`
	Days   int       `json:"days,omitempty"`
}

type MarketCalendarResult struct {
	Market        string          `json:"market"`
	Label         string          `json:"label"`
	Timezone      string          `json:"timezone"`
	AsOf          time.Time       `json:"as_of"`
	CoverageStart string          `json:"coverage_start"`
	CoverageEnd   string          `json:"coverage_end"`
	Source        string          `json:"source"`
	SourceURL     string          `json:"source_url"`
	Session       MarketSession   `json:"session"`
	Sessions      []MarketSession `json:"sessions,omitempty"`
}

type MarketDataAccessHealth struct {
	// RouteKey is the connector's own subscription key — a bare symbol, or
	// the pipe-joined contract route for an explicitly routed request.
	RouteKey string `json:"route_key"`
	// Symbol is RouteKey's leading symbol component, for display.
	Symbol     string    `json:"symbol,omitempty"`
	Code       int       `json:"code"`
	Reason     string    `json:"reason"`
	ObservedAt time.Time `json:"observed_at,omitzero"`
	// RetryAt is when the suppression window lifts and the next request for
	// this key reaches the gateway again.
	RetryAt time.Time `json:"retry_at,omitzero"`
}

type MarketEventBorrowFeeCoverage struct {
	Symbol              string         `json:"symbol"`
	ContractConID       int            `json:"contract_con_id,omitempty"`
	ContractFingerprint string         `json:"contract_fingerprint,omitempty"`
	CoverageScope       string         `json:"coverage_scope"`
	Status              string         `json:"status"`
	Reason              string         `json:"reason,omitempty"`
	Source              string         `json:"source"`
	DataType            string         `json:"data_type"`
	AsOf                time.Time      `json:"as_of,omitzero"`
	ObservedAt          time.Time      `json:"observed_at,omitzero"`
	FeeRate             *float64       `json:"fee_rate,omitempty"`
	Entitlement         string         `json:"entitlement"`
	ScaleStatus         string         `json:"scale_status"`
	PolicyEligible      bool           `json:"policy_eligible"`
	LastFailure         *SourceFailure `json:"last_failure,omitempty"`
}

type MarketEventFlag struct {
	ID             string        `json:"id"`
	Symbol         string        `json:"symbol"`
	Label          string        `json:"label"`
	Status         string        `json:"status"`
	Severity       string        `json:"severity"`
	Role           string        `json:"role"`
	Source         string        `json:"source"`
	SourceURL      string        `json:"source_url,omitempty"`
	AsOf           time.Time     `json:"as_of,omitzero"`
	ObservedAt     time.Time     `json:"observed_at,omitzero"`
	ExpiresAt      time.Time     `json:"expires_at,omitzero"`
	Value          *float64      `json:"value,omitempty"`
	Unit           string        `json:"unit,omitempty"`
	Details        []string      `json:"details,omitempty"`
	WarningDetails []DataWarning `json:"warning_details,omitempty"`
}

type MarketEventsParams struct {
	Symbol  string   `json:"symbol,omitempty"`
	Symbols []string `json:"symbols,omitempty"`
}

type MarketEventsResult struct {
	Kind          string                       `json:"kind"`
	SchemaVersion string                       `json:"schema_version"`
	AsOf          time.Time                    `json:"as_of"`
	Symbols       []string                     `json:"symbols,omitempty"`
	Flags         []MarketEventFlag            `json:"flags,omitempty"`
	BySymbol      map[string][]MarketEventFlag `json:"by_symbol,omitempty"`
	SourceHealth  []SourceHealth               `json:"source_health,omitempty"`
	// BorrowFeeCoverage makes source scope and exact-contract completeness
	// explicit. In particular, portfolio-only historical FEE_RATE rows remain
	// policy-ineligible until their broker numeric scale is commissioned.
	BorrowFeeCoverage []MarketEventBorrowFeeCoverage `json:"borrow_fee_coverage,omitempty"`
	Fingerprint       Fingerprint                    `json:"fingerprint,omitzero"`
	WarningDetails    []DataWarning                  `json:"warning_details,omitempty"`
	NotExecution      string                         `json:"not_execution,omitempty"`
}

type MarketSession struct {
	Market        string     `json:"market"`
	Label         string     `json:"label,omitempty"`
	Date          string     `json:"date"`
	Timezone      string     `json:"timezone"`
	State         string     `json:"state"`
	IsOpen        bool       `json:"is_open"`
	Reason        string     `json:"reason,omitempty"`
	Open          time.Time  `json:"open,omitzero"`
	Close         time.Time  `json:"close,omitzero"`
	NextOpen      *time.Time `json:"next_open,omitempty"`
	NextClose     *time.Time `json:"next_close,omitempty"`
	Source        string     `json:"source,omitempty"`
	SourceURL     string     `json:"source_url,omitempty"`
	CoverageStart string     `json:"coverage_start,omitempty"`
	CoverageEnd   string     `json:"coverage_end,omitempty"`
	Notes         string     `json:"notes,omitempty"`
}

type MembersHealth struct {
	Source       string    `json:"source"`
	AsOf         time.Time `json:"as_of"`
	Count        int       `json:"count"`
	RefreshState string    `json:"refresh_state"`
}

type MethodLifetime uint8

type MethodTiming struct {
	Method        string
	Lifetime      MethodLifetime
	DaemonTimeout time.Duration
}

type NudgeCandidate struct {
	Fingerprint string    `json:"fingerprint"`
	Kind        string    `json:"kind"`
	State       string    `json:"state"`
	Severity    string    `json:"severity"`
	Title       string    `json:"title"`
	Body        string    `json:"body"`
	OccurredAt  time.Time `json:"occurred_at,omitzero"`
	DueAt       time.Time `json:"due_at,omitzero"`
	ExpiresAt   time.Time `json:"expires_at,omitzero"`
	Destination string    `json:"destination"`
}

type NudgeConfirmedFlowCoverage struct {
	CoverageFrom              time.Time `json:"coverage_from"`
	PreCutoverFlowsUnreviewed bool      `json:"pre_cutover_flows_unreviewed"`
}

type NudgeCutoverReviewEvidence string

type NudgeCutoverReviewOrigin string

type NudgeDrawdownSummary struct {
	Tier        string   `json:"tier"`
	ConsumedPct *float64 `json:"consumed_pct"`
}

type NudgeInputHealth struct {
	Status string    `json:"status"` // ok | unapproved | stale | unavailable | error
	Reason string    `json:"reason,omitempty"`
	AsOf   time.Time `json:"as_of,omitzero"`
}

type NudgeShadowSummary struct {
	Count int `json:"count"`
}

type NudgeSnapshotContext struct {
	Shadow   *NudgeShadowSummary   `json:"shadow,omitempty"`
	Drawdown *NudgeDrawdownSummary `json:"drawdown,omitempty"`
}

type NudgeSourceHealth struct {
	Aggregate      string           `json:"aggregate"` // ready | suppressed | degraded
	Policy         NudgeInputHealth `json:"policy"`
	Reconciliation NudgeInputHealth `json:"reconciliation"`
	Capital        NudgeInputHealth `json:"capital"`
	Pins           NudgeInputHealth `json:"pins"`
	Cadence        NudgeInputHealth `json:"cadence"`
	ConfirmedFlow  NudgeInputHealth `json:"confirmed_flow"`
}

type NudgesCutoverReviewParams struct {
	Origin   NudgeCutoverReviewOrigin   `json:"origin"`
	Evidence NudgeCutoverReviewEvidence `json:"evidence"`
}

type NudgesCutoverReviewResult struct {
	OK              bool                       `json:"ok"`
	AlreadyReviewed bool                       `json:"already_reviewed"`
	ReviewedAt      time.Time                  `json:"reviewed_at"`
	CoverageFrom    time.Time                  `json:"coverage_from"`
	Evidence        NudgeCutoverReviewEvidence `json:"evidence"`
}

type NudgesSnapshotParams struct{}

type NudgesSnapshotResult struct {
	AsOf                  time.Time                   `json:"as_of"`
	Candidates            []NudgeCandidate            `json:"candidates"`
	SourceHealth          NudgeSourceHealth           `json:"source_health"`
	Reconciliation        *ReconAutomationStatus      `json:"reconciliation,omitempty"`
	ConfirmedFlowCoverage *NudgeConfirmedFlowCoverage `json:"confirmed_flow_coverage,omitempty"`
	Context               *NudgeSnapshotContext       `json:"context,omitempty"`
}

type Opportunity struct {
	Key                      string                        `json:"key"`
	Revision                 string                        `json:"revision"`
	State                    string                        `json:"state"`
	Bucket                   string                        `json:"bucket"`
	Rank                     int                           `json:"rank"`
	Symbol                   string                        `json:"symbol"`
	SecType                  string                        `json:"sec_type"`
	Action                   string                        `json:"action"`
	ExerciseAction           int                           `json:"exercise_action"`
	Quantity                 int                           `json:"quantity"`
	MaxQuantity              int                           `json:"max_quantity"`
	PositionQuantity         float64                       `json:"position_quantity"`
	PositionEffect           string                        `json:"position_effect"`
	UnderlyingQuantityBefore float64                       `json:"underlying_quantity_before"`
	UnderlyingQuantityAfter  float64                       `json:"underlying_quantity_after"`
	UnderlyingShareChange    float64                       `json:"underlying_share_change"`
	PostExerciseRisk         *OpportunityPostExerciseRisk  `json:"post_exercise_risk,omitempty"`
	Contract                 ContractParams                `json:"contract"`
	UnderlyingContract       ContractParams                `json:"underlying_contract"`
	ExpectedGain             float64                       `json:"expected_gain,omitempty"`
	ExpectedGainCurrency     string                        `json:"expected_gain_currency,omitempty"`
	IntrinsicValue           float64                       `json:"intrinsic_value,omitempty"`
	CloseValue               float64                       `json:"close_value,omitempty"`
	OptionBid                *float64                      `json:"option_bid,omitempty"`
	UnderlyingBid            *float64                      `json:"underlying_bid,omitempty"`
	UnderlyingAsk            *float64                      `json:"underlying_ask,omitempty"`
	Reason                   string                        `json:"reason"`
	Details                  []string                      `json:"details,omitempty"`
	Score                    float64                       `json:"score,omitempty"`
	PolicyID                 string                        `json:"policy_id,omitempty"`
	PolicyVersion            int                           `json:"policy_version,omitempty"`
	PolicyFingerprint        Fingerprint                   `json:"policy_fingerprint,omitzero"`
	SourceFingerprints       OpportunitySourceFingerprints `json:"source_fingerprints,omitzero"`
	Blockers                 []TradingBlocker              `json:"blockers,omitempty"`
	CreatedAt                time.Time                     `json:"created_at,omitzero"`
}

type OpportunityCounts struct {
	Total                int     `json:"total"`
	Actionable           int     `json:"actionable"`
	Blocked              int     `json:"blocked"`
	OptionExercise       int     `json:"option_exercise"`
	ExpectedGain         float64 `json:"expected_gain,omitempty"`
	ExpectedGainCurrency string  `json:"expected_gain_currency,omitempty"`
}

type OpportunityExercisePreviewParams struct {
	Key       string `json:"key"`
	Revision  string `json:"revision"`
	Quantity  int    `json:"quantity,omitempty"`
	TimeoutMs int    `json:"timeout_ms,omitempty"`
	Origin    string `json:"origin,omitempty"`
}

type OpportunityExercisePreviewResult struct {
	Accepted              bool             `json:"accepted"`
	Opportunity           Opportunity      `json:"opportunity"`
	PreviewTokenID        string           `json:"preview_token_id,omitempty"`
	TokenMinted           bool             `json:"token_minted"`
	PreviewTokenExpiresAt time.Time        `json:"preview_token_expires_at,omitzero"`
	SubmitEligible        bool             `json:"submit_eligible"`
	Blockers              []TradingBlocker `json:"blockers,omitempty"`
	AsOf                  time.Time        `json:"as_of"`
}

type OpportunityExerciseSubmitParams struct {
	Key       string `json:"key"`
	Revision  string `json:"revision"`
	Quantity  int    `json:"quantity,omitempty"`
	TimeoutMs int    `json:"timeout_ms,omitempty"`
	Origin    string `json:"origin,omitempty"`
}

type OpportunityExerciseSubmitResult struct {
	Accepted       bool                              `json:"accepted"`
	Opportunity    Opportunity                       `json:"opportunity"`
	Preview        *OpportunityExercisePreviewResult `json:"preview,omitempty"`
	PreviewTokenID string                            `json:"preview_token_id,omitempty"`
	OrderRef       string                            `json:"order_ref,omitempty"`
	Blockers       []TradingBlocker                  `json:"blockers,omitempty"`
	Message        string                            `json:"message,omitempty"`
	AsOf           time.Time                         `json:"as_of"`
}

type OpportunityIgnoreParams struct {
	Key      string `json:"key"`
	Revision string `json:"revision,omitempty"`
	Reason   string `json:"reason,omitempty"`
}

type OpportunityIgnoreResult struct {
	Accepted bool      `json:"accepted"`
	Key      string    `json:"key"`
	Revision string    `json:"revision,omitempty"`
	Message  string    `json:"message,omitempty"`
	AsOf     time.Time `json:"as_of"`
}

type OpportunityPolicyStatus struct {
	Kind          string           `json:"kind,omitempty"`
	Status        string           `json:"status"`
	PolicyID      string           `json:"policy_id,omitempty"`
	PolicyVersion int              `json:"policy_version,omitempty"`
	Profile       string           `json:"profile,omitempty"`
	Fingerprint   Fingerprint      `json:"fingerprint,omitzero"`
	Source        string           `json:"source,omitempty"`
	Path          string           `json:"path,omitempty"`
	LoadedAt      time.Time        `json:"loaded_at,omitzero"`
	LastCheckedAt time.Time        `json:"last_checked_at,omitzero"`
	Message       string           `json:"message,omitempty"`
	Blockers      []TradingBlocker `json:"blockers,omitempty"`
}

type OpportunityPostExerciseRisk struct {
	Underlying                      string   `json:"underlying,omitempty"`
	BeforeQuantity                  float64  `json:"before_quantity"`
	AfterQuantity                   float64  `json:"after_quantity"`
	ShareChange                     float64  `json:"share_change"`
	PositionEffect                  string   `json:"position_effect,omitempty"`
	RiskChange                      string   `json:"risk_change,omitempty"`
	RiskOpened                      bool     `json:"risk_opened,omitempty"`
	RiskIncreased                   bool     `json:"risk_increased,omitempty"`
	RiskFlipped                     bool     `json:"risk_flipped,omitempty"`
	ProtectionReviewNeeded          bool     `json:"protection_review_needed"`
	ProtectionReviewReason          string   `json:"protection_review_reason,omitempty"`
	ProtectionCoverageState         string   `json:"protection_coverage_state,omitempty"`
	CurrentProtectedQuantity        float64  `json:"current_protected_quantity,omitempty"`
	CurrentUnprotectedQuantity      float64  `json:"current_unprotected_quantity,omitempty"`
	CurrentUnprotectedNotionalBase  *float64 `json:"current_unprotected_notional_base,omitempty"`
	UnprotectedNotionalBaseCurrency string   `json:"unprotected_notional_base_currency,omitempty"`
	WarningCodes                    []string `json:"warning_codes,omitempty"`
}

type OpportunityRefreshParams struct {
	Show bool `json:"show,omitempty"`
}

type OpportunitySnapshot struct {
	Kind               string                        `json:"kind"`
	SchemaVersion      string                        `json:"schema_version"`
	AsOf               time.Time                     `json:"as_of"`
	Revision           string                        `json:"revision"`
	AccountID          string                        `json:"account_id,omitempty"`
	AccountMode        string                        `json:"account_mode,omitempty"`
	PolicyID           string                        `json:"policy_id,omitempty"`
	PolicyVersion      int                           `json:"policy_version,omitempty"`
	PolicyFingerprint  Fingerprint                   `json:"policy_fingerprint,omitzero"`
	PolicyStatus       OpportunityPolicyStatus       `json:"policy_status"`
	Status             OpportunityStatus             `json:"status"`
	Trading            TradingStatus                 `json:"trading"`
	SourceFingerprints OpportunitySourceFingerprints `json:"source_fingerprints,omitzero"`
	Opportunities      []Opportunity                 `json:"opportunities"`
	Counts             OpportunityCounts             `json:"counts"`
	Blockers           []TradingBlocker              `json:"blockers,omitempty"`
	LoadedFromState    bool                          `json:"loaded_from_state,omitempty"`
}

type OpportunitySnapshotParams struct {
	Show bool `json:"show,omitempty"`
}

type OpportunitySourceFingerprints struct {
	Account   *Fingerprint `json:"account,omitempty"`
	Positions *Fingerprint `json:"positions,omitempty"`
}

type OpportunityStatus struct {
	Kind           string                  `json:"kind,omitempty"`
	AsOf           time.Time               `json:"as_of,omitzero"`
	Enabled        bool                    `json:"enabled"`
	HotReload      bool                    `json:"hot_reload"`
	ReloadInterval string                  `json:"reload_interval,omitempty"`
	RefreshCadence string                  `json:"refresh_cadence,omitempty"`
	Policy         OpportunityPolicyStatus `json:"policy"`
	Trading        TradingStatus           `json:"trading"`
	Blocked        bool                    `json:"blocked"`
	Blockers       []TradingBlocker        `json:"blockers,omitempty"`
}

type OptionHealthSummary struct {
	GreeksCoverage                  int     `json:"greeks_coverage"`
	GreeksTotal                     int     `json:"greeks_total"`
	MissingGreeksCount              int     `json:"missing_greeks_count"`
	LowDTECount                     int     `json:"low_dte_count"`
	LowDTEThresholdDays             int     `json:"low_dte_threshold_days"`
	OptionsClosedCount              int     `json:"options_closed_count"`
	MarkOutsideBidAskCount          int     `json:"mark_outside_bid_ask_count"`
	LargeStaleDailyLossCount        int     `json:"large_stale_daily_loss_count"`
	LargeStaleDailyLossThresholdPct float64 `json:"large_stale_daily_loss_threshold_pct_nlv"`
	FlaggedLegCount                 int     `json:"flagged_leg_count"`
	FlaggedLegsReturned             int     `json:"flagged_legs_returned"`
}