@modelprofile.com/flexharness 9.6.1 → 9.7.0

package/ts/utils.harnessoptions.ts

@@ -61,7 +61,7 @@ const defaultReversionMaintenanceTimeoutMs = 30_000;
 const maximumReversionMaintenanceTimeoutMs = 30 * 60 * 1000;
 
 export function normalizeSubagents(
-  definitions: IFlexSubagentDefinition[] | undefined,
+  definitions: readonly IFlexSubagentDefinition[] | undefined,
 ): ReadonlyMap<string, Readonly<IFlexSubagentDefinition>> {
   if (definitions === undefined) return new Map();
   if (!Array.isArray(definitions) || definitions.length > maxSubagentDefinitions) {

package/ts/utils.json.ts

@@ -20,6 +20,7 @@ import type {
   TFlexAgentModelMessage,
   TJsonValue,
 } from './interfaces.js';
+import { isValidSessionConfigurationRef } from './utils.validation.js';
 
 const DEFAULT_MAX_DEPTH = 12;
 const DEFAULT_MAX_BYTES = 256 * 1024;
@@ -483,6 +484,7 @@ function validateSession(value: unknown, path: string): IValidatedSessionIdentit
       'sessionId',
       'sessionGenerationId',
       'sessionGenerationSequence',
+      'configurationRef',
       'title',
       'createdAt',
       'updatedAt',
@@ -502,6 +504,9 @@ function validateSession(value: unknown, path: string): IValidatedSessionIdentit
   if (session.origin !== undefined) validateSessionOrigin(session.origin, `${path}.origin`);
   const sessionId = requireString(session.sessionId, `${path}.sessionId`);
   const generation = validateOptionalSessionGeneration(session, path);
+  if (session.configurationRef !== undefined && !isValidSessionConfigurationRef(session.configurationRef)) {
+    throw new FlexHarnessStoreFormatError(`${path}.configurationRef is invalid.`);
+  }
   requireOptionalString(session.title, `${path}.title`);
   requireString(session.createdAt, `${path}.createdAt`);
   requireString(session.updatedAt, `${path}.updatedAt`);
@@ -545,6 +550,7 @@ function validateSession(value: unknown, path: string): IValidatedSessionIdentit
   return {
     sessionId,
     ...generation,
+    ...(session.configurationRef === undefined ? {} : { configurationRef: session.configurationRef as string }),
     ...(relationshipCount === 0
       ? {}
       : {
@@ -689,6 +695,7 @@ interface IValidatedSessionIdentity {
   sessionId: string;
   sessionGenerationId?: string;
   sessionGenerationSequence?: number;
+  configurationRef?: string;
   parentSessionId?: string;
   parentRunId?: string;
   parentToolCallId?: string;
@@ -889,6 +896,11 @@ export function assertFlexScopeSnapshot(value: unknown): asserts value is IFlexS
         `Snapshot child session "${session.sessionId}" has no live parent "${session.parentSessionId}".`,
       );
     }
+    if (session.configurationRef !== parent.configurationRef) {
+      throw new FlexHarnessStoreFormatError(
+        `Snapshot child session "${session.sessionId}" has a different configurationRef from its parent.`,
+      );
+    }
     const expectedDepth = (parent.depth ?? 0) + 1;
     if (session.depth !== expectedDepth) {
       throw new FlexHarnessStoreFormatError(

package/ts/utils.validation.ts

@@ -4,6 +4,7 @@ import {
   FLEX_PROJECT_MANAGEMENT_LIMITS,
   FLEX_SESSION_GENERATION_COHORT_MAX_ENTRIES,
   FLEX_SESSION_GENERATION_ID_MAX_BYTES,
+  FLEX_SESSION_CONFIGURATION_REF_MAX_BYTES,
 } from './interfaces.js';
 import type {
   IFlexCompactSessionOptions,
@@ -23,6 +24,24 @@ const maxProjectedErrorNameBytes = 128;
 const maxProjectedErrorMessageBytes = 2048;
 const maxProjectedErrorCodeBytes = 128;
 const controlCharacterPattern = /[\u0000-\u001f\u007f]/u;
+const configurationControlCharacterPattern = /[\u0000-\u001f\u007f-\u009f]/u;
+const unpairedSurrogatePattern = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/u;
+
+export function isValidSessionConfigurationRef(value: unknown): value is string {
+  return typeof value === 'string'
+    && Boolean(value.trim())
+    && Buffer.byteLength(value, 'utf8') <= FLEX_SESSION_CONFIGURATION_REF_MAX_BYTES
+    && !configurationControlCharacterPattern.test(value)
+    && !unpairedSurrogatePattern.test(value);
+}
+
+export function validateSessionConfigurationRef(value: unknown): asserts value is string {
+  if (!isValidSessionConfigurationRef(value)) {
+    throw new FlexHarnessValidationError(
+      `configurationRef must be a non-empty well-formed string without control characters of at most ${FLEX_SESSION_CONFIGURATION_REF_MAX_BYTES} UTF-8 bytes.`,
+    );
+  }
+}
 
 export function validateIdentifier(value: string, name: string): void {
   if (typeof value !== 'string' || value.length === 0) {