@modelprofile.com/flexharness 10.24.0 → 10.24.1

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

@@ -0,0 +1,44 @@
+import { FlexHarnessAbortError } from './errors.js';
+import type { IFlexAgentContextInvocation, IFlexSteerAdmission, IFlexSteerInput, IFlexPromptAdmission, IFlexPromptQueueAdmission, IFlexPromptQueueEntry, IFlexPromptOptions, IFlexPromptResult, IFlexScheduledPromptAdmission, IFlexSchedulePromptOptions, TFlexPrompt } from './interfaces.js';
+import { type INormalizedFlexPrompt } from './utils.prompt.js';
+import type { IStoredSessionState, IStorageState, IActiveRun, IDelegatedRunAdmissionSeed, IQueuedPrompt, IPendingPromptAdmission } from './interfaces.flexharness.js';
+import type { FlexHarnessCore } from './classes.flexharness.core.js';
+/** The prompt queue: admission, scheduling, promotion and cancellation of prompts and steers. */
+export declare class FlexHarnessPromptQueue<TScope> {
+    private readonly core;
+    readonly pendingPromptAdmissionOwners: Set<IPendingPromptAdmission>;
+    private promptQueueSequence;
+    pendingPromptAdmissions: number;
+    pendingPromptAdmissionBytes: number;
+    constructor(core: FlexHarnessCore<TScope>);
+    promptAdmissionByteSize(prompt: TFlexPrompt, options: IFlexPromptOptions, scheduleKey?: string, debounceMs?: number): number;
+    isSessionRuntimeIdle(state: IStorageState, stored: IStoredSessionState): boolean;
+    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>;
+    steerPrompt(scopeId: string, sessionId: string, queueId: string, steer: IFlexSteerInput): Promise<IFlexSteerAdmission>;
+    /** The shared synchronous admission point; neither entrypoint starts or resumes a run. */
+    admitRunSteer(run: IActiveRun, steer: IFlexSteerInput, prompt: INormalizedFlexPrompt, byteSize: number): IFlexSteerAdmission;
+    enqueuePromptInternal(scopeId: string, sessionId: string, prompt: TFlexPrompt, options: IFlexPromptOptions, scheduleKey?: string, debounceMs?: number, delegationSeed?: IDelegatedRunAdmissionSeed, admissionSignal?: AbortSignal, slashCommandAdmission?: boolean): Promise<{
+        admission: IFlexPromptQueueAdmission;
+        started: Promise<IFlexPromptAdmission>;
+        queued?: IQueuedPrompt;
+    }>;
+    private reservePendingPromptAdmission;
+    private schedulePromptQueueDrain;
+    private drainPromptQueue;
+    private assertPromptPromotion;
+    private promoteQueuedPrompt;
+    private projectPromptQueueEntry;
+    private promptQueueEntry;
+    emitPromptQueueEvent(queued: IQueuedPrompt, type: 'prompt.queued' | 'prompt.started' | 'prompt.running' | 'prompt.finished', entry?: IFlexPromptQueueEntry): void;
+    private finishQueuedPrompt;
+    cancelQueuedPrompt(queued: IQueuedPrompt, reason: FlexHarnessAbortError, context?: IFlexAgentContextInvocation<TScope>): boolean;
+    cancelStoredPromptQueue(stored: IStoredSessionState, reason: FlexHarnessAbortError, excludedQueueId?: string, context?: IFlexAgentContextInvocation<unknown>): void;
+    purgeStoredPromptQueue(stored: IStoredSessionState): void;
+}