@modelprofile.com/flexharness 3.6.0 → 3.7.0

package/changelog.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 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.7.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, 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,11 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly toolOutputLimits;
     private readonly callbackLimits;
     private readonly promptQueueLimits;
+    private readonly reversionLimits;
+    private readonly turnReversionProvider;
     private readonly externalErrorProjector?;
     private readonly subagents;
+    private readonly slashCommands;
     private readonly maxSubagentDepth;
     private readonly maxSubagentCallsPerRun;
     private readonly stateLoads;
@@ -28,8 +31,12 @@ 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 deferredCompactorContexts;
     private sequence;
     private promptQueueSequence;
@@ -47,6 +54,20 @@ export declare class FlexHarness<TScope = unknown> {
     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 +85,19 @@ 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 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 +130,24 @@ export declare class FlexHarness<TScope = unknown> {
     private abortExactRun;
     private createReservation;
     private buildTerminal;
+    private reversionId;
+    private reversionCaptureContext;
+    private withReversionMaintenanceSignal;
+    private inspectReversionCapture;
+    private finalizeReversionCapture;
+    private resolveReversionCaptureReference;
+    private normalizeReversionReference;
+    private prepareRunReversion;
+    private finalizeRunReversion;
+    private hiddenReversionSegments;
+    private enqueueReversionRelease;
+    private pruneReversionState;
+    private commitRevertedBranch;
+    private commitRevertedBranchState;
+    private commitArchivedHiddenBranchState;
+    private filterReversionContextEvents;
+    private drainReversionReleases;
+    private releaseDeletedSessionReversions;
     private promoteCompletedTerminal;
     private publishFailedTerminal;
     private replaceStagedTerminal;
@@ -146,6 +198,7 @@ export declare class FlexHarness<TScope = unknown> {
     private mutatePermissions;
     private createScopeSnapshot;
     private createProjectionSnapshot;
+    private reconcileProjectionFromStore;
     private cleanupSessionDomains;
     private collectSessionSubtree;
     private tombstoneGroup;
@@ -155,6 +208,7 @@ export declare class FlexHarness<TScope = unknown> {
     private finishTombstoneCleanupInternal;
     private fenceNamespace;
     private deferNamespaceDrain;
+    private deferReversionReleaseDrain;
     private sessionsAreDependencyRelated;
     private isSessionAncestor;
     private sessionAncestryDepth;
@@ -174,6 +228,8 @@ export declare class FlexHarness<TScope = unknown> {
     private drainStorage;
     private drainStorageInternal;
     private disposeInternal;
+    private abortSlashCommandExecutions;
+    private abortSlashCommandListings;
     private appendUnexpectedErrors;
     private abortCompactorLifecycle;
     private resolveState;
@@ -187,6 +243,8 @@ export declare class FlexHarness<TScope = unknown> {
     private effectiveRunCompactorContext;
     private withRunCompactorContext;
     private requireSession;
+    private completedReversionCandidates;
+    private visibleMessages;
     private requireMutableSession;
     private requireMessage;
     private isTombstoned;