@modelprofile.com/flexharness 9.9.1 → 9.10.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@modelprofile.com/flexharness',
-    version: '9.9.1',
+    version: '9.10.0',
     description: 'The FlexHarness toolbox source repository and shared dependency catalog.'
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSwrQkFBK0I7SUFDckMsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLDBFQUEwRTtDQUN4RixDQUFBIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSwrQkFBK0I7SUFDckMsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLDBFQUEwRTtDQUN4RixDQUFBIn0=

package/dist_ts/classes.flexharness.d.ts

@@ -1,4 +1,4 @@
-import type { IFlexBackgroundExecution, IFlexBeginSessionImportOptions, IFlexCompactSessionOptions, IFlexCreateProjectTaskInput, IFlexCreateSessionOptions, IFlexDeleteSessionGenerationCohortInput, IFlexDeleteSessionGenerationCohortResult, IFlexEventArchiveMetadata, IFlexHarnessOptions, IFlexImportedRun, IFlexMessage, IFlexMessagePage, IFlexMessagePageOptions, IFlexPermissionRequest, IFlexProjectGoalResult, IFlexProjectScratchpadResult, IFlexProjectStateResult, IFlexProjectTaskResult, IFlexProjectTasksResult, IFlexPromptAdmission, IFlexPromptQueueAdmission, IFlexPromptQueueEntry, IFlexPromptOptions, IFlexPromptResult, IFlexRedoSessionResult, IFlexScheduledPromptAdmission, IFlexSchedulePromptOptions, IFlexSession, IFlexSessionImportHandle, IFlexSessionImportProgress, IFlexSessionReversionInfo, IFlexSlashCommandDescriptor, IFlexSlashCommandExecutionOptions, IFlexUncertainToolExecution, IFlexUndoSessionResult, IFlexUpdateSessionOptions, IFlexUpdateProjectTaskInput, IJsonObject, TFlexBeginSessionImportResult, TFlexHarnessEventListener, TFlexPermissionDecision, TFlexPrompt, TFlexSlashCommandExecutionResult, TFlexToolExecutionReconciliation } from './interfaces.js';
+import type { IFlexBackgroundExecution, IFlexBeginSessionImportOptions, IFlexCompactSessionOptions, IFlexCreateProjectTaskInput, IFlexCreateSessionOptions, IFlexDeleteSessionGenerationCohortInput, IFlexDeleteSessionGenerationCohortResult, IFlexEventArchiveMetadata, IFlexHarnessOptions, IFlexImportedRun, IFlexMessage, IFlexMessagePage, IFlexMessagePageOptions, IFlexPermissionRequest, IFlexProjectGoalResult, IFlexSteerAdmission, IFlexSteerInput, IFlexProjectScratchpadResult, IFlexProjectStateResult, IFlexProjectTaskResult, IFlexProjectTasksResult, IFlexPromptAdmission, IFlexPromptQueueAdmission, IFlexPromptQueueEntry, IFlexPromptOptions, IFlexPromptResult, IFlexRedoSessionResult, IFlexScheduledPromptAdmission, IFlexSchedulePromptOptions, IFlexSession, IFlexSessionImportHandle, IFlexSessionImportProgress, IFlexSessionReversionInfo, IFlexSlashCommandDescriptor, IFlexSlashCommandExecutionOptions, IFlexUncertainToolExecution, IFlexUndoSessionResult, IFlexUpdateSessionOptions, IFlexUpdateProjectTaskInput, IJsonObject, TFlexBeginSessionImportResult, TFlexHarnessEventListener, TFlexPermissionDecision, TFlexPrompt, TFlexSlashCommandExecutionResult, TFlexToolExecutionReconciliation } from './interfaces.js';
 export declare function createFlexResourceToolNamespace(resourceId: string, attachmentRevision: number): string;
 export declare function createFlexResourceToolName(namespace: string, toolName: string): string;
 export declare class FlexHarness<TScope = unknown> {
@@ -127,6 +127,16 @@ export declare class FlexHarness<TScope = unknown> {
     listPromptQueueEntries(scopeId: string, sessionId: string): Promise<IFlexPromptQueueEntry[]>;
     cancelPrompt(scopeId: string, sessionId: string, queueId: string): Promise<boolean>;
     cancelScheduledPrompt(scopeId: string, sessionId: string, scheduleKey: string): Promise<boolean>;
+    /**
+     * Steers the running run of the prompt `queueId`: the run takes `steer.prompt` in as a user
+     * message at its next step boundary, after the tool results of its current model step are
+     * recorded and before its next model call. A running tool call or permission wait is not
+     * interrupted. A steer the run has not taken in when it ends is reported in its
+     * `unappliedSteerIds`; a steer for a prompt that has no running run, or whose run is ending,
+     * is refused with `FlexHarnessSteerRejectedError` reason `not-running` and belongs to the
+     * next turn.
+     */
+    steerPrompt(scopeId: string, sessionId: string, queueId: string, steer: IFlexSteerInput): Promise<IFlexSteerAdmission>;
     abort(scopeId: string, sessionId: string): Promise<boolean>;
     listPendingPermissions(scopeId: string, sessionId?: string): Promise<IFlexPermissionRequest[]>;
     respondToPermission(scopeId: string, sessionId: string, permissionId: string, decision: TFlexPermissionDecision): Promise<void>;
@@ -225,6 +235,21 @@ export declare class FlexHarness<TScope = unknown> {
     private updateSubagentToolPart;
     private abortExactRun;
     private createReservation;
+    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.
+     */
+    private closeRunSteering;
+    /**
+     * 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.
+     */
+    private applyRunSteer;
     private buildTerminal;
     private reversionId;
     private reversionProviderProtocolVersion;
@@ -252,6 +277,12 @@ export declare class FlexHarness<TScope = unknown> {
     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.
+     */
     private replaceVisibleRun;
     private emitTerminalProjection;
     private emitFinalRunEvent;