@modelprofile.com/flexharness 3.7.0 → 4.0.0

package/changelog.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 2026-08-14 - 4.0.0
+
+### Breaking Changes
+
+- rename the foreground subagent tool and add opt-in project-management tools (harness)
+  - Rename the foreground subagent wire tool from `task` to `delegate` while retaining durable `taskId` input/output and child-session persistence semantics.
+  - Add configurable `task`, `goal`, `scratchpad`, and `rename_session` built-ins backed by strict session-local CAS state, public controller APIs, attribution context, and durable deletion fencing.
+  - Require `IFlexHarnessStores.projectManagement` independently of tool enablement, with generation-aware CAS tombstones and explicit whole-namespace purge.
+  - Add random durable session generation identity, deterministic legacy backfill, and monotonic generation sequencing so explicit session IDs can be safely reused without stale writes.
+  - Reserve built-in names only while enabled and reject collisions from application and resource providers before model execution.
+  - Bound existing `createSession()` and `updateSession()` title inputs to 2048 UTF-8 bytes.
+
+## 2026-08-14 - 3.8.0
+
+### Features
+
+- add workspace-required turn reversion (harness)
+  - Add a versioned provider contract for revertible, no-change, and nonrevertible workspace outcomes with bounded affected-workspace metadata.
+  - Add workspace-required history grouping, nonrevertible barriers, and public reversion information while preserving the existing transcript-optional policy.
+  - Upgrade projection persistence to schema version 3 with version 1 and 2 loading, durable cleanup ownership, and crash-safe apply and deletion recovery.
+
 ## 2026-08-13 - 3.7.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@modelprofile.com/flexharness',
-    version: '3.7.0',
+    version: '4.0.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, IFlexPromptQueueAdmission, IFlexPromptQueueEntry, IFlexPromptOptions, IFlexPromptResult, IFlexRedoSessionResult, IFlexScheduledPromptAdmission, IFlexSchedulePromptOptions, IFlexSession, IFlexSlashCommandDescriptor, IFlexSlashCommandExecutionOptions, IFlexUncertainToolExecution, IFlexUndoSessionResult, IFlexUpdateSessionOptions, IJsonObject, TFlexHarnessEventListener, TFlexPermissionDecision, TFlexPrompt, TFlexSlashCommandExecutionResult, TFlexToolExecutionReconciliation } from './interfaces.js';
+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';
 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,8 +14,10 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly promptQueueLimits;
     private readonly reversionLimits;
     private readonly turnReversionProvider;
+    private readonly reversionPolicy;
     private readonly externalErrorProjector?;
     private readonly subagents;
+    private readonly builtInTools;
     private readonly slashCommands;
     private readonly maxSubagentDepth;
     private readonly maxSubagentCallsPerRun;
@@ -33,10 +35,12 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly orphanedTombstoneCleanups;
     private readonly orphanedTombstoneOwners;
     private readonly pendingPromptAdmissionOwners;
+    private readonly projectManagementQueues;
     private readonly activeSlashCommandExecutions;
     private readonly activeSlashCommandListings;
     private readonly compactorInvocationContext;
     private readonly slashCommandInvocationContext;
+    private readonly slashCommandActivityContext;
     private readonly deferredCompactorContexts;
     private sequence;
     private promptQueueSequence;
@@ -48,7 +52,21 @@ export declare class FlexHarness<TScope = unknown> {
     listSessions(scopeId: string): Promise<IFlexSession[]>;
     createSession(scopeId: string, options?: IFlexCreateSessionOptions): Promise<IFlexSession>;
     getSession(scopeId: string, sessionId: string): Promise<IFlexSession>;
+    getSessionReversionInfo(scopeId: string, sessionId: string): Promise<IFlexSessionReversionInfo>;
     updateSession(scopeId: string, sessionId: string, options: IFlexUpdateSessionOptions): Promise<IFlexSession>;
+    getProjectState(scopeId: string, sessionId: string): Promise<IFlexProjectStateResult>;
+    listProjectTasks(scopeId: string, sessionId: string): Promise<IFlexProjectTasksResult>;
+    createProjectTask(scopeId: string, sessionId: string, input: IFlexCreateProjectTaskInput): Promise<IFlexProjectTaskResult>;
+    updateProjectTask(scopeId: string, sessionId: string, input: IFlexUpdateProjectTaskInput): Promise<IFlexProjectTaskResult>;
+    deleteProjectTask(scopeId: string, sessionId: string, taskId: string): Promise<IFlexProjectTaskResult>;
+    clearProjectTasks(scopeId: string, sessionId: string): Promise<IFlexProjectTasksResult>;
+    getProjectGoal(scopeId: string, sessionId: string): Promise<IFlexProjectGoalResult>;
+    setProjectGoal(scopeId: string, sessionId: string, goal: string): Promise<IFlexProjectGoalResult>;
+    clearProjectGoal(scopeId: string, sessionId: string): Promise<IFlexProjectGoalResult>;
+    getProjectScratchpad(scopeId: string, sessionId: string): Promise<IFlexProjectScratchpadResult>;
+    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>;
     deleteSession(scopeId: string, sessionId: string): Promise<void>;
     private deleteSessionInternal;
     getMessages(scopeId: string, sessionId: string): Promise<IFlexMessage[]>;
@@ -89,6 +107,7 @@ export declare class FlexHarness<TScope = unknown> {
     undoSession(scopeId: string, sessionId: string, signal?: AbortSignal): Promise<IFlexUndoSessionResult>;
     redoSession(scopeId: string, sessionId: string, signal?: AbortSignal): Promise<IFlexRedoSessionResult>;
     private reversionUnit;
+    private reversionGroups;
     private requireReversionIdle;
     private reversionUnavailableReason;
     private awaitReversionOperation;
@@ -121,7 +140,42 @@ export declare class FlexHarness<TScope = unknown> {
     private purgeStoredPromptQueue;
     private executeRun;
     private finishFailedRun;
+    private requireProjectManagementTools;
+    private projectManagementKey;
+    private queueProjectManagementOperation;
+    private awaitProjectManagementOperations;
+    private resolveProjectManagementSession;
+    private assertProjectManagementSession;
+    private loadProjectManagementState;
+    private readProjectManagementState;
+    private mutateProjectManagementState;
+    private projectStateResult;
+    private projectTaskResult;
+    private projectTasksResult;
+    private projectGoalResult;
+    private projectScratchpadResult;
+    private createProjectTaskInState;
+    private updateProjectTaskInState;
+    private deleteProjectTaskInState;
+    private clearProjectTasksInState;
+    private setProjectGoalInState;
+    private clearProjectGoalInState;
+    private setProjectScratchpadInState;
+    private appendProjectScratchpadInState;
+    private clearProjectScratchpadInState;
     private prepareGeneration;
+    private enabledBuiltInToolNames;
+    private assertNoBuiltInToolCollisions;
+    private createBuiltInTools;
+    private createRenameSessionTool;
+    private createProjectTaskTool;
+    private createProjectGoalTool;
+    private createProjectScratchpadTool;
+    private projectManagementAgentWriteContext;
+    private executeProjectTaskTool;
+    private executeProjectGoalTool;
+    private executeProjectScratchpadTool;
+    private createProjectTaskId;
     private createSubagentTool;
     private executeSubagentTask;
     private acquireSubagentSession;
@@ -131,16 +185,21 @@ export declare class FlexHarness<TScope = unknown> {
     private createReservation;
     private buildTerminal;
     private reversionId;
+    private reversionProviderProtocolVersion;
     private reversionCaptureContext;
     private withReversionMaintenanceSignal;
     private inspectReversionCapture;
     private finalizeReversionCapture;
-    private resolveReversionCaptureReference;
+    private resolveReversionCaptureOutcome;
     private normalizeReversionReference;
+    private normalizeReversionOutcome;
+    private normalizeAffectedWorkspaces;
     private prepareRunReversion;
     private finalizeRunReversion;
+    private applyFinalizedReversionOutcome;
     private hiddenReversionSegments;
     private enqueueReversionRelease;
+    private enqueueReversionReleaseReference;
     private pruneReversionState;
     private commitRevertedBranch;
     private commitRevertedBranchState;
@@ -198,8 +257,10 @@ export declare class FlexHarness<TScope = unknown> {
     private mutatePermissions;
     private createScopeSnapshot;
     private createProjectionSnapshot;
+    private upgradeProjectionSnapshot;
     private reconcileProjectionFromStore;
     private cleanupSessionDomains;
+    private tombstoneProjectManagementSession;
     private collectSessionSubtree;
     private tombstoneGroup;
     private descendantTombstoneRoots;
@@ -236,6 +297,8 @@ export declare class FlexHarness<TScope = unknown> {
     private getScopeAdmission;
     private pruneScopeAdmission;
     private createScopeRetirementError;
+    private ambientSlashCommandOwner;
+    private assertNoAmbientSlashCommandTeardown;
     private assertStateAcceptingWork;
     private createCompactorContext;
     private withCompactorContext;