@modelprofile.com/flexharness 9.3.1 → 9.5.0

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/classes.flexharness.d.ts

@@ -1,4 +1,4 @@
-import type { IFlexBackgroundExecution, IFlexCreateProjectTaskInput, IFlexCreateSessionOptions, IFlexDeleteSessionGenerationCohortInput, IFlexDeleteSessionGenerationCohortResult, IFlexEventArchiveMetadata, IFlexHarnessOptions, IFlexMessage, IFlexMessagePage, IFlexMessagePageOptions, IFlexPermissionRequest, IFlexProjectGoalResult, IFlexProjectScratchpadResult, IFlexProjectStateResult, IFlexProjectTaskResult, IFlexProjectTasksResult, IFlexPromptAdmission, IFlexPromptQueueAdmission, IFlexPromptQueueEntry, IFlexPromptOptions, IFlexPromptResult, IFlexRedoSessionResult, IFlexScheduledPromptAdmission, IFlexSchedulePromptOptions, IFlexSession, IFlexSessionReversionInfo, IFlexSlashCommandDescriptor, IFlexSlashCommandExecutionOptions, IFlexUncertainToolExecution, IFlexUndoSessionResult, IFlexUpdateSessionOptions, IFlexUpdateProjectTaskInput, IJsonObject, 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, 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> {
@@ -14,6 +14,7 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly callbackLimits;
     private readonly promptQueueLimits;
     private readonly reversionLimits;
+    private readonly sessionImportLimits;
     private readonly reversionMaintenanceTimeoutMs;
     private readonly turnReversionProvider;
     private readonly reversionPolicy;
@@ -40,6 +41,7 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly projectManagementQueues;
     private readonly activeSlashCommandExecutions;
     private readonly activeSlashCommandListings;
+    private readonly stagedSessionImports;
     private readonly compactorInvocationContext;
     private readonly slashCommandInvocationContext;
     private readonly slashCommandActivityContext;
@@ -53,6 +55,21 @@ export declare class FlexHarness<TScope = unknown> {
     constructor(options: IFlexHarnessOptions<TScope>);
     listSessions(scopeId: string): Promise<IFlexSession[]>;
     createSession(scopeId: string, options?: IFlexCreateSessionOptions): Promise<IFlexSession>;
+    /**
+     * Starts a staged import of a finished conversation into a new read-only session. The session
+     * stays hidden until `commitSessionImport()`. A committed session with the same source, source
+     * id and part is reported instead of being imported twice.
+     */
+    beginSessionImport(scopeId: string, options: IFlexBeginSessionImportOptions): Promise<TFlexBeginSessionImportResult>;
+    /** Stages one page of runs, in order, for a started session import. A rejected page stages nothing. */
+    appendImportedRuns(handle: IFlexSessionImportHandle, runs: readonly IFlexImportedRun[]): Promise<IFlexSessionImportProgress>;
+    /**
+     * Persists the staged runs and publishes the session: archived, read-only and marked with its
+     * `origin`. A failed commit removes everything it persisted before it rejects.
+     */
+    commitSessionImport(handle: IFlexSessionImportHandle): Promise<IFlexSession>;
+    /** Discards a staged import. Nothing of it was persisted; an unknown or finished handle is ignored. */
+    abortSessionImport(handle: IFlexSessionImportHandle): Promise<void>;
     getSession(scopeId: string, sessionId: string): Promise<IFlexSession>;
     getSessionReversionInfo(scopeId: string, sessionId: string): Promise<IFlexSessionReversionInfo>;
     updateSession(scopeId: string, sessionId: string, options: IFlexUpdateSessionOptions): Promise<IFlexSession>;
@@ -111,7 +128,7 @@ export declare class FlexHarness<TScope = unknown> {
     pushRuntimeEvent(scopeId: string, sessionId: string, event: IJsonObject & {
         type: string;
     }): Promise<void>;
-    compactSession(scopeId: string, sessionId: string): Promise<void>;
+    compactSession(scopeId: string, sessionId: string, options?: IFlexCompactSessionOptions): Promise<void>;
     private compactStoredSession;
     undoSession(scopeId: string, sessionId: string, signal?: AbortSignal): Promise<IFlexUndoSessionResult>;
     redoSession(scopeId: string, sessionId: string, signal?: AbortSignal): Promise<IFlexRedoSessionResult>;
@@ -337,6 +354,11 @@ export declare class FlexHarness<TScope = unknown> {
     private assertNoAmbientSlashCommandTeardown;
     private assertStateAcceptingWork;
     private createCompactorContext;
+    /**
+     * The model the compacted work was dispatched on: the resolved model of the run whose context
+     * overflowed, or the model hint a manual compaction was requested with. Retention states none.
+     */
+    private compactionModel;
     private withCompactorContext;
     private createRunCompactorContext;
     private effectiveRunCompactorContext;
@@ -345,6 +367,21 @@ export declare class FlexHarness<TScope = unknown> {
     private completedReversionCandidates;
     private visibleMessages;
     private requireMutableSession;
+    /** Refuses an operation that would change an imported session's history or model context. */
+    private assertSessionWritable;
+    /** An imported session never ran here, so it has no hidden stage and no reversion state. */
+    private assertImportedSessionState;
+    private assertNoCommittingSessionImport;
+    private findStagedSessionImport;
+    private requireStagedSessionImport;
+    private armStagedImportIdleTimer;
+    private clearStagedImportIdleTimer;
+    private releaseStagedSessionImport;
+    /**
+     * An imported child session belongs to a committed imported parent whose run `parent.runId` holds
+     * the tool call `parent.toolCallId` naming the child, and no other session claims that tool call.
+     */
+    private requireImportParent;
     private requireMessage;
     private isTombstoned;
     private emitPartEvent;