agl 40.6.0 → 41.0.0

package/dist_ts/classes.flexstore.d.ts

@@ -107,13 +107,26 @@ export interface IFlexTranscriptBuild {
     /** A record for every message the transcript lists, oldest first. */
     records: IFlexPublicMessageRecordDocument[];
 }
+/**
+ * What a transcript build asks of each message: the id of its record, the size of its JSON and
+ * its stand-in when it is oversized. A store answers from what it cached per stored message.
+ */
+export interface IFlexTranscriptMessageRecords {
+    /** The id of the public record of `messageArg` at `messageIndexArg`. */
+    recordId(messageIndexArg: number, messageArg: TFlexMessage): string;
+    /** The UTF-8 bytes of `messageArg`'s JSON. */
+    messageBytes(messageArg: TFlexMessage): number;
+    /** The public stand-in of an oversized message, within `budgetArg` serialized bytes. */
+    placeholder(messageArg: TFlexMessage, budgetArg: number): TFlexMessage;
+}
 /**
  * The public transcript of one session: its newest messages within the public bounds, a message
  * over the single-message bound reduced to a placeholder that keeps its metadata. Records are
  * addressed by their content, and `storedRecordsArg` names records already stored, so the
- * transcript lists the stored copy of every record it shares.
+ * transcript lists the stored copy of every record it shares; only the records it adds are
+ * serialized, hashed and checked.
  */
-export declare const createProjectionTranscript: (controllerIdArg: string, storageKeyArg: string, sessionIdArg: string, messagesArg: readonly TFlexMessage[], preparationArg: IFlexCandidatePreparation, storedRecordsArg?: ReadonlyMap<string, IFlexRecordManifest>, limitsArg?: IFlexTranscriptLimits) => IFlexTranscriptBuild;
+export declare const createProjectionTranscript: (controllerIdArg: string, storageKeyArg: string, sessionIdArg: string, messagesArg: readonly TFlexMessage[], preparationArg: IFlexCandidatePreparation, storedRecordsArg?: ReadonlyMap<string, IFlexRecordManifest>, limitsArg?: IFlexTranscriptLimits, recordsArg?: IFlexTranscriptMessageRecords) => IFlexTranscriptBuild;
 /** One retained session's committed projection, as a publication names it. */
 export interface IFlexPublishedProjection {
     sessionId: string;
@@ -165,10 +178,16 @@ export declare class FlexStore implements plugins.flexharness.IFlexHarnessStores
     /**
      * The snapshot of each domain head this writer last committed or loaded, keyed by head id and
      * valid while the head names the same private candidate: a save applies its change to it
-     * instead of reading the snapshot back. Only heads of storage keys this writer leases enter it.
+     * instead of reading the snapshot back, and reuses the chunks of a layout it committed. Only
+     * heads of storage keys this writer leases enter it; least recently used entries leave first.
      */
     private readonly snapshotCache;
     private snapshotCacheBytes;
+    /** Heads whose snapshot exceeds the whole snapshot cache, logged once each. */
+    private readonly uncachedSnapshotHeads;
+    private readonly publicMessageRecordIds;
+    private readonly publicMessageBytes;
+    private readonly publicMessagePlaceholders;
     /** Transcripts by id; they are addressed by their content, so a cached one never goes stale. */
     private readonly transcriptCache;
     private transcriptCacheBytes;
@@ -233,12 +252,20 @@ export declare class FlexStore implements plugins.flexharness.IFlexHarnessStores
     private deleteJobSession;
     private validateScopeSnapshot;
     private validateProjectionSnapshot;
+    /** Checks a projection snapshot in place: FlexHarness owns what a valid projection is. */
+    private assertProjectionSnapshot;
     private validatePermissionSnapshot;
     private validateAgentEventSnapshot;
     private validateAgentEventArchive;
     private validateToolJobSnapshot;
     private saveDomain;
     private loadDomainDirect;
+    /**
+     * The committed snapshot a save changes: taken out of the cache, so the save holds its layout
+     * alone, or read when `loadArg` asks for it. Undefined when the domain has no head. The caller
+     * releases it once the save ended, whatever its outcome.
+     */
+    private checkoutDomain;
     private readMigration;
     private readDomainHead;
     private readDomainHeadPage;
@@ -255,7 +282,15 @@ export declare class FlexStore implements plugins.flexharness.IFlexHarnessStores
     /** The ids among `idsArg` that `modelArg` stores for the storage key, read without documents. */
     private storedIds;
     private cachedSnapshot;
-    /** Keeps a projection or scope snapshot this writer committed or loaded, never edited after. */
+    /**
+     * Takes the cached snapshot of `headArg` out of the cache for a save, which then holds its
+     * layout until it releases it; a stale entry is dropped.
+     */
+    private takeCachedSnapshot;
+    /**
+     * Keeps a projection, scope or Agent event snapshot this writer committed or loaded, never
+     * edited after, and the layout this writer stored it in.
+     */
     private cacheSnapshot;
     private forgetCachedSnapshot;
     private forgetCachedSnapshots;
@@ -264,6 +299,8 @@ export declare class FlexStore implements plugins.flexharness.IFlexHarnessStores
      * `previousArg` or that an earlier write stored, and the records it adds.
      */
     private buildTranscript;
+    /** The record facts of a scope's messages, from this store's per-message caches. */
+    private transcriptMessageRecords;
     /**
      * Stores a transcript before the records it adds, so an interrupted write leaves a transcript no
      * head names that still names everything the write stored, and proves both.