@modelprofile.com/flexharness 3.7.0 → 4.0.0

package/dist_ts/interfaces.d.ts

@@ -104,6 +104,8 @@ export interface IFlexSessionActivity {
 export interface IFlexSession {
     scopeId: string;
     sessionId: string;
+    sessionGenerationId?: string;
+    sessionGenerationSequence?: number;
     title?: string;
     createdAt: string;
     updatedAt: string;
@@ -325,6 +327,8 @@ export interface IFlexResourceToolProviderResolver<TScope> {
 }
 export interface IFlexSessionTombstone {
     sessionId: string;
+    sessionGenerationId?: string;
+    sessionGenerationSequence?: number;
     deletedAt: string;
     rootSessionId?: string;
     depth?: number;
@@ -353,7 +357,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 +374,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,31 +399,125 @@ 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;
     rememberedPermissionKeys: string[];
 }
+export declare const FLEX_PROJECT_MANAGEMENT_SCHEMA_VERSION: 1;
+export declare const FLEX_SESSION_GENERATION_ID_MAX_BYTES = 128;
+export declare const FLEX_PROJECT_MANAGEMENT_LIMITS: Readonly<{
+    maxGoalBytes: number;
+    maxScratchpadBytes: number;
+    maxTaskContentBytes: number;
+    maxTaskIdBytes: 512;
+    maxTasks: 512;
+    maxTitleBytes: 2048;
+    maxSnapshotBytes: number;
+}>;
+export type TFlexProjectTaskStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled';
+export type TFlexProjectTaskPriority = 'high' | 'medium' | 'low';
+export interface IFlexProjectTask {
+    id: string;
+    content: string;
+    status: TFlexProjectTaskStatus;
+    priority: TFlexProjectTaskPriority;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface IFlexProjectManagementSnapshot {
+    schemaVersion: 1;
+    revision: number;
+    sessionGenerationId: string;
+    sessionGenerationSequence: number;
+    goal?: string;
+    scratchpad: string;
+    tasks: IFlexProjectTask[];
+}
+export interface IFlexProjectManagementTombstone {
+    schemaVersion: 1;
+    revision: number;
+    sessionGenerationId: string;
+    sessionGenerationSequence: number;
+    deletedAt: string;
+}
+export type TFlexProjectManagementRecord = IFlexProjectManagementSnapshot | IFlexProjectManagementTombstone;
+export type TFlexProjectManagementWriteActor = 'agent' | 'application';
+export interface IFlexProjectManagementWriteContext {
+    actor: TFlexProjectManagementWriteActor;
+    runId?: string;
+    agent?: string;
+    toolCallId?: string;
+}
+export interface IFlexProjectManagementStore {
+    load(storageKey: string, sessionId: string): Promise<TFlexProjectManagementRecord | undefined>;
+    save(storageKey: string, sessionId: string, snapshot: IFlexProjectManagementSnapshot, expectedRevision: number, writeContext: IFlexProjectManagementWriteContext): Promise<void>;
+    tombstoneSession(storageKey: string, sessionId: string, tombstone: IFlexProjectManagementTombstone, expectedRevision: number): Promise<void>;
+    purgeNamespace(storageKey: string): Promise<void>;
+}
+export interface IFlexCreateProjectTaskInput {
+    id: string;
+    content: string;
+    status?: TFlexProjectTaskStatus;
+    priority?: TFlexProjectTaskPriority;
+}
+export interface IFlexUpdateProjectTaskInput {
+    id: string;
+    content?: string;
+    status?: TFlexProjectTaskStatus;
+    priority?: TFlexProjectTaskPriority;
+}
+export interface IFlexProjectStateResult {
+    revision: number;
+    state: IFlexProjectManagementSnapshot;
+}
+export interface IFlexProjectTaskResult extends IFlexProjectStateResult {
+    task: IFlexProjectTask;
+}
+export interface IFlexProjectTasksResult extends IFlexProjectStateResult {
+    tasks: IFlexProjectTask[];
+}
+export interface IFlexProjectGoalResult extends IFlexProjectStateResult {
+    goal: string | null;
+}
+export interface IFlexProjectScratchpadResult extends IFlexProjectStateResult {
+    scratchpad: string;
+}
 export interface IFlexScopeStore {
     load(storageKey: string): Promise<IFlexScopeSnapshot | undefined>;
     save(storageKey: string, snapshot: IFlexScopeSnapshot, expectedRevision: number): Promise<void>;
@@ -431,6 +546,7 @@ export interface IFlexHarnessStores {
     scopes: IFlexScopeStore;
     projections: IFlexProjectionStore;
     permissions: IFlexPermissionStore;
+    projectManagement: IFlexProjectManagementStore;
     agentEvents: IFlexAgentEventStoreProvider;
     jobs: IFlexToolJobStoreProvider;
 }
@@ -469,6 +585,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 +621,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;
 }
@@ -555,6 +721,15 @@ export interface IFlexSubagentDefinition {
     system?: string;
     maxSteps?: number;
 }
+export interface IFlexProjectManagementBuiltInToolsOptions {
+    task?: boolean;
+    goal?: boolean;
+    scratchpad?: boolean;
+}
+export interface IFlexBuiltInToolsOptions {
+    renameSession?: boolean;
+    projectManagement?: IFlexProjectManagementBuiltInToolsOptions;
+}
 export interface IFlexHarnessOptions<TScope> {
     scopeResolver: IFlexScopeResolver<TScope>;
     modelResolver: IFlexModelResolver<TScope>;
@@ -567,9 +742,11 @@ export interface IFlexHarnessOptions<TScope> {
     callbackLimits?: IFlexCallbackLimits;
     promptQueueLimits?: IFlexPromptQueueLimits;
     reversionLimits?: IFlexReversionLimits;
-    turnReversionProvider?: IFlexTurnReversionProvider<TScope>;
+    turnReversionProvider?: IFlexTurnReversionProvider<TScope> | IFlexTurnReversionProviderV2<TScope>;
+    reversionPolicy?: TFlexReversionPolicy;
     externalErrorProjector?: TFlexExternalErrorProjector;
     subagents?: IFlexSubagentDefinition[];
+    builtInTools?: IFlexBuiltInToolsOptions;
     slashCommands?: readonly TFlexSlashCommandRegistration<TScope>[];
     maxSubagentDepth?: number;
     maxSubagentCallsPerRun?: number;
@@ -684,3 +861,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

@@ -1,3 +1,14 @@
+export const FLEX_PROJECT_MANAGEMENT_SCHEMA_VERSION = 1;
+export const FLEX_SESSION_GENERATION_ID_MAX_BYTES = 128;
+export const FLEX_PROJECT_MANAGEMENT_LIMITS = Object.freeze({
+    maxGoalBytes: 8 * 1024,
+    maxScratchpadBytes: 64 * 1024,
+    maxTaskContentBytes: 8 * 1024,
+    maxTaskIdBytes: 512,
+    maxTasks: 512,
+    maxTitleBytes: 2048,
+    maxSnapshotBytes: 96 * 1024,
+});
 export const FLEX_REVERSION_DEFAULT_LIMITS = Object.freeze({
     maxCompletedTurns: 100,
     maxSegments: 300,
@@ -11,4 +22,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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBMGpCQSxNQUFNLENBQUMsTUFBTSxzQ0FBc0MsR0FBRyxDQUFVLENBQUM7QUFDakUsTUFBTSxDQUFDLE1BQU0sb0NBQW9DLEdBQUcsR0FBRyxDQUFDO0FBRXhELE1BQU0sQ0FBQyxNQUFNLDhCQUE4QixHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDMUQsWUFBWSxFQUFFLENBQUMsR0FBRyxJQUFJO0lBQ3RCLGtCQUFrQixFQUFFLEVBQUUsR0FBRyxJQUFJO0lBQzdCLG1CQUFtQixFQUFFLENBQUMsR0FBRyxJQUFJO0lBQzdCLGNBQWMsRUFBRSxHQUFHO0lBQ25CLFFBQVEsRUFBRSxHQUFHO0lBQ2IsYUFBYSxFQUFFLElBQUk7SUFDbkIsZ0JBQWdCLEVBQUUsRUFBRSxHQUFHLElBQUk7Q0FDNUIsQ0FBQyxDQUFDO0FBeUxILE1BQU0sQ0FBQyxNQUFNLDZCQUE2QixHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDekQsaUJBQWlCLEVBQUUsR0FBRztJQUN0QixXQUFXLEVBQUUsR0FBRztJQUNoQixpQkFBaUIsRUFBRSxJQUFJO0lBQ3ZCLDJCQUEyQixFQUFFLElBQUk7Q0FDbEMsQ0FBQyxDQUFDO0FBRUgsTUFBTSxDQUFDLE1BQU0sNkJBQTZCLEdBQUcsTUFBTSxDQUFDLE1BQU0sQ0FBQztJQUN6RCxpQkFBaUIsRUFBRSxJQUFJO0lBQ3ZCLFdBQVcsRUFBRSxJQUFJO0lBQ2pCLGlCQUFpQixFQUFFLE1BQU07SUFDekIsMkJBQTJCLEVBQUUsTUFBTTtDQUNwQyxDQUFDLENBQUM7QUFFSCxNQUFNLENBQUMsTUFBTSxrQ0FBa0MsR0FBRyxHQUFHLEdBQUcsSUFBSSxDQUFDO0FBQzdELE1BQU0sQ0FBQyxNQUFNLHNDQUFzQyxHQUFHLEVBQUUsQ0FBQztBQUN6RCxNQUFNLENBQUMsTUFBTSxxQ0FBcUMsR0FBRyxHQUFHLENBQUM7QUFDekQsTUFBTSxDQUFDLE1BQU0sd0NBQXdDLEdBQUcsSUFBSSxDQUFDO0FBQzdELE1BQU0sQ0FBQyxNQUFNLG9DQUFvQyxHQUFHLEdBQUcsQ0FBQyJ9

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;