@agentshouse/app-bridge 0.1.0-c38399ec02f49 → 0.1.0-c38910dcdc9fa

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;
             }[];
         };
@@ -414,18 +401,11 @@ 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 record: string;
-            readonly ref: string;
-            readonly created_at: string;
-            readonly body: string | null;
-            readonly claimed: unknown;
-        } | {
             readonly records: readonly {
                 readonly record: string;
                 readonly ref: string;
@@ -630,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;
@@ -935,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';
@@ -994,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;
@@ -132,10 +132,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 = {

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';

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/collection.d.ts

@@ -16,6 +16,11 @@ export type Composition = {
         model: ModelState;
     } | null;
 };
+export type Composed = {
+    readonly composition: Composition;
+    readonly fingerprint: string;
+};
+export declare function composedOf(composition: Composition): Composed;
 export declare function selected(composition: Composition, path: string): boolean;
 export declare function governing(composition: Composition, path: string): ModelState;
 export declare function collectionOf(text: Readonly<Record<string, string>>, composition: Composition): Collection;

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';
@@ -54,6 +54,7 @@ export type MdRuntimeOptions = {
     authorization?: Authorization;
     signal?: AbortSignal;
     recovery?: Recovery;
+    usableWhenHeld?: readonly string[];
 };
 export type SaveResult = {
     outcome: 'saved';
@@ -72,7 +73,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 +84,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 = {
@@ -91,7 +94,7 @@ export type HistoryQuery = {
 };
 export type MdRuntime = {
     loaded(): Promise<void>;
-    rooms(): readonly AppRoom[];
+    rooms(): Promise<readonly AppRoom[]>;
     query: {
         (query: DocumentQuery): Promise<DocumentResult | PendingResult>;
         (query: GroupQuery): Promise<GroupResult | PendingResult>;

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>;
@@ -85,6 +83,7 @@ export type ConversationDependencies = {
     stream(): ConversationStream | undefined;
     publish(set: ChangeSet): void;
     online(): boolean;
+    listed(): boolean;
     full(): boolean;
     closed(): boolean;
     unanswered(): void;
@@ -99,6 +98,8 @@ export type ConversationStore = {
     resend(progress: CycleProgress): Promise<void>;
     current(): boolean;
     known(): boolean;
+    learned(): void;
+    declared(): void;
     reconnected(): void;
     reopened(): void;
     lost(): void;

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 {};