Skip to content

Add non-normative soft maximum field length guidance - #386

Open
jpagnucco wants to merge 1 commit into
webmachinelearning:mainfrom
jpagnucco:soft-max-field-lengths
Open

jpagnucco wants to merge 1 commit into
webmachinelearning:mainfrom
jpagnucco:soft-max-field-lengths

Conversation

@jpagnucco

@jpagnucco jpagnucco commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

Adds non-normative soft maximum field length guidance to the Security and Privacy Considerations section (#mitigation-restrict-input-lengths) of index.bs, and aligns the field list in #metadata-description-attacks to include title, inputSchema, and outputSchema.

Summary of Changes

  • Expands #mitigation-restrict-input-lengths with a recommended soft-maximums table measured in Unicode code points across ModelContextTool.title, ModelContextTool.description, ModelContextTool.inputSchema, and ModelContextTool.outputSchema:
    • title, schema identifiers (property names, $defs / definitions keys), schema title fields: 128 code points (matching the normative name maximum of 128 ASCII code points)
    • description: 750 code points
    • Schema description fields: 500 code points
    • Schema enum values: 128 code points per value; 1,000 code points combined per parameter
    • Other schema string literals (const, string default, examples entries, pattern values): 128 code points per value
  • Documents interoperability expectations for site authors and agents (subject to aggregate tool/schema budgets), guidance on handling oversized fields (reject vs. truncate), and schema hygiene ($comment, custom x-* keywords) and aggregate limits.
  • Updates #metadata-description-attacks to reference name, title, description, inputSchema, and outputSchema.
  • Formatted with domfarolino/specfmt to wrap lines to 100 characters.

Addresses #359. Related to #73 and #219.


Preview | Diff

This branch has not been deployed

No deployments
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.

1 participant