@ekkos/cli 0.2.18 → 0.3.3

package/dist/capture/jsonl-rewriter.d.ts

@@ -0,0 +1,96 @@
+/**
+ * JSONL Sliding Window - Maximize Context for New Work
+ *
+ * Progressive eviction - always stay lean:
+ * - 60%+: trim junk (streaming chunks only)
+ * - 65%+: trim metadata (snapshots, system) + truncate tool_results
+ * - 70%+: trim tools (results, calls)
+ * - 80%+: emergency dump to 50%
+ *
+ * THINKING BLOCKS: Preserved (priority 6) - contain valuable reasoning
+ * Safety: Last 50 lines are NEVER evicted (recent work protection)
+ *
+ * PROXY MODE (EKKOS_PROXY_MODE=1):
+ * When API proxy is enabled, eviction happens at the API level before
+ * requests reach Anthropic. In this mode, JSONL rewriter only does
+ * junk cleanup (continuousClean) - no threshold-based eviction.
+ * This prevents duplicate eviction from two sources.
+ */
+import { type HandshakeEvictionResult } from './eviction-client.js';
+interface HandshakeEvictionContext {
+    sessionId: string;
+    sessionName: string;
+    userId?: string;
+    tenantId?: string;
+    projectPath?: string;
+}
+/**
+ * Result of the eviction flow (sync or async)
+ */
+export interface EvictionResult {
+    success: boolean;
+    evicted: number;
+    truncated: number;
+    newPercent: number;
+    handshakeUsed?: boolean;
+    evictionId?: string;
+    error?: string;
+}
+/**
+ * Evict messages using the Handshake Protocol (two-phase commit)
+ *
+ * CRITICAL: Returns success ONLY after R2 confirms backup.
+ * Caller must NOT delete locally until this returns success=true.
+ *
+ * @returns result with clientNonce for confirm phase, or error
+ */
+export declare function evictWithHandshake(lines: string[], indices: number[], context: HandshakeEvictionContext): Promise<HandshakeEvictionResult>;
+/**
+ * Complete the handshake by confirming local deletion
+ * Call this AFTER successfully deleting from local JSONL
+ */
+export declare function confirmLocalEviction(evictionId: string, clientNonce: string, deletedCount: number): Promise<boolean>;
+/**
+ * Check if handshake eviction is available (proxy reachable)
+ */
+export declare function isHandshakeEvictionAvailable(): Promise<boolean>;
+export declare function evictToTarget(filePath: string, currentPercent: number, sessionId?: string, sessionName?: string): {
+    success: boolean;
+    evicted: number;
+    truncated: number;
+    newPercent: number;
+};
+export declare function needsEviction(percent: number): boolean;
+/**
+ * Async eviction with proper two-phase commit handshake.
+ * Use this instead of evictToTarget when async context is available.
+ *
+ * @returns Promise<EvictionResult>
+ */
+export declare function evictToTargetAsync(filePath: string, currentPercent: number, sessionId?: string, sessionName?: string): Promise<EvictionResult>;
+/**
+ * Continuous clean - run every turn, remove junk regardless of threshold
+ * Removes: thinking blocks, streaming chunks, old file-history-snapshots
+ */
+export declare function continuousClean(filePath: string): {
+    cleaned: number;
+};
+export declare function emergencyEvict(filePath: string): {
+    success: boolean;
+    evicted: number;
+};
+/**
+ * Get eviction stats
+ */
+export declare function getEvictionStats(): {
+    entries: number;
+    lastEviction?: string;
+};
+/**
+ * Get evicted content for retrieval (used by ccDNA)
+ */
+export declare function getEvictedContent(limit?: number): Array<{
+    timestamp: string;
+    content: string[];
+}>;
+export {};