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.