@agentshouse/app-bridge 0.1.0-c6f0ca4067690 → 0.1.0-c6f4d423ead48

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,19 +64,6 @@ 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;
@@ -240,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;
             }[];
         };
@@ -623,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;
@@ -928,6 +628,7 @@ 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';
@@ -987,9 +688,11 @@ export interface HouseMethods {
                 } | {
                     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;
@@ -134,8 +134,29 @@ export interface HouseCooperation {
     ready(): Promise<boolean> | boolean;
     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/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';

package/dist/mdruntime/adapter.d.ts

@@ -50,7 +50,7 @@ export type ListedConversation = {
     outcome: string | null;
     waiting: boolean;
 };
-export type ConversationAction = 'conversation.create' | 'conversation.send' | 'conversation.attach' | 'conversation.answer' | 'conversation.interrupt' | 'conversation.kill' | 'conversation.cancel' | 'conversation.delete' | 'conversation.history';
+export type ConversationAction = 'conversation.create' | 'conversation.send' | 'conversation.answer' | 'conversation.interrupt' | 'conversation.kill' | 'conversation.cancel' | 'conversation.delete' | 'conversation.history';
 export type ConversationMessage = {
     identity: string;
     turn: string;
@@ -298,7 +298,6 @@ export type BootstrapInventory = {
 };
 export type RoomModels = {
     collection?: ModelResult;
-    selection?: ModelResult;
 };
 export type BootstrapPage = {
     kind: 'bootstrap';
@@ -432,6 +431,22 @@ export type BinaryLinkResult = {
     kind: 'link';
     url: string;
     name: string;
+    mediaType?: string;
+} | (ProviderRefusal & {
+    kind: 'rejected';
+}) | AdapterFailure;
+export type AttachRequest = {
+    locator: string;
+    name: string;
+    mediaType: string;
+    byteLength: number;
+    sha256: string;
+    blob: Blob;
+};
+export type AttachResult = {
+    kind: 'attached';
+    path: string;
+    revision: string;
 } | (ProviderRefusal & {
     kind: 'rejected';
 }) | AdapterFailure;
@@ -495,6 +510,7 @@ export type Adapter = {
     readonly localSaves?: true;
     readonly exhaustiveDiscovery?: true;
     readonly roomTypes?: string;
+    readonly nameableRoomTypes?: readonly string[];
     authorize(): Promise<Authorization>;
     discover(authorization: Authorization, scope?: DiscoveryScope): Promise<DiscoverResult>;
     bootstrap(authorization: Authorization, request: BootstrapRequest): Promise<BootstrapResult>;
@@ -503,6 +519,7 @@ export type Adapter = {
     history(authorization: Authorization, request: HistoryRequest): Promise<HistoryResult>;
     binary(authorization: Authorization, request: BinaryRequest): Promise<BinaryResult>;
     link(authorization: Authorization, request: BinaryRequest): Promise<BinaryLinkResult>;
+    attach(authorization: Authorization, request: AttachRequest): Promise<AttachResult>;
     action(authorization: Authorization, request: ActionRequest): Promise<ActionResult>;
     reached(locator: string, roomVersion: string, target: string): boolean;
     follows(locator: string, roomVersion: string, next: string): boolean;

package/dist/mdruntime/client.d.ts

@@ -2,8 +2,7 @@ import type { AppRoom, ConnectionRefusal, HistoryQuery, RoomSchemas, SavedParts,
 import type { Member, ServiceMode } from './adapter.js';
 import type { ChatDraft, ConversationAgent, ConversationEntry, ConversationOptions, ConversationView } from './conversation.js';
 import { type Observation } from './observation.js';
-import type { ChosenFile } from './file.js';
-import type { BinaryAnswer, BinaryLinkAnswer, CallResult, HistoryAnswer, Offline, QueueEntry, Resolution } from './outcome.js';
+import type { AttachAnswer, BinaryAnswer, CallResult, DownloadAnswer, HistoryAnswer, Offline, QueueEntry, Resolution } from './outcome.js';
 import type { DocumentQuery, DocumentResult, GroupQuery, GroupResult, PendingResult } from './query.js';
 import type { RoomDraft, RoomDraftParts, RoomDraftWrite } from './room-draft.js';
 import type { SearchRequest, SearchResult } from './search.js';
@@ -21,7 +20,7 @@ export type MdRuntimeClient = {
     roomDraft: {
         list(): Promise<readonly RoomDraft[]>;
         read(room: string, path: string): Promise<RoomDraft | null>;
-        write(room: string, path: string, revision: string | null, parts: RoomDraftParts): Promise<RoomDraftWrite>;
+        write(room: string, path: string, revision: string | null, parts: RoomDraftParts, next?: string): Promise<RoomDraftWrite>;
         discard(room: string, path: string, revision: string): Promise<RoomDraftWrite>;
     };
     save(room: string, roomDrafts: readonly SavedRoomDraft[]): Promise<SaveResult>;
@@ -36,7 +35,6 @@ export type MdRuntimeClient = {
         read(conversation: string, options?: ConversationOptions): Promise<ConversationView>;
         create(input: unknown): Promise<CallResult>;
         send(conversation: string, operation?: string, draft?: ChatDraft): Promise<CallResult | Offline>;
-        attach(room: string, file: ChosenFile): Promise<CallResult | Offline>;
         answer(conversation: string, answer: unknown): Promise<CallResult>;
         interrupt(conversation: string): Promise<CallResult>;
         kill(conversation: string): Promise<CallResult>;
@@ -52,7 +50,8 @@ export type MdRuntimeClient = {
     resolve(room: string, path: string, destination: string): Promise<Resolution>;
     binaryFile: {
         read(room: string, path: string, revision?: string): Promise<BinaryAnswer>;
-        link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
+        attach(room: string, file: File): Promise<AttachAnswer>;
+        download(room: string, path: string, revision?: string): Promise<DownloadAnswer>;
     };
     call(name: string, input: unknown): Promise<CallResult>;
     reached(locator: string, roomVersion: string, path?: string): Promise<boolean>;
@@ -84,6 +83,8 @@ export type MdRuntimeClient = {
 export declare function connectMdRuntime(port: RuntimePort): MdRuntimeClient;
 export declare function inTurn(client: MdRuntimeClient, work: () => Promise<void>): Promise<void>;
 export { chainedWindows, type WindowAnswer, type WindowChain } from './chain.js';
+export { roomDraftRevision } from './identity.js';
+export { defineRoomMedia, ROOM_MEDIA } from './media.js';
 export type { Observation } from './observation.js';
 export type { Open } from './open.js';
 export { unanswered, type RuntimePort, type WireMember } from './wire.js';

package/dist/mdruntime/connection.d.ts

@@ -7,7 +7,7 @@ import { type Adapter, type Authorization, type Member, type ProviderRefusal, ty
 import { type ChatDraftSurface, type ConversationAgent, type ConversationEntry, type ConversationOptions, type ConversationSurface, type ConversationView } from './conversation.js';
 import { type WrittenBy } from './change.js';
 import type { Open } from './open.js';
-import { type BinaryLinkAnswer, type CallResult, type HeldBinaryAnswer, type HistoryAnswer, type QueueEntry, type Resolution } from './outcome.js';
+import { type AttachAnswer, type BinaryLinkAnswer, type CallResult, type HeldBinaryAnswer, type HeldShownAnswer, type HistoryAnswer, type QueueEntry, type Resolution } from './outcome.js';
 import { type Recovery } from './recovery.js';
 import { type SaveRefusal } from './save.js';
 import { type RoomDraft, type RoomDraftParts, type RoomDraftWrite } from './room-draft.js';
@@ -72,7 +72,7 @@ export type SavedParts = {
 export type RoomDraftSurface = {
     list(): Promise<readonly RoomDraft[]>;
     read(room: string, path: string): Promise<RoomDraft | null>;
-    write(room: string, path: string, revision: string | null, parts: unknown): Promise<RoomDraftWrite>;
+    write(room: string, path: string, revision: string | null, parts: unknown, next?: string): Promise<RoomDraftWrite>;
     discard(room: string, path: string, revision: string): Promise<RoomDraftWrite>;
 };
 export type PresentationSurface = {
@@ -83,6 +83,8 @@ export type PresentationSurface = {
 export type BinaryFileSurface = {
     read(room: string, path: string, revision?: string): Promise<HeldBinaryAnswer>;
     link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
+    show(room: string, path: string, revision?: string): Promise<HeldShownAnswer>;
+    attach(room: string, file: File): Promise<AttachAnswer>;
     part(file: string, part: number): Promise<Uint8Array | null>;
 };
 export type HistoryQuery = {

package/dist/mdruntime/conversation.d.ts

@@ -1,6 +1,5 @@
 import type { ConversationAction, ConversationAgents, ConversationEvent, ConversationMessage, ConversationStream, ProcessCommand, SessionOption, TurnContext } from './adapter.js';
 import { type ChangeSet } from './change-set.js';
-import { type ChosenFile } from './file.js';
 import type { Open } from './open.js';
 import { type CallResult, type Offline } from './outcome.js';
 import type { DocumentResult, PendingResult } from './query.js';
@@ -65,7 +64,6 @@ export type ConversationSurface = {
     read(conversation: string, options?: ConversationOptions): Promise<ConversationView>;
     create(input: unknown): Promise<CallResult>;
     send(conversation: string, operation?: string, draft?: ChatDraft): Promise<CallResult | Offline>;
-    attach(room: string, file: ChosenFile): Promise<CallResult | Offline>;
     answer(conversation: string, answer: unknown): Promise<CallResult>;
     interrupt(conversation: string): Promise<CallResult>;
     kill(conversation: string): Promise<CallResult>;

package/dist/mdruntime/identity.d.ts

@@ -0,0 +1,6 @@
+export declare function changeBatchIdentity(at?: number): string;
+export declare function identityTime(identity: string): number;
+export declare function roomDraftRevision(): string;
+export declare function chatDraftRevision(): string;
+export declare function transferIdentity(): string;
+export declare function binaryLocalId(): string;

package/dist/mdruntime/media.d.ts

@@ -0,0 +1,7 @@
+import type { MdRuntimeClient } from './client.js';
+import type { ShownAnswer } from './outcome.js';
+export declare const ROOM_MEDIA = "room-media";
+type Show = (room: string, path: string, revision?: string) => Promise<ShownAnswer>;
+export declare function shownBy(show: Show, client: MdRuntimeClient): MdRuntimeClient;
+export declare function defineRoomMedia(client: Promise<MdRuntimeClient> | MdRuntimeClient, registry?: CustomElementRegistry): void;
+export {};

package/dist/mdruntime/outcome.d.ts

@@ -1,4 +1,4 @@
-import type { ActionResult, AdapterFailure, BinaryLinkResult, HistoryResult, HistoryRevision, ProviderRefusal, RoomVersionAt, ScopedRefusal } from './adapter.js';
+import type { ActionResult, AdapterFailure, AttachResult, BinaryLinkResult, HistoryResult, HistoryRevision, ProviderRefusal, RoomVersionAt, ScopedRefusal } from './adapter.js';
 import type { ChangeBatch } from './change.js';
 import type { KeptBinary, KeptResult } from './opened.js';
 type Refused<Kind extends string> = ProviderRefusal & {
@@ -29,7 +29,17 @@ export type BinaryLinkAnswer = {
     kind: 'link';
     url: string;
     name: string;
+    mediaType: string;
 } | Refused<'rejected'> | Refused<'absent'> | Failure;
+export type HeldShownAnswer = KeptBinary | BinaryLinkAnswer;
+export type ShownAnswer = BinaryAnswer | BinaryLinkAnswer;
+export type AttachAnswer = {
+    kind: 'attached';
+    path: string;
+} | Offline | Refused<'rejected'> | Failure;
+export type DownloadAnswer = {
+    kind: 'started';
+} | Refused<'rejected'> | Refused<'absent'> | Refused<'blocked'> | Failure;
 export type Resolution = {
     readonly kind: 'document';
     readonly room: string;
@@ -45,7 +55,8 @@ export declare const LOCKED_UNREADABLE: Refused<'unreadable'>;
 export declare const ABSENT_TARGET: Refused<'absent'>;
 export declare function absentBinary(path: string): Refused<'absent'>;
 export declare function binaryAnswer(result: KeptResult): HeldBinaryAnswer;
-export declare function binaryLinkAnswer(result: BinaryLinkResult): BinaryLinkAnswer;
+export declare function binaryLinkAnswer(result: BinaryLinkResult, held?: string): BinaryLinkAnswer;
+export declare function attachAnswer(result: AttachResult): AttachAnswer;
 export declare const ROOM_LOCKED = "room-locked";
 export declare function lockedRoom(locator: string): Refused<'room-locked'> & {
     locator: string;

package/dist/mdruntime/query.d.ts

@@ -232,9 +232,15 @@ export type GroupShape = {
         direction: Direction;
     }[];
 };
+export type PlanArea = {
+    room: string;
+    path: string;
+    types: readonly string[];
+};
 export type PlanReach = {
     rooms: readonly string[];
     documents: readonly string[];
+    areas: readonly PlanArea[];
 };
 export type Continuation = {
     text: string;

package/dist/mdruntime/reach.d.ts

@@ -6,9 +6,15 @@ export type ReachedDocument = {
     readonly room: string;
     readonly path: string;
 };
+export type ReachedArea = {
+    readonly room: string;
+    readonly path: string;
+    readonly types: readonly string[];
+};
 export type PortReach = {
     readonly rooms: readonly string[];
     readonly documents: readonly ReachedDocument[];
+    readonly areas?: readonly ReachedArea[];
     readonly conversations: boolean;
 };
 export type Deliver = (message: unknown) => void;

package/dist/mdruntime/replica.d.ts

@@ -12,7 +12,6 @@ export type ReplicaRecord = {
     readonly replica: ReplicaAdmission;
     readonly model: ModelState;
     readonly typedSelection: TypedSelection | null;
-    readonly selectionModel: ModelState;
     readonly providerOwnedPaths: readonly string[];
     readonly roomVersion: string;
     readonly transfer: string;
@@ -34,7 +33,7 @@ export type Slice = Layer & {
     readonly written: Readonly<Record<string, string>>;
     readonly held: ReadonlySet<string>;
 };
-export declare function compositionOf(record: Pick<ReplicaRecord, 'model' | 'typedSelection' | 'selectionModel'>): Composition;
+export declare function compositionOf(record: Pick<ReplicaRecord, 'model' | 'typedSelection'>, builtIn: ModelState): Composition;
 export declare function sameMembership(record: Pick<ReplicaRecord, 'typedSelection'>, other: Pick<ReplicaRecord, 'typedSelection'>): boolean;
 export declare function storedRecord(record: ReplicaRecord): string;
 export declare function slicing(entries: readonly HeldEntry[], paths: Iterable<string>): Generator<number, Slice, void>;

package/dist/mdruntime/room-draft.d.ts

@@ -127,6 +127,7 @@ export type SavedDraft = {
     readonly parts: HeldParts;
 };
 export declare function readParts(value: unknown): RoomDraftParts;
+export declare function gatheredParts(earlier: unknown, later: unknown): unknown;
 export declare function held(current: HeldParts | undefined, parts: RoomDraftParts, file?: HeldFile): HeldParts;
 export declare function underneath(parts: HeldParts, path: string, visible: VisibleLayer | undefined): ChangedUnderneath;
 export declare function heldFile(blob: Blob, base: string | null): Promise<HeldFile>;

package/dist/mdruntime/store.d.ts

@@ -7,12 +7,8 @@ import type { Submission } from './outcome.js';
 import type { RoomDraftRecord, SavedDraft } from './room-draft.js';
 import type { ModelState } from './model.js';
 import type { SearchWindow } from './search.js';
-import type { CommittedWrite, ConversationWrite, CountedRoom, HeldConversation, HeldEntry, MessageWindow, QueryAnswer, QueryRoom, Referrer, RoomCommit, RuntimeDatabase, SearchAsk, StoredEntry, StoredFile, TypedEntry, View, Walked } from './tables.js';
+import type { CommittedWrite, ConversationWrite, CountedRoom, HeldConversation, HeldEntry, KeptPart, MessageWindow, QueryAnswer, QueryRoom, Referrer, RoomCommit, RuntimeDatabase, SearchAsk, StoredEntry, StoredFile, TypedEntry, View, Walked } from './tables.js';
 export type { ConversationWrite, HeldConversation, MessageWindow } from './tables.js';
-export type TransferWriting = {
-    readonly token: string | null;
-    readonly written: number;
-};
 export type TransferRecord = {
     readonly locator: string;
     readonly transfer: string;
@@ -20,12 +16,10 @@ export type TransferRecord = {
     readonly from: string;
     readonly last: string;
     readonly pageToken: string | null;
-    readonly writing: TransferWriting | null;
     readonly inventory: BootstrapInventory | null;
     readonly done: BootstrapInventory;
     readonly models: {
         readonly collection: ModelState;
-        readonly selection: ModelState;
     };
     readonly key: number | null;
 };
@@ -90,6 +84,7 @@ export type RefreshedPage = StagedPage & {
 export type Opened = {
     readonly rooms: ReadonlyMap<string, ReplicaRecord>;
     readonly transfers: ReadonlyMap<string, TransferRecord>;
+    readonly kept: ReadonlyMap<string, ReadonlyMap<string, number>>;
     readonly unindexed: ReadonlySet<number>;
     readonly overlaid: ReadonlyMap<number, ReadonlySet<string>>;
     readonly erasing: boolean;
@@ -125,7 +120,7 @@ export type RuntimeStore = {
     search(ask: SearchAsk): Promise<SearchWindow>;
     stage(record: TransferRecord, composition: Composition, page: StagedPage, written?: string): Promise<number | null>;
     transferPart(locator: string, token: string): Promise<Uint8Array | null>;
-    keepPart(locator: string, token: string, part: Uint8Array): Promise<void>;
+    keepParts(parts: readonly KeptPart[]): Promise<void>;
     refresh(key: number, page: RefreshedPage): Promise<void>;
     unrefresh(key: number): Promise<void>;
     commit(commit: Commit): Promise<CommittedWrite>;
@@ -133,7 +128,7 @@ export type RuntimeStore = {
     erase(locator: string | null, limit: number): Promise<boolean>;
     abandon(locator: string, kept?: boolean): Promise<number | null>;
     release(key: number): Promise<void>;
-    rederive(key: number, limit: number): Promise<boolean>;
+    rederive(key: number, bytes: number): Promise<boolean>;
     fact(name: string, value: unknown): Promise<void>;
     queues(): Promise<readonly QueueRecord[]>;
     submit(locator: string, id: string, submission: Submission, lost: boolean): Promise<void>;

package/dist/mdruntime/stored.d.ts

@@ -34,6 +34,7 @@ export type HeldKey = {
     readonly locator: string;
     readonly transfer: string;
     readonly rederiving: number | null;
+    readonly searching: number | null;
 };
 export type ReplicaOpened = {
     readonly rooms: readonly {
@@ -46,6 +47,11 @@ export type ReplicaOpened = {
         readonly key: number;
         readonly record: string;
     }[];
+    readonly kept: readonly {
+        readonly locator: string;
+        readonly token: string;
+        readonly bytes: number;
+    }[];
     readonly keys: readonly HeldKey[];
     readonly facts: Readonly<Record<string, string>>;
     readonly presentation: readonly {
@@ -122,7 +128,7 @@ export declare function release(connection: Connection, key: number): null;
 export declare function erase(connection: Connection, locator: string | null, limit: number): {
     readonly remaining: boolean;
 };
-export declare function rederive(connection: Connection, key: number, limit: number): {
+export declare function rederive(connection: Connection, key: number, bytes: number): {
     readonly done: boolean;
 };
 export declare function entries(connection: Connection, key: number, view: View, list: readonly string[]): HeldEntry[];
@@ -135,10 +141,11 @@ export declare function files(connection: Connection, key: number, view: View, a
 }[];
 export declare function typedWithin(connection: Connection, key: number, view: View, roots: readonly string[], within: boolean): boolean;
 export declare function transferPart(connection: Connection, locator: string, token: string): Uint8Array | null;
-export declare function keepPart(connection: Connection, request: {
+export type KeptPart = {
     readonly locator: string;
     readonly token: string;
     readonly part: Uint8Array;
-}): null;
+};
+export declare function keepParts(connection: Connection, parts: readonly KeptPart[]): null;
 export declare function opened(connection: Connection): ReplicaOpened;
 export declare function ended(connection: Connection): void;

package/dist/mdruntime/tables.d.ts

@@ -5,8 +5,8 @@ import { type SearchAsk } from './fulltext.js';
 import { type ConversationWrite, type HeldConversation, type MessageWindow } from './messages.js';
 import type { Plan } from './query.js';
 import type { SearchWindow } from './search.js';
-import { type Committed, type CountedRoom, type HeldEntry, type ReplicaOpened, type Referrer, type RoomCommit, type StoredEntry, type TypedEntry, type View, type Walked } from './stored.js';
-export type { Committed, CountedRoom, HeldEntry, OverlayEntry, ReplicaOpened, Referrer, RoomCommit, StoredEntry, TypedEntry, View, Walked, } from './stored.js';
+import { type Committed, type CountedRoom, type HeldEntry, type KeptPart, type ReplicaOpened, type Referrer, type RoomCommit, type StoredEntry, type TypedEntry, type View, type Walked } from './stored.js';
+export type { Committed, CountedRoom, HeldEntry, KeptPart, OverlayEntry, ReplicaOpened, Referrer, RoomCommit, StoredEntry, TypedEntry, View, Walked, } from './stored.js';
 export type { QueryAnswer, QueryRoom } from './compile.js';
 export type { SearchAsk } from './fulltext.js';
 export type { ConversationWrite, HeldConversation, MessageWindow } from './messages.js';
@@ -226,10 +226,8 @@ export interface RuntimeRequests {
         readonly locator: string;
         readonly token: string;
     }, Uint8Array | null>;
-    readonly 'replica.keepPart': Asked<{
-        readonly locator: string;
-        readonly token: string;
-        readonly part: Uint8Array;
+    readonly 'replica.keepParts': Asked<{
+        readonly parts: readonly KeptPart[];
     }, null>;
     readonly 'replica.refresh': Asked<{
         readonly key: number;
@@ -263,7 +261,7 @@ export interface RuntimeRequests {
     }, null>;
     readonly 'replica.rederive': Asked<{
         readonly key: number;
-        readonly limit: number;
+        readonly bytes: number;
     }, {
         readonly done: boolean;
     }>;

package/dist/mdruntime/wire.d.ts

@@ -54,6 +54,14 @@ declare const MEMBERS: {
         readonly reach: 'within';
         readonly effect: 'read';
     };
+    readonly 'binaryFile.show': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'binaryFile.attach': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
     readonly 'binaryFile.part': {
         readonly reach: 'within';
         readonly effect: 'read';
@@ -130,10 +138,6 @@ declare const MEMBERS: {
         readonly reach: 'within';
         readonly effect: 'action';
     };
-    readonly 'conversation.attach': {
-        readonly reach: 'within';
-        readonly effect: 'action';
-    };
     readonly 'conversation.answer': {
         readonly reach: 'within';
         readonly effect: 'action';

package/dist/test-host.d.ts

@@ -1,11 +1,17 @@
 import type { MdRuntimeClient } from './mdruntime/client.js';
-import type { HouseActivation, HouseAnalyticsChoice, HouseAppMessage, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab, HouseTask } from './index.js';
+import type { HouseActivation, HouseAnalyticsChoice, HouseAppMessage, HouseChatOptions, HouseExternalAnswer, HouseExternalRequest, HouseNavigationMode, HouseRefusal, HouseSourceDownload, HouseSourceTop, HouseStatus, HouseTab, HouseTask } from './index.js';
 export interface HouseBridgeNavigation {
     readonly mode: HouseNavigationMode;
     readonly address: string;
 }
+export interface HouseBridgeChat {
+    readonly element: object;
+    readonly options: HouseChatOptions;
+    readonly mounted: boolean;
+}
 export interface HouseBridgeTestHost {
     readonly navigations: readonly HouseBridgeNavigation[];
+    readonly chats: readonly HouseBridgeChat[];
     readonly ceremonies: readonly string[];
     readonly consents: readonly HouseAnalyticsChoice[];
     readonly tabs: readonly HouseTab[];

package/dist/test-host.js

@@ -50,6 +50,7 @@ export function createHouseBridgeTestHost(options = {}) {
     const consents = [];
     const tabs = [];
     const externalCalls = [];
+    const chats = [];
     const addressListeners = new Set();
     const statusListeners = new Set();
     const messageListeners = new Set();
@@ -100,6 +101,20 @@ export function createHouseBridgeTestHost(options = {}) {
     }
     const bridge = {
         runtime: runtime,
+        chat: {
+            mount(element, options = {}) {
+                const chat = { element, options, mounted: true };
+                chats.push(chat);
+                return Promise.resolve({
+                    update(next) {
+                        chat.options = next;
+                    },
+                    unmount() {
+                        chat.mounted = false;
+                    },
+                });
+            },
+        },
         address: () => shown,
         onAddress(listener) {
             return followHeld(addressListeners, listener, () => shown);
@@ -164,6 +179,7 @@ export function createHouseBridgeTestHost(options = {}) {
     arrive(current);
     return {
         navigations,
+        chats,
         ceremonies,
         consents,
         tabs,

package/docs/families.md

@@ -96,8 +96,23 @@
   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.
 
+- **Chat** - `chat.mount(element, options)` places House's Chat, the one chat
+  in which the User's Agent conversations show, in `element` over the page's
+  `runtime` client, and resolves to a handle: `update(options)` replaces its
+  options and `unmount()` removes it. House serves the Chat with the page and
+  keeps it current, so the App installs and bundles nothing for it. The
+  options: `conversation` opens one, `null` for a new chat, `agent` is the
+  Agent a new chat goes to, `showChats` adds its conversation list, `width` is
+  `full`, the element, or `3/4`, `1/2` or `1/3` of the window docked at its
+  right edge, `onOpen` hears each conversation it opens as
+  `{ conversation, agent }`, and `onLink` takes a link without a scheme in
+  place of the browser. CSS custom properties named `--chat-*` on the element
+  or an ancestor set its look. It shows conversations only to a release that
+  declares them. A Site and the House panel have none: their call rejects with
+  an error named and coded `NotSupportedError`, with `retryable` false.
+
 - **Cooperation** - `cooperate({ checkpoint, persist, capture, restore,
-ready, settle })` lets House activate a newer release of the App while it
+  ready, settle })` lets House activate a newer release of the App while it
   runs, keeping the User's task; the function it returns withdraws it.
   Register it in the entry script, before the first draw, or House treats the
   page as not cooperating and the newer release waits for the App's next
@@ -141,7 +156,9 @@ records in `tabs` each `setTab`, answers a release code read from the
 by App 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
+as a browser without push does, settles every `setBadge`, records in `chats`
+each Chat `chat.mount` places, with its `element`, the `options` it was last
+given and whether it is still `mounted`, drawing nothing, delivers each App
 message `message({ from, body })` plays, and hands `bridge.runtime` the MD
 Runtime client `attachRuntime(client)` gives it. `checkpoint()` runs the
 registered cooperation's checkpoint, persist and capture and answers the task,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-c6f0ca4067690",
-  "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.",
+  "version": "0.1.0-c6f4d423ead48",
+  "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, App messages and the Chat, with an accessor and an in-page test host.",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -23,5 +23,10 @@
     "docs",
     "README.md",
     "LICENSE"
-  ]
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentshouse/core.git",
+    "directory": "client"
+  }
 }

package/dist/mdruntime/file.d.ts

@@ -1,11 +0,0 @@
-export type ChosenFile = {
-    name: string;
-    blob: Blob;
-};
-export type FileDeclaration = {
-    name: string;
-    mediaType: string;
-    byteLength: number;
-    contentHash: string;
-};
-export declare function declaredFile(file: ChosenFile): Promise<FileDeclaration>;