@modelprofile.com/flexharness 10.24.0 → 10.24.1

package/dist_ts/classes.flexharness.runs.d.ts

@@ -0,0 +1,63 @@
+import * as plugins from './plugins.js';
+import { FlexHarnessAbortError } from './errors.js';
+import { type IFlexAgentContextInvocation, type IFlexMessage, type IFlexPromptOptions, type IFlexPromptResult, type IFlexTerminalProjection, type TFlexAgentToolSet } from './interfaces.js';
+import type { INormalizedFlexPrompt } from './utils.prompt.js';
+import type { IStoredSessionState, IStorageState, IActiveRun, IRunSteering, IRunSteeringOutcome, IQueuedPrompt } from './interfaces.flexharness.js';
+import type { FlexHarnessCore } from './classes.flexharness.core.js';
+/** The run execution engine: generations, terminal outcomes, steering and cancellation. */
+export declare class FlexHarnessRuns<TScope> {
+    private readonly core;
+    constructor(core: FlexHarnessCore<TScope>);
+    abort(scopeId: string, sessionId: string): Promise<boolean>;
+    createActiveRun(queued: IQueuedPrompt): IActiveRun;
+    executeRun(run: IActiveRun, generation: Promise<plugins.IAgentGenerateResult>): Promise<IFlexPromptResult>;
+    private finishFailedRun;
+    prepareGeneration(run: IActiveRun, options: IFlexPromptOptions, signal: AbortSignal): Promise<plugins.IAgentGenerationLease>;
+    enabledBuiltInToolNames(run: IActiveRun): Set<string>;
+    assertNoBuiltInToolCollisions(run: IActiveRun, tools: TFlexAgentToolSet): void;
+    private createBuiltInTools;
+    private createRenameSessionTool;
+    abortExactRun(state: IStorageState, sessionId: string, runId: string, reason: unknown): boolean;
+    createReservation(run: IActiveRun, prompt: INormalizedFlexPrompt): {
+        userMessage: IFlexMessage;
+        assistantMessage: IFlexMessage;
+    };
+    private userMessageParts;
+    /**
+     * Ends steering intake once the run's generation has settled and fixes what became of its
+     * steers. A run that stays in the model context reports the steers its generation did not
+     * record; a run that does not, because it failed, was stopped before any model output or its
+     * outcome could not be established, reports every steer it accepted, since the model context
+     * of later turns holds none of them. The bytes of the steers not taken in are released.
+     */
+    closeRunSteering(steering: IRunSteering): IRunSteeringOutcome;
+    /**
+     * Projects a steer the run's generation took in as a user message of the run. The assistant
+     * message that answered before it is completed and the run answers on in a new one; a steer
+     * taken in before the run answered anything is placed before its still empty assistant message.
+     */
+    applyRunSteer(run: IActiveRun, applied: plugins.IAgentAppliedInput): Promise<void>;
+    private buildTerminal;
+    private promoteCompletedTerminal;
+    private publishFailedTerminal;
+    private replaceStagedTerminal;
+    /**
+     * Puts a run's terminal messages in place of their projected versions: its prompt, and its last
+     * assistant message. The steers a run took in, and the assistant messages it completed before
+     * them, stay where they are. A terminal message that is not projected yet is added: the prompt
+     * before the run's other messages, the assistant message after them.
+     */
+    replaceVisibleRun(stored: IStoredSessionState, terminal: IFlexTerminalProjection): void;
+    private emitTerminalProjection;
+    /**
+     * Ends a run that fails without publishing a terminal projection, because its namespace was
+     * fenced or retired or its durable outcome could not be established: listeners still receive
+     * its terminal message events and its one `run.finished`. Nothing here is persisted; the next
+     * load of the namespace repairs the stored projection from the canonical outcome.
+     */
+    private emitUnpublishedRunFinish;
+    private emitFinalRunEvent;
+    cancelRun(run: IActiveRun, reason: FlexHarnessAbortError, context?: IFlexAgentContextInvocation<TScope>): void;
+    abortRunInternally(run: IActiveRun, error: unknown, context?: IFlexAgentContextInvocation<TScope>): void;
+    rollbackAdmission(run: IActiveRun, projectionReserved: boolean, originalError: Error): Promise<unknown[]>;
+}