@agentshouse/app-bridge 0.1.0-caae3da69c1c2 → 0.1.0-cad9b7e2b6d0c

package/README.md

@@ -3,16 +3,16 @@
 The types of the agents.house App bridge, an accessor and an in-page test host.
 House builds the bridge object in every App it serves and hands it to the page
 before the App's own scripts run; `houseBridge()` returns that object, so an App
-carries no bridge code of its own. It carries eleven families: navigation,
+carries no bridge code of its own. It carries twelve families: navigation,
 ceremonies, installation, notifications, status, Site image reads, App release
-code, external calls, App messages and App and Site screenshot reads.
+code, external calls, App messages, App and Site screenshot reads and the Chat.
 [docs/families.md](docs/families.md) describes each and the test host.
 
 The bridge carries no credential handling and no Runtime family. House builds
-the MD Runtime client into the page beside the bridge, and `bridge.runtime`
-resolves to that client, so the App imports and constructs none.
+the MD Runtime client into the page beside the bridge and serves it the Chat, so
+the App imports, constructs and bundles neither: `bridge.runtime` resolves to the client.
 
-House's `find_command` "App" is the guide to building an App or a Site.
+House's guide to building an App is its Guide's `apps/` pages, which `open_guide` opens.
 
 ## Use
 

package/dist/calls.d.ts

@@ -16,18 +16,18 @@ export interface HouseMethods {
                 readonly user_name: string;
                 readonly entries: readonly {
                     readonly namespace: string;
-                    readonly read: 'mcp' | 'online' | 'local' | null;
+                    readonly level: 'search' | 'open' | 'keep' | null;
                     readonly operations: readonly ('write' | 'delete' | 'export' | 'manageAccess')[];
                     readonly sources: readonly {
                         readonly kind: 'direct' | 'inherited';
                         readonly namespace: string;
-                        readonly read: 'mcp' | 'online' | 'local' | null;
+                        readonly level: 'search' | 'open' | 'keep' | null;
                         readonly operations: readonly ('write' | 'delete' | 'export' | 'manageAccess')[];
                     }[];
                 }[];
                 readonly direct: readonly {
                     readonly namespace: string;
-                    readonly read: 'mcp' | 'online' | 'local' | null;
+                    readonly level: 'search' | 'open' | 'keep' | null;
                     readonly operations: readonly ('write' | 'delete' | 'export' | 'manageAccess')[];
                 }[];
                 readonly admitted_at: string | null;
@@ -68,6 +68,7 @@ export interface HouseMethods {
         readonly params: {
             readonly agent_id: string;
             readonly operation_id?: string;
+            readonly replaces?: string;
         };
         readonly result: {
             readonly agent_id: string;
@@ -192,40 +193,13 @@ export interface HouseMethods {
     readonly 'conversation.send': {
         readonly params: {
             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 text: string;
         };
         readonly result: {
             readonly agent_id: string;
             readonly authority: string;
             readonly conversation_id: string;
-            readonly files: readonly {
-                readonly name: string;
-                readonly media_type: string | null;
-                readonly dimensions: {
-                    readonly width: number;
-                    readonly height: number;
-                } | null;
-                readonly bytes: number;
-                readonly sha256: string;
-                readonly file: string | null;
-                readonly page: string;
-                readonly upload?: {
-                    readonly method: 'POST';
-                    readonly operation: string;
-                    readonly url: string;
-                    readonly expires_at: string;
-                };
-            }[];
             readonly log_epoch: string;
             readonly message_id: string;
             readonly position: string;
@@ -253,7 +227,7 @@ export interface HouseMethods {
         readonly params: Readonly<Record<string, never>>;
         readonly result: {
             readonly features: readonly {
-                readonly feature: 'microphone' | 'camera' | 'geolocation' | 'clipboard-read' | 'notifications';
+                readonly feature: string;
                 readonly allowed: boolean;
             }[];
         };
@@ -278,6 +252,86 @@ export interface HouseMethods {
             readonly log_epoch: string;
         };
     };
+    readonly 'inboxChat.assign': {
+        readonly params: {
+            readonly room_ref: string;
+            readonly path: string;
+            readonly assignee: {
+                readonly user: string;
+            } | {
+                readonly agent: string;
+            } | null;
+        };
+        readonly result: {
+            readonly room_ref: string;
+            readonly path: string;
+            readonly assignee: {
+                readonly user: string;
+                readonly name: string;
+            } | {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly return_to: {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly authority: string;
+            readonly position: string;
+            readonly log_epoch: string;
+            readonly url: string;
+        };
+    };
+    readonly 'inboxChat.return': {
+        readonly params: {
+            readonly room_ref: string;
+            readonly path: string;
+        };
+        readonly result: {
+            readonly room_ref: string;
+            readonly path: string;
+            readonly assignee: {
+                readonly user: string;
+                readonly name: string;
+            } | {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly return_to: {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly authority: string;
+            readonly position: string;
+            readonly log_epoch: string;
+            readonly url: string;
+        };
+    };
+    readonly 'inboxChat.takeControl': {
+        readonly params: {
+            readonly room_ref: string;
+            readonly path: string;
+        };
+        readonly result: {
+            readonly room_ref: string;
+            readonly path: string;
+            readonly assignee: {
+                readonly user: string;
+                readonly name: string;
+            } | {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly return_to: {
+                readonly agent: string;
+                readonly name: string;
+            } | null;
+            readonly authority: string;
+            readonly position: string;
+            readonly log_epoch: string;
+            readonly url: string;
+        };
+    };
     readonly 'member.list': {
         readonly params: {
             readonly room_ref: string;
@@ -292,7 +346,8 @@ export interface HouseMethods {
                 readonly owner: boolean;
                 readonly email?: string;
                 readonly since: string | null;
-                readonly access?: 'owner' | 'manage' | 'edit' | 'read';
+                readonly access?: 'owner' | 'manage' | 'edit' | 'keep' | 'open' | 'search';
+                readonly only_while_online?: true;
                 readonly member_document: string | null;
                 readonly schema_roles?: readonly string[];
             }[];
@@ -347,48 +402,19 @@ export interface HouseMethods {
     readonly 'record.list': {
         readonly params: {
             readonly room_ref: string;
-            readonly record?: string;
             readonly cursor?: string;
             readonly limit?: number;
             readonly order?: 'asc' | 'desc';
         };
         readonly result: {
-            readonly attachments: readonly {
-                readonly bytes: number;
-                readonly file: string;
-                readonly media_type: string | null;
-                readonly name: string | null;
-                readonly referrer: {
-                    readonly record: string;
-                    readonly room_ref: string;
-                };
-                readonly sha256: string;
-            }[];
-            readonly body: string | null;
-            readonly claimed: unknown;
-            readonly created_at: string;
-            readonly record: string;
-            readonly ref: string;
-        } | {
-            readonly next_cursor?: string;
             readonly records: readonly {
-                readonly attachments: readonly {
-                    readonly bytes: number;
-                    readonly file: string;
-                    readonly media_type: string | null;
-                    readonly name: string | null;
-                    readonly referrer: {
-                        readonly record: string;
-                        readonly room_ref: string;
-                    };
-                    readonly sha256: string;
-                }[];
-                readonly body: string | null;
-                readonly claimed: unknown;
-                readonly created_at: string;
                 readonly record: string;
                 readonly ref: string;
+                readonly created_at: string;
+                readonly body: string | null;
+                readonly claimed: unknown;
             }[];
+            readonly next_cursor?: string;
         };
     };
     readonly 'relay.read': {
@@ -468,11 +494,7 @@ export interface HouseMethods {
                     readonly reach: 'selected';
                     readonly refs: readonly string[];
                 };
-                readonly accounts?: readonly {
-                    readonly id: string;
-                    readonly name: string;
-                    readonly origin: string;
-                }[];
+                readonly key_origins?: readonly string[];
                 readonly url: string;
             }[];
         };
@@ -488,11 +510,11 @@ export interface HouseMethods {
                 readonly name: string;
                 readonly email: string;
                 readonly used: number;
-                readonly quota: number | null;
+                readonly allowance: number | null;
             } | {
                 readonly room: string;
                 readonly used: number;
-                readonly quota: number | null;
+                readonly allowance: number | null;
                 readonly url: string;
             })[];
         };
@@ -585,292 +607,6 @@ export interface HouseMethods {
             readonly submitted: true;
         };
     };
-    readonly 'trigger.list': {
-        readonly params: {
-            readonly room_ref: string;
-        };
-        readonly result: {
-            readonly triggers: readonly {
-                readonly trigger: string;
-                readonly creator: {
-                    readonly user: string;
-                    readonly name: string;
-                };
-                readonly description: string;
-                readonly condition: {
-                    readonly on: 'documents';
-                    readonly scope: {
-                        readonly type: string;
-                    } | {
-                        readonly folder: string;
-                    } | {
-                        readonly document: string;
-                    };
-                    readonly mode: 'starts_matching';
-                    readonly new_documents: boolean;
-                    readonly match: {
-                        readonly all: readonly unknown[];
-                    } | {
-                        readonly any: readonly unknown[];
-                    } | {
-                        readonly not: unknown;
-                    } | {
-                        readonly path: string;
-                        readonly eq: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly in: readonly (string | number | boolean)[];
-                    } | {
-                        readonly path: string;
-                        readonly exists: boolean;
-                    } | {
-                        readonly path: string;
-                        readonly contains: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly gt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly gte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly prefix: string;
-                    };
-                    readonly by?: {
-                        readonly all: readonly unknown[];
-                    } | {
-                        readonly any: readonly unknown[];
-                    } | {
-                        readonly not: unknown;
-                    } | {
-                        readonly path: string;
-                        readonly eq: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly in: readonly (string | number | boolean)[];
-                    } | {
-                        readonly path: string;
-                        readonly exists: boolean;
-                    } | {
-                        readonly path: string;
-                        readonly contains: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly gt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly gte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly prefix: string;
-                    };
-                } | {
-                    readonly on: 'documents';
-                    readonly scope: {
-                        readonly type: string;
-                    } | {
-                        readonly folder: string;
-                    } | {
-                        readonly document: string;
-                    };
-                    readonly mode: 'field_changes';
-                    readonly field: string;
-                    readonly from?: readonly (string | number | boolean)[] | 'new';
-                    readonly to?: readonly (string | number | boolean)[] | 'deleted';
-                    readonly match?: {
-                        readonly all: readonly unknown[];
-                    } | {
-                        readonly any: readonly unknown[];
-                    } | {
-                        readonly not: unknown;
-                    } | {
-                        readonly path: string;
-                        readonly eq: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly in: readonly (string | number | boolean)[];
-                    } | {
-                        readonly path: string;
-                        readonly exists: boolean;
-                    } | {
-                        readonly path: string;
-                        readonly contains: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly gt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly gte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly prefix: string;
-                    };
-                    readonly by?: {
-                        readonly all: readonly unknown[];
-                    } | {
-                        readonly any: readonly unknown[];
-                    } | {
-                        readonly not: unknown;
-                    } | {
-                        readonly path: string;
-                        readonly eq: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly in: readonly (string | number | boolean)[];
-                    } | {
-                        readonly path: string;
-                        readonly exists: boolean;
-                    } | {
-                        readonly path: string;
-                        readonly contains: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly gt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly gte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly prefix: string;
-                    };
-                } | {
-                    readonly on: 'items';
-                    readonly source?: string;
-                    readonly address?: string;
-                    readonly match?: {
-                        readonly all: readonly unknown[];
-                    } | {
-                        readonly any: readonly unknown[];
-                    } | {
-                        readonly not: unknown;
-                    } | {
-                        readonly path: string;
-                        readonly eq: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly in: readonly (string | number | boolean)[];
-                    } | {
-                        readonly path: string;
-                        readonly exists: boolean;
-                    } | {
-                        readonly path: string;
-                        readonly contains: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly gt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly gte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly prefix: string;
-                    };
-                } | {
-                    readonly on: 'clock';
-                    readonly cron: string;
-                    readonly time_zone: string;
-                } | {
-                    readonly on: 'clock';
-                    readonly scope: {
-                        readonly type: string;
-                    };
-                    readonly date: string;
-                    readonly days: number;
-                    readonly at: string;
-                    readonly time_zone: string;
-                    readonly match?: {
-                        readonly all: readonly unknown[];
-                    } | {
-                        readonly any: readonly unknown[];
-                    } | {
-                        readonly not: unknown;
-                    } | {
-                        readonly path: string;
-                        readonly eq: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly in: readonly (string | number | boolean)[];
-                    } | {
-                        readonly path: string;
-                        readonly exists: boolean;
-                    } | {
-                        readonly path: string;
-                        readonly contains: string | number | boolean;
-                    } | {
-                        readonly path: string;
-                        readonly gt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly gte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lt: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly lte: number | string;
-                    } | {
-                        readonly path: string;
-                        readonly prefix: string;
-                    };
-                };
-                readonly enabled: boolean;
-                readonly paused_by?: 'types';
-                readonly actions: readonly ({
-                    readonly kind: 'notify';
-                    readonly enabled: boolean;
-                    readonly title: string;
-                    readonly text: string;
-                    readonly to: {
-                        readonly users: readonly string[];
-                        readonly fields: readonly string[];
-                        readonly roles: readonly string[];
-                    };
-                    readonly holds: boolean;
-                } | {
-                    readonly kind: 'routine';
-                    readonly enabled: boolean;
-                    readonly access?: string;
-                    readonly payload: string;
-                    readonly references: readonly {
-                        readonly room_ref: string;
-                        readonly ref: string;
-                        readonly url: string;
-                    }[];
-                    readonly holds: boolean;
-                })[];
-            }[];
-        };
-    };
     readonly 'triggerOccurrence.list': {
         readonly params: {
             readonly room_ref: string;
@@ -889,10 +625,15 @@ export interface HouseMethods {
                 } | {
                     readonly position: number;
                     readonly outcome: 'no_target';
+                    readonly code: 'no_recipient' | 'routine_access_not_found' | 'routine_retired' | 'target_agent_unavailable' | 'app_not_found' | 'app_function_not_found';
                 } | {
                     readonly position: number;
                     readonly outcome: 'requested';
                     readonly request: string;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'continued';
+                    readonly request: string;
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
@@ -901,12 +642,12 @@ export interface HouseMethods {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'limit_reached';
-                    readonly limit: 'sites' | 'custom_domains' | 'publish_data' | 'site_submissions' | 'address_submissions' | 'house_writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | 'external_calls' | 'export_starts' | 'routine_requests' | 'routine_mail' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_sockets';
+                    readonly limit: 'sites' | 'custom_domains' | 'publish_data' | 'site_submissions' | 'mcp_reads' | 'mcp_downloads' | 'external_calls' | 'routine_requests' | 'routine_mail';
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'limit_reached';
-                    readonly limit: 'sites' | 'custom_domains' | 'publish_data' | 'site_submissions' | 'address_submissions' | 'house_writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | 'external_calls' | 'export_starts' | 'routine_requests' | 'routine_mail' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_sockets';
+                    readonly limit: 'sites' | 'custom_domains' | 'publish_data' | 'site_submissions' | 'mcp_reads' | 'mcp_downloads' | 'external_calls' | 'routine_requests' | 'routine_mail';
                     readonly retry_at: string;
                 } | {
                     readonly position: number;
@@ -927,22 +668,49 @@ export interface HouseMethods {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'limit_reached';
-                    readonly limit: 'house_writes';
+                    readonly limit: 'writes';
                     readonly period: 'minute' | 'day';
                     readonly retry_at: string;
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
-                    readonly code: 'limit_reached';
-                    readonly limit: 'mcp_reads' | 'mcp_downloads';
-                    readonly value: string;
+                    readonly code: 'cap_reached';
+                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'service_keys' | 'shared_schemas' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections' | 'open_uploads' | 'waiting_web_wizards' | 'folder_subscriptions';
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'refused';
+                    readonly code: 'cap_reached';
+                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'service_keys' | 'shared_schemas' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections' | 'open_uploads' | 'waiting_web_wizards' | 'folder_subscriptions';
                     readonly retry_at: string;
                 } | {
                     readonly position: number;
                     readonly outcome: 'withdrawn';
+                    readonly code: 'agent_unavailable';
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'failed';
+                    readonly code: 'internal_error' | 'routine_request_not_started';
                 } | {
                     readonly position: number;
                     readonly outcome: 'failed';
+                    readonly code: 'function_failed';
+                    readonly error: string;
+                    readonly release: string;
+                    readonly final: true;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'failed';
+                    readonly code: 'function_not_started';
+                    readonly tries: number;
+                    readonly final?: true;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'running';
+                    readonly release: string;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'ran';
+                    readonly release: string;
                 } | {
                     readonly position: number;
                     readonly outcome: 'waiting';