@agentshouse/app-bridge 0.1.0-c94ad2bcf90f7 → 0.1.0-c98040c2bf3b7

package/README.md

@@ -41,7 +41,9 @@ async function manageSecurity(securityPath) {
 ```
 
 `bridge.runtime` resolves to the `MdRuntimeClient` of
-`@agentshouse/mdruntime/client`, whose README describes its members.
+`@agentshouse/mdruntime/client`, whose README describes its members. Its
+`call(name, input)` reaches House: `HouseCalls` names each Call an App makes
+and the input it takes, such as `call('member.list', { room_ref })`.
 
 ## Test without a House
 

package/dist/calls.d.ts

@@ -0,0 +1,117 @@
+export interface HouseCalls {
+    readonly 'access.read': {
+        readonly room_ref: string;
+    };
+    readonly 'conversation.answer': {
+        readonly answer: {
+            readonly interaction_id: string;
+            readonly response: unknown;
+        };
+        readonly conversation: string;
+        readonly operation_id?: string;
+    };
+    readonly 'conversation.create': {
+        readonly agent_id: string;
+        readonly operation_id?: string;
+    };
+    readonly 'conversation.delete': {
+        readonly conversation: string;
+        readonly operation_id?: string;
+    };
+    readonly 'conversation.history': {
+        readonly conversations: readonly {
+            readonly after?: string;
+            readonly conversation: string;
+        }[];
+    };
+    readonly 'conversation.interrupt': {
+        readonly conversation: string;
+        readonly operation_id?: string;
+    };
+    readonly 'conversation.kill': {
+        readonly conversation: string;
+        readonly operation_id?: string;
+    };
+    readonly 'conversation.markDone': {
+        readonly conversation_id?: string;
+        readonly result?: string;
+        readonly operation_id: string;
+    };
+    readonly 'conversation.rename': {
+        readonly conversation_id: string;
+        readonly operation_id: string;
+        readonly name: string;
+    };
+    readonly 'conversation.send': {
+        readonly conversation: string;
+        readonly files?: readonly {
+            readonly blob: Blob;
+            readonly byteLength: number;
+            readonly contentHash: string;
+            readonly height?: number;
+            readonly mediaType: string;
+            readonly name: string;
+            readonly width?: number;
+        }[];
+        readonly operation_id?: string;
+        readonly text?: string;
+    };
+    readonly 'conversation.setOption': {
+        readonly conversation_id: string;
+        readonly operation_id: string;
+        readonly option: string;
+        readonly value: string | boolean;
+    };
+    readonly 'feature.list': Readonly<Record<string, never>>;
+    readonly 'holder.list': Readonly<Record<string, never>>;
+    readonly 'holder.ring': {
+        readonly to: string;
+    };
+    readonly 'member.list': {
+        readonly room_ref: string;
+        readonly history?: boolean;
+        readonly limit?: number;
+        readonly cursor?: string;
+    };
+    readonly 'message.send': {
+        readonly to: string;
+        readonly body: unknown;
+    };
+    readonly 'processing.read': {
+        readonly room_ref: string;
+        readonly path: string;
+    };
+    readonly 'record.list': {
+        readonly room_ref: string;
+        readonly record?: string;
+        readonly cursor?: string;
+        readonly limit?: number;
+        readonly order?: 'asc' | 'desc';
+    };
+    readonly 'relay.read': Readonly<Record<string, never>>;
+    readonly 'routine.list': {
+        readonly room_ref: string;
+    };
+    readonly 'routineAccess.list': {
+        readonly room_ref: string;
+    };
+    readonly 'routineAllowance.list': {
+        readonly room_ref: string;
+        readonly access: string;
+    };
+    readonly 'routineRequest.list': {
+        readonly room_ref: string;
+    };
+    readonly 'storage.read': {
+        readonly room_ref?: string;
+    };
+    readonly submit: {
+        readonly content: string;
+    };
+    readonly 'trigger.list': {
+        readonly room_ref: string;
+    };
+    readonly 'triggerOccurrence.list': {
+        readonly room_ref: string;
+    };
+}

package/dist/calls.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -1,16 +1,23 @@
 import type { MdRuntimeClient } from '@agentshouse/mdruntime/client';
+import type { HouseCalls } from './calls.js';
+export type { HouseCalls } from './calls.js';
+type Open<Value extends string> = Value | (string & {});
+export type HouseCallInput<Name extends string> = Name extends keyof HouseCalls ? HouseCalls[Name] : unknown;
+export interface HouseRuntime extends Omit<MdRuntimeClient, 'call'> {
+    call<Name extends Open<keyof HouseCalls>>(name: Name, input: HouseCallInput<Name>): ReturnType<MdRuntimeClient['call']>;
+}
 export interface HouseSyncState {
     readonly state: string;
     readonly providerUnreachable: boolean;
 }
 export interface HouseCredentialState {
-    readonly state: 'none' | 'held' | 'rejected';
+    readonly state: Open<'none' | 'held' | 'rejected'>;
     readonly expiresAt: number | null;
 }
 export type HouseAnalyticsChoice = 'accept' | 'decline';
 export interface HouseAnalytics {
     readonly measures: boolean;
-    readonly choice: HouseAnalyticsChoice | null;
+    readonly choice: Open<HouseAnalyticsChoice> | null;
 }
 export interface HouseStatus {
     readonly app: string | null;
@@ -22,11 +29,12 @@ export interface HouseStatus {
     readonly credential: HouseCredentialState;
     readonly sync: HouseSyncState | null;
     readonly refusal: {
-        readonly reason: string;
+        readonly code: string;
+        readonly retryable: boolean;
     } | null;
     readonly loss: string | null;
     readonly analytics: HouseAnalytics;
-    readonly serviceMode: 'open' | 'write-halted' | null;
+    readonly serviceMode: Open<'open' | 'write-halted'> | null;
     readonly offline: boolean;
 }
 export type HouseNavigationMode = 'push' | 'replace';
@@ -77,30 +85,33 @@ export type HouseExternalAnswer = {
 export interface HouseRefusal {
     readonly error: {
         readonly code: string;
+        readonly retryable: boolean;
     };
 }
 export interface HouseAppMessage {
     readonly from: string;
     readonly body: unknown;
 }
-export type HouseInstallation = 'accepted' | 'dismissed' | 'manual';
-export type HouseNotifications = 'on' | 'off' | 'blocked' | 'unavailable';
-export interface HouseImageCopy {
-    readonly attachment: string;
-    readonly copy: string;
-    readonly name: string;
-    readonly media_type: string;
-}
+export type HouseInstallation = Open<'accepted' | 'dismissed' | 'manual'>;
+export type HouseNotifications = Open<'on' | 'off' | 'blocked' | 'unavailable'>;
 export interface HouseCeremonyRefused extends Error {
     readonly name: 'HouseCeremonyRefused';
+    readonly code: Open<'house_ceremony_refused'>;
+    readonly retryable: boolean;
     readonly path: string | null;
 }
 export interface HouseNavigationRefused extends Error {
     readonly name: 'HouseNavigationRefused';
+    readonly code: Open<'house_navigation_refused'>;
+    readonly retryable: boolean;
     readonly address: string | null;
 }
+export interface HouseBrowserRefused extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+}
 export interface HouseBridge {
-    readonly runtime: Promise<MdRuntimeClient>;
+    readonly runtime: Promise<HouseRuntime>;
     address(): string | null;
     onAddress(listener: (address: string) => void): () => void;
     push(address: string): Promise<string>;
@@ -110,7 +121,6 @@ export interface HouseBridge {
     notifications(on?: boolean): Promise<HouseNotifications>;
     setBadge(unread: readonly string[]): Promise<void>;
     setTab(tab: HouseTab): void;
-    readAttachment(room: string, attachment: string): Promise<HouseImageCopy | null>;
     sourceTop(app: string, release?: string): Promise<HouseSourceTop | HouseRefusal | null>;
     sourceDownload(app: string, release?: string): Promise<HouseSourceDownload | HouseRefusal | null>;
     callExternal(request: HouseExternalRequest): Promise<HouseExternalAnswer | HouseRefusal | null>;
@@ -121,5 +131,7 @@ export interface HouseBridge {
     messages(listener: (message: HouseAppMessage) => void): () => void;
     analyticsConsent(choice: HouseAnalyticsChoice): void;
 }
+export interface HouseHeld {
+    readonly houseBridge: HouseBridge;
+}
 export declare const houseBridge: () => HouseBridge;
-export {};

package/dist/test-host.d.ts

@@ -1,5 +1,5 @@
 import type { MdRuntimeClient } from '@agentshouse/mdruntime/client';
-import type { HouseAnalyticsChoice, HouseAppMessage, HouseExternalAnswer, HouseExternalRequest, HouseImageCopy, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab } from './index.js';
+import type { HouseAnalyticsChoice, HouseAppMessage, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab } from './index.js';
 export interface HouseBridgeNavigation {
     readonly mode: HouseNavigationMode;
     readonly address: string;
@@ -19,9 +19,6 @@ export interface HouseBridgeTestHost {
 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;

package/dist/test-host.js

@@ -16,12 +16,16 @@ function appAddress(address) {
 function ceremonyRefused(path) {
     return Object.assign(new Error('house_ceremony_refused'), {
         name: 'HouseCeremonyRefused',
+        code: 'house_ceremony_refused',
+        retryable: false,
         path,
     });
 }
 function navigationRefused(address) {
     return Object.assign(new Error('house_navigation_refused'), {
         name: 'HouseNavigationRefused',
+        code: 'house_navigation_refused',
+        retryable: false,
         address,
     });
 }
@@ -92,17 +96,6 @@ export function createHouseBridgeTestHost(options = {}) {
         setTab(tab) {
             tabs.push(tab);
         },
-        readAttachment(room, attachment) {
-            const image = options.images?.find((entry) => entry.room === room && entry.attachment === attachment);
-            return Promise.resolve(image === undefined
-                ? null
-                : {
-                    attachment: image.attachment,
-                    copy: image.copy,
-                    name: image.name,
-                    media_type: image.media_type,
-                });
-        },
         sourceTop: (app) => Promise.resolve(options.sources?.find((entry) => entry.top.app_ref === app)?.top ?? null),
         sourceDownload: (app) => Promise.resolve(options.sources?.find((entry) => entry.top.app_ref === app)?.download ?? null),
         callExternal(request) {

package/docs/families.md

@@ -18,17 +18,17 @@
   `'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 the browser's own `DOMException`
-  and stays ready. Call it from a click. The standard
+  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`. `notifications()` answers this browser
+  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 rejects
-  with the browser's own `DOMException`. Call `notifications(true)` from a
+  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.
@@ -53,14 +53,14 @@
   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 } }`, `app_release_not_found` for an
+  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 } }`, or `null` when House does not answer. House fills in the
+  `{ 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
@@ -69,7 +69,7 @@
   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('apps/messages/send', { to, body })` with the recipient's User id and
+  `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)`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-c94ad2bcf90f7",
+  "version": "0.1.0-c98040c2bf3b7",
   "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",
@@ -19,7 +19,7 @@
     }
   },
   "dependencies": {
-    "@agentshouse/mdruntime": "0.1.0-c7bd7ca3faee4"
+    "@agentshouse/mdruntime": "0.1.0-c24bc09d750de"
   },
   "files": [
     "dist",