The bridge

A screen runs in a worker with no page, network, storage, cookies, or server address. The SDK bridge is its only route into Brydio.

The wire protocol is brydio-tree/1. This page is generated by bun run docs:bridge. The protocol table reads WORKER_METHODS and HOST_METHODS directly, and every limit below reads its exported constant. Do not edit this page by hand.

Errors

tools.call rejects a tool result with isError. tools.result returns the whole ToolResult instead.

Public calls

connect()

Sends worker/ready once and resolves with HostContext. mount() calls it for a screen that draws immediately.

host.context and host.subscribe(listener)

host.context is the latest context or null. host.subscribe receives each later theme, size, selection, placement, or instance update and returns an unsubscribe function.

tools.call(tool, input) and tools.result(tool, input)

Calls one generated or custom tool. A write waits for Brydio to show an approval card. A missing manifest grant throws GrantError before the message leaves the worker.

data.get(collection, id) and data.list(collection, query)

data.get returns one record. data.list accepts filter, sort, limit, and cursor; a page is 50 by default, 200 at most. The result carries items and nextCursor.

data.watch(collection, onChange, onEnd)

Watches one collection and returns a function that stops. Each change has only { id, op, version }, so the screen reads the record again under current access. One open app may watch at most 5 collections.

navigate(to)

Opens a chat, file, project, or app item and resolves with { opened }. It needs navigate in grants.host.

toast(text, tone)

Shows one Brydio toast in the info, success, or danger tone. Text is cut at 200 characters.

mount(build, options)

Connects, gives the plain builder a remote root and HostContext, and sends the first tree. That tree must arrive within 2 seconds. The Preact entry point has its own mount; a screen uses one or the other.

onTeardown(listener)

Runs when Brydio stops the screen. Use it to release local resources. Calls started during teardown will not receive an answer.

@brydio/api

api.projects, api.files, api.chats, and api.connections are typed calls over api/call. The app receives no token, cookie, API address, or connection credential. Each family needs projects, files, chats, or the exact connection:<name> host grant. * never grants a connection. Reads run after Brydio checks the current person. Writes wait for Allow once.

import { api } from '@brydio/api';

const projects = await api.projects.list();
const issues = await api.connections.use('github').request({
  path: '/repos/brydio/brydio/issues',
  query: { state: 'open' },
});

A connection path is relative. GET and HEAD are reads. POST, PUT, PATCH, and DELETE are approval-gated writes.

Protocol methods

Limits

Calls per minute are Brydio's limit, not an SDK constant. An administrator sees the rate in app activity. A rate refusal is a HostError with a message written for the builder.