@modelprofile.com/flexharness 5.2.0 → 5.3.0

package/ts/interfaces.ts

@@ -944,6 +944,7 @@ export interface IFlexRedoSessionResult {
 export type TFlexExternalErrorSource =
   | 'modelResolver'
   | 'toolProvider'
+  | 'delegatedRunAdmissionProvider'
   | 'toolExecution'
   | 'toolCallback'
   | 'toolCleanup'
@@ -964,6 +965,37 @@ export type TFlexExternalErrorProjector = (
   context: IFlexExternalErrorContext,
 ) => IFlexErrorInfo;
 
+export interface IFlexDelegatedRunAdmissionContext<TScope> extends IFlexSessionGeneration {
+  readonly scopeId: string;
+  readonly scope: TScope;
+  readonly storageKey: string;
+  readonly sessionId: string;
+  readonly sessionGenerationId: string;
+  readonly sessionGenerationSequence: number;
+  readonly queueId: string;
+  readonly runId: string;
+  readonly parentSessionId: string;
+  readonly parentSessionGenerationId: string;
+  readonly parentSessionGenerationSequence: number;
+  readonly parentQueueId: string;
+  readonly parentRunId: string;
+  readonly parentToolCallId: string;
+  readonly agent: string;
+  readonly depth: number;
+  readonly signal: AbortSignal;
+}
+
+export interface IFlexDelegatedRunAdmissionLease {
+  /** Must be idempotent and safe to retry after a rejected close attempt. */
+  close(): Promise<void> | void;
+}
+
+export interface IFlexDelegatedRunAdmissionProvider<TScope> {
+  acquireDelegatedRunAdmission(
+    context: IFlexDelegatedRunAdmissionContext<TScope>,
+  ): Promise<IFlexDelegatedRunAdmissionLease> | IFlexDelegatedRunAdmissionLease;
+}
+
 export interface IFlexExecutionContextProviderContext<TScope> {
   scopeId: string;
   scope: TScope;
@@ -1035,6 +1067,7 @@ export interface IFlexHarnessOptions<TScope> {
   toolProvider?: IFlexToolProvider<TScope>;
   resourceToolProviderResolver?: IFlexResourceToolProviderResolver<TScope>;
   executionContextProvider?: IFlexExecutionContextProvider<TScope>;
+  delegatedRunAdmissionProvider?: IFlexDelegatedRunAdmissionProvider<TScope>;
   stores?: IFlexHarnessStores;
   agentSessionPolicy?: IFlexAgentSessionPolicy<TScope>;
   toolOutputLimits?: IFlexJsonLimits;