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

package/dist/calls.d.ts

@@ -414,18 +414,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;

package/dist/mdmodel/definition.d.ts

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

package/dist/mdmodel/index.d.ts

@@ -10,7 +10,7 @@ export type { RoomTarget } from './paths.js';
 export { MARKDOWN_SYNTAX_PROFILE } from './profile.js';
 export { project } from './project.js';
 export { references } from './references.js';
-export { ARRAY_INDEX, ATTACHMENT, crossedFacts, escapePointer, itemFacts, memberFacts, pointerFacts, pointerSegments, } from './definition.js';
+export { ARRAY_INDEX, ATTACHMENT, crossedFacts, escapePointer, itemFacts, JSON_POINTER, memberFacts, pointerFacts, pointerSegments, } from './definition.js';
 export type { Definition, FieldRules, JsonType, PatternFacts, PointerFacts, RuleValue, SectionSpec, Shape, Transition, ValueFacts, } from './definition.js';
 export type { ApplyResult, BodyResult, Change, Division, DivisionContext, Document, DocumentCheck, Frontmatter, FrontmatterResult, Library, ModelVerification, Link, ParseResult, Projection, ProjectionContext, Reached, Reference, Refusal, RoomReference, Span, Validation, ValidationContext, ValidationStep, VerifiedModel, } from './types.js';
 export { assess, bodyRoomLinks, checkDocument, resolves, roomReferences, sectionReferences, validate, validating, verdicts, verify, } from './validate.js';

package/dist/mdruntime/adapter.d.ts

@@ -269,7 +269,6 @@ export type HeadChange = {
     time: string;
 };
 export type BinaryFile = {
-    fileRef: string;
     byteLength: number;
     mediaType: string;
     sha256: string;
@@ -290,6 +289,12 @@ export type BootstrapRequest = {
     selection: string;
     pageToken?: PageToken;
     held?: HeldContent;
+    received?: Uint8Array;
+    arriving?: (bytes: number) => void;
+};
+export type BootstrapInventory = {
+    readonly parts: number;
+    readonly bytes: number;
 };
 export type RoomModels = {
     collection?: ModelResult;
@@ -306,6 +311,8 @@ export type BootstrapPage = {
     binaryFiles: Readonly<Record<string, BinaryFile>>;
     folders?: readonly string[];
     pageToken?: PageToken;
+    inventory?: BootstrapInventory;
+    received?: Uint8Array;
 };
 export type BootstrapResult = BootstrapPage | {
     kind: 'beyond-horizon';
@@ -412,15 +419,6 @@ export type BinaryRequest = {
     locator: string;
     path: string;
     revision: string;
-    fileRef?: string;
-} | {
-    kind: 'reference';
-    fileRef: string;
-    referrer: unknown;
-};
-export type ReferrerScope = {
-    locator: string;
-    path?: string;
 };
 export type BinaryResult = {
     kind: 'binary';
@@ -504,10 +502,7 @@ 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;
+    link(authorization: Authorization, request: BinaryRequest): Promise<BinaryLinkResult>;
     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/binary.d.ts

@@ -3,7 +3,6 @@ export type BinaryFileRecord = {
     readonly state: 'accepted';
     readonly revision: string;
     readonly path: string;
-    readonly fileRef: string;
     readonly byteLength: number;
     readonly mediaType: string;
     readonly sha256: string;
@@ -15,8 +14,4 @@ export type BinaryFileRecord = {
     readonly mediaType: string;
     readonly sha256: string;
 };
-export type BinaryReference = {
-    readonly fileRef: string;
-    readonly referrer: unknown;
-};
 export declare function binaryRecord(path: string, held: HeldBinary, revision: string | undefined): BinaryFileRecord;

package/dist/mdruntime/client.d.ts

@@ -2,7 +2,6 @@ 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 { BinaryReference } from './binary.js';
 import type { ChosenFile } from './file.js';
 import type { BinaryAnswer, BinaryLinkAnswer, CallResult, HistoryAnswer, Offline, QueueEntry, Resolution } from './outcome.js';
 import type { DocumentQuery, DocumentResult, GroupQuery, GroupResult, PendingResult } from './query.js';
@@ -54,7 +53,6 @@ export type MdRuntimeClient = {
     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>;
     reached(locator: string, roomVersion: string, path?: string): Promise<boolean>;

package/dist/mdruntime/connection.d.ts

@@ -7,14 +7,13 @@ 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 BinaryReference } from './binary.js';
 import { type BinaryLinkAnswer, type CallResult, type HeldBinaryAnswer, 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';
 import { type SyncStatus } from './status.js';
 import { type RuntimeShell } from './durability.js';
-import { type CapacityCause, type CodeAvailability, type Persistence, type Readiness, type SearchObligation } from './readiness.js';
+import { type CodeAvailability, type Persistence, type Readiness, type SearchObligation, type Space } from './readiness.js';
 import type { RuntimeDatabase } from './tables.js';
 import { type NarrowedView, type PortReach, type RuntimeView } from './reach.js';
 export type AppTypedSelection = {
@@ -84,7 +83,6 @@ export type PresentationSurface = {
 export type BinaryFileSurface = {
     read(room: string, path: string, revision?: string): Promise<HeldBinaryAnswer>;
     link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
-    readReference(reference: BinaryReference): Promise<HeldBinaryAnswer>;
     part(file: string, part: number): Promise<Uint8Array | null>;
 };
 export type HistoryQuery = {
@@ -138,7 +136,7 @@ export type RuntimeTopic = 'rooms' | 'readiness' | 'connection-refusal' | 'stora
 export type ReadinessPort = {
     readonly target: string;
     readonly code: CodeAvailability;
-    readonly capacity: CapacityCause | null;
+    readonly space: Space | null;
     readonly search: SearchObligation;
 };
 export type ComposedRuntime = RuntimeView & {
@@ -146,6 +144,7 @@ export type ComposedRuntime = RuntimeView & {
     stop(): Promise<void>;
     lose(locators: readonly string[]): Promise<void>;
     persisted(answer: Persistence): void;
+    shown(onScreen: boolean): void;
     within(reach: PortReach | null, port: ReadinessPort): NarrowedView;
 };
 export declare function composeRuntime(options: MdRuntimeOptions): ComposedRuntime;

package/dist/mdruntime/conversation.d.ts

@@ -85,6 +85,7 @@ export type ConversationDependencies = {
     stream(): ConversationStream | undefined;
     publish(set: ChangeSet): void;
     online(): boolean;
+    full(): boolean;
     closed(): boolean;
     unanswered(): void;
     expired(operation: string): boolean;
@@ -112,5 +113,6 @@ export type ConversationStore = {
 };
 export declare function unheldView(conversation: string): ConversationView;
 export declare const SESSION_STARTED = "Session started";
+export declare const HISTORY_CONVERSATIONS = 64;
 export declare function newChat(agent: string): string;
 export declare function createConversationStore(deps: ConversationDependencies): ConversationStore;

package/dist/mdruntime/durability.d.ts

@@ -1,15 +1,12 @@
 import type { Persistence } from './readiness.js';
-export type StorageEstimate = {
-    readonly usage: number;
-    readonly total: number;
-};
 export type RuntimeShell = {
     persistence: Persistence;
     generation: string | null;
+    onScreen: boolean;
     keepGeneration(value: string): void | Promise<void>;
     dropGeneration(): void | Promise<void>;
-    estimate?(): Promise<StorageEstimate | null>;
     cleanUp?(): Promise<number>;
 };
+export declare function refusedForSpace(error: unknown): boolean;
 export declare function detectStorageLoss(stored: string | null, reported: string | null): string | null;
 export declare function nextGeneration(stored: string | null, reported: string | null): string;

package/dist/mdruntime/outcome.d.ts

@@ -44,7 +44,6 @@ export declare const UNREADABLE: Refused<'unreadable'>;
 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 absentReference(fileRef: string): Refused<'absent'>;
 export declare function binaryAnswer(result: KeptResult): HeldBinaryAnswer;
 export declare function binaryLinkAnswer(result: BinaryLinkResult): BinaryLinkAnswer;
 export declare const ROOM_LOCKED = "room-locked";

package/dist/mdruntime/reach.d.ts

@@ -1,4 +1,3 @@
-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';
@@ -28,7 +27,6 @@ export type Reachable = RuntimeView & {
     watchPlan(plan: Plan, deliver: (message: unknown) => void): () => void;
     search(input: unknown, reach: PortReach | null, locked: readonly string[]): Promise<SearchResult>;
     watchReadiness(port: ReadinessPort, reach: PortReach | null, deliver: (readiness: Readiness) => void): () => void;
-    referrerScope(referrer: unknown): ReferrerScope | null;
     locked(room: string): boolean;
     lockedRooms(): readonly string[];
     watchLocks(notify: () => void): () => void;

package/dist/mdruntime/readiness.d.ts

@@ -18,17 +18,28 @@ export type Persistence = Open<'granted' | 'denied' | 'unavailable'>;
 export type Durability = Open<'persistent' | 'best-effort'>;
 export type ConnectionAvailability = Open<'connected' | 'connecting' | 'unreachable'>;
 export type HouseOutcome = Open<'open' | 'write-halted' | 'refused'>;
-export type CapacityCause = {
-    readonly cause: Open<'insufficient-space' | 'storage-exceeded'>;
-    readonly needed: number | null;
-    readonly available: number | null;
-};
+export type Space = Open<'full'>;
 export type RefusedRoom = {
     readonly room: string;
+    readonly name: string;
     readonly file: string;
     readonly rule: string;
     readonly location: string | null;
 };
+export type InstallationStep = Open<'listing' | 'downloading' | 'writing' | 'replaying'>;
+export type InstallationPause = Open<'hidden'>;
+export type InstallationAmount = {
+    readonly done: number;
+    readonly total: number;
+};
+export type Installation = {
+    readonly step: InstallationStep | null;
+    readonly paused: InstallationPause | null;
+    readonly rooms: InstallationAmount;
+    readonly parts: InstallationAmount;
+    readonly bytes: InstallationAmount;
+    readonly received: InstallationAmount;
+};
 export type ReadinessStatus = Open<'preparing' | 'paused' | 'refused' | 'ready' | 'lost'>;
 export type Readiness = {
     readonly status: ReadinessStatus;
@@ -40,7 +51,8 @@ export type Readiness = {
     readonly persistence: Persistence;
     readonly connection: ConnectionAvailability;
     readonly house: HouseOutcome;
-    readonly capacity: CapacityCause | null;
+    readonly space: Space | null;
+    readonly installation: Installation;
     readonly refused: readonly RefusedRoom[];
     readonly lost: boolean;
 };
@@ -48,5 +60,4 @@ export type ReadinessFacts = Omit<Readiness, 'status' | 'ready' | 'usable' | 'du
     readonly coverage: Omit<TargetCoverage, 'complete'>;
     readonly established: boolean;
 };
-export declare const SETTLED_ROOMS: ReadonlySet<string>;
 export declare function readinessOf(facts: ReadinessFacts): Readiness;

package/dist/mdruntime/replica.d.ts

@@ -1,4 +1,4 @@
-import type { MutationResult, OperationScopes, ReplicaAdmission, TypedSelection } from './adapter.js';
+import type { BootstrapInventory, MutationResult, OperationScopes, ReplicaAdmission, TypedSelection } from './adapter.js';
 import { type ChangeBatch, type Precondition } from './change.js';
 import { type Collection, type Composition } from './collection.js';
 import type { ModelState } from './model.js';
@@ -16,6 +16,7 @@ export type ReplicaRecord = {
     readonly providerOwnedPaths: readonly string[];
     readonly roomVersion: string;
     readonly transfer: string;
+    readonly inventory: BootstrapInventory | null;
     readonly key: number;
 };
 export type HeldReplica = {
@@ -24,6 +25,7 @@ export type HeldReplica = {
     readonly overlaid: ReadonlySet<string>;
     readonly count: number;
     readonly confirmed: number;
+    readonly indexed: boolean;
 };
 export type VisibleLayer = Layer & {
     readonly collection: Collection;

package/dist/mdruntime/store.d.ts

@@ -1,4 +1,4 @@
-import type { Capability, KeptReceipt, Member, ProviderLimit } from './adapter.js';
+import type { BootstrapInventory, Capability, KeptReceipt, Member, ProviderLimit } from './adapter.js';
 import type { ChangeBatch } from './change.js';
 import type { Composition } from './collection.js';
 import type { Plan } from './query.js';
@@ -9,6 +9,10 @@ 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';
 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;
@@ -16,6 +20,9 @@ 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;
@@ -83,7 +90,7 @@ export type RefreshedPage = StagedPage & {
 export type Opened = {
     readonly rooms: ReadonlyMap<string, ReplicaRecord>;
     readonly transfers: ReadonlyMap<string, TransferRecord>;
-    readonly unprepared: ReadonlySet<number>;
+    readonly unindexed: ReadonlySet<number>;
     readonly overlaid: ReadonlyMap<number, ReadonlySet<string>>;
     readonly erasing: boolean;
     readonly orphans: readonly number[];
@@ -116,7 +123,9 @@ export type RuntimeStore = {
     }[]>;
     typedWithin(key: number, view: View, roots: readonly string[], within: boolean): Promise<boolean>;
     search(ask: SearchAsk): Promise<SearchWindow>;
-    stage(record: TransferRecord, composition: Composition, page: StagedPage, key: number | null, last: boolean): Promise<number | null>;
+    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>;
     refresh(key: number, page: RefreshedPage): Promise<void>;
     unrefresh(key: number): Promise<void>;
     commit(commit: Commit): Promise<CommittedWrite>;

package/dist/mdruntime/stored.d.ts

@@ -84,7 +84,7 @@ export type RoomCommit = {
 export type Committed = {
     readonly counts: Readonly<Record<string, number>>;
     readonly changed: Readonly<Record<string, readonly string[] | null>>;
-    readonly prepared: Readonly<Record<string, boolean>>;
+    readonly indexed: Readonly<Record<string, boolean>>;
 };
 export type CountedRoom = {
     readonly key: number;
@@ -99,11 +99,12 @@ export declare function entered(connection: Connection, locator: string, composi
 export declare function stage(connection: Connection, request: {
     readonly locator: string;
     readonly transfer: string;
-    readonly record: string | null;
+    readonly record: string;
     readonly key: number | null;
     readonly composition: Composition;
     readonly entries: readonly StoredEntry[];
     readonly folders: readonly string[];
+    readonly written?: string;
 }): number;
 export declare function refreshing(connection: Connection, request: {
     readonly key: number;
@@ -133,5 +134,11 @@ export declare function files(connection: Connection, key: number, view: View, a
     readonly revision: string;
 }[];
 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: {
+    readonly locator: string;
+    readonly token: string;
+    readonly part: Uint8Array;
+}): null;
 export declare function opened(connection: Connection): ReplicaOpened;
 export declare function ended(connection: Connection): void;

package/dist/mdruntime/tables.d.ts

@@ -26,6 +26,15 @@ export interface SqliteEngine {
         heap8u(): Uint8Array;
     };
 }
+export interface SqliteStatement {
+    readonly parameterCount: number;
+    bind(values: readonly Value[]): unknown;
+    step(): boolean;
+    get(values: Value[]): Value[];
+    getColumnNames(names: string[]): string[];
+    resetNoThrow(clearBindings: boolean): number;
+    finalize(): unknown;
+}
 export interface SqliteDatabase {
     readonly pointer: number;
     exec(options: {
@@ -34,6 +43,7 @@ export interface SqliteDatabase {
         readonly rowMode?: 'object';
         readonly returnValue?: 'resultRows';
     }): Row[];
+    prepare(sql: string): SqliteStatement;
 }
 export declare function sqliteConnection(engine: SqliteEngine, database: SqliteDatabase): Connection;
 export declare const FILE_PART_BYTES = 1048576;
@@ -47,6 +57,7 @@ export interface FileSpool {
     held(): Iterable<string>;
     spool(key: string, type: string, parts: Iterable<Uint8Array>): Promise<Blob>;
     drop(key: string): Promise<void>;
+    probe(bytes: number): Promise<void>;
 }
 export type KeptPending = {
     readonly id: string;
@@ -204,12 +215,22 @@ export interface RuntimeRequests {
     readonly 'replica.stage': Asked<{
         readonly locator: string;
         readonly transfer: string;
-        readonly record: string | null;
+        readonly record: string;
         readonly key: number | null;
         readonly composition: Composition;
         readonly entries: readonly StoredEntry[];
         readonly folders: readonly string[];
+        readonly written?: string;
     }, number | null>;
+    readonly 'replica.transferPart': Asked<{
+        readonly locator: string;
+        readonly token: string;
+    }, Uint8Array | null>;
+    readonly 'replica.keepPart': Asked<{
+        readonly locator: string;
+        readonly token: string;
+        readonly part: Uint8Array;
+    }, null>;
     readonly 'replica.refresh': Asked<{
         readonly key: number;
         readonly entries: readonly StoredEntry[];
@@ -313,6 +334,7 @@ export interface RuntimeRequests {
     readonly 'conversation.drop': Asked<{
         readonly conversations: readonly string[];
     }, null>;
+    readonly 'space.probe': Asked<Nothing, null>;
 }
 export type RuntimeKind = keyof RuntimeRequests;
 export type RuntimeRequest<K extends RuntimeKind = RuntimeKind> = {

package/dist/mdruntime/wire.d.ts

@@ -54,10 +54,6 @@ declare const MEMBERS: {
         readonly reach: 'within';
         readonly effect: 'read';
     };
-    readonly 'binaryFile.readReference': {
-        readonly reach: 'within';
-        readonly effect: 'read';
-    };
     readonly 'binaryFile.part': {
         readonly reach: 'within';
         readonly effect: 'read';

package/docs/families.md

@@ -56,8 +56,8 @@
   applied any other call, an act on House is answered the outcome
   `transport-uncertainty`, and every other call, a Save or a draft write among
   them, fails with the retryable code `transport-uncertainty`.
-- **Site image read** - given a Published Room and an original attachment
-  reference, it answers the web copy's path and metadata, or `null` when no
+- **Site image read** - given a Published Room and the Path of one of its
+  binary entries, it answers the web copy's path and metadata, or `null` when no
   copy exists. The original bytes never cross this bridge at a Site.
 - **App release code** - `sourceTop(app, release)` answers the top level of
   the latest successful release of an App the User may use: its folders, its
@@ -84,7 +84,7 @@
   the sender's User id, and `body`, the JSON value they sent, until the
   function it returns is called. App code sends one through the Runtime's
   `call('message.send', { to, body })` with the recipient's User id and
-  a body of at most 32 KiB of JSON; House fills in the App and relays it only
+  a body of at most 32 kB of JSON; House fills in the App and relays it only
   to copies running now, storing nothing. The panel sends none.
 - **App screenshot read** - given an App reference, `readScreenshot(app)`
   answers the image this browser captured of that App's screen the first time

package/package.json

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