@modelprofile.com/flexharness 10.24.0 → 11.0.0

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

@@ -0,0 +1,47 @@
+import { FlexHarnessAbortError } from './errors.js';
+import type { IFlexAgentContextInvocation, IFlexExecutionContextHandle } from './interfaces.js';
+import type { IStoredSessionState, IOrphanedProviderRelease, IOrphanedTombstoneOwner, IOrphanedExecutionContextOwner, IStorageState, IActiveRun } from './interfaces.flexharness.js';
+import type { FlexHarnessCore } from './classes.flexharness.core.js';
+/**
+ * Harness and scope lifecycle: namespace fences, storage drains, orphaned resources, scope
+ * retirement and disposal.
+ */
+export declare class FlexHarnessLifecycle<TScope> {
+    private readonly core;
+    private readonly scopeRetirements;
+    readonly storageDrains: Map<string, Promise<void>>;
+    readonly storageCompactorLifecycleControllers: Map<string, AbortController>;
+    private orphanedResourceQueue;
+    readonly orphanedStoredSessions: Set<IStoredSessionState>;
+    readonly orphanedExecutionContexts: Map<IFlexExecutionContextHandle, IOrphanedExecutionContextOwner>;
+    private readonly orphanedProviderReleases;
+    private readonly orphanedTombstoneCleanups;
+    readonly orphanedTombstoneOwners: Map<string, IOrphanedTombstoneOwner<TScope>>;
+    private disposePromise?;
+    constructor(core: FlexHarnessCore<TScope>);
+    retireScope(scopeId: string): Promise<void>;
+    dispose(): Promise<void>;
+    fenceNamespace(state: IStorageState, currentRun: IActiveRun, cause: unknown): Promise<void>;
+    deferNamespaceDrain(state: IStorageState, cause: unknown, invocation?: {
+        scopeId: string;
+        scope: TScope;
+    }): void;
+    deferReversionReleaseDrain(state: IStorageState, stored: IStoredSessionState, scopeId: string, scope: TScope): void;
+    closeStoredSession(stored: IStoredSessionState, context?: IFlexAgentContextInvocation<unknown>): Promise<void>;
+    abortStoredSession(stored: IStoredSessionState, reason: FlexHarnessAbortError, context?: IFlexAgentContextInvocation<unknown>): Promise<void>;
+    storedSessionCleanupCompleted(stored: IStoredSessionState): boolean;
+    releasePartialProviderSession(providerName: 'agentEvents' | 'jobs', storageKey: string, sessionId: string): Promise<void>;
+    retainPartialProviderSession(providerName: 'agentEvents' | 'jobs', storageKey: string, sessionId: string): IOrphanedProviderRelease | undefined;
+    hasOrphanedSessionResources(storageKey: string, sessionId: string): boolean;
+    private retainOrphanedTombstoneCleanup;
+    closeOrphanedResources(storageKey?: string): Promise<unknown[]>;
+    private closeOrphanedResourcesInternal;
+    private orphanedResourceStorageKeys;
+    private retireScopeInternal;
+    drainStorage(storageKey: string, stateLoad: Promise<IStorageState>, reason: FlexHarnessAbortError, invocation?: {
+        scopeId: string;
+        scope: TScope;
+    }): Promise<void>;
+    private drainStorageInternal;
+    private disposeInternal;
+}