@agentshouse/app-bridge 0.1.0-alpha.11 → 0.1.0-alpha.12

package/README.md

@@ -70,6 +70,10 @@ port's one listener. It carries nine families:
   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.
 
 The package carries no credential handling and no Runtime family. It surfaces
 the dedicated Runtime port the worker transfers over the bridge as a plain
@@ -131,7 +135,8 @@ records in `consents` each
 choice leaves, records in `tabs` each `setTab` the shell would take and ignores
 any other, answers a release code read from the `sources` it was given, or
 `null`, answers `readScreenshot` from the `screenshots` it was given by App
-reference, answers every `install()` `'manual'`, as a browser with no install
+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 attaches a Runtime port.

package/client/src/bridge.d.ts

@@ -30,6 +30,7 @@ export interface HouseBridge {
     sourceTop(app: string, release?: string): Promise<HouseSourceTop | HouseSourceRefusal | null>;
     sourceDownload(app: string, release?: string): Promise<HouseSourceDownload | HouseSourceRefusal | null>;
     readScreenshot(app: string): Promise<Blob | null>;
+    readSiteScreenshot(site: string): Promise<Blob | null>;
     status(): HouseStatus | null;
     onStatus(listener: (status: HouseStatus) => void): () => void;
     messages(listener: (message: HouseAppMessage) => void): () => void;

package/client/src/bridge.js

@@ -179,6 +179,13 @@ export function connectHouseBridge(source = heldBridge()) {
         send({ house, id, app, release });
         return pending.promise;
     }
+    function screenshot(house, asked) {
+        const pending = settled();
+        const id = ++nextScreenshot;
+        screenshots.set(id, pending.settle);
+        send({ house, id, ...asked });
+        return pending.promise;
+    }
     function navigate(mode, asked) {
         const pending = settled();
         navigations.push({ address: asked, settle: pending.settle });
@@ -246,11 +253,10 @@ export function connectHouseBridge(source = heldBridge()) {
             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;
+            return screenshot('screenshot-read', { app });
+        },
+        readSiteScreenshot(site) {
+            return screenshot('site-screenshot-read', { site });
         },
         status() {
             return status;

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

@@ -27,5 +27,6 @@ export interface HouseBridgeTestHostOptions {
         readonly download: HouseSourceDownload;
     }[];
     readonly screenshots?: Readonly<Record<string, Blob>>;
+    readonly siteScreenshots?: Readonly<Record<string, Blob>>;
 }
 export declare function createHouseBridgeTestHost(options?: HouseBridgeTestHostOptions): HouseBridgeTestHost;

package/client/src/test-host.js

@@ -123,6 +123,11 @@ export function createHouseBridgeTestHost(options = {}) {
             const held = typeof asked.app === 'string' ? options.screenshots?.[asked.app] : undefined;
             deliver({ house: 'screenshot', id: asked.id, image: held ?? null });
         }
+        else if (data.house === 'site-screenshot-read') {
+            const asked = data;
+            const held = typeof asked.site === 'string' ? options.siteScreenshots?.[asked.site] : undefined;
+            deliver({ house: 'screenshot', id: asked.id, image: held ?? null });
+        }
     }
     const port = {
         postMessage(message) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-alpha.11",
-  "description": "Renderer-side client of the agents.house App bridge: navigation, the tab title and icon, ceremonies, installation, notifications and the icon badge, status, Site image reads, App release code and App screenshot reads, and App messages, with an in-page test host.",
+  "version": "0.1.0-alpha.12",
+  "description": "Renderer-side client of the agents.house App bridge: 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 in-page test host.",
   "license": "UNLICENSED",
   "type": "module",
   "sideEffects": false,