Skip to content

Update stacklok/toolhive to v0.42.1 (Codex) - #1098

Merged
danbarr merged 5 commits into
mainfrom
codex/update-docs-for-toolhive-v0421
Aug 14, 2026
Merged

Update stacklok/toolhive to v0.42.1 (Codex)#1098
danbarr merged 5 commits into
mainfrom
codex/update-docs-for-toolhive-v0421

Conversation

@danbarr

@danbarr danbarr commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator

Description

Codex comparison run for the ToolHive v0.42.1 release-docs workflow. This branch includes the version pin and refreshed reference assets, source-verified documentation updates, and a separate editorial review pass.

Type of change

  • Documentation update

Related issues/PRs

Submitter checklist

Content and formatting

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Reviewer checklist

Content

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Docs update for toolhive v0.42.1

At a glance

Upstream stacklok/toolhive v0.42.0v0.42.1
Hand-written changes 2 commit(s)
Reference assets refreshed (separate commit)
Gaps 0
Release contributors not auto-assigned for this comparison run
Action required Spot-check Codex-authored prose for accuracy

Summary of changes

  • Updated vMCP tool visibility and direct-call behavior in docs/toolhive/guides-vmcp/tool-aggregation.mdx and docs/toolhive/guides-vmcp/local-cli.mdx.
  • Updated composite tool annotations in docs/toolhive/guides-vmcp/composite-tools.mdx.
  • Updated vMCP session recovery behavior in docs/toolhive/guides-vmcp/failure-handling.mdx.
  • Updated OIDC URL validation and Cedar request requirements in docs/toolhive/guides-k8s/auth-k8s.mdx and docs/toolhive/concepts/cedar-policies.mdx.
  • Updated skill and AI tool plugin path, upgrade, and timeout behavior in docs/toolhive/guides-cli/skills-management.mdx and docs/toolhive/guides-cli/ai-plugins.mdx.
How this PR was built

Two Codex sessions were used for this comparison: a generation pass
(upstream-release-docs skill, 6 phases) followed by a separate editorial
review pass (docs-review). Prettier and ESLint auto-fixes were applied after.

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

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

No gaps requiring human context were identified.

Copilot AI lite review requested due to automatic review settings August 13, 2026 18:29
@vercel

vercel Bot commented Aug 13, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview Aug 13, 2026 7:41pm

Request Review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates the docs website to match ToolHive v0.42.1, including refreshed generated reference assets plus source-verified edits to vMCP, Kubernetes auth/OIDC, Cedar authz, and CLI skill/plugin documentation.

Changes:

  • Sync v0.42.1 reference assets (OpenAPI + CRD schemas + CLI reference).
  • Document vMCP tool visibility/direct-call behavior, composite tool annotations, and session recovery semantics.
  • Document OIDC URL validation requirements and Cedar’s JSON POST requirement; clarify skill/plugin project-root and timeout/upgrade behaviors.

Reviewed changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
.github/upstream-projects.yaml Bumps upstream ToolHive pin to v0.42.1.
docs/toolhive/guides-vmcp/tool-aggregation.mdx Updates tool aggregation/visibility docs; adds opt-in model via defaultToolVisibility.
docs/toolhive/guides-vmcp/local-cli.mdx Aligns local CLI examples/behavior with updated aggregation visibility and opt-in guidance.
docs/toolhive/guides-vmcp/failure-handling.mdx Documents backend selection behavior for new sessions and recovery monitoring.
docs/toolhive/guides-vmcp/composite-tools.mdx Adds composite tool annotation guidance and clarifies examples.
docs/toolhive/guides-k8s/auth-k8s.mdx Adds OIDC issuer/JWKS URL validation rules and upgrade impact notes.
docs/toolhive/concepts/cedar-policies.mdx Documents JSON Content-Type requirement for Cedar-authorized MCP POST requests.
docs/toolhive/guides-cli/skills-management.mdx Clarifies project-root usage, adds skill upgrade + timeout troubleshooting guidance.
docs/toolhive/guides-cli/ai-plugins.mdx Clarifies project-root usage and adds timeout troubleshooting guidance.
docs/toolhive/reference/cli/thv_skill_upgrade.md Syncs CLI reference text for thv skill upgrade flag semantics.
static/api-specs/toolhive-api.yaml Updates API spec to include trusted issuer token-exchange config schema.
static/api-specs/toolhive-crds/mcpoidcconfigs.schema.json Updates CRD schema docs for insecureAllowHTTP to cover issuer + JWKS URLs.
static/api-specs/toolhive-crds/virtualmcpservers.schema.json Updates vMCP CRD schema docs for default tool visibility and annotation semantics.
static/api-specs/toolhive-crds/virtualmcpcompositetooldefinitions.schema.json Adds composite tool annotations schema docs.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/toolhive/guides-vmcp/tool-aggregation.mdx
@danbarr
danbarr merged commit 3085d51 into main Aug 14, 2026
5 checks passed
@danbarr
danbarr deleted the codex/update-docs-for-toolhive-v0421 branch August 14, 2026 15:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants