@modelprofile.com/flexharness 1.0.1 → 2.0.0

package/ts/errors.ts

@@ -52,6 +52,13 @@ export class FlexHarnessCallbackOverflowError extends FlexHarnessError {
   }
 }
 
+export class FlexHarnessExternalError extends FlexHarnessError {
+  constructor(info: IFlexErrorInfo) {
+    super(info.code ?? 'FLEX_EXTERNAL_ERROR', info.message);
+    this.name = info.name;
+  }
+}
+
 export class FlexHarnessPermissionRejectedError extends FlexHarnessError {
   constructor(permissionId: string, options?: ErrorOptions) {
     super('FLEX_PERMISSION_REJECTED', `Permission "${permissionId}" was rejected.`, options);

package/ts/interfaces.ts

@@ -55,6 +55,7 @@ export interface IFlexModelIdentity {
   provider: string;
   model: string;
   displayName?: string;
+  variant?: string;
 }
 
 export type TFlexActivityStatus =
@@ -167,6 +168,21 @@ export interface IFlexPromptResult {
   steps: number;
 }
 
+export interface IFlexPromptAdmission {
+  runId: string;
+  completion: Promise<IFlexPromptResult>;
+}
+
+export interface IFlexMessagePageOptions {
+  limit?: number;
+  before?: string;
+}
+
+export interface IFlexMessagePage {
+  messages: IFlexMessage[];
+  nextCursor?: string;
+}
+
 export interface IFlexResolvedScope<TScope> {
   storageKey: string;
   scope: TScope;
@@ -271,6 +287,27 @@ export interface IFlexCallbackLimits {
   maxParts?: number;
 }
 
+export type TFlexExternalErrorSource =
+  | 'modelResolver'
+  | 'toolProvider'
+  | 'runner'
+  | 'toolExecution'
+  | 'toolCallback'
+  | 'toolCleanup'
+  | 'persistence';
+
+export interface IFlexExternalErrorContext {
+  source: TFlexExternalErrorSource;
+  scopeId: string;
+  sessionId: string;
+  runId: string;
+}
+
+export type TFlexExternalErrorProjector = (
+  error: unknown,
+  context: IFlexExternalErrorContext,
+) => IFlexErrorInfo;
+
 export interface IFlexHarnessOptions<TScope> {
   scopeResolver: IFlexScopeResolver<TScope>;
   modelResolver: IFlexModelResolver<TScope>;
@@ -279,6 +316,7 @@ export interface IFlexHarnessOptions<TScope> {
   runner?: TFlexAgentRunner;
   toolOutputLimits?: IFlexJsonLimits;
   callbackLimits?: IFlexCallbackLimits;
+  externalErrorProjector?: TFlexExternalErrorProjector;
 }
 
 export interface IFlexEventBase {

package/ts/utils.json.ts

@@ -166,7 +166,7 @@ export function normalizeJsonValue(value: unknown, limits: IFlexJsonLimits = {})
     if (current instanceof Error) {
       return description(
         'error',
-        { name: shortString(current.name), message: shortString(current.message) },
+        { description: 'An error value was returned.' },
         allowance,
       );
     }
@@ -200,9 +200,9 @@ export function normalizeJsonValue(value: unknown, limits: IFlexJsonLimits = {})
         let entry: unknown;
         try {
           entry = current[index];
-        } catch (error) {
+        } catch {
           entry = makeDescription('unreadable', {
-            description: shortString(error instanceof Error ? error.message : String(error)),
+            description: 'The array entry could not be read.',
           });
         }
         const child = visit(
@@ -266,9 +266,9 @@ export function normalizeJsonValue(value: unknown, limits: IFlexJsonLimits = {})
       let entry: unknown;
       try {
         entry = (current as Record<string, unknown>)[key];
-      } catch (error) {
+      } catch {
         entry = makeDescription('unreadable', {
-          description: shortString(error instanceof Error ? error.message : String(error)),
+          description: 'The object property could not be read.',
         });
       }
       const child = visit(
@@ -448,6 +448,7 @@ function validateSessionSnapshot(value: unknown, path: string): string {
       requireString(model.provider, `${messagePath}.model.provider`);
       requireString(model.model, `${messagePath}.model.model`);
       requireOptionalString(model.displayName, `${messagePath}.model.displayName`);
+      requireOptionalString(model.variant, `${messagePath}.model.variant`);
     }
     if (message.usage !== undefined) {
       const usage = requireRecord(message.usage, `${messagePath}.usage`);