@modelprofile.com/flexharness 3.8.0 → 4.0.0

package/changelog.md

@@ -1,5 +1,17 @@
 # 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

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@modelprofile.com/flexharness',
-    version: '3.8.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, IFlexSessionReversionInfo, 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> {
@@ -17,6 +17,7 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly reversionPolicy;
     private readonly externalErrorProjector?;
     private readonly subagents;
+    private readonly builtInTools;
     private readonly slashCommands;
     private readonly maxSubagentDepth;
     private readonly maxSubagentCallsPerRun;
@@ -34,6 +35,7 @@ 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;
@@ -52,6 +54,19 @@ export declare class FlexHarness<TScope = unknown> {
     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[]>;
@@ -125,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;
@@ -210,6 +260,7 @@ export declare class FlexHarness<TScope = unknown> {
     private upgradeProjectionSnapshot;
     private reconcileProjectionFromStore;
     private cleanupSessionDomains;
+    private tombstoneProjectManagementSession;
     private collectSessionSubtree;
     private tombstoneGroup;
     private descendantTombstoneRoots;