@agentshouse/mdruntime 0.1.0-cf6041a06849c → 0.1.0-cf96c797c5fa8

package/dist/attempt.js

@@ -0,0 +1,57 @@
+import { changeBatchIdentity } from './identity.js';
+export function identities(mint = () => changeBatchIdentity()) {
+    const kept = new Map();
+    let used = new Map();
+    return {
+        of(intent) {
+            const one = used.get(intent) ?? kept.get(intent) ?? mint();
+            used.set(intent, one);
+            return one;
+        },
+        settle(answered) {
+            if (answered !== 'offline') {
+                for (const [intent, one] of used) {
+                    if (answered === 'unanswered')
+                        kept.set(intent, one);
+                    else
+                        kept.delete(intent);
+                }
+            }
+            used = new Map();
+        },
+    };
+}
+export function intentOf(name, about) {
+    return `${name}\u0000${JSON.stringify(about)}`;
+}
+export function attempts(mint) {
+    const numbers = identities(mint);
+    const waiting = new Map();
+    return {
+        begin(act) {
+            const intents = [];
+            return {
+                identity(intent) {
+                    intents.push(intent);
+                    return numbers.of(intent);
+                },
+                settle(answered, drop) {
+                    numbers.settle(answered);
+                    if (answered === 'refused' || answered === 'offline')
+                        drop(act);
+                    if (answered === 'offline')
+                        return;
+                    for (const intent of intents) {
+                        const earlier = waiting.get(intent);
+                        if (earlier !== undefined && earlier !== act)
+                            drop(earlier);
+                        if (answered === 'unanswered')
+                            waiting.set(intent, act);
+                        else
+                            waiting.delete(intent);
+                    }
+                },
+            };
+        },
+    };
+}

package/dist/binary.d.ts

@@ -0,0 +1,23 @@
+import type { HeldBinary } from './overlay.js';
+export type BinaryFileRecord = {
+    readonly state: 'accepted';
+    readonly revision: string;
+    readonly path: string;
+    readonly fileRef: string;
+    readonly byteLength: number;
+    readonly mediaType: string;
+    readonly sha256: string;
+} | {
+    readonly state: 'pending';
+    readonly localId: string;
+    readonly path: string;
+    readonly byteLength: number;
+    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;
+//# sourceMappingURL=binary.d.ts.map

package/dist/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../src/binary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GACxB;IACE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvF,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,gBAAgB,CAKlB"}

package/dist/binary.js

@@ -0,0 +1,8 @@
+export function binaryRecord(path, held, revision) {
+    const facts = { byteLength: held.byteLength, mediaType: held.mediaType, sha256: held.sha256 };
+    if (held.state === 'pending')
+        return { state: 'pending', localId: held.localId, path, ...facts };
+    if (revision === undefined)
+        throw new Error(`the accepted binary file ${path} has no revision`);
+    return { state: 'accepted', revision, path, fileRef: held.fileRef, ...facts };
+}

package/dist/bootstrap.d.ts

@@ -1,12 +1,24 @@
 import type { ModelState } from './model.js';
-import type { Adapter, AdapterFailure, Authorization, DiscoveredRoom, RoomModels } from './adapter.js';
-import { type Staged } from './replica.js';
-import { type Unconfirmed } from './transfer.js';
-export type BootstrapOutcome = Staged | Unconfirmed | AdapterFailure;
+import type { Adapter, AdapterFailure, Authorization, DiscoveredRoom, RetryableRefusal, RoomModels } from './adapter.js';
+import { type ConfirmedLayer } from './replica.js';
+import type { StagedLayer, TransferRecord } from './store.js';
+import { type Refused, type Unconfirmed } from './transfer.js';
+export type Bootstrapped = {
+    kind: 'staged';
+    confirmed: ConfirmedLayer;
+    stored: StagedLayer;
+};
+export type BootstrapOutcome = Bootstrapped | Refused | Unconfirmed | RetryableRefusal | AdapterFailure;
 export type HeldModels = {
     collection: ModelState;
     selection: ModelState;
 };
 export type Remodel = (models: RoomModels | undefined, held: HeldModels) => HeldModels;
-export declare function bootstrapRoom(adapter: Adapter, authorization: Authorization, room: DiscoveredRoom, held: HeldModels, remodel: Remodel, continuing: () => boolean): Promise<BootstrapOutcome>;
+export type Staging = {
+    held(locator: string): TransferRecord | null;
+    staged(record: TransferRecord): Promise<StagedLayer>;
+    stage(record: TransferRecord, page: StagedLayer): Promise<boolean>;
+    abandon(locator: string): Promise<void>;
+};
+export declare function bootstrapRoom(adapter: Adapter, authorization: Authorization, room: DiscoveredRoom, held: HeldModels, remodel: Remodel, continuing: () => boolean, staging: Staging): Promise<BootstrapOutcome>;
 //# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,aAAa,EACb,cAAc,EAGd,UAAU,EACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC;AAErE,MAAM,MAAM,UAAU,GAAG;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC;AAEvF,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,OAAO,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA+C3B"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,aAAa,EAEb,cAAc,EAEd,gBAAgB,EAChB,UAAU,EACX,MAAM,cAAc,CAAC;AAItB,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAiB,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAe,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5E,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAE9F,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,OAAO,GACP,WAAW,GACX,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,MAAM,UAAU,GAAG;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC;AAEvF,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAC7C,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrD,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,CAAC;AAgCF,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,OAAO,EACzB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,gBAAgB,CAAC,CA0E3B"}

package/dist/bootstrap.js

@@ -1,56 +1,107 @@
-import { declaredAttachments } from './attachment.js';
+import { transferIdentity } from './identity.js';
+import { advancement } from './refresh.js';
+import { acceptedBinaries } from './overlay.js';
 import { readStaged } from './replica.js';
 import { unconfirmed } from './transfer.js';
-export async function bootstrapRoom(adapter, authorization, room, held, remodel, continuing) {
-    const first = await adapter.bootstrap(authorization, {
-        locator: room.locator,
-        selection: room.replica.selection,
-    });
-    if (first.kind !== 'bootstrap')
-        return first;
-    const roomVersion = first.roomVersion;
-    const models = remodel(first.models, held);
-    const documents = { ...first.documents };
-    const revisions = { ...first.revisions };
-    const changes = { ...first.changes };
-    const binaryTargets = new Set(first.binaryTargets);
-    const attachments = [first.attachments ?? []];
-    let pageToken = first.pageToken;
-    while (pageToken !== undefined) {
+const RESUMABLE = new Set([
+    'transport-uncertainty',
+    'retryable-refusal',
+    'unconfirmed',
+]);
+function pageLayer(page) {
+    return {
+        documents: page.documents,
+        revisions: page.revisions,
+        changes: page.changes,
+        written: Object.fromEntries(Object.keys(page.documents).map((path) => [path, page.roomVersion])),
+        binaries: acceptedBinaries(page.binaryFiles),
+    };
+}
+async function heldTransfer(staging, room) {
+    const record = staging.held(room.locator);
+    if (record === null)
+        return null;
+    if (record.selection === room.replica.selection) {
+        return { record, layer: await staging.staged(record) };
+    }
+    await staging.abandon(room.locator);
+    return null;
+}
+export async function bootstrapRoom(adapter, authorization, room, held, remodel, continuing, staging) {
+    const locator = room.locator;
+    const selection = room.replica.selection;
+    const kept = await heldTransfer(staging, room);
+    const documents = { ...kept?.layer.documents };
+    const revisions = { ...kept?.layer.revisions };
+    const changes = { ...kept?.layer.changes };
+    const written = { ...kept?.layer.written };
+    const binaries = { ...kept?.layer.binaries };
+    let transfer = kept?.record ?? null;
+    while (transfer === null || transfer.pageToken !== null) {
         if (!continuing())
             return unconfirmed;
         const page = await adapter.bootstrap(authorization, {
-            locator: room.locator,
-            selection: room.replica.selection,
-            pageToken,
+            locator,
+            selection,
+            ...(transfer?.pageToken == null ? {} : { pageToken: transfer.pageToken }),
         });
-        if (page.kind !== 'bootstrap')
+        if (page.kind !== 'bootstrap') {
+            if (!RESUMABLE.has(page.kind))
+                await staging.abandon(locator);
             return page;
-        if (page.roomVersion !== roomVersion)
+        }
+        transfer = {
+            locator,
+            transfer: transfer?.transfer ?? transferIdentity(),
+            selection,
+            from: transfer?.from ?? page.roomVersion,
+            last: page.roomVersion,
+            pageToken: page.pageToken ?? null,
+            models: remodel(page.models, transfer?.models ?? held),
+        };
+        const staged = pageLayer(page);
+        if (!(await staging.stage(transfer, staged)))
             return unconfirmed;
-        Object.assign(documents, page.documents);
-        Object.assign(revisions, page.revisions);
-        Object.assign(changes, page.changes);
-        for (const target of page.binaryTargets)
-            binaryTargets.add(target);
-        attachments.push(page.attachments ?? []);
-        pageToken = page.pageToken;
+        Object.assign(documents, staged.documents);
+        Object.assign(revisions, staged.revisions);
+        Object.assign(changes, staged.changes);
+        Object.assign(written, staged.written);
+        Object.assign(binaries, staged.binaries);
     }
-    return readStaged({
-        locator: room.locator,
+    const record = {
+        locator,
         name: room.name,
+        handle: room.handle,
         operations: room.operations,
         replica: room.replica,
-        model: models.collection,
+        model: transfer.models.collection,
         typedSelection: room.typedSelection ?? null,
-        selectionModel: models.selection,
+        selectionModel: transfer.models.selection,
         providerOwnedPaths: room.providerOwnedPaths,
-        roomVersion,
+        roomVersion: transfer.from,
+        transfer: transfer.transfer,
         documents,
-        binaryTargets: [...binaryTargets].sort(),
+        binaries,
         revisions,
         changes,
-        written: Object.fromEntries(Object.keys(documents).map((path) => [path, roomVersion])),
-        attachments: declaredAttachments(attachments),
-    });
+        written,
+    };
+    const reconciled = transfer.last === transfer.from
+        ? { kind: 'still-current' }
+        : await advancement(adapter, authorization, record, remodel, continuing);
+    if (reconciled.kind === 'advanced' || reconciled.kind === 'still-current') {
+        const read = readStaged(reconciled.kind === 'advanced' ? reconciled.record : record);
+        if (read.kind === 'refused') {
+            await staging.abandon(locator);
+            return read;
+        }
+        return { kind: 'staged', confirmed: read.confirmed, stored: record };
+    }
+    if (reconciled.kind === 'beyond-horizon') {
+        await staging.abandon(locator);
+        return unconfirmed;
+    }
+    if (!RESUMABLE.has(reconciled.kind))
+        await staging.abandon(locator);
+    return reconciled;
 }

package/dist/change-set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-set.d.ts","sourceRoot":"","sources":["../src/change-set.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAU,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,EAAE,CAAC;IACvB,KAAK,EAAE,SAAS,GAAG,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,MAAM,EAAE,SAAS;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AAqBF,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,KAAK,EAAE,OAAO,GAAG,IAAI,EACrB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,SAAS,CAiDX;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,SAAS,CAUX;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAUrE"}
+{"version":3,"file":"change-set.d.ts","sourceRoot":"","sources":["../src/change-set.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAwB,KAAK,GAAG,EAAE,MAAM,WAAW,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,EAAE,CAAC;IACvB,KAAK,EAAE,SAAS,GAAG,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,MAAM,EAAE,SAAS;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AAuBF,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,KAAK,EAAE,OAAO,GAAG,IAAI,EACrB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,SAAS,CAoDX;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,SAAS,CAUX;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAUrE"}

package/dist/change-set.js

@@ -1,15 +1,19 @@
-import { sameChange } from './overlay.js';
+import { passingDocument } from './collection.js';
+import { binaryRecord } from './binary.js';
+import { sameBinary, sameChange } from './overlay.js';
 import { beneath } from './paths.js';
 import { compositionOf, sameMembership } from './replica.js';
-import { rowsOf } from './rows.js';
+import { markdownPath, rowsOf } from './rows.js';
 function rowsAt(locator, replica, path) {
     if (replica === null)
         return [];
-    const document = replica.visible.collection.documents[path];
-    if (document === undefined && !replica.visible.binaryTargets.includes(path)) {
+    const visible = replica.visible;
+    const document = markdownPath(path) ? passingDocument(visible.collection, path) : null;
+    const held = visible.documents[path] !== undefined && document !== undefined;
+    const binary = visible.binaries[path];
+    if (!held && binary === undefined)
         return [];
-    }
-    return rowsOf(locator, path, document ?? null, compositionOf(replica.confirmed.record), replica.visible.changes[path] ?? null);
+    return rowsOf(locator, path, document ?? null, compositionOf(replica.confirmed.record), visible.changes[path] ?? null, binary === undefined ? null : binaryRecord(path, binary, visible.revisions[path]));
 }
 function modelShape(model) {
     return model.status === 'unavailable' ? 'unavailable' : JSON.stringify(model.types);
@@ -18,8 +22,8 @@ export function changeSet(locator, before, after, changed = {}) {
     const paths = new Set([
         ...Object.keys(before?.visible.documents ?? {}),
         ...Object.keys(after?.visible.documents ?? {}),
-        ...(before?.visible.binaryTargets ?? []),
-        ...(after?.visible.binaryTargets ?? []),
+        ...Object.keys(before?.visible.binaries ?? {}),
+        ...Object.keys(after?.visible.binaries ?? {}),
     ]);
     const documents = [];
     const oldRoom = before?.confirmed.record;
@@ -35,8 +39,7 @@ export function changeSet(locator, before, after, changed = {}) {
         const selected = newRoom?.typedSelection?.roots.some((root) => beneath(root, path)) ?? false;
         const retyped = selected ? selectionChanged : collectionChanged;
         if (before?.visible.documents[path] === after?.visible.documents[path] &&
-            before?.visible.binaryTargets.includes(path) ===
-                after?.visible.binaryTargets.includes(path) &&
+            sameBinary(before?.visible.binaries[path], after?.visible.binaries[path]) &&
             before?.visible.revisions[path] === after?.visible.revisions[path] &&
             sameChange(before?.visible.changes[path], after?.visible.changes[path]) &&
             !retyped &&
@@ -45,8 +48,12 @@ export function changeSet(locator, before, after, changed = {}) {
         documents.push({
             locator,
             path,
-            before: rowsAt(locator, before, path),
-            after: rowsAt(locator, after, path),
+            get before() {
+                return rowsAt(locator, before, path);
+            },
+            get after() {
+                return rowsAt(locator, after, path);
+            },
         });
     }
     return {

package/dist/change.d.ts

@@ -25,6 +25,14 @@ export type Change = {
     readonly kind: 'replace';
     readonly path: string;
     readonly content: string;
+} | {
+    readonly kind: 'binary';
+    readonly path: string;
+    readonly localId: string;
+    readonly blob: Blob;
+    readonly byteLength: number;
+    readonly mediaType: string;
+    readonly sha256: string;
 } | {
     readonly kind: 'move';
     readonly path: string;
@@ -51,6 +59,10 @@ export type Precondition = {
     readonly kind: 'revision';
     readonly path: string;
     readonly revision: string;
+} | {
+    readonly kind: 'content';
+    readonly path: string;
+    readonly content: string;
 } | {
     readonly kind: 'present';
     readonly path: string;
@@ -71,4 +83,7 @@ export type ChangeBatch = {
     readonly writtenBy?: WrittenBy;
 };
 export declare function immutable(batch: ChangeBatch): ChangeBatch;
+export declare function landing(changes: readonly Change[], index: number, path: string): string | null;
+export declare function departure(changes: readonly Change[], index: number): string;
+export declare function queuedFile(batch: ChangeBatch, path: string, localId: string): number;
 //# sourceMappingURL=change.d.ts.map

package/dist/change.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../src/change.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../src/change.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GACd;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5E;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7E;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,YAAY,GACpB;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,CAAC,EAAE,OAAO,YAAY,EAAE,iBAAiB,CAAC;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAChC,CAAC;AAUF,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAEzD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ9F;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAOpF"}

package/dist/change.js

@@ -1,7 +1,7 @@
 function frozen(value) {
     if (Array.isArray(value))
         return Object.freeze(value.map((item) => frozen(item)));
-    if (value === null || typeof value !== 'object')
+    if (value === null || typeof value !== 'object' || value instanceof Blob)
         return value;
     const copy = {};
     for (const [name, item] of Object.entries(value))
@@ -11,3 +11,28 @@ function frozen(value) {
 export function immutable(batch) {
     return frozen(batch);
 }
+export function landing(changes, index, path) {
+    let at = path;
+    for (const change of changes.slice(index + 1)) {
+        if (change.path !== at)
+            continue;
+        if (change.kind === 'remove')
+            return null;
+        if (change.kind === 'move')
+            at = change.to;
+    }
+    return at;
+}
+export function departure(changes, index) {
+    let at = changes[index].path;
+    for (const change of changes.slice(0, index).reverse()) {
+        if (change.kind === 'move' && change.to === at)
+            at = change.path;
+    }
+    return at;
+}
+export function queuedFile(batch, path, localId) {
+    return batch.changes.findIndex((change, index) => change.kind === 'binary' &&
+        change.localId === localId &&
+        landing(batch.changes, index, change.path) === path);
+}

package/dist/chat/acts.d.ts

@@ -0,0 +1,34 @@
+import { type Answered } from '../attempt.js';
+import { type CallResult } from '../outcome.js';
+import type { Expected } from './overlay.js';
+export type ChatResult = CallResult | {
+    readonly kind: 'offline';
+};
+export type ChatOutcome = {
+    readonly state: 'sending';
+} | {
+    readonly state: 'offline';
+} | {
+    readonly state: 'failed';
+    readonly result: CallResult;
+};
+export declare function accepted(result: ChatResult): result is Extract<CallResult, {
+    readonly kind: 'action';
+}>;
+export declare function unanswered(result: ChatResult): boolean;
+export declare function outcomeOf(result: ChatResult): ChatOutcome | null;
+export declare function answeredOf(result: ChatResult): Answered;
+export type Sender = {
+    carried(name: string, about: unknown, sending: (operation: string) => Promise<CallResult>): Promise<ChatResult>;
+    expect(expected: Expected): void;
+    draw(expected: Expected): void;
+};
+type Senders = {
+    readonly online: boolean;
+    identity(intent: string): string;
+    expect(expected: Expected): void;
+    draw(expected: Expected): void;
+};
+export declare function sender({ online, identity, expect, draw }: Senders): Sender;
+export {};
+//# sourceMappingURL=acts.d.ts.map

package/dist/chat/acts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acts.d.ts","sourceRoot":"","sources":["../../src/chat/acts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAE9D,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,GACjB,MAAM,IAAI,OAAO,CAAC,UAAU,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAE5D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAGhE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAIvD;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,GAClD,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,KAAK,OAAO,GAAG;IACb,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,wBAAgB,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,GAAG,MAAM,CAa1E"}

package/dist/chat/acts.js

@@ -0,0 +1,36 @@
+import { intentOf } from '../attempt.js';
+import { UNCERTAIN } from '../outcome.js';
+export function accepted(result) {
+    return result.kind === 'action';
+}
+export function unanswered(result) {
+    return result.kind === 'transport-uncertainty';
+}
+export function outcomeOf(result) {
+    if (accepted(result))
+        return null;
+    return result.kind === 'offline' ? { state: 'offline' } : { state: 'failed', result };
+}
+export function answeredOf(result) {
+    if (accepted(result))
+        return 'accepted';
+    if (result.kind === 'offline')
+        return 'offline';
+    return unanswered(result) ? 'unanswered' : 'refused';
+}
+export function sender({ online, identity, expect, draw }) {
+    return {
+        async carried(name, about, sending) {
+            if (!online)
+                return { kind: 'offline' };
+            try {
+                return await sending(identity(intentOf(name, about)));
+            }
+            catch {
+                return UNCERTAIN;
+            }
+        },
+        expect,
+        draw,
+    };
+}

package/dist/chat/context.d.ts

@@ -0,0 +1,3 @@
+import type { TurnContext } from '../adapter.js';
+export declare function contextText(context: TurnContext): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/chat/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/chat/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQjD,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAExD"}

package/dist/chat/context.js

@@ -0,0 +1,10 @@
+function figure(tokens) {
+    if (tokens >= 1_000_000)
+        return `${(tokens / 1_000_000).toFixed(1).replace(/\.0$/, '')}M`;
+    if (tokens >= 1_000)
+        return `${Math.round(tokens / 1_000)}k`;
+    return String(tokens);
+}
+export function contextText(context) {
+    return `${figure(context.used)}/${figure(context.window)}`;
+}

package/dist/chat/input.d.ts

@@ -0,0 +1,9 @@
+import { type ReactElement, type ReactNode } from 'react';
+import { type ChatNoteProps } from './kit.js';
+export type ChatInputProps = {
+    readonly messageLength?: number;
+    readonly note?: (note: ChatNoteProps) => ReactNode;
+    readonly autoFocus?: boolean;
+};
+export declare function ChatInput({ messageLength, note, autoFocus, }: ChatInputProps): ReactElement;
+//# sourceMappingURL=input.d.ts.map

package/dist/chat/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/chat/input.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAqBlG,OAAO,EAAsD,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAMlG,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,SAAS,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAiGF,wBAAgB,SAAS,CAAC,EACxB,aAAa,EACb,IAAY,EACZ,SAAiB,GAClB,EAAE,cAAc,GAAG,YAAY,CA+K/B"}