Skip to content

Clarify executeTool input and schema values - #279

Open
mlmrx wants to merge 1 commit into
webmachinelearning:mainfrom
mlmrx:ml/clarify-executetool-values
Open

Clarify executeTool input and schema values#279
mlmrx wants to merge 1 commit into
webmachinelearning:mainfrom
mlmrx:ml/clarify-executetool-values

Conversation

@mlmrx

@mlmrx mlmrx commented Sep 1, 2026

Copy link
Copy Markdown

Summary

  • clarify that executeTool() takes a RegisteredTool returned by getTools()
  • clarify that RegisteredTool.inputSchema is exposed as a parsed JavaScript object
  • clarify that callers pass the structured JavaScript input value directly rather than pre-serializing it with JSON.stringify()
  • add a focused discovery-and-execution example to the API introduction

This documents the contract already defined by the RegisteredTool dictionary and the
executeTool() serialization algorithm. An implementation that exposes inputSchema as a string or
requires pre-serialized JSON arguments does not match the current draft.

Closes #278.

Validation

  • W3C spec-generator: Bikeshed processing with die-on=warning
  • git diff --check

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.

Clarify executeTool argument encoding and returned schema shape

1 participant