Skip to content

Update stacklok/toolhive to v0.27.1#861

Open
renovate[bot] wants to merge 4 commits into
mainfrom
renovate/stacklok-toolhive-0.x
Open

Update stacklok/toolhive to v0.27.1#861
renovate[bot] wants to merge 4 commits into
mainfrom
renovate/stacklok-toolhive-0.x

Conversation

@renovate
Copy link
Copy Markdown
Contributor

@renovate renovate Bot commented May 11, 2026

This PR contains the following updates:

Package Update Change
stacklok/toolhive minor v0.26.1v0.27.1

After this PR opens, .github/workflows/upstream-release-docs.yml adds source-verified content edits for the new release. For stacklok/toolhive, the same workflow also syncs reference assets (CLI help, Swagger) and regenerates the CRD MDX pages.


Release Notes

stacklok/toolhive (stacklok/toolhive)

v0.27.1

Compare Source

What's Changed

New Contributors

Full Changelog: stacklok/toolhive@v0.27.0...v0.27.1

v0.27.0

Compare Source

What's Changed

New Contributors

Full Changelog: stacklok/toolhive@v0.26.1...v0.27.0


Configuration

📅 Schedule: (in timezone America/New_York)

  • Branch creation
    • At any time (no schedule defined)
  • Automerge
    • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Never, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.


Docs update for toolhive v0.27.1

At a glance

Upstream stacklok/toolhive v0.26.1v0.27.1
Hand-written changes 2 commit(s)
Reference assets refreshed (separate commit)
Gaps 0
Release contributors 4 auto-assigned · 10 mentioned below
Action required Spot-check skill-authored prose for accuracy

Summary of changes

Summary of changes

  • Added intro override for the new MCPWebhookConfig CRD in
    scripts/lib/crd-intros.mjs and updated
    docs/toolhive/reference/crds/mcpwebhookconfig.mdx plus the CRD landing
    DocCard so the new resource has a useful description and cross-link to the
    CLI webhook guide.
  • Updated docs/toolhive/guides-cli/webhooks.mdx to point Kubernetes users at
    the new MCPWebhookConfig resource (admonition + Related information link).
  • Updated docs/toolhive/guides-cli/api-server.mdx to document Windows
    named-pipe support on thv serve --socket (\\.\pipe\ addresses), in
    addition to the existing UNIX socket path.
  • Updated docs/toolhive/guides-cli/run-mcp-servers.mdx to describe CIMD as
    the preferred OAuth client-registration mechanism for thv run, with DCR as
    the fallback. Also corrected the "Resource indicator (RFC 8707)" subsection
    to reflect the new behavior: the indicator is no longer auto-derived from
    the server URL by default.
  • Swept MCPGroup "Ready" wording to the renamed Checked column /
    MCPServersChecked condition across guides-vmcp/quickstart.mdx,
    configuration.mdx, and backend-discovery.mdx (printer column renamed in
    toolhive v0.27.1).
  • Expanded the embedded auth server storage docs in
    guides-k8s/auth-k8s.mdx and guides-k8s/redis-session-storage.mdx to
    cover the new standalone Redis (addr) and Redis Cluster (clusterMode)
    connection modes alongside Sentinel, including the now-optional
    usernameSecretRef for managed tiers without ACL users.

Additional release contributors

Couldn't be auto-assigned as reviewers on this repo, but cc'd below so they see the PR:

@amirejaz @gkatz2 @jhrozek @nalditopr @peppescg @reyortiz3 @samuv @sharanrajt @tgrunnagle @yrobla

Run cost

Session Turns Cost (USD)
Generation 162 $17.4508
Editorial review 67 $5.4112
Total 229 $22.8620
How this PR was built

Two Claude Opus sessions run per release: a generation pass
(upstream-release-docs skill, 6 phases) followed by a fresh-
context editorial pass (docs-review). Prettier/ESLint
auto-fixes are applied after.

Auto-synced paths — do not hand-edit these in review:

  • docs/toolhive/reference/cli/
  • docs/toolhive/reference/crds/
  • static/api-specs/

If a "Gaps needing human context" section is present above,
each entry includes a paste-ready Helper prompt for local
Claude
a reviewer can use to resolve the gap.

Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
@renovate renovate Bot added the autogen-docs Pull requests generated by automated release workflows label May 11, 2026
@vercel
Copy link
Copy Markdown

vercel Bot commented May 11, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview, Comment May 11, 2026 1:40pm

Request Review

@github-actions github-actions Bot marked this pull request as draft May 11, 2026 13:11
@claude
Copy link
Copy Markdown
Contributor

claude Bot commented May 11, 2026

Claude finished @renovate[bot]'s task in 19m 44s —— View job


Upstream release docs for toolhive v0.27.1

Pushed bd7888c with the doc edits for v0.27.0 + v0.27.1.

  • Phase 1: Discover release scope
  • Phase 2: Deep-dive into PRs (CIMD, named-pipe, RFC 8707, webhook CRD, primaryUpstreamProvider, DCR config, Redis modes, MCPGroup column)
  • Phase 3: Impact map across CLI, vMCP, K8s, CRD reference
  • Phase 4: Hand-written edits in 10 docs + 1 script
  • Phase 5: Prettier, ESLint, source-verified one inaccuracy (incorrect RFC 9728 claim removed) and applied docs-review polish
  • Phase 6: SUMMARY.md written, commit pushed

What changed

File Change
docs/toolhive/reference/crds/mcpwebhookconfig.mdx + scripts/lib/crd-intros.mjs + docs/toolhive/reference/crds/index.mdx Real intro and DocCard description for the new MCPWebhookConfig CRD; intro override registered so future regen keeps the prose
docs/toolhive/guides-cli/webhooks.mdx Kubernetes-equivalent admonition + Related information link
docs/toolhive/guides-cli/api-server.mdx Windows named-pipe support on --socket
docs/toolhive/guides-cli/run-mcp-servers.mdx CIMD-then-DCR client registration; resource indicator no longer auto-derived
docs/toolhive/guides-vmcp/{quickstart,configuration,backend-discovery}.mdx MCPGroup Ready references swept to Checked column / MCPServersChecked condition
docs/toolhive/guides-k8s/auth-k8s.mdx + docs/toolhive/guides-k8s/redis-session-storage.mdx Standalone Redis (addr) and Redis Cluster (clusterMode: true) modes for embedded auth server storage; optional usernameSecretRef for managed tiers without ACL

Not done (deferred or N/A)

  • thv llm command surface published (#5189): auto-generated CLI reference is updated, but no concept page for the LLM gateway feature exists yet - that's a larger doc effort outside this release's scope.
  • primaryUpstreamProvider (#5199) and DCR config (#5069) on VirtualMCPServer: schema reference picks these up automatically. Worth a separate authoring pass to add narrative coverage in guides-vmcp/authentication.mdx, but not blocking.
  • Webhook security hardening (#5191, #5192): runtime invariants behind existing webhook docs; no user-facing config changes.
  • Local Docusaurus build: can't complete in this sandbox (the MCP metadata plugin shells out to thv, which isn't installed). Vercel build will validate.

reyortiz3
reyortiz3 previously approved these changes May 11, 2026
- Intro/cross-links for new MCPWebhookConfig CRD
- Windows named-pipe support on thv serve --socket
- CIMD client registration and corrected RFC 8707 default
- MCPGroup printer column rename (Ready -> Checked)
- Standalone Redis and Redis Cluster auth server storage

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@claude
Copy link
Copy Markdown
Contributor

claude Bot commented May 11, 2026

Claude finished @renovate[bot]'s task in 7m 4s —— View job


Editorial review for toolhive v0.27.1 doc updates

Pushed 4bd3596 with editorial polish on top of the prior release commit.

  • Reviewed all hand-edited files (eight .mdx guides under guides-cli/, guides-k8s/, guides-vmcp/)
  • Verified factual claims against upstream PRs #5085, #5153, #4994, #5201, #5204, #5241
  • Applied fixes, ran prettier:fix + eslint, pushed

Summary

The release commit is accurate and well-aligned with upstream. Found a few small clarity/style issues worth fixing; no factual corrections needed.

Primary issues addressed

  1. CIMD singular/plural in guides-cli/run-mcp-servers.mdx:690 - "Client ID Metadata Documents (CIMD)" → "Client ID Metadata Document (CIMD)". The RFC and the upstream PR title/body consistently use the singular form, and CIMD as an acronym expands to the singular.

  2. Internal contradiction in CIMD intro in guides-cli/run-mcp-servers.mdx:687 - the lead-in said "ToolHive registers itself with the authorization server using one of two mechanisms," but the very next bullet says CIMD requires "no registration round-trip." Changed to "identifies itself to" so the umbrella verb is neutral across both mechanisms.

  3. HA acronym not expanded on first use in guides-k8s/auth-k8s.mdx:655 - expanded to "Sentinel-based high availability (HA)" per the style guide's "Expand acronyms on first use" rule.

  4. Passive voice and inconsistency in guides-k8s/auth-k8s.mdx:652-653 - "Three connection modes are supported, and exactly one must be set" rewritten in active voice and aligned with the parallel sentence in redis-session-storage.mdx: "The redis block supports three connection modes; you must set exactly one."

  5. Inconsistent code-title casing in guides-k8s/auth-k8s.mdx:680 - "storage block for MCPExternalAuthConfig - standalone""...- Standalone" to match the Sentinel and Cluster peers (and the bullet labels above).

Other observations (not changed)

  • The guides-k8s/redis-session-storage.mdx page uses GCP Memorystore as "Basic/Standard" in one bullet and "Basic/Standard HA" in another. Both forms appear in the upstream PR and are not factually wrong (GCP's Standard tier offers HA by default). Left as-is - changing would be unjustified rewording.
  • guides-cli/webhooks.mdx Kubernetes-equivalent note correctly references spec.webhookConfigRef (verified against mcpservers.schema.json).
  • vMCP guides' MCPGroup "Checked" column / MCPServersChecked condition wording matches the upstream printer-column definition in cmd/thv-operator/api/v1beta1/mcpgroup_types.go.
  • Branch

- Use singular "Client ID Metadata Document (CIMD)" to match RFC and PR #5085.
- Replace "registers itself" with "identifies itself to" so the lead-in does
  not contradict the CIMD bullet's "no registration round-trip" claim.
- Expand "HA" on first use in auth-k8s.mdx; flip the passive lead-in to
  active and parallel the redis-session-storage page.
- Capitalize "Standalone" in the storage-block code title to match its
  Sentinel and Cluster peers.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@github-actions github-actions Bot requested review from ChrisJBurns and JAORMX May 11, 2026 13:39
@github-actions github-actions Bot requested a review from danbarr May 11, 2026 13:40
@github-actions github-actions Bot marked this pull request as ready for review May 11, 2026 13:40
@danbarr danbarr requested review from amirejaz, jhrozek, peppescg, samuv, tgrunnagle and yrobla and removed request for danbarr May 11, 2026 13:47
Copy link
Copy Markdown
Contributor

@samuv samuv left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pipe in windows socket is there 💪🏼

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

autogen-docs Pull requests generated by automated release workflows

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants