@agentshouse/app-bridge 0.1.0-c7704ffcd24b7 → 0.1.0-c77623f54a39b

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

@@ -64,23 +64,11 @@ export interface HouseMethods {
             readonly url: string;
         };
     };
-    readonly 'conversation.attach': {
-        readonly params: {
-            readonly blob: Blob;
-            readonly byteLength: number;
-            readonly contentHash: string;
-            readonly mediaType: string;
-            readonly name: string;
-            readonly room: string;
-        };
-        readonly result: {
-            readonly path: string;
-        };
-    };
     readonly 'conversation.create': {
         readonly params: {
             readonly agent_id: string;
             readonly operation_id?: string;
+            readonly replaces?: string;
         };
         readonly result: {
             readonly agent_id: string;
@@ -239,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;
             }[];
         };
@@ -264,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;
@@ -333,48 +401,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': {
@@ -571,293 +610,6 @@ export interface HouseMethods {
             readonly submitted: true;
         };
     };
-    readonly 'trigger.list': {
-        readonly params: {
-            readonly room_refs: readonly string[];
-        };
-        readonly result: {
-            readonly rooms: readonly {
-                readonly room_ref: string;
-                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 moved_between_rooms?: boolean;
-                    } | {
-                        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 moved_between_rooms?: boolean;
-                    } | {
-                        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 holds: boolean;
-                    })[];
-                }[];
-                readonly url: string;
-            }[];
-        };
-    };
     readonly 'triggerOccurrence.list': {
         readonly params: {
             readonly room_ref: string;
@@ -876,10 +628,15 @@ export interface HouseMethods {
                 } | {
                     readonly position: number;
                     readonly outcome: 'no_target';
+                    readonly code: 'no_recipient' | 'routine_access_not_found' | 'routine_retired' | 'target_agent_unavailable';
                 } | {
                     readonly position: number;
                     readonly outcome: 'requested';
                     readonly request: string;
+                } | {
+                    readonly position: number;
+                    readonly outcome: 'continued';
+                    readonly request: string;
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
@@ -888,12 +645,12 @@ export interface HouseMethods {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'limit_reached';
-                    readonly limit: 'sites' | 'custom_domains' | 'publish_data' | 'site_submissions' | 'external_calls' | 'routine_requests' | 'routine_mail';
+                    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' | 'external_calls' | 'routine_requests' | 'routine_mail';
+                    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;
@@ -917,30 +674,25 @@ export interface HouseMethods {
                     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 retry_at: string;
                 } | {
                     readonly position: number;
                     readonly outcome: 'refused';
                     readonly code: 'cap_reached';
-                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections' | 'open_uploads';
+                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | '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' | 'external_accounts' | 'export_starts' | 'share_creations' | 'share_room_creations' | 'live_shares' | 'ownership_offers' | 'site_rooms' | 'slot_rooms' | 'room_triggers' | 'app_sockets' | 'kit_connections' | 'open_uploads';
+                    readonly cap: 'address_submissions' | 'writes' | 'push_addresses' | 'push_deliveries' | 'external_accounts' | '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: 'waiting';

package/dist/index.d.ts

@@ -21,7 +21,7 @@ export interface HouseCredentialState {
     readonly state: Open<'none' | 'held' | 'rejected'>;
     readonly expiresAt: number | null;
 }
-export type HouseDatabaseFailure = 'unsupported' | 'damaged' | 'update-required';
+export type HouseDatabaseFailure = 'unsupported' | 'damaged';
 export type HouseAnalyticsChoice = 'accept' | 'decline';
 export interface HouseAnalytics {
     readonly measures: boolean;
@@ -81,7 +81,6 @@ export interface HouseExternalRequest {
     readonly body?: string;
     readonly body_base64?: string;
     readonly account?: string;
-    readonly slot?: string;
     readonly room_ref?: string;
 }
 export type HouseExternalAnswer = {
@@ -132,10 +131,32 @@ export interface HouseCooperation {
     capture(): Promise<HouseTask> | HouseTask;
     restore(task: HouseTask | null): Promise<void> | void;
     ready(): Promise<boolean> | boolean;
+    placed?(): Promise<void> | void;
     settle(activation: HouseActivation): void;
 }
+export type HouseChatWidth = 'full' | '3/4' | '1/2' | '1/3';
+export interface HouseChatOpened {
+    readonly conversation: string | null;
+    readonly agent: string | null;
+}
+export interface HouseChatOptions {
+    readonly conversation?: string | null;
+    readonly agent?: string | null;
+    readonly showChats?: boolean;
+    readonly width?: HouseChatWidth;
+    readonly onOpen?: (opened: HouseChatOpened) => void;
+    readonly onLink?: (href: string) => void;
+}
+export interface HouseMountedChat {
+    update(options: HouseChatOptions): void;
+    unmount(): void;
+}
+export interface HouseChat {
+    mount(element: object, options?: HouseChatOptions): Promise<HouseMountedChat>;
+}
 export interface HouseBridge {
     readonly runtime: Promise<HouseRuntime>;
+    readonly chat: HouseChat;
     address(): string | null;
     onAddress(listener: (address: string) => void): () => void;
     push(address: string): Promise<string>;

package/dist/mdmodel/condition.d.ts

@@ -103,6 +103,7 @@ export type DocumentFacts = {
     readonly fields: Readonly<Record<string, Fact>>;
     readonly sections: readonly string[];
 };
+export declare const TEXT_FIELD = "/text";
 export declare const WRITE_DOORS: readonly ['browser', 'agent', 'client'];
 export type WriteDoor = (typeof WRITE_DOORS)[number];
 export type Actor = {
@@ -121,7 +122,6 @@ export type ItemFacts = {
     readonly delivery: string;
     readonly source: string | null;
     readonly address: string | null;
-    readonly has_attachment: boolean;
     readonly container: string | null;
     readonly author: string | null;
     readonly headers: Readonly<Record<string, string>>;

package/dist/mdmodel/definition.d.ts

@@ -60,6 +60,7 @@ export declare const JSON_TYPES: readonly JsonType[];
 export declare const BUILT_IN_TYPE = "any";
 export declare const ATTACHMENT = "attachment";
 export declare const ARRAY_INDEX: RegExp;
+export declare const JSON_POINTER: RegExp;
 export declare function escapePointer(key: string): string;
 export declare function pointerSegments(pointer: string): string[];
 export declare function refTarget(reference: string, defs: Readonly<Record<string, unknown>>): {

package/dist/mdmodel/index.d.ts

@@ -1,4 +1,4 @@
-export { ACTOR_PATHS, actorOperators, changeFields, CONDITION_OPERATORS, dated, datePointers, DOCUMENT_PATHS, factKind, facts, fires, holds, instant, ITEM_PATHS, itemFires, itemKind, itemOperators, memberPointers, members, pointed, prosePaths, testOperators, valuedChange, WRITE_DOORS, } from './condition.js';
+export { ACTOR_PATHS, actorOperators, changeFields, CONDITION_OPERATORS, dated, datePointers, DOCUMENT_PATHS, factKind, facts, fires, holds, instant, ITEM_PATHS, itemFires, itemKind, itemOperators, memberPointers, members, pointed, prosePaths, testOperators, TEXT_FIELD, valuedChange, WRITE_DOORS, } from './condition.js';
 export type { Actor, Condition, ConditionOperator, ConditionScope, ConditionTest, ConditionValue, CronCondition, DateCondition, DocumentCondition, DocumentEvent, DocumentFacts, Fact, FactKind, ItemCondition, ItemFacts, Resolved, WriteDoor, } from './condition.js';
 export { headingLines } from './blocks.js';
 export type { HeadingLine } from './blocks.js';
@@ -10,10 +10,11 @@ export type { RoomTarget } from './paths.js';
 export { MARKDOWN_SYNTAX_PROFILE } from './profile.js';
 export { project } from './project.js';
 export { references } from './references.js';
-export { ARRAY_INDEX, ATTACHMENT, crossedFacts, escapePointer, itemFacts, memberFacts, pointerFacts, pointerSegments, } from './definition.js';
+export { ARRAY_INDEX, ATTACHMENT, crossedFacts, escapePointer, itemFacts, JSON_POINTER, memberFacts, pointerFacts, pointerSegments, } from './definition.js';
 export type { Definition, FieldRules, JsonType, PatternFacts, PointerFacts, RuleValue, SectionSpec, Shape, Transition, ValueFacts, } from './definition.js';
 export type { ApplyResult, BodyResult, Change, Division, DivisionContext, Document, DocumentCheck, Frontmatter, FrontmatterResult, Library, ModelVerification, Link, ParseResult, Projection, ProjectionContext, Reached, Reference, Refusal, RoomReference, Span, Validation, ValidationContext, ValidationStep, VerifiedModel, } from './types.js';
-export { bodyRoomLinks, checkDocument, resolves, roomReferences, sectionReferences, validate, validating, verify, } from './validate.js';
+export { assess, bodyRoomLinks, checkDocument, resolves, roomReferences, sectionReferences, validate, validating, verdicts, verify, } from './validate.js';
+export type { Assessment, Verdicts } from './validate.js';
 export { VERSION } from './version.js';
 export { bodyAfterFrontmatter, equalValue, frontmatterValue } from './yaml.js';
 export type { FrontmatterValue } from './yaml.js';

package/dist/mdmodel/types.d.ts

@@ -2,6 +2,7 @@ import type { Definition } from './definition.js';
 export type Library = Readonly<Record<string, string>>;
 export type VerifiedModel = {
     readonly types: Readonly<Record<string, Definition>>;
+    readonly nameable?: readonly string[];
 };
 export type ModelVerification = {
     readonly verdict: 'accept';