Skip to content

Commit e2e256d

Browse files
committed
docs(spec): clarify ui.domain is host-dependent
Update the spec to clarify that: - ui.domain format and validation rules are host-dependent - Servers must consult host-specific documentation for expected format - Common patterns: hash-based subdomains, URL-derived subdomains - Updated examples to reflect realistic host-controlled domains This addresses the gap between the spec's previous implied flexibility (arbitrary domains like weather-widget.example.com) and real-world constraints where hosts must control sandbox domains for security.
1 parent cac214f commit e2e256d

1 file changed

Lines changed: 12 additions & 4 deletions

File tree

specification/draft/apps.mdx

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -195,15 +195,23 @@ interface UIResourceMeta {
195195
clipboardWrite?: {},
196196
},
197197
/**
198-
* Dedicated origin for widget
198+
* Dedicated sandbox origin for widget
199199
*
200200
* Optional domain for the widget's sandbox origin. Useful when widgets need
201-
* dedicated origins for API key allowlists or cross-origin isolation.
201+
* stable, dedicated origins for OAuth callbacks or API key allowlists.
202202
*
203-
* If omitted, Host uses default sandbox origin.
203+
* **Host-dependent:** The format and validation rules for this field are
204+
* determined by each host. Servers MUST consult host-specific documentation
205+
* for the expected domain format. Common patterns include:
206+
* - Hash-based subdomains (e.g., `{hash}.claudemcpcontent.com`)
207+
* - URL-derived subdomains (e.g., `www-example-com.oaiusercontent.com`)
204208
*
209+
* If omitted, Host uses default sandbox origin (typically per-conversation).
210+
*
211+
* @example
212+
* "a904794854a047f6.claudemcpcontent.com"
205213
* @example
206-
* "https://weather-widget.example.com"
214+
* "www-example-com.oaiusercontent.com"
207215
*/
208216
domain?: string,
209217
/**

0 commit comments

Comments
 (0)