@modelprofile.com/flexharness 10.15.1 → 10.16.0

package/ts_stores_nosqldb/classes.nosqldbstores.ts

@@ -11,16 +11,19 @@ import type {
   IFlexProjectManagementWriteContext,
   IFlexProjectionSnapshotV3,
   IFlexProjectionStore,
+  IFlexResultStore,
   IFlexScopeSnapshot,
   IFlexScopeStore,
   IFlexToolJobStoreProvider,
   TFlexProjectionSnapshot,
   TFlexProjectManagementRecord,
+  TJsonValue,
 } from '../ts/interfaces.js';
 import {
   assertFlexPermissionSnapshot,
   assertFlexProjectionSnapshot,
   assertFlexScopeSnapshot,
+  assertJsonSerializable,
 } from '../ts/utils.json.js';
 import {
   assertFlexProjectManagementRecord,
@@ -297,7 +300,7 @@ class NoSqlAgentEventStore implements plugins.IAgentEventStoreV2 {
       domain: 'agentEventArchive' as const,
       storageKey: this.storageKey,
       sessionId: this.sessionId,
-      archiveId: archive.archiveId,
+      entryId: archive.archiveId,
     };
     await this.records.mutate(address, {
       validate: (value) => validateAgentEventArchive(value, this.sessionId, archive.archiveId),
@@ -318,7 +321,7 @@ class NoSqlAgentEventStore implements plugins.IAgentEventStoreV2 {
     this.assertSession(sessionId);
     validateIdentifier(archiveId, 'archiveId');
     return this.records.read(
-      { domain: 'agentEventArchive', storageKey: this.storageKey, sessionId, archiveId },
+      { domain: 'agentEventArchive', storageKey: this.storageKey, sessionId, entryId: archiveId },
       (value) => validateAgentEventArchive(value, this.sessionId, archiveId),
     );
   }
@@ -428,6 +431,38 @@ export interface INoSqlFlexHarnessStoresOptions {
   operationTimeoutMs?: number;
 }
 
+class NoSqlResultStore implements IFlexResultStore {
+  constructor(private readonly records: FlexRecordStore) {}
+
+  public async save(storageKey: string, sessionId: string, handle: string, value: TJsonValue): Promise<void> {
+    validateIdentifier(handle, 'handle');
+    assertJsonSerializable(value);
+    const conflict = () => new FlexHarnessStoreConflictError(`${providerKey(storageKey, sessionId)}:${handle}`, 0, 1);
+    await this.records.mutate({ domain: 'result', storageKey, sessionId, entryId: handle }, {
+      validate: validateResult,
+      decide: (current) => {
+        if (current !== undefined) throw conflict();
+        return { revision: 1, value };
+      },
+      contention: conflict,
+    });
+  }
+
+  public load(storageKey: string, sessionId: string, handle: string): Promise<TJsonValue | undefined> {
+    validateIdentifier(handle, 'handle');
+    return this.records.read({ domain: 'result', storageKey, sessionId, entryId: handle }, validateResult);
+  }
+
+  public deleteSession(storageKey: string, sessionId: string): Promise<void> {
+    return this.records.deleteOwner(storageKey, sessionId, ['result']);
+  }
+}
+
+function validateResult(value: unknown): TJsonValue {
+  assertJsonSerializable(value);
+  return value as TJsonValue;
+}
+
 /**
  * Every FlexHarness persistence domain on `@lossless.org/client/nosqldb`, with compare-and-swap
  * that holds across processes. Records live in `flexharness_records`; payloads longer than one
@@ -440,6 +475,7 @@ export class NoSqlFlexHarnessStores implements IFlexHarnessStores {
   public readonly projectManagement: IFlexProjectManagementStore;
   public readonly agentEvents: IFlexAgentEventStoreProvider;
   public readonly jobs: IFlexToolJobStoreProvider;
+  public readonly results: IFlexResultStore;
   private readonly records: FlexRecordStore;
 
   constructor(options: INoSqlFlexHarnessStoresOptions) {
@@ -453,6 +489,7 @@ export class NoSqlFlexHarnessStores implements IFlexHarnessStores {
     this.projectManagement = new NoSqlProjectManagementStore(this.records);
     this.agentEvents = new NoSqlAgentEventStoreProvider(this.records);
     this.jobs = new NoSqlToolJobStoreProvider(this.records);
+    this.results = new NoSqlResultStore(this.records);
   }
 
   /**

package/ts_stores_nosqldb/classes.recordstore.ts

@@ -12,14 +12,16 @@ export type TFlexRecordDomain =
   | 'projectManagement'
   | 'agentEvents'
   | 'agentEventArchive'
-  | 'jobs';
+  | 'jobs'
+  | 'result';
 
-/** Names one record: a domain snapshot of a storage key, a session or an archive. */
+/** Names one record: a domain snapshot of a storage key or a session, or one entry of a session. */
 export interface IFlexRecordAddress {
   domain: TFlexRecordDomain;
   storageKey: string;
   sessionId?: string;
-  archiveId?: string;
+  /** The archive or result the record holds. */
+  entryId?: string;
 }
 
 /** The next stored value a mutation decided on. */
@@ -256,7 +258,7 @@ export class FlexRecordStore {
       address.domain,
       address.storageKey,
       address.sessionId ?? null,
-      address.archiveId ?? null,
+      address.entryId ?? null,
     ]));
     return {
       recordId,