RagLeap
ragleap-integrations · release notes

ragleap-integrations v0.5.0

ragleap-integrations 0.5.0 (published to PyPI on 2026-11-11)

Two owner-controlled additions to the UTCP client, and one fix. Install: pip install ragleap-integrations==0.5.0 (optional extra: security). This text follows the CHANGELOG shipped with the release and adds the checks made after publishing.

Added

  • allowed_query on UtcpServerConfig and connect_utcp: the owner lists the static query parameter names a tool URL may carry (at most 8 names, each 1 to 32 of letters, digits, underscore, dot and hyphen, all distinct; anything else raises UtcpConfigError). Default empty: exactly the 0.4.0 behavior. Each pair in the URL must be name=value with a value of 1 to 64 of letters, digits, underscore, dot and hyphen; a repeated name, a name that is also an input property and any placeholder are refused. UtcpToolSpec.static_query keeps the pairs; they are sent first, then the arguments. An argument with the same name as a static parameter is refused at call time and nothing is sent.
  • One accepted auth shape: auth_type api_key, location header, var_name Authorization, api_key exactly Bearer followed by a ${NAME} placeholder, and no other key. It is accepted only because it describes what this client already does: the owner token as Authorization: Bearer to approved origins. NAME is never looked up, in the environment or anywhere. Without a token the tool is skipped (the template declares auth but no token is configured; hint: pass token). Any other auth block, and auth_tools, are skipped as in 0.4.0. A query parameter the owner did not allow gets the hint: list the name in allowed_query.
  • scripts/utcp_live.py (repository only): new option --allowed-query, and its description now says it makes two GET requests, not one. Design note docs/design/utcp-auth.md: the decisions and two corrections to the note were added.

Fixed

  • A tool URL ending in a bare question mark was accepted by 0.4.0 and a call went out with two question marks. It is now skipped (url has a query string or a fragment).

Verified

  • 626 tests (the 545 of 0.4.0 unchanged plus 81 new): 622 passed and 4 skipped without ragleap-security, 626 passed with it, on Python 3.10.12 in clean virtual environments. 48 of 52 deliberate breaks of the new code caught; the other 4 are equivalent mutants (another check on the same path gives the identical outcome). A first round of breaks found one real test gap, now closed.
  • After release (2026-11-11): the wheel and the sdist on PyPI have the same sha256 as on TestPyPI; a plain pip install fetches that wheel; the installed files equal the source; pip check is clean with and without the extra; a smoke test passes; the sdist tests pass against the installed wheel (Python 3.10.12: 622 passed and 4 skipped, or 626 passed with the extra). The sdist contains a copy of the repository .gitignore, added by the build tool and byte-identical to the repository one at the merge.

Verified after 0.4.0 (recorded here because published files cannot be edited)

  • 2026-11-07 15:39 UTC: the public manual at https://api.unified.to/utcp was read (HTTP 200, 33 tools, all http); 0.4.0 offered none of the 20 tried because every template declares auth. 2026-11-08 13:05 UTC: 35 tools with one uniform shape (POST, the auth block above, a format query, body_field arguments). 2026-11-09 03:19 UTC: 37 tools, each input schema one required object property named arguments. Counts and shapes only: no credential and no tool call.
  • Correction: the 0.4.0 notes said no public server with a current-format manual was found. That became wrong on 2026-11-07: one was found.

Not verified

  • Any tool call against a real UTCP server (discovery only was observed). The normative UTCP specification text. Whether a vendor returns the same manual when a bearer token is sent.

Known limitations

  • Not supported: other auth types (basic, OAuth2, other api_key shapes), header_fields, OpenAPI conversion, variable substitution and a multi-tenant UTCP hub. Tools whose input schema is larger than max_schema_chars are still skipped.

Release date note

  • The CHANGELOG heading says 2026-11-11 and the files reached TestPyPI and PyPI on 2026-11-11 (UTC).
View on GitHub Package page All releases
← v0.4.0

Release notes mirrored from GitHub Releases.