@zhin.js/agent 1.1.13 → 1.1.14

package/lib/workroom/file-effect-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-effect-ledger.d.ts","sourceRoot":"","sources":["../../src/workroom/file-effect-ledger.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAC;AAgB5B,wFAAwF;AACxF,qBAAa,yBAA0B,YAAW,qBAAqB;;IAGzD,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;IAIhC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAqBhE,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,wBAAwB,EAAE,GAC1C,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;CA6C3C"}

package/lib/workroom/file-effect-ledger.js

@@ -0,0 +1,118 @@
+import { createHash } from 'node:crypto';
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { WorkroomEffectSequenceConflictError, assertWorkroomEffectEvent, createWorkroomEffectEvent, replayWorkroomEffectLedger, } from './effect-ledger.js';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from './canonical-value.js';
+import { DurableFileStore } from './durable-file-store.js';
+/** Crash-durable append-only Effect Ledger; one create-only slot owns each sequence. */
+export class FileWorkroomEffectJournal {
+    directory;
+    #store;
+    constructor(directory) {
+        this.directory = directory;
+        this.#store = new DurableFileStore(directory);
+    }
+    async read(projectId) {
+        const id = required(projectId, 'projectId');
+        const prefix = segmentPrefix(id);
+        let names;
+        try {
+            names = await readdir(this.directory);
+        }
+        catch (error) {
+            if (hasCode(error, 'ENOENT'))
+                return Object.freeze([]);
+            throw error;
+        }
+        const candidates = names.filter(name => name.startsWith(prefix)).sort();
+        if (candidates.some(name => !segmentPattern(prefix).test(name))) {
+            throw new Error('Invalid Workroom Effect Journal segment name');
+        }
+        const events = await Promise.all(candidates.map(async (name, index) => parseSegment(await readFile(join(this.directory, name), 'utf8'), id, index).event));
+        replayWorkroomEffectLedger(id, events);
+        if (events.length > 0)
+            await this.#store.syncLeaf();
+        return deepFreeze(events);
+    }
+    async append(projectId, expectedSequence, drafts) {
+        const id = required(projectId, 'projectId');
+        if (!Number.isSafeInteger(expectedSequence) || expectedSequence < -1) {
+            throw new Error('Workroom Effect expectedSequence is invalid');
+        }
+        if (!Array.isArray(drafts) || drafts.length === 0) {
+            throw new Error('Workroom Effect append requires events');
+        }
+        if (drafts.length !== 1) {
+            throw new Error('File Workroom Effect Journal requires one atomic event per append');
+        }
+        const current = await this.read(id);
+        const actual = current.length - 1;
+        if (actual !== expectedSequence)
+            throw new WorkroomEffectSequenceConflictError(expectedSequence, actual);
+        const appended = drafts.map((draft, index) => createWorkroomEffectEvent(id, expectedSequence + index + 1, draft));
+        replayWorkroomEffectLedger(id, Object.freeze([...current, ...appended]));
+        await this.#store.ensureDurableLeaf('Workroom Effect Journal');
+        for (const event of appended) {
+            const body = deepFreeze({
+                version: 1,
+                projectId: id,
+                expectedSequence: event.sequence - 1,
+                event,
+            });
+            const segment = deepFreeze({ ...body, payloadDigest: digest(body) });
+            const target = join(this.directory, segmentName(id, event.sequence));
+            await this.#store.publishCreateOnly({
+                target,
+                content: canonicalWorkroomJson(segment),
+                createdValue: segment,
+                onConflict: async () => {
+                    const existing = parseSegment(await readFile(target, 'utf8'), id, event.sequence);
+                    if (canonicalWorkroomJson(existing) !== canonicalWorkroomJson(segment)) {
+                        throw new WorkroomEffectSequenceConflictError(event.sequence - 1, event.sequence);
+                    }
+                    return existing;
+                },
+            });
+        }
+        return deepFreeze(appended);
+    }
+}
+function parseSegment(serialized, projectId, sequence) {
+    const value = JSON.parse(serialized);
+    if (value.version !== 1 || value.projectId !== projectId
+        || value.expectedSequence !== sequence - 1 || value.event?.sequence !== sequence) {
+        throw new Error('Invalid Workroom Effect Journal segment binding');
+    }
+    assertWorkroomEffectEvent(value.event, projectId, sequence);
+    const body = deepFreeze({
+        version: 1,
+        projectId,
+        expectedSequence: sequence - 1,
+        event: value.event,
+    });
+    const canonical = deepFreeze({ ...body, payloadDigest: digest(body) });
+    if (value.payloadDigest !== canonical.payloadDigest
+        || canonicalWorkroomJson(value) !== canonicalWorkroomJson(canonical)) {
+        throw new Error('Invalid Workroom Effect Journal segment digest');
+    }
+    return canonical;
+}
+function segmentPrefix(projectId) {
+    return `effect-${createHash('sha256').update(projectId).digest('hex')}-`;
+}
+function segmentName(projectId, sequence) {
+    return `${segmentPrefix(projectId)}${String(sequence).padStart(16, '0')}.json`;
+}
+function segmentPattern(prefix) {
+    return new RegExp(`^${prefix}[0-9]{16}\\.json$`, 'u');
+}
+function required(value, label) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim())
+        throw new Error(`${label} is invalid`);
+    return value;
+}
+function hasCode(error, code) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === code);
+}
+//# sourceMappingURL=file-effect-ledger.js.map

package/lib/workroom/file-effect-ledger.js.map

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

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

@@ -0,0 +1,10 @@
+import { type HumanIngressApplicationEvent, type HumanIngressApplicationEventDraft, type HumanIngressApplicationRepository } from './human-ingress-application.js';
+/** Crash-durable lifecycle journal for the Orchestrator Inbox consumer. */
+export declare class FileHumanIngressApplicationRepository implements HumanIngressApplicationRepository {
+    #private;
+    readonly directory: string;
+    constructor(directory: string);
+    read(projectId: string): Promise<readonly HumanIngressApplicationEvent[]>;
+    append(projectId: string, expectedSequence: number, drafts: readonly HumanIngressApplicationEventDraft[]): Promise<readonly HumanIngressApplicationEvent[]>;
+}
+//# sourceMappingURL=file-human-ingress-application.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-human-ingress-application.d.ts","sourceRoot":"","sources":["../../src/workroom/file-human-ingress-application.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EACvC,MAAM,gCAAgC,CAAC;AAgBxC,2EAA2E;AAC3E,qBAAa,qCACb,YAAW,iCAAiC;;IAG9B,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;IAIhC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,4BAA4B,EAAE,CAAC;IAOzE,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,iCAAiC,EAAE,GACnD,OAAO,CAAC,SAAS,4BAA4B,EAAE,CAAC;CAiEpD"}

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

@@ -0,0 +1,177 @@
+import { createHash } from 'node:crypto';
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from './canonical-value.js';
+import { HumanIngressApplicationSequenceConflictError, MemoryHumanIngressApplicationRepository, } from './human-ingress-application.js';
+import { DurableFileStore } from './durable-file-store.js';
+/** Crash-durable lifecycle journal for the Orchestrator Inbox consumer. */
+export class FileHumanIngressApplicationRepository {
+    directory;
+    #durable;
+    constructor(directory) {
+        this.directory = directory;
+        this.#durable = new DurableFileStore(directory);
+    }
+    async read(projectId) {
+        const id = text(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 = text(projectId, 'projectId');
+        const snapshots = deepFreeze(structuredClone(drafts));
+        const current = await this.#readEvents(id);
+        const events = await materialize(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 application repository');
+        const published = await this.#durable.publishCreateOnly({
+            target: join(this.directory, segmentName(id, firstSequence)),
+            content: JSON.stringify(segment),
+            createdValue: events,
+            onConflict: async () => {
+                const winner = await this.#readEvents(id);
+                const actual = winner.at(-1)?.sequence ?? -1;
+                if (expectedSequence + snapshots.length > actual) {
+                    throw new HumanIngressApplicationSequenceConflictError(id, expectedSequence, actual);
+                }
+                return await materialize(id, winner, expectedSequence, snapshots);
+            },
+        });
+        return published.value;
+    }
+    async #readEvents(projectId) {
+        let names;
+        try {
+            names = await readdir(this.directory);
+        }
+        catch (error) {
+            if (hasCode(error, 'ENOENT'))
+                return deepFreeze([]);
+            throw error;
+        }
+        const segments = (await Promise.all(names
+            .filter(name => name.endsWith('.json'))
+            .map(async (name) => parseSegment(name, await readFile(join(this.directory, name), 'utf8')))))
+            .filter(segment => segment.projectId === projectId)
+            .sort((left, right) => left.firstSequence - right.firstSequence);
+        const events = [];
+        let expectedSequence = -1;
+        for (const segment of segments) {
+            if (segment.expectedSequence !== expectedSequence
+                || segment.firstSequence !== expectedSequence + 1) {
+                throw new Error('Human ingress application segment sequence gap');
+            }
+            events.push(...segment.events);
+            expectedSequence = segment.lastSequence;
+        }
+        return await validateHistory(projectId, events);
+    }
+}
+async function materialize(projectId, current, expectedSequence, drafts) {
+    const repository = new MemoryHumanIngressApplicationRepository();
+    if (current.length > 0)
+        await repository.append(projectId, -1, current.map(toDraft));
+    return await repository.append(projectId, expectedSequence, drafts);
+}
+async function validateHistory(projectId, events) {
+    if (events.length === 0)
+        return deepFreeze([]);
+    const repository = new MemoryHumanIngressApplicationRepository();
+    const canonical = await repository.append(projectId, -1, events.map(toDraft));
+    if (canonicalWorkroomJson(canonical) !== canonicalWorkroomJson(events)) {
+        throw new Error('Human ingress application event digest or payload is corrupt');
+    }
+    return canonical;
+}
+function toDraft(event) {
+    const { version: _version, projectId: _projectId, sequence: _sequence, digest: _digest, ...draft } = event;
+    return draft;
+}
+function parseSegment(name, encoded) {
+    const match = /^([a-f0-9]{64})\.(\d{16})\.json$/u.exec(name);
+    if (!match)
+        throw new Error('Invalid Human ingress application segment name');
+    let value;
+    try {
+        value = JSON.parse(encoded);
+    }
+    catch (error) {
+        throw new Error('Invalid Human ingress application segment JSON', { cause: error });
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Invalid Human ingress application segment');
+    }
+    const segment = value;
+    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 application segment');
+    }
+    const projectId = text(segment.projectId, 'projectId');
+    const expectedSequence = segment.expectedSequence;
+    const firstSequence = segment.firstSequence;
+    const lastSequence = segment.lastSequence;
+    if (match[1] !== projectHash(projectId) || Number(match[2]) !== firstSequence) {
+        throw new Error('Human ingress application 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 application segment position');
+    }
+    const payload = deepFreeze({
+        version: 1,
+        projectId,
+        expectedSequence,
+        firstSequence,
+        lastSequence,
+        events,
+    });
+    if (segment.payloadDigest !== digestCanonicalWorkroomValue(payload)) {
+        throw new Error('Human ingress application segment payload digest mismatch');
+    }
+    return deepFreeze({ ...payload, payloadDigest: segment.payloadDigest });
+}
+function segmentName(projectId, firstSequence) {
+    return `${projectHash(projectId)}.${String(firstSequence).padStart(16, '0')}.json`;
+}
+function projectHash(projectId) {
+    return createHash('sha256').update(projectId).digest('hex');
+}
+function text(value, field) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Human ingress application ${field} must be canonical text`);
+    }
+    return value;
+}
+function hasCode(error, code) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === code);
+}
+//# sourceMappingURL=file-human-ingress-application.js.map

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