@agentshouse/app-bridge 0.1.0-c2dfa65932edd → 0.1.0-c2e4124b00b94

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,5 +1,11 @@
 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;
@@ -105,7 +111,7 @@ export interface HouseBrowserRefused extends Error {
     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>;
@@ -129,4 +135,3 @@ export interface HouseHeld {
     readonly houseBridge: HouseBridge;
 }
 export declare const houseBridge: () => HouseBridge;
-export {};

package/dist/test-host.js

@@ -29,6 +29,21 @@ function navigationRefused(address) {
         address,
     });
 }
+function followHeld(listeners, listener, held) {
+    let following = true;
+    queueMicrotask(() => {
+        if (!following)
+            return;
+        listeners.add(listener);
+        const value = held();
+        if (value !== null)
+            listener(value);
+    });
+    return () => {
+        following = false;
+        listeners.delete(listener);
+    };
+}
 export function createHouseBridgeTestHost(options = {}) {
     const navigations = [];
     const ceremonies = [];
@@ -63,7 +78,17 @@ export function createHouseBridgeTestHost(options = {}) {
         });
     }
     function navigate(mode, asked) {
-        const target = sameOriginPath(asked);
+        let path = asked;
+        if (/^https?:\/\//i.test(asked)) {
+            try {
+                const target = new URL(asked);
+                path = target.origin === HOST_ORIGIN ? target.pathname + target.search + target.hash : '';
+            }
+            catch {
+                path = '';
+            }
+        }
+        const target = sameOriginPath(path);
         if (target === null)
             return Promise.reject(navigationRefused(asked));
         navigations.push({ mode, address: target });
@@ -76,10 +101,7 @@ export function createHouseBridgeTestHost(options = {}) {
         runtime,
         address: () => shown,
         onAddress(listener) {
-            addressListeners.add(listener);
-            return () => {
-                addressListeners.delete(listener);
-            };
+            return followHeld(addressListeners, listener, () => shown);
         },
         push: (asked) => navigate('push', asked),
         replace: (asked) => navigate('replace', asked),
@@ -106,10 +128,7 @@ export function createHouseBridgeTestHost(options = {}) {
         readSiteScreenshot: (site) => Promise.resolve(options.siteScreenshots?.[site] ?? null),
         status: () => seen,
         onStatus(listener) {
-            statusListeners.add(listener);
-            return () => {
-                statusListeners.delete(listener);
-            };
+            return followHeld(statusListeners, listener, () => seen);
         },
         messages(listener) {
             messageListeners.add(listener);

package/docs/families.md

@@ -39,7 +39,9 @@
   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.
+  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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-c2dfa65932edd",
+  "version": "0.1.0-c2e4124b00b94",
   "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-cd3ee807e46ae"
+    "@agentshouse/mdruntime": "0.1.0-c16fc8caac7ff"
   },
   "files": [
     "dist",