niceeval 0.16.2-canary.98 → 0.16.2

package/dist/record/sqlite/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { Effect } from \"effect\";\nimport { projectRecordReadMode, startExternalRecordImport } from \"./external-record-import.ts\";\nimport { closeRecordDatabase, inspectProjectRecordDatabase, openImmutableRecordReader, reopenProjectDatabase, recordSqlitePath, validateExactSchema, type ProjectRecordDatabaseInspection, } from \"./database.ts\";\nimport { sqliteError } from \"./errors.ts\";\nimport { findAttemptLocatorCandidates as findAttemptLocatorCandidatesOnConnection, readSealedRunSummaryPage as readSealedRunSummaryPageOnConnection, readCollectionItemPage as readCollectionItemPageOnConnection, readContentChunkPage as readContentChunkPageOnConnection, readSealedRunDocument as readSealedRunDocumentOnConnection, readSealedRunCore as readSealedRunCoreOnConnection, readSealedRunSummary as readSealedRunSummaryOnConnection, verifyAllSealedRuns, } from \"./storage.ts\";\nimport { RECORD_SQLITE_VALIDATION_DEADLINE_MS, type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunDocument, type SealedRunCore, type SealedRunSummary, type SealedRunSummaryPage, } from \"./types.ts\";\nimport { currentPublicationCutoffOnConnection, readRunResourceOnConnection, listRunResourcesOnConnection, } from \"../../run/storage/sqlite.ts\";\nimport { publicationCutoffIdentity } from \"../../run/storage/cutoff.ts\";\nimport type { PublicationCutoff, ReadableRunResource, } from \"../../run/storage/types.ts\";\nexport { makeStorageWorkerClient, openStorageWorker, type StorageWorkerClient } from \"./client.ts\";\nexport { ProjectStateDatabase, ProjectStateDatabaseLive, type ProjectStateDatabaseService, type ProjectStateFacets, } from \"./project-state-database.ts\";\nexport { SqliteRecordError, type SqliteRecordErrorCode } from \"./errors.ts\";\nexport { RECORD_SQLITE_CHUNK_BYTES, RECORD_SQLITE_FORMAT, RECORD_SQLITE_MAX_PUBLISH_BYTES, RECORD_SQLITE_MAX_PUBLISH_ROWS, RECORD_SQLITE_MAX_ROW_BYTES, RECORD_SQLITE_MAX_PAGE_ROWS, RECORD_SQLITE_MAX_PAGE_BYTES, RECORD_SQLITE_MAX_VALIDATION_ROWS, RECORD_SQLITE_MAX_VALIDATION_RUNS, RECORD_SQLITE_VALIDATION_DEADLINE_MS, RECORD_SQLITE_STORAGE_REVISION, type AdmitAttachmentInput, type AdmitAttemptInput, type AdmitContentInput, type AppendContentChunksInput, type BeginRunInput, type AttemptLocatorCandidateRun, type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type FinalizeRunInput, type FinalizedAttachmentMetadata, type FinalizedAttachmentClosure, type FenceRunFinalizationInput, type PersistedAttachment, type PersistedAttachmentReference, type PersistedCollectionItem, type PersistedContent, type PersistedContentMetadata, type PersistedContentChunk, type PersistedMember, type PersistedSlot, type PersistedAttempt, type PersistSealedRunInput, type PrepareRunFinalizationInput, type PreparedRunFinalization, type RunFinalization, type SealEntry, type SealedAttachmentDocument, type SealedAttachmentMetadata, type SealedRunCore, type SealedRunDocument, type SealedRunSummary, type SealedRunCutoff, type SealedRunSummaryPage, type SealRunInput, type StageAttachmentInput, type StageAttachmentReferencesInput, type StageCollectionItemsInput, type StageSealEntriesInput, type StageSealEntriesResult, type StageRunCoreInput, } from \"./types.ts\";\nexport { inspectProjectRecordDatabase, recordSqlitePath, reopenProjectDatabase, type ProjectRecordDatabaseInspection };\n/** Fixed Host-private read surface. The SQLite connection and SQL stay encapsulated. */\nexport interface PinnedRecordReadSession {\n    readonly kind: \"canonical\" | \"private-generation\";\n    readonly deadlineEpochMs: number;\n    readonly publicationCutoff: () => PublicationCutoff;\n    readonly readRunResource: (runId: string) => ReadableRunResource | undefined;\n    readonly listRunResources: (input?: Parameters<typeof listRunResourcesOnConnection>[1]) => ReturnType<typeof listRunResourcesOnConnection>;\n    readonly readSealedRunSummary: (runId: string) => SealedRunSummary | undefined;\n    readonly readSealedRunSummaryPage: (afterRunId?: string, pageSize?: number, expectedCutoffIdentity?: string) => SealedRunSummaryPage;\n    readonly findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => AttemptLocatorCandidates;\n    readonly readSealedRunDocument: (runId: string) => SealedRunDocument | undefined;\n    readonly readSealedRunCore: (runId: string) => SealedRunCore | undefined;\n    readonly readContentChunkPage: (contentId: string, afterOrdinal: number, pageSize: number) => ContentChunkPage;\n    readonly readCollectionItemPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => CollectionItemPage;\n    readonly close: () => void;\n}\nfunction openPinnedRecordReadSession(path: string, kind: \"canonical\" | \"private-generation\", deadlineEpochMs: number, validation: \"complete\" | \"host-validated-generation\" = \"complete\"): PinnedRecordReadSession {\n    if (!Number.isSafeInteger(deadlineEpochMs) || deadlineEpochMs <= Date.now()) {\n        throw sqliteError(\"record-resource-limit-exceeded\", \"open-read-session\", \"pinned read deadline must be a future safe integer\");\n    }\n    const connection = openImmutableRecordReader(path);\n    let closed = false;\n    const close = (): void => {\n        if (closed)\n            return;\n        closed = true;\n        try {\n            if (connection.db.isTransaction)\n                connection.db.exec(\"ROLLBACK\");\n        }\n        finally {\n            closeRecordDatabase(connection);\n        }\n    };\n    const assertUsable = (operation: string): void => {\n        if (closed)\n            throw sqliteError(\"record-database-invalid\", operation, \"pinned read session is closed\");\n        if (Date.now() >= deadlineEpochMs) {\n            close();\n            throw sqliteError(\"record-resource-limit-exceeded\", operation, \"pinned read session exceeded its deadline and was closed\");\n        }\n    };\n    const readBounded = <A>(operation: string, read: () => A): A => {\n        assertUsable(operation);\n        const result = read();\n        // Synchronous SQLite work may only observe the deadline at its boundary;\n        // never release a result if that work crossed the session deadline.\n        assertUsable(operation);\n        return result;\n    };\n    try {\n        // BEGIN occurs before the authoritative schema + Seal pass. Every later\n        // read observes this same WAL/file generation until close rolls it back.\n        connection.db.exec(\"BEGIN\");\n        const publicationCutoff = currentPublicationCutoffOnConnection(connection);\n        const cutoffIdentity = publicationCutoffIdentity(publicationCutoff);\n        validateExactSchema(connection);\n        if (validation === \"complete\") {\n            verifyAllSealedRuns(connection, false, deadlineEpochMs);\n        }\n        else if (kind !== \"private-generation\") {\n            throw sqliteError(\"record-database-invalid\", \"open-read-session\", \"only an admitted private generation may skip repeated validation\");\n        }\n        assertUsable(\"open-read-session\");\n        return Object.freeze({\n            kind,\n            deadlineEpochMs,\n            publicationCutoff: () => publicationCutoff,\n            readRunResource: (runId: string) => readBounded(\"read-run-resource\", () => readRunResourceOnConnection(connection, runId, publicationCutoff)),\n            listRunResources: (input: Parameters<typeof listRunResourcesOnConnection>[1]) => readBounded(\"list-run-resources\", () => listRunResourcesOnConnection(connection, { ...input, cutoff: input?.cutoff ?? publicationCutoff })),\n            readSealedRunSummary: (runId: string) => readBounded(\"read-sealed-run-summary\", () => readSealedRunSummaryOnConnection(connection, runId)),\n            readSealedRunSummaryPage: (afterRunId = \"\", pageSize = 100, expectedCutoffIdentity?: string) => readBounded(\"page-sealed-runs\", () => {\n                if (expectedCutoffIdentity !== undefined && expectedCutoffIdentity !== cutoffIdentity) {\n                    throw sqliteError(\"record-command-conflict\", \"page-sealed-runs\", \"publication cutoff changed; restart pagination\");\n                }\n                const page = readSealedRunSummaryPageOnConnection(connection, afterRunId, pageSize, undefined, deadlineEpochMs);\n                return Object.freeze({\n                    ...page,\n                    cutoff: Object.freeze({ ...page.cutoff, identity: cutoffIdentity }),\n                });\n            }),\n            findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => readBounded(\"find-attempt-locator\", () => findAttemptLocatorCandidatesOnConnection(connection, locator, maximumCandidateRuns)),\n            readSealedRunDocument: (runId: string) => readBounded(\"read-sealed-run-document\", () => readSealedRunDocumentOnConnection(connection, runId)),\n            readSealedRunCore: (runId: string) => readBounded(\"read-sealed-run-core\", () => readSealedRunCoreOnConnection(connection, runId)),\n            readContentChunkPage: (contentId: string, afterOrdinal: number, pageSize: number) => readBounded(\"read-content-page\", () => readContentChunkPageOnConnection(connection, contentId, afterOrdinal, pageSize)),\n            readCollectionItemPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => readBounded(\"read-collection-page\", () => readCollectionItemPageOnConnection(connection, attachmentId, afterOrdinal, pageSize)),\n            close,\n        });\n    }\n    catch (cause) {\n        close();\n        throw cause;\n    }\n}\nexport function openOperationalRecordReadSession(recordStorageRoot: string, deadlineEpochMs = Date.now() + RECORD_SQLITE_VALIDATION_DEADLINE_MS): PinnedRecordReadSession {\n    return openPinnedRecordReadSession(recordSqlitePath(recordStorageRoot), \"canonical\", deadlineEpochMs);\n}\n/** Read admission never binds a project writer or mutates historical input. */\nexport const acquireProjectRecordReadSession = Effect.fn(\"acquireProjectRecordReadSession\")(function* (recordStorageRoot: string) {\n    const path = recordSqlitePath(recordStorageRoot);\n    const mode = yield* Effect.try({ try: () => projectRecordReadMode(path), catch: (cause) => cause });\n    if (mode === \"operational\") {\n        return yield* Effect.acquireRelease(Effect.try({ try: () => openOperationalRecordReadSession(recordStorageRoot), catch: (cause) => cause }), (session) => Effect.sync(() => session.close()));\n    }\n    const importer = yield* Effect.acquireRelease(Effect.try({\n        try: () => startExternalRecordImport(path, Date.now() + RECORD_SQLITE_VALIDATION_DEADLINE_MS, \"captured-project-record\"),\n        catch: (cause) => cause,\n    }), (handle) => Effect.promise(() => handle.close()));\n    const generation = yield* Effect.tryPromise({ try: (_signal) => importer.result, catch: (cause) => cause });\n    return yield* Effect.acquireRelease(Effect.try({ try: () => openHostOwnedRecordReadSession(generation.path), catch: (cause) => cause }), (session) => Effect.sync(() => session.close()));\n});\n/** Opens only a private generation already admitted by the hostile importer. */\nexport function openHostOwnedRecordReadSession(generationPath: string, deadlineEpochMs = Date.now() + RECORD_SQLITE_VALIDATION_DEADLINE_MS): PinnedRecordReadSession {\n    return openPinnedRecordReadSession(generationPath, \"private-generation\", deadlineEpochMs, \"host-validated-generation\");\n}\nfunction withSession<A>(session: PinnedRecordReadSession, use: (session: PinnedRecordReadSession) => A): A {\n    try {\n        return use(session);\n    }\n    finally {\n        session.close();\n    }\n}\nexport function readSealedRunSummary(recordStorageRoot: string, runId: string): SealedRunSummary | undefined {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readSealedRunSummary(runId));\n}\nexport function listSealedRunSummaries(recordStorageRoot: string, afterRunId = \"\", pageSize = 100): readonly SealedRunSummary[] {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readSealedRunSummaryPage(afterRunId, pageSize).summaries);\n}\nexport function readSealedRunSummaryPage(recordStorageRoot: string, afterRunId = \"\", pageSize = 100, expectedCutoffIdentity?: string): SealedRunSummaryPage {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readSealedRunSummaryPage(afterRunId, pageSize, expectedCutoffIdentity));\n}\nexport function findAttemptLocatorCandidates(recordStorageRoot: string, locator: string, maximumCandidateRuns: number): AttemptLocatorCandidates {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.findAttemptLocatorCandidates(locator, maximumCandidateRuns));\n}\nexport function readCollectionItemPage(recordStorageRoot: string, attachmentId: string, afterOrdinal: number, pageSize: number): CollectionItemPage {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readCollectionItemPage(attachmentId, afterOrdinal, pageSize));\n}\nexport function readSealedRunDocument(recordStorageRoot: string, runId: string): SealedRunDocument | undefined {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readSealedRunDocument(runId));\n}\nexport function readSealedRunCore(recordStorageRoot: string, runId: string): SealedRunCore | undefined {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readSealedRunCore(runId));\n}\nexport function readContentChunkPage(recordStorageRoot: string, contentId: string, afterOrdinal: number, pageSize: number): ContentChunkPage {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readContentChunkPage(contentId, afterOrdinal, pageSize));\n}\nexport function validateRecordDatabase(recordStorageRoot: string, sealedOnly = false): number {\n    const connection = openImmutableRecordReader(recordSqlitePath(recordStorageRoot));\n    try {\n        validateExactSchema(connection);\n        return verifyAllSealedRuns(connection, sealedOnly);\n    }\n    finally {\n        closeRecordDatabase(connection);\n    }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { Effect } from \"effect\";\nimport { projectRecordReadMode, startExternalRecordImport } from \"./external-record-import.ts\";\nimport { closeRecordDatabase, inspectProjectRecordDatabase, openImmutableRecordReader, reopenProjectDatabase, recordSqlitePath, validateExactSchema, type ProjectRecordDatabaseInspection, } from \"./database.ts\";\nimport { sqliteError } from \"./errors.ts\";\nimport { findAttemptLocatorCandidates as findAttemptLocatorCandidatesOnConnection, findExperimentRunIds as findExperimentRunIdsOnConnection, readSealedRunCutoff as readSealedRunCutoffOnConnection, readSealedRunSummaryPage as readSealedRunSummaryPageOnConnection, readCollectionItemPage as readCollectionItemPageOnConnection, readContentChunkPage as readContentChunkPageOnConnection, readSealedRunDocument as readSealedRunDocumentOnConnection, readSealedRunCore as readSealedRunCoreOnConnection, readSealedRunSummary as readSealedRunSummaryOnConnection, verifyAllSealedRuns, } from \"./storage.ts\";\nimport { RECORD_SQLITE_VALIDATION_DEADLINE_MS, type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunDocument, type SealedRunCore, type SealedRunCutoff, type SealedRunSummary, type SealedRunSummaryPage, } from \"./types.ts\";\nimport { currentPublicationCutoffOnConnection, readRunResourceOnConnection, listRunResourcesOnConnection, } from \"../../run/storage/sqlite.ts\";\nimport { publicationCutoffIdentity } from \"../../run/storage/cutoff.ts\";\nimport type { PublicationCutoff, ReadableRunResource, } from \"../../run/storage/types.ts\";\nexport { makeStorageWorkerClient, openStorageWorker, type StorageWorkerClient } from \"./client.ts\";\nexport { ProjectStateDatabase, ProjectStateDatabaseLive, type ProjectStateDatabaseService, type ProjectStateFacets, } from \"./project-state-database.ts\";\nexport { SqliteRecordError, type SqliteRecordErrorCode } from \"./errors.ts\";\nexport { RECORD_SQLITE_CHUNK_BYTES, RECORD_SQLITE_FORMAT, RECORD_SQLITE_MAX_PUBLISH_BYTES, RECORD_SQLITE_MAX_PUBLISH_ROWS, RECORD_SQLITE_MAX_ROW_BYTES, RECORD_SQLITE_MAX_PAGE_ROWS, RECORD_SQLITE_MAX_PAGE_BYTES, RECORD_SQLITE_MAX_VALIDATION_ROWS, RECORD_SQLITE_MAX_VALIDATION_RUNS, RECORD_SQLITE_VALIDATION_DEADLINE_MS, RECORD_SQLITE_STORAGE_REVISION, type AdmitAttachmentInput, type AdmitAttemptInput, type AdmitContentInput, type AppendContentChunksInput, type BeginRunInput, type AttemptLocatorCandidateRun, type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type FinalizeRunInput, type FinalizedAttachmentMetadata, type FinalizedAttachmentClosure, type FenceRunFinalizationInput, type PersistedAttachment, type PersistedAttachmentReference, type PersistedCollectionItem, type PersistedContent, type PersistedContentMetadata, type PersistedContentChunk, type PersistedMember, type PersistedSlot, type PersistedAttempt, type PersistSealedRunInput, type PrepareRunFinalizationInput, type PreparedRunFinalization, type RunFinalization, type SealEntry, type SealedAttachmentDocument, type SealedAttachmentMetadata, type SealedRunCore, type SealedRunDocument, type SealedRunSummary, type SealedRunCutoff, type SealedRunSummaryPage, type SealRunInput, type StageAttachmentInput, type StageAttachmentReferencesInput, type StageCollectionItemsInput, type StageSealEntriesInput, type StageSealEntriesResult, type StageRunCoreInput, } from \"./types.ts\";\nexport { inspectProjectRecordDatabase, recordSqlitePath, reopenProjectDatabase, type ProjectRecordDatabaseInspection };\n/** Fixed Host-private read surface. The SQLite connection and SQL stay encapsulated. */\nexport interface PinnedRecordReadSession {\n    readonly kind: \"canonical\" | \"private-generation\";\n    readonly deadlineEpochMs: number;\n    readonly publicationCutoff: () => PublicationCutoff;\n    readonly sealedCutoff: () => SealedRunCutoff;\n    readonly findExperimentRunIds: (experimentId: string) => readonly string[];\n    readonly readRunResource: (runId: string) => ReadableRunResource | undefined;\n    readonly listRunResources: (input?: Parameters<typeof listRunResourcesOnConnection>[1]) => ReturnType<typeof listRunResourcesOnConnection>;\n    readonly readSealedRunSummary: (runId: string) => SealedRunSummary | undefined;\n    readonly readSealedRunSummaryPage: (afterRunId?: string, pageSize?: number, expectedCutoffIdentity?: string) => SealedRunSummaryPage;\n    readonly findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => AttemptLocatorCandidates;\n    readonly readSealedRunDocument: (runId: string) => SealedRunDocument | undefined;\n    readonly readSealedRunCore: (runId: string, lazyAttachments?: boolean) => SealedRunCore | undefined;\n    readonly readContentChunkPage: (contentId: string, afterOrdinal: number, pageSize: number) => ContentChunkPage;\n    readonly readCollectionItemPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => CollectionItemPage;\n    readonly close: () => void;\n}\nfunction openPinnedRecordReadSession(path: string, kind: \"canonical\" | \"private-generation\", deadlineEpochMs: number): PinnedRecordReadSession {\n    if (!Number.isSafeInteger(deadlineEpochMs) || deadlineEpochMs <= Date.now()) {\n        throw sqliteError(\"record-resource-limit-exceeded\", \"open-read-session\", \"pinned read deadline must be a future safe integer\");\n    }\n    const connection = openImmutableRecordReader(path);\n    let closed = false;\n    const close = (): void => {\n        if (closed)\n            return;\n        closed = true;\n        try {\n            if (connection.db.isTransaction)\n                connection.db.exec(\"ROLLBACK\");\n        }\n        finally {\n            closeRecordDatabase(connection);\n        }\n    };\n    const assertUsable = (operation: string): void => {\n        if (closed)\n            throw sqliteError(\"record-database-invalid\", operation, \"pinned read session is closed\");\n        if (Date.now() >= deadlineEpochMs) {\n            close();\n            throw sqliteError(\"record-resource-limit-exceeded\", operation, \"pinned read session exceeded its deadline and was closed\");\n        }\n    };\n    const readBounded = <A>(operation: string, read: () => A): A => {\n        assertUsable(operation);\n        const result = read();\n        // Synchronous SQLite work may only observe the deadline at its boundary;\n        // never release a result if that work crossed the session deadline.\n        assertUsable(operation);\n        return result;\n    };\n    try {\n        // BEGIN occurs before the authoritative schema pass. Every later\n        // read observes this same WAL/file generation until close rolls it back.\n        connection.db.exec(\"BEGIN\");\n        const publicationCutoff = currentPublicationCutoffOnConnection(connection);\n        const cutoffIdentity = publicationCutoffIdentity(publicationCutoff);\n        validateExactSchema(connection);\n        // Both sources have an admission owner: the project writer or the hostile\n        // importer. Re-check selected facts, not every historical Seal, on reads.\n        let sealedCutoff: SealedRunCutoff | undefined;\n        const readCutoff = () => sealedCutoff ??= readBounded(\"read-sealed-cutoff\", () => readSealedRunCutoffOnConnection(connection, cutoffIdentity));\n        assertUsable(\"open-read-session\");\n        return Object.freeze({\n            kind,\n            deadlineEpochMs,\n            publicationCutoff: () => publicationCutoff,\n            sealedCutoff: readCutoff,\n            findExperimentRunIds: (experimentId: string) => readBounded(\"find-experiment-runs\", () => findExperimentRunIdsOnConnection(connection, experimentId)),\n            readRunResource: (runId: string) => readBounded(\"read-run-resource\", () => readRunResourceOnConnection(connection, runId, publicationCutoff)),\n            listRunResources: (input: Parameters<typeof listRunResourcesOnConnection>[1]) => readBounded(\"list-run-resources\", () => listRunResourcesOnConnection(connection, { ...input, cutoff: input?.cutoff ?? publicationCutoff })),\n            readSealedRunSummary: (runId: string) => readBounded(\"read-sealed-run-summary\", () => readSealedRunSummaryOnConnection(connection, runId)),\n            readSealedRunSummaryPage: (afterRunId = \"\", pageSize = 100, expectedCutoffIdentity?: string) => readBounded(\"page-sealed-runs\", () => {\n                if (expectedCutoffIdentity !== undefined && expectedCutoffIdentity !== cutoffIdentity) {\n                    throw sqliteError(\"record-command-conflict\", \"page-sealed-runs\", \"publication cutoff changed; restart pagination\");\n                }\n                const page = readSealedRunSummaryPageOnConnection(connection, afterRunId, pageSize, undefined, deadlineEpochMs, readCutoff());\n                return Object.freeze({\n                    ...page,\n                    cutoff: Object.freeze({ ...page.cutoff, identity: cutoffIdentity }),\n                });\n            }),\n            findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => readBounded(\"find-attempt-locator\", () => findAttemptLocatorCandidatesOnConnection(connection, locator, maximumCandidateRuns)),\n            readSealedRunDocument: (runId: string) => readBounded(\"read-sealed-run-document\", () => readSealedRunDocumentOnConnection(connection, runId)),\n            readSealedRunCore: (runId: string, lazyAttachments = false) => readBounded(\"read-sealed-run-core\", () => readSealedRunCoreOnConnection(connection, runId, lazyAttachments\n                ? (read) => readBounded(\"read-sealed-attachment\", read)\n                : undefined)),\n            readContentChunkPage: (contentId: string, afterOrdinal: number, pageSize: number) => readBounded(\"read-content-page\", () => readContentChunkPageOnConnection(connection, contentId, afterOrdinal, pageSize)),\n            readCollectionItemPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => readBounded(\"read-collection-page\", () => readCollectionItemPageOnConnection(connection, attachmentId, afterOrdinal, pageSize)),\n            close,\n        });\n    }\n    catch (cause) {\n        close();\n        throw cause;\n    }\n}\nexport function openOperationalRecordReadSession(recordStorageRoot: string, deadlineEpochMs = Date.now() + RECORD_SQLITE_VALIDATION_DEADLINE_MS): PinnedRecordReadSession {\n    return openPinnedRecordReadSession(recordSqlitePath(recordStorageRoot), \"canonical\", deadlineEpochMs);\n}\n/** Read admission never binds a project writer or mutates historical input. */\nexport const acquireProjectRecordReadSession = Effect.fn(\"acquireProjectRecordReadSession\")(function* (recordStorageRoot: string) {\n    const path = recordSqlitePath(recordStorageRoot);\n    const mode = yield* Effect.try({ try: () => projectRecordReadMode(path), catch: (cause) => cause });\n    if (mode === \"operational\") {\n        return yield* Effect.acquireRelease(Effect.try({ try: () => openOperationalRecordReadSession(recordStorageRoot), catch: (cause) => cause }), (session) => Effect.sync(() => session.close()));\n    }\n    const importer = yield* Effect.acquireRelease(Effect.try({\n        try: () => startExternalRecordImport(path, Date.now() + RECORD_SQLITE_VALIDATION_DEADLINE_MS, \"captured-project-record\"),\n        catch: (cause) => cause,\n    }), (handle) => Effect.promise(() => handle.close()));\n    const generation = yield* Effect.tryPromise({ try: (_signal) => importer.result, catch: (cause) => cause });\n    return yield* Effect.acquireRelease(Effect.try({ try: () => openHostOwnedRecordReadSession(generation.path), catch: (cause) => cause }), (session) => Effect.sync(() => session.close()));\n});\n/** Opens only a private generation already admitted by the hostile importer. */\nexport function openHostOwnedRecordReadSession(generationPath: string, deadlineEpochMs = Date.now() + RECORD_SQLITE_VALIDATION_DEADLINE_MS): PinnedRecordReadSession {\n    return openPinnedRecordReadSession(generationPath, \"private-generation\", deadlineEpochMs);\n}\nfunction withSession<A>(session: PinnedRecordReadSession, use: (session: PinnedRecordReadSession) => A): A {\n    try {\n        return use(session);\n    }\n    finally {\n        session.close();\n    }\n}\nexport function readSealedRunSummary(recordStorageRoot: string, runId: string): SealedRunSummary | undefined {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readSealedRunSummary(runId));\n}\nexport function listSealedRunSummaries(recordStorageRoot: string, afterRunId = \"\", pageSize = 100): readonly SealedRunSummary[] {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readSealedRunSummaryPage(afterRunId, pageSize).summaries);\n}\nexport function readSealedRunSummaryPage(recordStorageRoot: string, afterRunId = \"\", pageSize = 100, expectedCutoffIdentity?: string): SealedRunSummaryPage {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readSealedRunSummaryPage(afterRunId, pageSize, expectedCutoffIdentity));\n}\nexport function findAttemptLocatorCandidates(recordStorageRoot: string, locator: string, maximumCandidateRuns: number): AttemptLocatorCandidates {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.findAttemptLocatorCandidates(locator, maximumCandidateRuns));\n}\nexport function readCollectionItemPage(recordStorageRoot: string, attachmentId: string, afterOrdinal: number, pageSize: number): CollectionItemPage {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readCollectionItemPage(attachmentId, afterOrdinal, pageSize));\n}\nexport function readSealedRunDocument(recordStorageRoot: string, runId: string): SealedRunDocument | undefined {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readSealedRunDocument(runId));\n}\nexport function readSealedRunCore(recordStorageRoot: string, runId: string): SealedRunCore | undefined {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readSealedRunCore(runId));\n}\nexport function readContentChunkPage(recordStorageRoot: string, contentId: string, afterOrdinal: number, pageSize: number): ContentChunkPage {\n    return withSession(openOperationalRecordReadSession(recordStorageRoot), (session) => session.readContentChunkPage(contentId, afterOrdinal, pageSize));\n}\nexport function validateRecordDatabase(recordStorageRoot: string, sealedOnly = false): number {\n    const connection = openImmutableRecordReader(recordSqlitePath(recordStorageRoot));\n    try {\n        validateExactSchema(connection);\n        return verifyAllSealedRuns(connection, sealedOnly);\n    }\n    finally {\n        closeRecordDatabase(connection);\n    }\n}\n"]}

package/dist/record/sqlite/index.d.cts

@@ -1,6 +1,6 @@
 import { Effect } from "effect";
 import { inspectProjectRecordDatabase, reopenProjectDatabase, recordSqlitePath, type ProjectRecordDatabaseInspection } from "./database.cjs";
-import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunDocument, type SealedRunCore, type SealedRunSummary, type SealedRunSummaryPage } from "./types.cjs";
+import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunDocument, type SealedRunCore, type SealedRunCutoff, type SealedRunSummary, type SealedRunSummaryPage } from "./types.cjs";
 import { listRunResourcesOnConnection } from "../../run/storage/sqlite.cjs";
 import type { PublicationCutoff, ReadableRunResource } from "../../run/storage/types.cjs";
 export { makeStorageWorkerClient, openStorageWorker, type StorageWorkerClient } from "./client.cjs";
@@ -13,13 +13,15 @@ export interface PinnedRecordReadSession {
     readonly kind: "canonical" | "private-generation";
     readonly deadlineEpochMs: number;
     readonly publicationCutoff: () => PublicationCutoff;
+    readonly sealedCutoff: () => SealedRunCutoff;
+    readonly findExperimentRunIds: (experimentId: string) => readonly string[];
     readonly readRunResource: (runId: string) => ReadableRunResource | undefined;
     readonly listRunResources: (input?: Parameters<typeof listRunResourcesOnConnection>[1]) => ReturnType<typeof listRunResourcesOnConnection>;
     readonly readSealedRunSummary: (runId: string) => SealedRunSummary | undefined;
     readonly readSealedRunSummaryPage: (afterRunId?: string, pageSize?: number, expectedCutoffIdentity?: string) => SealedRunSummaryPage;
     readonly findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => AttemptLocatorCandidates;
     readonly readSealedRunDocument: (runId: string) => SealedRunDocument | undefined;
-    readonly readSealedRunCore: (runId: string) => SealedRunCore | undefined;
+    readonly readSealedRunCore: (runId: string, lazyAttachments?: boolean) => SealedRunCore | undefined;
     readonly readContentChunkPage: (contentId: string, afterOrdinal: number, pageSize: number) => ContentChunkPage;
     readonly readCollectionItemPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => CollectionItemPage;
     readonly close: () => void;

package/dist/record/sqlite/index.d.mts

@@ -1,6 +1,6 @@
 import { Effect } from "effect";
 import { inspectProjectRecordDatabase, reopenProjectDatabase, recordSqlitePath, type ProjectRecordDatabaseInspection } from "./database.mjs";
-import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunDocument, type SealedRunCore, type SealedRunSummary, type SealedRunSummaryPage } from "./types.mjs";
+import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunDocument, type SealedRunCore, type SealedRunCutoff, type SealedRunSummary, type SealedRunSummaryPage } from "./types.mjs";
 import { listRunResourcesOnConnection } from "../../run/storage/sqlite.mjs";
 import type { PublicationCutoff, ReadableRunResource } from "../../run/storage/types.mjs";
 export { makeStorageWorkerClient, openStorageWorker, type StorageWorkerClient } from "./client.mjs";
@@ -13,13 +13,15 @@ export interface PinnedRecordReadSession {
     readonly kind: "canonical" | "private-generation";
     readonly deadlineEpochMs: number;
     readonly publicationCutoff: () => PublicationCutoff;
+    readonly sealedCutoff: () => SealedRunCutoff;
+    readonly findExperimentRunIds: (experimentId: string) => readonly string[];
     readonly readRunResource: (runId: string) => ReadableRunResource | undefined;
     readonly listRunResources: (input?: Parameters<typeof listRunResourcesOnConnection>[1]) => ReturnType<typeof listRunResourcesOnConnection>;
     readonly readSealedRunSummary: (runId: string) => SealedRunSummary | undefined;
     readonly readSealedRunSummaryPage: (afterRunId?: string, pageSize?: number, expectedCutoffIdentity?: string) => SealedRunSummaryPage;
     readonly findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => AttemptLocatorCandidates;
     readonly readSealedRunDocument: (runId: string) => SealedRunDocument | undefined;
-    readonly readSealedRunCore: (runId: string) => SealedRunCore | undefined;
+    readonly readSealedRunCore: (runId: string, lazyAttachments?: boolean) => SealedRunCore | undefined;
     readonly readContentChunkPage: (contentId: string, afterOrdinal: number, pageSize: number) => ContentChunkPage;
     readonly readCollectionItemPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => CollectionItemPage;
     readonly close: () => void;

package/dist/record/sqlite/index.d.ts

@@ -1,6 +1,6 @@
 import { Effect } from "effect";
 import { inspectProjectRecordDatabase, reopenProjectDatabase, recordSqlitePath, type ProjectRecordDatabaseInspection } from "./database.js";
-import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunDocument, type SealedRunCore, type SealedRunSummary, type SealedRunSummaryPage } from "./types.js";
+import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunDocument, type SealedRunCore, type SealedRunCutoff, type SealedRunSummary, type SealedRunSummaryPage } from "./types.js";
 import { listRunResourcesOnConnection } from "../../run/storage/sqlite.js";
 import type { PublicationCutoff, ReadableRunResource } from "../../run/storage/types.js";
 export { makeStorageWorkerClient, openStorageWorker, type StorageWorkerClient } from "./client.js";
@@ -13,13 +13,15 @@ export interface PinnedRecordReadSession {
     readonly kind: "canonical" | "private-generation";
     readonly deadlineEpochMs: number;
     readonly publicationCutoff: () => PublicationCutoff;
+    readonly sealedCutoff: () => SealedRunCutoff;
+    readonly findExperimentRunIds: (experimentId: string) => readonly string[];
     readonly readRunResource: (runId: string) => ReadableRunResource | undefined;
     readonly listRunResources: (input?: Parameters<typeof listRunResourcesOnConnection>[1]) => ReturnType<typeof listRunResourcesOnConnection>;
     readonly readSealedRunSummary: (runId: string) => SealedRunSummary | undefined;
     readonly readSealedRunSummaryPage: (afterRunId?: string, pageSize?: number, expectedCutoffIdentity?: string) => SealedRunSummaryPage;
     readonly findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => AttemptLocatorCandidates;
     readonly readSealedRunDocument: (runId: string) => SealedRunDocument | undefined;
-    readonly readSealedRunCore: (runId: string) => SealedRunCore | undefined;
+    readonly readSealedRunCore: (runId: string, lazyAttachments?: boolean) => SealedRunCore | undefined;
     readonly readContentChunkPage: (contentId: string, afterOrdinal: number, pageSize: number) => ContentChunkPage;
     readonly readCollectionItemPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => CollectionItemPage;
     readonly close: () => void;

package/dist/record/sqlite/storage.cjs

@@ -23,6 +23,8 @@ exports.sealRun = sealRun;
 exports.publishRunSeal = publishRunSeal;
 exports.verifyAllSealedRuns = verifyAllSealedRuns;
 exports.readSealedRunSummary = readSealedRunSummary;
+exports.readSealedRunCutoff = readSealedRunCutoff;
+exports.findExperimentRunIds = findExperimentRunIds;
 exports.listSealedRunSummaries = listSealedRunSummaries;
 exports.readSealedRunSummaryPage = readSealedRunSummaryPage;
 exports.findAttemptLocatorCandidates = findAttemptLocatorCandidates;
@@ -1480,12 +1482,62 @@ function verifyRunPayloadClosures(connection, runId, verifyPayloadBytes = true)
         }
     }
 }
+/** Summary metadata never materializes Core, Attachment payload or collection rows. */
 function readSealedRunSummary(connection, runId) {
-    const published = readPublishedSealedRun(connection, runId);
-    if (published === undefined) {
+    const row = (0, database_ts_1.recordStatement)(connection, `SELECT r.run_id,r.writer_generation,r.started_at,
+    coalesce(r.logical_seal_identity,'published:' || (SELECT max(p.published_revision)
+      FROM ne18_attempt_publications p WHERE p.origin_run_id=r.run_id)) logical_seal_identity,
+    (SELECT count(*) FROM ne18_slots WHERE run_id=r.run_id) slot_count,
+    CASE WHEN EXISTS (SELECT 1 FROM ne18_run_resources WHERE run_id=r.run_id) THEN
+      (SELECT count(*) FROM ne18_run_slot_bindings WHERE target_run_id=r.run_id)+
+      (SELECT count(*) FROM ne18_run_slot_absences WHERE run_id=r.run_id)
+      ELSE (SELECT count(*) FROM ne18_members WHERE target_run_id=r.run_id) END member_count,
+    (SELECT count(*) FROM ne18_attempts a WHERE a.origin_run_id=r.run_id AND
+      (NOT EXISTS (SELECT 1 FROM ne18_run_resources WHERE run_id=r.run_id) OR EXISTS
+       (SELECT 1 FROM ne18_attempt_publications p WHERE p.origin_run_id=a.origin_run_id AND p.attempt_id=a.attempt_id))) attempt_count,
+    (SELECT count(*) FROM ne18_attachments a WHERE a.owner_run_id=r.run_id AND a.canonical_payload IS NOT NULL AND
+      (a.owner_kind='run' OR NOT EXISTS (SELECT 1 FROM ne18_run_resources WHERE run_id=r.run_id) OR EXISTS
+       (SELECT 1 FROM ne18_attempt_publications p WHERE p.origin_run_id=a.owner_run_id AND p.attempt_id=a.owner_attempt_id))) attachment_count,
+    (SELECT count(*) FROM ne18_contents c JOIN ne18_attachments a ON a.attachment_id=c.attachment_id
+      WHERE a.owner_run_id=r.run_id AND a.canonical_payload IS NOT NULL AND
+      (a.owner_kind='run' OR NOT EXISTS (SELECT 1 FROM ne18_run_resources WHERE run_id=r.run_id) OR EXISTS
+       (SELECT 1 FROM ne18_attempt_publications p WHERE p.origin_run_id=a.owner_run_id AND p.attempt_id=a.owner_attempt_id))) content_count,
+    (SELECT coalesce(sum(c.byte_length),0) FROM ne18_contents c JOIN ne18_attachments a ON a.attachment_id=c.attachment_id
+      WHERE a.owner_run_id=r.run_id AND a.canonical_payload IS NOT NULL AND
+      (a.owner_kind='run' OR NOT EXISTS (SELECT 1 FROM ne18_run_resources WHERE run_id=r.run_id) OR EXISTS
+       (SELECT 1 FROM ne18_attempt_publications p WHERE p.origin_run_id=a.owner_run_id AND p.attempt_id=a.owner_attempt_id))) content_bytes,
+    (SELECT count(*) FROM ne18_run_seal_entries WHERE run_id=r.run_id) seal_count
+    FROM ne18_runs r WHERE r.run_id=? AND NOT EXISTS
+      (SELECT 1 FROM ne18_run_deletion_tombstones d WHERE d.run_id=r.run_id)
+      AND (r.status='sealed' OR EXISTS (SELECT 1 FROM ne18_attempt_publications p WHERE p.origin_run_id=r.run_id))`).get(runId);
+    if (row === undefined)
         return undefined;
-    }
-    return published.summary;
+    return Object.freeze({ runId: text(row, "run_id"), writerGeneration: text(row, "writer_generation"),
+        startedAt: text(row, "started_at"), logicalSealIdentity: text(row, "logical_seal_identity"),
+        slotCount: integer(row, "slot_count"), memberCount: integer(row, "member_count"), attemptCount: integer(row, "attempt_count"),
+        attachmentCount: integer(row, "attachment_count"), contentCount: integer(row, "content_count"),
+        contentByteLength: integer(row, "content_bytes"), sealEntryCount: integer(row, "seal_count") });
+}
+/** Pinned publication identity, plus a metadata-only count; no Seal hashing. */
+function readSealedRunCutoff(connection, identity) {
+    const row = (0, database_ts_1.recordStatement)(connection, `SELECT count(*) count FROM ne18_runs r
+    WHERE NOT EXISTS (SELECT 1 FROM ne18_run_deletion_tombstones d WHERE d.run_id=r.run_id)
+      AND (status='sealed' OR EXISTS (SELECT 1 FROM ne18_attempt_publications p WHERE p.origin_run_id=r.run_id))`).get();
+    return Object.freeze({ identity, runCount: integer(row, "count") });
+}
+/** Filter lightweight Run metadata before loading any selected Core or payload. */
+function findExperimentRunIds(connection, experimentId) {
+    requireIdentity(experimentId, "experimentId");
+    const selected = rows(connection, `SELECT r.run_id FROM ne18_runs r
+    LEFT JOIN ne18_run_resources resource ON resource.run_id=r.run_id
+    WHERE coalesce(resource.experiment_id,json_extract(r.core_payload,'$.experimentId'))=?
+      AND NOT EXISTS (SELECT 1 FROM ne18_run_deletion_tombstones d WHERE d.run_id=r.run_id)
+      AND (r.status='sealed' OR EXISTS (SELECT 1 FROM ne18_attempt_publications p WHERE p.origin_run_id=r.run_id))
+    ORDER BY r.run_id LIMIT ?`, experimentId, types_ts_1.RECORD_SQLITE_MAX_VALIDATION_RUNS + 1);
+    if (selected.length > types_ts_1.RECORD_SQLITE_MAX_VALIDATION_RUNS) {
+        throw (0, errors_ts_1.sqliteError)("record-resource-limit-exceeded", "find-experiment-runs", "Experiment exceeds its Run ceiling");
+    }
+    return Object.freeze(selected.map((row) => text(row, "run_id")));
 }
 function listSealedRunSummaries(connection, afterRunId = "", pageSize = 100) {
     if (!Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > 256) {
@@ -1506,35 +1558,39 @@ function listSealedRunSummaries(connection, afterRunId = "", pageSize = 100) {
  * Computes the stable sealed cutoff without retaining the inventory, then
  * returns one bounded page from the same caller-owned read transaction.
  */
-function readSealedRunSummaryPage(connection, afterRunId = "", pageSize = 100, expectedCutoffIdentity, deadlineEpochMs = Date.now() + types_ts_1.RECORD_SQLITE_VALIDATION_DEADLINE_MS) {
+function readSealedRunSummaryPage(connection, afterRunId = "", pageSize = 100, expectedCutoffIdentity, deadlineEpochMs = Date.now() + types_ts_1.RECORD_SQLITE_VALIDATION_DEADLINE_MS, pinnedCutoff) {
     requireIdentity(afterRunId === "" ? "start" : afterRunId, "afterRunId");
     if (!Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > 256) {
         throw (0, errors_ts_1.sqliteError)("record-resource-limit-exceeded", "page-sealed-runs", "page size must be between 1 and 256");
     }
-    const cutoffHash = (0, node_crypto_1.createHash)("sha256");
-    cutoffHash.update("[");
-    let runCount = 0;
-    const inventory = (0, database_ts_1.recordStatement)(connection, `SELECT run_id,
-    coalesce(logical_seal_identity,'published:' || (SELECT max(p.published_revision) FROM ne18_attempt_publications p
-      WHERE p.origin_run_id=ne18_runs.run_id)) logical_seal_identity
-    FROM ne18_runs WHERE NOT EXISTS (SELECT 1 FROM ne18_run_deletion_tombstones d WHERE d.run_id=ne18_runs.run_id)
-      AND (status='sealed' OR EXISTS
-        (SELECT 1 FROM ne18_attempt_publications p WHERE p.origin_run_id=ne18_runs.run_id))
-    ORDER BY run_id`).iterate();
-    for (const row of inventory) {
-        if (runCount >= types_ts_1.RECORD_SQLITE_MAX_VALIDATION_RUNS) {
-            throw (0, errors_ts_1.sqliteError)("record-resource-limit-exceeded", "page-sealed-runs", "sealed cutoff exceeds its Run ceiling");
-        }
-        if ((runCount & 255) === 0 && Date.now() >= deadlineEpochMs) {
-            throw (0, errors_ts_1.sqliteError)("record-resource-limit-exceeded", "page-sealed-runs", "sealed cutoff exceeded its deadline");
-        }
-        if (runCount > 0)
-            cutoffHash.update(",");
-        cutoffHash.update(JSON.stringify({ runId: text(row, "run_id"), logicalSealIdentity: text(row, "logical_seal_identity") }));
-        runCount += 1;
-    }
-    cutoffHash.update("]");
-    const identity = cutoffHash.digest("hex");
+    const cutoff = pinnedCutoff ?? (() => {
+        const cutoffHash = (0, node_crypto_1.createHash)("sha256");
+        cutoffHash.update("[");
+        let runCount = 0;
+        const inventory = (0, database_ts_1.recordStatement)(connection, `SELECT run_id,
+      coalesce(logical_seal_identity,'published:' || (SELECT max(p.published_revision) FROM ne18_attempt_publications p
+        WHERE p.origin_run_id=ne18_runs.run_id)) logical_seal_identity
+      FROM ne18_runs WHERE NOT EXISTS (SELECT 1 FROM ne18_run_deletion_tombstones d WHERE d.run_id=ne18_runs.run_id)
+        AND (status='sealed' OR EXISTS
+          (SELECT 1 FROM ne18_attempt_publications p WHERE p.origin_run_id=ne18_runs.run_id))
+      ORDER BY run_id`).iterate();
+        for (const row of inventory) {
+            if (runCount >= types_ts_1.RECORD_SQLITE_MAX_VALIDATION_RUNS) {
+                throw (0, errors_ts_1.sqliteError)("record-resource-limit-exceeded", "page-sealed-runs", "sealed cutoff exceeds its Run ceiling");
+            }
+            if ((runCount & 255) === 0 && Date.now() >= deadlineEpochMs) {
+                throw (0, errors_ts_1.sqliteError)("record-resource-limit-exceeded", "page-sealed-runs", "sealed cutoff exceeded its deadline");
+            }
+            if (runCount > 0)
+                cutoffHash.update(",");
+            cutoffHash.update(JSON.stringify({ runId: text(row, "run_id"), logicalSealIdentity: text(row, "logical_seal_identity") }));
+            runCount += 1;
+        }
+        cutoffHash.update("]");
+        const identity = cutoffHash.digest("hex");
+        return Object.freeze({ identity, runCount });
+    })();
+    const { identity, runCount } = cutoff;
     if (expectedCutoffIdentity !== undefined && expectedCutoffIdentity !== identity) {
         throw (0, errors_ts_1.sqliteError)("record-command-conflict", "page-sealed-runs", "sealed cutoff changed; restart pagination");
     }
@@ -1648,8 +1704,15 @@ function readCollectionItemPage(connection, attachmentId, afterOrdinal, pageSize
     const nextOrdinal = hasMore ? cursor : null;
     return Object.freeze({ attachmentId, afterOrdinal, items: Object.freeze(items), nextOrdinal });
 }
-/** Bounded sealed Core projection. Collection item bytes and Content chunk bytes are never selected. */
-function readPublishedSealedRun(connection, runId) {
+function memoRecordRead(read, defer) {
+    if (defer === undefined) {
+        const value = read();
+        return () => value;
+    }
+    let cached;
+    return () => defer(() => (cached ??= { value: read() }).value);
+}
+function readPublishedSealedRun(connection, runId, defer) {
     const run = (0, database_ts_1.recordStatement)(connection, `SELECT run_id,writer_generation,started_at,status,
     coalesce(logical_seal_identity,'published:' || (SELECT max(p.published_revision) FROM ne18_attempt_publications p
       WHERE p.origin_run_id=ne18_runs.run_id)) logical_seal_identity,core_payload,core_digest,
@@ -1766,59 +1829,50 @@ function readPublishedSealedRun(connection, runId) {
             coreBytes: transferableBytes(bytes(row, "core_payload")), coreDigest: text(row, "core_digest") });
     });
     const attachmentRows = rows(connection, `SELECT attachment_id,owner_kind,owner_run_id,owner_attempt_id,family,family_revision,
-    logical_identity,canonical_payload,canonical_digest,logical_inventory,inventory_digest,
-    (SELECT count(*) FROM ne18_collection_items i WHERE i.attachment_id=a.attachment_id) item_count,
-    (SELECT coalesce(sum(length(i.canonical_payload)),0) FROM ne18_collection_items i WHERE i.attachment_id=a.attachment_id) item_bytes
+    logical_identity,canonical_digest,inventory_digest
     FROM ne18_attachments a WHERE owner_run_id=?${publicationManaged ? ` AND canonical_payload IS NOT NULL AND
       (owner_kind='run' OR EXISTS (SELECT 1 FROM ne18_attempt_publications p
         WHERE p.origin_run_id=a.owner_run_id AND p.attempt_id=a.owner_attempt_id))` : ""} ORDER BY attachment_id`, runId);
     const attachments = attachmentRows.map((row) => {
         const attachmentId = text(row, "attachment_id");
-        if (!(row.canonical_payload instanceof Uint8Array))
-            throw (0, errors_ts_1.sqliteError)("record-database-invalid", "read-published-run-core", `Attachment ${attachmentId} is not published`);
-        const references = rows(connection, `SELECT ordinal,target_owner_kind,target_family,canonical_payload,reference_digest
+        const payload = memoRecordRead(() => {
+            const stored = (0, database_ts_1.recordStatement)(connection, `SELECT canonical_payload,logical_inventory FROM ne18_attachments WHERE attachment_id=?`)
+                .get(attachmentId);
+            return { canonicalBytes: transferableBytes(bytes(stored, "canonical_payload")),
+                logicalInventoryBytes: transferableBytes(bytes(stored, "logical_inventory")) };
+        }, defer);
+        const references = memoRecordRead(() => Object.freeze(rows(connection, `SELECT ordinal,target_owner_kind,target_family,canonical_payload,reference_digest
       FROM ne18_attachment_references WHERE attachment_id=? ORDER BY ordinal`, attachmentId).map((reference) => Object.freeze({
             ordinal: integer(reference, "ordinal"), owner: ownerKind(reference, "target_owner_kind"), family: text(reference, "target_family"),
             canonicalBytes: transferableBytes(bytes(reference, "canonical_payload")), referenceDigest: text(reference, "reference_digest"),
-        }));
-        const contents = rows(connection, `SELECT content_id,logical_handle,byte_length,overall_digest,chunk_count
+        }))), defer);
+        const contents = memoRecordRead(() => Object.freeze(rows(connection, `SELECT content_id,logical_handle,byte_length,overall_digest,chunk_count
       FROM ne18_contents WHERE attachment_id=? ORDER BY content_id`, attachmentId).map((content) => Object.freeze({
             contentId: text(content, "content_id"), logicalHandle: text(content, "logical_handle"), byteLength: integer(content, "byte_length"),
             digest: text(content, "overall_digest"), chunkCount: integer(content, "chunk_count"),
-        }));
+        }))), defer);
+        const collection = memoRecordRead(() => {
+            const aggregate = (0, database_ts_1.recordStatement)(connection, `SELECT count(*) item_count,coalesce(sum(length(canonical_payload)),0) item_bytes
+        FROM ne18_collection_items WHERE attachment_id=?`).get(attachmentId);
+            return { count: integer(aggregate, "item_count"), byteLength: integer(aggregate, "item_bytes") };
+        }, defer);
         return Object.freeze({ attachmentId, ownerKind: ownerKind(row, "owner_kind"), ownerRunId: text(row, "owner_run_id"),
             ...(optionalText(row, "owner_attempt_id") === undefined ? {} : { ownerAttemptId: optionalText(row, "owner_attempt_id") }),
             family: text(row, "family"), familyRevision: integer(row, "family_revision"), logicalIdentity: text(row, "logical_identity"),
-            canonicalBytes: transferableBytes(bytes(row, "canonical_payload")), canonicalDigest: text(row, "canonical_digest"),
-            logicalInventoryBytes: transferableBytes(bytes(row, "logical_inventory")), inventoryDigest: text(row, "inventory_digest"),
-            references: Object.freeze(references), collectionItemCount: integer(row, "item_count"), collectionItemByteLength: integer(row, "item_bytes"),
-            contents: Object.freeze(contents) });
+            get canonicalBytes() { return payload().canonicalBytes; }, canonicalDigest: text(row, "canonical_digest"),
+            get logicalInventoryBytes() { return payload().logicalInventoryBytes; }, inventoryDigest: text(row, "inventory_digest"),
+            get references() { return references(); }, get contents() { return contents(); },
+            get collectionItemCount() { return collection().count; }, get collectionItemByteLength() { return collection().byteLength; } });
     });
     const core = Object.freeze({ runId: text(run, "run_id"), writerGeneration: text(run, "writer_generation"), startedAt: text(run, "started_at"),
         logicalSealIdentity: text(run, "logical_seal_identity"), ...(publicationManaged ? { publicationManaged: true, createdRevision: integer(publicationResource, "created_revision") } : {}), recordCoreBytes: transferableBytes(bytes(record, "record_payload")),
         recordCoreDigest: text(record, "record_digest"), runCoreBytes, runCoreDigest,
         slots: Object.freeze(slots), attempts: Object.freeze(attempts), members: Object.freeze(members), attachments: Object.freeze(attachments) });
-    const contentCount = core.attachments.reduce((count, attachment) => count + attachment.contents.length, 0);
-    const contentByteLength = core.attachments.reduce((count, attachment) => count + attachment.contents.reduce((subtotal, content) => subtotal + content.byteLength, 0), 0);
-    const seal = (0, database_ts_1.recordStatement)(connection, "SELECT count(*) seal_count FROM ne18_run_seal_entries WHERE run_id=?").get(runId);
-    const summary = Object.freeze({
-        runId: core.runId,
-        writerGeneration: core.writerGeneration,
-        startedAt: core.startedAt,
-        logicalSealIdentity: core.logicalSealIdentity,
-        slotCount: core.slots.length,
-        memberCount: core.members.length,
-        attemptCount: core.attempts.length,
-        attachmentCount: core.attachments.length,
-        contentCount,
-        contentByteLength,
-        sealEntryCount: integer(seal, "seal_count"),
-    });
-    return Object.freeze({ core, summary });
+    return Object.freeze({ core, get summary() { return readSealedRunSummary(connection, runId); } });
 }
-/** Compatibility-shaped Core read backed by the sole publication projection. */
-function readSealedRunCore(connection, runId) {
-    return readPublishedSealedRun(connection, runId)?.core;
+/** Inspection may defer Attachment reads within its existing pinned session. */
+function readSealedRunCore(connection, runId, defer) {
+    return readPublishedSealedRun(connection, runId, defer)?.core;
 }
 /** Fixed, decoded projection sufficient to rebuild sealed Core and attachment metadata. */
 function readSealedRunDocument(connection, runId) {