@agentshouse/app-bridge 0.1.0-alpha.9 → 0.1.0-c094380be07ea

package/docs/families.md

@@ -0,0 +1,136 @@
+# The App bridge's families
+
+- **Navigation** - the part of the shell's URL below the App's path, with its
+  query and fragment. The shell delivers it when the App starts and whenever the
+  User navigates; the App asks the shell to push or replace it. The App also
+  sets its tab's title and icon with `setTab({ title, icon })`, either or both:
+  a title of at most 200 characters and an icon given as a base64 `data:` URL
+  of an SVG, PNG, GIF or WebP image of at most 1,048,576 characters. The shell
+  shows them over the App's display name, or a Site's title, and its tab icon
+  until the next load, and ignores a request outside those bounds.
+- **Ceremony** - the App asks the shell to leave for one of House's own
+  purpose-bound authenticated pages. The shell navigates only to a same-origin
+  absolute path, carries its current address as the return target, and the page
+  returns there when it completes. An App names an address House gave it in a
+  reading and composes none.
+- **Installation** - `install()` offers the page as a Home-screen app. Where the
+  browser has an install prompt ready the shell shows it and the call resolves
+  `'accepted'` or `'dismissed'` with the User's choice, spending that prompt;
+  otherwise, as on every iPhone and iPad, it resolves `'manual'` and the App
+  shows its own instructions. A prompt the browser refuses to show, as for a
+  call made without a click, rejects with an error named and coded by the
+  browser's own error name, with `retryable` false, and stays ready. Call it from a click. The standard
+  `display-mode: standalone` media query tells the App it runs installed.
+- **Notifications** - House's own panel alone; an App's or a Site's call
+  rejects with an error named `HouseCeremonyRefused`, carrying `code` and `retryable`. `notifications()` answers this browser
+  storage's push state: `'on'`, `'off'`, `'blocked'` where the browser refuses
+  notifications, or `'unavailable'` where it has no push, as on an iPhone or
+  iPad outside a Home-screen app. `notifications(true)` asks the browser's
+  permission and subscribes, `notifications(false)` unsubscribes, and each
+  answers the state it leaves; a failure of the browser's push service, and
+  of `setBadge`, rejects the same way. Call `notifications(true)` from a
+  click. `setBadge(unread)` takes the identifiers of the Human Notifications
+  unread in this storage and sets the icon's badge to their number, or clears
+  it at none, where the browser shows one.
+- **Status** - the App reference the runtime client is attached under,
+  `preferences`: the `roomRef` and Path of the App's own preferences document,
+  or `null` until the runtime holds that Room, sync
+  state, credential state and its `expiresAt`, observed failure, `analytics`:
+  whether the page measures and the visitor's stored analytics choice, and
+  `serviceMode`: `open`, `write-halted` while House refuses writes, so the
+  App can stop retrying them, or `null` while the runtime holds no House
+  connection. Every status field is camelCase. `onStatus(listener)` and
+  `onAddress(listener)` hand a listener the status and the address the bridge
+  already holds, then each change.
+  The App reports the visitor's choice with `analyticsConsent('accept')` or
+  `analyticsConsent('decline')`; the shell hands it to House's analytics loader, and
+  the choice never reaches House.
+- **Site image read** - given a Published Room and an original attachment
+  reference, it answers the web copy's path and metadata, or `null` when no
+  copy exists. The original bytes never cross this bridge at a Site.
+- **App release code** - `sourceTop(app, release)` answers the top level of
+  the latest successful release of an App the User may use: its folders, its
+  files with their sizes and its root README's text, or `null` for none;
+  `sourceDownload(app, release)` answers every file of that release with its
+  path, its size and its `text`, or its bytes as `base64`. The browser keeps
+  each answer per App and release: a read naming a release it holds answers
+  without asking House, and keeping a newer release drops the earlier one. A
+  refusal is House's `{ error: { code, retryable } }`, `app_release_not_found` for an
+  App with no release; a read House does not answer, or one that outlived
+  the browser's signed-in User, is `null`.
+- **External calls** - `callExternal({ url, method, headers, body, slot })`
+  has House's server send an HTTPS request to one of the release's declared
+  external origins and resolves with the service's `status`, `headers` and its
+  body as `body` text or `body_base64`, or a refusal as House's
+  `{ error: { code, retryable } }`, or `null` when House does not answer. House fills in the
+  App and its running release; naming an account slot places the key of the
+  account the User connected to it, which the App never sees, and naming none
+  sends no key. A Site's call names no slot, and the House panel names an
+  `account` instead. `body_base64` replaces `body` for bytes.
+- **App messages** - `messages(listener)` hands the listener each message
+  another holder of this App sends to this User's running copies, as `from`,
+  the sender's User id, and `body`, the JSON value they sent, until the
+  function it returns is called. App code sends one through the Runtime's
+  `call('message.send', { to, body })` with the recipient's User id and
+  a body of at most 32 KiB of JSON; House fills in the App and relays it only
+  to copies running now, storing nothing. The panel sends none.
+- **App screenshot read** - given an App reference, `readScreenshot(app)`
+  answers the image this browser captured of that App's screen the first time
+  it ran its current release, as a PNG `Blob` at most 1200 pixels wide, or
+  `null` when this browser holds none. The image stays in the browser; a Site
+  holds none.
+- **Site screenshot read** - given one of the User's Site identifiers,
+  `readSiteScreenshot(site)` answers the image House captured of that Site
+  after its latest release, as a JPEG `Blob`, or `null` when House holds none
+  or does not answer. A Site's own renderer reads none.
+
+- **Cooperation** - `cooperate({ checkpoint, persist, capture, restore,
+ready, settle })` lets House activate a newer release of the App while it
+  runs, keeping the User's task; the function it returns withdraws it.
+  Register it in the entry script, before the first draw, or House treats the
+  page as not cooperating and the newer release waits for the App's next
+  open. When a newer release is stored, House calls `checkpoint()`, which
+  resolves at the App's next safe checkpoint and may never resolve, then
+  `persist()`, which makes authored work durable, then `capture()`, which
+  answers the meaningful task the App owns, such as the selected record,
+  filters, cursor, selection and scroll position, as JSON of at most 65,536
+  characters; House keeps the address itself. In the newer release House
+  calls `restore(task)`, or `restore(null)` when it opens the release without
+  a task, then `ready()`, the App's own check that its local data and
+  capabilities work, and finally `settle('committed')` once the release is
+  active or `settle('abandoned')` when House returns to the release before
+  it, restoring the same task there. A release House opens already active is
+  settled `'committed'` at once, after `restore(task)` when House hands it a
+  task, and a cooperation registered after House settled is settled at its
+  registration. Until `settle('committed')` House fails the release's outside
+  calls at once, as offline, those of the workers it starts included, and
+  refuses its Saves, write acts and external calls with the retryable code
+  `house_trial_withheld`, so a start-up effect is not repeated; run start-up
+  effects after `settle('committed')`.
+
+## The test host
+
+`createHouseBridgeTestHost(options)` plays House in one page: it installs a
+bridge object that `houseBridge()` returns, until the next host replaces it.
+It delivers the address the App starts at and each address `open` plays as
+Back or Forward, admitting nothing, so it delivers `//notes` exactly as a
+browser at `/apps/<app>//notes` does. It records every push and replace and
+answers each with the address the shell would then show, records an admitted
+ceremony, and refuses a push, replace or ceremony that is not a same-origin
+absolute path of at most 1,000 characters with an error named
+`HouseNavigationRefused` or `HouseCeremonyRefused`. It publishes a status,
+its `serviceMode` included, records in `consents` each `analyticsConsent` it
+takes while that status measures and publishes the status the choice leaves,
+records in `tabs` each `setTab`, answers a release code read from the
+`sources` it was given, or `null`, answers each `callExternal` from the
+`external` function it was given, or `null`, and records the request in
+`externalCalls`, answers `readScreenshot` from the `screenshots` it was given
+by App reference and `readSiteScreenshot` from the `siteScreenshots` it was
+given by Site identifier, answers every `install()` `'manual'`, as a browser
+with no install prompt does, answers every `notifications()` `'unavailable'`,
+as a browser without push does, settles every `setBadge`, delivers each App
+message `message({ from, body })` plays, and hands `bridge.runtime` the MD
+Runtime client `attachRuntime(client)` gives it. `checkpoint()` runs the
+registered cooperation's checkpoint, persist and capture and answers the task,
+`restore(task)` runs its restore and answers its readiness check, and
+`settle(activation)` hands it the outcome.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-alpha.9",
-  "description": "Renderer-side client of the agents.house App bridge: navigation, the tab title and icon, ceremonies, installation, status, Site image reads, App release code and App screenshot reads, with an in-page test host.",
-  "license": "UNLICENSED",
+  "version": "0.1.0-c094380be07ea",
+  "description": "Types of the agents.house App bridge House hands every App: navigation, the tab title and icon, ceremonies, installation, notifications and the icon badge, status, Site image reads, App release code, App and Site screenshot reads, and App messages, with an accessor and an in-page test host.",
+  "license": "MIT",
   "type": "module",
   "sideEffects": false,
   "engines": {
@@ -10,21 +10,18 @@
   },
   "exports": {
     ".": {
-      "types": "./client/src/index.d.ts",
-      "default": "./client/src/index.js"
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     },
     "./test-host": {
-      "types": "./client/src/test-host.d.ts",
-      "default": "./client/src/test-host.js"
+      "types": "./dist/test-host.d.ts",
+      "default": "./dist/test-host.js"
     }
   },
   "files": [
-    "client/src/*.js",
-    "client/src/*.d.ts",
-    "src/apps/remainder.js",
-    "src/apps/remainder.d.ts",
-    "src/apps/tab.js",
-    "src/apps/tab.d.ts",
-    "README.md"
+    "dist",
+    "docs",
+    "README.md",
+    "LICENSE"
   ]
 }

package/client/src/bridge.d.ts

@@ -1,35 +0,0 @@
-import type { HouseBridgePort, HouseGaChoice, HouseMessagePort, HouseSourceDownload, HouseSourceRefusal, HouseSourceTop, HouseStatus, HouseTab } from './wire.js';
-export declare class HouseCeremonyRefused extends Error {
-    readonly path: string | null;
-    constructor(path: string | null);
-}
-export declare class HouseNavigationRefused extends Error {
-    readonly address: string | null;
-    constructor(address: string | null);
-}
-export interface HouseImageCopy {
-    readonly attachment: string;
-    readonly copy: string;
-    readonly name: string;
-    readonly media_type: string;
-}
-type HouseInstallation = 'accepted' | 'dismissed' | 'manual';
-export interface HouseBridge {
-    readonly runtime: Promise<HouseMessagePort>;
-    address(): string | null;
-    onAddress(listener: (address: string) => void): () => void;
-    push(address: string): Promise<string>;
-    replace(address: string): Promise<string>;
-    ceremony(path: string): Promise<never>;
-    install(): Promise<HouseInstallation>;
-    setTab(tab: HouseTab): void;
-    readAttachment(room: string, attachment: string): Promise<HouseImageCopy | null>;
-    sourceTop(app: string, release?: string): Promise<HouseSourceTop | HouseSourceRefusal | null>;
-    sourceDownload(app: string, release?: string): Promise<HouseSourceDownload | HouseSourceRefusal | null>;
-    readScreenshot(app: string): Promise<Blob | null>;
-    status(): HouseStatus | null;
-    onStatus(listener: (status: HouseStatus) => void): () => void;
-    gaConsent(choice: HouseGaChoice): void;
-}
-export declare function connectHouseBridge(source?: Promise<HouseBridgePort>): HouseBridge;
-export {};

package/client/src/bridge.js

@@ -1,229 +0,0 @@
-export class HouseCeremonyRefused extends Error {
-    path;
-    constructor(path) {
-        super('house_ceremony_refused');
-        this.name = 'HouseCeremonyRefused';
-        this.path = path;
-    }
-}
-export class HouseNavigationRefused extends Error {
-    address;
-    constructor(address) {
-        super('house_navigation_refused');
-        this.name = 'HouseNavigationRefused';
-        this.address = address;
-    }
-}
-function settled() {
-    let settle = null;
-    const promise = new Promise((resolve, reject) => {
-        settle = { resolve, reject };
-    });
-    return { promise, settle: settle };
-}
-function heldBridge() {
-    const held = globalThis.houseBridge;
-    if (held === undefined)
-        throw new Error('house_bridge_absent');
-    return held;
-}
-export function connectHouseBridge(source = heldBridge()) {
-    const runtime = settled();
-    const ceremonies = [];
-    const navigations = [];
-    const attachments = new Map();
-    let nextAttachment = 0;
-    const sources = new Map();
-    let nextSource = 0;
-    const installations = new Map();
-    let nextInstallation = 0;
-    const screenshots = new Map();
-    let nextScreenshot = 0;
-    const addressListeners = new Set();
-    const statusListeners = new Set();
-    let outbox = [];
-    let held = null;
-    let address = null;
-    let status = null;
-    function send(message) {
-        if (held === null)
-            outbox?.push(message);
-        else
-            held.postMessage(message);
-    }
-    function receive(event) {
-        const data = event.data;
-        if (data === null || typeof data !== 'object')
-            return;
-        if (data.house === 'runtime') {
-            const [port] = event.ports;
-            if (port !== undefined)
-                runtime.settle.resolve(port);
-            return;
-        }
-        if (data.house === 'status') {
-            status = data.status;
-            for (const listener of statusListeners)
-                listener(status);
-            return;
-        }
-        if (data.house === 'address') {
-            address = String(data.address);
-            if (data.navigated === true)
-                navigations.shift()?.settle.resolve(address);
-            for (const listener of addressListeners)
-                listener(address);
-            return;
-        }
-        if (data.house === 'navigate-refused') {
-            const refused = data.address;
-            const named = typeof refused === 'string' ? refused : null;
-            const index = named === null ? 0 : navigations.findIndex((one) => one.address === named);
-            const [pending] = navigations.splice(index < 0 ? 0 : index, 1);
-            pending?.settle.reject(new HouseNavigationRefused(named));
-            return;
-        }
-        if (data.house === 'attachment') {
-            const answer = data;
-            if (typeof answer.id !== 'number')
-                return;
-            const pending = attachments.get(answer.id);
-            if (pending === undefined)
-                return;
-            attachments.delete(answer.id);
-            pending.resolve(answer.image ?? null);
-            return;
-        }
-        if (data.house === 'install') {
-            const answer = data;
-            if (typeof answer.id !== 'number')
-                return;
-            const pending = installations.get(answer.id);
-            if (pending === undefined)
-                return;
-            installations.delete(answer.id);
-            if (answer.outcome !== undefined)
-                pending.resolve(answer.outcome);
-            else
-                pending.reject(new DOMException(answer.refusal?.message, answer.refusal?.name));
-            return;
-        }
-        if (data.house === 'source') {
-            const answer = data;
-            if (typeof answer.id !== 'number')
-                return;
-            const pending = sources.get(answer.id);
-            if (pending === undefined)
-                return;
-            sources.delete(answer.id);
-            pending.resolve(answer.answer ?? null);
-            return;
-        }
-        if (data.house === 'screenshot') {
-            const answer = data;
-            if (typeof answer.id !== 'number')
-                return;
-            const pending = screenshots.get(answer.id);
-            if (pending === undefined)
-                return;
-            screenshots.delete(answer.id);
-            pending.resolve(answer.image ?? null);
-            return;
-        }
-        if (data.house === 'ceremony-refused') {
-            const refused = data.path;
-            const named = typeof refused === 'string' ? refused : null;
-            const index = named === null ? 0 : ceremonies.findIndex((one) => one.path === named);
-            const [pending] = ceremonies.splice(index < 0 ? 0 : index, 1);
-            pending?.settle.reject(new HouseCeremonyRefused(named));
-        }
-    }
-    void source.then((port) => {
-        held = port;
-        port.addEventListener('message', receive);
-        port.start();
-        const waiting = outbox ?? [];
-        outbox = null;
-        for (const message of waiting)
-            port.postMessage(message);
-    });
-    function readSource(house, app, release) {
-        const pending = settled();
-        const id = ++nextSource;
-        sources.set(id, pending.settle);
-        send({ house, id, app, release });
-        return pending.promise;
-    }
-    function navigate(mode, asked) {
-        const pending = settled();
-        navigations.push({ address: asked, settle: pending.settle });
-        send({ house: 'navigate', mode, address: asked });
-        return pending.promise;
-    }
-    return {
-        runtime: runtime.promise,
-        address() {
-            return address;
-        },
-        onAddress(listener) {
-            addressListeners.add(listener);
-            return () => {
-                addressListeners.delete(listener);
-            };
-        },
-        push(asked) {
-            return navigate('push', asked);
-        },
-        replace(asked) {
-            return navigate('replace', asked);
-        },
-        ceremony(path) {
-            const pending = settled();
-            ceremonies.push({ path, settle: pending.settle });
-            send({ house: 'ceremony', path });
-            return pending.promise;
-        },
-        install() {
-            const pending = settled();
-            const id = ++nextInstallation;
-            installations.set(id, pending.settle);
-            send({ house: 'install', id });
-            return pending.promise;
-        },
-        setTab(tab) {
-            send({ house: 'tab', title: tab.title, icon: tab.icon });
-        },
-        readAttachment(room, attachment) {
-            const pending = settled();
-            const id = ++nextAttachment;
-            attachments.set(id, pending.settle);
-            send({ house: 'attachment-read', id, room, attachment });
-            return pending.promise;
-        },
-        sourceTop(app, release) {
-            return readSource('source-top', app, release);
-        },
-        sourceDownload(app, release) {
-            return readSource('source-download', app, release);
-        },
-        readScreenshot(app) {
-            const pending = settled();
-            const id = ++nextScreenshot;
-            screenshots.set(id, pending.settle);
-            send({ house: 'screenshot-read', id, app });
-            return pending.promise;
-        },
-        status() {
-            return status;
-        },
-        onStatus(listener) {
-            statusListeners.add(listener);
-            return () => {
-                statusListeners.delete(listener);
-            };
-        },
-        gaConsent(choice) {
-            send({ house: 'ga/consent', choice });
-        },
-    };
-}

package/client/src/index.d.ts

@@ -1,3 +0,0 @@
-export { connectHouseBridge, HouseCeremonyRefused, HouseNavigationRefused, type HouseBridge, type HouseImageCopy, } from './bridge.js';
-export { HOUSE_ADDRESS_MAX_CHARS } from './wire.js';
-export type { HouseBridgeEvent, HouseBridgePort, HouseCredentialState, HouseGa, HouseGaChoice, HouseMessagePort, HouseNavigationMode, HouseSourceDownload, HouseSourceFile, HouseSourceRefusal, HouseSourceTop, HouseStatus, HouseSyncState, } from './wire.js';

package/client/src/index.js

@@ -1,2 +0,0 @@
-export { connectHouseBridge, HouseCeremonyRefused, HouseNavigationRefused, } from './bridge.js';
-export { HOUSE_ADDRESS_MAX_CHARS } from './wire.js';

package/client/src/test-host.d.ts

@@ -1,30 +0,0 @@
-import type { HouseImageCopy } from './bridge.js';
-import type { HouseBridgePort, HouseGaChoice, HouseMessagePort, HouseNavigationMode, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab } from './wire.js';
-export interface HouseBridgeNavigation {
-    readonly mode: HouseNavigationMode;
-    readonly address: string;
-}
-export interface HouseBridgeTestHost {
-    readonly port: Promise<HouseBridgePort>;
-    readonly navigations: readonly HouseBridgeNavigation[];
-    readonly ceremonies: readonly string[];
-    readonly consents: readonly HouseGaChoice[];
-    readonly tabs: readonly HouseTab[];
-    address(): string;
-    open(address: string): void;
-    publish(status: HouseStatus): void;
-    attachRuntime(runtime: HouseMessagePort): void;
-}
-export interface HouseBridgeTestHostOptions {
-    readonly address?: string;
-    readonly status?: HouseStatus;
-    readonly images?: readonly (HouseImageCopy & {
-        readonly room: string;
-    })[];
-    readonly sources?: readonly {
-        readonly top: HouseSourceTop;
-        readonly download: HouseSourceDownload;
-    }[];
-    readonly screenshots?: Readonly<Record<string, Blob>>;
-}
-export declare function createHouseBridgeTestHost(options?: HouseBridgeTestHostOptions): HouseBridgeTestHost;

package/client/src/test-host.js

@@ -1,159 +0,0 @@
-import { appAddressOf } from '../../src/apps/remainder.js';
-import { tabChange } from '../../src/apps/tab.js';
-import { HOUSE_ADDRESS_MAX_CHARS } from './wire.js';
-const HOST_ORIGIN = 'https://house.invalid';
-function sameOriginPath(value) {
-    if (typeof value !== 'string')
-        return null;
-    if (value.charAt(0) !== '/' || value.slice(0, 2) === '//')
-        return null;
-    if (value.length > HOUSE_ADDRESS_MAX_CHARS)
-        return null;
-    const target = new URL(value, HOST_ORIGIN);
-    return target.origin === HOST_ORIGIN ? `${target.pathname}${target.search}${target.hash}` : null;
-}
-export function createHouseBridgeTestHost(options = {}) {
-    const navigations = [];
-    const ceremonies = [];
-    const consents = [];
-    const tabs = [];
-    const listeners = new Set();
-    const queued = [];
-    let started = false;
-    let address = appAddressOf('/', options.address ?? '/');
-    let status = options.status ?? null;
-    function deliver(data, ports = []) {
-        const event = { data, ports };
-        if (!started) {
-            queued.push(event);
-            return;
-        }
-        queueMicrotask(() => {
-            for (const listener of listeners)
-                listener(event);
-        });
-    }
-    function arrive(target, navigated) {
-        address = target;
-        deliver({ house: 'address', address, navigated });
-    }
-    function navigate(mode, asked) {
-        const target = sameOriginPath(asked);
-        if (target === null) {
-            deliver({
-                house: 'navigate-refused',
-                address: typeof asked === 'string' ? asked : null,
-            });
-            return;
-        }
-        navigations.push({ mode: mode === 'replace' ? 'replace' : 'push', address: target });
-        arrive(target, true);
-    }
-    function ceremony(path) {
-        const target = sameOriginPath(path);
-        if (target === null) {
-            deliver({ house: 'ceremony-refused', path: typeof path === 'string' ? path : null });
-            return;
-        }
-        ceremonies.push(target);
-    }
-    function publish(next) {
-        status = next;
-        deliver({ house: 'status', status });
-    }
-    function consent(choice) {
-        if (status === null || !status.ga.measures)
-            return;
-        if (choice !== 'accept' && choice !== 'decline')
-            return;
-        consents.push(choice);
-        publish({ ...status, ga: { measures: true, choice } });
-    }
-    function receive(message) {
-        const data = message;
-        if (data === null || typeof data !== 'object')
-            return;
-        if (data.house === 'navigate') {
-            navigate(data.mode, data.address);
-        }
-        else if (data.house === 'ceremony') {
-            ceremony(data.path);
-        }
-        else if (data.house === 'install') {
-            deliver({ house: 'install', id: data.id, outcome: 'manual' });
-        }
-        else if (data.house === 'tab') {
-            const change = tabChange(data);
-            if (change !== null)
-                tabs.push(change);
-        }
-        else if (data.house === 'ga/consent') {
-            consent(data.choice);
-        }
-        else if (data.house === 'source-top' || data.house === 'source-download') {
-            const asked = data;
-            const source = options.sources?.find((entry) => entry.top.app_ref === asked.app);
-            const answer = source === undefined ? null : data.house === 'source-top' ? source.top : source.download;
-            deliver({ house: 'source', id: asked.id, answer });
-        }
-        else if (data.house === 'attachment-read') {
-            const asked = data;
-            const image = options.images?.find((entry) => entry.room === asked.room && entry.attachment === asked.attachment);
-            deliver({
-                house: 'attachment',
-                id: asked.id,
-                image: image === undefined
-                    ? null
-                    : {
-                        attachment: image.attachment,
-                        copy: image.copy,
-                        name: image.name,
-                        media_type: image.media_type,
-                    },
-            });
-        }
-        else if (data.house === 'screenshot-read') {
-            const asked = data;
-            const held = typeof asked.app === 'string' ? options.screenshots?.[asked.app] : undefined;
-            deliver({ house: 'screenshot', id: asked.id, image: held ?? null });
-        }
-    }
-    const port = {
-        postMessage(message) {
-            receive(message);
-        },
-        addEventListener(_type, listener) {
-            listeners.add(listener);
-        },
-        start() {
-            started = true;
-            const held = queued.splice(0);
-            queueMicrotask(() => {
-                for (const event of held) {
-                    for (const listener of listeners)
-                        listener(event);
-                }
-            });
-        },
-    };
-    if (status !== null)
-        deliver({ house: 'status', status });
-    deliver({ house: 'address', address, navigated: false });
-    return {
-        port: Promise.resolve(port),
-        navigations,
-        ceremonies,
-        consents,
-        tabs,
-        address() {
-            return address;
-        },
-        open(asked) {
-            arrive(appAddressOf('/', asked), false);
-        },
-        publish,
-        attachRuntime(runtime) {
-            deliver({ house: 'runtime' }, [runtime]);
-        },
-    };
-}