@tangle-network/braid 0.1.0

package/dist/adapters/storage/sqlite-state-snapshots.js

@@ -0,0 +1,53 @@
+import { SqliteStateSnapshotLifecycle } from './sqlite-state-snapshot-lifecycle.js';
+import { SqliteStateSnapshotReader } from './sqlite-state-snapshot-read.js';
+import { SqliteStateSnapshotWriter } from './sqlite-state-snapshot-write.js';
+export class SqliteStateSnapshotStore {
+    #lifecycle;
+    #reader;
+    #writer;
+    constructor(runtime) {
+        this.#lifecycle = new SqliteStateSnapshotLifecycle(runtime);
+        this.#reader = new SqliteStateSnapshotReader(runtime);
+        this.#writer = new SqliteStateSnapshotWriter(runtime);
+    }
+    async latest() {
+        return this.#reader.latest();
+    }
+    async prepare(snapshot, createdRefs) {
+        return this.#writer.prepare(snapshot, createdRefs);
+    }
+    writeUnsafe(snapshot, storageId, prepared) {
+        this.#writer.writeUnsafe(snapshot, storageId, prepared);
+    }
+    async write(snapshot) {
+        return this.#writer.write(snapshot, () => this.#lifecycle.pruneAfterCommitUnsafe());
+    }
+    async prune() {
+        return this.#lifecycle.prune();
+    }
+    async pruneAfterCommitUnsafe() {
+        return this.#lifecycle.pruneAfterCommitUnsafe();
+    }
+    async discardCredentials(refs) {
+        return this.#lifecycle.discardCredentials(refs);
+    }
+    async pruneUnsafe() {
+        return this.#lifecycle.pruneUnsafe();
+    }
+    async destroyKeysBeforeMutation() {
+        return this.#lifecycle.destroyKeysBeforeMutation();
+    }
+    invalidateUnsafe() {
+        this.#lifecycle.invalidateUnsafe();
+    }
+    async finishInvalidationUnsafe() {
+        return this.#lifecycle.finishInvalidationUnsafe();
+    }
+    async reconcile() {
+        return this.#lifecycle.reconcile();
+    }
+    async reconcileUnsafe() {
+        return this.#lifecycle.reconcileUnsafe();
+    }
+}
+//# sourceMappingURL=sqlite-state-snapshots.js.map

package/dist/adapters/storage/sqlite-state-snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-state-snapshots.js","sourceRoot":"","sources":["../../../src/adapters/storage/sqlite-state-snapshots.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAA;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAA;AAE3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AAE5E,MAAM,OAAO,wBAAwB;IAC1B,UAAU,CAA8B;IACxC,OAAO,CAA2B;IAClC,OAAO,CAA2B;IAE3C,YAAY,OAAwB;QAClC,IAAI,CAAC,UAAU,GAAG,IAAI,4BAA4B,CAAC,OAAO,CAAC,CAAA;QAC3D,IAAI,CAAC,OAAO,GAAG,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAA;QACrD,IAAI,CAAC,OAAO,GAAG,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CACX,QAAuB,EACvB,WAA4B;QAE5B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IACpD,CAAC;IAED,WAAW,CAAC,QAAuB,EAAE,SAAiB,EAAE,QAA+B;QACrF,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAuB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAA;IACrF,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,sBAAsB;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAA;IACjD,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,IAA8B;QACrD,OAAO,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACjD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,yBAAyB;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,yBAAyB,EAAE,CAAA;IACpD,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,wBAAwB;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAA;IACnD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAA;IAC1C,CAAC;CACF"}

package/dist/adapters/storage/sqlite-types.d.ts

@@ -0,0 +1,97 @@
+import type { CredentialPort, CredentialRef } from '../../ports/credentials.js';
+import type { HeadlessKeySource } from '../credentials/headless-key.js';
+import type { SqliteDatabase, SqliteDatabaseFactory } from './sqlite-driver.js';
+export declare const DEFAULT_BUSY_TIMEOUT_MS = 5000;
+export declare const DEFAULT_MAX_EVENTS = 256;
+export declare const DEFAULT_MAX_PAYLOAD_BYTES: number;
+export declare const DEFAULT_MAX_QUEUED_TRANSACTIONS = 64;
+export declare const RESTORE_MANIFEST_VERSION = 1;
+export interface MigrationHooks {
+    readonly beforeVersionCommit?: (version: number) => void;
+}
+export type DurableBoundaryHook = (boundary: string) => void;
+export interface SqliteStartupStage {
+    readonly name: 'path-lock' | 'path-validation' | 'lock-acquire' | 'recovery-check' | 'initialization-marker' | 'credential' | 'cipher-open' | 'schema' | 'content-keys' | 'snapshot-maintenance' | 'projection' | 'configuration' | 'artifact-permissions';
+    readonly durationMs: number;
+}
+export interface SqliteStorageOptions {
+    readonly path: string;
+    readonly workspaceRoot?: string;
+    readonly credentialStore: CredentialPort;
+    readonly databaseKeyRef?: CredentialRef;
+    readonly databaseKeySource?: HeadlessKeySource;
+    readonly busyTimeoutMs?: number;
+    readonly maxEventsPerTransaction?: number;
+    readonly maxPayloadBytesPerTransaction?: number;
+    readonly maxQueuedTransactions?: number;
+    readonly backupDirectory?: string;
+    readonly migrationHooks?: MigrationHooks;
+    readonly durableBoundaryHook?: DurableBoundaryHook;
+    readonly startupObserver?: (stage: SqliteStartupStage) => void;
+    /** Test/packaging seam. It must still expose key/rekey and is never a plaintext fallback. */
+    readonly databaseFactory?: SqliteDatabaseFactory;
+}
+export interface SqliteStorageInput {
+    readonly path: string;
+    readonly workspaceRoot?: string;
+    readonly credentials: CredentialPort;
+    readonly databaseKeyRef: CredentialRef;
+    readonly databaseKey: Buffer;
+    readonly databaseFactory: SqliteDatabaseFactory;
+    readonly busyTimeoutMs: number;
+    readonly maxEvents: number;
+    readonly maxPayloadBytes: number;
+    readonly maxQueuedTransactions: number;
+    readonly backupDirectory: string;
+    readonly migrationHooks?: MigrationHooks;
+    readonly durableBoundaryHook?: DurableBoundaryHook;
+    readonly startupObserver?: (stage: SqliteStartupStage) => void;
+    readonly database: SqliteDatabase;
+    readonly databaseFileDescriptor?: number;
+    readonly exclusiveLock?: {
+        readonly release: () => Promise<void>;
+    };
+}
+export interface SqliteEventRow extends Record<string, unknown> {
+    readonly storage_id: number | bigint;
+    readonly workspace_id: string;
+    readonly conversation_id: string;
+    readonly run_id: string;
+    readonly event_id: string;
+    readonly provider_event_id: string | null;
+    readonly run_sequence: number;
+    readonly kind: string;
+    readonly cursor: string | null;
+    readonly operation_id: string | null;
+    readonly payload: Buffer;
+    readonly payload_checksum: string;
+    readonly occurred_at: string;
+    readonly received_at: string;
+    readonly terminal: number;
+    readonly redacted: number;
+}
+export interface CursorRow extends Record<string, unknown> {
+    readonly run_id: string;
+    readonly conversation_id: string;
+    readonly last_sequence: number;
+    readonly last_cursor: string | null;
+    readonly missing_from: number | null;
+    readonly missing_to: number | null;
+    readonly terminal: number;
+}
+export interface OperationRow extends Record<string, unknown> {
+    readonly operation_id: string;
+    readonly operation_kind: string;
+    readonly request_digest: string;
+    readonly request_json: string;
+    readonly status: 'pending' | 'acknowledged' | 'failed' | 'unknown' | 'conflict' | 'terminal';
+    readonly result_json: string | null;
+    readonly created_at: string;
+    readonly updated_at: string;
+}
+export interface QueueTask<T> {
+    readonly operation: () => Promise<T>;
+    readonly resolve: (value: T | PromiseLike<T>) => void;
+    readonly reject: (reason?: unknown) => void;
+}
+//# sourceMappingURL=sqlite-types.d.ts.map

package/dist/adapters/storage/sqlite-types.d.ts.map

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

package/dist/adapters/storage/sqlite-types.js

@@ -0,0 +1,6 @@
+export const DEFAULT_BUSY_TIMEOUT_MS = 5_000;
+export const DEFAULT_MAX_EVENTS = 256;
+export const DEFAULT_MAX_PAYLOAD_BYTES = 4 * 1024 * 1024;
+export const DEFAULT_MAX_QUEUED_TRANSACTIONS = 64;
+export const RESTORE_MANIFEST_VERSION = 1;
+//# sourceMappingURL=sqlite-types.js.map

package/dist/adapters/storage/sqlite-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-types.js","sourceRoot":"","sources":["../../../src/adapters/storage/sqlite-types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAA;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;AACrC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;AACxD,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAA;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAA"}

package/dist/adapters/storage/sqlite.d.ts

@@ -0,0 +1,11 @@
+import type { EffectStoragePort } from '../../ports/effect-storage.js';
+import type { StoragePort } from '../../ports/storage.js';
+import { SqliteRedactionStorage } from './sqlite-redaction.js';
+import { type SqliteStorageInput, type SqliteStorageOptions } from './sqlite-types.js';
+export type { DurableBoundaryHook, SqliteStartupStage, SqliteStorageOptions, } from './sqlite-types.js';
+export declare class SqliteStorage extends SqliteRedactionStorage implements StoragePort, EffectStoragePort {
+    protected constructor(input: SqliteStorageInput);
+    static open(options: SqliteStorageOptions): Promise<SqliteStorage>;
+}
+export declare function openSqliteStorage(options: SqliteStorageOptions): Promise<SqliteStorage>;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/adapters/storage/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/sqlite.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAmBzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAG9D,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAE1B,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,qBAAa,aACX,SAAQ,sBACR,YAAW,WAAW,EAAE,iBAAiB;IAEzC,SAAS,aAAa,KAAK,EAAE,kBAAkB,EAE9C;IAED,OAAa,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CA+IvE;CACF;AAyCD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAEvF"}

package/dist/adapters/storage/sqlite.js

@@ -0,0 +1,198 @@
+import { randomBytes } from 'node:crypto';
+import { dirname } from 'node:path';
+import { performance } from 'node:perf_hooks';
+import { readHeadlessKey } from '../credentials/headless-key.js';
+import { closeBoundSqliteDatabase, openBoundSqliteDatabase } from './sqlite-bound-open.js';
+import { configureCipherDatabase, loadCipherDatabaseFactory } from './sqlite-driver.js';
+import { StorageError } from './sqlite-errors.js';
+import { claimInitializationMarker, inspectInitializationMarker, markInitializationInterrupted, releaseInitializationMarker, removeDatabaseArtifacts, } from './sqlite-initialization.js';
+import { assertApprovedPath, classifySqliteError, ensureDirectory, validatePath, } from './sqlite-paths.js';
+import { acquireExclusiveLock, recoverRestoreManifest } from './sqlite-recovery.js';
+import { SqliteRedactionStorage } from './sqlite-redaction.js';
+import { credentialErrorCode, deterministicCredentialRef } from './sqlite-rows.js';
+import { applyConnectionPragmas } from './sqlite-schema.js';
+import { DEFAULT_BUSY_TIMEOUT_MS, DEFAULT_MAX_EVENTS, DEFAULT_MAX_PAYLOAD_BYTES, DEFAULT_MAX_QUEUED_TRANSACTIONS, } from './sqlite-types.js';
+export class SqliteStorage extends SqliteRedactionStorage {
+    constructor(input) {
+        super(input);
+    }
+    static async open(options) {
+        const pathLockStarted = performance.now();
+        let stageStarted = pathLockStarted;
+        const path = validatePath(options.path, 'SQLite path');
+        const approvedRoot = validatePath(options.workspaceRoot ?? dirname(path), 'Approved root');
+        const unsafeOptions = options;
+        for (const forbidden of ['databaseKey', 'key', 'encryptionKey', 'env', 'environmentVariable']) {
+            if (forbidden in unsafeOptions) {
+                throw new StorageError('HEADLESS_KEY_SOURCE_REQUIRED', 'Raw and environment key inputs are rejected');
+            }
+        }
+        const busyTimeoutMs = options.busyTimeoutMs ?? DEFAULT_BUSY_TIMEOUT_MS;
+        const maxEvents = options.maxEventsPerTransaction ?? DEFAULT_MAX_EVENTS;
+        const maxPayloadBytes = options.maxPayloadBytesPerTransaction ?? DEFAULT_MAX_PAYLOAD_BYTES;
+        const maxQueuedTransactions = options.maxQueuedTransactions ?? DEFAULT_MAX_QUEUED_TRANSACTIONS;
+        if (!Number.isInteger(busyTimeoutMs) || busyTimeoutMs < 1 || busyTimeoutMs > 60_000) {
+            throw new StorageError('STORAGE_OPTIONS', 'busyTimeoutMs must be between 1 and 60000');
+        }
+        if (!Number.isInteger(maxEvents) || maxEvents < 1)
+            throw new StorageError('STORAGE_OPTIONS', 'maxEvents must be positive');
+        if (!Number.isInteger(maxPayloadBytes) || maxPayloadBytes < 1024) {
+            throw new StorageError('STORAGE_OPTIONS', 'maxPayloadBytes must be at least 1024');
+        }
+        if (!Number.isInteger(maxQueuedTransactions) || maxQueuedTransactions < 1) {
+            throw new StorageError('STORAGE_OPTIONS', 'maxQueuedTransactions must be positive');
+        }
+        await ensureDirectory(approvedRoot);
+        await assertApprovedPath(path, approvedRoot, 'SQLite path');
+        const backupDirectory = validatePath(options.backupDirectory ?? dirname(path), 'Backup directory');
+        await assertApprovedPath(backupDirectory, approvedRoot, 'Backup directory');
+        observeStartup(options.startupObserver, 'path-validation', stageStarted);
+        stageStarted = performance.now();
+        const lock = await acquireExclusiveLock(`${path}.exclusive.lock`);
+        observeStartup(options.startupObserver, 'lock-acquire', stageStarted);
+        stageStarted = performance.now();
+        let lockReleased = false;
+        try {
+            await recoverRestoreManifest(path, approvedRoot);
+            observeStartup(options.startupObserver, 'recovery-check', stageStarted);
+            stageStarted = performance.now();
+            const markerState = await inspectInitializationMarker(path);
+            observeStartup(options.startupObserver, 'initialization-marker', stageStarted);
+            if (markerState === 'active') {
+                throw new StorageError('STORAGE_INITIALIZING', 'Another process is initializing the encrypted database');
+            }
+            observeStartup(options.startupObserver, 'path-lock', pathLockStarted);
+            stageStarted = performance.now();
+            let credentialStoreAvailable = false;
+            try {
+                credentialStoreAvailable = await options.credentialStore.available();
+            }
+            catch (error) {
+                throw new StorageError('CREDENTIAL_STORE_UNAVAILABLE', 'The operating-system credential facility is unavailable', { cause: error });
+            }
+            if (!credentialStoreAvailable) {
+                throw new StorageError('CREDENTIAL_STORE_UNAVAILABLE', 'The operating-system credential facility is unavailable');
+            }
+            const databaseFactory = options.databaseFactory ?? loadCipherDatabaseFactory();
+            const databaseKeyRef = options.databaseKeyRef ?? deterministicCredentialRef('database', path);
+            const databaseKey = await resolveDatabaseKey(options, databaseKeyRef);
+            observeStartup(options.startupObserver, 'credential', stageStarted);
+            stageStarted = performance.now();
+            let opened;
+            let initializationClaimed = false;
+            try {
+                opened = openBoundSqliteDatabase(path, databaseFactory, busyTimeoutMs);
+                initializationClaimed = opened.newDatabase || markerState === 'stale';
+                if (initializationClaimed)
+                    await claimInitializationMarker(path);
+                configureCipherDatabase(opened.database, databaseKey, { newDatabase: opened.newDatabase });
+                applyConnectionPragmas(opened.database, busyTimeoutMs);
+                observeStartup(options.startupObserver, 'cipher-open', stageStarted);
+            }
+            catch (error) {
+                try {
+                    if (opened)
+                        closeBoundSqliteDatabase(opened);
+                }
+                catch {
+                    // The original error is the useful failure boundary.
+                }
+                databaseKey.fill(0);
+                if (initializationClaimed) {
+                    if (opened?.newDatabase)
+                        await removeDatabaseArtifacts(path);
+                    await releaseInitializationMarker(path);
+                }
+                throw error instanceof StorageError ? error : classifySqliteError(error);
+            }
+            const storage = new SqliteStorage({
+                path,
+                workspaceRoot: approvedRoot,
+                credentials: options.credentialStore,
+                databaseKeyRef,
+                databaseKey,
+                databaseFactory,
+                busyTimeoutMs,
+                maxEvents,
+                maxPayloadBytes,
+                maxQueuedTransactions,
+                backupDirectory,
+                ...(options.migrationHooks === undefined ? {} : { migrationHooks: options.migrationHooks }),
+                ...(options.durableBoundaryHook === undefined
+                    ? {}
+                    : { durableBoundaryHook: options.durableBoundaryHook }),
+                ...(options.startupObserver === undefined
+                    ? {}
+                    : { startupObserver: options.startupObserver }),
+                database: opened.database,
+                databaseFileDescriptor: opened.fileDescriptor,
+            });
+            databaseKey.fill(0);
+            try {
+                await storage.initialize();
+                if (initializationClaimed)
+                    await releaseInitializationMarker(path);
+                await lock.release();
+                lockReleased = true;
+                return storage;
+            }
+            catch (error) {
+                await storage.close().catch(() => undefined);
+                if (initializationClaimed) {
+                    if (opened?.newDatabase) {
+                        await removeDatabaseArtifacts(path).catch(() => undefined);
+                        await releaseInitializationMarker(path).catch(() => undefined);
+                    }
+                    else {
+                        await markInitializationInterrupted(path).catch(() => undefined);
+                    }
+                }
+                throw error;
+            }
+        }
+        finally {
+            if (!lockReleased)
+                await lock.release();
+        }
+    }
+}
+function observeStartup(observer, name, startedAt) {
+    try {
+        observer?.({ name, durationMs: performance.now() - startedAt });
+    }
+    catch {
+        // Diagnostics cannot change storage startup.
+    }
+}
+async function resolveDatabaseKey(options, ref) {
+    if (options.databaseKeySource)
+        return readHeadlessKey(options.databaseKeySource);
+    let handle;
+    try {
+        handle = await options.credentialStore.resolve(ref);
+        const key = Buffer.from(handle.read());
+        if (key.length !== 32)
+            throw new StorageError('SQLITE_KEY_INVALID', 'Stored SQLite key has invalid length');
+        return key;
+    }
+    catch (error) {
+        if (credentialErrorCode(error) !== 'CREDENTIAL_NOT_FOUND')
+            throw error;
+        const key = randomBytes(32);
+        try {
+            await options.credentialStore.store({ ref, value: key, label: 'Braid database key' });
+            return Buffer.from(key);
+        }
+        finally {
+            key.fill(0);
+            handle?.dispose();
+        }
+    }
+    finally {
+        handle?.dispose();
+    }
+}
+export function openSqliteStorage(options) {
+    return SqliteStorage.open(options);
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/adapters/storage/sqlite.js.map

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

package/dist/adapters/storage/storage-validation.d.ts

@@ -0,0 +1,12 @@
+import type { EffectRecord } from '../../ports/effect-storage.js';
+import type { JournalEvent, JsonValue, OperationIntent } from '../../ports/storage.js';
+/**
+ * A provider terminal event closes run output, not commands already racing with it.
+ * These events record command settlement or local bookkeeping without reopening output.
+ */
+export declare function canAppendAfterTerminal(event: Pick<JournalEvent, 'kind' | 'terminal'>): boolean;
+export declare function assertJournalEventInput(event: JournalEvent): void;
+export declare function assertOperationIntentInput(intent: OperationIntent): void;
+export declare function assertOperationRequestDigest(intent: OperationIntent, request: JsonValue): void;
+export declare function assertEffectRecordInput(record: EffectRecord): void;
+//# sourceMappingURL=storage-validation.d.ts.map

package/dist/adapters/storage/storage-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-validation.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/storage-validation.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAetF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG,OAAO,CAE9F;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAyCjE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAuBxE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAQ9F;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CA0DlE"}

package/dist/adapters/storage/storage-validation.js

@@ -0,0 +1,131 @@
+import { canonicalDigest } from '../../domain/canonical.js';
+import { parseConversationId, parseEventId, parseOperationId, parseReplayCursor, parseRunId, parseWorkspaceId, } from '../../domain/ids.js';
+import { isSafePublicMetadata } from '../../domain/public-metadata.js';
+import { containsUnsafeControlCharacter, isCanonicalIsoDateTime } from '../../domain/text.js';
+import { StorageError } from './sqlite-errors.js';
+const POST_TERMINAL_SIDEBAND_EVENT_KINDS = new Set([
+    'interaction.automation.audited',
+    'replay.cursor.advanced',
+    'run.cancel.requested',
+    'run.control.acknowledged',
+    'run.control.requested',
+    'run.interaction.responded',
+    'run.interaction.response.requested',
+    'run.queue.removed',
+    'run.reconciled',
+]);
+/**
+ * A provider terminal event closes run output, not commands already racing with it.
+ * These events record command settlement or local bookkeeping without reopening output.
+ */
+export function canAppendAfterTerminal(event) {
+    return event.terminal !== true && POST_TERMINAL_SIDEBAND_EVENT_KINDS.has(event.kind);
+}
+export function assertJournalEventInput(event) {
+    try {
+        parseWorkspaceId(event.workspaceId);
+        parseConversationId(event.conversationId);
+        parseRunId(event.runId);
+        parseEventId(event.eventId);
+        if (event.providerEventId !== undefined &&
+            (typeof event.providerEventId !== 'string' ||
+                event.providerEventId.length === 0 ||
+                event.providerEventId.length > 4096 ||
+                event.providerEventId.includes('\u0000') ||
+                event.providerEventId.includes('\r') ||
+                event.providerEventId.includes('\n'))) {
+            throw new StorageError('EVENT_INVALID', 'Provider event identity must be a bounded single-line string');
+        }
+        if (event.operationId !== undefined)
+            parseOperationId(event.operationId);
+        if (event.cursor !== undefined)
+            parseReplayCursor(event.cursor);
+    }
+    catch (error) {
+        throw new StorageError('EVENT_INVALID', 'Journal event contains an identifier from the wrong domain', { cause: error });
+    }
+    if (!Number.isSafeInteger(event.sequence) || event.sequence < 1) {
+        throw new StorageError('EVENT_INVALID', 'Journal event sequence must be a positive integer');
+    }
+    if (typeof event.kind !== 'string' || event.kind.length === 0 || event.kind.length > 256) {
+        throw new StorageError('EVENT_INVALID', 'Journal event kind must be a non-empty bounded string');
+    }
+    if (!isCanonicalIsoDateTime(event.occurredAt)) {
+        throw new StorageError('EVENT_INVALID', 'Journal event occurredAt must be a canonical ISO date');
+    }
+    if (event.receivedAt !== undefined && !isCanonicalIsoDateTime(event.receivedAt)) {
+        throw new StorageError('EVENT_INVALID', 'Journal event receivedAt must be a canonical ISO date');
+    }
+}
+export function assertOperationIntentInput(intent) {
+    try {
+        parseOperationId(intent.operationId);
+    }
+    catch (error) {
+        throw new StorageError('OPERATION_INVALID', 'Operation identifier is not valid', {
+            cause: error,
+        });
+    }
+    if (!/^[0-9a-f]{64}$/u.test(intent.requestDigest)) {
+        throw new StorageError('OPERATION_INVALID', 'Operation request digest must be a SHA-256 digest');
+    }
+    if (canonicalDigest(intent.request) !== intent.requestDigest) {
+        throw new StorageError('OPERATION_INVALID', 'Operation request digest does not match the canonical request');
+    }
+    if (typeof intent.kind !== 'string' || intent.kind.length === 0 || intent.kind.length > 256) {
+        throw new StorageError('OPERATION_INVALID', 'Operation kind must be a non-empty bounded string');
+    }
+    if (intent.createdAt !== undefined && !isCanonicalIsoDateTime(intent.createdAt)) {
+        throw new StorageError('OPERATION_INVALID', 'Operation createdAt must be a canonical ISO date');
+    }
+}
+export function assertOperationRequestDigest(intent, request) {
+    assertOperationIntentInput(intent);
+    if (canonicalDigest(request) !== intent.requestDigest) {
+        throw new StorageError('OPERATION_INVALID', 'Operation request digest does not cover the complete storage mutation request');
+    }
+}
+export function assertEffectRecordInput(record) {
+    try {
+        parseOperationId(record.operationId);
+    }
+    catch (error) {
+        throw new StorageError('EFFECT_INVALID', 'Effect operation identifier is not valid', {
+            cause: error,
+        });
+    }
+    if (!/^[0-9a-f]{64}$/u.test(record.requestDigest)) {
+        throw new StorageError('EFFECT_INVALID', 'Effect request digest must be a SHA-256 digest');
+    }
+    if (typeof record.effectKind !== 'string' ||
+        record.effectKind.length === 0 ||
+        record.effectKind.length > 256) {
+        throw new StorageError('EFFECT_INVALID', 'Effect kind must be a non-empty bounded string');
+    }
+    if (!Number.isSafeInteger(record.attempt) || record.attempt < 1) {
+        throw new StorageError('EFFECT_INVALID', 'Effect attempt must be a positive integer');
+    }
+    if (!isCanonicalIsoDateTime(record.createdAt) ||
+        !isCanonicalIsoDateTime(record.updatedAt) ||
+        record.updatedAt < record.createdAt) {
+        throw new StorageError('EFFECT_INVALID', 'Effect timestamps must be canonical ISO dates in order');
+    }
+    if (!['pending', 'acknowledged', 'failed', 'unknown', 'conflict', 'terminal'].includes(record.status)) {
+        throw new StorageError('EFFECT_INVALID', 'Effect status is not recognized');
+    }
+    const safeText = (value, field, maximum) => {
+        if (value.length > maximum ||
+            containsUnsafeControlCharacter(value) ||
+            /(secret|password|passphrase|token|bearer|authorization|credential|private(?:[_-]?key)?|api[-_]?key)\s*[:=]/iu.test(value)) {
+            throw new StorageError('EFFECT_INVALID', `${field} contains unsafe diagnostic text`);
+        }
+    };
+    if (record.detail !== undefined)
+        safeText(record.detail, 'Effect detail', 128);
+    if (record.externalReference !== undefined)
+        safeText(record.externalReference, 'Effect external reference', 256);
+    if (!isSafePublicMetadata(record.metadata)) {
+        throw new StorageError('EFFECT_INVALID', 'Effect metadata must contain only bounded public strings');
+    }
+}
+//# sourceMappingURL=storage-validation.js.map

package/dist/adapters/storage/storage-validation.js.map

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

package/dist/adapters/tui/alternate-screen-terminal.d.ts

@@ -0,0 +1,7 @@
+import { ProcessTerminal } from '@earendil-works/pi-tui/dist/terminal.js';
+export declare class AlternateScreenTerminal extends ProcessTerminal {
+    #private;
+    start(onInput: (data: string) => void, onResize: () => void): void;
+    stop(): void;
+}
+//# sourceMappingURL=alternate-screen-terminal.d.ts.map

package/dist/adapters/tui/alternate-screen-terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alternate-screen-terminal.d.ts","sourceRoot":"","sources":["../../../src/adapters/tui/alternate-screen-terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAA;AAKzE,qBAAa,uBAAwB,SAAQ,eAAe;;IAIjD,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAO1E;IAEQ,IAAI,IAAI,IAAI,CAKpB;CACF"}

package/dist/adapters/tui/alternate-screen-terminal.js

@@ -0,0 +1,24 @@
+import { ProcessTerminal } from '@earendil-works/pi-tui/dist/terminal.js';
+const ENTER_ALTERNATE_SCREEN = '\u001b[?1049h';
+const LEAVE_ALTERNATE_SCREEN = '\u001b[?1049l';
+export class AlternateScreenTerminal extends ProcessTerminal {
+    #started = false;
+    #stopped = false;
+    start(onInput, onResize) {
+        if (this.#started && !this.#stopped)
+            return;
+        this.#started = true;
+        this.#stopped = false;
+        super.start(onInput, onResize);
+        this.write(ENTER_ALTERNATE_SCREEN);
+        this.clearScreen();
+    }
+    stop() {
+        if (this.#stopped)
+            return;
+        this.#stopped = true;
+        this.write(LEAVE_ALTERNATE_SCREEN);
+        super.stop();
+    }
+}
+//# sourceMappingURL=alternate-screen-terminal.js.map

package/dist/adapters/tui/alternate-screen-terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alternate-screen-terminal.js","sourceRoot":"","sources":["../../../src/adapters/tui/alternate-screen-terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAA;AAEzE,MAAM,sBAAsB,GAAG,eAAe,CAAA;AAC9C,MAAM,sBAAsB,GAAG,eAAe,CAAA;AAE9C,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,QAAQ,GAAG,KAAK,CAAA;IAChB,QAAQ,GAAG,KAAK,CAAA;IAEP,KAAK,CAAC,OAA+B,EAAE,QAAoB;QAClE,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAM;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACrB,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAC9B,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAA;QAClC,IAAI,CAAC,WAAW,EAAE,CAAA;IACpB,CAAC;IAEQ,IAAI;QACX,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAM;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAA;QAClC,KAAK,CAAC,IAAI,EAAE,CAAA;IACd,CAAC;CACF"}

package/dist/adapters/tui/application-ui-controller.d.ts

@@ -0,0 +1,23 @@
+import type { BraidApplication } from '../../app/application.js';
+import type { BraidIntent, BraidUiController, UiDispatchResult, UiEvent, UiSubscriber, UiSubscriptionOptions } from '../../views/shared/intents.js';
+import type { BraidViewModel, HeadlessState } from '../../views/shared/models.js';
+import type { ProfileConnectionDispatchOptions } from './profile-connection-dispatch.js';
+import { type UiFixture } from './ui-fixtures.js';
+import { buildBraidViewModel, type UiAppearanceOptions } from './ui-view-model.js';
+export type { UiAppearanceOptions, UiFixture };
+export { buildBraidViewModel };
+export declare class ApplicationUiController implements BraidUiController {
+    #private;
+    constructor(app: BraidApplication, appearance?: UiAppearanceOptions, fixture?: UiFixture, profileConnectionOptions?: ProfileConnectionDispatchOptions);
+    view(): BraidViewModel;
+    state(): HeadlessState;
+    events(): readonly UiEvent[];
+    subscribe(subscriber: UiSubscriber, options?: UiSubscriptionOptions): () => void;
+    replaceApplication(next: BraidApplication, workspace: string): Promise<void>;
+    initialize(workspace: string): Promise<UiDispatchResult>;
+    dispatch(intent: BraidIntent): Promise<UiDispatchResult>;
+    waitForIdle(): Promise<BraidViewModel>;
+    close(): Promise<void>;
+}
+export declare function createApplicationUiController(app: BraidApplication, appearance?: UiAppearanceOptions, fixture?: UiFixture, profileConnectionOptions?: ProfileConnectionDispatchOptions): ApplicationUiController;
+//# sourceMappingURL=application-ui-controller.d.ts.map