@zhin.js/workroom 0.0.0 → 0.0.1

package/lib/workroom/file-human-ingress-application.js.map

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

package/lib/workroom/file-human-ingress.d.ts

@@ -0,0 +1,24 @@
+import { type HumanIngressProposalEvent, type HumanIngressProposalEventDraft, type HumanIngressProposalRepository } from './human-ingress.js';
+import { type DurableFileHandle, type DurableFileSystem } from './durable-file-store.js';
+export type HumanIngressFileHandle = DurableFileHandle;
+/** Injectable only at the crash-durable filesystem boundary. */
+export interface HumanIngressFileSystem extends DurableFileSystem {
+    readdir(path: string): Promise<readonly string[]>;
+    readFile(path: string, encoding: 'utf8'): Promise<string>;
+}
+/**
+ * Crash-durable, content-free Human Ingress proposal history.
+ *
+ * The leaf directory is created non-recursively: its parent must already be a
+ * durable directory. Each immutable segment is published through a hard link
+ * whose project hash and first sequence form the cross-process CAS pathname.
+ */
+export declare class FileHumanIngressProposalRepository implements HumanIngressProposalRepository {
+    #private;
+    readonly directory: string;
+    readonly fileSystem: HumanIngressFileSystem;
+    constructor(directory: string, fileSystem?: HumanIngressFileSystem);
+    read(projectId: string): Promise<readonly HumanIngressProposalEvent[]>;
+    append(projectId: string, expectedSequence: number, drafts: readonly HumanIngressProposalEventDraft[]): Promise<readonly HumanIngressProposalEvent[]>;
+}
+//# sourceMappingURL=file-human-ingress.d.ts.map

package/lib/workroom/file-human-ingress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-human-ingress.d.ts","sourceRoot":"","sources":["../../src/workroom/file-human-ingress.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACpC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAEvD,gEAAgE;AAChE,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D;AAsBD;;;;;;GAMG;AACH,qBAAa,kCACb,YAAW,8BAA8B;;IAIrC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,UAAU,EAAE,sBAAsB;gBADlC,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,sBAAuC;IAKxD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,yBAAyB,EAAE,CAAC;IAOtE,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,8BAA8B,EAAE,GAChD,OAAO,CAAC,SAAS,yBAAyB,EAAE,CAAC;CAkFjD"}

package/lib/workroom/file-human-ingress.js

@@ -0,0 +1,234 @@
+import { createHash } from 'node:crypto';
+import { readFile as nodeReadFile, readdir as nodeReaddir, } from 'node:fs/promises';
+import { join } from 'node:path';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from './canonical-value.js';
+import { HumanIngressProposalSequenceConflictError, MemoryHumanIngressProposalRepository, } from './human-ingress.js';
+import { DurableFileStore, nodeDurableFileSystem, } from './durable-file-store.js';
+const nodeFileSystem = Object.freeze({
+    ...nodeDurableFileSystem,
+    readdir: async (path) => await nodeReaddir(path),
+    readFile: async (path, encoding) => await nodeReadFile(path, encoding),
+});
+/**
+ * Crash-durable, content-free Human Ingress proposal history.
+ *
+ * The leaf directory is created non-recursively: its parent must already be a
+ * durable directory. Each immutable segment is published through a hard link
+ * whose project hash and first sequence form the cross-process CAS pathname.
+ */
+export class FileHumanIngressProposalRepository {
+    directory;
+    fileSystem;
+    #durable;
+    constructor(directory, fileSystem = nodeFileSystem) {
+        this.directory = directory;
+        this.fileSystem = fileSystem;
+        this.#durable = new DurableFileStore(directory, fileSystem);
+    }
+    async read(projectId) {
+        const id = identifier(projectId, 'projectId');
+        const events = await this.#readEvents(id);
+        if (events.length > 0)
+            await this.#durable.syncLeaf();
+        return events;
+    }
+    async append(projectId, expectedSequence, drafts) {
+        const id = identifier(projectId, 'projectId');
+        sequence(expectedSequence, 'expectedSequence');
+        const snapshots = snapshotDrafts(drafts);
+        const current = await this.#readEvents(id);
+        const events = await materializeAgainst(id, current, expectedSequence, snapshots);
+        const actualSequence = current.at(-1)?.sequence ?? -1;
+        if (events.every(event => event.sequence <= actualSequence)) {
+            if (current.length > 0)
+                await this.#durable.syncLeaf();
+            return events;
+        }
+        const firstSequence = events[0].sequence;
+        const payload = deepFreeze({
+            version: 1,
+            projectId: id,
+            expectedSequence,
+            firstSequence,
+            lastSequence: events.at(-1).sequence,
+            events,
+        });
+        const segment = deepFreeze({
+            ...payload,
+            payloadDigest: digestCanonicalWorkroomValue(payload),
+        });
+        await this.#durable.ensureDurableLeaf('Human ingress proposal repository');
+        const path = this.#segmentPath(id, firstSequence);
+        const published = await this.#durable.publishCreateOnly({
+            target: path,
+            content: JSON.stringify(segment),
+            createdValue: events,
+            onConflict: async () => {
+                const winner = await this.#readEvents(id);
+                const winnerSequence = winner.at(-1)?.sequence ?? -1;
+                if (expectedSequence + snapshots.length > winnerSequence) {
+                    throw new HumanIngressProposalSequenceConflictError(id, expectedSequence, winnerSequence);
+                }
+                return await materializeAgainst(id, winner, expectedSequence, snapshots);
+            },
+        });
+        return published.value;
+    }
+    async #readEvents(projectId) {
+        let names;
+        try {
+            names = await this.fileSystem.readdir(this.directory);
+        }
+        catch (error) {
+            if (isMissingFile(error))
+                return deepFreeze([]);
+            throw error;
+        }
+        const segments = await Promise.all(names
+            .filter(name => name.endsWith('.json'))
+            .map(async (name) => parseSegment(await this.fileSystem.readFile(join(this.directory, name), 'utf8'), name)));
+        const selected = segments
+            .filter(segment => segment.projectId === projectId)
+            .sort((left, right) => left.firstSequence - right.firstSequence);
+        const events = [];
+        let expectedSequence = -1;
+        for (const segment of selected) {
+            if (segment.expectedSequence !== expectedSequence
+                || segment.firstSequence !== expectedSequence + 1) {
+                throw new Error('Human ingress proposal segment sequence gap');
+            }
+            events.push(...segment.events);
+            expectedSequence = segment.lastSequence;
+        }
+        return await validateHistory(projectId, events);
+    }
+    #segmentPath(projectId, firstSequence) {
+        return join(this.directory, segmentName(projectId, firstSequence));
+    }
+}
+function snapshotDrafts(drafts) {
+    if (!Array.isArray(drafts))
+        throw new Error('Human ingress proposal append requires events');
+    const encoded = JSON.stringify(drafts);
+    if (typeof encoded !== 'string')
+        throw new Error('Invalid Human ingress proposal event drafts');
+    return deepFreeze(JSON.parse(encoded));
+}
+async function materializeAgainst(projectId, current, expectedSequence, drafts) {
+    const validator = new MemoryHumanIngressProposalRepository();
+    if (current.length > 0) {
+        await validator.append(projectId, -1, current.map(event => eventDraft(event)));
+    }
+    return await validator.append(projectId, expectedSequence, drafts);
+}
+async function validateHistory(projectId, values) {
+    if (values.length === 0)
+        return deepFreeze([]);
+    const validator = new MemoryHumanIngressProposalRepository();
+    const canonical = await validator.append(projectId, -1, values.map(event => eventDraft(event)));
+    if (canonicalWorkroomJson(canonical) !== canonicalWorkroomJson(values)) {
+        throw new Error('Human ingress proposal event digest or payload is corrupt');
+    }
+    return canonical;
+}
+function eventDraft(event) {
+    return {
+        eventId: event.eventId,
+        type: event.type,
+        proposal: event.proposal,
+    };
+}
+function parseSegment(value, name) {
+    const match = /^([a-f0-9]{64})\.(\d{16})\.json$/u.exec(name);
+    if (!match)
+        throw new Error('Invalid Human ingress proposal segment name');
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error('Invalid Human ingress proposal segment JSON', { cause: error });
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('Invalid Human ingress proposal segment');
+    }
+    assertExactKeys(parsed, [
+        'version', 'projectId', 'expectedSequence', 'firstSequence',
+        'lastSequence', 'events', 'payloadDigest',
+    ], 'segment');
+    const segment = parsed;
+    if (segment.version !== 1
+        || typeof segment.projectId !== 'string'
+        || !Number.isSafeInteger(segment.expectedSequence)
+        || !Number.isSafeInteger(segment.firstSequence)
+        || !Number.isSafeInteger(segment.lastSequence)
+        || !Array.isArray(segment.events)
+        || typeof segment.payloadDigest !== 'string') {
+        throw new Error('Invalid Human ingress proposal segment');
+    }
+    const projectId = identifier(segment.projectId, 'projectId');
+    const expectedSequence = sequence(segment.expectedSequence, 'expectedSequence');
+    const firstSequence = sequence(segment.firstSequence, 'firstSequence', false);
+    const lastSequence = sequence(segment.lastSequence, 'lastSequence', false);
+    if (match[1] !== projectIdHash(projectId) || Number(match[2]) !== firstSequence) {
+        throw new Error('Human ingress proposal segment name binding mismatch');
+    }
+    const events = deepFreeze(structuredClone(segment.events));
+    if (events.length === 0
+        || firstSequence !== expectedSequence + 1
+        || events[0]?.sequence !== firstSequence
+        || events.at(-1)?.sequence !== lastSequence) {
+        throw new Error('Invalid Human ingress proposal segment position');
+    }
+    for (let index = 0; index < events.length; index += 1) {
+        if (events[index]?.sequence !== firstSequence + index) {
+            throw new Error('Invalid Human ingress proposal event position');
+        }
+    }
+    const payload = deepFreeze({
+        version: 1,
+        projectId,
+        expectedSequence,
+        firstSequence,
+        lastSequence,
+        events,
+    });
+    if (segment.payloadDigest !== digestCanonicalWorkroomValue(payload)) {
+        throw new Error('Human ingress proposal segment payload digest mismatch');
+    }
+    return deepFreeze({ ...payload, payloadDigest: segment.payloadDigest });
+}
+function segmentName(projectId, firstSequence) {
+    return `${projectIdHash(projectId)}.${String(firstSequence).padStart(16, '0')}.json`;
+}
+function projectIdHash(projectId) {
+    return createHash('sha256').update(projectId).digest('hex');
+}
+function identifier(value, field) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Human ingress proposal ${field} must be canonical text`);
+    }
+    return value;
+}
+function sequence(value, field, allowNegativeOne = true) {
+    const minimum = allowNegativeOne ? -1 : 0;
+    if (!Number.isSafeInteger(value) || value < minimum) {
+        throw new Error(`Human ingress proposal ${field} must be a valid sequence`);
+    }
+    return value;
+}
+function assertExactKeys(value, keys, field) {
+    const expected = new Set(keys);
+    const unexpected = Object.keys(value).find(key => !expected.has(key));
+    const missing = keys.find(key => !Object.hasOwn(value, key));
+    if (unexpected || missing) {
+        throw new Error(`Invalid Human ingress proposal ${field} schema`);
+    }
+}
+function isMissingFile(error) {
+    return isNodeError(error) && error.code === 'ENOENT';
+}
+function isNodeError(error) {
+    return error instanceof Error && 'code' in error;
+}
+//# sourceMappingURL=file-human-ingress.js.map

package/lib/workroom/file-human-ingress.js.map

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

package/lib/workroom/file-interaction-space-binding-repository.d.ts

@@ -0,0 +1,24 @@
+import type { InteractionSpaceBinding, InteractionSpaceBindingRepository } from './interaction-space-router.js';
+import { type DurableFileHandle, type DurableFileSystem } from './durable-file-store.js';
+export type InteractionSpaceBindingFileHandle = DurableFileHandle;
+/** Injectable only at the durable filesystem boundary. */
+export interface InteractionSpaceBindingFileSystem extends DurableFileSystem {
+    readdir(path: string): Promise<readonly string[]>;
+    readFile(path: string, encoding: 'utf8'): Promise<string>;
+}
+/**
+ * Crash-durable Interaction Space binding history.
+ *
+ * The leaf directory is created non-recursively, so its parent must already be
+ * durable. Immutable segments are published through a hard-link pathname whose
+ * conversation-key hash and first binding revision form the cross-process CAS.
+ */
+export declare class FileInteractionSpaceBindingRepository implements InteractionSpaceBindingRepository {
+    #private;
+    readonly directory: string;
+    readonly fileSystem: InteractionSpaceBindingFileSystem;
+    constructor(directory: string, fileSystem?: InteractionSpaceBindingFileSystem);
+    read(conversationKey: string): Promise<readonly InteractionSpaceBinding[]>;
+    append(conversationKey: string, expectedRevision: number, values: readonly InteractionSpaceBinding[]): Promise<readonly InteractionSpaceBinding[]>;
+}
+//# sourceMappingURL=file-interaction-space-binding-repository.d.ts.map

package/lib/workroom/file-interaction-space-binding-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-interaction-space-binding-repository.d.ts","sourceRoot":"","sources":["../../src/workroom/file-interaction-space-binding-repository.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,uBAAuB,EACvB,iCAAiC,EAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,iCAAiC,GAAG,iBAAiB,CAAC;AAElE,0DAA0D;AAC1D,MAAM,WAAW,iCAAkC,SAAQ,iBAAiB;IAC1E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D;AAsBD;;;;;;GAMG;AACH,qBAAa,qCACb,YAAW,iCAAiC;;IAIxC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,UAAU,EAAE,iCAAiC;gBAD7C,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,iCAAkD;IAKnE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC;IAO1E,MAAM,CACV,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,uBAAuB,EAAE,GACzC,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC;CAmF/C"}

package/lib/workroom/file-interaction-space-binding-repository.js

@@ -0,0 +1,293 @@
+import { createHash } from 'node:crypto';
+import { readFile as nodeReadFile, readdir as nodeReaddir, } from 'node:fs/promises';
+import { join } from 'node:path';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from './canonical-value.js';
+import { DurableFileStore, nodeDurableFileSystem, } from './durable-file-store.js';
+const nodeFileSystem = Object.freeze({
+    ...nodeDurableFileSystem,
+    readdir: async (path) => await nodeReaddir(path),
+    readFile: async (path, encoding) => await nodeReadFile(path, encoding),
+});
+/**
+ * Crash-durable Interaction Space binding history.
+ *
+ * The leaf directory is created non-recursively, so its parent must already be
+ * durable. Immutable segments are published through a hard-link pathname whose
+ * conversation-key hash and first binding revision form the cross-process CAS.
+ */
+export class FileInteractionSpaceBindingRepository {
+    directory;
+    fileSystem;
+    #durable;
+    constructor(directory, fileSystem = nodeFileSystem) {
+        this.directory = directory;
+        this.fileSystem = fileSystem;
+        this.#durable = new DurableFileStore(directory, fileSystem);
+    }
+    async read(conversationKey) {
+        const key = identifier(conversationKey, 'conversationKey');
+        const bindings = await this.#readBindings(key);
+        if (bindings.length > 0)
+            await this.#durable.syncLeaf();
+        return bindings;
+    }
+    async append(conversationKey, expectedRevision, values) {
+        const key = identifier(conversationKey, 'conversationKey');
+        revision(expectedRevision, 'expectedRevision', true);
+        const bindings = snapshotBindings(values, key);
+        if (bindings.length === 0) {
+            throw new Error('Interaction Space binding append requires facts');
+        }
+        const current = await this.#readBindings(key);
+        const replay = exactReplay(current, expectedRevision, bindings);
+        if (replay) {
+            if (current.length > 0)
+                await this.#durable.syncLeaf();
+            return replay;
+        }
+        if (current.length !== expectedRevision) {
+            throw revisionConflict(key, expectedRevision, current.length);
+        }
+        validateHistory(key, Object.freeze([...current, ...bindings]));
+        const firstBindingRevision = bindings[0].bindingRevision;
+        const payload = deepFreeze({
+            version: 1,
+            conversationKey: key,
+            expectedRevision,
+            firstBindingRevision,
+            lastBindingRevision: bindings.at(-1).bindingRevision,
+            bindings,
+        });
+        const segment = deepFreeze({
+            ...payload,
+            payloadDigest: digestCanonicalWorkroomValue(payload),
+        });
+        await this.#durable.ensureDurableLeaf('Interaction Space binding repository');
+        const path = this.#segmentPath(key, firstBindingRevision);
+        const published = await this.#durable.publishCreateOnly({
+            target: path,
+            content: JSON.stringify(segment),
+            createdValue: bindings,
+            onConflict: async () => {
+                const winner = await this.#readBindings(key);
+                const exact = exactReplay(winner, expectedRevision, bindings);
+                if (exact)
+                    return exact;
+                throw revisionConflict(key, expectedRevision, winner.length);
+            },
+        });
+        return published.value;
+    }
+    async #readBindings(conversationKey) {
+        let names;
+        try {
+            names = await this.fileSystem.readdir(this.directory);
+        }
+        catch (error) {
+            if (isMissingFile(error))
+                return Object.freeze([]);
+            throw error;
+        }
+        const segmentNames = names.filter(name => name.endsWith('.json')).sort();
+        const segments = await Promise.all(segmentNames.map(async (name) => parseSegment(await this.fileSystem.readFile(join(this.directory, name), 'utf8'), name)));
+        const selected = segments
+            .filter(segment => segment.conversationKey === conversationKey)
+            .sort((left, right) => left.firstBindingRevision - right.firstBindingRevision);
+        const bindings = [];
+        let expectedRevision = 0;
+        for (const segment of selected) {
+            if (segment.expectedRevision !== expectedRevision
+                || segment.firstBindingRevision !== expectedRevision + 1) {
+                throw new Error('Interaction Space binding segment revision gap');
+            }
+            bindings.push(...segment.bindings);
+            expectedRevision = segment.lastBindingRevision;
+        }
+        const frozen = deepFreeze(bindings);
+        validateHistory(conversationKey, frozen);
+        return frozen;
+    }
+    #segmentPath(conversationKey, firstRevision) {
+        return join(this.directory, segmentName(conversationKey, firstRevision));
+    }
+}
+function snapshotBindings(values, conversationKey) {
+    if (!Array.isArray(values))
+        throw new Error('Invalid Interaction Space binding facts');
+    return deepFreeze(values.map(value => {
+        const encoded = JSON.stringify(value);
+        if (typeof encoded !== 'string')
+            throw new Error('Invalid Interaction Space binding fact');
+        return parseBinding(JSON.parse(encoded), conversationKey);
+    }));
+}
+function exactReplay(current, expectedRevision, bindings) {
+    if (expectedRevision + bindings.length > current.length)
+        return undefined;
+    const persisted = current.slice(expectedRevision, expectedRevision + bindings.length);
+    if (canonicalWorkroomJson(persisted) === canonicalWorkroomJson(bindings)) {
+        return deepFreeze(persisted);
+    }
+    if (persisted.length > 0) {
+        throw new Error(`Interaction Space binding replay payload drift at revision ${expectedRevision}`);
+    }
+    return undefined;
+}
+function parseSegment(value, name) {
+    const match = /^([a-f0-9]{64})\.(\d{16})\.json$/u.exec(name);
+    if (!match)
+        throw new Error('Invalid Interaction Space binding segment name');
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error('Invalid Interaction Space binding segment JSON', { cause: error });
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('Invalid Interaction Space binding segment');
+    }
+    assertExactKeys(parsed, [
+        'version', 'conversationKey', 'expectedRevision', 'firstBindingRevision',
+        'lastBindingRevision', 'bindings', 'payloadDigest',
+    ], 'segment');
+    const segment = parsed;
+    if (segment.version !== 1
+        || typeof segment.conversationKey !== 'string'
+        || !Number.isSafeInteger(segment.expectedRevision)
+        || !Number.isSafeInteger(segment.firstBindingRevision)
+        || !Number.isSafeInteger(segment.lastBindingRevision)
+        || !Array.isArray(segment.bindings)
+        || typeof segment.payloadDigest !== 'string') {
+        throw new Error('Invalid Interaction Space binding segment');
+    }
+    const conversationKey = identifier(segment.conversationKey, 'conversationKey');
+    const expectedRevision = revision(segment.expectedRevision, 'expectedRevision', true);
+    const firstBindingRevision = revision(segment.firstBindingRevision, 'firstBindingRevision');
+    const lastBindingRevision = revision(segment.lastBindingRevision, 'lastBindingRevision');
+    if (match[1] !== conversationKeyHash(conversationKey)
+        || Number(match[2]) !== firstBindingRevision) {
+        throw new Error('Interaction Space binding segment name binding mismatch');
+    }
+    const bindings = deepFreeze(segment.bindings.map(binding => parseBinding(binding, conversationKey)));
+    if (bindings.length === 0
+        || firstBindingRevision !== expectedRevision + 1
+        || bindings[0].bindingRevision !== firstBindingRevision
+        || bindings.at(-1).bindingRevision !== lastBindingRevision) {
+        throw new Error('Invalid Interaction Space binding segment position');
+    }
+    for (let index = 0; index < bindings.length; index += 1) {
+        if (bindings[index].bindingRevision !== firstBindingRevision + index) {
+            throw new Error('Invalid Interaction Space binding position');
+        }
+    }
+    const payload = deepFreeze({
+        version: 1,
+        conversationKey,
+        expectedRevision,
+        firstBindingRevision,
+        lastBindingRevision,
+        bindings,
+    });
+    if (segment.payloadDigest !== digestCanonicalWorkroomValue(payload)) {
+        throw new Error('Interaction Space binding segment payload digest mismatch');
+    }
+    validateHistory(conversationKey, bindings, firstBindingRevision - 1);
+    return deepFreeze({ ...payload, payloadDigest: segment.payloadDigest });
+}
+function parseBinding(value, conversationKey) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Invalid Interaction Space binding');
+    }
+    assertExactKeys(value, [
+        'version', 'conversationKey', 'bindingRevision', 'effectiveAfterConversationSequence',
+        'space', 'projectId', 'sourceRef', 'sourceDigest', 'digest',
+    ], 'binding');
+    const binding = value;
+    if (binding.version !== 1 || binding.conversationKey !== conversationKey) {
+        throw new Error('Interaction Space binding conversation mismatch');
+    }
+    const bindingRevision = revision(binding.bindingRevision, 'bindingRevision');
+    const effectiveAfterConversationSequence = revision(binding.effectiveAfterConversationSequence, 'effectiveAfterConversationSequence', true);
+    if (binding.space !== 'chat' && binding.space !== 'workroom' && binding.space !== 'sponsor_room') {
+        throw new Error('Invalid Interaction Space binding space');
+    }
+    const projectId = binding.projectId === undefined
+        ? undefined
+        : identifier(binding.projectId, 'projectId');
+    if (binding.space === 'chat' && projectId !== undefined) {
+        throw new Error('Interaction Space chat binding cannot carry projectId');
+    }
+    if (binding.space !== 'chat' && projectId === undefined) {
+        throw new Error(`Interaction Space ${binding.space} binding requires projectId`);
+    }
+    const sourceRef = identifier(binding.sourceRef, 'sourceRef');
+    const sourceDigest = sha256(binding.sourceDigest, 'sourceDigest');
+    const projection = deepFreeze({
+        version: 1,
+        conversationKey,
+        bindingRevision,
+        effectiveAfterConversationSequence,
+        space: binding.space,
+        ...(projectId === undefined ? {} : { projectId }),
+        sourceRef,
+        sourceDigest,
+    });
+    if (binding.digest !== digestCanonicalWorkroomValue(projection)) {
+        throw new Error('Interaction Space binding digest mismatch');
+    }
+    return deepFreeze({ ...projection, digest: binding.digest });
+}
+function validateHistory(conversationKey, bindings, revisionOffset = 0) {
+    let previous;
+    bindings.forEach((value, index) => {
+        const binding = parseBinding(value, conversationKey);
+        if (binding.bindingRevision !== revisionOffset + index + 1) {
+            throw new Error('Interaction Space binding revisions must be contiguous');
+        }
+        if (previous
+            && binding.effectiveAfterConversationSequence
+                < previous.effectiveAfterConversationSequence) {
+            throw new Error('Interaction Space binding anchor must not move backwards');
+        }
+        previous = binding;
+    });
+}
+function segmentName(conversationKey, firstRevision) {
+    return `${conversationKeyHash(conversationKey)}.${String(firstRevision).padStart(16, '0')}.json`;
+}
+function conversationKeyHash(conversationKey) {
+    return createHash('sha256').update(conversationKey).digest('hex');
+}
+function identifier(value, field) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Invalid Interaction Space binding ${field}`);
+    }
+    return value;
+}
+function revision(value, field, allowZero = false) {
+    if (!Number.isSafeInteger(value) || value < (allowZero ? 0 : 1)) {
+        throw new Error(`Invalid Interaction Space binding ${field}`);
+    }
+    return value;
+}
+function sha256(value, field) {
+    if (typeof value !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(value)) {
+        throw new Error(`Invalid Interaction Space binding ${field}`);
+    }
+    return value;
+}
+function assertExactKeys(value, allowed, label) {
+    const allow = new Set(allowed);
+    const unexpected = Object.keys(value).find(key => !allow.has(key));
+    if (unexpected)
+        throw new Error(`Invalid Interaction Space binding ${label} field: ${unexpected}`);
+}
+function revisionConflict(conversationKey, expected, actual) {
+    return new Error(`Interaction Space binding ${conversationKey} revision conflict: expected ${expected}, actual ${actual}`);
+}
+function isMissingFile(error) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === 'ENOENT');
+}
+//# sourceMappingURL=file-interaction-space-binding-repository.js.map

package/lib/workroom/file-interaction-space-binding-repository.js.map

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