@agentshouse/app-bridge 0.1.0-alpha.7 → 0.1.0-alpha.8

package/README.md

@@ -2,7 +2,7 @@
 
 The renderer-side client of the agents.house App bridge. An App served by House
 receives one message port before its own scripts run; this package is that
-port's one listener. It carries five families:
+port's one listener. It carries six 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
@@ -39,6 +39,11 @@ port's one listener. It carries five families:
   refusal is House's `{ error: { code } }`, `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`.
+- **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.
 
 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
@@ -99,4 +104,5 @@ records in `consents` each
 `gaConsent` it takes while that status measures and publishes the status the
 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`, and attaches a Runtime port.
+`null`, answers `readScreenshot` from the `screenshots` it was given by App
+reference, and attaches a Runtime port.

package/client/src/bridge.d.ts

@@ -24,6 +24,7 @@ export interface HouseBridge {
     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;

package/client/src/bridge.js

@@ -35,6 +35,8 @@ export function connectHouseBridge(source = heldBridge()) {
     let nextAttachment = 0;
     const sources = new Map();
     let nextSource = 0;
+    const screenshots = new Map();
+    let nextScreenshot = 0;
     const addressListeners = new Set();
     const statusListeners = new Set();
     let outbox = [];
@@ -101,6 +103,17 @@ export function connectHouseBridge(source = heldBridge()) {
             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;
@@ -170,6 +183,13 @@ export function connectHouseBridge(source = heldBridge()) {
         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;
         },

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

@@ -25,5 +25,6 @@ export interface HouseBridgeTestHostOptions {
         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

@@ -109,6 +109,11 @@ export function createHouseBridgeTestHost(options = {}) {
                     },
             });
         }
+        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) {

package/package.json

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