fix(spec): align permissions type with SDK implementation

The spec document incorrectly defined permission fields (camera, microphone,
geolocation, clipboardWrite) as boolean types, but the SDK implementation
uses empty object types ({}).

This caused validation errors for MCP servers (like Hex) that followed
the spec and sent boolean values like `clipboardWrite: true`, when the
Zod schema expects `clipboardWrite: {}`.

The empty object design was intentional to allow future extensibility
(e.g., adding options like `{ required: true }`). This commit aligns
the spec documentation with the actual TypeScript types in spec.types.ts.

Fixes validation error:
`{ code: 'invalid_type', expected: 'object', received: 'boolean',
   path: ['permissions', 'clipboardWrite'] }`
This commit is contained in:
Anton Pidkuiko MacBook 2026-01-19 17:26:13 +00:00
commit 8c87715628
No known key found for this signature in database

View file

@ -174,25 +174,25 @@ interface UIResourceMeta {
* *
* Maps to Permission Policy `camera` feature * Maps to Permission Policy `camera` feature
*/ */
camera?: boolean, camera?: {},
/** /**
* Request microphone access * Request microphone access
* *
* Maps to Permission Policy `microphone` feature * Maps to Permission Policy `microphone` feature
*/ */
microphone?: boolean, microphone?: {},
/** /**
* Request geolocation access * Request geolocation access
* *
* Maps to Permission Policy `geolocation` feature * Maps to Permission Policy `geolocation` feature
*/ */
geolocation?: boolean, geolocation?: {},
/** /**
* Request clipboard write access * Request clipboard write access
* *
* Maps to Permission Policy `clipboard-write` feature * Maps to Permission Policy `clipboard-write` feature
*/ */
clipboardWrite?: boolean, clipboardWrite?: {},
}, },
/** /**
* Dedicated origin for widget * Dedicated origin for widget
@ -239,10 +239,10 @@ The resource content is returned via `resources/read`:
baseUriDomains?: string[]; // Allowed base URIs for the document (base-uri directive). baseUriDomains?: string[]; // Allowed base URIs for the document (base-uri directive).
}; };
permissions?: { permissions?: {
camera?: boolean; // Request camera access camera?: {}; // Request camera access
microphone?: boolean; // Request microphone access microphone?: {}; // Request microphone access
geolocation?: boolean; // Request geolocation access geolocation?: {}; // Request geolocation access
clipboardWrite?: boolean; // Request clipboard write access clipboardWrite?: {}; // Request clipboard write access
}; };
domain?: string; domain?: string;
prefersBorder?: boolean; prefersBorder?: boolean;
@ -615,10 +615,10 @@ interface HostCapabilities {
sandbox?: { sandbox?: {
/** Permissions granted by the host (camera, microphone, geolocation, clipboard-write). */ /** Permissions granted by the host (camera, microphone, geolocation, clipboard-write). */
permissions?: { permissions?: {
camera?: boolean; camera?: {};
microphone?: boolean; microphone?: {};
geolocation?: boolean; geolocation?: {};
clipboardWrite?: boolean; clipboardWrite?: {};
}; };
/** CSP domains approved by the host. */ /** CSP domains approved by the host. */
csp?: { csp?: {
@ -1179,10 +1179,10 @@ These messages are reserved for web-based hosts that implement the recommended d
baseUriDomains?: string[], baseUriDomains?: string[],
}, },
permissions?: { // Sandbox permissions from resource metadata permissions?: { // Sandbox permissions from resource metadata
camera?: boolean, camera?: {},
microphone?: boolean, microphone?: {},
geolocation?: boolean, geolocation?: {},
clipboardWrite?: boolean, clipboardWrite?: {},
} }
} }
} }