Skip to content

Document default step outputs for composite tools#498

Merged
yrobla merged 2 commits into
mainfrom
issue-489
Feb 4, 2026
Merged

Document default step outputs for composite tools#498
yrobla merged 2 commits into
mainfrom
issue-489

Conversation

@yrobla
Copy link
Copy Markdown
Contributor

@yrobla yrobla commented Feb 2, 2026

Description

Add comprehensive documentation for the defaultResults field in Virtual MCP Server
composite tools. This field provides fallback values when workflow steps are skipped due to
conditional logic (condition: false) or continue-on-error behavior (onError.action: continue).

The new "Default step outputs" section covers:

  • When defaultResults are required (all three conditions explained)
  • Configuration syntax with examples for both conditional steps and continue-on-error
    scenarios
  • Validation behavior and error messages users will encounter
  • Cross-references from "Steps" and "Error handling" sections to help users discover the
    feature when they need it

Also fixed pre-existing markdownlint errors (heading style and JSX comment syntax).

Type of change

  • Documentation update

Related issues/PRs

Resolves: #489

Screenshots

None needed (text documentation only).

Submitter checklist

Content and formatting

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

Navigation

Not applicable - updated existing page, no new pages added or navigation changes.

Copilot AI review requested due to automatic review settings February 2, 2026 10:01
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 2, 2026

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

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview, Comment Feb 3, 2026 4:03pm

Request Review

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR adds comprehensive documentation for the defaultResults field in Virtual MCP Server composite tools. The defaultResults field provides fallback values when workflow steps are skipped due to conditional logic or continue-on-error behavior, addressing a critical gap in the documentation (issue #489).

Changes:

  • Added a new "Default step outputs" section with detailed explanations, examples, and validation behavior
  • Added cross-reference tips in the "Steps" and "Error handling" sections to help users discover the feature
  • Fixed pre-existing markdownlint errors (heading style and JSX comment syntax)

Comment thread docs/toolhive/guides-vmcp/composite-tools.mdx Outdated
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

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

Comment thread docs/toolhive/guides-vmcp/composite-tools.mdx Outdated
Copy link
Copy Markdown
Collaborator

@danbarr danbarr left a comment

Choose a reason for hiding this comment

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

Some minor style/consistency notes but overall LGTM.

I reviewed from a style POV, but I'm not able to adequately review the technical accuracy. Will leave that to others.

Comment thread docs/toolhive/guides-vmcp/composite-tools.mdx Outdated
Comment thread docs/toolhive/guides-vmcp/composite-tools.mdx Outdated
Comment thread docs/toolhive/guides-vmcp/composite-tools.mdx Outdated
Copy link
Copy Markdown
Contributor

@jerm-dro jerm-dro left a comment

Choose a reason for hiding this comment

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

One minor nit, but the content looks great to me

Comment thread docs/toolhive/guides-vmcp/composite-tools.mdx Outdated
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.

Comment thread docs/toolhive/guides-vmcp/composite-tools.mdx
Comment thread docs/toolhive/guides-vmcp/composite-tools.mdx Outdated
Add comprehensive documentation for the defaultResults field in Virtual
MCP Server composite tools. This feature provides fallback values when
workflow steps are skipped due to conditional logic or continue-on-error
behavior.

Changes:
  - Add "Default step outputs" section to composite tools guide
  - Document when defaultResults are required (conditional steps and
    onError.action: continue)
  - Include configuration examples for both use cases
  - Document validation behavior and error messages
  - Add cross-references from "Steps" and "Error handling" sections to
    help users discover the feature
  - Fix pre-existing markdownlint errors (heading style, JSX comment)

Resolves: #489
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

@yrobla yrobla merged commit d27430c into main Feb 4, 2026
5 checks passed
@yrobla yrobla deleted the issue-489 branch February 4, 2026 07:27
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.

[Gap]: Document default step outputs for composite tools

4 participants