@maxhealth.tech/prefab 0.3.18 → 0.3.20

package/dist/core/validate.js

@@ -5,6 +5,7 @@
  * and returns structured error information.
  */
 import { COMPONENT_TYPES } from './component-types.js';
+import { isRecord } from './guards.js';
 // ── Known component types ────────────────────────────────────────────────────
 // Derived from the renderer's registry (see scripts/gen-component-types.ts), not
 // restated here. A hand-maintained copy drifted and rejected four renderable
@@ -21,17 +22,16 @@ const KNOWN_TYPES = new Set(COMPONENT_TYPES);
 export function validateWireFormat(data, opts = {}) {
     const errors = [];
     const strict = opts.strict ?? false;
-    if (data == null || typeof data !== 'object') {
+    if (!isRecord(data)) {
         errors.push({ path: '$', message: 'Wire data must be a non-null object' });
         return { valid: false, errors };
     }
     const obj = data;
-    // $prefab header
-    if (obj.$prefab == null || typeof obj.$prefab !== 'object') {
+    const header = obj.$prefab;
+    if (!isRecord(header)) {
         errors.push({ path: '$.$prefab', message: 'Missing or invalid $prefab header' });
     }
     else {
-        const header = obj.$prefab;
         if (typeof header.version !== 'string') {
             errors.push({ path: '$.$prefab.version', message: 'version must be a string' });
         }
@@ -66,23 +66,25 @@ export function validateWireFormat(data, opts = {}) {
         errors.push({ path: '$.mode', message: 'mode must be "light" or "dark"' });
     }
     // defs (optional)
-    if (obj.defs !== undefined) {
-        if (obj.defs === null || typeof obj.defs !== 'object' || Array.isArray(obj.defs)) {
+    const defs = obj.defs;
+    if (defs !== undefined) {
+        if (!isRecord(defs)) {
             errors.push({ path: '$.defs', message: 'defs must be a plain object' });
         }
         else {
-            for (const [name, def] of Object.entries(obj.defs)) {
+            for (const [name, def] of Object.entries(defs)) {
                 validateComponent(def, `$.defs.${name}`, errors, strict);
             }
         }
     }
     // keyBindings (optional)
-    if (obj.keyBindings !== undefined) {
-        if (obj.keyBindings === null || typeof obj.keyBindings !== 'object' || Array.isArray(obj.keyBindings)) {
+    const keyBindings = obj.keyBindings;
+    if (keyBindings !== undefined) {
+        if (!isRecord(keyBindings)) {
             errors.push({ path: '$.keyBindings', message: 'keyBindings must be a plain object' });
         }
         else {
-            for (const [key, action] of Object.entries(obj.keyBindings)) {
+            for (const [key, action] of Object.entries(keyBindings)) {
                 validateAction(action, `$.keyBindings.${key}`, errors);
             }
         }
@@ -97,7 +99,7 @@ export function isValidWireFormat(data) {
 }
 // ── Internal helpers ─────────────────────────────────────────────────────────
 function validateComponent(node, path, errors, strict) {
-    if (node == null || typeof node !== 'object' || Array.isArray(node)) {
+    if (!isRecord(node)) {
         errors.push({ path, message: 'Component must be a plain object' });
         return;
     }
@@ -158,10 +160,7 @@ function validateComponent(node, path, errors, strict) {
 const COMPONENT_SLOT_KEYS = new Set(['children', 'fallback', 'trigger', 'empty', 'else', 'summary']);
 /** Is the value a component node of a recognized type? */
 function isComponentLike(value) {
-    if (value == null || typeof value !== 'object' || Array.isArray(value))
-        return false;
-    const t = value.type;
-    return typeof t === 'string' && KNOWN_TYPES.has(t);
+    return isRecord(value) && typeof value.type === 'string' && KNOWN_TYPES.has(value.type);
 }
 function validateAction(action, path, errors) {
     if (Array.isArray(action)) {
@@ -170,20 +169,19 @@ function validateAction(action, path, errors) {
         }
         return;
     }
-    if (action == null || typeof action !== 'object') {
+    if (!isRecord(action)) {
         errors.push({ path, message: 'Action must be an object or array of objects' });
         return;
     }
     const act = action;
-    const hasType = typeof act.type === 'string' && act.type.length > 0;
-    const hasAction = typeof act.action === 'string' && act.action.length > 0;
-    if (!hasType && !hasAction) {
+    const name = typeof act.action === 'string' && act.action.length > 0 ? act.action
+        : typeof act.type === 'string' && act.type.length > 0 ? act.type
+            : undefined;
+    if (name === undefined) {
         errors.push({ path: `${path}.type`, message: 'Action must have a non-empty "type" or "action" string' });
         return;
     }
-    // Required-field checks for known actions. showToast without `message` fires an
-    // empty heading (a real bug when authors reach for `title` instead).
-    const name = (hasAction ? act.action : act.type);
+    // showToast without `message` renders an empty toast (authors reach for `title`).
     if (name.toLowerCase() === 'showtoast') {
         if (typeof act.message !== 'string' || act.message.length === 0) {
             errors.push({ path: `${path}.message`, message: 'showToast requires a non-empty "message" string' });
@@ -202,14 +200,13 @@ function validateStringArray(value, path, errors) {
     }
 }
 function validateTheme(theme, errors) {
-    if (theme === null || typeof theme !== 'object' || Array.isArray(theme)) {
+    if (!isRecord(theme)) {
         errors.push({ path: '$.theme', message: 'theme must be a plain object' });
         return;
     }
-    const t = theme;
     for (const mode of ['light', 'dark']) {
-        if (t[mode] !== undefined) {
-            if (t[mode] === null || typeof t[mode] !== 'object' || Array.isArray(t[mode])) {
+        if (theme[mode] !== undefined) {
+            if (!isRecord(theme[mode])) {
                 errors.push({ path: `$.theme.${mode}`, message: `theme.${mode} must be a plain object` });
             }
         }

package/dist/core/validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"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"}

package/dist/core/version.d.ts

@@ -1,24 +1,5 @@
-/**
- * Single source of truth for prefab's version numbers.
- *
- * Zero imports on purpose: the lean renderer bundle (bridge, transport) can pull
- * these in without dragging the builder module graph along.
- */
-/**
- * Package version of `@maxhealth.tech/prefab`. Bumped at release time by
- * `release.yml` (see `scripts/changelog-release.ts` companion step). Identifies
- * the app to an MCP Apps host (`appInfo.version`) and pins the CDN URL.
- */
-export declare const VERSION = "0.3.18";
-/**
- * Wire protocol version emitted in `$prefab.version`.
- *
- * `0.3` matches upstream PrefectHQ/prefab: the theme is folded into the `css`
- * array, `stylesheets` carries external URLs, and `mode` forces a color scheme
- * (PR #431, "Wire Transfer"). The renderer still accepts `0.2` payloads.
- *
- * NOTE: distinct from `VERSION` (the npm package version) and from the MCP Apps
- * dated protocol version (`2026-01-26`, negotiated in the bridge handshake).
- */
+/** Package version, stamped by `release.yml`. Identifies the app to MCP Apps hosts and pins the CDN URL. */
+export declare const VERSION = "0.3.20";
+/** `$prefab.version` of the wire format, matching upstream PrefectHQ/prefab 0.3; the renderer still reads 0.2. */
 export declare const PROTOCOL_VERSION = "0.3";
 //# sourceMappingURL=version.d.ts.map

package/dist/core/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,eAAO,MAAM,OAAO,WAAW,CAAA;AAE/B;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,QAAQ,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,eAAO,MAAM,OAAO,WAAW,CAAA;AAE/B,kHAAkH;AAClH,eAAO,MAAM,gBAAgB,QAAQ,CAAA"}

package/dist/core/version.js

@@ -1,24 +1,5 @@
-/**
- * Single source of truth for prefab's version numbers.
- *
- * Zero imports on purpose: the lean renderer bundle (bridge, transport) can pull
- * these in without dragging the builder module graph along.
- */
-/**
- * Package version of `@maxhealth.tech/prefab`. Bumped at release time by
- * `release.yml` (see `scripts/changelog-release.ts` companion step). Identifies
- * the app to an MCP Apps host (`appInfo.version`) and pins the CDN URL.
- */
-export const VERSION = '0.3.18';
-/**
- * Wire protocol version emitted in `$prefab.version`.
- *
- * `0.3` matches upstream PrefectHQ/prefab: the theme is folded into the `css`
- * array, `stylesheets` carries external URLs, and `mode` forces a color scheme
- * (PR #431, "Wire Transfer"). The renderer still accepts `0.2` payloads.
- *
- * NOTE: distinct from `VERSION` (the npm package version) and from the MCP Apps
- * dated protocol version (`2026-01-26`, negotiated in the bridge handshake).
- */
+/** Package version, stamped by `release.yml`. Identifies the app to MCP Apps hosts and pins the CDN URL. */
+export const VERSION = '0.3.20';
+/** `$prefab.version` of the wire format, matching upstream PrefectHQ/prefab 0.3; the renderer still reads 0.2. */
 export const PROTOCOL_VERSION = '0.3';
 //# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAA;AAE/B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAA"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAA;AAE/B,kHAAkH;AAClH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAA"}

package/dist/mcp/a2ui.d.ts

@@ -1,22 +1,6 @@
 /**
- * Serving A2UI over MCP — the `a2ui://` sibling of `./resource.ts`'s `ui://`.
- *
- * The two delivery models are not variations on one theme:
- *
- *   - **MCP Apps (`ui://`)** ships an HTML document that the host renders in a
- *     sandboxed iframe. prefab's renderer runs inside it and draws the
- *     `$prefab` payload. `registerViewerResource` in `./resource.ts` sets that up.
- *   - **A2UI (`a2ui://`)** ships the UI *description*. No iframe and no
- *     renderer of prefab's: the host's own A2UI renderer draws native widgets
- *     from the component list.
- *
- * A server can offer both from the same tool. The A2UI payload is identified by
- * the `application/a2ui+json` MIME type, either as a standalone resource or as
- * an `EmbeddedResource` inside a tool result, which is what
- * [A2UI over MCP](https://a2ui.org/guides/a2ui_over_mcp/) specifies.
- *
- * The payload itself is the list-wrapper envelope `{ messages: [...] }` rather
- * than a bare array, because a resource body has to be a JSON object.
+ * A2UI over MCP (`a2ui://`): the UI description as `application/a2ui+json`, drawn by the host's own A2UI renderer,
+ * where `ui://` ships prefab's renderer in an iframe. See https://a2ui.org/guides/a2ui_over_mcp/.
  */
 import { PrefabApp } from '../app.js';
 import type { Component } from '../core/component.js';
@@ -31,19 +15,11 @@ export declare function a2uiPayload(messages: A2uiMessage[]): A2uiMessageList;
 export interface DisplayA2uiOptions extends A2uiEmitOptions {
     /** URI stamped on the embedded resource. @default 'a2ui://prefab/surface' */
     uri?: string;
-    /**
-     * Called with anything lost in translation. Without it, a `degraded` or
-     * `unsupported` diagnostic is logged at warn level, because silently shipping
-     * a lesser UI is the failure mode worth making noisy.
-     */
+    /** Called with anything lost in translation; without it, `degraded` and `unsupported` diagnostics are logged as warnings. */
     onDiagnostics?: (diagnostics: A2uiDiagnostic[]) => void;
 }
 /**
- * Return a view as an A2UI tool result.
- *
- * The messages travel as an `EmbeddedResource` in `content`, which is where a
- * host looks for a payload it should route to its A2UI renderer, and as
- * `structuredContent` for hosts that read results structurally.
+ * A view as an A2UI tool result: an `EmbeddedResource` in `content`, and the same payload as `structuredContent`.
  *
  * @example
  * ```ts
@@ -68,14 +44,8 @@ export interface A2uiResourceOptions extends A2uiEmitOptions {
     onDiagnostics?: (diagnostics: A2uiDiagnostic[]) => void;
 }
 /**
- * Register a static A2UI surface as an `a2ui://` resource.
- *
- * Static is the point: a surface that does not depend on the conversation is
- * cheaper as a resource than as a tool, because the host can read it once and
- * cache it. Anything that varies per call belongs in {@link display_a2ui}.
- *
- * `builder` runs on every read rather than once at registration, so a surface
- * that closes over data refreshes without re-registering.
+ * Register an A2UI surface that does not depend on the conversation as an `a2ui://` resource; `builder` runs on every read.
+ * Per-call views belong in {@link display_a2ui}.
  *
  * @example
  * ```ts

package/dist/mcp/a2ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"a2ui.d.ts","sourceRoot":"","sources":["../../src/mcp/a2ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAA0B,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACtH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAIjB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAgB,KAAK,aAAa,EAAuB,MAAM,eAAe,CAAA;AAWrF,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,0BAAiC,CAAA;AAE/D,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,eAAe,CAEpE;AAID,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,CAAA;CACxD;AAaD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,gBAAgB,CAAC,eAAe,CAAC,CAanC;AAID,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,oDAAoD;IACpD,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,CAAA;CACxD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,SAAS,GAAG,SAAS,EACpC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAuCN;AAED,2DAA2D;AAC3D,eAAO,MAAM,WAAW,qBAAe,CAAA"}
+{"version":3,"file":"a2ui.d.ts","sourceRoot":"","sources":["../../src/mcp/a2ui.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAA0B,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACtH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAIjB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAgB,KAAK,aAAa,EAAuB,MAAM,eAAe,CAAA;AAOrF,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,0BAAiC,CAAA;AAE/D,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,eAAe,CAEpE;AAID,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,6HAA6H;IAC7H,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,CAAA;CACxD;AAaD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,gBAAgB,CAAC,eAAe,CAAC,CAanC;AAID,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,oDAAoD;IACpD,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,CAAA;CACxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,SAAS,GAAG,SAAS,EACpC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAuCN;AAED,2DAA2D;AAC3D,eAAO,MAAM,WAAW,qBAAe,CAAA"}

package/dist/mcp/a2ui.js

@@ -1,22 +1,6 @@
 /**
- * Serving A2UI over MCP — the `a2ui://` sibling of `./resource.ts`'s `ui://`.
- *
- * The two delivery models are not variations on one theme:
- *
- *   - **MCP Apps (`ui://`)** ships an HTML document that the host renders in a
- *     sandboxed iframe. prefab's renderer runs inside it and draws the
- *     `$prefab` payload. `registerViewerResource` in `./resource.ts` sets that up.
- *   - **A2UI (`a2ui://`)** ships the UI *description*. No iframe and no
- *     renderer of prefab's: the host's own A2UI renderer draws native widgets
- *     from the component list.
- *
- * A server can offer both from the same tool. The A2UI payload is identified by
- * the `application/a2ui+json` MIME type, either as a standalone resource or as
- * an `EmbeddedResource` inside a tool result, which is what
- * [A2UI over MCP](https://a2ui.org/guides/a2ui_over_mcp/) specifies.
- *
- * The payload itself is the list-wrapper envelope `{ messages: [...] }` rather
- * than a bare array, because a resource body has to be a JSON object.
+ * A2UI over MCP (`a2ui://`): the UI description as `application/a2ui+json`, drawn by the host's own A2UI renderer,
+ * where `ui://` ships prefab's renderer in an iframe. See https://a2ui.org/guides/a2ui_over_mcp/.
  */
 import { PrefabApp } from '../app.js';
 import { createLogger } from '../core/logger.js';
@@ -24,11 +8,7 @@ import { emitA2UI } from '../a2ui/emit.js';
 import { A2UI_MIME, A2UI_SCHEME } from '../a2ui/types.js';
 import { resolveCache } from './resource.js';
 const log = createLogger('a2ui');
-/**
- * An A2UI surface is rebuilt on every read, so it defaults to no caching. That
- * is the opposite of the viewer HTML in `./resource.ts`, which is pinned to the
- * package version and safely shared-cacheable.
- */
+/** A surface is rebuilt on every read, so it is not cached unless the caller says so. */
 const DEFAULT_SURFACE_CACHE = { ttlMs: 0, cacheScope: 'private' };
 /** Default URI for a server that serves a single A2UI surface. */
 export const A2UI_RESOURCE_URI = `${A2UI_SCHEME}prefab/surface`;
@@ -49,11 +29,7 @@ function reportDiagnostics(diagnostics, options) {
     }
 }
 /**
- * Return a view as an A2UI tool result.
- *
- * The messages travel as an `EmbeddedResource` in `content`, which is where a
- * host looks for a payload it should route to its A2UI renderer, and as
- * `structuredContent` for hosts that read results structurally.
+ * A view as an A2UI tool result: an `EmbeddedResource` in `content`, and the same payload as `structuredContent`.
  *
  * @example
  * ```ts
@@ -77,14 +53,8 @@ export function display_a2ui(viewOrApp, options) {
     return { content: [embedded], structuredContent: payload };
 }
 /**
- * Register a static A2UI surface as an `a2ui://` resource.
- *
- * Static is the point: a surface that does not depend on the conversation is
- * cheaper as a resource than as a tool, because the host can read it once and
- * cache it. Anything that varies per call belongs in {@link display_a2ui}.
- *
- * `builder` runs on every read rather than once at registration, so a surface
- * that closes over data refreshes without re-registering.
+ * Register an A2UI surface that does not depend on the conversation as an `a2ui://` resource; `builder` runs on every read.
+ * Per-call views belong in {@link display_a2ui}.
  *
  * @example
  * ```ts

package/dist/mcp/a2ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"a2ui.js","sourceRoot":"","sources":["../../src/mcp/a2ui.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"a2ui.js","sourceRoot":"","sources":["../../src/mcp/a2ui.ts"],"names":[],"mappings":"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"}

package/dist/mcp/input-required.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-required.d.ts","sourceRoot":"","sources":["../../src/mcp/input-required.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,KAAK,EAEV,eAAe,EACf,sBAAsB,EAEtB,iBAAiB,EAEjB,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAwFnB;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,mBAAmB,CAUvE;AAID,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,CAAC,EAAE,uBAAuB,GAChC,sBAAsB,CAqBxB;AAID,iFAAiF;AACjF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,GAAG,EAAE,MAAM,GACV,eAAe,GAAG,SAAS,CAE7B;AAED,gDAAgD;AAChD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAA;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAyBvC"}
+{"version":3,"file":"input-required.d.ts","sourceRoot":"","sources":["../../src/mcp/input-required.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAGpD,OAAO,KAAK,EAEV,eAAe,EACf,sBAAsB,EAEtB,iBAAiB,EAEjB,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAgFnB;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,mBAAmB,CAUvE;AAID,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,CAAC,EAAE,uBAAuB,GAChC,sBAAsB,CAqBxB;AAID,iFAAiF;AACjF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,GAAG,EAAE,MAAM,GACV,eAAe,GAAG,SAAS,CAE7B;AAED,gDAAgD;AAChD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAA;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAyBvC"}

package/dist/mcp/input-required.js

@@ -35,6 +35,7 @@
  * ```
  */
 import { createLogger } from '../core/logger.js';
+import { humanizeKey } from '../core/humanize.js';
 const log = createLogger('mcp');
 /** Field `type` values that map onto a wire string format. */
 const STRING_FORMAT = {
@@ -51,13 +52,6 @@ const NUMERIC = {
     range: 'number',
     integer: 'integer',
 };
-/** Humanize a field name the same way `autoForm` does, for schema titles. */
-function humanize(name) {
-    return name
-        .replace(/[_-]+/g, ' ')
-        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
-        .replace(/\b\w/g, c => c.toUpperCase());
-}
 /**
  * Derive the restricted schema for one field.
  *
@@ -66,7 +60,7 @@ function humanize(name) {
  * render it; the type is dropped rather than misrepresented.
  */
 function fieldSchema(field) {
-    const title = field.label ?? humanize(field.name);
+    const title = field.label ?? humanizeKey(field.name);
     const common = { title, ...(field.description != null && { description: field.description }) };
     if (field.options != null && field.options.length > 0) {
         const values = field.options.map(o => o.value);

package/dist/mcp/input-required.js.map

@@ -1 +1 @@
-{"version":3,"file":"input-required.js","sourceRoot":"","sources":["../../src/mcp/input-required.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"input-required.js","sourceRoot":"","sources":["../../src/mcp/input-required.ts"],"names":[],"mappings":"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"}

package/dist/mcp/resource.d.ts

@@ -1,14 +1,4 @@
-/**
- * MCP Apps resource helpers — register the prefab viewer as a `ui://` resource.
- *
- * Covers the three things every MCP Apps host checks and the two the
- * 2026-07-28 protocol revision added:
- *   - the `text/html;profile=mcp-app` MIME type,
- *   - `_meta.ui` CSP / permissions on BOTH the listing and the content item,
- *   - the viewer HTML itself (CDN-pinned to this exact package version),
- *   - `ttlMs` / `cacheScope` on the read result (SEP-2549 `CacheableResult`),
- *   - the `io.modelcontextprotocol/ui` extension capability (SEP-2133).
- */
+/** Register the prefab viewer as a `ui://` MCP Apps resource: MIME type, `_meta.ui` on listing and content, CDN-pinned HTML, cache fields, extension capability. */
 import type { McpCacheHint, McpResourceReadResult, McpTextResourceContents } from './types.js';
 import { type ThemeBridge } from './theme-bridge.js';
 /** CSP configuration for MCP Apps resources. */
@@ -47,11 +37,7 @@ interface McpAppPermissionsWire {
     clipboardWrite?: Record<string, never>;
 }
 /**
- * Generate the `_meta` object for MCP Apps `ui://` resource registration.
- *
- * Includes CSP and Permission Policy configuration per the MCP Apps spec.
- * Use on both the resource listing AND the content item (VS Code reads
- * only the content item; other hosts may read either).
+ * The `_meta` (CSP, permissions) for a `ui://` resource. Put it on the listing and the content item: VS Code reads only the latter.
  *
  * @example
  * ```ts
@@ -96,33 +82,9 @@ export declare const PREFAB_CDN_META: {
 export declare const PREFAB_RESOURCE_URI = "ui://prefab/viewer";
 /** MIME type required by MCP Apps hosts. */
 export declare const MCP_APP_MIME = "text/html;profile=mcp-app";
-/**
- * Capability key for the MCP Apps extension (versioned independently of core).
- *
- * The identifier is `…/ui`, and the trap here is that `…/apps` looks right and is
- * wrong. The normative source is the MCP Apps spec, which states "This extension is
- * identified as: `io.modelcontextprotocol/ui`" in both the current `2026-01-26`
- * revision and the draft, and the reference implementation agrees:
- * `ext-apps/src/server/index.ts` exports `EXTENSION_ID = "io.modelcontextprotocol/ui"`.
- *
- * `io.modelcontextprotocol/apps` appears only as illustrative "e.g." text in the Rust
- * and C# SDKs' generic `ServerCapabilities.extensions` doc comments (and their test
- * fixtures), showing the SHAPE of the extensions map rather than naming this extension.
- * Copying it from there declares the capability under a key no host looks up, which
- * fails silently: rendering still works, because hosts fall back to detecting apps via
- * `_meta.ui` plus the MIME type, so only the SEP-2133 declaration is lost.
- *
- * Duplicated as a literal rather than imported, because prefab ships zero dependencies.
- */
+/** The MCP Apps extension id, `…/ui` per the spec and ext-apps (`…/apps` in some SDK doc examples is only illustrative). */
 export declare const APPS_EXTENSION = "io.modelcontextprotocol/ui";
-/**
- * Default cache hint for the viewer resource.
- *
- * The HTML is a pure function of this package's `VERSION` (the CDN base pins
- * the exact version), so it cannot change for a given server build — it is
- * safely shared-cacheable. Without this the SDK falls back to the conservative
- * `{ ttlMs: 0, cacheScope: 'private' }` and the viewer is re-fetched every time.
- */
+/** Viewer cache hint: the HTML is a pure function of `VERSION`, so it is shared-cacheable for a day. */
 export declare const DEFAULT_VIEWER_CACHE: Required<McpCacheHint>;
 export interface RendererHtmlOptions {
     /** Page title. @default 'Prefab' */
@@ -133,21 +95,11 @@ export interface RendererHtmlOptions {
     stylesheets?: string[];
     /** Override CDN base URL (no trailing slash). @default jsdelivr CDN */
     cdnBase?: string;
-    /**
-     * Inject a theme bridge stylesheet after `prefab.css`.
-     *
-     * `'vscode'` re-declares the tokens VS Code can supply with the
-     * `--vscode-*` variable first, dropping the MCP Apps `--color-*` layer that
-     * would otherwise shadow it, so the viewer follows the user's editor theme.
-     * Emitted before `stylesheets`, which stay the outermost override.
-     */
+    /** Theme bridge stylesheet after `prefab.css` (before `stylesheets`); `'vscode'` follows the editor theme. */
     themeBridge?: ThemeBridge;
 }
 /**
- * Generate the HTML page for a prefab MCP Apps viewer resource.
- *
- * Returns the minimal HTML that loads `prefab.css` and `renderer.auto.min.js`
- * from the CDN, plus any additional scripts/stylesheets you specify.
+ * The viewer HTML: `prefab.css` and `renderer.auto.min.js` from the CDN, plus your scripts and stylesheets.
  *
  * @example
  * ```ts
@@ -175,22 +127,11 @@ export interface ViewerResourceOptions {
     stylesheets?: string[];
     /** Override CDN base URL (no trailing slash). */
     cdnBase?: string;
-    /**
-     * Inject a theme bridge stylesheet. `'vscode'` makes the viewer follow the
-     * user's editor theme. See {@link RendererHtmlOptions.themeBridge}.
-     */
+    /** See {@link RendererHtmlOptions.themeBridge}. */
     themeBridge?: ThemeBridge;
-    /**
-     * Cache fields for the `resources/read` result (SEP-2549).
-     * @default { ttlMs: 86_400_000, cacheScope: 'public' }
-     */
+    /** Cache fields for the `resources/read` result (SEP-2549). @default { ttlMs: 86_400_000, cacheScope: 'public' } */
     cache?: McpCacheHint;
-    /**
-     * Declare the `io.modelcontextprotocol/ui` extension capability on the
-     * server (SEP-2133). Must happen before the server connects; a server that
-     * is already connected keeps its existing capabilities and a warning is
-     * logged. @default true
-     */
+    /** Declare the `io.modelcontextprotocol/ui` capability (SEP-2133); only works before the server connects. @default true */
     declareCapability?: boolean;
 }
 /** Registration config accepted by both SDK generations. */
@@ -208,13 +149,7 @@ export type ResourceReadHandler = (uri: URL) => Promise<McpResourceReadResult<Mc
 interface CapabilityDeclaration {
     extensions?: Record<string, Record<string, unknown>>;
 }
-/**
- * MCP server interface expected by registerViewerResource.
- *
- * Structural rather than an SDK import, so fastmcp and hand-rolled servers stay
- * compatible. `registerResource` is preferred; `resource` is the v1 overload
- * that v2 retired and is used only as a fallback.
- */
+/** The server shape registerViewerResource needs, structural so any SDK fits; `resource` is the v1 fallback. */
 export interface McpServerLike {
     registerResource?(name: string, uri: string, config: ResourceConfig, handler: ResourceReadHandler): unknown;
     resource?(name: string, uri: string, config: ResourceConfig, handler: ResourceReadHandler): unknown;
@@ -225,21 +160,10 @@ export interface McpServerLike {
     /** Some wrappers expose capability registration directly. */
     registerCapabilities?(capabilities: CapabilityDeclaration): void;
 }
-/**
- * Fill in and validate the `CacheableResult` fields, rejecting values the SDK
- * would silently discard in favour of `ttlMs: 0`.
- *
- * `defaults` differ per resource kind: the viewer HTML is a pure function of the
- * package version and is safely shared-cacheable, while an `a2ui://` surface is
- * rebuilt on every read and defaults to no caching. Exported so `./a2ui.ts`
- * resolves its hints through the same guard rather than restating it.
- */
+/** Fill in and validate `CacheableResult` fields, throwing on values the SDK would silently replace with `ttlMs: 0`. */
 export declare function resolveCache(hint?: McpCacheHint, defaults?: Required<McpCacheHint>): Required<McpCacheHint>;
 /**
- * Register the prefab viewer as a `ui://` resource on an MCP server.
- *
- * Handles the MIME type, CSP on both listing and content item, HTML generation,
- * the `CacheableResult` fields and the Apps extension capability in one call.
+ * Register the prefab viewer as a `ui://` resource. The CSP admits jsDelivr and every origin the page loads from.
  *
  * @example
  * ```ts