Previous value: -"Machine-readable failure mode. Declared by this tool: `unknown_alias`: No connection is registered under the requested alias, and the server has no base URL configured for it to connect on first use. `auth_token_exchange_failed`: Connecting the alias on first use, the SGN or OAuth token exchange against the BrAPI /token endpoint failed. `auth_no_access_token`: Connecting the alias on first use, the token endpoint answered without returning an access token. `capability_discovery_unavailable`: Neither /serverinfo nor /calls listed any call, and at least one of them timed out, was unreachable, or answered 429 or a 5xx other than 501, so nothing was cached. `upstream_unauthorized`: The BrAPI server answered HTTP 401: it requires credentials, or rejected the ones sent. `upstream_forbidden`: The BrAPI server answered HTTP 403: the credentials sent, or their absence, lack access. `alias_base_url_invalid`: The base URL configured on the server for this alias is not an absolute http(s) URL, or carries credentials. `private_address_blocked`: The base URL configured for this alias, or its token URL, is on a private or reserved address this server may not reach. `all_filters_dropped`: The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `upstream_not_found`: An uncaught BrAPI data request answered HTTP 404. `upstream_rate_limited`: An uncaught BrAPI data request exhausted retries after HTTP 429. `missing_find_route`: Neither the GET list nor a usable POST search route is advertised. `search_endpoint_disabled`: Only a POST search route marked unusable by the active dialect is advertised. `unknown_alias`: No connection is registered under the requested alias, and the server has no base URL configured for it to connect on first use. `auth_token_exchange_failed`: Connecting the alias on first use, the SGN or OAuth token exchange against the BrAPI /token endpoint failed. `auth_no_access_token`: Connecting the alias on first use, the token endpoint answered without returning an access token. `capability_discovery_unavailable`: Neither /serverinfo nor /calls listed any call, and at least one of them timed out, was unreachable, or answered 429 or a 5xx other than 501, so nothing was cached. `upstream_unauthorized`: The BrAPI server answered HTTP 401: it requires credentials, or rejected the ones sent. `upstream_forbidden`: The BrAPI server answered HTTP 403: the credentials sent, or their absence, lack access. `alias_base_url_invalid`: The base URL configured on the server for this alias is not an absolute http(s) URL, or carries credentials. `private_address_blocked`: The base URL configured for this alias, or its token URL, is on a private or reserved address this server may not reach. `all_filters_dropped`: The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "unknown_alias",
-  "auth_token_exchange_failed",
-  "auth_no_access_token",
-  "capability_discovery_unavailable",
-  "upstream_unauthorized",
-  "upstream_forbidden",
-  "alias_base_url_invalid",
-  "private_address_blocked",
-  "all_filters_dropped"
-]New value: +[
+  "upstream_not_found",
+  "upstream_rate_limited",
+  "missing_find_route",
+  "search_endpoint_disabled",
+  "unknown_alias",
+  "auth_token_exchange_failed",
+  "auth_no_access_token",
+  "capability_discovery_unavailable",
+  "upstream_unauthorized",
+  "upstream_forbidden",
+  "alias_base_url_invalid",
+  "private_address_blocked",
+  "all_filters_dropped"
+]

Previous value: -"Filter map sent upstream (named filters plus extraFilters)."New value: +"Upstream filter map, or separate upstreamRequests and clientSide criteria for embedded-unit collection."

Previous value: -"Total rows reported by the server, else the rows scanned."New value: +"Upstream observation total, or the matched observations collected on the embedded-unit route; warnings disclose incomplete scans."

Previous value: -"Connection alias registered via brapi_connect. Omit to read the connection registered under alias `default` — i.e. a prior brapi_connect call that did not specify an alias. Calls that used a non-default alias must pass that same alias here."New value: +"Connection alias. Omit to use alias `default`. An alias registered via brapi_connect works, and so does one the server has a URL configured for (a built-in alias, an operator-configured alias, or `default` on a deployment with a default server), which connects on first use. Calls that used a non-default alias must pass that same alias here."

Added value: +"\\S"

Previous value: -"Cap on rows returned inline. Omit for the deployment default. Rows beyond the cap land in a dataframe; query with brapi_dataframe_query (SQL) instead of paging row-by-row."New value: +"Cap on rows returned inline in results[]. Omit for the deployment default. results[] also stops at a 24,000-byte budget, whichever bound comes first, and keeps at least one row when any matched. When results[] holds fewer rows than matched, the matched rows are staged in a dataframe (marked truncated if the upstream walk stopped short); query it with brapi_dataframe_query (SQL) instead of paging row-by-row."

Added value: +"\\S"

Added value: +"\\S"

Added value: +"\\S"

Added value: +"\\S"

Added value: +"\\S"

Added value: +"\\S"

Added value: +"\\S"

Added value: +"\\S"

Added value: +"\\S"

Added value: +"\\S"

Previous value: -"Alias of the registered BrAPI connection the call used."New value: +"Connection alias the call used."

Previous value: -"The final filter map sent to the server (named + extraFilters)."New value: +"Filter map sent upstream (named filters plus extraFilters)."

Added value: +{
+  "description": "The effective loadLimit when truncated; shown is below it when the 24,000-byte inline budget bound first (notice says which).",
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}

Previous value: -"Dataframe handle when the full result set was materialized as a dataframe. Query it with brapi_dataframe_query (SQL)."New value: +"The matched rows, staged as a dataframe when results[] holds fewer."

Previous value: -"Maps a sanitized column name back to its original upstream key, for columns renamed to clear the SQL-safe-identifier gate (e.g. `end` → `end_`). Present only when a column was renamed — write SQL against the sanitized (left-hand) names."New value: +"Sanitized column name → original upstream key, present only when a column was renamed to be SQL-safe (e.g. `end` → `end_`). SQL uses the sanitized names."

Previous value: -"Full column list of the dataframe."New value: +"Every column name."

Previous value: -"Column name from the materialized rows."New value: +"Column name."

Previous value: -"ISO 8601 timestamp the dataframe was created."New value: +"ISO 8601 creation time."

Previous value: -"ISO 8601 timestamp after which the dataframe metadata will be purged. Re-run the find_* tool to refresh, or copy results out before expiry."New value: +"ISO 8601 time the dataframe metadata is purged; copy rows out before, or re-run the producing tool."

Previous value: -"Cap that was applied at create time, when truncation occurred."New value: +"Row cap that ended the pull, present only when that cap fired."

Previous value: -"Number of rows materialized in the dataframe."New value: +"Rows in the dataframe."

Previous value: -"Dataframe name. Use with brapi_dataframe_describe (schema + provenance) and brapi_dataframe_query (SQL)."New value: +"Table name for brapi_dataframe_describe and brapi_dataframe_query."

Previous value: -"Total rows reported by the upstream server (may exceed rowCount when truncated)."New value: +"Upstream-reported row total, when known; can exceed rowCount."

Previous value: -"True when the dataframe hit a row cap before exhausting upstream."New value: +"True when the dataframe holds less than the upstream reports: a cap, failed page, deadline, or short upstream ended the pull, or it was skipped. warnings says which. Absent otherwise."

Previous value: -"Value frequency per field across the full result set."New value: +"Value frequency per field across every matched row fetched."

Previous value: -"Machine-readable failure mode. Declared by this tool: `unknown_alias`: No connection has been registered under the requested alias. `all_filters_dropped`: The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `unknown_alias`: No connection is registered under the requested alias, and the server has no base URL configured for it to connect on first use. `auth_token_exchange_failed`: Connecting the alias on first use, the SGN or OAuth token exchange against the BrAPI /token endpoint failed. `auth_no_access_token`: Connecting the alias on first use, the token endpoint answered without returning an access token. `capability_discovery_unavailable`: Neither /serverinfo nor /calls listed any call, and at least one of them timed out, was unreachable, or answered 429 or a 5xx other than 501, so nothing was cached. `upstream_unauthorized`: The BrAPI server answered HTTP 401: it requires credentials, or rejected the ones sent. `upstream_forbidden`: The BrAPI server answered HTTP 403: the credentials sent, or their absence, lack access. `alias_base_url_invalid`: The base URL configured on the server for this alias is not an absolute http(s) URL, or carries credentials. `private_address_blocked`: The base URL configured for this alias, or its token URL, is on a private or reserved address this server may not reach. `all_filters_dropped`: The active dialect dropped every filter the agent supplied — the upstream server does not honor any of the requested scope filters on this endpoint, so the call would silently widen to the unfiltered baseline. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "unknown_alias",
-  "all_filters_dropped"
-]New value: +[
+  "unknown_alias",
+  "auth_token_exchange_failed",
+  "auth_no_access_token",
+  "capability_discovery_unavailable",
+  "upstream_unauthorized",
+  "upstream_forbidden",
+  "alias_base_url_invalid",
+  "private_address_blocked",
+  "all_filters_dropped"
+]

Previous value: -"Guidance when no rows were returned — how to broaden filters or retry."New value: +"Why results[] is empty, or which bound cut it short and the dataframe holding the matched rows."

Previous value: -"Suggested next-step query refinement when the result set is large."New value: +"Suggested refinement when the result set is large."

Previous value: -"Observation rows returned in-context (up to loadLimit)."New value: +"Leading matched observation rows, up to loadLimit and a 24,000-byte budget, whichever binds first."

Previous value: -[
-  {
-    "description": "Season identifier as a flat string (older BrAPI servers).",
-    "type": "string"
-  },
-  {
-    "additionalProperties": {},
-    "description": "Structured season block per BrAPI v2.1 — may carry seasonDbId, year, season, or seasonName. Fields vary by server; all pass through and are collapsed into a single label by format().",
-    "properties": {},
-    "type": "object"
-  },
-  {
-    "description": "Field present but null on the upstream.",
-    "type": "null"
-  }
-]New value: +[
+  {
+    "description": "Season identifier as a flat string (older BrAPI servers).",
+    "type": "string"
+  },
+  {
+    "additionalProperties": {},
+    "description": "BrAPI v2.1 season object — seasonDbId, year, season, or seasonName; fields vary by server.",
+    "properties": {},
+    "type": "object"
+  },
+  {
+    "description": "Field present but null on the upstream.",
+    "type": "null"
+  }
+]

Previous value: -"Season — either a flat string or a structured object depending on the server. format() normalizes both into a single label."New value: +"Season as a flat string or a structured object, depending on the server."

Added value: +{
+  "description": "Length of results[] when truncated.",
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}

Previous value: -"Total rows reported by the server."New value: +"Total rows reported by the server, else the rows scanned."

Added value: +{
+  "description": "True when results[] holds fewer rows than matched because loadLimit or the inline byte budget bound.",
+  "type": "boolean"
+}