changedInput schema / properties / alias / description
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."
removedInput schema / properties / path / minLength
Removed value: -1
addedInput schema / properties / path / pattern
Added value: +"\\S"
changedOutput schema / properties / alias / description
Previous value: -"Alias of the registered BrAPI connection the call used."New value: +"Connection alias the call used."
changedOutput schema / properties / dataframe / description
Previous value: -"Present when the upstream advertised more rows than `loadLimit` AND the result is a list shape. The inline `result` is unchanged; the dataframe carries the full union of pages — query with brapi_dataframe_query."New value: +"The pages of a list-shaped result, staged when the upstream advertised more rows than `loadLimit`. The inline `result` is unchanged."
changedOutput schema / properties / dataframe / properties / columnLegend / description
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."
changedOutput schema / properties / dataframe / properties / columns / description
Previous value: -"Full column list of the dataframe."New value: +"Every column name."
changedOutput schema / properties / dataframe / properties / columns / items / description
Previous value: -"Column name from the materialized rows."New value: +"Column name."
changedOutput schema / properties / dataframe / properties / createdAt / description
Previous value: -"ISO 8601 timestamp the dataframe was created."New value: +"ISO 8601 creation time."
changedOutput schema / properties / dataframe / properties / expiresAt / description
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."
changedOutput schema / properties / dataframe / properties / maxRows / description
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."
changedOutput schema / properties / dataframe / properties / rowCount / description
Previous value: -"Number of rows materialized in the dataframe."New value: +"Rows in the dataframe."
changedOutput schema / properties / dataframe / properties / tableName / description
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."
changedOutput schema / properties / dataframe / properties / totalCount / description
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."
changedOutput schema / properties / dataframe / properties / truncated / description
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."
changedOutput schema / properties / error / properties / data / properties / reason / description
Previous value: -"Machine-readable failure mode. Declared by this tool: `unknown_alias`: No connection has been registered under the requested alias. `cross_origin_path`: path argument was a full URL instead of a relative BrAPI route. 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. `cross_origin_path`: path argument was a full URL instead of a relative BrAPI route. Other values are possible when a failure originates below the handler."
changedOutput schema / properties / error / properties / data / properties / reason / examples
Previous value: -[
- "unknown_alias",
- "cross_origin_path"
-]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",
+ "cross_origin_path"
+]
addedOutput schema / properties / notice
Added value: +{
+ "description": "When a dataframe was staged, its name and the tools that read it.",
+ "type": "string"
+}
changedOutput schema / properties / suggestion / description
Previous value: -"Emitted when a curated goal-shaped tool covers this endpoint."New value: +"Emitted when a curated goal-shaped tool covers this endpoint, or takes the IDs it lists."
addedOutput schema / properties / warnings
Added value: +{
+ "description": "Advisory messages — present when the dataframe walk stopped before the upstream total.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+}