API: add capabilities and configuration schema discovery

This commit is contained in:
Alexey
2026-11-01 14:09:40 +03:00
parent 84e5b827a6
commit 108e14f628
11 changed files with 1985 additions and 0 deletions
+206
View File
@@ -0,0 +1,206 @@
//! Read-only discovery of implemented operations and configuration contracts.
//!
//! Field defaults come from unconfigured types, never the active or disk config.
//! Availability samples only existing control-plane publications without waiting.
use std::sync::OnceLock;
use serde::{Deserialize, Serialize};
use crate::config::ProxyConfig;
use crate::web::control::WebRuntimeLifecycle;
use super::ApiShared;
use super::model::ApiFailure;
#[cfg(test)]
mod http_tests;
mod schema;
#[cfg(test)]
mod tests;
pub(super) use schema::config_schema;
pub(super) const SCHEMA_VERSION: u32 = 1;
#[derive(Debug, Deserialize, Serialize)]
#[serde(deny_unknown_fields)]
pub(super) struct Operation {
pub(super) id: String,
pub(super) method: String,
pub(super) path: String,
#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub(super) aliases: Vec<String>,
pub(super) gate: Gate,
pub(super) success: Vec<u16>,
#[serde(default)]
pub(super) credential_bearing: bool,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub(super) body: Option<String>,
#[serde(default)]
pub(super) optional_body: bool,
#[serde(default)]
pub(super) exact_json_content_type: bool,
#[serde(default)]
pub(super) if_match: bool,
}
#[derive(Debug, Clone, Copy, Deserialize, Serialize)]
#[serde(rename_all = "snake_case")]
pub(super) enum Gate {
Always,
Minimal,
MinimalMe,
MiddleProxy,
Upstream,
Edge,
WebRead,
WebControl,
}
pub(super) fn operations() -> Result<&'static [Operation], ApiFailure> {
static CATALOG: OnceLock<Result<Vec<Operation>, String>> = OnceLock::new();
CATALOG
.get_or_init(|| {
serde_json::from_str(include_str!("discovery/operations.json"))
.map_err(|error| format!("invalid compiled operation catalog: {error}"))
})
.as_deref()
.map_err(|error| ApiFailure::internal(error.clone()))
}
#[derive(Serialize)]
pub(super) struct CapabilitiesData {
api_version: &'static str,
schema_version: u32,
software_version: &'static str,
config_schema: &'static str,
openapi_artifact: &'static str,
read_only: bool,
availability_scope: &'static str,
operations: Vec<OperationCapability>,
}
#[derive(Serialize)]
struct OperationCapability {
#[serde(flatten)]
operation: &'static Operation,
supported: bool,
enabled: bool,
/// Null means an optional runtime source was not sampled or its lock was busy.
available: Option<bool>,
mutable: bool,
#[serde(skip_serializing_if = "Option::is_none")]
disabled_reason: Option<&'static str>,
#[serde(skip_serializing_if = "Option::is_none")]
unavailable_reason: Option<&'static str>,
#[serde(skip_serializing_if = "Option::is_none")]
mutation_blocked_reason: Option<&'static str>,
}
#[derive(Clone, Copy)]
pub(super) struct Availability {
pub(super) me_pool: Option<bool>,
pub(super) web_read: bool,
pub(super) web_control: bool,
}
pub(super) fn capabilities(
shared: &ApiShared,
config: &ProxyConfig,
) -> Result<CapabilitiesData, ApiFailure> {
let me_pool = shared.me_pool.try_read().ok().map(|pool| pool.is_some());
let availability = {
let publication = shared.web_runtime_rx.borrow();
let web_alive = publication.runtime.upgrade().is_some();
Availability {
me_pool,
web_read: web_alive
&& matches!(
publication.lifecycle,
WebRuntimeLifecycle::Running | WebRuntimeLifecycle::Draining
),
web_control: web_alive && publication.lifecycle == WebRuntimeLifecycle::Running,
}
};
build_capabilities(config, availability)
}
fn build_capabilities(
config: &ProxyConfig,
availability: Availability,
) -> Result<CapabilitiesData, ApiFailure> {
let mut entries = Vec::with_capacity(operations()?.len());
for operation in operations()? {
let feature_enabled = match operation.gate {
Gate::Minimal | Gate::MinimalMe => config.server.api.minimal_runtime_enabled,
Gate::Edge => config.server.api.runtime_edge_enabled,
_ => true,
};
let enabled = config.server.api.enabled && feature_enabled;
let (available, unavailable_reason) = if !enabled {
(Some(false), None)
} else {
match operation.gate {
Gate::MinimalMe | Gate::MiddleProxy => match availability.me_pool {
Some(true) => (Some(true), None),
Some(false) => (Some(false), Some("source_unavailable")),
None => (None, Some("snapshot_busy")),
},
Gate::WebRead if !availability.web_read => {
(Some(false), Some("web_runtime_unavailable"))
}
Gate::WebControl if !availability.web_control => {
(Some(false), Some("web_runtime_unavailable"))
}
// These handlers perform their own bounded aggregation. Discovery
// does not repeat it or claim a sampled health/lock result.
Gate::Minimal | Gate::Upstream => (None, Some("availability_not_sampled")),
Gate::Edge if operation.id == "runtime_connections_summary" => {
(None, Some("availability_not_sampled"))
}
_ => (Some(true), None),
}
};
let mutation = operation.method != "GET";
entries.push(OperationCapability {
operation,
supported: true,
enabled,
available,
mutable: mutation && config.server.api.enabled && !config.server.api.read_only,
disabled_reason: if !config.server.api.enabled {
Some("api_disabled")
} else if !feature_enabled {
Some("feature_disabled")
} else {
None
},
unavailable_reason,
mutation_blocked_reason: if mutation && config.server.api.read_only {
Some("read_only")
} else {
None
},
});
}
Ok(CapabilitiesData {
api_version: "v1",
schema_version: SCHEMA_VERSION,
software_version: env!("CARGO_PKG_VERSION"),
config_schema: "/v1/config/schema",
openapi_artifact: "docs/Architecture/API/openapi-v1.json",
read_only: config.server.api.read_only,
availability_scope: "feature_and_runtime_source_prerequisites_not_request_success",
operations: entries,
})
}
pub(super) fn reject_query(query: Option<&str>) -> Result<(), ApiFailure> {
if query.is_some_and(|query| !query.is_empty()) {
return Err(ApiFailure::bad_request(
"discovery endpoints do not accept query parameters",
));
}
Ok(())
}
+476
View File
@@ -0,0 +1,476 @@
[
{"path":"access","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"User authentication secrets and admission policy.","apply":{"watcher":"mixed","reload":"mixed","effect":"see_child_fields"}},
{"path":"access.cidr_rate_limits","value":{"type":"object","additionalProperties":{"type":"object"}},"default_kind":"type_default","sensitivity":"public","description":"Per-CIDR aggregate transport rate limits in bits-per-second. Explicit CIDR keys use longest-prefix-wins semantics. Auto-template keys (`*4/N`, `*6/N`, `*/N`) lazily create per-source-subnet buckets after explicit CIDR matching misses. A value of `0` in one direction means \"unlimited\" for that direction. Limits are amortized with the same bounded-burst contract as per-user rate limits.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.cidr_rate_limits.{cidr}","value":{"type":"object"},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for access.cidr_rate_limits.{cidr}.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.cidr_rate_limits.{cidr}.down_bps","value":{"type":"integer","minimum":0,"maximum":100000000000},"default_kind":"map_entry","sensitivity":"public","description":"Download limit in bits-per-second within `0..=100_000_000_000`; `0` means unlimited.","unit":"bits_per_second","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"},"constraints":["At least one direction must be nonzero; zero means unlimited for that direction."]},
{"path":"access.cidr_rate_limits.{cidr}.up_bps","value":{"type":"integer","minimum":0,"maximum":100000000000},"default_kind":"map_entry","sensitivity":"public","description":"Upload limit in bits-per-second within `0..=100_000_000_000`; `0` means unlimited.","unit":"bits_per_second","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"},"constraints":["At least one direction must be nonzero; zero means unlimited for that direction."]},
{"path":"access.ignore_time_skew","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for access.ignore_time_skew.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"access.replay_check_len","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for access.replay_check_len.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"access.replay_window_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for access.replay_window_secs.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"access.user_ad_tags","value":{"type":"object","additionalProperties":{"type":"string"}},"default_kind":"type_default","sensitivity":"public","description":"Per-user ad_tag (32 hex chars from @MTProxybot).","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_ad_tags.{username}","value":{"type":"string"},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for access.user_ad_tags.{username}.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_data_quota","value":{"type":"object","additionalProperties":{"type":"integer","minimum":0,"maximum":18446744073709551615}},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for access.user_data_quota.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_data_quota.{username}","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for access.user_data_quota.{username}.","unit":"bytes","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_enabled","value":{"type":"object","additionalProperties":{"type":"boolean"}},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for access.user_enabled.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_enabled.{username}","value":{"type":"boolean"},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for access.user_enabled.{username}.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_expirations","value":{"type":"object","additionalProperties":{"type":"string","format":"date-time"}},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for access.user_expirations.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_expirations.{username}","value":{"type":"string","format":"date-time"},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for access.user_expirations.{username}.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_max_tcp_conns","value":{"type":"object","additionalProperties":{"type":"integer","minimum":0,"maximum":18446744073709551615}},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for access.user_max_tcp_conns.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_max_tcp_conns.{username}","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for access.user_max_tcp_conns.{username}.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_max_tcp_conns_global_each","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Global per-user TCP connection limit applied when a user has no positive individual override. `0` disables the inherited limit.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_max_unique_ips","value":{"type":"object","additionalProperties":{"type":"integer","minimum":0,"maximum":18446744073709551615}},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for access.user_max_unique_ips.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_max_unique_ips.{username}","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for access.user_max_unique_ips.{username}.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_max_unique_ips_global_each","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Global per-user unique IP limit applied when a user has no individual override. `0` disables the inherited limit.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_max_unique_ips_mode","value":{"type":"string","enum":["active_window","time_window","combined"]},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for access.user_max_unique_ips_mode.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_max_unique_ips_window_secs","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for access.user_max_unique_ips_window_secs.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_quota_periods","value":{"type":"object","additionalProperties":{"type":"string","enum":["daily","weekly","monthly"]}},"default_kind":"type_default","sensitivity":"public","description":"Optional UTC calendar for users with a positive data quota.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"},"constraints":["An existing user with a positive data quota is required; calendars use UTC."]},
{"path":"access.user_quota_periods.{username}","value":{"type":"string","enum":["daily","weekly","monthly"]},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for access.user_quota_periods.{username}.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"},"constraints":["An existing user with a positive data quota is required; calendars use UTC."]},
{"path":"access.user_rate_limits","value":{"type":"object","additionalProperties":{"type":"object"}},"default_kind":"type_default","sensitivity":"public","description":"Per-user transport rate limits in bits-per-second. Each entry supports independent upload (`up_bps`) and download (`down_bps`) ceilings. A value of `0` in one direction means \"unlimited\" for that direction. Limits are amortized: a relay quantum may pass as a bounded burst, and the limiter applies the resulting wait before later traffic in the same direction proceeds.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_rate_limits.{username}","value":{"type":"object"},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for access.user_rate_limits.{username}.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.user_rate_limits.{username}.down_bps","value":{"type":"integer","minimum":0,"maximum":100000000000},"default_kind":"map_entry","sensitivity":"public","description":"Download limit in bits-per-second within `0..=100_000_000_000`; `0` means unlimited.","unit":"bits_per_second","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"},"constraints":["At least one direction must be nonzero; zero means unlimited for that direction."]},
{"path":"access.user_rate_limits.{username}.up_bps","value":{"type":"integer","minimum":0,"maximum":100000000000},"default_kind":"map_entry","sensitivity":"public","description":"Upload limit in bits-per-second within `0..=100_000_000_000`; `0` means unlimited.","unit":"bits_per_second","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"},"constraints":["At least one direction must be nonzero; zero means unlimited for that direction."]},
{"path":"access.user_source_deny","value":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","format":"cidr"}}},"default_kind":"type_default","sensitivity":"public","description":"Per-username client source IP/CIDR deny list. Checked after successful authentication; matching IPs get the same rejection path as invalid auth (handshake fails closed for that connection).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"constraints":["Current strict-key validation does not recognize access.user_source_deny; no watcher overlay."]},
{"path":"access.user_source_deny.{username}","value":{"type":"array","items":{"type":"string","format":"cidr"}},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for access.user_source_deny.{username}.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"constraints":["Current strict-key validation does not recognize access.user_source_deny; no watcher overlay."]},
{"path":"access.users","value":{"type":"object","additionalProperties":{"type":"string"}},"default_kind":"redacted","sensitivity":"credential","description":"Configuration value for access.users.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"access.users.{username}","value":{"type":"string","minLength":32,"maxLength":32,"pattern":"^[0-9A-Fa-f]{32}$"},"default_kind":"redacted","sensitivity":"credential","description":"Configuration value for access.users.{username}.","apply":{"watcher":"supported","reload":"supported","effect":"admission_or_accounting_policy_consumption_no_implicit_quota_reset"}},
{"path":"censorship","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Anti-censorship behavior and traffic shaping configuration.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.alpn_enforce","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enforce ALPN echo of client preference.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.exclusive_mask","value":{"type":"object","additionalProperties":{"type":"string"}},"default_kind":"type_default","sensitivity":"public","description":"Per-SNI TCP mask targets. Keys are SNI domains, values are `host:port`.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.exclusive_mask.{hostname}","value":{"type":"string"},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for censorship.exclusive_mask.{hostname}.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.fake_cert_len","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for censorship.fake_cert_len.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"unit":"bytes"},
{"path":"censorship.mask","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for censorship.mask.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_classifier_prefetch_timeout_ms","value":{"type":"integer","minimum":5,"maximum":50},"default_kind":"type_default","sensitivity":"public","description":"Prefetch timeout (ms) for extending fragmented masking classifier window.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_dynamic","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Use the ClientHello SNI as the mask TCP target for configured TLS domains.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_host","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Configuration value for censorship.mask_host.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_port","value":{"type":"integer","minimum":0,"maximum":65535},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for censorship.mask_port.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_proxy_protocol","value":{"type":"integer","minimum":0,"maximum":255},"default_kind":"type_default","sensitivity":"public","description":"Send PROXY protocol header when connecting to mask_host. 0 = disabled, 1 = v1 (text), 2 = v2 (binary). Allows the backend to see the real client IP.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_relay_idle_timeout_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Per-read idle timeout on masking relay and drain paths. Limits resource consumption by slow-loris attacks and port scanners. A read call stalling beyond this is treated as an abandoned connection. Default: 5 000 ms (5 s).","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_relay_max_bytes","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum bytes relayed per direction on unauthenticated masking fallback paths. Set to 0 to disable byte cap (unlimited within relay/idle timeouts).","unit":"bytes","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_relay_timeout_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Wall-clock cap for the full masking relay on non-MTProto fallback paths. Raise when the mask target is a long-lived service (e.g. WebSocket). Default: 60 000 ms (60 s).","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_shape_above_cap_blur","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Add bounded random tail bytes even when total bytes already exceed mask_shape_bucket_cap_bytes.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_shape_above_cap_blur_max_bytes","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum random bytes appended above cap when above-cap blur is enabled.","unit":"bytes","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_shape_bucket_cap_bytes","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum bucket size for mask shape hardening padding.","unit":"bytes","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_shape_bucket_floor_bytes","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Minimum bucket size for mask shape hardening padding.","unit":"bytes","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_shape_hardening","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable shape-channel hardening on mask backend path by padding client->mask stream tail to configured buckets on stream end.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_shape_hardening_aggressive_mode","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Opt-in aggressive shape hardening mode. When enabled, masking may shape some backend-silent timeout paths and enforces strictly positive above-cap blur when blur is enabled.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_timing_normalization_ceiling_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Upper bound (ms) for masking outcome timing envelope.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_timing_normalization_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable outcome-time normalization envelope for masking fallback.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_timing_normalization_floor_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Lower bound (ms) for masking outcome timing envelope.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.mask_unix_sock","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Configuration value for censorship.mask_unix_sock.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.server_hello_delay_max_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum server_hello delay in milliseconds.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.server_hello_delay_min_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Minimum server_hello delay in milliseconds (anti-fingerprint).","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.serverhello_compact","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable compact ServerHello payload mode. When false, FakeTLS always uses full ServerHello payload behavior. When true, compact certificate payload mode can be used by TTL policy.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_domain","value":{"type":"string"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for censorship.tls_domain.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_domains","value":{"type":"array","items":{"type":"string"}},"default_kind":"type_default","sensitivity":"public","description":"Additional TLS domains for generating multiple proxy links.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_emulation","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable TLS certificate emulation using cached real certificates.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_fetch","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Fetch strategy for TLS front metadata bootstrap and periodic refresh.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_fetch.attempt_timeout_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Timeout per one profile attempt in milliseconds.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_fetch.deterministic","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Produces deterministic ClientHello randomness for debugging/tests.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_fetch.grease_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Adds GREASE-style values into selected ClientHello extensions.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_fetch.profile_cache_ttl_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"TTL for winner-profile cache entries in seconds. Set to 0 to disable profile cache.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_fetch.profiles","value":{"type":"array","items":{"type":"string","enum":["modern_chrome_like","modern_firefox_like","compat_tls12","legacy_minimal"]}},"default_kind":"type_default","sensitivity":"public","description":"Ordered list of ClientHello profiles used for adaptive fallback.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_fetch.strict_route","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"When true and upstream route is configured, TLS fetch fails closed on upstream connect errors and does not fallback to direct TCP.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_fetch.total_budget_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Total wall-clock budget in milliseconds across all profile attempts.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_fetch_scope","value":{"type":"string"},"default_kind":"type_default","sensitivity":"public","description":"Upstream scope used for TLS front metadata fetches. Empty value keeps default upstream routing behavior.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_front_dir","value":{"type":"string"},"default_kind":"type_default","sensitivity":"public","description":"Directory to store TLS front cache (on disk).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_full_cert_ttl_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"TTL in seconds for sending full certificate payload per client IP. First client connection per (SNI domain, client IP) gets full cert payload. Subsequent handshakes within TTL use compact cert metadata payload. Applied only when `serverhello_compact` is enabled.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.tls_new_session_tickets","value":{"type":"integer","minimum":0,"maximum":255},"default_kind":"type_default","sensitivity":"public","description":"Number of NewSessionTicket messages to emit post-handshake.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"censorship.unknown_sni_action","value":{"type":"string","enum":["drop","mask","accept","reject_handshake"]},"default_kind":"type_default","sensitivity":"public","description":"Policy for TLS ClientHello with unknown (non-configured) SNI.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"dc_overrides","value":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"default_kind":"type_default","sensitivity":"public","description":"DC address overrides for non-standard DCs (CDN, media, test, etc.) Keys are DC indices as strings, values are one or more \"ip:port\" addresses. Matches the C implementation's `proxy_for <dc_id> <ip>:<port>` config directive. Example in config.toml: [dc_overrides] \"203\" = [\"149.154.175.100:443\", \"91.105.192.100:443\"]","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"dc_overrides.{dc}","value":{"type":"array","items":{"type":"string"}},"default_kind":"map_entry","sensitivity":"public","description":"Configuration value for dc_overrides.{dc}.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"default_dc","value":{"type":"integer","minimum":0,"maximum":255},"default_kind":"unset","sensitivity":"public","description":"Default DC index (1-5) for unmapped non-standard DCs. Matches the C implementation's `default <dc_id>` config directive. If not set, defaults to 2 (matching Telegram's official `default 2;` in proxy-multi.conf).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"General runtime options shared across proxy subsystems.","apply":{"watcher":"mixed","reload":"mixed","effect":"see_child_fields"}},
{"path":"general.ad_tag","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Global ad_tag (32 hex chars from @MTProxybot). Fallback when user has no per-user tag in access.user_ad_tags.","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.auto_degradation_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable auto-degradation from ME to Direct-DC.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.beobachten","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable per-IP forensic observation buckets for scanners and handshake failures.","aliases":["beobachten"],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.beobachten_file","value":{"type":"string"},"default_kind":"type_default","sensitivity":"deployment","description":"Snapshot file path for beob output.","aliases":["beobachten_file"],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.beobachten_flush_secs","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Snapshot flush interval in seconds for beob output file.","aliases":["beobachten_flush_secs"],"unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.beobachten_minutes","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Observation retention window in minutes for per-IP forensic buckets.","aliases":["beobachten_minutes"],"unit":"minutes","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.config_strict","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Reject unknown TOML config keys during load. Startup fails fast; hot-reload rejects the new snapshot and keeps the current config.","apply":{"watcher":"not_applicable","reload":"not_applicable","effect":"source_validation_on_next_load"}},
{"path":"general.crypto_pending_buffer","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Max pending ciphertext buffer per client writer (bytes). Controls FakeTLS backpressure vs throughput.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"unit":"bytes"},
{"path":"general.data_path","value":{"type":"string"},"default_kind":"unset","sensitivity":"deployment","description":"Configuration value for general.data_path.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"general.degradation_min_unavailable_dc_groups","value":{"type":"integer","minimum":0,"maximum":255},"default_kind":"type_default","sensitivity":"public","description":"Minimum unavailable ME DC groups before degrading.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.desync_all_full","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Emit full crypto-desync forensic logs for every event. When false, full forensic details are emitted once per key window.","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.direct_relay_buffer_budget_max_bytes","value":{"oneOf":[{"const":0},{"type":"integer","minimum":16777216,"maximum":2147483648,"multipleOf":4096}]},"default_kind":"type_default","sensitivity":"public","description":"Process-wide hard ceiling for Direct relay copy buffers. `0` derives the ceiling from host and cgroup memory limits.","unit":"bytes","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"general.direct_relay_copy_buf_c2s_bytes","value":{"type":"integer","minimum":4096,"maximum":1048576},"default_kind":"type_default","sensitivity":"public","description":"Copy buffer ceiling for client->DC direction in direct relay. This is also the upper bound for one amortized upload rate-limit burst: upload debt is settled before the next relay read instead of blocking inside the completed read path.","unit":"bytes","apply":{"watcher":"supported","reload":"supported","effect":"new_direct_relay_connections_keep_existing_buffers"}},
{"path":"general.direct_relay_copy_buf_s2c_bytes","value":{"type":"integer","minimum":8192,"maximum":2097152},"default_kind":"type_default","sensitivity":"public","description":"Copy buffer ceiling for DC->client direction in direct relay. This bounds one direct download rate-limit grant because writes are clipped to the currently available shaper budget.","unit":"bytes","apply":{"watcher":"supported","reload":"supported","effect":"new_direct_relay_connections_keep_existing_buffers"}},
{"path":"general.disable_colors","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Disable colored output in logs (useful for files/systemd).","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"general.fast_mode","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for general.fast_mode.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.fast_mode_min_tls_record","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Minimum TLS record size when fast_mode coalescing is enabled (0 = disabled).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"unit":"bytes"},
{"path":"general.hardswap","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable C-like hard-swap for ME pool generations. When true, Telemt prewarms a new generation and switches once full coverage is reached.","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.links","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"[general.links] — proxy link generation overrides.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.links.public_host","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Public hostname/IP for tg:// link generation (overrides detected IP).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.links.public_port","value":{"type":"integer","minimum":0,"maximum":65535},"default_kind":"unset","sensitivity":"public","description":"Public port for tg:// link generation. Overrides listener ports and legacy `server.port`.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.links.show","value":{"oneOf":[{"const":"*"},{"type":"array","items":{"type":"string"}}]},"default_kind":"type_default","sensitivity":"public","description":"List of usernames whose tg:// links to display at startup. `\"*\"` = all users, `[\"alice\", \"bob\"]` = specific users.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.log_level","value":{"type":"string","enum":["debug","verbose","normal","silent"]},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for general.log_level.","apply":{"watcher":"supported","reload":"supported","effect":"log_filter_update"}},
{"path":"general.max_client_frame","value":{"type":"integer","minimum":4096,"maximum":16777216},"default_kind":"type_default","sensitivity":"public","description":"Maximum allowed client MTProto frame size (bytes).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"unit":"bytes"},
{"path":"general.me2dc_fallback","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Allow fallback from Middle-End mode to direct DC when ME startup cannot be initialized.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.me2dc_fast","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Fast ME->Direct fallback mode for new sessions. Active only when both `use_middle_proxy=true` and `me2dc_fallback=true`.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.me_adaptive_floor_cpu_cores_override","value":{"type":"integer","minimum":0,"maximum":65535},"default_kind":"type_default","sensitivity":"public","description":"Override logical CPU core count for adaptive floor calculations. Set to 0 to use runtime auto-detection.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_idle_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Idle time in seconds before adaptive floor can reduce single-endpoint writer target.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_max_active_writers_global","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Hard global cap for active ME writers.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_max_active_writers_per_core","value":{"type":"integer","minimum":1,"maximum":65535},"default_kind":"type_default","sensitivity":"public","description":"Hard cap for active ME writers per logical CPU core.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_max_extra_writers_multi_per_core","value":{"type":"integer","minimum":0,"maximum":65535},"default_kind":"type_default","sensitivity":"public","description":"Per-core max extra writers above base required floor for multi-endpoint DC groups.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_max_extra_writers_single_per_core","value":{"type":"integer","minimum":0,"maximum":65535},"default_kind":"type_default","sensitivity":"public","description":"Per-core max extra writers above base required floor for single-endpoint DC groups.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_max_warm_writers_global","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Hard global cap for warm ME writers.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_max_warm_writers_per_core","value":{"type":"integer","minimum":1,"maximum":65535},"default_kind":"type_default","sensitivity":"public","description":"Hard cap for warm ME writers per logical CPU core.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_min_writers_multi_endpoint","value":{"type":"integer","minimum":1,"maximum":32},"default_kind":"type_default","sensitivity":"public","description":"Minimum writer target for multi-endpoint DC groups in adaptive floor mode.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_min_writers_single_endpoint","value":{"type":"integer","minimum":1,"maximum":32},"default_kind":"type_default","sensitivity":"public","description":"Minimum writer target for single-endpoint DC groups in adaptive floor mode.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_recover_grace_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Grace period in seconds to hold static floor after activity in adaptive mode.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_adaptive_floor_writers_per_core_total","value":{"type":"integer","minimum":1,"maximum":65535},"default_kind":"type_default","sensitivity":"public","description":"Global ME writer budget per logical CPU core in adaptive mode.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_admission_poll_ms","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Poll interval in milliseconds for conditional-admission state checks.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_bind_stale_mode","value":{"type":"string","enum":["never","ttl","always"]},"default_kind":"type_default","sensitivity":"public","description":"Policy for new binds on stale draining writers.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_bind_stale_ttl_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"TTL for stale bind allowance when `me_bind_stale_mode = \\\"ttl\\\"`.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_c2me_channel_capacity","value":{"type":"integer","minimum":1,"maximum":8192},"default_kind":"type_default","sensitivity":"public","description":"Capacity of per-client command queue from client reader to ME sender task.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_c2me_send_timeout_ms","value":{"type":"integer","minimum":0,"maximum":60000},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait in milliseconds for enqueueing C2ME commands when the queue is full. `0` keeps legacy unbounded wait behavior.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_config_apply_cooldown_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Cooldown in seconds between applied ME map updates.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_config_stable_snapshots","value":{"type":"integer","minimum":1,"maximum":255},"default_kind":"type_default","sensitivity":"public","description":"Number of identical getProxyConfig snapshots required before applying ME map updates.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_d2c_ack_flush_immediate","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Flush client writer immediately after quick-ack write.","apply":{"watcher":"supported","reload":"supported","effect":"new_me_sessions_keep_existing_relay_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_d2c_flush_batch_max_bytes","value":{"type":"integer","minimum":4096,"maximum":2097152},"default_kind":"type_default","sensitivity":"public","description":"Maximum total payload bytes coalesced before flush.","unit":"bytes","apply":{"watcher":"supported","reload":"supported","effect":"new_me_sessions_keep_existing_relay_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_d2c_flush_batch_max_delay_us","value":{"type":"integer","minimum":0,"maximum":5000},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait in microseconds to coalesce additional ME->Client responses. `0` disables timed coalescing.","unit":"microseconds","apply":{"watcher":"supported","reload":"supported","effect":"new_me_sessions_keep_existing_relay_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_d2c_flush_batch_max_frames","value":{"type":"integer","minimum":1,"maximum":512},"default_kind":"type_default","sensitivity":"public","description":"Maximum number of ME->Client responses coalesced before flush.","apply":{"watcher":"supported","reload":"supported","effect":"new_me_sessions_keep_existing_relay_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_d2c_frame_buf_shrink_threshold_bytes","value":{"type":"integer","minimum":4096,"maximum":16777216},"default_kind":"type_default","sensitivity":"public","description":"Shrink threshold for reusable ME->Client frame assembly buffer.","unit":"bytes","apply":{"watcher":"supported","reload":"supported","effect":"new_me_sessions_keep_existing_relay_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_deterministic_writer_sort","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Deterministic candidate sort for ME writer binding path.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_floor_mode","value":{"type":"string","enum":["static","adaptive"]},"default_kind":"type_default","sensitivity":"public","description":"Floor policy mode for ME writer targets.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_hardswap_warmup_delay_max_ms","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum delay in ms between hardswap warmup connect attempts.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_hardswap_warmup_delay_min_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Minimum delay in ms between hardswap warmup connect attempts.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_hardswap_warmup_extra_passes","value":{"type":"integer","minimum":0,"maximum":10},"default_kind":"type_default","sensitivity":"public","description":"Additional warmup passes in the same hardswap cycle after the base pass.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_hardswap_warmup_pass_backoff_base_ms","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Base backoff in ms between hardswap warmup passes when floor is still incomplete.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_health_interval_ms_healthy","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Health monitor interval in milliseconds while writer coverage is stable.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_health_interval_ms_unhealthy","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Health monitor interval in milliseconds while writer coverage is degraded.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_init_retry_attempts","value":{"type":"integer","minimum":0,"maximum":1000000},"default_kind":"type_default","sensitivity":"public","description":"Startup retries for Middle-End pool initialization before ME→Direct fallback. 0 means unlimited retries.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_instadrain","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Force-remove any draining writer on the next cleanup tick, regardless of age/deadline.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_keepalive_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable ME keepalive padding frames.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_keepalive_interval_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Keepalive interval in seconds.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_keepalive_jitter_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Keepalive jitter in seconds.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_keepalive_payload_random","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Keepalive payload randomized (4 bytes); otherwise zeros.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_pool_drain_soft_evict_budget_per_core","value":{"type":"integer","minimum":1,"maximum":64},"default_kind":"type_default","sensitivity":"public","description":"Soft-eviction budget per CPU core for one health tick.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_pool_drain_soft_evict_cooldown_ms","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Cooldown for repetitive soft-eviction on the same writer in milliseconds.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_pool_drain_soft_evict_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable staged client eviction for draining ME writers that remain non-empty past TTL.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_pool_drain_soft_evict_grace_secs","value":{"type":"integer","minimum":0,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Extra grace in seconds after drain TTL before soft-eviction stage starts.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_pool_drain_soft_evict_per_writer","value":{"type":"integer","minimum":1,"maximum":16},"default_kind":"type_default","sensitivity":"public","description":"Maximum number of client sessions to evict from one draining writer per health tick.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_pool_drain_threshold","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum allowed number of draining ME writers before oldest ones are force-closed in batches. Set to 0 to disable threshold-based draining cleanup and keep timeout-only behavior.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_pool_drain_ttl_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Drain-TTL in seconds for stale ME writers after endpoint map changes. During TTL, stale writers may be used only as fallback for new bindings.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_pool_min_fresh_ratio","value":{"type":"number","minimum":0.0,"maximum":1.0},"default_kind":"type_default","sensitivity":"public","description":"Minimum desired-DC coverage ratio required before draining stale writers. Range: 0.0..=1.0.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_quota_soft_overshoot_bytes","value":{"type":"integer","minimum":0,"maximum":16777216},"default_kind":"type_default","sensitivity":"public","description":"Additional bytes above strict per-user quota allowed in hot-path soft mode.","unit":"bytes","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reader_route_data_wait_ms","value":{"type":"integer","minimum":0,"maximum":20},"default_kind":"type_default","sensitivity":"public","description":"Bounded wait in milliseconds for routing ME DATA to per-connection queue. `0` keeps non-blocking routing; values >0 enable bounded wait for compatibility.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reconnect_backoff_base_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Base backoff in ms for reconnect.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reconnect_backoff_cap_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Cap backoff in ms for reconnect.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reconnect_fast_retry_count","value":{"type":"integer","minimum":0,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Fast retry attempts before backoff.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reconnect_max_concurrent_per_dc","value":{"type":"integer","minimum":0,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Max concurrent reconnect attempts per DC.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reinit_coalesce_window_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Trigger coalescing window before starting a reinit cycle.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reinit_drain_timeout_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Drain timeout in seconds for stale ME writers after endpoint map changes. Set to 0 to use the runtime safety fallback timeout.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reinit_every_secs","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Periodic ME pool reinitialization interval in seconds.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reinit_max_concurrency","value":{"type":"integer","minimum":1,"maximum":8},"default_kind":"type_default","sensitivity":"public","description":"Maximum concurrent ME reinit warmups when single-flight mode is disabled.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reinit_singleflight","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Serialize ME reinit cycles across all trigger sources.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_reinit_trigger_channel","value":{"type":"integer","minimum":1,"maximum":4096},"default_kind":"type_default","sensitivity":"public","description":"Trigger queue capacity for reinit scheduler.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_backpressure_base_timeout_ms","value":{"type":"integer","minimum":1,"maximum":5000},"default_kind":"type_default","sensitivity":"public","description":"Base backpressure timeout in milliseconds for ME route channel send.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_backpressure_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable route-level ME backpressure controls in reader fairness path.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_backpressure_high_timeout_ms","value":{"type":"integer","minimum":1,"maximum":5000},"default_kind":"type_default","sensitivity":"public","description":"High backpressure timeout in milliseconds when queue occupancy is above watermark.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_backpressure_high_watermark_pct","value":{"type":"integer","minimum":1,"maximum":100},"default_kind":"type_default","sensitivity":"public","description":"Queue occupancy percent threshold for high backpressure timeout.","unit":"percent","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_blocking_send_timeout_ms","value":{"type":"integer","minimum":1,"maximum":5000},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait in milliseconds for blocking ME writer channel send fallback. Must be within [1, 5000].","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_channel_capacity","value":{"type":"integer","minimum":1,"maximum":8192},"default_kind":"type_default","sensitivity":"public","description":"Capacity of per-connection ME response route channel.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_fairshare_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable worker-local fairshare scheduler for ME reader routing.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_hybrid_max_wait_ms","value":{"type":"integer","minimum":50,"maximum":60000},"default_kind":"type_default","sensitivity":"public","description":"Maximum cumulative wait in milliseconds for hybrid no-writer mode before failfast.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_inline_recovery_attempts","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Number of inline recovery attempts in legacy mode.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_inline_recovery_wait_ms","value":{"type":"integer","minimum":10,"maximum":30000},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait time in milliseconds for inline recovery in legacy mode.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_no_writer_mode","value":{"type":"string","enum":["async_recovery_failfast","inline_recovery_legacy","hybrid_async_persistent"]},"default_kind":"type_default","sensitivity":"public","description":"ME route behavior when no writer is immediately available.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_route_no_writer_wait_ms","value":{"type":"integer","minimum":10,"maximum":5000},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait time in milliseconds for async-recovery failfast mode.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_secret_atomic_snapshot","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Keep key-selector and secret bytes from one snapshot during ME handshake.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_single_endpoint_outage_backoff_max_ms","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum reconnect backoff in ms for single-endpoint outage mode.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_single_endpoint_outage_backoff_min_ms","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Minimum reconnect backoff in ms for single-endpoint outage mode.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_single_endpoint_outage_disable_quarantine","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Ignore endpoint quarantine while in single-endpoint outage mode.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_single_endpoint_outage_mode_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable aggressive outage recovery mode for single-endpoint DC groups.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_single_endpoint_shadow_rotate_every_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Periodic shadow writer rotation interval in seconds for single-endpoint DC groups. Set to 0 to disable periodic shadow rotation.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_single_endpoint_shadow_writers","value":{"type":"integer","minimum":0,"maximum":32},"default_kind":"type_default","sensitivity":"public","description":"Number of additional reserve writers for DC groups with exactly one endpoint.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_snapshot_min_proxy_for_lines","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Minimum parsed `proxy_for` rows required to accept a snapshot.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_snapshot_reject_empty_map","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Reject empty getProxyConfig snapshots instead of marking them applied.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_snapshot_require_http_2xx","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Ensure getProxyConfig snapshots are applied only for 2xx HTTP responses.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_socks_kdf_policy","value":{"type":"string","enum":["strict","compat"]},"default_kind":"type_default","sensitivity":"public","description":"SOCKS-bound KDF policy for Middle-End handshake.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_warmup_stagger_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable staggered warmup of extra ME writers.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_warmup_step_delay_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Base delay between warmup connections in ms.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_warmup_step_jitter_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Jitter for warmup delay in ms.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_warn_rate_limit_ms","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Cooldown for repetitive ME warning logs in milliseconds.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_writer_byte_budget_bytes","value":{"type":"integer","minimum":16384,"maximum":268435456,"multipleOf":16384},"default_kind":"type_default","sensitivity":"public","description":"Resident-memory budget in bytes for each ME writer data queue.","unit":"bytes","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy","general.max_client_frame"],"constraints":["Must be at least ceil((2 * general.max_client_frame + 256) / 16384) * 16384 bytes."]},
{"path":"general.me_writer_cmd_channel_capacity","value":{"type":"integer","minimum":1,"maximum":16384},"default_kind":"type_default","sensitivity":"public","description":"Capacity of per-ME writer command channel.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_writer_pick_mode","value":{"type":"string","enum":["sorted_rr","p2c"]},"default_kind":"type_default","sensitivity":"public","description":"Writer selection mode for ME route bind path.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.me_writer_pick_sample_size","value":{"type":"integer","minimum":2,"maximum":4},"default_kind":"type_default","sensitivity":"public","description":"Number of candidates sampled by writer picker in `p2c` mode.","apply":{"watcher":"supported","reload":"supported","effect":"next_subsystem_policy_consumption_or_me_update"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.middle_proxy_nat_ip","value":{"type":"string","format":"ip-address"},"default_kind":"unset","sensitivity":"deployment","description":"Public IP override for middle-proxy NAT environments. When set, this IP is used in ME key derivation and local address translation.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.middle_proxy_nat_probe","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable STUN-based NAT probing to discover public IP:port for ME KDF.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.middle_proxy_nat_stun","value":{"type":"string"},"default_kind":"type_default","sensitivity":"public","description":"Deprecated legacy single STUN server for NAT probing. Use `network.stun_servers` instead.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.middle_proxy_nat_stun_servers","value":{"type":"array","items":{"type":"string"}},"default_kind":"type_default","sensitivity":"public","description":"Deprecated legacy STUN list for NAT probing fallback. Use `network.stun_servers` instead.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.middle_proxy_pool_size","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Desired size of active Middle-Proxy writer pool.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.middle_proxy_warm_standby","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Number of warm standby ME connections kept pre-initialized.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["general.use_middle_proxy"]},
{"path":"general.modes","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Configuration value for general.modes.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.modes.classic","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for general.modes.classic.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.modes.secure","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for general.modes.secure.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.modes.tls","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for general.modes.tls.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.ntp_check","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable NTP drift check at startup.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.ntp_servers","value":{"type":"array","items":{"type":"string"}},"default_kind":"type_default","sensitivity":"public","description":"NTP servers for drift check.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.prefer_ipv6","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for general.prefer_ipv6.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.proxy_config_auto_reload_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Deprecated legacy setting; kept for backward compatibility fallback. Use `update_every` instead.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.proxy_config_v4_cache_path","value":{"type":"string"},"default_kind":"type_default","sensitivity":"deployment","description":"Optional path to cache raw getProxyConfig (IPv4) snapshot for startup fallback.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.proxy_config_v4_url","value":{"type":"string"},"default_kind":"unset","sensitivity":"deployment","description":"Optional custom URL for getProxyConfig (https://core.telegram.org/getProxyConfig if absent).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.proxy_config_v6_cache_path","value":{"type":"string"},"default_kind":"type_default","sensitivity":"deployment","description":"Optional path to cache raw getProxyConfigV6 snapshot for startup fallback.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.proxy_config_v6_url","value":{"type":"string"},"default_kind":"unset","sensitivity":"deployment","description":"Optional custom URL for getProxyConfigV6 (https://core.telegram.org/getProxyConfigV6 if absent).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.proxy_secret_auto_reload_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Deprecated legacy setting; kept for backward compatibility fallback. Use `update_every` instead.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.proxy_secret_len_max","value":{"type":"integer","minimum":32,"maximum":4096},"default_kind":"type_default","sensitivity":"public","description":"Maximum allowed proxy-secret length in bytes for startup and runtime refresh.","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.proxy_secret_path","value":{"type":"string"},"default_kind":"type_default","sensitivity":"deployment","description":"Path to proxy-secret binary file (auto-downloaded if absent). Infrastructure secret from https://core.telegram.org/getProxySecret.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.proxy_secret_rotate_runtime","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable runtime proxy-secret rotation from getProxySecret.","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.proxy_secret_stable_snapshots","value":{"type":"integer","minimum":1,"maximum":255},"default_kind":"type_default","sensitivity":"public","description":"Number of identical getProxySecret snapshots required before runtime secret rotation.","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.proxy_secret_url","value":{"type":"string"},"default_kind":"unset","sensitivity":"deployment","description":"Optional custom URL for infrastructure secret (https://core.telegram.org/getProxySecret if absent).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.quota_state_path","value":{"type":"string"},"default_kind":"type_default","sensitivity":"deployment","description":"JSON state file for runtime per-user quota consumption.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"general.rpc_proxy_req_every","value":{"oneOf":[{"const":0},{"type":"integer","minimum":10,"maximum":300}]},"default_kind":"type_default","sensitivity":"public","description":"Interval in seconds for service RPC_PROXY_REQ activity signals to ME. 0 disables service activity signals.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.rst_on_close","value":{"type":"string","enum":["off","errors","always"]},"default_kind":"type_default","sensitivity":"public","description":"RST-on-close mode for accepted client sockets. `off` — normal FIN on all closes (default). `errors` — SO_LINGER(0) on accept, cleared after successful auth; pre-handshake failures send RST, relayed sessions close gracefully. `always` — SO_LINGER(0) on accept, never cleared; all closes send RST.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.stun_iface_mismatch_ignore","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Ignore STUN/interface IP mismatch (keep using Middle Proxy even if NAT detected).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.stun_nat_probe_concurrency","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum number of concurrent STUN probes during NAT detection.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.telemetry","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Runtime telemetry controls for counters/metrics in hot paths.","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.telemetry.core_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for general.telemetry.core_enabled.","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.telemetry.me_level","value":{"type":"string","enum":["normal","silent","debug"]},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for general.telemetry.me_level.","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.telemetry.user_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for general.telemetry.user_enabled.","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.tg_connect","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Per-attempt TCP connect timeout to Telegram DC (seconds).","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.unknown_dc_file_log_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"deployment","description":"Enable unknown-DC file logging.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.unknown_dc_log_path","value":{"type":"string"},"default_kind":"type_default","sensitivity":"deployment","description":"Log unknown (non-standard) DC requests to a file (default: unknown-dc.txt). Set to null to disable.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.update_every","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Unified ME updater interval in seconds for getProxyConfig/getProxyConfigV6/getProxySecret. When omitted, effective value falls back to legacy proxy_*_auto_reload_secs fields.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"watcher_publication_then_subsystem_policy_consumption"}},
{"path":"general.upstream_connect_budget_ms","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Total wall-clock budget in milliseconds for one upstream connect request across retries.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.upstream_connect_failfast_hard_errors","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Skip additional retries for hard non-transient upstream connect errors.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.upstream_connect_retry_attempts","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Connect attempts for the selected upstream before returning error/fallback.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.upstream_connect_retry_backoff_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Delay in milliseconds between upstream connect attempts.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.upstream_unhealthy_fail_threshold","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Consecutive failed requests before upstream is marked unhealthy.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"general.use_middle_proxy","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for general.use_middle_proxy.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"include","value":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"default_kind":"unset","sensitivity":"public","description":"Source include path or list of paths; resolved before typed configuration.","apply":{"watcher":"conditional","reload":"conditional","effect":"depends_on_included_field_changes_and_source_ownership"}},
{"path":"logging","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Runtime logging destination, rotation, and retention configuration.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"logging.destination","value":{"type":"string","enum":["stderr","syslog","file"]},"default_kind":"type_default","sensitivity":"public","description":"Effective logging destination.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"logging.max_age_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum age for rotated log files in seconds. `0` disables age retention.","unit":"seconds","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"logging.max_files","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"deployment","description":"Maximum number of matching log files to keep. `0` disables count retention.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"logging.max_size_bytes","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum active log file size before rotating. `0` disables size rotation.","unit":"bytes","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"logging.path","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"File path used when `destination = \"file\"`.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"logging.rotation","value":{"type":"string","enum":["never","minutely","hourly","daily","weekly"]},"default_kind":"type_default","sensitivity":"public","description":"Time rotation interval for file logs.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"network","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Network binding, routing, and socket-level configuration.","apply":{"watcher":"mixed","reload":"mixed","effect":"see_child_fields"}},
{"path":"network.cache_public_ip_path","value":{"type":"string"},"default_kind":"type_default","sensitivity":"deployment","description":"Cache file path for detected public IP.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"network.dns_overrides","value":{"type":"array","items":{"type":"string"}},"default_kind":"type_default","sensitivity":"public","description":"Runtime DNS overrides in `host:port:ip` format. IPv6 IP values must be bracketed: `[2001:db8::1]`.","apply":{"watcher":"supported","reload":"supported","effect":"future_resolutions_existing_connections_unchanged"}},
{"path":"network.http_ip_detect_urls","value":{"type":"array","items":{"type":"string"}},"default_kind":"type_default","sensitivity":"deployment","description":"HTTP-based public IP detection endpoints (fallback after STUN).","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"network.ipv4","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for network.ipv4.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"network.ipv6","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"None = auto-detect IPv6 availability.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"network.multipath","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for network.multipath.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"network.prefer","value":{"type":"integer","minimum":0,"maximum":255,"enum":[4,6]},"default_kind":"type_default","sensitivity":"public","description":"4 or 6.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"constraints":["Loader may normalize the preference when a family is explicitly disabled."]},
{"path":"network.stun_servers","value":{"type":"array","items":{"type":"string"}},"default_kind":"type_default","sensitivity":"public","description":"STUN servers list for public IP discovery.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"network.stun_tcp_fallback","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable TCP STUN fallback when UDP is blocked.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"network.stun_use","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Global switch for STUN probing. When false, STUN is fully disabled and only non-STUN detection remains.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Server-side listener, fallback, and API configuration.","apply":{"watcher":"mixed","reload":"mixed","effect":"see_child_fields"}},
{"path":"server.accept_permit_timeout_ms","value":{"type":"integer","minimum":0,"maximum":60000},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait in milliseconds while acquiring a connection slot permit. `0` keeps legacy unbounded wait behavior.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.api","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Configuration value for server.api.","aliases":["server.admin_api"],"apply":{"watcher":"mixed","reload":"mixed","effect":"see_child_fields"}},
{"path":"server.api.auth_header","value":{"type":"string"},"default_kind":"redacted","sensitivity":"credential","description":"Optional static value for `Authorization` header validation. Empty string disables header auth.","aliases":["server.admin_api.auth_header"],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.api.enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable or disable REST API.","aliases":["server.admin_api.enabled"],"apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.api.gray_action","value":{"type":"string","enum":["api","200","drop"]},"default_kind":"type_default","sensitivity":"public","description":"Behavior for requests from source IPs outside `whitelist`. - `api`: return structured API forbidden response. - `200`: return `200 OK` with an empty body. - `drop`: close the connection without HTTP response.","aliases":["server.admin_api.gray_action"],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.api.listen","value":{"type":"string"},"default_kind":"type_default","sensitivity":"public","description":"Listen address for API in `IP:PORT` format.","aliases":["server.admin_api.listen"],"apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.api.minimal_runtime_cache_ttl_ms","value":{"type":"integer","minimum":0,"maximum":60000},"default_kind":"type_default","sensitivity":"public","description":"Cache TTL for minimal runtime snapshots in milliseconds (0 disables caching).","aliases":["server.admin_api.minimal_runtime_cache_ttl_ms"],"unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.api.minimal_runtime_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enable runtime snapshots that require read-lock aggregation on API request path.","aliases":["server.admin_api.minimal_runtime_enabled"],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.api.read_only","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Read-only mode: mutating endpoints are rejected.","aliases":["server.admin_api.read_only"],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.api.request_body_limit_bytes","value":{"type":"integer","minimum":1,"maximum":1048576},"default_kind":"type_default","sensitivity":"public","description":"Maximum accepted HTTP request body size in bytes.","aliases":["server.admin_api.request_body_limit_bytes"],"unit":"bytes","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.api.runtime_edge_cache_ttl_ms","value":{"type":"integer","minimum":0,"maximum":60000},"default_kind":"type_default","sensitivity":"public","description":"Cache TTL for runtime edge aggregation payloads in milliseconds.","aliases":["server.admin_api.runtime_edge_cache_ttl_ms"],"unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.api.runtime_edge_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enables runtime edge endpoints with optional cached aggregation.","aliases":["server.admin_api.runtime_edge_enabled"],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.api.runtime_edge_events_capacity","value":{"type":"integer","minimum":16,"maximum":4096},"default_kind":"type_default","sensitivity":"public","description":"Ring-buffer capacity for runtime edge control-plane events.","aliases":["server.admin_api.runtime_edge_events_capacity"],"apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.api.runtime_edge_top_n","value":{"type":"integer","minimum":1,"maximum":1000},"default_kind":"type_default","sensitivity":"public","description":"Top-N limit for edge connection leaderboard payloads.","aliases":["server.admin_api.runtime_edge_top_n"],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.api.whitelist","value":{"type":"array","items":{"type":"string","format":"cidr"}},"default_kind":"type_default","sensitivity":"public","description":"CIDR whitelist allowed to access API.","aliases":["server.admin_api.whitelist"],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.client_mss","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Client-facing TCP MSS preset or custom value for all TCP listeners. Empty string or omitted value keeps the kernel default.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.client_mss_bulk","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Experimental Linux-only bulk MSS used with best-effort userspace chunking of the authenticated FakeTLS response. TCP offloads, loss, and retransmission may coalesce write boundaries. Empty or omitted keeps `client_mss` connection-wide. Uses the same preset/integer grammar as `client_mss`.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.conntrack_control","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Runtime conntrack control and pressure policy.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.conntrack_control.backend","value":{"type":"string","enum":["auto","nftables","iptables"]},"default_kind":"type_default","sensitivity":"public","description":"Netfilter backend used to reconcile notrack rules.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.conntrack_control.delete_budget_per_sec","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum conntrack delete operations per second.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.conntrack_control.hybrid_listener_ips","value":{"type":"array","items":{"type":"string","format":"ip-address"}},"default_kind":"type_default","sensitivity":"public","description":"Listener IP allow-list for hybrid mode. Ignored in tracked/notrack mode.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.conntrack_control.inline_conntrack_control","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enables runtime conntrack-control worker for pressure mitigation.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.conntrack_control.mode","value":{"type":"string","enum":["tracked","notrack","hybrid"]},"default_kind":"type_default","sensitivity":"public","description":"Conntrack mode for listener ingress traffic.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.conntrack_control.pressure_high_watermark_pct","value":{"type":"integer","minimum":1,"maximum":100},"default_kind":"type_default","sensitivity":"public","description":"Pressure high watermark as percentage.","unit":"percent","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.conntrack_control.pressure_low_watermark_pct","value":{"type":"integer","minimum":0,"maximum":255},"default_kind":"type_default","sensitivity":"public","description":"Pressure low watermark as percentage.","unit":"percent","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.conntrack_control.profile","value":{"type":"string","enum":["conservative","balanced","aggressive"]},"default_kind":"type_default","sensitivity":"public","description":"Pressure profile for timeout caps under resource saturation.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.listen_addr_ipv4","value":{"type":"string"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for server.listen_addr_ipv4.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listen_addr_ipv6","value":{"type":"string"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for server.listen_addr_ipv6.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listen_backlog","value":{"type":"integer","minimum":0,"maximum":2147483647},"default_kind":"type_default","sensitivity":"public","description":"TCP `listen(2)` backlog for client-facing sockets (also used for the metrics HTTP listener). The effective queue is capped by the kernel (for example `somaxconn` on Linux).","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listen_tcp","value":{"type":"boolean"},"default_kind":"unset","sensitivity":"public","description":"Enable TCP listening. Default: true when no unix socket, false when listen_unix_sock is set. Set explicitly to override auto-detection.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listen_unix_sock","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Configuration value for server.listen_unix_sock.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.listen_unix_sock_perm","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Unix socket file permissions (octal, e.g. \"0666\" or \"0777\"). Applied via chmod after bind. Default: no change (inherits umask).","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.listeners","value":{"type":"array","items":{"type":"object"}},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for server.listeners.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].announce","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"IP address or hostname to announce in proxy links. Takes precedence over `announce_ip` if both are set.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].announce_ip","value":{"type":"string","format":"ip-address"},"default_kind":"unset","sensitivity":"public","description":"Deprecated: Use `announce` instead. IP address to announce in proxy links. Migrated to `announce` automatically if `announce` is not set.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].client_mss","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Per-listener client-facing TCP MSS preset or custom value. Empty string disables MSS shaping for this listener.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].ip","value":{"type":"string","format":"ip-address"},"default_kind":"required","sensitivity":"public","description":"Configuration value for server.listeners[].ip.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].port","value":{"type":"integer","minimum":0,"maximum":65535},"default_kind":"unset","sensitivity":"public","description":"Per-listener TCP port. If omitted, falls back to legacy `server.port`.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].proxy_protocol","value":{"type":"boolean"},"default_kind":"unset","sensitivity":"public","description":"Per-listener PROXY protocol override. When set, overrides global server.proxy_protocol.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].reuse_allow","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Allow multiple telemt instances to listen on the same IP:port (SO_REUSEPORT). Default is false for safety.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].synlimit","value":{"oneOf":[{"const":false},{"type":"string","enum":["iptables","nftables","pf","false","off","disabled","none"]}]},"default_kind":"type_default","sensitivity":"public","description":"Per-listener SYN limiter mode.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"},"constraints":["String tokens are trimmed and ASCII-case-insensitive; disabled aliases serialize as false. Boolean true is rejected."]},
{"path":"server.listeners[].synlimit_burst","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Generic SYN-fix token-bucket burst size.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].synlimit_hashlimit_expire_ms","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Hashlimit entry expiration in milliseconds for iptables/ip6tables rules.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].synlimit_hashlimit_size","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Hashlimit table size for iptables/ip6tables rules.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].synlimit_hitcount","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Generic SYN-fix token-bucket rate amount.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].synlimit_ios_burst","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"iOS-like SYN-fix token-bucket burst size.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].synlimit_ios_hitcount","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"iOS-like SYN-fix token-bucket rate amount.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].synlimit_ios_seconds","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"iOS-like SYN-fix token-bucket rate interval.","unit":"seconds","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].synlimit_seconds","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Generic SYN-fix token-bucket rate interval.","unit":"seconds","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].transport","value":{"type":"string","enum":["mtproxy","web"]},"default_kind":"type_default","sensitivity":"public","description":"Application protocol accepted by this listener.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].web_client_ip_source","value":{"type":"string","enum":["x_forwarded_for"]},"default_kind":"type_default","sensitivity":"public","description":"L7 header policy used only by WEB listeners.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.listeners[].web_trusted_proxy_cidrs","value":{"type":"array","items":{"type":"string","format":"cidr"}},"default_kind":"type_default","sensitivity":"public","description":"Immediate socket peers allowed to provide the WEB client identity header.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.max_connections","value":{"type":"integer","minimum":0,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Maximum number of concurrent client connections. 0 means unlimited.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.metrics_listen","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Listen address for metrics in `IP:PORT` format (e.g. `\"127.0.0.1:9090\"`). When set, takes precedence over `metrics_port` and binds on the specified address only. Docker port publishing requires an explicit container-reachable listen address.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.metrics_port","value":{"type":"integer","minimum":0,"maximum":65535},"default_kind":"unset","sensitivity":"public","description":"Port for the Prometheus-compatible metrics endpoint. Enables metrics when set; binds on IPv4 and IPv6 loopback by default.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"server.metrics_whitelist","value":{"type":"array","items":{"type":"string","format":"cidr"}},"default_kind":"type_default","sensitivity":"public","description":"CIDR whitelist for the metrics endpoint.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.port","value":{"type":"integer","minimum":0,"maximum":65535},"default_kind":"type_default","sensitivity":"public","description":"Legacy listener port used for backward compatibility. For new configs prefer `[[server.listeners]].port`.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.proxy_protocol","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Accept HAProxy PROXY protocol headers on incoming connections. When enabled, real client IPs are extracted from PROXY v1/v2 headers.","apply":{"watcher":"unsupported","reload":"conditional","effect":"listener_identity_and_bind_policy_dependent"}},
{"path":"server.proxy_protocol_header_timeout_ms","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Timeout in milliseconds for reading and parsing PROXY protocol headers.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"server.proxy_protocol_trusted_cidrs","value":{"type":"array","items":{"type":"string","format":"cidr"}},"default_kind":"type_default","sensitivity":"public","description":"Trusted source CIDRs allowed to send incoming PROXY protocol headers. If this field is omitted in config, it defaults to trust-all CIDRs (`0.0.0.0/0` and `::/0`). If it is explicitly set to an empty list, all PROXY protocol headers are rejected.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"show_link","value":{"oneOf":[{"const":"*"},{"type":"array","items":{"type":"string"}}]},"default_kind":"type_default","sensitivity":"public","description":"Optional proxy link rendering controls.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Timeout values used by client, fallback, and upstream operations.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts.client_ack","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for timeouts.client_ack.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts.client_first_byte_idle_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum idle wait in seconds for the first client byte before handshake parsing starts. `0` disables the separate idle phase and keeps legacy timeout behavior.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts.client_handshake","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum active handshake duration in seconds after the first client byte is received.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts.client_keepalive","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for timeouts.client_keepalive.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts.me_one_retry","value":{"type":"integer","minimum":0,"maximum":255},"default_kind":"type_default","sensitivity":"public","description":"Number of quick ME reconnect attempts for single-address DC.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts.me_one_timeout_ms","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Timeout per quick attempt in milliseconds for single-address DC.","unit":"milliseconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts.relay_client_idle_hard_secs","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Hard idle threshold for middle-relay client uplink activity in seconds. Hitting this threshold closes the session.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts.relay_client_idle_soft_secs","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Soft idle threshold for middle-relay client uplink activity in seconds. Hitting this threshold marks the session as idle-candidate, but does not close it.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts.relay_idle_grace_after_downstream_activity_secs","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Additional grace in seconds added to hard idle window after recent downstream activity.","unit":"seconds","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"timeouts.relay_idle_policy_v2_enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enables soft/hard relay client idle policy for middle-relay sessions.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"upstreams","value":{"type":"array","items":{"type":"object"}},"default_kind":"type_default","sensitivity":"public","description":"Telegram upstream endpoint configuration.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"upstreams[].address","value":{"type":"string"},"default_kind":"required","sensitivity":"deployment","description":"Configuration value for upstreams[].address.","constraints":["Applies when upstreams[].type is socks4, socks5."],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["upstreams[].type"]},
{"path":"upstreams[].bind_addresses","value":{"type":"array","items":{"type":"string"}},"default_kind":"unset","sensitivity":"deployment","description":"Configuration value for upstreams[].bind_addresses.","constraints":["Applies when upstreams[].type is direct."],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["upstreams[].type"]},
{"path":"upstreams[].bindtodevice","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Configuration value for upstreams[].bindtodevice.","aliases":["upstreams[].force_bind"],"constraints":["Applies when upstreams[].type is direct."],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["upstreams[].type"]},
{"path":"upstreams[].enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for upstreams[].enabled.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"upstreams[].interface","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Configuration value for upstreams[].interface.","constraints":["Applies when upstreams[].type is direct, socks4, socks5, shadowsocks."],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["upstreams[].type"]},
{"path":"upstreams[].ipv4","value":{"type":"boolean"},"default_kind":"unset","sensitivity":"public","description":"Allow IPv4 DC targets for this upstream. `None` means auto-detect from runtime connectivity state.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"upstreams[].ipv6","value":{"type":"boolean"},"default_kind":"unset","sensitivity":"public","description":"Allow IPv6 DC targets for this upstream. `None` means auto-detect from runtime connectivity state.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"upstreams[].password","value":{"type":"string"},"default_kind":"redacted","sensitivity":"credential","description":"Configuration value for upstreams[].password.","constraints":["Applies when upstreams[].type is socks5."],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["upstreams[].type"]},
{"path":"upstreams[].prefer","value":{"type":"integer","minimum":0,"maximum":255,"enum":[4,6]},"default_kind":"unset","sensitivity":"public","description":"Per-upstream IP family preference for Telegram DC targets. `None` inherits the effective global `[network].prefer` decision.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"upstreams[].scopes","value":{"type":"string"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for upstreams[].scopes.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"upstreams[].type","value":{"type":"string","enum":["direct","socks4","socks5","shadowsocks"]},"default_kind":"required","sensitivity":"public","description":"Configuration value for upstreams[].type.","constraints":["Selected by the enclosing upstream type."],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"upstreams[].url","value":{"type":"string"},"default_kind":"redacted","sensitivity":"credential","description":"Configuration value for upstreams[].url.","constraints":["Applies when upstreams[].type is shadowsocks."],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["upstreams[].type"]},
{"path":"upstreams[].user_id","value":{"type":"string"},"default_kind":"redacted","sensitivity":"credential","description":"Configuration value for upstreams[].user_id.","constraints":["Applies when upstreams[].type is socks4."],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["upstreams[].type"]},
{"path":"upstreams[].username","value":{"type":"string"},"default_kind":"redacted","sensitivity":"credential","description":"Configuration value for upstreams[].username.","constraints":["Applies when upstreams[].type is socks5."],"apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"},"dependencies":["upstreams[].type"]},
{"path":"upstreams[].weight","value":{"type":"integer","minimum":0,"maximum":65535},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for upstreams[].weight.","apply":{"watcher":"unsupported","reload":"supported","effect":"new_generation_with_instant_or_drain_session_policy"}},
{"path":"web","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"WEB carrier ingress and public-site fallback configuration.","apply":{"watcher":"mixed","reload":"mixed","effect":"see_child_fields"}},
{"path":"web.allow_wildcard_hosts","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Restart-only opt-in to automatic suffix and catch-all hostname selectors.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.carrier","value":{"type":"string","enum":["https","https-lanes","websocket","websocket-lanes"]},"default_kind":"type_default","sensitivity":"public","description":"Sole carrier when negotiation is disabled and final fallback when enabled.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.carrier_learning","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enables bounded process-local carrier learning for automatic sessions.","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.carrier","web.limits.max_carrier_learning_entries"]},
{"path":"web.carrier_method","value":{"type":"string","enum":["post","put"]},"default_kind":"type_default","sensitivity":"public","description":"Page-owned HTTP method for HTTPS uplink and downlink, including retries.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.carrier_negotiation_aggressiveness","value":{"type":"string","enum":["conservative","balanced","aggressive"]},"default_kind":"type_default","sensitivity":"public","description":"Controls the evidence thresholds used by automatic carrier ranking.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.carriers","value":{"oneOf":[{"const":false},{"type":"array","items":{"type":"string","enum":["https","https-lanes","websocket","websocket-lanes"]},"minItems":1,"maxItems":4,"uniqueItems":true}]},"default_kind":"type_default","sensitivity":"public","description":"Ordered carriers considered by server-side negotiation before the fallback carrier.","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.carrier","web.limits.max_carrier_learning_entries"]},
{"path":"web.conveyor","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enables negotiated bounded HTTP uplink pipelining for new WEB sessions.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.debug","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Hot-reloadable bounded server-side debug policy.","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"}},
{"path":"web.debug.body_capture","value":{"type":"string","enum":["off","metadata","prefix","full"]},"default_kind":"type_default","sensitivity":"public","description":"Controls request and response body byte retention.","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits"]},
{"path":"web.debug.body_prefix_bytes","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum retained body prefix for recognized WEB requests.","unit":"bytes","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits"]},
{"path":"web.debug.capture_frames","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Parses carrier bodies into bounded frame metadata.","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits"]},
{"path":"web.debug.capture_headers","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Retains allowlisted header values and names of all other headers.","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits"]},
{"path":"web.debug.capture_lifecycle","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Records typed bridge, session, stream, handshake, and relay events.","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits"]},
{"path":"web.debug.capture_timings","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Retains request service and body-consumption timing points.","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits"]},
{"path":"web.debug.decoy_body_prefix_bytes","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum retained body prefix for ordinary decoy traffic.","unit":"bytes","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits"]},
{"path":"web.debug.default_window_secs","value":{"type":"integer","minimum":1,"maximum":86400},"default_kind":"type_default","sensitivity":"public","description":"Default observation window presented by the status page.","unit":"seconds","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits"]},
{"path":"web.debug.enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enables process-owned WEB debug collection.","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits"]},
{"path":"web.debug.max_window_secs","value":{"type":"integer","minimum":1,"maximum":86400},"default_kind":"type_default","sensitivity":"public","description":"Largest observation window accepted by the status page.","unit":"seconds","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits"]},
{"path":"web.debug.sideband","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enables generated-bridge diagnostic reports over the HTTPS sideband.","apply":{"watcher":"conditional","reload":"conditional","effect":"requires_compatible_active_process_limits"},"dependencies":["web.debug.enabled","web.limits","web.debug.capture_lifecycle"]},
{"path":"web.decoy_fasttrack_mode","value":{"type":"string","enum":["off","shadow","enforce"]},"default_kind":"type_default","sensitivity":"public","description":"Restart-only capability-scan policy for structurally impossible bridge requests.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Enables issuance of new WEB bridge and session credentials.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["server.listeners","network.ipv4","network.ipv6"],"constraints":["Requires a network-eligible WEB listener and nonempty valid profiles; false stops new issuance without implicitly closing live sessions."]},
{"path":"web.http_connection_capacity_action","value":{"type":"string","enum":["drop","wait","respond"]},"default_kind":"type_default","sensitivity":"public","description":"Action applied when accepted HTTP connection capacity is exhausted.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.limits","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Hard process and protocol limits.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.carrier_batch_bytes","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum encoded downlink batch returned by one poll.","unit":"bytes","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.control_bytes_global","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide byte reserve available only to control frames.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"},"unit":"bytes"},
{"path":"web.limits.control_bytes_per_session","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Per-session byte reserve available only to control frames.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"},"unit":"bytes"},
{"path":"web.limits.debug_bytes_global","value":{"type":"integer","minimum":4096,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide retained and in-flight WEB debug byte ceiling.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"},"unit":"bytes"},
{"path":"web.limits.debug_records_capacity","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum retained WEB debug record count.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_body_bytes","value":{"type":"integer","minimum":8,"maximum":16777216},"default_kind":"type_default","sensitivity":"public","description":"Maximum collected carrier request body size.","unit":"bytes","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_body_bytes_global","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Process-wide byte reservation for collected request bodies.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"},"unit":"bytes"},
{"path":"web.limits.max_body_readers","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide concurrently collected request body ceiling.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_bootstraps_global","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide live bootstrap credential ceiling.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_bootstraps_per_ip","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Live bootstrap credential ceiling for one forwarded client address.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_carrier_learning_entries","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide bounded carrier-learning evidence entry ceiling.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_frame_payload_bytes","value":{"type":"integer","minimum":1,"maximum":1048576},"default_kind":"type_default","sensitivity":"public","description":"Maximum payload carried by one WEB frame.","unit":"bytes","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_frames_per_body","value":{"type":"integer","minimum":1,"maximum":4096},"default_kind":"type_default","sensitivity":"public","description":"Maximum frame count parsed or emitted in one carrier body.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_header_bytes","value":{"type":"integer","minimum":8192,"maximum":65536},"default_kind":"type_default","sensitivity":"public","description":"Maximum bytes accepted while parsing one HTTP request head.","unit":"bytes","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_http_connections","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide accepted WEB HTTP connection ceiling.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_http_handlers","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide concurrently executing HTTP handler ceiling.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_http_overload_connections","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Accepted overload sockets allowed to wait or emit a retryable response.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_lane_open_waits_per_session","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Per-session ceiling for downlink polls waiting for a lane OPEN.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_profiles","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum exact bindings plus one shared profile set per wildcard group.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_sessions_global","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide live WEB session ceiling.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_sessions_per_ip","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Live WEB session ceiling for one forwarded client address.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_static_bytes","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum static snapshot bytes, charged once per source group.","unit":"bytes","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_static_file_bytes","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"deployment","description":"Maximum bytes read from one static snapshot file.","unit":"bytes","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_static_files","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"deployment","description":"Maximum static snapshot entry count, charged once per source group.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_stream_handshakes","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide ceiling for inner MTProxy handshakes that received a first byte.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_streams_global","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide live logical-stream ceiling.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_streams_per_session","value":{"type":"integer","minimum":1,"maximum":65535},"default_kind":"type_default","sensitivity":"public","description":"Default live logical-stream ceiling for one WEB session.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_tombstones_per_session","value":{"type":"integer","minimum":1,"maximum":4096},"default_kind":"type_default","sensitivity":"public","description":"Closed stream identifiers retained by one session.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_vhosts","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum concrete hostname count across all WEB groups.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.max_websocket_evictions_in_flight","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Concurrent pressure-eviction claims allowed process-wide.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.memory_envelope_bytes","value":{"type":"integer","minimum":1,"maximum":4294967296},"default_kind":"type_default","sensitivity":"public","description":"Declared process envelope for HTTP, queues, capabilities, learning, and static snapshots.","unit":"bytes","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.new_bootstraps_burst","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Process-wide bootstrap issuance burst.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.new_bootstraps_per_minute","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Sustained process-wide bootstrap issuance rate.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.new_sessions_burst","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Process-wide session creation burst.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.new_sessions_per_minute","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Sustained process-wide session creation rate.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.new_streams_burst","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Process-wide logical-stream creation burst.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.new_streams_per_minute","value":{"type":"integer","minimum":1,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Sustained process-wide logical-stream creation rate.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.pending_bytes_global","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide queued data and control byte ceiling.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"},"unit":"bytes"},
{"path":"web.limits.pending_bytes_per_lane","value":{"type":"integer","minimum":265,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Queued and resident DATA bytes allowed for one independent lane.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"},"unit":"bytes"},
{"path":"web.limits.pending_bytes_per_session","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Total queued data and control bytes allowed for one session.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"},"unit":"bytes"},
{"path":"web.limits.pending_items_global","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide queued data and control item ceiling.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.pending_items_per_lane","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Queued and resident DATA items allowed for one independent lane.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.pending_items_per_session","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Total queued data and control item ceiling for one session.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.websocket_admission_watermark_pct","value":{"type":"integer","minimum":1,"maximum":99},"default_kind":"type_default","sensitivity":"public","description":"WebSocket usage percentage above which ordinary admission uses replacement.","unit":"percent","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.websocket_bytes_global","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Process-wide transient WebSocket byte sub-budget inside pending bytes.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"},"unit":"bytes"},
{"path":"web.limits.websocket_eviction_watermark_pct","value":{"type":"integer","minimum":1,"maximum":99},"default_kind":"type_default","sensitivity":"public","description":"WebSocket usage percentage that triggers pressure eviction.","unit":"percent","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.websocket_http_connection_reserve","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Accepted HTTP connections that WebSocket upgrades must leave available.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.wildcard","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Bounds automatic wildcard derivation and positive capability retention.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.wildcard.cache_bytes","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum charged bytes, including entries still borrowed after eviction.","unit":"bytes","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.wildcard.cache_hosts","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum positively authenticated hosts retained; zero disables retention.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.wildcard.cold_hmac_burst","value":{"type":"integer","minimum":0,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Atomic cold-derivation burst measured in HMAC evaluations.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.wildcard.cold_hmac_per_minute","value":{"type":"integer","minimum":0,"maximum":4294967295},"default_kind":"type_default","sensitivity":"public","description":"Sustained process-wide HMAC evaluation budget per minute.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.wildcard.max_profiles_per_request","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum complete profile scan and cold derivation cost for one request.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.limits.wildcard.max_rules","value":{"type":"integer","minimum":0,"maximum":18446744073709551615},"default_kind":"type_default","sensitivity":"public","description":"Maximum suffix and catch-all selectors across all source groups.","apply":{"watcher":"unsupported","reload":"process_restart","effect":"after_process_restart"}},
{"path":"web.retry_jitter","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"Additive HTTP retry jitter frozen into each generated bridge page.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.retry_jitter.distribution","value":{"type":"string","enum":["uniform","triangular"]},"default_kind":"type_default","sensitivity":"public","description":"Probability distribution used independently for each retry.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["web.retry_jitter.min_ms","web.retry_jitter.max_ms","web.retry_jitter.distribution"],"constraints":["0 <= min_ms <= max_ms <= 30000; peak_ms requires triangular distribution and an in-range value."]},
{"path":"web.retry_jitter.enabled","value":{"type":"boolean"},"default_kind":"type_default","sensitivity":"public","description":"Replaces the legacy jitter while retaining the underlying retry delay.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["web.retry_jitter.min_ms","web.retry_jitter.max_ms","web.retry_jitter.distribution"],"constraints":["0 <= min_ms <= max_ms <= 30000; peak_ms requires triangular distribution and an in-range value."]},
{"path":"web.retry_jitter.max_ms","value":{"type":"integer","minimum":0,"maximum":30000},"default_kind":"type_default","sensitivity":"public","description":"Inclusive maximum additive delay, bounded to 30000 milliseconds.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["web.retry_jitter.min_ms","web.retry_jitter.max_ms","web.retry_jitter.distribution"],"constraints":["0 <= min_ms <= max_ms <= 30000; peak_ms requires triangular distribution and an in-range value."]},
{"path":"web.retry_jitter.min_ms","value":{"type":"integer","minimum":0,"maximum":30000},"default_kind":"type_default","sensitivity":"public","description":"Inclusive minimum additive delay in milliseconds.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["web.retry_jitter.min_ms","web.retry_jitter.max_ms","web.retry_jitter.distribution"],"constraints":["0 <= min_ms <= max_ms <= 30000; peak_ms requires triangular distribution and an in-range value."]},
{"path":"web.retry_jitter.peak_ms","value":{"type":"integer","minimum":0,"maximum":30000},"default_kind":"unset","sensitivity":"public","description":"Triangular mode; omission selects the midpoint of the interval.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["web.retry_jitter.min_ms","web.retry_jitter.max_ms","web.retry_jitter.distribution"],"constraints":["0 <= min_ms <= max_ms <= 30000; peak_ms requires triangular distribution and an in-range value."]},
{"path":"web.timeouts","value":{"type":"object"},"default_kind":"nested_fields","sensitivity":"public","description":"WEB lifecycle deadlines.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.body_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Deadline for collecting one authenticated carrier request body.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.bootstrap_lifetime_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Lifetime of an unused bootstrap credential and closed-token replay marker.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.bridge_recovery_secs","value":{"type":"integer","minimum":1,"maximum":60},"default_kind":"type_default","sensitivity":"public","description":"Absolute post-commit budget for one surviving bridge recovery epoch.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.bridge_request_secs","value":{"type":"integer","minimum":1,"maximum":60},"default_kind":"type_default","sensitivity":"public","description":"Deadline for one generated-bridge HTTP attempt and response body.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.bridge_retry_secs","value":{"type":"integer","minimum":1,"maximum":300},"default_kind":"type_default","sensitivity":"public","description":"Absolute generated-bridge budget for one retryable HTTP operation.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.carrier_health_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Post-commit observation interval required before learning succeeds.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.carrier_learning_secs","value":{"type":"integer","minimum":2,"maximum":86400},"default_kind":"type_default","sensitivity":"public","description":"Fixed process-local carrier-learning evidence lifetime.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.carrier_negotiation_deadlines_secs","value":{"type":"array","items":{"type":"integer","minimum":0,"maximum":18446744073709551615},"minItems":4,"maxItems":4},"default_kind":"type_default","sensitivity":"public","description":"Cumulative carrier-attempt deadlines for up to four unique candidates.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"constraints":["Four nonzero strictly increasing deadlines; final deadline plus health and cleanup must fit bootstrap_lifetime_secs."]},
{"path":"web.timeouts.carrier_probe_coalesce_ms","value":{"type":"integer","minimum":0,"maximum":10},"default_kind":"type_default","sensitivity":"public","description":"Optional delay for coalescing the first OPEN with immediate DATA.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.decoy_header_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Deadline for connecting to and receiving headers from an HTTP decoy.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.decoy_resolve_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait for each unique HTTP decoy hostname during preparation.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.header_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Deadline for receiving one complete HTTP request head.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.http_idle_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Maximum idle lifetime of a WEB HTTP keep-alive connection.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.http_overload_timeout_ms","value":{"type":"integer","minimum":1,"maximum":60000},"default_kind":"type_default","sensitivity":"public","description":"Per-phase wait or response deadline for accepted HTTP overload sockets.","unit":"milliseconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.lane_open_wait_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Grace for a canonical downlink poll that races its lane OPEN.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.long_poll_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait for one empty downlink long poll.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.reconnect_grace_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Maximum validated peer inactivity before a session is closed.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.shutdown_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Maximum graceful wait for WEB connections and process-owned tasks.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.stream_first_byte_secs","value":{"type":"integer","minimum":1,"maximum":300},"default_kind":"type_default","sensitivity":"public","description":"Absolute deadline for receiving the first inner MTProxy byte.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.stream_handshake_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Deadline from the first inner byte through MTProxy authentication.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.websocket_backpressure_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait for WebSocket queue or byte-budget progress.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.websocket_eviction_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Maximum graceful close wait for an evicted WebSocket.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.websocket_open_secs","value":{"type":"integer","minimum":1,"maximum":300},"default_kind":"type_default","sensitivity":"public","description":"Absolute deadline for the first carrier binary message after upgrade.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.websocket_upgrade_secs","value":{"type":"integer","minimum":1,"maximum":60},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait for Hyper to transfer an accepted WebSocket upgrade.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.timeouts.websocket_write_secs","value":{"type":"integer","minimum":1,"maximum":3600},"default_kind":"type_default","sensitivity":"public","description":"Maximum wait for one WebSocket write to complete.","unit":"seconds","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"}},
{"path":"web.vhosts","value":{"type":"array","items":{"type":"object"}},"default_kind":"type_default","sensitivity":"public","description":"Exact hostname and opted-in wildcard groups served by WEB listeners.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"]},
{"path":"web.vhosts[].base_path","value":{"type":"string","maxLength":128},"default_kind":"type_default","sensitivity":"deployment","description":"Optional canonical WEB endpoint prefix without surrounding slashes.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"]},
{"path":"web.vhosts[].decoy","value":{"type":"object"},"default_kind":"required","sensitivity":"public","description":"Ordinary-site fallback shared by every hostname in this group.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"]},
{"path":"web.vhosts[].decoy.directory","value":{"type":"string"},"default_kind":"required","sensitivity":"deployment","description":"Configuration value for web.vhosts[].decoy.directory.","constraints":["Applies when web.vhosts[].decoy.mode is static_directory."],"apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits","web.vhosts[].decoy.mode"]},
{"path":"web.vhosts[].decoy.index","value":{"type":"string"},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for web.vhosts[].decoy.index.","constraints":["Applies when web.vhosts[].decoy.mode is static_directory."],"apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits","web.vhosts[].decoy.mode"]},
{"path":"web.vhosts[].decoy.mode","value":{"type":"string","enum":["http_upstream","static_directory"]},"default_kind":"required","sensitivity":"public","description":"Configuration value for web.vhosts[].decoy.mode.","constraints":["Selected by the enclosing decoy mode."],"apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"]},
{"path":"web.vhosts[].decoy.resolve","value":{"type":"string","enum":["never","startup"]},"default_kind":"type_default","sensitivity":"public","description":"Configuration value for web.vhosts[].decoy.resolve.","constraints":["Applies when web.vhosts[].decoy.mode is http_upstream."],"apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits","web.vhosts[].decoy.mode"]},
{"path":"web.vhosts[].decoy.upstream","value":{"type":"string"},"default_kind":"required","sensitivity":"public","description":"Configuration value for web.vhosts[].decoy.upstream.","constraints":["Applies when web.vhosts[].decoy.mode is http_upstream."],"apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits","web.vhosts[].decoy.mode"]},
{"path":"web.vhosts[].host","value":{"type":"string"},"default_kind":"unset","sensitivity":"public","description":"Single exact or opted-in wildcard selector, mutually exclusive with `hosts`.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"],"constraints":["Exactly one of host or hosts; normalized host selectors must be unique and obey the active wildcard policy."]},
{"path":"web.vhosts[].hosts","value":{"type":"array","items":{"type":"string"}},"default_kind":"unset","sensitivity":"public","description":"Non-empty selector list, normalized to lowercase ACE during validation.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"],"constraints":["Exactly one of host or hosts; normalized host selectors must be unique and obey the active wildcard policy."]},
{"path":"web.vhosts[].profiles","value":{"type":"array","items":{"type":"object"}},"default_kind":"type_default","sensitivity":"public","description":"Access profiles whose limits apply independently to each hostname.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"]},
{"path":"web.vhosts[].profiles[].max_sessions","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"unset","sensitivity":"public","description":"Optional per-profile live session ceiling.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"]},
{"path":"web.vhosts[].profiles[].max_streams","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"unset","sensitivity":"public","description":"Optional per-profile live logical-stream ceiling.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"]},
{"path":"web.vhosts[].profiles[].max_streams_per_session","value":{"type":"integer","minimum":1,"maximum":18446744073709551615},"default_kind":"unset","sensitivity":"public","description":"Optional per-profile stream ceiling for one session.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"]},
{"path":"web.vhosts[].profiles[].secret_mode","value":{"type":"string","enum":["plain","dd"]},"default_kind":"required","sensitivity":"public","description":"Exact client-facing secret representation advertised in WEB links.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"]},
{"path":"web.vhosts[].profiles[].user","value":{"type":"string","minLength":1,"maxLength":64},"default_kind":"required","sensitivity":"public","description":"Existing `[access.users]` key authenticated by the inner MTProxy handshake.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"]},
{"path":"web.vhosts[].public_addr","value":{"type":"string","format":"ip-port"},"default_kind":"required","sensitivity":"deployment","description":"Stable public destination tuple used by inner relay routing and KDF metadata.","apply":{"watcher":"supported","reload":"supported","effect":"new_issuance_or_policy_consumption_existing_session_contracts_preserved"},"dependencies":["access.users","web.limits"],"constraints":["A concrete, non-unspecified socket address with port 443 is required."]}
]
+182
View File
@@ -0,0 +1,182 @@
use std::sync::Arc;
use std::sync::atomic::{AtomicBool, AtomicU64};
use std::time::Duration;
use hyper::server::conn::http1;
use hyper::service::service_fn;
use serde_json::Value;
use tokio::net::TcpListener;
use tokio::sync::{Mutex, watch};
use crate::api::{ApiRuntimeState, ApiShared, events::ApiEventStore, handler};
use crate::config::{ApiGrayAction, ProxyConfig};
use crate::maestro::{
control_plane::ProcessControlPlane, generation::test_runtime_generation, reload::ReloadControl,
};
use crate::quota_state::QuotaStateOwner;
use crate::stats::QuotaStore;
struct Fixture {
_directory: tempfile::TempDir,
shared: Arc<ApiShared>,
}
impl Fixture {
fn new(whitelist_denied: bool) -> Self {
let directory = tempfile::tempdir().unwrap();
let config_path = directory.path().join("config.toml");
std::fs::write(&config_path, "# discovery must not edit this source\n").unwrap();
let mut config = ProxyConfig::default();
config.server.api.enabled = true;
config.server.api.read_only = true;
config.server.api.auth_header = "Bearer discovery-test".into();
config.server.api.gray_action = ApiGrayAction::Api;
config.server.api.whitelist = vec![if whitelist_denied {
"192.0.2.0/24".parse().unwrap()
} else {
"127.0.0.1/32".parse().unwrap()
}];
let runtime = test_runtime_generation(1, config.clone());
let shared = ApiShared {
stats: runtime.stats.clone(),
ip_tracker: runtime.ip_tracker.clone(),
me_pool: runtime.me_pool_runtime.clone(),
upstream_manager: runtime.upstream_manager.clone(),
config_path,
quota_state: QuotaStateOwner::new(
directory.path().join("quota.json"),
Arc::new(QuotaStore::default()),
),
detected_ips_rx: watch::channel((None, None)).1,
mutation_lock: Arc::new(Mutex::new(())),
minimal_cache: Arc::new(Mutex::new(None)),
runtime_edge_connections_cache: Arc::new(Mutex::new(None)),
runtime_edge_recompute_lock: Arc::new(Mutex::new(())),
cache_generation: Arc::new(AtomicU64::new(1)),
runtime_events: Arc::new(ApiEventStore::new(64)),
request_id: Arc::new(AtomicU64::new(1)),
runtime_state: Arc::new(ApiRuntimeState {
process_started_at_epoch_secs: 0,
config_reload_count: AtomicU64::new(0),
last_config_reload_epoch_secs: AtomicU64::new(0),
admission_open: AtomicBool::new(true),
}),
startup_tracker: Arc::new(crate::startup::StartupTracker::new(0)),
route_runtime: runtime.route_runtime.clone(),
proxy_shared: runtime.proxy_shared.clone(),
reload_control: ReloadControl::channel(1).0,
active_runtime: Arc::new(arc_swap::ArcSwap::from(runtime)),
web_trace: crate::web::trace::WebTraceStore::new(config.web.debug, &config.web.limits),
web_runtime_rx: crate::web::control::WebRuntimeControl::new().subscribe(),
control_plane: ProcessControlPlane::new(),
};
Self {
_directory: directory,
shared: Arc::new(shared),
}
}
async fn request(&self, method: &str, path: &str, authorized: bool) -> (u16, String, Value) {
let listener = TcpListener::bind("127.0.0.1:0").await.unwrap();
let address = listener.local_addr().unwrap();
let shared = self.shared.clone();
let server = tokio::spawn(async move {
let (stream, peer) = listener.accept().await.unwrap();
http1::Builder::new()
.serve_connection(
hyper_util::rt::TokioIo::new(stream),
service_fn(move |request| handler::handle(request, peer, shared.clone())),
)
.await
.unwrap();
});
let client = reqwest::Client::builder()
.no_proxy()
.timeout(Duration::from_secs(5))
.build()
.unwrap();
let mut request = client
.request(method.parse().unwrap(), format!("http://{address}{path}"))
.header("Connection", "close");
if authorized {
request = request.header("Authorization", "Bearer discovery-test");
}
let response = request.send().await.unwrap();
let status = response.status().as_u16();
let allow = response
.headers()
.get("allow")
.map(|value| value.to_str().unwrap().to_owned())
.unwrap_or_default();
let body = serde_json::from_slice(&response.bytes().await.unwrap()).unwrap();
tokio::time::timeout(Duration::from_secs(5), server)
.await
.unwrap()
.unwrap();
(status, allow, body)
}
}
#[tokio::test]
async fn discovery_http_preserves_auth_read_only_and_method_contracts() {
let fixture = Fixture::new(false);
let original = std::fs::read(&fixture.shared.config_path).unwrap();
for path in ["/v1/capabilities", "/v1/config/schema"] {
let (status, _, body) = fixture.request("GET", path, false).await;
assert_eq!(status, 401);
assert_eq!(body["error"]["code"], "unauthorized");
let (status, _, body) = fixture.request("GET", path, true).await;
assert_eq!(status, 200);
assert_eq!(body["ok"], true);
assert_eq!(body["data"]["schema_version"], 1);
assert!(
body["revision"]
.as_str()
.is_some_and(|value| !value.is_empty())
);
let (status, allow, body) = fixture.request("POST", path, true).await;
assert_eq!(status, 405);
assert_eq!(allow, "GET");
assert_eq!(body["error"]["code"], "method_not_allowed");
let (status, _, body) = fixture
.request("GET", &format!("{path}?extra=1"), true)
.await;
assert_eq!(status, 400);
assert_eq!(body["error"]["code"], "bad_request");
}
assert_eq!(
std::fs::read(&fixture.shared.config_path).unwrap(),
original
);
}
#[tokio::test]
async fn discovery_http_preserves_whitelist_gate() {
let fixture = Fixture::new(true);
for path in ["/v1/capabilities", "/v1/config/schema"] {
let (status, _, body) = fixture.request("GET", path, true).await;
assert_eq!(status, 403);
assert_eq!(body["error"]["code"], "forbidden");
}
}
#[tokio::test]
async fn capabilities_http_does_not_wait_for_contended_me_pool() {
let fixture = Fixture::new(false);
// Keep the writer alive until after the HTTP response: a blocking sample
// would time out instead of describing the unknown prerequisite.
let _guard = fixture.shared.me_pool.write().await;
let (status, _, body) = fixture.request("GET", "/v1/capabilities", true).await;
assert_eq!(status, 200);
let operation = body["data"]["operations"]
.as_array()
.unwrap()
.iter()
.find(|operation| operation["id"] == "runtime_me_pool_state")
.unwrap();
assert!(operation["available"].is_null());
assert_eq!(operation["unavailable_reason"], "snapshot_busy");
}
+52
View File
@@ -0,0 +1,52 @@
[
{"id": "health","method": "GET","path": "/v1/health","gate": "always","success": [200]},
{"id": "health_ready","method": "GET","path": "/v1/health/ready","gate": "always","success": [200,503]},
{"id": "capabilities","method": "GET","path": "/v1/capabilities","gate": "always","success": [200]},
{"id": "config_schema","method": "GET","path": "/v1/config/schema","gate": "always","success": [200]},
{"id": "system_info","method": "GET","path": "/v1/system/info","gate": "always","success": [200]},
{"id": "runtime_gates","method": "GET","path": "/v1/runtime/gates","gate": "always","success": [200]},
{"id": "runtime_initialization","method": "GET","path": "/v1/runtime/initialization","gate": "always","success": [200]},
{"id": "limits_effective","method": "GET","path": "/v1/limits/effective","gate": "always","success": [200]},
{"id": "security_posture","method": "GET","path": "/v1/security/posture","gate": "always","success": [200]},
{"id": "security_whitelist","method": "GET","path": "/v1/security/whitelist","gate": "always","success": [200]},
{"id": "stats_summary","method": "GET","path": "/v1/stats/summary","gate": "always","success": [200]},
{"id": "stats_zero_all","method": "GET","path": "/v1/stats/zero/all","gate": "always","success": [200]},
{"id": "stats_upstreams","method": "GET","path": "/v1/stats/upstreams","gate": "minimal","success": [200]},
{"id": "stats_minimal_all","method": "GET","path": "/v1/stats/minimal/all","gate": "minimal_me","success": [200]},
{"id": "stats_me_writers","method": "GET","path": "/v1/stats/me-writers","gate": "minimal_me","success": [200]},
{"id": "stats_dcs","method": "GET","path": "/v1/stats/dcs","gate": "minimal_me","success": [200]},
{"id": "runtime_me_pool_state","method": "GET","path": "/v1/runtime/me_pool_state","gate": "middle_proxy","success": [200],"aliases": ["/v1/runtime/me-pool-state"]},
{"id": "runtime_me_quality","method": "GET","path": "/v1/runtime/me_quality","gate": "middle_proxy","success": [200],"aliases": ["/v1/runtime/me-quality"]},
{"id": "runtime_upstream_quality","method": "GET","path": "/v1/runtime/upstream_quality","gate": "upstream","success": [200],"aliases": ["/v1/runtime/upstream-quality"]},
{"id": "runtime_nat_stun","method": "GET","path": "/v1/runtime/nat_stun","gate": "middle_proxy","success": [200],"aliases": ["/v1/runtime/nat-stun"]},
{"id": "runtime_me_selftest","method": "GET","path": "/v1/runtime/me-selftest","gate": "middle_proxy","success": [200]},
{"id": "runtime_connections_summary","method": "GET","path": "/v1/runtime/connections/summary","gate": "edge","success": [200]},
{"id": "runtime_events_recent","method": "GET","path": "/v1/runtime/events/recent","gate": "edge","success": [200]},
{"id": "runtime_tls_fingerprints","method": "GET","path": "/v1/runtime/tls-fingerprints","gate": "edge","success": [200]},
{"id": "web_status","method": "GET","path": "/v1/runtime/web/status","gate": "always","success": [200]},
{"id": "web_sessions","method": "GET","path": "/v1/runtime/web/sessions","gate": "web_read","success": [200]},
{"id": "web_session","method": "GET","path": "/v1/runtime/web/sessions/{session_ref}","gate": "web_read","success": [200,410]},
{"id": "web_sessions_close","method": "POST","path": "/v1/runtime/web/sessions/close","gate": "web_control","success": [202],"body": "CloseRequest","exact_json_content_type": true},
{"id": "web_operation","method": "GET","path": "/v1/runtime/web/operations/{operation_id}","gate": "web_read","success": [200]},
{"id": "web_debug_clear","method": "POST","path": "/v1/runtime/web/debug/clear","gate": "web_control","success": [200],"body": "RuntimeInstanceRequest","exact_json_content_type": true},
{"id": "web_learning_reset","method": "POST","path": "/v1/runtime/web/carrier-learning/reset","gate": "web_control","success": [200],"body": "RuntimeInstanceRequest","exact_json_content_type": true},
{"id": "web_pause","method": "POST","path": "/v1/runtime/web/lifecycle/pause","gate": "web_control","success": [200],"body": "RuntimeInstanceRequest","exact_json_content_type": true},
{"id": "web_drain","method": "POST","path": "/v1/runtime/web/lifecycle/drain","gate": "web_control","success": [202],"body": "DrainRequest","exact_json_content_type": true},
{"id": "web_resume","method": "POST","path": "/v1/runtime/web/lifecycle/resume","gate": "web_control","success": [200],"body": "RuntimeInstanceRequest","exact_json_content_type": true},
{"id": "web_status_html","method": "GET","path": "/web-status","gate": "always","success": [200]},
{"id": "users_active_ips","method": "GET","path": "/v1/stats/users/active-ips","gate": "always","success": [200]},
{"id": "users_quota","method": "GET","path": "/v1/stats/users/quota","gate": "always","success": [200]},
{"id": "config_get","method": "GET","path": "/v1/config","gate": "always","success": [200],"credential_bearing": true},
{"id": "config_patch","method": "PATCH","path": "/v1/config","gate": "always","success": [200,202],"body": "PatchConfigRequest","if_match": true},
{"id": "reload","method": "POST","path": "/v1/system/reload","gate": "always","success": [202],"body": "ReloadRequest","optional_body": true,"if_match": true},
{"id": "reload_status","method": "GET","path": "/v1/system/reload/{id}","gate": "always","success": [200]},
{"id": "users_list","method": "GET","path": "/v1/users","gate": "always","success": [200],"aliases": ["/v1/stats/users"],"credential_bearing": true},
{"id": "users_create","method": "POST","path": "/v1/users","gate": "always","success": [201,202],"body": "CreateUserRequest","if_match": true,"credential_bearing": true},
{"id": "users_get","method": "GET","path": "/v1/users/{username}","gate": "always","success": [200],"credential_bearing": true},
{"id": "users_patch","method": "PATCH","path": "/v1/users/{username}","gate": "always","success": [200,202],"body": "PatchUserRequest","if_match": true,"credential_bearing": true},
{"id": "users_delete","method": "DELETE","path": "/v1/users/{username}","gate": "always","success": [200,202],"if_match": true},
{"id": "users_rotate_secret","method": "POST","path": "/v1/users/{username}/rotate-secret","gate": "always","success": [200,202],"body": "RotateSecretRequest","optional_body": true,"if_match": true,"credential_bearing": true},
{"id": "users_enable","method": "POST","path": "/v1/users/{username}/enable","gate": "always","success": [200,202],"if_match": true,"credential_bearing": true},
{"id": "users_disable","method": "POST","path": "/v1/users/{username}/disable","gate": "always","success": [200,202],"if_match": true,"credential_bearing": true},
{"id": "users_reset_quota","method": "POST","path": "/v1/users/{username}/reset-quota","gate": "always","success": [200],"if_match": true}
]
+244
View File
@@ -0,0 +1,244 @@
//! Checked metadata projection over unconfigured, typed configuration defaults.
use std::sync::OnceLock;
use serde::{Deserialize, Serialize};
use serde_json::Value;
use super::super::config_store::{EDITABLE_SECTIONS, EDITABLE_SERVER_FIELDS};
use super::super::model::ApiFailure;
use super::SCHEMA_VERSION;
mod defaults;
#[cfg(test)]
mod inventory_tests;
#[cfg(test)]
mod tests;
#[derive(Debug, Deserialize, Serialize)]
#[serde(deny_unknown_fields)]
pub(super) struct FieldSpec {
pub(super) path: String,
pub(super) value: Value,
pub(super) default_kind: DefaultKind,
pub(super) sensitivity: String,
pub(super) description: String,
#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub(super) aliases: Vec<String>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub(super) unit: Option<String>,
pub(super) apply: ApplyPolicy,
#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub(super) dependencies: Vec<String>,
#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub(super) constraints: Vec<String>,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Deserialize, Serialize)]
#[serde(rename_all = "snake_case")]
pub(super) enum DefaultKind {
TypeDefault,
Unset,
Required,
NestedFields,
MapEntry,
Redacted,
}
#[derive(Debug, Deserialize, Serialize)]
#[serde(deny_unknown_fields)]
pub(super) struct ApplyPolicy {
pub(super) watcher: String,
pub(super) reload: String,
pub(super) effect: String,
}
#[derive(Serialize)]
pub(in crate::api) struct ConfigSchemaData {
schema_version: u32,
value_schema_dialect: &'static str,
defaults_scope: &'static str,
validation_scope: &'static str,
path_notation: &'static str,
config_patch: ConfigPatchSemantics,
fields: Vec<FieldMetadata>,
}
#[derive(Serialize)]
struct ConfigPatchSemantics {
objects: &'static str,
arrays: &'static str,
object_null_members: &'static str,
reset: &'static str,
source_ownership: &'static str,
if_match: &'static str,
}
#[derive(Serialize)]
struct FieldMetadata {
#[serde(flatten)]
spec: FieldSpec,
#[serde(skip_serializing_if = "Option::is_none")]
default: Option<Value>,
api: FieldApi,
}
#[derive(Serialize)]
struct FieldApi {
config_read: bool,
config_write: bool,
read_routes: Vec<&'static str>,
write_routes: Vec<&'static str>,
#[serde(skip_serializing_if = "Option::is_none")]
request_field: Option<&'static str>,
#[serde(skip_serializing_if = "Option::is_none")]
non_editable_reason: Option<&'static str>,
null_behavior: &'static str,
}
pub(in crate::api) fn config_schema() -> Result<&'static ConfigSchemaData, ApiFailure> {
static SCHEMA: OnceLock<Result<ConfigSchemaData, String>> = OnceLock::new();
SCHEMA
.get_or_init(build_schema)
.as_ref()
.map_err(|error| ApiFailure::internal(error.clone()))
}
fn field_specs() -> Result<Vec<FieldSpec>, String> {
serde_json::from_str(include_str!("fields.json"))
.map_err(|error| format!("invalid compiled config field catalog: {error}"))
}
fn build_schema() -> Result<ConfigSchemaData, String> {
let defaults = defaults::typed_defaults()?;
let specs = field_specs()?;
let mut fields = Vec::with_capacity(specs.len());
for spec in specs {
let default = match spec.default_kind {
DefaultKind::TypeDefault if spec.path == "web.vhosts[].profiles" => {
Some(Value::Array(Vec::new()))
}
DefaultKind::TypeDefault => Some(
default_at(
if spec.path.contains("[]") {
&defaults["_elements"]
} else {
&defaults
},
&spec.path,
)
.ok_or_else(|| format!("compiled config default missing: {}", spec.path))?
.clone(),
),
DefaultKind::Unset => Some(Value::Null),
_ => None,
};
let api = field_api(&spec.path);
fields.push(FieldMetadata { spec, default, api });
}
Ok(ConfigSchemaData {
schema_version: SCHEMA_VERSION,
value_schema_dialect: "https://json-schema.org/draft/2020-12/schema",
defaults_scope: "unconfigured_type_defaults_before_loader_normalization",
validation_scope: "value_constraints_are_not_a_substitute_for_full_config_validation",
path_notation: "dot_members; []=array_element; {name}=dynamic_map_key",
config_patch: ConfigPatchSemantics {
objects: "recursive_merge",
arrays: "replace_whole_array",
object_null_members: "ignored_before_candidate_validation",
reset: "not_supported",
source_ownership: "one_independently_writable_source_per_mutation",
if_match: "optional_source_manifest_revision",
},
fields,
})
}
fn default_at<'a>(value: &'a Value, path: &str) -> Option<&'a Value> {
fn walk<'a>(value: &'a Value, segments: &[&str]) -> Option<&'a Value> {
let Some((segment, rest)) = segments.split_first() else {
return Some(value);
};
if let Some(key) = segment.strip_suffix("[]") {
value
.get(key)?
.as_array()?
.iter()
.find_map(|item| walk(item, rest))
} else {
walk(value.get(*segment)?, rest)
}
}
walk(value, &path.split('.').collect::<Vec<_>>())
}
fn field_api(path: &str) -> FieldApi {
let top = path.split(['.', '[']).next().unwrap_or("");
let config_editable = EDITABLE_SECTIONS.contains(&top)
|| (top == "server"
&& EDITABLE_SERVER_FIELDS.iter().any(|field| {
let prefix = format!("server.{field}");
path == prefix
|| path.starts_with(&format!("{prefix}["))
|| path.starts_with(&format!("{prefix}."))
}));
let user_field = path
.strip_prefix("access.")
.and_then(|path| path.split('.').next())
.and_then(|field| match field {
"users" => Some("secret"),
"user_enabled" => Some("enabled"),
"user_ad_tags" => Some("user_ad_tag"),
"user_max_tcp_conns" => Some("max_tcp_conns"),
"user_expirations" => Some("expiration_rfc3339"),
"user_data_quota" => Some("data_quota_bytes"),
"user_quota_periods" => Some("quota_period"),
"user_max_unique_ips" => Some("max_unique_ips"),
"user_rate_limits" if path.ends_with(".up_bps") => Some("rate_limit_up_bps"),
"user_rate_limits" if path.ends_with(".down_bps") => Some("rate_limit_down_bps"),
_ => None,
});
let mut api = FieldApi {
config_read: config_editable,
config_write: config_editable,
read_routes: Vec::new(),
write_routes: Vec::new(),
request_field: user_field,
non_editable_reason: None,
null_behavior: "not_editable",
};
if config_editable {
api.read_routes.push("GET /v1/config");
api.write_routes.push("PATCH /v1/config");
api.null_behavior = "ignored_member_then_validate_candidate";
} else if let Some(field) = user_field {
api.read_routes.push("GET /v1/users/{username}");
api.write_routes
.extend(["POST /v1/users", "PATCH /v1/users/{username}"]);
api.null_behavior = if field == "secret" {
"unchanged_on_user_patch"
} else {
"remove_user_override_on_patch"
};
api.non_editable_reason = Some("managed_via_users_api");
} else {
api.non_editable_reason = Some(match top {
"access" => "access_policy_is_file_only",
"network" => "network_section_is_file_only",
"server" => "server_field_not_in_config_api_allowlist",
"logging" => "logging_section_is_file_only",
"show_link" => "use_general_links_show",
"include" => "source_graph_is_file_only",
_ => "root_field_not_in_config_api_allowlist",
});
}
if path.starts_with("access.user_max_unique_ips_")
|| path == "access.user_max_tcp_conns_global_each"
{
api.read_routes.push("GET /v1/limits/effective");
}
if path == "server.api.whitelist" {
api.read_routes.push("GET /v1/security/whitelist");
}
api
}
+41
View File
@@ -0,0 +1,41 @@
use serde_json::{Value, json};
use crate::config::{ListenerConfig, ProxyConfig, UpstreamConfig, WebVhostConfig};
/// Supplies child defaults for otherwise empty collections. Required/example
/// values are never projected; their catalog default kind excludes them.
pub(super) fn typed_defaults() -> Result<Value, String> {
let mut config = ProxyConfig::default();
// Even the repository's built-in example credential is not schema data.
config.access.users.clear();
let mut root = serde_json::to_value(config).map_err(|error| error.to_string())?;
let listener: ListenerConfig =
serde_json::from_value(json!({"ip": "127.0.0.1"})).map_err(|error| error.to_string())?;
let upstreams: Vec<UpstreamConfig> = serde_json::from_value(json!([
{"type": "direct"},
{"type": "socks4", "address": "127.0.0.1:1080"},
{"type": "socks5", "address": "127.0.0.1:1080"},
{"type": "shadowsocks", "url": "ss://schema-example"}
]))
.map_err(|error| error.to_string())?;
let vhosts: Vec<WebVhostConfig> = serde_json::from_value(json!([
{
"host": "schema.example", "public_addr": "127.0.0.1:443",
"decoy": {"mode": "http_upstream", "upstream": "http://127.0.0.1:8080"},
"profiles": [{"user": "schema-example", "secret_mode": "plain"}]
},
{
"hosts": ["schema.example"], "public_addr": "127.0.0.1:443",
"decoy": {"mode": "static_directory", "directory": "/schema-example"}
}
]))
.map_err(|error| error.to_string())?;
// Collection roots retain their actual empty default. The separate child
// tree is selected only by paths containing an array element marker.
root["_elements"] = json!({
"server": {"listeners": [listener]},
"upstreams": upstreams,
"web": {"vhosts": vhosts}
});
Ok(root)
}
+190
View File
@@ -0,0 +1,190 @@
//! Source inventory complements typed serialization for omitted Options and
//! empty maps. This deliberately supports the repository's declaration style;
//! an unfamiliar field declaration fails instead of silently losing coverage.
use std::collections::{BTreeMap, BTreeSet};
use std::path::Path;
use regex::Regex;
struct Field {
name: String,
ty: String,
flattened: bool,
}
fn read_sources(directory: &Path, sources: &mut Vec<String>) {
for entry in std::fs::read_dir(directory).unwrap() {
let path = entry.unwrap().path();
if path.is_dir() {
read_sources(&path, sources);
} else if path.extension().is_some_and(|extension| extension == "rs") {
sources.push(std::fs::read_to_string(path).unwrap());
}
}
}
#[test]
fn declared_fields_including_omitted_options_and_maps_have_metadata() {
let root = Path::new(env!("CARGO_MANIFEST_DIR")).join("src/config");
let mut sources = vec![std::fs::read_to_string(root.join("load.rs")).unwrap()];
read_sources(&root.join("types"), &mut sources);
let declaration = Regex::new(r"pub(?:\([^)]*\))? struct (\w+)\s*\{").unwrap();
let field = Regex::new(r"^pub(?:\([^)]*\))? (\w+): (.+),$").unwrap();
let skipped = Regex::new(r"\bskip\b").unwrap();
let mut structs = BTreeMap::new();
for source in &sources {
for found in declaration.captures_iter(source) {
let start = found.get(0).unwrap().end();
let body = source[start..].split_once("\n}").unwrap().0;
let mut attributes = String::new();
let mut fields = Vec::new();
for line in body.lines().map(str::trim) {
if line.starts_with("#[") || (!attributes.is_empty() && !attributes.ends_with(']'))
{
attributes.push_str(line);
} else if line.starts_with("pub ") || line.starts_with("pub(") {
let entry = field.captures(line).unwrap_or_else(|| {
panic!(
"extend discovery source inventory for {}: {line}",
&found[1]
)
});
if !skipped.is_match(&attributes) {
fields.push(Field {
name: entry[1].to_string(),
ty: entry[2].to_string(),
flattened: attributes.contains("flatten"),
});
}
attributes.clear();
}
}
assert!(structs.insert(found[1].to_string(), fields).is_none());
}
}
let catalog: BTreeSet<_> = super::config_schema()
.unwrap()
.fields
.iter()
.map(|field| field.spec.path.clone())
.collect();
let mut declared = BTreeSet::new();
visit("ProxyConfig", "", &structs, &mut declared);
// Empty collection defaults cannot reveal a new tagged variant. Check the
// declarations as well as serializing every currently known variant.
for (ty, path, tag, snake_case) in [
("UpstreamType", "upstreams[]", "type", false),
("WebDecoyConfig", "web.vhosts[].decoy", "mode", true),
] {
check_tagged_variants(&sources, ty, path, tag, snake_case, &structs, &mut declared);
}
let missing: Vec<_> = declared.difference(&catalog).collect();
assert!(
missing.is_empty(),
"unclassified declared fields: {missing:?}"
);
assert!(
declared.len() > 400,
"source inventory unexpectedly incomplete"
);
}
fn check_tagged_variants(
sources: &[String],
ty: &str,
path: &str,
tag: &str,
snake_case: bool,
structs: &BTreeMap<String, Vec<Field>>,
paths: &mut BTreeSet<String>,
) {
let marker = format!("pub enum {ty} {{");
let body = sources
.iter()
.find_map(|source| source.split_once(&marker))
.unwrap()
.1
.split_once("\n}")
.unwrap()
.0;
let tag_path = format!("{path}.{tag}");
paths.insert(tag_path.clone());
let schema = super::config_schema().unwrap();
let field = schema
.fields
.iter()
.find(|field| field.spec.path == tag_path)
.unwrap();
let variants: BTreeSet<_> = field.spec.value["enum"]
.as_array()
.unwrap()
.iter()
.map(|value| value.as_str().unwrap().to_owned())
.collect();
let variant = Regex::new(r"(?m)^ (\w+)\s*(?:\{|,)").unwrap();
let boundary = Regex::new(r"([a-z0-9])([A-Z])").unwrap();
let declared: BTreeSet<_> = variant
.captures_iter(body)
.map(|value| {
if snake_case {
boundary.replace_all(&value[1], "${1}_${2}").to_lowercase()
} else {
value[1].to_lowercase()
}
})
.collect();
assert_eq!(variants, declared, "unclassified tagged variants in {ty}");
let field = Regex::new(r"(?m)^ (\w+): (.+),$").unwrap();
for field in field.captures_iter(body) {
let path = format!("{path}.{}", &field[1]);
paths.insert(path.clone());
visit(&field[2], &path, structs, paths);
}
}
fn visit(
ty: &str,
path: &str,
structs: &BTreeMap<String, Vec<Field>>,
paths: &mut BTreeSet<String>,
) {
if let Some(inner) = ty
.strip_prefix("Option<")
.and_then(|ty| ty.strip_suffix('>'))
{
visit(inner, path, structs, paths);
} else if let Some(inner) = ty.strip_prefix("Vec<").and_then(|ty| ty.strip_suffix('>')) {
visit(inner, &format!("{path}[]"), structs, paths);
} else if let Some(inner) = ty
.strip_prefix("HashMap<")
.and_then(|ty| ty.strip_suffix('>'))
{
let (_, value) = inner.split_once(',').unwrap();
let key = match path {
"dc_overrides" => "{dc}",
"censorship.exclusive_mask" => "{hostname}",
"access.cidr_rate_limits" => "{cidr}",
_ => "{username}",
};
let path = format!("{path}.{key}");
paths.insert(path.clone());
visit(value.trim(), &path, structs, paths);
} else if let Some(fields) = structs.get(ty) {
for field in fields {
let next = if field.flattened {
path.to_string()
} else if path.is_empty() {
field.name.clone()
} else {
format!("{path}.{}", field.name)
};
if !field.flattened {
paths.insert(next.clone());
}
visit(&field.ty, &next, structs, paths);
}
}
// Tagged enum children are exercised through all typed variants by the
// serialization inventory test; scalar custom deserializers have no children.
}
+382
View File
@@ -0,0 +1,382 @@
use std::collections::{BTreeMap, BTreeSet};
use serde_json::{Value, json};
use super::*;
use crate::config::ProxyConfig;
fn field<'a>(schema: &'a ConfigSchemaData, path: &str) -> &'a FieldMetadata {
schema
.fields
.iter()
.find(|field| field.spec.path == path)
.unwrap_or_else(|| panic!("missing field {path}"))
}
#[test]
fn schema_defaults_and_collection_templates_are_typed_and_secret_free() {
let schema = config_schema().unwrap();
let defaults = ProxyConfig::default();
assert_eq!(
field(schema, "general.me_keepalive_interval_secs").default,
Some(json!(defaults.general.me_keepalive_interval_secs))
);
assert_eq!(
field(schema, "server.api.gray_action").default,
Some(json!("drop"))
);
assert_eq!(
field(schema, "server.listeners[].synlimit").default,
Some(json!(false))
);
assert_eq!(
field(schema, "web.vhosts[].profiles").default,
Some(json!([]))
);
assert_eq!(
field(schema, "web.vhosts[].host").default,
Some(Value::Null)
);
assert_eq!(
field(schema, "web.vhosts[].decoy.index").default,
Some(json!("index.html"))
);
assert!(field(schema, "web.vhosts[].public_addr").default.is_none());
assert!(field(schema, "upstreams[].address").default.is_none());
for path in [
"access.users",
"access.users.{username}",
"server.api.auth_header",
"upstreams[].password",
"upstreams[].url",
] {
let field = field(schema, path);
assert_eq!(field.spec.sensitivity, "credential");
assert!(field.default.is_none());
}
}
fn serialized_paths(value: &Value, path: &str, paths: &mut BTreeSet<String>) {
if !path.is_empty() {
paths.insert(path.to_string());
}
match value {
Value::Object(object) => {
for (key, value) in object {
if key == "_elements" {
continue;
}
let key = if path.is_empty() {
key.clone()
} else {
format!("{path}.{key}")
};
serialized_paths(value, &key, paths);
}
}
Value::Array(array) => {
for item in array {
if let Some(object) = item.as_object() {
for (key, value) in object {
serialized_paths(value, &format!("{path}[].{key}"), paths);
}
}
}
}
_ => {}
}
}
#[test]
fn every_serialized_field_has_metadata_including_all_collection_variants() {
let schema = config_schema().unwrap();
let mut actual = BTreeSet::new();
let values = defaults::typed_defaults().unwrap();
serialized_paths(&values, "", &mut actual);
serialized_paths(&values["_elements"], "", &mut actual);
let catalog: BTreeSet<_> = schema
.fields
.iter()
.map(|field| field.spec.path.clone())
.collect();
assert_eq!(catalog.len(), schema.fields.len(), "duplicate config path");
let missing: Vec<_> = actual.difference(&catalog).collect();
assert!(
missing.is_empty(),
"unclassified serialized fields: {missing:?}"
);
// Omitted Options and dynamic maps are part of the contract too.
for path in [
"web.vhosts[].host",
"web.vhosts[].hosts",
"web.retry_jitter.peak_ms",
"access.users.{username}",
"access.user_rate_limits.{username}.up_bps",
"access.cidr_rate_limits.{cidr}.down_bps",
"dc_overrides.{dc}",
] {
assert!(catalog.contains(path), "missing {path}");
}
for entry in &schema.fields {
if !entry.api.config_write && entry.api.write_routes.is_empty() {
assert!(
entry.api.non_editable_reason.is_some(),
"{}",
entry.spec.path
);
}
}
}
#[test]
fn api_ownership_aliases_and_null_contracts_match_existing_surfaces() {
let schema = config_schema().unwrap();
assert!(field(schema, "web.vhosts[].base_path").api.config_write);
assert!(field(schema, "server.listeners[].port").api.config_write);
assert!(
!field(schema, "server.api.runtime_edge_enabled")
.api
.config_write
);
assert!(!field(schema, "network.dns_overrides").api.config_read);
assert_eq!(
field(schema, "access.user_rate_limits.{username}.up_bps")
.api
.request_field,
Some("rate_limit_up_bps")
);
assert_eq!(
field(schema, "access.user_quota_periods.{username}")
.api
.null_behavior,
"remove_user_override_on_patch"
);
assert!(
field(schema, "access.user_source_deny")
.api
.write_routes
.is_empty()
);
assert!(
field(schema, "server.api.listen")
.spec
.aliases
.contains(&"server.admin_api.listen".into())
);
assert!(
field(schema, "upstreams[].bindtodevice")
.spec
.aliases
.contains(&"upstreams[].force_bind".into())
);
assert_eq!(
field(schema, "network.dns_overrides").spec.apply.watcher,
"supported"
);
assert_eq!(
field(schema, "web.debug.body_capture").spec.apply.reload,
"conditional"
);
assert_eq!(
field(schema, "web.limits.max_sessions_global")
.spec
.apply
.reload,
"process_restart"
);
assert_eq!(
schema.config_patch.object_null_members,
"ignored_before_candidate_validation"
);
}
fn accepts(schema: &Value, value: &Value) -> bool {
if let Some(options) = schema.get("oneOf").and_then(Value::as_array) {
return options
.iter()
.filter(|option| accepts(option, value))
.count()
== 1;
}
if let Some(expected) = schema.get("const") {
return value == expected;
}
if let Some(values) = schema.get("enum").and_then(Value::as_array) {
if !values.contains(value) {
return false;
}
}
let correct_type = match schema["type"].as_str() {
Some("string") => value.is_string(),
Some("boolean") => value.is_boolean(),
Some("integer") => value.is_u64() || value.is_i64(),
Some("number") => value.is_number(),
Some("array") => value.is_array(),
Some("object") => value.is_object(),
None => true,
other => panic!("unsupported value schema type: {other:?}"),
};
if !correct_type {
return false;
}
if let Some(number) = value.as_f64() {
if schema
.get("minimum")
.and_then(Value::as_f64)
.is_some_and(|min| number < min)
|| schema
.get("maximum")
.and_then(Value::as_f64)
.is_some_and(|max| number > max)
{
return false;
}
}
if let Some(array) = value.as_array() {
if schema
.get("minItems")
.and_then(Value::as_u64)
.is_some_and(|min| array.len() < min as usize)
|| schema
.get("maxItems")
.and_then(Value::as_u64)
.is_some_and(|max| array.len() > max as usize)
{
return false;
}
if let Some(items) = schema.get("items") {
return array.iter().all(|value| accepts(items, value));
}
}
true
}
#[test]
fn declared_value_types_enums_and_ranges_accept_typed_defaults() {
for field in &config_schema().unwrap().fields {
if let Some(default) = &field.default {
if !default.is_null() {
assert!(
accepts(&field.spec.value, default),
"{}: {default} violates {}",
field.spec.path,
field.spec.value
);
}
}
}
}
fn alternative(field: &FieldMetadata, current: &Value) -> Option<Value> {
if let Some(values) = field.spec.value.get("enum").and_then(Value::as_array) {
return values.iter().find(|value| *value != current).cloned();
}
if let Some(boolean) = current.as_bool() {
return Some(json!(!boolean));
}
if let Some(number) = current.as_u64() {
return number.checked_add(1).map(|number| json!(number));
}
if let Some(number) = current.as_f64() {
return Some(json!(number + 0.01));
}
None
}
#[test]
fn application_metadata_matches_watcher_and_process_resolver() {
let base = ProxyConfig::default();
let baseline = serde_json::to_value(&base).unwrap();
let schema = config_schema().unwrap();
let mut watched = 0;
let mut resolved = 0;
let mut mismatches = Vec::new();
for field in &schema.fields {
let path = &field.spec.path;
if path.contains('[') || path.contains('{') {
continue;
}
let pointer = format!("/{}", path.replace('.', "/"));
let Some(current) = baseline.pointer(&pointer) else {
continue;
};
let Some(next) = alternative(field, current) else {
continue;
};
let mut candidate = baseline.clone();
*candidate.pointer_mut(&pointer).unwrap() = next;
let Ok(candidate) = serde_json::from_value::<ProxyConfig>(candidate) else {
continue;
};
let class = crate::config::hot_reload::classify_config_changes(&base, &candidate);
match field.spec.apply.watcher.as_str() {
"supported" => {
if class.restart_required {
mismatches.push(format!("watcher unexpectedly requires restart: {path}"));
}
watched += 1;
}
"unsupported" => {
if !class.restart_required {
mismatches.push(format!("watcher unexpectedly supports: {path}"));
}
watched += 1;
}
_ => {}
}
// Independent runtime validation can reject a deliberately single-field
// perturbation; only valid candidates classify the actual reload effect.
if let Ok(effect) = crate::maestro::runtime_build::resolve_reload_config(&base, &candidate)
{
match field.spec.apply.reload.as_str() {
"process_restart" => {
if effect.deferred_process_fields.is_empty() {
mismatches.push(format!("reload unexpectedly applies: {path}"));
}
}
"supported" => {
if !effect.deferred_process_fields.is_empty() {
mismatches.push(format!("reload unexpectedly defers: {path}"));
}
}
_ => continue,
}
resolved += 1;
}
}
assert!(mismatches.is_empty(), "{}", mismatches.join("\n"));
assert!(
watched > 150,
"only {watched} fields checked against watcher"
);
assert!(
resolved > 150,
"only {resolved} fields checked against runtime resolver"
);
}
#[test]
fn field_enums_round_trip_through_real_deserializers() {
let baseline = defaults::typed_defaults().unwrap();
let mut checked = BTreeMap::new();
for field in &config_schema().unwrap().fields {
let path = &field.spec.path;
if path.contains('[') || path.contains('{') {
continue;
}
let Some(variants) = field.spec.value.get("enum").and_then(Value::as_array) else {
continue;
};
let pointer = format!("/{}", path.replace('.', "/"));
for variant in variants {
let mut candidate = baseline.clone();
*candidate.pointer_mut(&pointer).unwrap() = variant.clone();
let config: ProxyConfig = serde_json::from_value(candidate)
.unwrap_or_else(|error| panic!("{path}={variant}: {error}"));
let serialized = serde_json::to_value(config).unwrap();
assert_eq!(serialized.pointer(&pointer), Some(variant), "{path}");
}
checked.insert(path, variants.len());
}
assert!(checked.len() >= 15);
}
+194
View File
@@ -0,0 +1,194 @@
use std::collections::{BTreeMap, BTreeSet};
use serde_json::{Value, json};
use super::*;
use crate::api::allowed_methods_for_path;
fn unavailable() -> Availability {
Availability {
me_pool: Some(false),
web_read: false,
web_control: false,
}
}
fn operation<'a>(data: &'a Value, id: &str) -> &'a Value {
data["operations"]
.as_array()
.unwrap()
.iter()
.find(|entry| entry["id"] == id)
.unwrap()
}
#[test]
fn discovery_distinguishes_disabled_unavailable_and_read_only() {
let mut config = ProxyConfig::default();
config.server.api.read_only = true;
config.server.api.minimal_runtime_enabled = false;
config.server.api.runtime_edge_enabled = false;
let data = serde_json::to_value(build_capabilities(&config, unavailable()).unwrap()).unwrap();
let disabled = operation(&data, "stats_me_writers");
assert_eq!(disabled["supported"], true);
assert_eq!(disabled["enabled"], false);
assert_eq!(disabled["disabled_reason"], "feature_disabled");
assert_eq!(
operation(&data, "runtime_upstream_quality")["enabled"],
true
);
assert_eq!(operation(&data, "web_sessions")["enabled"], true);
assert_eq!(operation(&data, "web_sessions")["available"], false);
assert_eq!(operation(&data, "web_status")["available"], true);
assert_eq!(operation(&data, "users_patch")["mutable"], false);
assert_eq!(
operation(&data, "users_patch")["mutation_blocked_reason"],
"read_only"
);
assert_eq!(operation(&data, "config_schema")["available"], true);
config.server.api.read_only = false;
config.server.api.minimal_runtime_enabled = true;
config.server.api.runtime_edge_enabled = true;
let available = Availability {
me_pool: Some(true),
web_read: true,
web_control: false,
};
let data = serde_json::to_value(build_capabilities(&config, available).unwrap()).unwrap();
assert_eq!(operation(&data, "stats_me_writers")["available"], true);
assert_eq!(operation(&data, "web_sessions")["available"], true);
assert_eq!(operation(&data, "web_drain")["available"], false);
assert_eq!(operation(&data, "web_drain")["mutable"], true);
assert_eq!(operation(&data, "users_patch")["mutable"], true);
assert_eq!(operation(&data, "users_get")["mutable"], false);
}
#[test]
fn busy_or_unsampled_sources_are_not_reported_as_healthy() {
let config = ProxyConfig::default();
let data = serde_json::to_value(
build_capabilities(
&config,
Availability {
me_pool: None,
..unavailable()
},
)
.unwrap(),
)
.unwrap();
assert!(operation(&data, "runtime_me_quality")["available"].is_null());
assert_eq!(
operation(&data, "runtime_me_quality")["unavailable_reason"],
"snapshot_busy"
);
assert!(operation(&data, "stats_upstreams")["available"].is_null());
assert_eq!(
operation(&data, "stats_upstreams")["unavailable_reason"],
"availability_not_sampled"
);
}
#[test]
fn discovery_does_not_serialize_configured_credentials_or_addresses() {
let mut config = ProxyConfig::default();
config.server.api.auth_header = "private-auth-sentinel".into();
config.general.proxy_secret_url = Some("https://private-url-sentinel/secret".into());
config.access.users.insert(
"private-user-sentinel".into(),
"private-secret-sentinel".into(),
);
config.upstreams = serde_json::from_value(json!([
{"type":"socks5", "address":"private-address-sentinel:1080", "password":"private-password-sentinel"}
])).unwrap();
let caps = serde_json::to_string(&build_capabilities(&config, unavailable()).unwrap()).unwrap();
let schema = serde_json::to_string(config_schema().unwrap()).unwrap();
assert!(!caps.contains("sentinel"));
assert!(!schema.contains("sentinel"));
for secret in ProxyConfig::default().access.users.values() {
assert!(!schema.contains(secret));
}
assert!(schema.len() < 1024 * 1024);
assert!(caps.len() < 128 * 1024);
}
fn example_path(path: &str) -> String {
path.replace("{username}", "alice")
.replace("{id}", "42")
.replace(
"{session_ref}",
"ws1.00000000000000000000000000000000.0000000000000001",
)
.replace(
"{operation_id}",
"wo1.00000000000000000000000000000000.0000000000000001",
)
}
#[test]
fn operation_catalog_matches_routing_methods_and_openapi() {
let document: Value = serde_json::from_str(include_str!(
"../../../docs/Architecture/API/openapi-v1.json"
))
.unwrap();
let mut paths = BTreeMap::<String, BTreeSet<String>>::new();
let mut ids = BTreeSet::new();
for operation in operations().unwrap() {
assert!(
ids.insert(&operation.id),
"duplicate operation: {}",
operation.id
);
for path in std::iter::once(&operation.path).chain(&operation.aliases) {
assert!(
paths
.entry(path.clone())
.or_default()
.insert(operation.method.clone())
);
let allowed = allowed_methods_for_path(&example_path(path))
.unwrap_or_else(|| panic!("missing route: {path}"));
assert!(
allowed.split(", ").any(|method| method == operation.method),
"{path}: {allowed}"
);
let spec = &document["paths"][path][operation.method.to_lowercase()];
assert!(spec.is_object(), "missing OpenAPI operation: {path}");
for status in &operation.success {
assert!(spec["responses"][status.to_string()].is_object());
}
}
}
for (path, methods) in &paths {
let allowed = allowed_methods_for_path(&example_path(path)).unwrap();
assert_eq!(
methods,
&allowed.split(", ").map(str::to_owned).collect(),
"{path}"
);
}
assert_eq!(paths.len(), document["paths"].as_object().unwrap().len());
// Both tables are independent: a newly dispatched fixed route cannot silently
// disappear from discovery because a maintainer omitted its catalog entry.
for source in [
include_str!("../mod.rs"),
include_str!("../handler.rs"),
include_str!("../handler/read_routes.rs"),
include_str!("../handler/fixed_routes.rs"),
include_str!("../web_runtime.rs"),
] {
let pattern = regex::Regex::new(r#""(/v1/[^"{}]*|/web-status)""#).unwrap();
for matched in pattern.captures_iter(source) {
let path = &matched[1];
if path.ends_with('/') || path.contains('*') {
continue;
}
assert!(paths.contains_key(path), "unclassified route: {path}");
}
}
assert_eq!(allowed_methods_for_path("/v1/config/schema"), Some("GET"));
assert_eq!(allowed_methods_for_path("/v1/capabilities"), Some("GET"));
assert!(reject_query(None).is_ok());
assert!(reject_query(Some("include_secrets=true")).is_err());
}
+15
View File
@@ -10,6 +10,21 @@ pub(super) async fn handle(
) -> Result<Option<Response<Full<Bytes>>>, ApiFailure> {
let api_cfg = &cfg.server.api;
match (method.as_str(), normalized_path) {
("GET", "/v1/capabilities") => {
discovery::reject_query(query)?;
let revision = current_revision(&shared.config_path).await?;
let data = discovery::capabilities(shared, cfg)?;
Ok(success_response(StatusCode::OK, data, revision))
}
("GET", "/v1/config/schema") => {
discovery::reject_query(query)?;
let revision = current_revision(&shared.config_path).await?;
Ok(success_response(
StatusCode::OK,
discovery::config_schema()?,
revision,
))
}
("GET", "/web-status") => Ok(web_status::render(query, &shared.web_trace).await),
("GET", "/v1/health") => {
let revision = current_revision(&shared.config_path).await?;
+3
View File
@@ -38,6 +38,7 @@ use crate::web::trace::WebTraceStore;
mod config_edit;
pub(crate) mod config_store;
mod discovery;
mod events;
mod http_utils;
// Authenticated request admission and route dispatch.
@@ -264,6 +265,8 @@ fn allowed_methods_for_path(path: &str) -> Option<&'static str> {
}
match path {
"/v1/health"
| "/v1/capabilities"
| "/v1/config/schema"
| "/v1/health/ready"
| "/v1/system/info"
| "/v1/runtime/gates"