@amalgm/live 0.2.81-preview.34176839240 → 0.2.81-preview.34320593070

package/PURPOSE.md

@@ -13,8 +13,9 @@ The public developer model is `live.bind(surface, channel)` and is specified
 in `docs/realtime-sdk.md`. The shipped wire behavior this package encodes is
 `docs/local-live-protocol.md`. The entity Record/Send/Receive discipline is
 `docs/entity-record-queues.md`. This repository is where those documents
-become executable and testable; the engine repo keeps read-only copies until
-its cutover.
+become executable and testable. The deprecated Engine repository is read-only
+reference evidence; released Live surfaces run only from this package through
+Shell.
 
 ## Axioms
 
@@ -63,10 +64,15 @@ or certify a new wire contract, cloud migration or cross-machine rollout.
    released surface.
 10. **Amalgm's own surfaces use this SDK.** A private shortcut in the Amalgm
     UI or runtime means the SDK is incomplete — fix the SDK, not the caller.
-11. **A workspace has one portable identity.** Its UUIDv7 and computer URI
-    survive renames and rediscovery; local paths locate it but never become a
-    second identity, and every registry change emits both legacy `projects`
-    and canonical `workspaces` resource events.
+11. **A workspace link has one portable identity; a group composes links.** A
+    direct external folder keeps its UUIDv7 and computer URI across renames and
+    rediscovery. Two or more links may have one separately identified, named
+    workspace group on one computer with one selected default child. Promotion into that group
+    retains each child link's identity and never copies its filesystem ground;
+    a child belongs to at most one group. Link and group UUIDs are unique across
+    the complete registry; a rejected replacement changes neither state nor
+    events. Every registry change emits both
+    legacy `projects` and canonical `workspaces` resource events.
 12. **User ground is portable; coordination state is not.** Everything beneath
     an authenticated `users/<email>/` home is registrable except the reserved
     `.amalgm/` directory, transient SQLite journal/lock sidecars, and paths
@@ -390,6 +396,18 @@ or certify a new wire contract, cloud migration or cross-machine rollout.
     is placement work, never correctness work: placement rows converge
     first-wins, a source missing at repack time is skipped silently, and the
     immutable content readers prove never changes even when its locator does.
+45. **Files browse opens one active cloud head.** The authenticated user's
+    `/amalgm/users/<canonical-email>` path is one complete logical namespace.
+    Every browse or content request opens the current cloud graph head once,
+    and all cloud membership and content resolved by that request remains
+    pinned to that immutable head.
+46. **Local is materialization on one computer.** A machine-local path is
+    evidence that one entity is materialized on one computer, never a second
+    file identity or a second directory tree. A present local entity is read
+    through that computer's filesystem port even when legitimate unsynced work
+    makes its version differ from cloud; an absent entity is read from the
+    request's pinned cloud head. Arbitrary machine paths remain an explicit
+    local-only scope and never enter the Amalgm namespace by accident.
 47. **An unfinished merge is settled Checkpoint truth.** Git lock files and
     Amalgm's own reveal marker are transient and may never be captured. A
     stable merge in progress is different: its merge heads, message and mode,
@@ -463,6 +481,8 @@ src/apply/       the Apply/Verify pure submodule: durable intent phases,
                  proof, type-adapter sockets, and crash-resumable orchestration.
 src/registration/ the login-time user-ground convergence operation and its
                   injected local/cloud effect ports.
+src/files/       Files Register/Add decisions plus active-head browse and
+                 per-computer local-source selection behind injected ports.
 src/transfer/    type-aware immutable artifact upload/download operations;
                  chunk storage, R2, files, and Git remain injected effects.
 tests/           unit tests per module, in the engine wall's style: each

package/README.md

@@ -21,8 +21,9 @@ normative specifications live in [docs/](docs/):
 | [local-live-protocol.md](docs/local-live-protocol.md) | the shipped local wire protocol (v1/v2) |
 | [entity-record-queues.md](docs/entity-record-queues.md) | filesystem Record, local Outbox, per-UUID cloud order, and local Inbox |
 | [entity-apply.md](docs/entity-apply.md) | intent-first, type-sensitive Apply and exact Verify |
+| [files-browsing.md](docs/files-browsing.md) | one active-cloud namespace with per-computer local materialization |
 | [shared-realtime-wave-3.md](docs/shared-realtime-wave-3.md) | the multi-user cloud-authority design |
-| [extraction-boundary.md](docs/extraction-boundary.md) | what moves here from the engine runtime, and in what order |
+| [extraction-boundary.md](docs/extraction-boundary.md) | current Live/Shell ownership and the remaining cutover boundary |
 | [user-ground-login.md](docs/user-ground-login.md) | first-login publication, later-device materialization, and Watch readiness |
 | [watching.md](docs/watching.md) | Watch purpose, axioms, lifecycle matrix, and cross-platform test layers |
 
@@ -43,7 +44,7 @@ Every surface delegates to `src/`. One behavior, five doors.
 ```bash
 npm install
 npm test              # build + unit tests
-npm run test:parity   # golden vectors vs the shipped engine runtime
+npm run test:parity   # golden vectors vs read-only historical Engine evidence
 ```
 
 ## Managed candidate delivery

package/dist/files/api.d.ts

@@ -0,0 +1,3 @@
+import { FilesBrowser } from './browser.js';
+export declare function createFilesApi(browser: FilesBrowser): (request: Request) => Promise<Response>;
+//# sourceMappingURL=api.d.ts.map

package/dist/files/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/files/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA8C7F"}

package/dist/files/api.js

@@ -0,0 +1,83 @@
+import { FilesBrowser } from './browser.js';
+import { FilesRequestError } from './browse-types.js';
+export function createFilesApi(browser) {
+    return async (request) => {
+        const url = new URL(request.url);
+        if (request.method !== 'GET')
+            return json(405, 'method_not_allowed', 'Files endpoints are read-only');
+        try {
+            if (url.pathname === '/files/amalgm') {
+                return jsonValue(200, await browser.listAmalgm({
+                    ...optional(url, 'parentId'),
+                    ...optional(url, 'computerId'),
+                }));
+            }
+            if (url.pathname === '/files/amalgm/content') {
+                const read = await browser.readAmalgm({
+                    entityId: required(url, 'entityId'),
+                    ...optional(url, 'computerId'),
+                });
+                return content(read.content, {
+                    'x-amalgm-scope': read.scope,
+                    'x-amalgm-source': read.source,
+                    'x-amalgm-cloud-head': read.head.checksum,
+                    'x-amalgm-entity-id': read.entityId,
+                });
+            }
+            if (url.pathname === '/files/local') {
+                return jsonValue(200, await browser.listLocal({
+                    computerId: required(url, 'computerId'),
+                    ...optional(url, 'path'),
+                }));
+            }
+            if (url.pathname === '/files/local/content') {
+                const read = await browser.readLocal({
+                    computerId: required(url, 'computerId'),
+                    path: required(url, 'path'),
+                });
+                return content(read.content, {
+                    'x-amalgm-scope': read.scope,
+                    'x-amalgm-source': read.source,
+                    'x-amalgm-computer-id': read.computerId,
+                });
+            }
+            return json(404, 'not_found', 'Files route not found');
+        }
+        catch (error) {
+            if (error instanceof FilesRequestError)
+                return json(error.status, error.code, error.message);
+            return json(500, 'files_error', error instanceof Error ? error.message : 'Files request failed');
+        }
+    };
+}
+function required(url, key) {
+    const value = url.searchParams.get(key)?.trim() ?? '';
+    if (!value)
+        throw new FilesRequestError(400, 'invalid_request', `${key} is required`);
+    return value;
+}
+function optional(url, key) {
+    const value = url.searchParams.get(key)?.trim() ?? '';
+    return value ? { [key]: value } : {};
+}
+function content(value, extra) {
+    const headers = {
+        'content-type': value.mediaType,
+        'cache-control': 'no-store',
+        etag: `\"${value.version}\"`,
+        ...extra,
+    };
+    if (value.bytes !== null)
+        headers['content-length'] = String(value.bytes);
+    return new Response(value.body, { status: 200, headers });
+}
+function json(status, code, message) {
+    return jsonValue(status, { error: { code, message } });
+}
+function jsonValue(status, body) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { 'content-type': 'application/json', 'cache-control': 'no-store' },
+    });
+}
+//# sourceMappingURL=api.js.map

package/dist/files/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/files/api.ts"],"names":[],"mappings":"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"}

package/dist/files/browse-types.d.ts

@@ -0,0 +1,65 @@
+import type { EntityStatus, EntityType } from '../entities/index.js';
+export type FilesBody = Uint8Array | ReadableStream<Uint8Array>;
+/** A host-owned byte source. Streams stay streams across the Live boundary. */
+export interface FilesContent {
+    readonly body: FilesBody;
+    readonly mediaType: string;
+    readonly bytes: number | null;
+    /** Exact entity version, or a host-derived version for raw local files. */
+    readonly version: string;
+}
+export interface FilesHeadDescriptor {
+    readonly checksum: string;
+    readonly version: number;
+}
+export interface AmalgmFileEntry {
+    /** Stable id of this directory placement; differs from entityId for a reference mount. */
+    readonly entryId: string;
+    readonly entityId: string;
+    readonly parentEntityId: string | null;
+    readonly referenceId: string | null;
+    readonly name: string;
+    readonly type: EntityType;
+    readonly status: EntityStatus;
+    readonly version: string;
+    readonly availability: {
+        readonly cloud: true;
+        readonly local: boolean;
+        readonly localVersion: string | null;
+        readonly matchesCloud: boolean | null;
+    };
+    /** The route a content request will prefer for the selected computer. */
+    readonly source: 'cloud' | 'local';
+}
+export interface AmalgmDirectoryListing {
+    readonly scope: 'amalgm';
+    readonly root: string;
+    readonly head: FilesHeadDescriptor;
+    readonly computerId: string | null;
+    readonly directory: AmalgmFileEntry;
+    readonly entries: readonly AmalgmFileEntry[];
+}
+export type LocalPathKind = 'directory' | 'file' | 'symlink' | 'other';
+export interface LocalPathEntry {
+    readonly name: string;
+    readonly path: string;
+    readonly kind: LocalPathKind;
+    readonly bytes: number | null;
+    readonly modifiedAt: string | null;
+}
+export interface LocalDirectoryListing {
+    readonly scope: 'local-only';
+    readonly computerId: string;
+    readonly directory: LocalPathEntry;
+    readonly entries: readonly LocalPathEntry[];
+}
+export declare class FilesRequestError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export declare function requiredText(value: unknown, label: string): string;
+export declare function canonicalUserEmail(value: unknown): string;
+export declare function amalgmUserRoot(userEmail: string): string;
+export declare function assertFilesContent(value: unknown, label: string): FilesContent;
+//# sourceMappingURL=browse-types.d.ts.map

package/dist/files/browse-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-types.d.ts","sourceRoot":"","sources":["../../src/files/browse-types.ts"],"names":[],"mappings":"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"}

package/dist/files/browse-types.js

@@ -0,0 +1,46 @@
+export class FilesRequestError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'FilesRequestError';
+    }
+}
+export function requiredText(value, label) {
+    const text = typeof value === 'string' ? value.trim() : '';
+    if (!text)
+        throw new FilesRequestError(400, 'invalid_request', `${label} is required`);
+    return text;
+}
+export function canonicalUserEmail(value) {
+    const email = requiredText(value, 'authenticated user email').toLowerCase();
+    if (email.includes('/') || email.includes('\\') || email.includes('\0')) {
+        throw new FilesRequestError(400, 'invalid_identity', 'authenticated user email is not path-safe');
+    }
+    return email;
+}
+export function amalgmUserRoot(userEmail) {
+    return `/amalgm/users/${canonicalUserEmail(userEmail)}`;
+}
+export function assertFilesContent(value, label) {
+    const content = value;
+    const stream = content?.body;
+    const validBody = content?.body instanceof Uint8Array
+        || (stream !== undefined && typeof stream.getReader === 'function');
+    if (!content || !validBody
+        || typeof content.mediaType !== 'string' || !content.mediaType.trim()
+        || (content.bytes !== null
+            && (!Number.isSafeInteger(content.bytes) || Number(content.bytes) < 0))
+        || typeof content.version !== 'string' || !content.version) {
+        throw new Error(`${label} returned invalid content`);
+    }
+    return {
+        body: content.body,
+        mediaType: content.mediaType,
+        bytes: content.bytes === null ? null : Number(content.bytes),
+        version: content.version,
+    };
+}
+//# sourceMappingURL=browse-types.js.map

package/dist/files/browse-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-types.js","sourceRoot":"","sources":["../../src/files/browse-types.ts"],"names":[],"mappings":"AAgEA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAE/B;IACA;IAFX,YACW,MAAc,EACd,IAAY,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,KAAa;IACxD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,KAAK,cAAc,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5E,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,EAAE,2CAA2C,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,iBAAiB,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,KAAa;IAC9D,MAAM,OAAO,GAAG,KAAqC,CAAC;IACtD,MAAM,MAAM,GAAG,OAAO,EAAE,IAA2C,CAAC;IACpE,MAAM,SAAS,GAAG,OAAO,EAAE,IAAI,YAAY,UAAU;WAChD,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC;IACtE,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS;WACrB,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE;WAClE,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI;eACrB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;WACtE,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,2BAA2B,CAAC,CAAC;IACvD,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAiB;QAC/B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QAC5D,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC"}

package/dist/files/browser.d.ts

@@ -0,0 +1,44 @@
+import { type AmalgmDirectoryListing, type FilesContent, type FilesHeadDescriptor, type LocalDirectoryListing } from './browse-types.js';
+import { type CloudFilesPort } from './cloud-files.js';
+import { type LocalFilesPort } from './local-files.js';
+export interface FilesBrowserOptions {
+    readonly userEmail: string;
+    readonly cloud: CloudFilesPort;
+    readonly local: LocalFilesPort;
+}
+export interface AmalgmFileRead {
+    readonly scope: 'amalgm';
+    readonly head: FilesHeadDescriptor;
+    readonly entityId: string;
+    readonly source: 'cloud' | 'local';
+    readonly content: FilesContent;
+}
+export interface LocalFileRead {
+    readonly scope: 'local-only';
+    readonly computerId: string;
+    readonly source: 'local';
+    readonly content: FilesContent;
+}
+export declare class FilesBrowser {
+    readonly root: string;
+    private readonly cloud;
+    private readonly local;
+    constructor(options: FilesBrowserOptions);
+    listAmalgm(input?: {
+        readonly parentId?: string;
+        readonly computerId?: string;
+    }): Promise<AmalgmDirectoryListing>;
+    readAmalgm(input: {
+        readonly entityId: string;
+        readonly computerId?: string;
+    }): Promise<AmalgmFileRead>;
+    listLocal(input: {
+        readonly computerId: string;
+        readonly path?: string;
+    }): Promise<LocalDirectoryListing>;
+    readLocal(input: {
+        readonly computerId: string;
+        readonly path: string;
+    }): Promise<LocalFileRead>;
+}
+//# sourceMappingURL=browser.d.ts.map

package/dist/files/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/files/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAE3B,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEvB,OAAO,EAAE,mBAAmB;IAMlC,UAAU,CAAC,KAAK,GAAE;QACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAkBlC,UAAU,CAAC,KAAK,EAAE;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KAC9B,GAAG,OAAO,CAAC,cAAc,CAAC;IA0B3B,SAAS,CAAC,KAAK,EAAE;QACf,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI5B,SAAS,CAAC,KAAK,EAAE;QACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,aAAa,CAAC;CAQ3B"}

package/dist/files/browser.js

@@ -0,0 +1,100 @@
+import { amalgmUserRoot, } from './browse-types.js';
+import { CloudFiles, assertReadable, } from './cloud-files.js';
+import { LocalFiles } from './local-files.js';
+export class FilesBrowser {
+    root;
+    cloud;
+    local;
+    constructor(options) {
+        this.cloud = new CloudFiles(options.userEmail, options.cloud);
+        this.local = new LocalFiles(options.local);
+        this.root = amalgmUserRoot(options.userEmail);
+    }
+    async listAmalgm(input = {}) {
+        const cloud = await this.cloud.open();
+        const listed = await cloud.list(input.parentId);
+        const records = uniqueEntities([listed.directory, ...listed.entries]);
+        const computerId = optionalText(input.computerId);
+        const local = computerId === null
+            ? new Map()
+            : await this.local.available(computerId, cloud.head, records);
+        return {
+            scope: 'amalgm',
+            root: this.root,
+            head: headDescriptor(cloud.head),
+            computerId,
+            directory: present(listed.directory, local),
+            entries: listed.entries.map((entry) => present(entry, local)),
+        };
+    }
+    async readAmalgm(input) {
+        const cloud = await this.cloud.open();
+        const entity = await cloud.entry(input.entityId);
+        assertReadable(entity);
+        const computerId = optionalText(input.computerId);
+        if (computerId !== null) {
+            const local = await this.local.readIfMaterialized(computerId, cloud.head, entity);
+            if (local !== null) {
+                return {
+                    scope: 'amalgm',
+                    head: headDescriptor(cloud.head),
+                    entityId: entity.uuid,
+                    source: 'local',
+                    content: local,
+                };
+            }
+        }
+        return {
+            scope: 'amalgm',
+            head: headDescriptor(cloud.head),
+            entityId: entity.uuid,
+            source: 'cloud',
+            content: await cloud.read(entity),
+        };
+    }
+    listLocal(input) {
+        return this.local.list(input.computerId, input.path);
+    }
+    async readLocal(input) {
+        return {
+            scope: 'local-only',
+            computerId: input.computerId.trim(),
+            source: 'local',
+            content: await this.local.read(input.computerId, input.path),
+        };
+    }
+}
+function present(node, local) {
+    const localVersion = local.get(node.entity.uuid) ?? null;
+    const isLocal = localVersion !== null;
+    return {
+        entryId: node.entryId,
+        entityId: node.entity.uuid,
+        parentEntityId: node.parentEntityId,
+        referenceId: node.referenceId,
+        name: node.name,
+        type: node.entity.type,
+        status: node.entity.status,
+        version: node.entity.version,
+        availability: {
+            cloud: true,
+            local: isLocal,
+            localVersion,
+            matchesCloud: localVersion === null ? null : localVersion === node.entity.version,
+        },
+        source: isLocal ? 'local' : 'cloud',
+    };
+}
+function uniqueEntities(nodes) {
+    return [...new Map(nodes.map((node) => [node.entity.uuid, node.entity])).values()];
+}
+function headDescriptor(head) {
+    return { checksum: head.checksum, version: head.version };
+}
+function optionalText(value) {
+    if (value === undefined)
+        return null;
+    const text = value.trim();
+    return text || null;
+}
+//# sourceMappingURL=browser.js.map

package/dist/files/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/files/browser.ts"],"names":[],"mappings":"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"}

package/dist/files/cloud-files.d.ts

@@ -0,0 +1,55 @@
+import { type CloudEntityRecord } from '../entities/index.js';
+import { type FilesContent } from './browse-types.js';
+export interface CloudFilesHead {
+    readonly checksum: string;
+    readonly version: number;
+    readonly root: CloudEntityRecord;
+}
+export interface CloudFilesPort {
+    /** Resolve the authority's current head. Every later call receives this
+     * exact immutable descriptor rather than consulting the pointer again. */
+    openActiveHead(): Promise<unknown>;
+    list(input: {
+        readonly head: CloudFilesHead;
+        readonly parentId: string;
+    }): Promise<unknown>;
+    entry(input: {
+        readonly head: CloudFilesHead;
+        readonly entityId: string;
+    }): Promise<unknown>;
+    read(input: {
+        readonly head: CloudFilesHead;
+        readonly entity: CloudEntityRecord;
+    }): Promise<unknown>;
+}
+export interface CloudDirectory {
+    readonly directory: CloudFileNode;
+    readonly entries: readonly CloudFileNode[];
+}
+/** One placement in the logical Amalgm tree. A reference keeps its own entry
+ * id and name while its target supplies entity identity, type, and version. */
+export interface CloudFileNode {
+    readonly entryId: string;
+    readonly entity: CloudEntityRecord;
+    readonly parentEntityId: string | null;
+    readonly name: string;
+    readonly referenceId: string | null;
+}
+export declare class CloudFiles {
+    private readonly port;
+    readonly userEmail: string;
+    constructor(userEmail: string, port: CloudFilesPort);
+    open(): Promise<CloudFilesView>;
+}
+export declare class CloudFilesView {
+    readonly head: CloudFilesHead;
+    private readonly port;
+    constructor(head: CloudFilesHead, port: CloudFilesPort);
+    list(parentId?: string): Promise<CloudDirectory>;
+    entry(value: string): Promise<CloudEntityRecord>;
+    private resolveNode;
+    private referenceNode;
+    read(entry: CloudEntityRecord): Promise<FilesContent>;
+}
+export declare function assertReadable(entry: CloudEntityRecord): void;
+//# sourceMappingURL=cloud-files.d.ts.map

package/dist/files/cloud-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-files.d.ts","sourceRoot":"","sources":["../../src/files/cloud-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B;8EAC0E;IAC1E,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5F,KAAK,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7F,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtG;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C;AAED;+EAC+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,qBAAa,UAAU;IAKnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAGzB,SAAS,EAAE,MAAM,EACA,IAAI,EAAE,cAAc;IAKjC,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC;CAGtC;AAED,qBAAa,cAAc;IAEvB,QAAQ,CAAC,IAAI,EAAE,cAAc;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADZ,IAAI,EAAE,cAAc,EACZ,IAAI,EAAE,cAAc;IAGjC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAmChD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAKxC,WAAW;YAYX,aAAa;IAyBrB,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;CAS5D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAI7D"}