Summary
The declarative API explainer places natural-language tool metadata in the
tooldescription and toolparamdescription HTML attributes, then turns those values into a tool
description and JSON Schema property descriptions. The current proposal does not define how the
language or base direction of those strings is determined or preserved during that conversion.
This is the declarative-markup part of #153, identified while reviewing the checklist in #273.
Current text
Internationalization concern
W3C's Internationalization Best Practices for Spec Developers says that:
The current explainer does not say:
- whether these new attributes are translatable;
- whether their values use the form control's inherited HTML
lang and dir/auto context; or
- how that context is carried into the synthesized tool definition and JSON Schema instead of
being reduced to an unlabelled string.
This matters even when a description is primarily agent-facing: property descriptions and other
schema annotations may be surfaced in confirmation or native UI, and the tool title is explicitly
defined for user interfaces.
Resolution criteria
Before defining the declarative synthesis algorithm in #210, decide whether to:
- represent descriptions as element content (allowing ordinary HTML
lang, dir, and inline
markup), or
- keep attributes but normatively define their translation, language, and direction behavior and
preserve that metadata in the synthesized representation.
The solution should also state how authors provide localized alternatives, or explicitly defer that
part to the resolution of #153.
Maintainers: please apply the i18n-tracker label so the Internationalization WG is notified, as
requested by #273. I cannot apply repository labels with my current permissions.
Summary
The declarative API explainer places natural-language tool metadata in the
tooldescriptionandtoolparamdescriptionHTML attributes, then turns those values into a tooldescription and JSON Schema property descriptions. The current proposal does not define how the
language or base direction of those strings is determined or preserved during that conversion.
This is the declarative-markup part of #153, identified while reviewing the checklist in #273.
Current text
tooldescriptionis analogous toModelContextTool.description.toolparamdescriptionbecomes a JSON Schemadescription.Internationalization concern
W3C's Internationalization Best Practices for Spec Developers says that:
The current explainer does not say:
langanddir/autocontext; orbeing reduced to an unlabelled string.
This matters even when a description is primarily agent-facing: property descriptions and other
schema annotations may be surfaced in confirmation or native UI, and the tool
titleis explicitlydefined for user interfaces.
Resolution criteria
Before defining the declarative synthesis algorithm in #210, decide whether to:
lang,dir, and inlinemarkup), or
preserve that metadata in the synthesized representation.
The solution should also state how authors provide localized alternatives, or explicitly defer that
part to the resolution of #153.
Maintainers: please apply the
i18n-trackerlabel so the Internationalization WG is notified, asrequested by #273. I cannot apply repository labels with my current permissions.