@agentshouse/app-bridge 0.1.0-c70153aac6ee3 → 0.1.0-c785df2285fb2

package/dist/calls.d.ts

@@ -1,6 +1,7 @@
 export interface HouseCalls {
     readonly 'access.read': {
         readonly room_ref: string;
+        readonly statistics?: boolean;
     };
     readonly 'conversation.answer': {
         readonly answer: {

package/dist/index.d.ts

@@ -1,7 +1,6 @@
-import type { MdRuntimeClient } from './mdruntime/client.js';
+import type { MdRuntimeClient, Open } from './mdruntime/client.js';
 import type { HouseCalls } from './calls.js';
 export type { HouseCalls } from './calls.js';
-type Open<Value extends string> = Value | (string & {});
 export type HouseCallInput<Name extends string> = Name extends keyof HouseCalls ? HouseCalls[Name] : unknown;
 export interface HouseRuntime extends Omit<MdRuntimeClient, 'call'> {
     call<Name extends Open<keyof HouseCalls>>(name: Name, input: HouseCallInput<Name>): ReturnType<MdRuntimeClient['call']>;
@@ -73,6 +72,7 @@ export interface HouseExternalRequest {
     readonly body_base64?: string;
     readonly account?: string;
     readonly slot?: string;
+    readonly room_ref?: string;
 }
 export type HouseExternalAnswer = {
     readonly status: number;

package/dist/mdmodel/condition.d.ts

@@ -120,7 +120,6 @@ export type ItemFacts = {
     readonly source: string | null;
     readonly address: string | null;
     readonly has_attachment: boolean;
-    readonly provider: string | null;
     readonly container: string | null;
     readonly author: string | null;
     readonly headers: Readonly<Record<string, string>>;

package/dist/mdmodel/definition.d.ts

@@ -29,12 +29,26 @@ export type Shape = {
     readonly schema: Readonly<Record<string, unknown>>;
     readonly defs: Readonly<Record<string, unknown>>;
 };
+export type RuleValue = string | number | boolean | null;
+export type Transition = {
+    readonly from: RuleValue;
+    readonly to: RuleValue;
+    readonly roles?: readonly string[];
+};
+export type FieldRules = {
+    readonly changeRoles?: readonly string[];
+    readonly initialRoles?: readonly string[];
+    readonly transitions?: readonly Transition[];
+};
 export type Definition = {
     readonly name: string;
     readonly memberDocument: boolean;
     readonly frontmatter: ValueFacts;
     readonly fields: Readonly<Record<string, ValueFacts>>;
     readonly sections: Readonly<Record<string, SectionSpec>>;
+    readonly rules: Readonly<Record<string, FieldRules>>;
+    readonly createRoles?: readonly string[];
+    readonly deleteRoles?: readonly string[];
     readonly shape: Shape;
 };
 export type Failure = {

package/dist/mdmodel/index.d.ts

@@ -10,9 +10,9 @@ 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 type { Definition, JsonType, PatternFacts, PointerFacts, SectionSpec, Shape, ValueFacts, } 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, LinkOccurrence, ParseResult, Projection, ProjectionContext, Reached, Reference, Refusal, Span, Validation, ValidationContext, VerifiedModel, } from './types.js';
 export { checkDocument, resolves, sectionReferences, validate, verify } from './validate.js';
 export { VERSION } from './version.js';
-export { equalValue, frontmatterValue } from './yaml.js';
+export { bodyAfterFrontmatter, equalValue, frontmatterValue } from './yaml.js';
 export type { FrontmatterValue } from './yaml.js';

package/dist/mdruntime/adapter.d.ts

@@ -238,17 +238,15 @@ export type ContractUnavailable = ProviderRefusal & {
 export type DiscoverResult = Discovery | TransportUncertainty | RevokedAuthorization | ContractUnavailable;
 export type PageToken = string;
 export type ChangeAuthor = {
-    kind: 'user';
+    kind: Open<'user' | 'site'>;
     id: string;
     name: string;
-} | {
-    kind: 'site';
+};
+export type Member = {
+    kind: Open<'user'>;
     id: string;
     name: string;
 };
-export type Member = Extract<ChangeAuthor, {
-    kind: 'user';
-}>;
 export type HeadChange = {
     author: ChangeAuthor | null;
     time: string;
@@ -279,6 +277,7 @@ export type BootstrapPage = {
     models?: RoomModels;
     documents: Readonly<Record<string, string>>;
     revisions: Readonly<Record<string, string>>;
+    fileIds?: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
     binaryFiles: Readonly<Record<string, BinaryFile>>;
     pageToken?: PageToken;
@@ -298,6 +297,7 @@ export type RefreshPage = {
     models?: RoomModels;
     documents: Readonly<Record<string, string>>;
     revisions: Readonly<Record<string, string>>;
+    fileIds?: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
     binaryFiles: Readonly<Record<string, BinaryFile>>;
     removals: readonly string[];
@@ -326,6 +326,7 @@ export type MutationResult = {
     roomVersion: string;
     documents: Readonly<Record<string, string>>;
     revisions: Readonly<Record<string, string>>;
+    fileIds?: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
     removals: readonly string[];
     binaryFiles?: Readonly<Record<string, BinaryFile>>;
@@ -399,6 +400,13 @@ export type BinaryResult = {
 } | (ProviderRefusal & {
     kind: 'rejected';
 }) | AdapterFailure;
+export type BinaryLinkResult = {
+    kind: 'link';
+    url: string;
+    name: string;
+} | (ProviderRefusal & {
+    kind: 'rejected';
+}) | AdapterFailure;
 export type ActionRequest = {
     name: string;
     input: unknown;
@@ -425,9 +433,12 @@ export type RoomStreamEvent = {
 } | {
     kind: 'closed';
     revoked: boolean;
+    lost: boolean;
 } | {
     kind: 'opening';
     expired: readonly string[];
+} | {
+    kind: 'authority-changed';
 } | {
     kind: 'room-version';
     locator: string;
@@ -466,6 +477,9 @@ export type Adapter = {
     mutate(authorization: Authorization, request: MutationRequest, keep: (upload: unknown) => Promise<void>): Promise<MutationResult>;
     history(authorization: Authorization, request: HistoryRequest): Promise<HistoryResult>;
     binary(authorization: Authorization, request: BinaryRequest): Promise<BinaryResult>;
+    link(authorization: Authorization, request: Extract<BinaryRequest, {
+        kind: 'path';
+    }>): Promise<BinaryLinkResult>;
     referrerScope(referrer: unknown): ReferrerScope | null;
     action(authorization: Authorization, request: ActionRequest): Promise<ActionResult>;
     reached(locator: string, roomVersion: string, target: string): boolean;

package/dist/mdruntime/client.d.ts

@@ -3,7 +3,7 @@ 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 { BinaryReference } from './binary.js';
-import type { BinaryAnswer, CallResult, HistoryAnswer, Offline, QueueEntry } from './outcome.js';
+import type { BinaryAnswer, BinaryLinkAnswer, CallResult, HistoryAnswer, Offline, QueueEntry } 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';
@@ -28,6 +28,7 @@ export type MdRuntimeClient = {
     presentation: {
         read(): Promise<unknown>;
         write(value: unknown): Promise<void>;
+        edit(members: Readonly<Record<string, unknown>>): Promise<void>;
     };
     conversation: {
         list(): Promise<readonly ConversationEntry[]>;
@@ -47,6 +48,7 @@ export type MdRuntimeClient = {
     history(locator: string, path: string, query?: HistoryQuery): Promise<HistoryAnswer>;
     binaryFile: {
         read(room: string, path: string, revision?: string): Promise<BinaryAnswer>;
+        link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
         readReference(reference: BinaryReference): Promise<BinaryAnswer>;
     };
     call(name: string, input: unknown): Promise<CallResult>;
@@ -78,4 +80,5 @@ export type MdRuntimeClient = {
 export declare function connectMdRuntime(port: RuntimePort): MdRuntimeClient;
 export declare function inTurn(client: MdRuntimeClient, work: () => Promise<void>): Promise<void>;
 export type { Observation } from './observation.js';
-export type { RuntimePort } from './wire.js';
+export type { Open } from './open.js';
+export { unanswered, type RuntimePort, type WireMember } from './wire.js';

package/dist/mdruntime/connection.d.ts

@@ -1,20 +1,21 @@
 import { type TypesResult } from './model.js';
 import { type Observation } from './observation.js';
 import { type DocumentQuery, type DocumentResult, type GroupQuery, type GroupResult, type PendingResult } from './query.js';
+import { type EntrySeed } from './seed.js';
 import { type SearchRequest, type SearchResult } from './search.js';
 import { type Adapter, type Authorization, type Member, type ProviderRefusal, type ServiceMode } from './adapter.js';
 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 BinaryReference } from './binary.js';
-import { type BinaryAnswer, type CallResult, type HistoryAnswer, type QueueEntry } from './outcome.js';
+import { type BinaryAnswer, type BinaryLinkAnswer, type CallResult, type HistoryAnswer, type QueueEntry } from './outcome.js';
 import { type Recovery } from './recovery.js';
 import { type SaveRefusal } from './save.js';
 import { type RoomDraft, type RoomDraftWrite } from './room-draft.js';
 import { type SyncStatus } from './status.js';
 import { type RuntimeShell } from './durability.js';
 import { type RuntimeDemand } from './acquisition.js';
-import { type CapacityCause, type CodeAvailability, type Persistence, type Readiness } from './readiness.js';
+import { type CapacityCause, type CodeAvailability, type Persistence, type Readiness, type SearchObligation } from './readiness.js';
 import { type NarrowedView, type PortReach, type RuntimeView } from './reach.js';
 export type AppTypedSelection = {
     roots: readonly string[];
@@ -72,9 +73,11 @@ export type RoomDraftSurface = {
 export type PresentationSurface = {
     read(app: string): Promise<unknown>;
     write(app: string, value: unknown): Promise<void>;
+    edit(app: string, members: Readonly<Record<string, unknown>>): Promise<void>;
 };
 export type BinaryFileSurface = {
     read(room: string, path: string, revision?: string): Promise<BinaryAnswer>;
+    link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
     readReference(reference: BinaryReference): Promise<BinaryAnswer>;
 };
 export type HistoryQuery = {
@@ -126,8 +129,10 @@ export type ReadinessPort = {
     readonly target: string;
     readonly code: CodeAvailability;
     readonly capacity: CapacityCause | null;
+    readonly search: SearchObligation;
 };
 export type ComposedRuntime = RuntimeView & {
+    seed(entry: EntrySeed): void;
     stop(): Promise<void>;
     lose(locators: readonly string[]): Promise<void>;
     acquire(demand: RuntimeDemand): void;

package/dist/mdruntime/conversation.d.ts

@@ -36,10 +36,14 @@ export type ChatDraft = {
 };
 export type ConversationOptions = {
     limit?: number;
+    after?: string;
+    total?: true;
 };
 export type ConversationView = {
     conversation: string;
     messages: readonly ConversationMessage[];
+    next?: string;
+    total?: number;
     turn: RunningTurn | null;
     questions: readonly unknown[];
     process: {
@@ -89,6 +93,7 @@ export type ConversationStore = {
     known(): boolean;
     reconnected(): void;
     reopened(): void;
+    lost(): void;
     watch(conversation: string, options: ConversationOptions, deliver: (view: ConversationView) => void): () => void;
     watchList(deliver: (entries: readonly ConversationEntry[]) => void): () => void;
     watchAgents(deliver: (agents: readonly ConversationAgent[]) => void): () => void;
@@ -100,4 +105,5 @@ export type ConversationStore = {
 };
 export declare function unheldView(conversation: string): ConversationView;
 export declare const SESSION_STARTED = "Session started";
+export declare function newChat(agent: string): string;
 export declare function createConversationStore(deps: ConversationDependencies): ConversationStore;

package/dist/mdruntime/model.d.ts

@@ -29,12 +29,13 @@ export type ModelState = {
     types: VerifiedModel['types'];
 };
 export type TypesResult = {
-    status: 'unavailable';
+    status: Open<'unavailable'>;
     reason: ModelUnavailableReason;
+    types: null;
     schema?: string | null;
     revision?: string | null;
 } | {
-    status: 'current' | 'cached';
+    status: Open<'current' | 'cached'>;
     identity: string;
     version: string;
     verifiedWith: ModelIdentity;

package/dist/mdruntime/observation.d.ts

@@ -14,6 +14,8 @@ export type QueryChange = {
     removed: readonly RowKey[];
     order: readonly RowKey[] | null;
     coverage?: QueryCoverage;
+    next?: string | null;
+    total?: number;
 };
 export type QueryMessage = KeyedResult | QueryChange;
 export type Observed = {

package/dist/mdruntime/outcome.d.ts

@@ -1,4 +1,4 @@
-import type { ActionResult, AdapterFailure, BinaryResult, HistoryResult, ProviderRefusal, RoomVersionAt, ScopedRefusal } from './adapter.js';
+import type { ActionResult, AdapterFailure, BinaryLinkResult, BinaryResult, HistoryResult, ProviderRefusal, RoomVersionAt, ScopedRefusal } from './adapter.js';
 import type { ChangeBatch } from './change.js';
 type Refused<Kind extends string> = ProviderRefusal & {
     kind: Kind;
@@ -18,8 +18,14 @@ export type BinaryAnswer = {
     kind: 'binary';
     blob: Blob;
 } | Refused<'rejected'> | Refused<'absent'> | Failure;
-export declare function absentBinary(path: string): BinaryAnswer;
+export type BinaryLinkAnswer = {
+    kind: 'link';
+    url: string;
+    name: string;
+} | Refused<'rejected'> | Refused<'absent'> | Failure;
+export declare function absentBinary(path: string): Refused<'absent'>;
 export declare function binaryAnswer(result: BinaryResult): BinaryAnswer;
+export declare function binaryLinkAnswer(result: BinaryLinkResult): BinaryLinkAnswer;
 export type Offline = {
     readonly kind: 'offline';
 };

package/dist/mdruntime/overlay.d.ts

@@ -2,6 +2,7 @@ import type { BinaryFile, HeadChange } from './adapter.js';
 import type { ChangeBatch } from './change.js';
 export type Heads = {
     revisions: Readonly<Record<string, string>>;
+    fileIds: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
 };
 export type HeldBinary = ({

package/dist/mdruntime/query.d.ts

@@ -1,6 +1,7 @@
 import { type Definition } from '../mdmodel/index.js';
 import type { HeadChange } from './adapter.js';
 import type { BinaryFileRecord } from './binary.js';
+import type { Open } from './open.js';
 export type Value = string | number | boolean | null;
 export type Predicate = Value | {
     $eq: Value;
@@ -37,6 +38,7 @@ export type Filter = {
     types?: readonly string[];
     where?: Where;
     pathPrefix?: string;
+    paths?: readonly string[];
     hop?: Related & {
         field: string;
     };
@@ -54,6 +56,7 @@ export type Select = 'all' | {
     markdown?: true;
     backlinks?: true;
     change?: true;
+    fileId?: true;
 };
 export type OrderOptions = {
     nulls?: 'first' | 'last';
@@ -69,6 +72,8 @@ export type DocumentQuery = Filter & {
         direction?: Direction;
     } & OrderOptions)[];
     limit?: number;
+    after?: string;
+    total?: true;
 };
 export type GroupQuery = Filter & {
     groupBy: readonly Exclude<Key, 'path'>[];
@@ -77,6 +82,8 @@ export type GroupQuery = Filter & {
         direction?: Direction;
     }[];
     limit?: number;
+    after?: string;
+    total?: true;
 };
 export type LocalQuery = DocumentQuery | GroupQuery;
 export type Backlink = {
@@ -94,6 +101,7 @@ export type QueryDocument = {
     markdown?: string;
     backlinks?: readonly Backlink[];
     change?: HeadChange | null;
+    fileId?: string | null;
     binaryFile?: BinaryFileRecord;
 };
 export type QueryGroup = {
@@ -110,7 +118,7 @@ export type QueryCoverage = {
     indexes: readonly string[];
     overlay: readonly string[];
 };
-export type Awaits = 'acquisition' | 'preparation' | 'index';
+export type Awaits = Open<'acquisition' | 'preparation' | 'index'>;
 export type PendingRoom = {
     room: string;
     awaits: Awaits;
@@ -120,9 +128,13 @@ export type PendingResult = {
 };
 export type DocumentRows = {
     documents: readonly QueryDocument[];
+    next?: string;
+    total?: number;
 };
 export type GroupRows = {
     groups: readonly QueryGroup[];
+    next?: string;
+    total?: number;
 };
 export type QueryRows = DocumentRows | GroupRows;
 export type DocumentResult = DocumentRows & {
@@ -198,6 +210,7 @@ export type DocumentShape = {
     markdown: boolean;
     backlinks: boolean;
     change: boolean;
+    fileId: boolean;
     orderBy: readonly {
         key: KeyPlan;
         options: OrderOptions & {
@@ -217,10 +230,16 @@ export type PlanReach = {
     rooms: readonly string[];
     documents: readonly string[];
 };
+export type Continuation = {
+    text: string;
+    values: readonly unknown[] | null;
+};
 export type Plan = {
+    key: string;
     rooms: readonly string[] | null;
     reach: PlanReach | null;
     root: Scope;
+    paths: readonly string[] | null;
     hop: (Scope & {
         field: string;
     }) | null;
@@ -229,6 +248,8 @@ export type Plan = {
     }) | null;
     shape: DocumentShape | GroupShape;
     limit: number | null;
+    after: Continuation | null;
+    total: boolean;
 };
 export declare class QueryError extends Error {
     readonly code: QueryErrorCode;
@@ -239,8 +260,10 @@ type Entries = Readonly<Record<string, unknown>>;
 export declare function invalid(at: string, problem: string): never;
 export declare function plain(value: unknown): value is Entries;
 export declare function known(value: Entries, allowed: readonly string[], at: string): void;
+export declare function flag(input: unknown, at: string): boolean;
 export declare function planOf(input: unknown, facts: HeldRooms, reach?: PlanReach | null): Plan;
 export declare function limitOf(input: unknown): number | null;
 export declare function filterOf(input: unknown, facts: HeldRooms, reach?: PlanReach | null): Plan;
+export declare function queryKey(query: unknown): string;
 export declare function identityOf(plan: Plan): string;
 export {};

package/dist/mdruntime/reach.d.ts

@@ -2,7 +2,7 @@ import type { ReferrerScope } from './adapter.js';
 import type { MdRuntime, ReadinessPort, RuntimeTopic } from './connection.js';
 import type { Plan, PlanReach, QueryResult } from './query.js';
 import type { Readiness } from './readiness.js';
-import type { SearchResult } from './search.js';
+import { type SearchResult } from './search.js';
 export type ReachedDocument = {
     readonly room: string;
     readonly path: string;
@@ -27,7 +27,6 @@ export type Reachable = RuntimeView & {
     query(plan: Plan): Promise<QueryResult>;
     watchPlan(plan: Plan, deliver: (message: unknown) => void): () => void;
     search(input: unknown, reach: PortReach | null): Promise<SearchResult>;
-    searching(target: string): void;
     watchReadiness(port: ReadinessPort, reach: PortReach | null, deliver: (readiness: Readiness) => void): () => void;
     referrerScope(referrer: unknown): ReferrerScope | null;
 };

package/dist/mdruntime/replica.d.ts

@@ -41,5 +41,9 @@ type Accepted = Extract<MutationResult, {
 export declare function applyReturned(confirmed: ConfirmedLayer, submitted: ChangeBatch, accepted: Accepted, roomVersion: string, writtenAt: string): Staged;
 export declare function replicaOf(confirmed: ConfirmedLayer, queue: readonly ChangeBatch[], previous?: Replica): Replica;
 export declare function landed(batch: ChangeBatch, confirmed: ConfirmedLayer, current?: Readonly<Record<string, string>>): boolean;
-export declare function withdrawals(confirmed: ConfirmedLayer, queue: readonly ChangeBatch[], withdrawable: (batch: ChangeBatch) => boolean, local: boolean): readonly ChangeBatch[];
+export type Standing = {
+    readonly withdrawn: readonly ChangeBatch[];
+    readonly kept: readonly ChangeBatch[];
+};
+export declare function standing(confirmed: ConfirmedLayer, queue: readonly ChangeBatch[], withdrawable: (batch: ChangeBatch) => boolean, local: boolean): Standing;
 export {};

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

@@ -87,7 +87,7 @@ type ChangedUnderneath = {
     readonly file?: string | null;
 };
 export type ReturnReason = ProviderRefusal & {
-    readonly kind: 'conflicted' | 'rejected' | 'expired' | 'withdrawn';
+    readonly kind: Open<'conflicted' | 'rejected' | 'expired' | 'withdrawn'>;
 };
 export declare function returnedBy(kind: 'expired' | 'withdrawn'): ReturnReason;
 export type RoomDraft = {
@@ -130,6 +130,18 @@ export declare function underneath(parts: HeldParts, path: string, visible: Visi
 export declare function heldFile(blob: Blob, base: string | null): Promise<HeldFile>;
 export declare function binaryBase(visible: VisibleLayer | undefined, path: string): string | null;
 export declare function changedParts(path: string, report: ChangedUnderneath): readonly ChangedPart[];
+export type TextParts = {
+    readonly fields?: Readonly<Record<string, {
+        readonly value: unknown;
+    }>>;
+    readonly sections?: Readonly<Record<string, {
+        readonly value: string;
+    }>>;
+    readonly preamble?: {
+        readonly value: string;
+    };
+};
+export declare function partsAfter(markdown: string, parts: TextParts): string;
 export declare function returnedInto(existing: HeldParts | undefined, returned: HeldParts): HeldParts;
 export declare function moveTarget(move: {
     readonly to: string;

package/dist/mdruntime/rows.d.ts

@@ -15,6 +15,7 @@ export type DocumentRow = {
     directories: readonly string[];
     text: string | null;
     change: HeadChange | null;
+    fileId: string | null;
     binary: BinaryFileRecord | null;
 };
 export type ReferenceRow = {
@@ -32,5 +33,5 @@ export type Row = DocumentRow | ReferenceRow;
 export declare function documentKey(room: string, path: string): string;
 export declare function roomOfKey(key: string): string;
 export declare function markdownPath(path: string): boolean;
-export declare function rowsOf(room: string, path: string, document: Frontmatter | null, composition: Composition, change: HeadChange | null, binary: BinaryFileRecord | null): readonly Row[];
+export declare function rowsOf(room: string, path: string, document: Frontmatter | null, composition: Composition, change: HeadChange | null, fileId: string | null, binary: BinaryFileRecord | null): readonly Row[];
 export {};

package/dist/mdruntime/save.d.ts

@@ -38,6 +38,7 @@ export type BatchResult = {
     refusal: SaveRefusal;
 };
 export declare function providerRewritten(batch: ChangeBatch, visible: VisibleLayer): ChangeBatch;
+export declare function queuedDocuments(queue: readonly ChangeBatch[]): ReadonlySet<string>;
 export type Requeued = {
     kind: 'requeued';
     queue: readonly ChangeBatch[];

package/dist/mdruntime/search.d.ts

@@ -1,3 +1,4 @@
+import type { ProviderRefusal } from './adapter.js';
 import type { ChangeSet } from './change-set.js';
 import { type CoveredRoom, type Filter, type PendingRoom } from './query.js';
 import type { Open } from './open.js';
@@ -5,8 +6,11 @@ export type DocumentPart = Open<'fields' | 'sections' | 'preamble' | 'path'>;
 export type SearchRequest = {
     text: string;
     documents?: Filter;
+    collection?: true;
     conversations?: readonly string[];
     limit?: number;
+    after?: string;
+    total?: true;
 };
 export type DocumentHit = {
     room: string;
@@ -29,18 +33,30 @@ export type SearchCoverage = {
 };
 export type PendingConversation = {
     conversation: string;
-    awaits: 'index';
-};
-export type SearchPending = {
-    pending: readonly (PendingRoom | PendingConversation)[];
+    awaits: Open<'index'>;
 };
 export type SearchHits = {
     documents: readonly DocumentHit[];
     messages: readonly MessageHit[];
 };
-export type SearchResult = (SearchHits & {
+export type SearchWindow = SearchHits & {
+    next?: string;
+    total?: {
+        documents: number;
+        messages: number;
+    };
+};
+export type SearchPending = SearchHits & {
+    pending: readonly (PendingRoom | PendingConversation)[];
+    coverage: SearchCoverage;
+};
+export type SearchUndeclared = ProviderRefusal & {
+    kind: 'undeclared';
+};
+export type SearchResult = (SearchWindow & {
     coverage: SearchCoverage;
-}) | SearchPending;
+}) | SearchPending | SearchUndeclared;
+export declare function undeclaredSearch(): SearchUndeclared;
 export type SearchedDocument = {
     room: string;
     path: string;
@@ -58,11 +74,15 @@ export type SearchSource = {
     room(room: string): readonly string[];
     document(room: string, path: string): SearchedDocument | null;
 };
+type HitCursor = readonly [number, string, string] | readonly [] | null;
 export type SearchPlan = {
     text: string;
     documents: unknown;
+    collection: boolean;
     conversations: readonly string[] | null;
     limit: number | null;
+    after: readonly [HitCursor, HitCursor] | null;
+    total: boolean;
 };
 export type SearchIndex = {
     generation(): string;
@@ -77,7 +97,8 @@ export type SearchIndex = {
     search(plan: SearchPlan, documents: readonly {
         room: string;
         path: string;
-    }[] | null, conversations: readonly string[]): SearchHits;
+    }[] | null, conversations: readonly string[], rooms: ReadonlySet<string> | null, selections: ReadonlyMap<string, readonly string[]> | null): SearchWindow;
 };
 export declare function searchPlanOf(input: unknown): SearchPlan;
 export declare function createSearchIndex(source: SearchSource): SearchIndex;
+export {};

package/dist/mdruntime/seed.d.ts

@@ -0,0 +1,15 @@
+import type { KeyedResult } from './observation.js';
+import type { QueryRows } from './query.js';
+export type EntrySeed = {
+    readonly at: Readonly<Record<string, string>>;
+    readonly queries: readonly {
+        readonly query: unknown;
+        readonly rows: QueryRows;
+    }[];
+};
+export type Seeded = {
+    readonly rows: QueryRows;
+    readonly at: Readonly<Record<string, string>>;
+};
+export declare function entrySeedOf(value: unknown): EntrySeed | null;
+export declare function seededResult(seed: Seeded): KeyedResult;

package/dist/mdruntime/store.d.ts

@@ -7,7 +7,7 @@ import type { ChatDraftFile } from './file.js';
 import type { Submission } from './outcome.js';
 import type { RoomDraftRecord, SavedDraft } from './room-draft.js';
 export declare const STORE_SCHEMA = 25;
-export declare const AUTHORED_SCHEMA = 2;
+export declare const AUTHORED_SCHEMA = 3;
 export type ReplicaRecord = {
     locator: string;
     name: string;
@@ -23,10 +23,11 @@ export type ReplicaRecord = {
     documents: Readonly<Record<string, string>>;
     binaries: Readonly<Record<string, HeldBinary>>;
     revisions: Readonly<Record<string, string>>;
+    fileIds: Readonly<Record<string, string>>;
     changes: Readonly<Record<string, HeadChange>>;
     written: Readonly<Record<string, string>>;
 };
-export type StagedLayer = Pick<ReplicaRecord, 'documents' | 'binaries' | 'revisions' | 'changes' | 'written'>;
+export type StagedLayer = Pick<ReplicaRecord, 'documents' | 'binaries' | 'revisions' | 'fileIds' | 'changes' | 'written'>;
 export type TransferRecord = {
     locator: string;
     transfer: string;
@@ -48,7 +49,6 @@ export type PendingState = {
 };
 export type TargetRecord = {
     established: boolean;
-    search: boolean;
 };
 export type QueueRecord = {
     locator: string;
@@ -66,6 +66,10 @@ export type HeldConversation = {
     read: string | null | undefined;
     partial: boolean;
 };
+export type MessageWindow = {
+    messages: AcceptedMessage[];
+    more: boolean;
+};
 export type ConversationWrite = {
     conversation: string;
     messages: readonly AcceptedMessage[];
@@ -86,6 +90,12 @@ export type ChatDraftRecord = {
     files: readonly ChatDraftFile[];
     revision: string;
     submitted?: readonly ChatSubmission[];
+    moves?: readonly string[];
+};
+export type CallRecord = {
+    readonly operation: string;
+    readonly name: string;
+    readonly input: unknown;
 };
 export type RecordWrite = {
     next: ReplicaRecord;
@@ -95,6 +105,7 @@ export type RecordWrite = {
 export type AuthoredWrite = {
     locator: string;
     queue: readonly ChangeBatch[];
+    founded?: readonly ChangeBatch[];
     saved?: ReadonlyMap<string, readonly SavedDraft[]>;
     roomDrafts?: readonly RoomDraftRecord[];
     consumedRoomDrafts?: readonly string[];
@@ -122,14 +133,18 @@ export type RuntimeStore = {
     present(record: PresentationRecord): Promise<void>;
     conversations(): Promise<readonly HeldConversation[]>;
     keepMessages(write: ConversationWrite): Promise<void>;
-    messageWindow(conversation: string, limit: number | undefined): Promise<AcceptedMessage[]>;
+    messageWindow(conversation: string, limit: number | undefined, before: readonly [string, string] | null): Promise<MessageWindow>;
+    messageCount(conversation: string): Promise<number>;
     messagesAfter(conversation: string, identity: string | null): Promise<AcceptedMessage[]>;
     messageIdentities(conversation: string): Promise<readonly string[]>;
     turnArrived(conversation: string, turn: string): Promise<boolean>;
     dropConversations(conversations: readonly string[]): Promise<void>;
     chatDrafts(): Promise<readonly ChatDraftRecord[]>;
-    keepChatDraft(record: ChatDraftRecord): Promise<void>;
+    keepChatDrafts(records: readonly ChatDraftRecord[]): Promise<void>;
     dropChatDraft(conversation: string): Promise<void>;
+    calls(): Promise<readonly CallRecord[]>;
+    keepCall(record: CallRecord): Promise<void>;
+    dropCall(operation: string): Promise<void>;
     keepRoomDraft(record: RoomDraftRecord): Promise<void>;
     discardRoomDraft(locator: string, path: string): Promise<void>;
     fences(): Promise<readonly string[]>;

package/dist/mdruntime/wire.d.ts

@@ -8,38 +8,144 @@ export type RuntimePort = {
     start(): void;
 };
 export type WireReach = 'within' | 'app' | 'runtime' | 'actions' | 'whole';
+export type WireEffect = 'read' | 'write' | 'action';
+export type WireCall = {
+    readonly reach: WireReach;
+    readonly effect: WireEffect;
+};
 declare const MEMBERS: {
-    readonly rooms: 'within';
-    readonly query: 'within';
-    readonly search: 'within';
-    readonly types: 'within';
-    readonly save: 'within';
-    readonly history: 'within';
-    readonly 'binaryFile.read': 'within';
-    readonly 'binaryFile.readReference': 'within';
-    readonly call: 'actions';
-    readonly reached: 'within';
-    readonly log: 'whole';
-    readonly persistence: 'runtime';
-    readonly retry: 'runtime';
-    readonly reauthorize: 'runtime';
-    readonly 'roomDraft.list': 'within';
-    readonly 'roomDraft.read': 'within';
-    readonly 'roomDraft.write': 'within';
-    readonly 'roomDraft.discard': 'within';
-    readonly 'presentation.read': 'app';
-    readonly 'presentation.write': 'app';
-    readonly 'conversation.list': 'within';
-    readonly 'conversation.read': 'within';
-    readonly 'conversation.create': 'within';
-    readonly 'conversation.send': 'within';
-    readonly 'conversation.answer': 'within';
-    readonly 'conversation.interrupt': 'within';
-    readonly 'conversation.kill': 'within';
-    readonly 'conversation.cancel': 'within';
-    readonly 'conversation.delete': 'within';
-    readonly 'chatDraft.write': 'within';
-    readonly 'chatDraft.discard': 'within';
+    readonly rooms: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly query: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly search: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly types: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly save: {
+        readonly reach: 'within';
+        readonly effect: 'write';
+    };
+    readonly history: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'binaryFile.read': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'binaryFile.link': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'binaryFile.readReference': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly call: {
+        readonly reach: 'actions';
+        readonly effect: 'action';
+    };
+    readonly reached: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly log: {
+        readonly reach: 'whole';
+        readonly effect: 'read';
+    };
+    readonly persistence: {
+        readonly reach: 'runtime';
+        readonly effect: 'read';
+    };
+    readonly retry: {
+        readonly reach: 'runtime';
+        readonly effect: 'write';
+    };
+    readonly reauthorize: {
+        readonly reach: 'runtime';
+        readonly effect: 'write';
+    };
+    readonly 'roomDraft.list': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'roomDraft.read': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'roomDraft.write': {
+        readonly reach: 'within';
+        readonly effect: 'write';
+    };
+    readonly 'roomDraft.discard': {
+        readonly reach: 'within';
+        readonly effect: 'write';
+    };
+    readonly 'presentation.read': {
+        readonly reach: 'app';
+        readonly effect: 'read';
+    };
+    readonly 'presentation.write': {
+        readonly reach: 'app';
+        readonly effect: 'write';
+    };
+    readonly 'presentation.edit': {
+        readonly reach: 'app';
+        readonly effect: 'write';
+    };
+    readonly 'conversation.list': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'conversation.read': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'conversation.create': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.send': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.answer': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.interrupt': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.kill': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.cancel': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'conversation.delete': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'chatDraft.write': {
+        readonly reach: 'within';
+        readonly effect: 'write';
+    };
+    readonly 'chatDraft.discard': {
+        readonly reach: 'within';
+        readonly effect: 'write';
+    };
 };
 declare const TOPICS: {
     readonly rooms: 'within';
@@ -58,8 +164,8 @@ declare const TOPICS: {
     readonly conversations: 'within';
     readonly agents: 'within';
 };
-export declare const WIRE_REACH: {
-    readonly members: Readonly<Record<string, WireReach>>;
+export declare const WIRE: {
+    readonly members: Readonly<Record<string, WireCall>>;
     readonly topics: Readonly<Record<string, WireReach>>;
 };
 export type WireMember = keyof typeof MEMBERS;
@@ -97,6 +203,10 @@ export type WireAnswer = {
 } | {
     kind: 'ended';
 };
+export declare function unanswered(call: {
+    readonly id: number;
+    readonly member: WireMember;
+}): WireAnswer | null;
 export declare const AUTHORIZATION_ENDED = "the host authorization ended";
 export declare const PORT_CLOSED = "the port closed";
 export declare function request(message: unknown): WireRequest | null;

package/docs/families.md

@@ -12,7 +12,9 @@
   purpose-bound authenticated pages. The shell navigates only to a same-origin
   absolute path, carries its current address as the return target, and the page
   returns there when it completes. An App names an address House gave it in a
-  reading and composes none.
+  reading and composes one only for `/bind/<app_ref>`, where the User binds
+  its Rooms and connects its account slots, with `?slot=<name>` to open at one
+  slot.
 - **Installation** - `install()` offers the page as a Home-screen app. Where the
   browser has an install prompt ready the shell shows it and the call resolves
   `'accepted'` or `'dismissed'` with the User's choice, spending that prompt;
@@ -67,14 +69,15 @@
   refusal is House's `{ error: { code, retryable } }`, `app_release_not_found` for an
   App with no release; a read House does not answer, or one that outlived
   the browser's signed-in User, is `null`.
-- **External calls** - `callExternal({ url, method, headers, body, slot })`
+- **External calls** - `callExternal({ url, method, headers, body, slot, room_ref })`
   has House's server send an HTTPS request to one of the release's declared
   external origins and resolves with the service's `status`, `headers` and its
   body as `body` text or `body_base64`, or a refusal as House's
   `{ error: { code, retryable } }`, or `null` when House does not answer. House fills in the
-  App and its running release; naming an account slot places the key of the
-  account the User connected to it, which the App never sees, and naming none
-  sends no key. A Site's call names no slot, and the House panel names an
+  App and its running release; naming an account slot and one of the App's
+  bound Rooms places the key of the account that Room connects to the slot,
+  when the User holds one of the account's roles there, which the App never
+  sees, and naming neither sends no key. A Site's call names no slot, and the House panel names an
   `account` instead. `body_base64` replaces `body` for bytes.
 - **App messages** - `messages(listener)` hands the listener each message
   another holder of this App sends to this User's running copies, as `from`,
@@ -104,7 +107,8 @@ ready, settle })` lets House activate a newer release of the App while it
   answers the meaningful task the App owns, such as the selected record,
   filters, cursor, selection and scroll position, as JSON of at most 65,536
   characters; House keeps the address itself. In the newer release House
-  calls `restore(task)`, or `restore(null)` when it opens the release without
+  calls `restore(task)` once its document has drawn, so the scroll position
+  and focus it sets hold, or `restore(null)` when it opens the release without
   a task, then `ready()`, the App's own check that its local data and
   capabilities work, and finally `settle('committed')` once the release is
   active or `settle('abandoned')` when House returns to the release before

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/app-bridge",
-  "version": "0.1.0-c70153aac6ee3",
+  "version": "0.1.0-c785df2285fb2",
   "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.",
   "license": "MIT",
   "type": "module",