Module state_parsing 

Stream-message state parsers: rate-limit / api-retry / runtime-session / settings-parse-error. Mirrors upstream’s agent-sdk/src/bridge/state_parsing.ts.

Re-exports

use serde_json::Map; 🔒

use serde_json::Value; 🔒

use forge_primitives::ApiRetryError; 🔒

use forge_primitives::RateLimitStatus; 🔒

use forge_primitives::RuntimeSessionState; 🔒

use forge_primitives::SettingsParseErrorUpdate; 🔒

Functions

build_api_retry_update

Mirrors upstream’s buildApiRetryUpdate(message). Returns a typed ApiRetryUpdate when all three required numeric fields parse correctly.

build_rate_limit_update

Mirrors upstream’s buildRateLimitUpdate(rateLimitInfo). Returns a typed RateLimitUpdate when the input has a recognised status, populating optional fields when present.

normalize_settings_parse_error 🔒

Mirrors normalizeSettingsParseError(value).

normalize_settings_parse_errors

Accepts either a single record or an array; returns all valid entries.

number_field 🔒

parse_api_retry_error 🔒

parse_clamped_u64 🔒

Reads a numeric field as u64, returning None when the field is missing or its value is outside [0, u64::MAX) (note the open upper bound - see the body comment). Out-of-range drops emit a debug breadcrumb so a misbehaving CLI is observable.

parse_clamped_u16_optional 🔒

Optional sibling of parse_clamped_u64 for u16-sized fields (status codes). Field-absent is silent (None); out-of-range value logs at debug and returns None.

parse_enum 🔒

Deserialize a wire-string enum variant from an optional JSON value. Returns None for missing field, wrong JSON type, or unrecognised variant - the three failure modes share a single drop path. Each enum carries #[serde(rename_all = "snake_case")] so this is just the typed wrapper.

parse_rate_limit_status 🔒

parse_runtime_session_state

record 🔒