@cogitator-ai/types 0.3.1 → 0.5.0

package/dist/time-travel.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Time-Travel Debugging types for Cogitator
+ *
+ * Enables:
+ * - Checkpointing execution state at any step
+ * - Replaying execution from checkpoints (deterministic or live)
+ * - Forking execution with modified context/tool results
+ * - Comparing execution traces step by step
+ */
+import type { Message, ToolCall } from './message';
+import type { RunResult } from './runtime';
+import type { ExecutionStep } from './learning';
+export type ReplayMode = 'deterministic' | 'live';
+export type StepDiffStatus = 'identical' | 'similar' | 'different' | 'only_in_1' | 'only_in_2';
+export interface ExecutionCheckpoint {
+    id: string;
+    traceId: string;
+    runId: string;
+    agentId: string;
+    stepIndex: number;
+    messages: Message[];
+    toolResults: Record<string, unknown>;
+    pendingToolCalls: ToolCall[];
+    label?: string;
+    createdAt: Date;
+    metadata?: Record<string, unknown>;
+}
+export interface CheckpointQuery {
+    agentId?: string;
+    traceId?: string;
+    runId?: string;
+    label?: string;
+    before?: Date;
+    after?: Date;
+    limit?: number;
+}
+export interface TimeTravelCheckpointStore {
+    save(checkpoint: ExecutionCheckpoint): Promise<void>;
+    load(id: string): Promise<ExecutionCheckpoint | null>;
+    list(query: CheckpointQuery): Promise<ExecutionCheckpoint[]>;
+    delete(id: string): Promise<boolean>;
+    getByTrace(traceId: string): Promise<ExecutionCheckpoint[]>;
+    getByAgent(agentId: string, limit?: number): Promise<ExecutionCheckpoint[]>;
+    getByLabel(label: string): Promise<ExecutionCheckpoint[]>;
+    clear(agentId?: string): Promise<void>;
+}
+export interface ReplayOptions {
+    fromCheckpoint: string;
+    mode: ReplayMode;
+    modifiedMessages?: Message[];
+    modifiedToolResults?: Record<string, unknown>;
+    skipTools?: string[];
+    onStep?: (step: ExecutionStep, index: number) => void;
+    pauseAt?: number;
+}
+export interface ReplayResult extends RunResult {
+    replayedFrom: string;
+    originalTraceId: string;
+    divergedAt?: number;
+    stepsReplayed: number;
+    stepsExecuted: number;
+}
+export interface ForkOptions {
+    checkpointId: string;
+    input?: string;
+    additionalContext?: string;
+    mockToolResults?: Record<string, unknown>;
+    label?: string;
+}
+export interface ForkResult {
+    forkId: string;
+    checkpoint: ExecutionCheckpoint;
+    result: ReplayResult;
+}
+export interface StepDiff {
+    index: number;
+    status: StepDiffStatus;
+    step1?: ExecutionStep;
+    step2?: ExecutionStep;
+    differences?: string[];
+}
+export interface TraceDiff {
+    trace1Id: string;
+    trace2Id: string;
+    stepDiffs: StepDiff[];
+    commonSteps: number;
+    divergencePoint?: number;
+    trace1OnlySteps: number;
+    trace2OnlySteps: number;
+    metricsDiff: {
+        success: {
+            trace1: boolean;
+            trace2: boolean;
+        };
+        score: {
+            trace1: number;
+            trace2: number;
+            delta: number;
+        };
+        tokens: {
+            trace1: number;
+            trace2: number;
+            delta: number;
+        };
+        duration: {
+            trace1: number;
+            trace2: number;
+            delta: number;
+        };
+    };
+}
+export interface TimeTravelConfig {
+    autoCheckpoint?: boolean;
+    autoCheckpointInterval?: number;
+    maxCheckpointsPerTrace?: number;
+    checkpointRetention?: number;
+}
+export declare const DEFAULT_TIME_TRAVEL_CONFIG: TimeTravelConfig;
+//# sourceMappingURL=time-travel.d.ts.map

package/dist/time-travel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-travel.d.ts","sourceRoot":"","sources":["../src/time-travel.ts"],"names":[],"mappings":"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"}

package/dist/time-travel.js

@@ -0,0 +1,16 @@
+/**
+ * Time-Travel Debugging types for Cogitator
+ *
+ * Enables:
+ * - Checkpointing execution state at any step
+ * - Replaying execution from checkpoints (deterministic or live)
+ * - Forking execution with modified context/tool results
+ * - Comparing execution traces step by step
+ */
+export const DEFAULT_TIME_TRAVEL_CONFIG = {
+    autoCheckpoint: false,
+    autoCheckpointInterval: 1,
+    maxCheckpointsPerTrace: 50,
+    checkpointRetention: 24 * 60 * 60 * 1000,
+};
+//# sourceMappingURL=time-travel.js.map

package/dist/time-travel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-travel.js","sourceRoot":"","sources":["../src/time-travel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA+GH,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,cAAc,EAAE,KAAK;IACrB,sBAAsB,EAAE,CAAC;IACzB,sBAAsB,EAAE,EAAE;IAC1B,mBAAmB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CACzC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cogitator-ai/types",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Shared TypeScript types for Cogitator",
   "type": "module",
   "main": "./dist/index.js",