niceeval 0.16.2 → 0.17.0

package/dist/inspection/source.cjs

@@ -16,6 +16,7 @@ const errors_ts_1 = require("../record/reader/errors.cjs");
 const protocol_ts_1 = require("../run/protocol.cjs");
 const index_ts_1 = require("../record/sqlite/index.cjs");
 const external_record_import_ts_1 = require("../record/sqlite/external-record-import.cjs");
+const cutoff_ts_1 = require("../run/storage/cutoff.cjs");
 class InspectionSourceError extends effect_1.Data.TaggedError("InspectionSourceError") {
 }
 exports.InspectionSourceError = InspectionSourceError;
@@ -81,7 +82,8 @@ function openHostOwnedInspectionSource(recordPath) {
 }
 const EMPTY_OPERATIONAL_CUTOFF = Object.freeze({
     identity: protocol_ts_1.EMPTY_PUBLICATION_CUTOFF_IDENTITY,
-    runCount: 0,
+    storeGeneration: protocol_ts_1.EMPTY_PUBLICATION_CUTOFF_IDENTITY,
+    revision: 0,
 });
 function emptyOperationalFacts() {
     return Object.freeze({
@@ -89,6 +91,11 @@ function emptyOperationalFacts() {
         cutoff: () => EMPTY_OPERATIONAL_CUTOFF,
         findExperimentRunIds: () => Object.freeze([]),
         readRunResource: () => undefined,
+        readRunResourcePage: () => Object.freeze({
+            cutoff: Object.freeze({ storeGeneration: protocol_ts_1.EMPTY_PUBLICATION_CUTOFF_IDENTITY, revision: 0 }),
+            runs: Object.freeze([]),
+            nextAfterRunId: null,
+        }),
         readSealedRunSummaryPage: (afterRunId = "", _pageSize = 100, expectedCutoffIdentity) => {
             if (expectedCutoffIdentity !== undefined && expectedCutoffIdentity !== EMPTY_OPERATIONAL_CUTOFF.identity) {
                 throw new InspectionSourceError({
@@ -97,7 +104,7 @@ function emptyOperationalFacts() {
                 });
             }
             return Object.freeze({
-                cutoff: EMPTY_OPERATIONAL_CUTOFF,
+                cutoff: Object.freeze({ identity: EMPTY_OPERATIONAL_CUTOFF.identity, runCount: 0 }),
                 afterRunId,
                 summaries: Object.freeze([]),
                 nextAfterRunId: null,
@@ -124,23 +131,15 @@ function emptyOperationalFacts() {
     });
 }
 function sessionFacts(session, kind) {
-    let observedCutoff;
-    const remember = (page) => {
-        if (observedCutoff !== undefined && observedCutoff.identity !== page.cutoff.identity) {
-            throw new InspectionSourceError({
-                code: "inspection-source-invalid",
-                reason: "Pinned Record session changed its sealed cutoff.",
-            });
-        }
-        observedCutoff = page.cutoff;
-        return page;
-    };
-    const readPage = (afterRunId = "", pageSize = 100, expectedCutoffIdentity) => remember(session.readSealedRunSummaryPage(afterRunId, pageSize, expectedCutoffIdentity ?? observedCutoff?.identity));
+    const publication = session.publicationCutoff();
+    const cutoff = Object.freeze({ ...publication, identity: (0, cutoff_ts_1.publicationCutoffIdentity)(publication) });
+    const readPage = (afterRunId = "", pageSize = 100, expectedCutoffIdentity) => session.readSealedRunSummaryPage(afterRunId, pageSize, expectedCutoffIdentity ?? cutoff.identity);
     return Object.freeze({
         kind,
-        cutoff: () => observedCutoff ??= session.sealedCutoff(),
+        cutoff: () => cutoff,
         findExperimentRunIds: session.findExperimentRunIds,
         readRunResource: (runId) => session.readRunResource(runId),
+        readRunResourcePage: (afterRunId = "", pageSize = 100) => session.listRunResources({ afterRunId, pageSize }),
         readSealedRunSummaryPage: readPage,
         findAttemptLocatorCandidates: (locator, maximumCandidateRuns) => session.findAttemptLocatorCandidates(locator, maximumCandidateRuns),
         readSealedRunCore: (runId) => session.readSealedRunCore(runId, true),

package/dist/inspection/source.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"source.js","sourceRoot":"","sources":["source.ts"],"names":[],"mappings":"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","sourcesContent":["// @concord-file ne-eval-inspection-source\n// @concord-implements docs/feature/inspection/README.md\n// @concord-implements docs/feature/inspection/architecture.md\n// @concord-implements docs/feature/insight/README.md\nimport { existsSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { Data, Effect } from \"effect\";\nimport type * as Scope from \"effect/Scope\";\nimport { RecordIntegrityFailure } from \"../record/reader/errors.ts\";\nimport { EMPTY_PUBLICATION_CUTOFF_IDENTITY } from \"../run/protocol.ts\";\nimport { openHostOwnedRecordReadSession, acquireProjectRecordReadSession, RECORD_SQLITE_VALIDATION_DEADLINE_MS, type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type PinnedRecordReadSession, type SealedRunCore, type SealedRunCutoff, type SealedRunSummaryPage, } from \"../record/sqlite/index.ts\";\nimport { startExternalRecordImport } from \"../record/sqlite/external-record-import.ts\";\nimport type { ReadableRunResource } from \"../run/storage/types.ts\";\nexport type InspectionSource = {\n    readonly kind: \"project-record\";\n    readonly databasePath: string;\n} | {\n    readonly kind: \"external-record\";\n    readonly recordPath: string;\n};\nexport class InspectionSourceError extends Data.TaggedError(\"InspectionSourceError\")<{\n    readonly code: \"inspection-source-invalid\";\n    readonly reason: string;\n    readonly cause?: unknown;\n}> {\n}\n/** Safe Inspection identity for a Record publication that is not closed. */\nexport class InspectionIntegrityError extends Data.TaggedError(\"InspectionIntegrityError\")<{\n    readonly code: \"inspection-record-integrity-failure\";\n    readonly runId: string;\n}> {\n}\n/** Browser-neutral fixed reader capability backed by one pinned Record generation. */\nexport interface InspectionFactSource {\n    readonly kind: InspectionSource[\"kind\"];\n    readonly cutoff: () => SealedRunCutoff;\n    readonly findExperimentRunIds: (experimentId: string) => readonly string[];\n    readonly readRunResource: (runId: string) => ReadableRunResource | undefined;\n    readonly readSealedRunSummaryPage: (afterRunId?: string, pageSize?: number, expectedCutoffIdentity?: string) => SealedRunSummaryPage;\n    readonly findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => AttemptLocatorCandidates;\n    readonly readSealedRunCore: (runId: string) => SealedRunCore | undefined;\n    readonly readContentPage: (contentId: string, afterOrdinal: number, pageSize: number) => ContentChunkPage;\n    readonly readCollectionPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => CollectionItemPage;\n}\n/** Pure source selection; opening and validation happen only inside a Scope. */\nexport function operationalInspectionSource(cwd: string): InspectionSource {\n    return Object.freeze({\n        kind: \"project-record\" as const,\n        databasePath: resolve(cwd, \".niceeval/record.sqlite\"),\n    });\n}\nexport function externalInspectionSource(cwd: string, pathname: string): InspectionSource {\n    return Object.freeze({\n        kind: \"external-record\" as const,\n        recordPath: resolve(cwd, pathname),\n    });\n}\n/**\n * Acquires exactly one pinned Record reader. Every fixed operation in the\n * returned source sees the same generation, and Scope closes the session on\n * success, typed failure, defect, or interruption.\n */\nexport function openInspectionSource(source: InspectionSource): Effect.Effect<InspectionFactSource, InspectionSourceError | InspectionIntegrityError, Scope.Scope> {\n    return Effect.gen(function* () {\n        let session: PinnedRecordReadSession;\n        if (source.kind === \"project-record\") {\n            if (!existsSync(source.databasePath))\n                return emptyOperationalFacts();\n            session = yield* acquireProjectRecordReadSession(dirname(source.databasePath)).pipe(Effect.mapError(sourceError));\n        }\n        else {\n            const importDeadline = Date.now() + RECORD_SQLITE_VALIDATION_DEADLINE_MS;\n            const importer = yield* Effect.acquireRelease(Effect.try({\n                try: () => startExternalRecordImport(source.recordPath, importDeadline),\n                catch: (cause) => sourceError(cause),\n            }), (handle) => Effect.promise(() => handle.close().catch(() => undefined)));\n            const generation = yield* Effect.tryPromise({\n                // Declaring the AbortSignal keeps this await interruptible. Scope then\n                // terminates the Worker and removes its private generation.\n                try: (_signal) => importer.result,\n                catch: (cause) => sourceError(cause),\n            });\n            session = yield* Effect.acquireRelease(Effect.try({\n                try: () => openHostOwnedRecordReadSession(generation.path),\n                catch: (cause) => sourceError(cause),\n            }), (opened) => Effect.sync(() => opened.close()));\n        }\n        return sessionFacts(session, source.kind);\n    });\n}\n/** Opens one already-imported private generation without accepting a public path. */\nexport function openHostOwnedInspectionSource(recordPath: string): Effect.Effect<InspectionFactSource, InspectionSourceError | InspectionIntegrityError, Scope.Scope> {\n    return Effect.gen(function* () {\n        const session = yield* Effect.acquireRelease(Effect.try({\n            try: () => openHostOwnedRecordReadSession(recordPath),\n            catch: (cause) => sourceError(cause),\n        }), (opened) => Effect.sync(() => opened.close()));\n        return sessionFacts(session, \"external-record\");\n    });\n}\nconst EMPTY_OPERATIONAL_CUTOFF = Object.freeze({\n    identity: EMPTY_PUBLICATION_CUTOFF_IDENTITY,\n    runCount: 0,\n});\nfunction emptyOperationalFacts(): InspectionFactSource {\n    return Object.freeze({\n        kind: \"project-record\" as const,\n        cutoff: () => EMPTY_OPERATIONAL_CUTOFF,\n        findExperimentRunIds: () => Object.freeze([]),\n        readRunResource: () => undefined,\n        readSealedRunSummaryPage: (afterRunId = \"\", _pageSize = 100, expectedCutoffIdentity?: string) => {\n            if (expectedCutoffIdentity !== undefined && expectedCutoffIdentity !== EMPTY_OPERATIONAL_CUTOFF.identity) {\n                throw new InspectionSourceError({\n                    code: \"inspection-source-invalid\",\n                    reason: \"The empty operational publication cutoff changed; restart pagination.\",\n                });\n            }\n            return Object.freeze({\n                cutoff: EMPTY_OPERATIONAL_CUTOFF,\n                afterRunId,\n                summaries: Object.freeze([]),\n                nextAfterRunId: null,\n            });\n        },\n        findAttemptLocatorCandidates: (locator: string) => Object.freeze({\n            locator,\n            ambiguous: false,\n            candidates: Object.freeze([]),\n        }),\n        readSealedRunCore: () => undefined,\n        readContentPage: (contentId: string, afterOrdinal: number) => Object.freeze({\n            contentId,\n            afterOrdinal,\n            chunks: Object.freeze([]),\n            nextOrdinal: null,\n        }),\n        readCollectionPage: (attachmentId: string, afterOrdinal: number) => Object.freeze({\n            attachmentId,\n            afterOrdinal,\n            items: Object.freeze([]),\n            nextOrdinal: null,\n        }),\n    });\n}\nfunction sessionFacts(session: PinnedRecordReadSession, kind: InspectionSource[\"kind\"]): InspectionFactSource {\n    let observedCutoff: SealedRunCutoff | undefined;\n    const remember = (page: SealedRunSummaryPage): SealedRunSummaryPage => {\n        if (observedCutoff !== undefined && observedCutoff.identity !== page.cutoff.identity) {\n            throw new InspectionSourceError({\n                code: \"inspection-source-invalid\",\n                reason: \"Pinned Record session changed its sealed cutoff.\",\n            });\n        }\n        observedCutoff = page.cutoff;\n        return page;\n    };\n    const readPage = (afterRunId = \"\", pageSize = 100, expectedCutoffIdentity?: string): SealedRunSummaryPage => remember(session.readSealedRunSummaryPage(afterRunId, pageSize, expectedCutoffIdentity ?? observedCutoff?.identity));\n    return Object.freeze({\n        kind,\n        cutoff: () => observedCutoff ??= session.sealedCutoff(),\n        findExperimentRunIds: session.findExperimentRunIds,\n        readRunResource: (runId: string) => session.readRunResource(runId),\n        readSealedRunSummaryPage: readPage,\n        findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => session.findAttemptLocatorCandidates(locator, maximumCandidateRuns),\n        readSealedRunCore: (runId: string) => session.readSealedRunCore(runId, true),\n        readContentPage: (contentId: string, afterOrdinal: number, pageSize: number) => session.readContentChunkPage(contentId, afterOrdinal, pageSize),\n        readCollectionPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => session.readCollectionItemPage(attachmentId, afterOrdinal, pageSize),\n    });\n}\nfunction sourceError(cause: unknown): InspectionSourceError | InspectionIntegrityError {\n    if (cause instanceof RecordIntegrityFailure) {\n        return new InspectionIntegrityError({\n            code: \"inspection-record-integrity-failure\",\n            runId: cause.runId,\n        });\n    }\n    return new InspectionSourceError({\n        code: \"inspection-source-invalid\",\n        reason: cause instanceof Error ? cause.message : \"Record source validation failed\",\n        cause,\n    });\n}\n"]}
+{"version":3,"file":"source.js","sourceRoot":"","sources":["source.ts"],"names":[],"mappings":"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","sourcesContent":["// @concord-file ne-eval-inspection-source\n// @concord-implements docs/feature/inspection/README.md\n// @concord-implements docs/feature/inspection/architecture.md\n// @concord-implements docs/feature/insight/README.md\nimport { existsSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { Data, Effect } from \"effect\";\nimport type * as Scope from \"effect/Scope\";\nimport { RecordIntegrityFailure } from \"../record/reader/errors.ts\";\nimport { EMPTY_PUBLICATION_CUTOFF_IDENTITY } from \"../run/protocol.ts\";\nimport { openHostOwnedRecordReadSession, acquireProjectRecordReadSession, RECORD_SQLITE_VALIDATION_DEADLINE_MS, type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type PinnedRecordReadSession, type SealedRunCore, type SealedRunSummaryPage, } from \"../record/sqlite/index.ts\";\nimport { startExternalRecordImport } from \"../record/sqlite/external-record-import.ts\";\nimport { publicationCutoffIdentity } from \"../run/storage/cutoff.ts\";\nimport type { PublicationCutoff, ReadableRunResource, RunResourcePage } from \"../run/storage/types.ts\";\nexport type InspectionSource = {\n    readonly kind: \"project-record\";\n    readonly databasePath: string;\n} | {\n    readonly kind: \"external-record\";\n    readonly recordPath: string;\n};\nexport class InspectionSourceError extends Data.TaggedError(\"InspectionSourceError\")<{\n    readonly code: \"inspection-source-invalid\";\n    readonly reason: string;\n    readonly cause?: unknown;\n}> {\n}\n/** Safe Inspection identity for a Record publication that is not closed. */\nexport class InspectionIntegrityError extends Data.TaggedError(\"InspectionIntegrityError\")<{\n    readonly code: \"inspection-record-integrity-failure\";\n    readonly runId: string;\n}> {\n}\n/** Browser-neutral fixed reader capability backed by one pinned Record generation. */\nexport interface InspectionFactSource {\n    readonly kind: InspectionSource[\"kind\"];\n    readonly cutoff: () => PublicationCutoff & {\n        readonly identity: string;\n    };\n    readonly findExperimentRunIds: (experimentId: string) => readonly string[];\n    readonly readRunResource: (runId: string) => ReadableRunResource | undefined;\n    readonly readRunResourcePage: (afterRunId?: string, pageSize?: number) => RunResourcePage;\n    readonly readSealedRunSummaryPage: (afterRunId?: string, pageSize?: number, expectedCutoffIdentity?: string) => SealedRunSummaryPage;\n    readonly findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => AttemptLocatorCandidates;\n    readonly readSealedRunCore: (runId: string) => SealedRunCore | undefined;\n    readonly readContentPage: (contentId: string, afterOrdinal: number, pageSize: number) => ContentChunkPage;\n    readonly readCollectionPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => CollectionItemPage;\n}\n/** Pure source selection; opening and validation happen only inside a Scope. */\nexport function operationalInspectionSource(cwd: string): InspectionSource {\n    return Object.freeze({\n        kind: \"project-record\" as const,\n        databasePath: resolve(cwd, \".niceeval/record.sqlite\"),\n    });\n}\nexport function externalInspectionSource(cwd: string, pathname: string): InspectionSource {\n    return Object.freeze({\n        kind: \"external-record\" as const,\n        recordPath: resolve(cwd, pathname),\n    });\n}\n/**\n * Acquires exactly one pinned Record reader. Every fixed operation in the\n * returned source sees the same generation, and Scope closes the session on\n * success, typed failure, defect, or interruption.\n */\nexport function openInspectionSource(source: InspectionSource): Effect.Effect<InspectionFactSource, InspectionSourceError | InspectionIntegrityError, Scope.Scope> {\n    return Effect.gen(function* () {\n        let session: PinnedRecordReadSession;\n        if (source.kind === \"project-record\") {\n            if (!existsSync(source.databasePath))\n                return emptyOperationalFacts();\n            session = yield* acquireProjectRecordReadSession(dirname(source.databasePath)).pipe(Effect.mapError(sourceError));\n        }\n        else {\n            const importDeadline = Date.now() + RECORD_SQLITE_VALIDATION_DEADLINE_MS;\n            const importer = yield* Effect.acquireRelease(Effect.try({\n                try: () => startExternalRecordImport(source.recordPath, importDeadline),\n                catch: (cause) => sourceError(cause),\n            }), (handle) => Effect.promise(() => handle.close().catch(() => undefined)));\n            const generation = yield* Effect.tryPromise({\n                // Declaring the AbortSignal keeps this await interruptible. Scope then\n                // terminates the Worker and removes its private generation.\n                try: (_signal) => importer.result,\n                catch: (cause) => sourceError(cause),\n            });\n            session = yield* Effect.acquireRelease(Effect.try({\n                try: () => openHostOwnedRecordReadSession(generation.path),\n                catch: (cause) => sourceError(cause),\n            }), (opened) => Effect.sync(() => opened.close()));\n        }\n        return sessionFacts(session, source.kind);\n    });\n}\n/** Opens one already-imported private generation without accepting a public path. */\nexport function openHostOwnedInspectionSource(recordPath: string): Effect.Effect<InspectionFactSource, InspectionSourceError | InspectionIntegrityError, Scope.Scope> {\n    return Effect.gen(function* () {\n        const session = yield* Effect.acquireRelease(Effect.try({\n            try: () => openHostOwnedRecordReadSession(recordPath),\n            catch: (cause) => sourceError(cause),\n        }), (opened) => Effect.sync(() => opened.close()));\n        return sessionFacts(session, \"external-record\");\n    });\n}\nconst EMPTY_OPERATIONAL_CUTOFF = Object.freeze({\n    identity: EMPTY_PUBLICATION_CUTOFF_IDENTITY,\n    storeGeneration: EMPTY_PUBLICATION_CUTOFF_IDENTITY,\n    revision: 0,\n});\nfunction emptyOperationalFacts(): InspectionFactSource {\n    return Object.freeze({\n        kind: \"project-record\" as const,\n        cutoff: () => EMPTY_OPERATIONAL_CUTOFF,\n        findExperimentRunIds: () => Object.freeze([]),\n        readRunResource: () => undefined,\n        readRunResourcePage: () => Object.freeze({\n            cutoff: Object.freeze({ storeGeneration: EMPTY_PUBLICATION_CUTOFF_IDENTITY, revision: 0 }),\n            runs: Object.freeze([]),\n            nextAfterRunId: null,\n        }),\n        readSealedRunSummaryPage: (afterRunId = \"\", _pageSize = 100, expectedCutoffIdentity?: string) => {\n            if (expectedCutoffIdentity !== undefined && expectedCutoffIdentity !== EMPTY_OPERATIONAL_CUTOFF.identity) {\n                throw new InspectionSourceError({\n                    code: \"inspection-source-invalid\",\n                    reason: \"The empty operational publication cutoff changed; restart pagination.\",\n                });\n            }\n            return Object.freeze({\n                cutoff: Object.freeze({ identity: EMPTY_OPERATIONAL_CUTOFF.identity, runCount: 0 }),\n                afterRunId,\n                summaries: Object.freeze([]),\n                nextAfterRunId: null,\n            });\n        },\n        findAttemptLocatorCandidates: (locator: string) => Object.freeze({\n            locator,\n            ambiguous: false,\n            candidates: Object.freeze([]),\n        }),\n        readSealedRunCore: () => undefined,\n        readContentPage: (contentId: string, afterOrdinal: number) => Object.freeze({\n            contentId,\n            afterOrdinal,\n            chunks: Object.freeze([]),\n            nextOrdinal: null,\n        }),\n        readCollectionPage: (attachmentId: string, afterOrdinal: number) => Object.freeze({\n            attachmentId,\n            afterOrdinal,\n            items: Object.freeze([]),\n            nextOrdinal: null,\n        }),\n    });\n}\nfunction sessionFacts(session: PinnedRecordReadSession, kind: InspectionSource[\"kind\"]): InspectionFactSource {\n    const publication = session.publicationCutoff();\n    const cutoff = Object.freeze({ ...publication, identity: publicationCutoffIdentity(publication) });\n    const readPage = (afterRunId = \"\", pageSize = 100, expectedCutoffIdentity?: string): SealedRunSummaryPage => session.readSealedRunSummaryPage(afterRunId, pageSize, expectedCutoffIdentity ?? cutoff.identity);\n    return Object.freeze({\n        kind,\n        cutoff: () => cutoff,\n        findExperimentRunIds: session.findExperimentRunIds,\n        readRunResource: (runId: string) => session.readRunResource(runId),\n        readRunResourcePage: (afterRunId = \"\", pageSize = 100) => session.listRunResources({ afterRunId, pageSize }),\n        readSealedRunSummaryPage: readPage,\n        findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => session.findAttemptLocatorCandidates(locator, maximumCandidateRuns),\n        readSealedRunCore: (runId: string) => session.readSealedRunCore(runId, true),\n        readContentPage: (contentId: string, afterOrdinal: number, pageSize: number) => session.readContentChunkPage(contentId, afterOrdinal, pageSize),\n        readCollectionPage: (attachmentId: string, afterOrdinal: number, pageSize: number) => session.readCollectionItemPage(attachmentId, afterOrdinal, pageSize),\n    });\n}\nfunction sourceError(cause: unknown): InspectionSourceError | InspectionIntegrityError {\n    if (cause instanceof RecordIntegrityFailure) {\n        return new InspectionIntegrityError({\n            code: \"inspection-record-integrity-failure\",\n            runId: cause.runId,\n        });\n    }\n    return new InspectionSourceError({\n        code: \"inspection-source-invalid\",\n        reason: cause instanceof Error ? cause.message : \"Record source validation failed\",\n        cause,\n    });\n}\n"]}

package/dist/inspection/source.d.cts

@@ -1,7 +1,7 @@
 import { Effect } from "effect";
 import type * as Scope from "effect/Scope";
-import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunCore, type SealedRunCutoff, type SealedRunSummaryPage } from "../record/sqlite/index.cjs";
-import type { ReadableRunResource } from "../run/storage/types.cjs";
+import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunCore, type SealedRunSummaryPage } from "../record/sqlite/index.cjs";
+import type { PublicationCutoff, ReadableRunResource, RunResourcePage } from "../run/storage/types.cjs";
 export type InspectionSource = {
     readonly kind: "project-record";
     readonly databasePath: string;
@@ -30,9 +30,12 @@ export declare class InspectionIntegrityError extends InspectionIntegrityError_b
 /** Browser-neutral fixed reader capability backed by one pinned Record generation. */
 export interface InspectionFactSource {
     readonly kind: InspectionSource["kind"];
-    readonly cutoff: () => SealedRunCutoff;
+    readonly cutoff: () => PublicationCutoff & {
+        readonly identity: string;
+    };
     readonly findExperimentRunIds: (experimentId: string) => readonly string[];
     readonly readRunResource: (runId: string) => ReadableRunResource | undefined;
+    readonly readRunResourcePage: (afterRunId?: string, pageSize?: number) => RunResourcePage;
     readonly readSealedRunSummaryPage: (afterRunId?: string, pageSize?: number, expectedCutoffIdentity?: string) => SealedRunSummaryPage;
     readonly findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => AttemptLocatorCandidates;
     readonly readSealedRunCore: (runId: string) => SealedRunCore | undefined;

package/dist/inspection/source.d.mts

@@ -1,7 +1,7 @@
 import { Effect } from "effect";
 import type * as Scope from "effect/Scope";
-import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunCore, type SealedRunCutoff, type SealedRunSummaryPage } from "../record/sqlite/index.mjs";
-import type { ReadableRunResource } from "../run/storage/types.mjs";
+import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunCore, type SealedRunSummaryPage } from "../record/sqlite/index.mjs";
+import type { PublicationCutoff, ReadableRunResource, RunResourcePage } from "../run/storage/types.mjs";
 export type InspectionSource = {
     readonly kind: "project-record";
     readonly databasePath: string;
@@ -30,9 +30,12 @@ export declare class InspectionIntegrityError extends InspectionIntegrityError_b
 /** Browser-neutral fixed reader capability backed by one pinned Record generation. */
 export interface InspectionFactSource {
     readonly kind: InspectionSource["kind"];
-    readonly cutoff: () => SealedRunCutoff;
+    readonly cutoff: () => PublicationCutoff & {
+        readonly identity: string;
+    };
     readonly findExperimentRunIds: (experimentId: string) => readonly string[];
     readonly readRunResource: (runId: string) => ReadableRunResource | undefined;
+    readonly readRunResourcePage: (afterRunId?: string, pageSize?: number) => RunResourcePage;
     readonly readSealedRunSummaryPage: (afterRunId?: string, pageSize?: number, expectedCutoffIdentity?: string) => SealedRunSummaryPage;
     readonly findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => AttemptLocatorCandidates;
     readonly readSealedRunCore: (runId: string) => SealedRunCore | undefined;

package/dist/inspection/source.d.ts

@@ -1,7 +1,7 @@
 import { Effect } from "effect";
 import type * as Scope from "effect/Scope";
-import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunCore, type SealedRunCutoff, type SealedRunSummaryPage } from "../record/sqlite/index.js";
-import type { ReadableRunResource } from "../run/storage/types.js";
+import { type AttemptLocatorCandidates, type CollectionItemPage, type ContentChunkPage, type SealedRunCore, type SealedRunSummaryPage } from "../record/sqlite/index.js";
+import type { PublicationCutoff, ReadableRunResource, RunResourcePage } from "../run/storage/types.js";
 export type InspectionSource = {
     readonly kind: "project-record";
     readonly databasePath: string;
@@ -30,9 +30,12 @@ export declare class InspectionIntegrityError extends InspectionIntegrityError_b
 /** Browser-neutral fixed reader capability backed by one pinned Record generation. */
 export interface InspectionFactSource {
     readonly kind: InspectionSource["kind"];
-    readonly cutoff: () => SealedRunCutoff;
+    readonly cutoff: () => PublicationCutoff & {
+        readonly identity: string;
+    };
     readonly findExperimentRunIds: (experimentId: string) => readonly string[];
     readonly readRunResource: (runId: string) => ReadableRunResource | undefined;
+    readonly readRunResourcePage: (afterRunId?: string, pageSize?: number) => RunResourcePage;
     readonly readSealedRunSummaryPage: (afterRunId?: string, pageSize?: number, expectedCutoffIdentity?: string) => SealedRunSummaryPage;
     readonly findAttemptLocatorCandidates: (locator: string, maximumCandidateRuns: number) => AttemptLocatorCandidates;
     readonly readSealedRunCore: (runId: string) => SealedRunCore | undefined;

package/dist/inspection/trace.cjs

@@ -1105,7 +1105,7 @@ function projectApplicationUsage(attachments, models) {
         const read = readAdapterUsageAttachment(attachments.adapterUsage, models);
         const modelUsage = (0, adapter_usage_projection_ts_1.projectAdapterModelUsage)(read.state === "available" ? read.value : null, models, {
             basis: "recorded-calls", reason: read.state === "invalid" ? "source-invalid" : "usage-not-recorded",
-        });
+        }, attachments.adapterUsage.physical.familyRevision === 4);
         const empty = {
             source: "adapter",
             coverage: "recorded-calls",