@modelprofile.com/flexharness 5.1.0 → 5.3.0

package/changelog.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 2026-08-30 - 5.3.0
+
+### Features
+
+- add delegated child-run admission leases (subagents)
+  - Add a frozen exact child/current-parent admission context and an optional delegatedRunAdmissionProvider for internally delegated runs.
+  - Acquire before generation-side reversion, compaction, model, tool, and resource callbacks, while retaining generation-scoped ownership through terminal reversion finalization.
+  - Close before canonical acceptance or failed/cancelled finalization, preserve abort progress across late acquisition, and retry failed idempotent closes during exact deletion, retirement, or disposal.
+  - Explain new-child versus later-run resume semantics in the model-visible delegate schema and return safe corrective feedback for unknown task IDs.
+
+## 2026-08-26 - 5.2.0
+
+### Features
+
+- add generation-fenced session cohort deletion (session-generation)
+  - Add deleteSessionGenerationCohort with strict root and authorized cohort validation.
+  - Allow createSession callers to provide a validated sessionGenerationId while preserving harness-assigned sequences.
+  - Propagate session generation metadata through model resolver contexts, permission requests, and emitted events.
+
 ## 2026-08-26 - 5.1.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@modelprofile.com/flexharness',
-    version: '5.1.0',
+    version: '5.3.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, IFlexCreateProjectTaskInput, IFlexCreateSessionOptions, 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, 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';
 export declare function createFlexResourceToolNamespace(resourceId: string, attachmentRevision: number): string;
 export declare function createFlexResourceToolName(namespace: string, toolName: string): string;
 export declare class FlexHarness<TScope = unknown> {
@@ -7,6 +7,7 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly toolProvider;
     private readonly resourceToolProviderResolver;
     private readonly executionContextProvider;
+    private readonly delegatedRunAdmissionProvider;
     private readonly stores;
     private readonly agentSessionPolicy;
     private readonly toolOutputLimits;
@@ -67,8 +68,15 @@ export declare class FlexHarness<TScope = unknown> {
     setProjectScratchpad(scopeId: string, sessionId: string, content: string): Promise<IFlexProjectScratchpadResult>;
     appendProjectScratchpad(scopeId: string, sessionId: string, content: string): Promise<IFlexProjectScratchpadResult>;
     clearProjectScratchpad(scopeId: string, sessionId: string): Promise<IFlexProjectScratchpadResult>;
+    deleteSessionGenerationCohort(scopeId: string, input: IFlexDeleteSessionGenerationCohortInput): Promise<IFlexDeleteSessionGenerationCohortResult>;
     deleteSession(scopeId: string, sessionId: string): Promise<void>;
+    private startSessionDeletion;
+    private startReservedSessionDeletion;
+    private registerSessionDeletion;
+    private assertAuthorizedSessionGenerationCohort;
+    private reserveLiveSessionDeletion;
     private deleteSessionInternal;
+    private finishReservedSessionDeletion;
     getMessages(scopeId: string, sessionId: string): Promise<IFlexMessage[]>;
     listMessagePage(scopeId: string, sessionId: string, options?: IFlexMessagePageOptions): Promise<IFlexMessagePage>;
     getMessage(scopeId: string, sessionId: string, messageId: string): Promise<IFlexMessage>;
@@ -130,6 +138,12 @@ export declare class FlexHarness<TScope = unknown> {
     private drainPromptQueue;
     private createActiveRun;
     private assertPromptPromotion;
+    private assertDelegatedRunAdmissionOwnership;
+    private acquireDelegatedRunAdmission;
+    private normalizeDelegatedRunAdmissionLease;
+    private requestDelegatedRunAdmissionClose;
+    private startDelegatedRunAdmissionCloseAttempt;
+    private closeRunDelegatedRunAdmission;
     private promoteQueuedPrompt;
     private projectPromptQueueEntry;
     private promptQueueEntry;
@@ -178,6 +192,7 @@ export declare class FlexHarness<TScope = unknown> {
     private createProjectTaskId;
     private createSubagentTool;
     private executeSubagentTask;
+    private createDelegatedRunAdmissionSeed;
     private acquireSubagentSession;
     private createSubagentSessionId;
     private updateSubagentToolPart;
@@ -244,6 +259,8 @@ export declare class FlexHarness<TScope = unknown> {
     private runDetachedCleanup;
     private beginDetachedCleanupSettlement;
     private settleDetachedCleanups;
+    private delegatedRunAdmissionOwnersForGeneration;
+    private settleDelegatedRunAdmissionOwners;
     private projectExternalError;
     private projectOperationError;
     private trustInternalError;
@@ -254,7 +271,9 @@ export declare class FlexHarness<TScope = unknown> {
     private loadSessionRuntime;
     private repairLoadedSession;
     private repairTerminal;
+    private withScopeMutationOwnership;
     private mutateScope;
+    private mutateScopeOwned;
     private mutateProjection;
     private mutatePermissions;
     private createScopeSnapshot;
@@ -265,6 +284,7 @@ export declare class FlexHarness<TScope = unknown> {
     private tombstoneProjectManagementSession;
     private collectSessionSubtree;
     private tombstoneGroup;
+    private tombstonesForRoots;
     private descendantTombstoneRoots;
     private orderTombstoneRootsChildFirst;
     private finishTombstoneCleanup;