@modelprofile.com/flexharness 3.6.0 → 3.8.0

package/changelog.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 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
+
+- add native slash commands and turn reversion (harness)
+  - Add built-in, template, and typed-handler slash commands with authoritative parsing, availability, execution, and literal unknown-command fallback.
+  - Add durable grouped undo and redo with optional workspace capture, crash recovery, branch commitment, release ownership, and archival horizons.
+  - Upgrade projection persistence to schema version 2 while preserving version 1 loading, and document the public command and reversion contracts.
+
 ## 2026-08-13 - 3.6.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@modelprofile.com/flexharness',
-    version: '3.6.0',
+    version: '3.8.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, IFlexScheduledPromptAdmission, IFlexSchedulePromptOptions, IFlexSession, IFlexUncertainToolExecution, IFlexUpdateSessionOptions, IJsonObject, TFlexHarnessEventListener, TFlexPermissionDecision, TFlexPrompt, TFlexToolExecutionReconciliation } from './interfaces.js';
+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';
 export declare function createFlexResourceToolNamespace(resourceId: string, attachmentRevision: number): string;
 export declare function createFlexResourceToolName(namespace: string, toolName: string): string;
 export declare class FlexHarness<TScope = unknown> {
@@ -12,8 +12,12 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly toolOutputLimits;
     private readonly callbackLimits;
     private readonly promptQueueLimits;
+    private readonly reversionLimits;
+    private readonly turnReversionProvider;
+    private readonly reversionPolicy;
     private readonly externalErrorProjector?;
     private readonly subagents;
+    private readonly slashCommands;
     private readonly maxSubagentDepth;
     private readonly maxSubagentCallsPerRun;
     private readonly stateLoads;
@@ -28,8 +32,13 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly orphanedExecutionContexts;
     private readonly orphanedProviderReleases;
     private readonly orphanedTombstoneCleanups;
+    private readonly orphanedTombstoneOwners;
     private readonly pendingPromptAdmissionOwners;
+    private readonly activeSlashCommandExecutions;
+    private readonly activeSlashCommandListings;
     private readonly compactorInvocationContext;
+    private readonly slashCommandInvocationContext;
+    private readonly slashCommandActivityContext;
     private readonly deferredCompactorContexts;
     private sequence;
     private promptQueueSequence;
@@ -41,12 +50,27 @@ 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>;
     deleteSession(scopeId: string, sessionId: string): Promise<void>;
     private deleteSessionInternal;
     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>;
+    listSlashCommands(scopeId: string, sessionId: string): Promise<IFlexSlashCommandDescriptor[]>;
+    private createSlashCommandDescriptors;
+    executeSlashCommand(scopeId: string, sessionId: string, untouchedInput: string, options?: IFlexSlashCommandExecutionOptions): Promise<TFlexSlashCommandExecutionResult>;
+    private isSessionAvailableForSlashCommand;
+    private slashCommandPromptUnavailableReason;
+    private slashCommandPromptAvailability;
+    private requireSlashCommandPromptAvailable;
+    private promptAdmissionByteSize;
+    private isSessionRuntimeIdle;
+    private slashCommandSessionKey;
+    private requireSessionAvailableForSlashCommand;
+    private trackSlashCommandExecution;
+    private trackSlashCommandListing;
+    private executeSlashCommandHandler;
     prompt(scopeId: string, sessionId: string, prompt: TFlexPrompt, options?: IFlexPromptOptions): Promise<IFlexPromptResult>;
     startPrompt(scopeId: string, sessionId: string, prompt: TFlexPrompt, options?: IFlexPromptOptions): Promise<IFlexPromptAdmission>;
     enqueuePrompt(scopeId: string, sessionId: string, prompt: TFlexPrompt, options?: IFlexPromptOptions): Promise<IFlexPromptQueueAdmission>;
@@ -64,6 +88,20 @@ export declare class FlexHarness<TScope = unknown> {
         type: string;
     }): Promise<void>;
     compactSession(scopeId: string, sessionId: string): Promise<void>;
+    private compactStoredSession;
+    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;
+    private changeReversionCursor;
+    private changeReversionCursorResolved;
+    private reconcileContextAvailability;
+    private resumePendingApply;
+    private persistKnownNotApplied;
+    private recoverPendingCapture;
     archiveSessionEvents(scopeId: string, sessionId: string, compactionEventId?: string): Promise<IFlexEventArchiveMetadata | undefined>;
     listBackgroundExecutions(scopeId: string, sessionId: string): Promise<IFlexBackgroundExecution[]>;
     getBackgroundExecution(scopeId: string, sessionId: string, executionId: string): Promise<IFlexBackgroundExecution>;
@@ -96,6 +134,29 @@ export declare class FlexHarness<TScope = unknown> {
     private abortExactRun;
     private createReservation;
     private buildTerminal;
+    private reversionId;
+    private reversionProviderProtocolVersion;
+    private reversionCaptureContext;
+    private withReversionMaintenanceSignal;
+    private inspectReversionCapture;
+    private finalizeReversionCapture;
+    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;
+    private commitArchivedHiddenBranchState;
+    private filterReversionContextEvents;
+    private drainReversionReleases;
+    private releaseDeletedSessionReversions;
     private promoteCompletedTerminal;
     private publishFailedTerminal;
     private replaceStagedTerminal;
@@ -146,6 +207,8 @@ export declare class FlexHarness<TScope = unknown> {
     private mutatePermissions;
     private createScopeSnapshot;
     private createProjectionSnapshot;
+    private upgradeProjectionSnapshot;
+    private reconcileProjectionFromStore;
     private cleanupSessionDomains;
     private collectSessionSubtree;
     private tombstoneGroup;
@@ -155,6 +218,7 @@ export declare class FlexHarness<TScope = unknown> {
     private finishTombstoneCleanupInternal;
     private fenceNamespace;
     private deferNamespaceDrain;
+    private deferReversionReleaseDrain;
     private sessionsAreDependencyRelated;
     private isSessionAncestor;
     private sessionAncestryDepth;
@@ -174,12 +238,16 @@ export declare class FlexHarness<TScope = unknown> {
     private drainStorage;
     private drainStorageInternal;
     private disposeInternal;
+    private abortSlashCommandExecutions;
+    private abortSlashCommandListings;
     private appendUnexpectedErrors;
     private abortCompactorLifecycle;
     private resolveState;
     private getScopeAdmission;
     private pruneScopeAdmission;
     private createScopeRetirementError;
+    private ambientSlashCommandOwner;
+    private assertNoAmbientSlashCommandTeardown;
     private assertStateAcceptingWork;
     private createCompactorContext;
     private withCompactorContext;
@@ -187,6 +255,8 @@ export declare class FlexHarness<TScope = unknown> {
     private effectiveRunCompactorContext;
     private withRunCompactorContext;
     private requireSession;
+    private completedReversionCandidates;
+    private visibleMessages;
     private requireMutableSession;
     private requireMessage;
     private isTombstoned;