@maxhealth.tech/prefab 0.1.2

package/dist/mcp/display.js

@@ -0,0 +1,124 @@
+/**
+ * MCP Display Helpers — return prefab UIs as MCP tool results.
+ *
+ * These functions wrap PrefabApp / Component trees into MCP-compatible
+ * tool result content arrays, ready to return from tool handlers.
+ *
+ * @example
+ * ```ts
+ * import { display, display_error } from '@maxhealth.tech/prefab/mcp'
+ * import { autoTable } from '@maxhealth.tech/prefab'
+ *
+ * // In a FastMCP tool handler:
+ * async function listPatients(args, context) {
+ *   const patients = await fetchPatients()
+ *   return display(autoTable(patients), { title: 'Patient List' })
+ * }
+ * ```
+ */
+import {} from '../core/component.js';
+import { PrefabApp } from '../app.js';
+/**
+ * Wrap a Component (or PrefabApp) as an MCP tool result.
+ *
+ * If given a Component, it's wrapped in a PrefabApp automatically.
+ * If given a PrefabApp, it's serialized as-is.
+ *
+ * @returns MCP tool result with the prefab wire format JSON as text content.
+ */
+export function display(viewOrApp, options) {
+    const app = viewOrApp instanceof PrefabApp
+        ? viewOrApp
+        : new PrefabApp({
+            title: options?.title ?? 'Prefab',
+            view: viewOrApp,
+            state: options?.state,
+            theme: options?.theme,
+            defs: options?.defs,
+            onMount: options?.onMount,
+            keyBindings: options?.keyBindings,
+            cssClass: options?.cssClass,
+        });
+    return {
+        content: [{ type: 'text', text: JSON.stringify(app.toJSON()) }],
+    };
+}
+// ── display_form() ───────────────────────────────────────────────────────────
+import { autoForm } from '../auto/form.js';
+/**
+ * Return a form UI as an MCP tool result.
+ *
+ * The form submits back to the specified MCP tool via CallTool.
+ * Field definitions map to Input components; the submit action
+ * invokes `submitTool` with all field values.
+ *
+ * @returns MCP tool result with form prefab UI.
+ */
+export function display_form(fields, submitTool, options) {
+    const view = autoForm(fields, submitTool, options);
+    const app = new PrefabApp({
+        title: options?.title ?? 'Form',
+        view,
+        state: options?.state,
+        theme: options?.theme,
+    });
+    return {
+        content: [{ type: 'text', text: JSON.stringify(app.toJSON()) }],
+    };
+}
+/**
+ * Return a partial state update for an existing prefab UI.
+ *
+ * Instead of re-rendering the entire UI, this sends a state delta
+ * that the renderer merges into its reactive store.
+ *
+ * @returns MCP tool result with a $prefab update payload.
+ */
+export function display_update(state) {
+    const payload = {
+        $prefab: { version: '0.2' },
+        update: { state },
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload) }],
+    };
+}
+// ── display_error() ──────────────────────────────────────────────────────────
+import { Column } from '../components/layout/index.js';
+import { Muted, Code } from '../components/typography/index.js';
+import { Alert, AlertTitle, AlertDescription } from '../components/alert/index.js';
+import { Card, CardContent } from '../components/card/index.js';
+/**
+ * Return a standardized error view as an MCP tool result.
+ *
+ * Renders a destructive Alert with title + message, optional detail
+ * code block, and optional hint. Sets `isError: true` on the MCP result.
+ *
+ * @returns MCP tool result with error UI and isError flag.
+ */
+export function display_error(title, message, options) {
+    const alertChildren = [
+        AlertTitle(title),
+        AlertDescription(message),
+    ];
+    const bodyChildren = [
+        Alert({ variant: 'destructive', icon: 'AlertCircle', children: alertChildren }),
+    ];
+    if (options?.detail) {
+        bodyChildren.push(Card({ children: [CardContent({ children: [Code(options.detail)] })] }));
+    }
+    if (options?.hint) {
+        bodyChildren.push(Muted(options.hint));
+    }
+    const view = Column({ gap: 4, cssClass: 'p-6 max-w-2xl', children: bodyChildren });
+    const app = new PrefabApp({
+        title: 'Error',
+        view,
+        theme: options?.theme,
+    });
+    return {
+        content: [{ type: 'text', text: JSON.stringify(app.toJSON()) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=display.js.map

package/dist/mcp/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../src/mcp/display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAkB,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAwBrC;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CACrB,SAAgC,EAChC,OAAwB;IAExB,MAAM,GAAG,GAAG,SAAS,YAAY,SAAS;QACxC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAI,SAAS,CAAC;YACZ,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,QAAQ;YACjC,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,QAAQ,EAAE,OAAO,EAAE,QAAQ;SAC5B,CAAC,CAAA;IAEN,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;KAChE,CAAA;AACH,CAAC;AAED,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAU1C;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAuB,EACvB,UAAkB,EAClB,OAA4B;IAE5B,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;IAClD,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC;QACxB,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,MAAM;QAC/B,IAAI;QACJ,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,KAAK,EAAE,OAAO,EAAE,KAAK;KACtB,CAAC,CAAA;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;KAChE,CAAA;AACH,CAAC;AAcD;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA8B;IAE9B,MAAM,OAAO,GAAqB;QAChC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;QAC3B,MAAM,EAAE,EAAE,KAAK,EAAE;KAClB,CAAA;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;KAC3D,CAAA;AACH,CAAC;AAED,gFAAgF;AAEhF,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAA;AACtD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,mCAAmC,CAAA;AAC/D,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAClF,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAW/D;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,OAAe,EACf,OAA6B;IAE7B,MAAM,aAAa,GAAgB;QACjC,UAAU,CAAC,KAAK,CAAC;QACjB,gBAAgB,CAAC,OAAO,CAAC;KAC1B,CAAA;IAED,MAAM,YAAY,GAAgB;QAChC,KAAK,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;KAChF,CAAA;IAED,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,YAAY,CAAC,IAAI,CACf,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CACxE,CAAA;IACH,CAAC;IAED,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACxC,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAA;IAElF,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC;QACxB,KAAK,EAAE,OAAO;QACd,IAAI;QACJ,KAAK,EAAE,OAAO,EAAE,KAAK;KACtB,CAAC,CAAA;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI;KACd,CAAA;AACH,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP display helpers — return prefab UIs as MCP tool results.
+ */
+export { display, display_form, display_update, display_error } from './display.js';
+export type { DisplayOptions, DisplayFormOptions, DisplayErrorOptions, StateUpdate, PrefabUpdateWire, } from './display.js';
+export type { McpToolResult, McpContent, McpTextContent, McpImageContent, McpResourceContent } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACnF,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,GACjB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}

package/dist/mcp/index.js

@@ -0,0 +1,5 @@
+/**
+ * MCP display helpers — return prefab UIs as MCP tool results.
+ */
+export { display, display_form, display_update, display_error } from './display.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MCP protocol types used by display helpers.
+ *
+ * These match the Model Context Protocol spec for tool results.
+ * @see https://spec.modelcontextprotocol.io/specification/server/tools/
+ */
+/** MCP text content block */
+export interface McpTextContent {
+    type: 'text';
+    text: string;
+}
+/** MCP image content block */
+export interface McpImageContent {
+    type: 'image';
+    data: string;
+    mimeType: string;
+}
+/** MCP embedded resource content block */
+export interface McpResourceContent {
+    type: 'resource';
+    resource: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+        blob?: string;
+    };
+}
+/** Any MCP content block */
+export type McpContent = McpTextContent | McpImageContent | McpResourceContent;
+/** MCP tool result — returned from tool handlers */
+export interface McpToolResult {
+    content: McpContent[];
+    isError?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAA;QACX,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAED,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,eAAe,GAAG,kBAAkB,CAAA;AAE9E,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB"}

package/dist/mcp/types.js

@@ -0,0 +1,8 @@
+/**
+ * MCP protocol types used by display helpers.
+ *
+ * These match the Model Context Protocol spec for tool results.
+ * @see https://spec.modelcontextprotocol.io/specification/server/tools/
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/renderer/actions.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Action dispatcher — executes serialized actions at runtime.
+ *
+ * Client actions (setState, showToast, etc.) run locally.
+ * MCP actions (toolCall, sendMessage) delegate to the transport layer.
+ */
+import type { Store } from './state.js';
+import type { EvalScope } from './rx.js';
+/** MCP transport interface — injected at mount time */
+export interface McpTransport {
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    sendMessage(message: string): Promise<void>;
+}
+/** Toast event — emitted for showToast actions */
+export interface ToastEvent {
+    message: string;
+    description?: string;
+    variant?: string;
+    duration?: number;
+}
+/** Action dispatcher context */
+export interface DispatchContext {
+    store: Store;
+    transport?: McpTransport;
+    scope?: EvalScope;
+    rerender: () => void;
+    onToast?: (toast: ToastEvent) => void;
+}
+export type ActionJSON = Record<string, unknown>;
+/**
+ * Dispatch one or more serialized actions.
+ */
+export declare function dispatchActions(actions: ActionJSON | ActionJSON[], ctx: DispatchContext): Promise<void>;
+/** Clear all active intervals (called on destroy). */
+export declare function clearAllIntervals(): void;
+//# sourceMappingURL=actions.d.ts.map

package/dist/renderer/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/renderer/actions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAGxC,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACvE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5C;AAED,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,CAAC,EAAE,YAAY,CAAA;IACxB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;CACtC;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEhD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,UAAU,GAAG,UAAU,EAAE,EAClC,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,IAAI,CAAC,CAKf;AAoHD,sDAAsD;AACtD,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC"}

package/dist/renderer/actions.js

@@ -0,0 +1,296 @@
+/**
+ * Action dispatcher — executes serialized actions at runtime.
+ *
+ * Client actions (setState, showToast, etc.) run locally.
+ * MCP actions (toolCall, sendMessage) delegate to the transport layer.
+ */
+import { evaluateTemplate, isRxExpression } from './rx.js';
+/**
+ * Dispatch one or more serialized actions.
+ */
+export async function dispatchActions(actions, ctx) {
+    const list = Array.isArray(actions) ? actions : [actions];
+    for (const action of list) {
+        await dispatchOne(action, ctx);
+    }
+}
+async function dispatchOne(action, ctx) {
+    const type = action.action;
+    switch (type) {
+        case 'setState':
+            {
+                handleSetState(action, ctx);
+                return;
+            }
+        case 'toggleState':
+            {
+                handleToggleState(action, ctx);
+                return;
+            }
+        case 'appendState':
+            {
+                handleAppendState(action, ctx);
+                return;
+            }
+        case 'popState':
+            {
+                handlePopState(action, ctx);
+                return;
+            }
+        case 'showToast':
+            {
+                handleShowToast(action, ctx);
+                return;
+            }
+        case 'closeOverlay':
+            {
+                handleCloseOverlay(action, ctx);
+                return;
+            }
+        case 'openLink':
+            {
+                handleOpenLink(action);
+                return;
+            }
+        case 'setInterval':
+            {
+                handleSetInterval(action, ctx);
+                return;
+            }
+        case 'toolCall':
+            return handleToolCall(action, ctx);
+        case 'sendMessage':
+            return handleSendMessage(action, ctx);
+        case 'updateContext':
+            {
+                handleUpdateContext(action, ctx);
+                return;
+            }
+        case 'fetch':
+            return handleFetch(action, ctx);
+        case 'openFilePicker':
+            {
+                handleOpenFilePicker(action, ctx);
+                return;
+            }
+        case 'callHandler':
+            return handleCallHandler(action, ctx);
+        case 'requestDisplayMode':
+            {
+                handleRequestDisplayMode(action, ctx);
+                return;
+            }
+        default:
+            console.warn(`[prefab] Unknown action: ${type}`);
+    }
+}
+// ── Client Actions ───────────────────────────────────────────────────────────
+function handleSetState(action, ctx) {
+    const key = action.key;
+    let value = action.value;
+    if (isRxExpression(value)) {
+        value = evaluateTemplate(value, ctx.store, ctx.scope);
+    }
+    ctx.store.set(key, value);
+    ctx.rerender();
+    void runCallbacks(action.onSuccess, ctx);
+}
+function handleToggleState(action, ctx) {
+    ctx.store.toggle(action.key);
+    ctx.rerender();
+}
+function handleAppendState(action, ctx) {
+    let value = action.value;
+    if (isRxExpression(value)) {
+        value = evaluateTemplate(value, ctx.store, ctx.scope);
+    }
+    ctx.store.append(action.key, value, action.index);
+    ctx.rerender();
+}
+function handlePopState(action, ctx) {
+    ctx.store.pop(action.key, action.index);
+    ctx.rerender();
+}
+function handleShowToast(action, ctx) {
+    ctx.onToast?.({
+        message: resolveStr(action.message, ctx),
+        description: action.description != null ? resolveStr(action.description, ctx) : undefined,
+        variant: action.variant,
+        duration: action.duration,
+    });
+}
+function handleCloseOverlay(_action, _ctx) {
+    // Close any open dialog/popover — dispatched as custom event
+    if (typeof document !== 'undefined') {
+        document.dispatchEvent(new CustomEvent('prefab:close-overlay'));
+    }
+}
+function handleOpenLink(action) {
+    if (typeof window !== 'undefined') {
+        const url = action.url;
+        if (!isSafeUrl(url)) {
+            console.warn(`[prefab] Blocked unsafe URL scheme: ${url}`);
+            return;
+        }
+        window.open(url, action.target ?? '_blank');
+    }
+}
+/** Active interval IDs for cleanup. */
+const activeIntervals = new Set();
+const MAX_INTERVALS = 20;
+const MIN_INTERVAL_MS = 100;
+function handleSetInterval(action, ctx) {
+    const ms = Math.max(action.intervalMs, MIN_INTERVAL_MS);
+    const onTick = action.onTick;
+    if (typeof globalThis.setInterval !== 'function')
+        return;
+    if (activeIntervals.size >= MAX_INTERVALS) {
+        console.warn('[prefab] Max intervals reached, ignoring new setInterval');
+        return;
+    }
+    const id = globalThis.setInterval(() => void dispatchActions(onTick, ctx), ms);
+    activeIntervals.add(id);
+}
+/** Clear all active intervals (called on destroy). */
+export function clearAllIntervals() {
+    for (const id of activeIntervals)
+        globalThis.clearInterval(id);
+    activeIntervals.clear();
+}
+// ── MCP Actions ──────────────────────────────────────────────────────────────
+async function handleToolCall(action, ctx) {
+    if (!ctx.transport) {
+        console.warn('[prefab] No MCP transport configured for toolCall');
+        return;
+    }
+    const tool = action.tool;
+    const args = resolveArgs(action.arguments, ctx);
+    try {
+        const result = await ctx.transport.callTool(tool, args);
+        if (action.resultKey != null) {
+            ctx.store.set(action.resultKey, result);
+        }
+        ctx.rerender();
+        await runCallbacks(action.onSuccess, ctx, { $result: result });
+    }
+    catch (err) {
+        await runCallbacks(action.onError, ctx, { $error: err });
+    }
+}
+async function handleSendMessage(action, ctx) {
+    if (!ctx.transport) {
+        console.warn('[prefab] No MCP transport configured for sendMessage');
+        return;
+    }
+    await ctx.transport.sendMessage(resolveStr(action.message, ctx));
+}
+function handleUpdateContext(action, ctx) {
+    const context = action.context;
+    if (context != null) {
+        ctx.store.merge(context);
+        ctx.rerender();
+    }
+}
+async function handleFetch(action, ctx) {
+    const url = resolveStr(action.url, ctx);
+    if (!isSafeUrl(url)) {
+        console.warn(`[prefab] Blocked unsafe URL in fetch: ${url}`);
+        return;
+    }
+    const method = action.method ?? 'GET';
+    const headers = action.headers;
+    const body = action.body !== undefined ? JSON.stringify(action.body) : undefined;
+    try {
+        const resp = await globalThis.fetch(url, {
+            method,
+            headers: { 'Content-Type': 'application/json', ...headers },
+            ...(body && { body }),
+        });
+        const result = await resp.json().catch(() => resp.text());
+        if (action.resultKey != null) {
+            ctx.store.set(action.resultKey, result);
+        }
+        ctx.rerender();
+        await runCallbacks(action.onSuccess, ctx, { $result: result });
+    }
+    catch (err) {
+        await runCallbacks(action.onError, ctx, { $error: err });
+    }
+}
+function handleOpenFilePicker(action, ctx) {
+    if (typeof document === 'undefined')
+        return;
+    const input = document.createElement('input');
+    input.type = 'file';
+    if (action.accept != null)
+        input.accept = action.accept;
+    if (action.multiple === true)
+        input.multiple = true;
+    input.addEventListener('change', () => {
+        const files = Array.from(input.files ?? []);
+        if (action.resultKey != null) {
+            ctx.store.set(action.resultKey, files);
+        }
+        ctx.rerender();
+        void runCallbacks(action.onSuccess, ctx, { $result: files });
+    });
+    input.click();
+}
+async function handleCallHandler(action, ctx) {
+    const handler = action.handler;
+    const args = resolveArgs(action.arguments, ctx);
+    // callHandler delegates to the transport like toolCall
+    if (!ctx.transport) {
+        console.warn(`[prefab] No transport configured for callHandler: ${handler}`);
+        return;
+    }
+    try {
+        const result = await ctx.transport.callTool(handler, args);
+        if (action.resultKey != null) {
+            ctx.store.set(action.resultKey, result);
+        }
+        ctx.rerender();
+        await runCallbacks(action.onSuccess, ctx, { $result: result });
+    }
+    catch (err) {
+        await runCallbacks(action.onError, ctx, { $error: err });
+    }
+}
+function handleRequestDisplayMode(action, _ctx) {
+    if (typeof document !== 'undefined') {
+        document.dispatchEvent(new CustomEvent('prefab:request-display-mode', {
+            detail: { mode: action.mode },
+        }));
+    }
+}
+// ── Helpers ──────────────────────────────────────────────────────────────────
+/** Blocked URL schemes that can execute code. */
+const UNSAFE_SCHEME_RE = /^\s*(javascript|vbscript|data):/i;
+function isSafeUrl(url) {
+    return !UNSAFE_SCHEME_RE.test(url);
+}
+function resolveStr(val, ctx) {
+    if (isRxExpression(val)) {
+        const result = evaluateTemplate(val, ctx.store, ctx.scope);
+        return result == null ? '' : String(result);
+    }
+    return val == null ? '' : String(val);
+}
+function resolveArgs(args, ctx) {
+    if (!args)
+        return {};
+    const resolved = {};
+    for (const [key, value] of Object.entries(args)) {
+        resolved[key] = isRxExpression(value)
+            ? evaluateTemplate(value, ctx.store, ctx.scope)
+            : value;
+    }
+    return resolved;
+}
+async function runCallbacks(callbacks, ctx, extraScope) {
+    if (callbacks == null)
+        return;
+    const merged = { ...ctx.scope, ...extraScope };
+    await dispatchActions(callbacks, { ...ctx, scope: merged });
+}
+//# sourceMappingURL=actions.js.map

package/dist/renderer/actions.js.map

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

package/dist/renderer/app.d.ts

@@ -0,0 +1,87 @@
+/**
+ * app() factory — the one-call entry point for prefab apps.
+ *
+ * Auto-detects environment (iframe → postMessage bridge, standalone → HTTP transport),
+ * performs handshake if in iframe, applies host theme, and returns a clean API object.
+ *
+ * Usage:
+ * ```ts
+ * const ui = await prefab.app();
+ *
+ * ui.onToolInput((args) => {
+ *   ui.render('#root', Column(
+ *     H1('Results'),
+ *     autoTable(args.data),
+ *   ));
+ * });
+ * ```
+ */
+import type { PrefabWireData, MountOptions, MountedApp } from './index.js';
+import type { AppCapabilities, HostContext, HostCapabilities, HostTheme, DisplayMode } from './bridge.js';
+import type { McpTransportOptions } from './transport.js';
+import type { McpTransport } from './actions.js';
+import { Store } from './state.js';
+import type { ComponentNode } from './engine.js';
+export interface AppOptions {
+    /** Override environment detection: force bridge or standalone mode. */
+    mode?: 'bridge' | 'standalone' | 'auto';
+    /** Allowed host origin for postMessage (default: '*'). Set explicitly in production. */
+    hostOrigin?: string;
+    /** HTTP transport options (for standalone mode). */
+    transport?: McpTransportOptions;
+    /** App capabilities to advertise to host. */
+    capabilities?: AppCapabilities;
+}
+export type ToolInputHandler = (args: Record<string, unknown>) => void;
+export type ToolResultHandler = (result: unknown) => void;
+export type VoidHandler = () => void;
+export interface PrefabApp {
+    /** Call an MCP tool through the transport. */
+    callTool: (name: string, args?: Record<string, unknown>) => Promise<unknown>;
+    /** Send a message through the transport. */
+    sendMessage: (message: string) => Promise<void>;
+    /** Register a handler for tool input from the host. */
+    onToolInput: (handler: ToolInputHandler) => void;
+    /** Register a handler for tool results from the host. */
+    onToolResult: (handler: ToolResultHandler) => void;
+    /** Register a handler for tool cancellation. */
+    onToolCancelled: (handler: VoidHandler) => void;
+    /** Register a handler for partial/streaming tool input. */
+    onToolInputPartial: (handler: ToolInputHandler) => void;
+    /** Render a component tree into a DOM element. */
+    render: (target: string | HTMLElement, ...components: ComponentNode[]) => MountHandle;
+    /** Mount full wire-format data (legacy API). */
+    mount: (target: string | HTMLElement, data: PrefabWireData, opts?: MountOptions) => MountedApp;
+    /** Request a display mode change. */
+    requestMode: (mode: DisplayMode) => void;
+    /** Request the host to open a URL. */
+    openLink: (url: string, target?: string) => void;
+    /** Send context updates. */
+    updateContext: (context: Record<string, unknown>) => void;
+    /** Host context from initialization. */
+    host: HostContext;
+    /** Host capabilities. */
+    capabilities: HostCapabilities;
+    /** Host theme (if provided). */
+    theme: HostTheme | undefined;
+    /** The underlying MCP transport. */
+    transport: McpTransport;
+    /** Destroy the app and clean up. */
+    destroy: () => void;
+}
+export interface MountHandle {
+    /** Re-render the current component tree. */
+    rerender: () => void;
+    /** Access the reactive store. */
+    store: Store;
+    /** Unmount. */
+    destroy: () => void;
+}
+/**
+ * Create a prefab app. Auto-detects iframe vs standalone.
+ *
+ * In an iframe: uses postMessage bridge, performs handshake with host.
+ * Standalone: uses HTTP transport (or noop if no config).
+ */
+export declare function app(options?: AppOptions): Promise<PrefabApp>;
+//# sourceMappingURL=app.d.ts.map

package/dist/renderer/app.d.ts.map

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