@modelprofile.com/flexharness 3.1.0 → 3.2.0

package/changelog.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2026-08-11 - 3.2.0
+
+### Features
+
+- add bounded prompt queue APIs (harness)
+  - Introduce enqueuePrompt(), queue entry inspection, cancellation, and prompt queue events for FIFO session admission.
+  - Extend scheduled prompts to share queue ownership with stable schedule keys and cancellable queued work.
+  - Enforce pending admission, outstanding prompt, byte, and terminal retention limits while clearing private queue payloads at settlement.
+  - Document queue lifecycle behavior and add coverage for cancellation, disposal, retirement, limits, and immutable queued inputs.
+
 ## 2026-08-11 - 3.1.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@modelprofile.com/flexharness',
-    version: '3.1.0',
+    version: '3.2.0',
     description: 'Provider-neutral model-session runtime with durable history, permissions, typed events, and pluggable local or remote tool execution.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSwrQkFBK0I7SUFDckMsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHVJQUF1STtDQUNySixDQUFBIn0=

package/dist_ts/classes.flexharness.d.ts

@@ -1,4 +1,4 @@
-import type { IFlexBackgroundExecution, IFlexCreateSessionOptions, IFlexEventArchiveMetadata, IFlexHarnessOptions, IFlexMessage, IFlexMessagePage, IFlexMessagePageOptions, IFlexPermissionRequest, IFlexPromptAdmission, IFlexPromptOptions, IFlexPromptResult, IFlexScheduledPromptAdmission, IFlexSchedulePromptOptions, IFlexSession, IFlexUncertainToolExecution, IFlexUpdateSessionOptions, IJsonObject, TFlexHarnessEventListener, TFlexPermissionDecision, TFlexPrompt, TFlexToolExecutionReconciliation } from './interfaces.js';
+import type { IFlexBackgroundExecution, IFlexCreateSessionOptions, IFlexEventArchiveMetadata, IFlexHarnessOptions, IFlexMessage, IFlexMessagePage, IFlexMessagePageOptions, IFlexPermissionRequest, IFlexPromptAdmission, IFlexPromptQueueAdmission, IFlexPromptQueueEntry, IFlexPromptOptions, IFlexPromptResult, IFlexScheduledPromptAdmission, IFlexSchedulePromptOptions, IFlexSession, IFlexUncertainToolExecution, IFlexUpdateSessionOptions, IJsonObject, TFlexHarnessEventListener, TFlexPermissionDecision, TFlexPrompt, TFlexToolExecutionReconciliation } from './interfaces.js';
 export declare class FlexHarness<TScope = unknown> {
     private readonly scopeResolver;
     private readonly modelResolver;
@@ -8,6 +8,7 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly agentSessionPolicy;
     private readonly toolOutputLimits;
     private readonly callbackLimits;
+    private readonly promptQueueLimits;
     private readonly externalErrorProjector?;
     private readonly stateLoads;
     private readonly scopeAdmissions;
@@ -19,7 +20,11 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly orphanedStoredSessions;
     private readonly orphanedExecutionContexts;
     private readonly orphanedProviderReleases;
+    private readonly pendingPromptAdmissionOwners;
     private sequence;
+    private promptQueueSequence;
+    private pendingPromptAdmissions;
+    private pendingPromptAdmissionBytes;
     private closed;
     private disposePromise?;
     constructor(options: IFlexHarnessOptions<TScope>);
@@ -34,7 +39,11 @@ export declare class FlexHarness<TScope = unknown> {
     getMessage(scopeId: string, sessionId: string, messageId: string): Promise<IFlexMessage>;
     prompt(scopeId: string, sessionId: string, prompt: TFlexPrompt, options?: IFlexPromptOptions): Promise<IFlexPromptResult>;
     startPrompt(scopeId: string, sessionId: string, prompt: TFlexPrompt, options?: IFlexPromptOptions): Promise<IFlexPromptAdmission>;
+    enqueuePrompt(scopeId: string, sessionId: string, prompt: TFlexPrompt, options?: IFlexPromptOptions): Promise<IFlexPromptQueueAdmission>;
     schedulePrompt(scopeId: string, sessionId: string, scheduleKey: string, prompt: TFlexPrompt, options?: IFlexSchedulePromptOptions): Promise<IFlexScheduledPromptAdmission>;
+    getPromptQueueEntry(scopeId: string, sessionId: string, queueId: string): Promise<IFlexPromptQueueEntry>;
+    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>;
     abort(scopeId: string, sessionId: string): Promise<boolean>;
     listPendingPermissions(scopeId: string, sessionId?: string): Promise<IFlexPermissionRequest[]>;
@@ -52,7 +61,20 @@ export declare class FlexHarness<TScope = unknown> {
     subscribe(listener: TFlexHarnessEventListener): () => void;
     retireScope(scopeId: string): Promise<void>;
     dispose(): Promise<void>;
-    private admitPrompt;
+    private enqueuePromptInternal;
+    private reservePendingPromptAdmission;
+    private schedulePromptQueueDrain;
+    private drainPromptQueue;
+    private createActiveRun;
+    private assertPromptPromotion;
+    private promoteQueuedPrompt;
+    private projectPromptQueueEntry;
+    private promptQueueEntry;
+    private emitPromptQueueEvent;
+    private finishQueuedPrompt;
+    private cancelQueuedPrompt;
+    private cancelStoredPromptQueue;
+    private purgeStoredPromptQueue;
     private executeRun;
     private finishFailedRun;
     private prepareGeneration;