Skip to content

@maxhealth.tech/prefab / renderer / PrefabApp

Interface: PrefabApp

Defined in: renderer/app.ts:55

Properties

callTool

ts
callTool: (name, args?) => Promise<unknown>;

Defined in: renderer/app.ts:57

Call an MCP tool through the transport.

Parameters

ParameterType
namestring
args?Record<string, unknown>

Returns

Promise<unknown>


sendMessage

ts
sendMessage: (message) => Promise<void>;

Defined in: renderer/app.ts:59

Send a message through the transport.

Parameters

ParameterType
messagestring

Returns

Promise<void>


onToolInput

ts
onToolInput: (handler) => void;

Defined in: renderer/app.ts:61

Register a handler for tool input from the host.

Parameters

ParameterType
handlerToolInputHandler

Returns

void


onToolResult

ts
onToolResult: (handler) => void;

Defined in: renderer/app.ts:63

Register a handler for tool results from the host.

Parameters

ParameterType
handlerToolResultHandler

Returns

void


onToolCancelled

ts
onToolCancelled: (handler) => void;

Defined in: renderer/app.ts:65

Register a handler for tool cancellation.

Parameters

ParameterType
handlerVoidHandler

Returns

void


onToolInputPartial

ts
onToolInputPartial: (handler) => void;

Defined in: renderer/app.ts:67

Register a handler for partial/streaming tool input.

Parameters

ParameterType
handlerToolInputHandler

Returns

void


onHostContextChanged

ts
onHostContextChanged: (handler) => void;

Defined in: renderer/app.ts:69

Register a handler for host context changes (full params from host-context-changed).

Parameters

ParameterType
handler(context) => void

Returns

void


render

ts
render: (target, ...components) => MountHandle;

Defined in: renderer/app.ts:71

Render a component tree into a DOM element.

Parameters

ParameterType
targetstring | HTMLElement
...componentsComponentNode[]

Returns

MountHandle


mount

ts
mount: (target, data, opts?) => MountedApp;

Defined in: renderer/app.ts:73

Mount full wire-format data (legacy API).

Parameters

ParameterType
targetstring | HTMLElement
dataPrefabWireData
opts?MountOptions

Returns

MountedApp


requestMode

ts
requestMode: (mode) => void;

Defined in: renderer/app.ts:75

Request a display mode change.

Parameters

ParameterType
modeDisplayMode

Returns

void


ts
openLink: (url, target?) => void;

Defined in: renderer/app.ts:77

Request the host to open a URL.

Parameters

ParameterType
urlstring
target?string

Returns

void


updateContext

ts
updateContext: (context) => void;

Defined in: renderer/app.ts:79

Send context updates.

Parameters

ParameterType
contextRecord<string, unknown>

Returns

void


setupAutoResize

ts
setupAutoResize: (target) => () => void;

Defined in: renderer/app.ts:85

Observe an element and notify the host whenever it resizes. Mirrors the ext-apps SDK autoResize: true behaviour. Returns a teardown function that disconnects the observer.

Parameters

ParameterType
targetstring | HTMLElement

Returns

() => void


notifyPreferredSize

ts
notifyPreferredSize: (layout) => void;

Defined in: renderer/app.ts:90

Notify the host of declarative layout/size preferences from the wire format. Called automatically when mounting wire data with a layout field.

Parameters

ParameterType
layout{ preferredHeight?: number; minHeight?: number; maxHeight?: number; }
layout.preferredHeight?number
layout.minHeight?number
layout.maxHeight?number

Returns

void


host

ts
host: HostContext;

Defined in: renderer/app.ts:92

Host context from initialization.


capabilities

ts
capabilities: HostCapabilities;

Defined in: renderer/app.ts:94

Host capabilities.


theme

ts
theme: HostTheme | undefined;

Defined in: renderer/app.ts:96

Host theme (if provided).


transport

ts
transport: McpTransport;

Defined in: renderer/app.ts:98

The underlying MCP transport.


destroy

ts
destroy: () => void;

Defined in: renderer/app.ts:100

Destroy the app and clean up.

Returns

void

Released under the MIT License.