@modelprofile.com/flexharness 3.7.0 → 3.8.0

package/dist_ts/interfaces.d.ts

@@ -353,7 +353,14 @@ export interface IFlexProjectionSnapshotV1 {
     stagedTerminals: IFlexTerminalProjection[];
 }
 export type TFlexReversionSegmentStatus = 'capturing' | 'completed' | 'failed' | 'cancelled';
-export interface IFlexReversionSegment {
+export type TFlexReversionProtocolVersion = 1 | 2;
+export type TFlexReversionProvenance = 'transcript' | 'workspace';
+export type TFlexReversionDisposition = 'pending' | 'revertible' | 'no-change' | 'nonrevertible';
+export interface IFlexAffectedWorkspace {
+    readonly id: string;
+    readonly label: string;
+}
+interface IFlexReversionSegmentV2 {
     runId: string;
     userMessageId: string;
     status: TFlexReversionSegmentStatus;
@@ -363,12 +370,22 @@ export interface IFlexReversionSegment {
     captureId?: string;
     workspaceReference?: TJsonValue;
 }
-export interface IFlexPendingCaptureReversion {
+export interface IFlexReversionSegment extends IFlexReversionSegmentV2 {
+    protocolVersion: TFlexReversionProtocolVersion;
+    provenance: TFlexReversionProvenance;
+    disposition?: TFlexReversionDisposition;
+    affectedWorkspaces?: IFlexAffectedWorkspace[];
+    reasonCode?: string;
+}
+interface IFlexPendingCaptureReversionV2 {
     kind: 'capture';
     runId: string;
     captureId: string;
     state: 'preparing' | 'prepared' | 'finalizing';
 }
+export interface IFlexPendingCaptureReversion extends IFlexPendingCaptureReversionV2 {
+    protocolVersion: TFlexReversionProtocolVersion;
+}
 export interface IFlexPendingApplyReversion {
     kind: 'apply';
     operationId: string;
@@ -378,26 +395,41 @@ export interface IFlexPendingApplyReversion {
     segmentRunIds: string[];
     appliedRunIds: string[];
 }
+type TFlexPendingReversionV2 = IFlexPendingCaptureReversionV2 | IFlexPendingApplyReversion;
 export type TFlexPendingReversion = IFlexPendingCaptureReversion | IFlexPendingApplyReversion;
-export interface IFlexPendingReversionRelease {
+interface IFlexPendingReversionReleaseV2 {
     runId: string;
     captureId: string;
     reference: TJsonValue;
 }
+export interface IFlexPendingReversionRelease extends IFlexPendingReversionReleaseV2 {
+    protocolVersion: TFlexReversionProtocolVersion;
+}
 export interface IFlexProjectionSnapshotV2 {
     schemaVersion: 2;
     revision: number;
     messages: IFlexMessage[];
     stagedTerminals: IFlexTerminalProjection[];
+    reversionSegments: IFlexReversionSegmentV2[];
+    revertCursor: number;
+    excludedRunIds: string[];
+    pendingReversion?: TFlexPendingReversionV2;
+    pendingReversionReleases: IFlexPendingReversionReleaseV2[];
+}
+export interface IFlexProjectionSnapshotV3 {
+    schemaVersion: 3;
+    revision: number;
+    messages: IFlexMessage[];
+    stagedTerminals: IFlexTerminalProjection[];
     reversionSegments: IFlexReversionSegment[];
     revertCursor: number;
     excludedRunIds: string[];
     pendingReversion?: TFlexPendingReversion;
     pendingReversionReleases: IFlexPendingReversionRelease[];
 }
-export type IFlexProjectionSnapshot = IFlexProjectionSnapshotV1 | IFlexProjectionSnapshotV2;
+export type IFlexProjectionSnapshot = IFlexProjectionSnapshotV1 | IFlexProjectionSnapshotV2 | IFlexProjectionSnapshotV3;
 export type TFlexProjectionSnapshot = IFlexProjectionSnapshot;
-export type IFlexProjectionSnapshotCurrent = IFlexProjectionSnapshotV2;
+export type IFlexProjectionSnapshotCurrent = IFlexProjectionSnapshotV3;
 export interface IFlexPermissionSnapshot {
     schemaVersion: 1;
     revision: number;
@@ -469,6 +501,10 @@ export declare const FLEX_REVERSION_MAXIMUM_LIMITS: Readonly<{
     maxPendingReversionReleases: 10000;
 }>;
 export declare const FLEX_REVERSION_REFERENCE_MAX_BYTES: number;
+export declare const FLEX_REVERSION_MAX_AFFECTED_WORKSPACES = 64;
+export declare const FLEX_REVERSION_WORKSPACE_ID_MAX_BYTES = 512;
+export declare const FLEX_REVERSION_WORKSPACE_LABEL_MAX_BYTES = 2048;
+export declare const FLEX_REVERSION_REASON_CODE_MAX_BYTES = 128;
 export interface IFlexTurnReversionBaseContext<TScope> {
     readonly scopeId: string;
     readonly scope: TScope;
@@ -501,6 +537,52 @@ export interface IFlexTurnReversionProvider<TScope> {
     inspectApply(context: IFlexTurnReversionApplyContext<TScope>): Promise<IFlexTurnReversionApplyInspection> | IFlexTurnReversionApplyInspection;
     release(context: IFlexTurnReversionReleaseContext<TScope>): Promise<void> | void;
 }
+export interface IFlexTurnReversionRevertibleOutcome {
+    readonly disposition: 'revertible';
+    readonly reference: TJsonValue;
+    readonly affectedWorkspaces: readonly IFlexAffectedWorkspace[];
+}
+export interface IFlexTurnReversionNoChangeOutcome {
+    readonly disposition: 'no-change';
+    readonly reference: TJsonValue;
+    readonly affectedWorkspaces?: readonly [];
+}
+export interface IFlexTurnReversionNonrevertibleOutcome {
+    readonly disposition: 'nonrevertible';
+    readonly reference: TJsonValue;
+    readonly reasonCode: string;
+    readonly affectedWorkspaces?: readonly IFlexAffectedWorkspace[];
+}
+export type TFlexTurnReversionFinalizedOutcome = IFlexTurnReversionRevertibleOutcome | IFlexTurnReversionNoChangeOutcome | IFlexTurnReversionNonrevertibleOutcome;
+export type TFlexTurnReversionCaptureInspectionV2 = {
+    readonly status: 'missing' | 'prepared' | 'unknown';
+} | {
+    readonly status: 'finalized';
+    readonly outcome: TFlexTurnReversionFinalizedOutcome;
+};
+export interface IFlexTurnReversionProviderV2<TScope> {
+    readonly protocolVersion: 2;
+    prepare(context: IFlexTurnReversionBaseContext<TScope>): Promise<void> | void;
+    inspectCapture(context: IFlexTurnReversionBaseContext<TScope>): Promise<TFlexTurnReversionCaptureInspectionV2> | TFlexTurnReversionCaptureInspectionV2;
+    finalize(context: IFlexTurnReversionBaseContext<TScope>): Promise<TFlexTurnReversionFinalizedOutcome> | TFlexTurnReversionFinalizedOutcome;
+    apply(context: IFlexTurnReversionApplyContext<TScope>): Promise<void> | void;
+    inspectApply(context: IFlexTurnReversionApplyContext<TScope>): Promise<IFlexTurnReversionApplyInspection> | IFlexTurnReversionApplyInspection;
+    release(context: IFlexTurnReversionReleaseContext<TScope>): Promise<void> | void;
+}
+export type TFlexReversionPolicy = 'transcript-optional' | 'workspace-required';
+export type TFlexSessionReversionGroupKind = 'candidate' | 'barrier' | 'no-change';
+export interface IFlexSessionReversionGroup {
+    readonly runId: string;
+    readonly kind: TFlexSessionReversionGroupKind;
+    readonly visibility: 'visible' | 'hidden';
+    readonly affectedWorkspaces: readonly IFlexAffectedWorkspace[];
+    readonly affectedWorkspacesTruncated: boolean;
+}
+export interface IFlexSessionReversionInfo {
+    readonly undoAvailable: boolean;
+    readonly redoAvailable: boolean;
+    readonly groups: readonly IFlexSessionReversionGroup[];
+}
 export interface IFlexUndoSessionResult {
     revertedRunId: string;
 }
@@ -567,7 +649,8 @@ export interface IFlexHarnessOptions<TScope> {
     callbackLimits?: IFlexCallbackLimits;
     promptQueueLimits?: IFlexPromptQueueLimits;
     reversionLimits?: IFlexReversionLimits;
-    turnReversionProvider?: IFlexTurnReversionProvider<TScope>;
+    turnReversionProvider?: IFlexTurnReversionProvider<TScope> | IFlexTurnReversionProviderV2<TScope>;
+    reversionPolicy?: TFlexReversionPolicy;
     externalErrorProjector?: TFlexExternalErrorProjector;
     subagents?: IFlexSubagentDefinition[];
     slashCommands?: readonly TFlexSlashCommandRegistration<TScope>[];
@@ -684,3 +767,4 @@ export interface IFlexErrorInfo {
 }
 export type TFlexHarnessEvent = IFlexSessionCreatedEvent | IFlexSessionUpdatedEvent | IFlexSessionDeletedEvent | IFlexRunStartedEvent | IFlexMessageChangedEvent | IFlexPartChangedEvent | IFlexPermissionRequestedEvent | IFlexPermissionResolvedEvent | IFlexRunFinishedEvent | IFlexPromptQueueEvent | IFlexSessionHistoryChangedEvent;
 export type TFlexHarnessEventListener = (event: TFlexHarnessEvent) => void;
+export {};

package/dist_ts/interfaces.js

@@ -11,4 +11,8 @@ export const FLEX_REVERSION_MAXIMUM_LIMITS = Object.freeze({
     maxPendingReversionReleases: 10_000,
 });
 export const FLEX_REVERSION_REFERENCE_MAX_BYTES = 256 * 1024;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBOGxCQSxNQUFNLENBQUMsTUFBTSw2QkFBNkIsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDO0lBQ3pELGlCQUFpQixFQUFFLEdBQUc7SUFDdEIsV0FBVyxFQUFFLEdBQUc7SUFDaEIsaUJBQWlCLEVBQUUsSUFBSTtJQUN2QiwyQkFBMkIsRUFBRSxJQUFJO0NBQ2xDLENBQUMsQ0FBQztBQUVILE1BQU0sQ0FBQyxNQUFNLDZCQUE2QixHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDekQsaUJBQWlCLEVBQUUsSUFBSTtJQUN2QixXQUFXLEVBQUUsSUFBSTtJQUNqQixpQkFBaUIsRUFBRSxNQUFNO0lBQ3pCLDJCQUEyQixFQUFFLE1BQU07Q0FDcEMsQ0FBQyxDQUFDO0FBRUgsTUFBTSxDQUFDLE1BQU0sa0NBQWtDLEdBQUcsR0FBRyxHQUFHLElBQUksQ0FBQyJ9
+export const FLEX_REVERSION_MAX_AFFECTED_WORKSPACES = 64;
+export const FLEX_REVERSION_WORKSPACE_ID_MAX_BYTES = 512;
+export const FLEX_REVERSION_WORKSPACE_LABEL_MAX_BYTES = 2048;
+export const FLEX_REVERSION_REASON_CODE_MAX_BYTES = 128;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBeW9CQSxNQUFNLENBQUMsTUFBTSw2QkFBNkIsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDO0lBQ3pELGlCQUFpQixFQUFFLEdBQUc7SUFDdEIsV0FBVyxFQUFFLEdBQUc7SUFDaEIsaUJBQWlCLEVBQUUsSUFBSTtJQUN2QiwyQkFBMkIsRUFBRSxJQUFJO0NBQ2xDLENBQUMsQ0FBQztBQUVILE1BQU0sQ0FBQyxNQUFNLDZCQUE2QixHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDekQsaUJBQWlCLEVBQUUsSUFBSTtJQUN2QixXQUFXLEVBQUUsSUFBSTtJQUNqQixpQkFBaUIsRUFBRSxNQUFNO0lBQ3pCLDJCQUEyQixFQUFFLE1BQU07Q0FDcEMsQ0FBQyxDQUFDO0FBRUgsTUFBTSxDQUFDLE1BQU0sa0NBQWtDLEdBQUcsR0FBRyxHQUFHLElBQUksQ0FBQztBQUM3RCxNQUFNLENBQUMsTUFBTSxzQ0FBc0MsR0FBRyxFQUFFLENBQUM7QUFDekQsTUFBTSxDQUFDLE1BQU0scUNBQXFDLEdBQUcsR0FBRyxDQUFDO0FBQ3pELE1BQU0sQ0FBQyxNQUFNLHdDQUF3QyxHQUFHLElBQUksQ0FBQztBQUM3RCxNQUFNLENBQUMsTUFBTSxvQ0FBb0MsR0FBRyxHQUFHLENBQUMifQ==

package/dist_ts/utils.json.d.ts

@@ -1,11 +1,12 @@
-import type { IFlexJsonLimits, IFlexPermissionSnapshot, IFlexProjectionSnapshotV1, IFlexProjectionSnapshotV2, IFlexScopeSnapshot, TFlexAgentModelMessage, TJsonValue } from './interfaces.js';
+import type { IFlexJsonLimits, IFlexPermissionSnapshot, IFlexProjectionSnapshotV1, IFlexProjectionSnapshotV2, IFlexProjectionSnapshotV3, IFlexScopeSnapshot, TFlexAgentModelMessage, TJsonValue } from './interfaces.js';
 export declare function resolveJsonLimits(limits?: IFlexJsonLimits): Required<IFlexJsonLimits>;
 export declare function normalizeJsonValue(value: unknown, limits?: IFlexJsonLimits): TJsonValue;
 export declare function assertJsonSerializable(value: unknown, path?: string): void;
 export declare function assertFlexScopeSnapshot(value: unknown): asserts value is IFlexScopeSnapshot;
 export declare function assertFlexProjectionSnapshotV1(value: unknown): asserts value is IFlexProjectionSnapshotV1;
 export declare function assertFlexProjectionSnapshotV2(value: unknown): asserts value is IFlexProjectionSnapshotV2;
-export declare function assertFlexProjectionSnapshot(value: unknown): asserts value is IFlexProjectionSnapshotV1 | IFlexProjectionSnapshotV2;
+export declare function assertFlexProjectionSnapshotV3(value: unknown): asserts value is IFlexProjectionSnapshotV3;
+export declare function assertFlexProjectionSnapshot(value: unknown): asserts value is IFlexProjectionSnapshotV1 | IFlexProjectionSnapshotV2 | IFlexProjectionSnapshotV3;
 export declare function assertFlexPermissionSnapshot(value: unknown): asserts value is IFlexPermissionSnapshot;
 export declare function cloneSerializable<T>(value: T): T;
 export declare function deepFreeze<T>(value: T): T;