@superblocksteam/vite-plugin-file-sync 2.0.83 → 2.0.84-next.0

package/dist/ai-service/recording/recorders/tool-recorder.js

@@ -0,0 +1,58 @@
+/**
+ * Tool call recorder middleware.
+ *
+ * Creates a middleware that records tool executions passing through
+ * the tool registry. Follows the existing ToolMiddleware pattern.
+ */
+/**
+ * Creates a tool recording middleware.
+ *
+ * This middleware wraps tool execution to record inputs, outputs,
+ * errors, and timing information.
+ *
+ * @param recorder - The RecordingManager instance
+ * @returns A ToolMiddleware that records tool executions
+ *
+ * @example
+ * ```typescript
+ * const recordingMiddleware = createToolRecordingMiddleware(recorder);
+ * registry.addMiddleware(recordingMiddleware);
+ * ```
+ */
+export function createToolRecordingMiddleware(recorder) {
+    return (tool) => {
+        return {
+            ...tool,
+            execute: async (input, options) => {
+                // If recording is not enabled, just execute normally
+                if (!recorder.isEnabled()) {
+                    return tool.execute(input, options);
+                }
+                const startTime = Date.now();
+                try {
+                    const output = await tool.execute(input, options);
+                    recorder.recordTool({
+                        toolName: tool.name,
+                        toolCallId: options?.toolCallId ?? "",
+                        input,
+                        output,
+                        durationMs: Date.now() - startTime,
+                    });
+                    return output;
+                }
+                catch (error) {
+                    recorder.recordTool({
+                        toolName: tool.name,
+                        toolCallId: options?.toolCallId ?? "",
+                        input,
+                        output: null,
+                        error: error instanceof Error ? error.message : String(error),
+                        durationMs: Date.now() - startTime,
+                    });
+                    throw error;
+                }
+            },
+        };
+    };
+}
+//# sourceMappingURL=tool-recorder.js.map

package/dist/ai-service/recording/recorders/tool-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-recorder.js","sourceRoot":"","sources":["../../../../src/ai-service/recording/recorders/tool-recorder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAA0B;IAE1B,OAAO,CAAC,IAAU,EAAQ,EAAE;QAC1B,OAAO;YACL,GAAG,IAAI;YACP,OAAO,EAAE,KAAK,EAAE,KAAc,EAAE,OAAwB,EAAE,EAAE;gBAC1D,qDAAqD;gBACrD,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACtC,CAAC;gBAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAE7B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBAElD,QAAQ,CAAC,UAAU,CAAC;wBAClB,QAAQ,EAAE,IAAI,CAAC,IAAI;wBACnB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,EAAE;wBACrC,KAAK;wBACL,MAAM;wBACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBACnC,CAAC,CAAC;oBAEH,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,QAAQ,CAAC,UAAU,CAAC;wBAClB,QAAQ,EAAE,IAAI,CAAC,IAAI;wBACnB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,EAAE;wBACrC,KAAK;wBACL,MAAM,EAAE,IAAI;wBACZ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;wBAC7D,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBACnC,CAAC,CAAC;oBAEH,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/ai-service/recording/recording-manager.d.ts

@@ -0,0 +1,104 @@
+/**
+ * RecordingManager - Central manager for recording AI interactions.
+ *
+ * This class coordinates the recording of socket messages, tool calls,
+ * and LLM interactions. It manages recording sessions and provides
+ * a unified interface for all recording operations.
+ */
+import type { RecordingSession, SocketRecording, ToolRecording, LLMRecording, MetaRecording } from "./types.js";
+/**
+ * Configuration options for RecordingManager.
+ */
+export interface RecordingManagerConfig {
+    /** Directory for file-based storage (required) */
+    recordingsDir: string;
+    /** App root directory path (required for snapshot creation) */
+    appRootDirPath: string;
+    /** Max session log file size in bytes before rotating (default: 512000 = 500KB) */
+    maxSessionSizeBytes?: number;
+    /** Max number of sessions to keep (default: 3) */
+    maxSessions?: number;
+    /** Max file size for snapshot inclusion in bytes (default: 1048576 = 1MB) */
+    maxSnapshotFileSizeBytes?: number;
+}
+export declare class RecordingManager {
+    private readonly config;
+    private storage;
+    private enabled;
+    private currentSessionId;
+    private readonly maxSessionSizeBytes;
+    private readonly maxSessions;
+    private readonly maxSnapshotFileSizeBytes;
+    /** Throttled rotation check - runs at most every 5 seconds */
+    private checkAndRotateIfNeeded;
+    constructor(config: RecordingManagerConfig);
+    /**
+     * Enable recording and start a new session.
+     *
+     * @param initialCommitId - Optional commit ID to set as starting/current commit
+     * @returns The session ID for the new session
+     */
+    start(initialCommitId?: string): string;
+    /**
+     * Start a new recording session (internal).
+     * Does not enable recording - use start() to enable and start.
+     *
+     * @param initialCommitId - Optional commit ID to set as starting/current commit
+     * @returns The session ID for the new session
+     */
+    private startSession;
+    /**
+     * Create a snapshot of the app directory for a session.
+     * Fire-and-forget, does not block recording.
+     * Records a meta entry with snapshot info (including any skipped files).
+     */
+    private createSessionSnapshot;
+    /**
+     * Set the current commit ID for the active session.
+     * Called when commits occur during the session.
+     */
+    setCurrentCommitId(commitId: string): Promise<void>;
+    /**
+     * Check if recording is currently enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Perform the actual rotation check.
+     * Called by the throttled checkAndRotateIfNeeded.
+     */
+    private doRotationCheck;
+    /**
+     * Get the current session ID.
+     */
+    getCurrentSessionId(): string | null;
+    /**
+     * List all recorded sessions from the persistent index.
+     *
+     * @returns Promise resolving to array of sessions (oldest first)
+     */
+    listSessions(): Promise<RecordingSession[]>;
+    /**
+     * Record a socket message.
+     *
+     * By default, only records method name and peerId.
+     * For specific methods (like aiGenerate), also records cleaned request data.
+     */
+    recordSocket(data: SocketRecording): void;
+    /**
+     * Record a tool call.
+     */
+    recordTool(data: ToolRecording): void;
+    /**
+     * Record an LLM call.
+     */
+    recordLLM(data: LLMRecording): void;
+    /**
+     * Record a meta entry (session metadata like snapshot info).
+     */
+    recordMeta(data: MetaRecording): void;
+    /**
+     * Clear all recordings, optionally for a specific session.
+     */
+    clear(sessionId?: string): Promise<void>;
+}
+//# sourceMappingURL=recording-manager.d.ts.map

package/dist/ai-service/recording/recording-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-manager.d.ts","sourceRoot":"","sources":["../../../src/ai-service/recording/recording-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAEV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,EAEd,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AA6BD,qBAAa,gBAAgB;IAaf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZnC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAElD,8DAA8D;IAC9D,OAAO,CAAC,sBAAsB,CAEC;gBAEF,MAAM,EAAE,sBAAsB;IAW3D;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM;IAKvC;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IA2BpB;;;;OAIG;YACW,qBAAqB;IAyBnC;;;OAGG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;YACW,eAAe;IAkB7B;;OAEG;IACH,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAIpC;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIjD;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAkEzC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAcrC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAwCnC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAarC;;OAEG;IACG,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C"}

package/dist/ai-service/recording/recording-manager.js

@@ -0,0 +1,308 @@
+/**
+ * RecordingManager - Central manager for recording AI interactions.
+ *
+ * This class coordinates the recording of socket messages, tool calls,
+ * and LLM interactions. It manages recording sessions and provides
+ * a unified interface for all recording operations.
+ */
+import { pick, throttle } from "lodash-es";
+import { getErrorMeta, getLogger } from "../../util/logger.js";
+import { SessionRecordingStorage } from "./storage/session-recording-storage.js";
+/**
+ * Central manager for recording AI interactions.
+ *
+ * Provides session-based recording with support for socket messages,
+ * tool executions, and LLM calls. Entries are written to JSONL files
+ * in {recordingsDir}/{sessionId}/recording.jsonl.
+ *
+ * Sessions are tracked in a persistent index at {recordingsDir}/sessions.json.
+ *
+ * @example
+ * ```typescript
+ * const recorder = new RecordingManager({
+ *   recordingsDir: '/path/to/.superblocks/recordings',
+ *   appRootDirPath: '/path/to/app',
+ * });
+ *
+ * // Start recording with optional initial commit ID
+ * recorder.start(initialCommitId);
+ * recorder.recordSocket({ method: 'aiGenerate', request: {...}, peerId: '123' });
+ *
+ * // Update commit ID when new commits occur
+ * recorder.setCurrentCommitId(newCommitId);
+ * ```
+ */
+/** Throttle interval for rotation checks (ms) */
+const ROTATION_CHECK_INTERVAL_MS = 5000;
+export class RecordingManager {
+    config;
+    storage;
+    enabled = false;
+    currentSessionId = null;
+    maxSessionSizeBytes;
+    maxSessions;
+    maxSnapshotFileSizeBytes;
+    /** Throttled rotation check - runs at most every 5 seconds */
+    checkAndRotateIfNeeded = throttle(() => {
+        void this.doRotationCheck();
+    }, ROTATION_CHECK_INTERVAL_MS);
+    constructor(config) {
+        this.config = config;
+        this.storage = new SessionRecordingStorage(config.recordingsDir);
+        this.maxSessionSizeBytes = config.maxSessionSizeBytes ?? 512000; // 500KB
+        this.maxSessions = config.maxSessions ?? 3;
+        this.maxSnapshotFileSizeBytes = config.maxSnapshotFileSizeBytes ?? 1048576; // 1MB
+        getLogger().info(`[recording] Using file storage at: ${config.recordingsDir}`);
+    }
+    /**
+     * Enable recording and start a new session.
+     *
+     * @param initialCommitId - Optional commit ID to set as starting/current commit
+     * @returns The session ID for the new session
+     */
+    start(initialCommitId) {
+        this.enabled = true;
+        return this.startSession(initialCommitId);
+    }
+    /**
+     * Start a new recording session (internal).
+     * Does not enable recording - use start() to enable and start.
+     *
+     * @param initialCommitId - Optional commit ID to set as starting/current commit
+     * @returns The session ID for the new session
+     */
+    startSession(initialCommitId) {
+        this.currentSessionId = crypto.randomUUID();
+        const session = {
+            id: this.currentSessionId,
+            startedAt: Date.now(),
+            startingCommitId: initialCommitId,
+            currentCommitId: initialCommitId,
+        };
+        // Add to storage (single source of truth)
+        void this.storage.addSession(session);
+        // Cleanup old sessions if over limit
+        void this.storage.deleteOldestSessions(this.maxSessions);
+        getLogger().info(`[recording] Started recording session: ${this.currentSessionId}`, { initialCommitId });
+        // Create snapshot async (fire-and-forget, non-blocking)
+        void this.createSessionSnapshot(this.currentSessionId);
+        return this.currentSessionId;
+    }
+    /**
+     * Create a snapshot of the app directory for a session.
+     * Fire-and-forget, does not block recording.
+     * Records a meta entry with snapshot info (including any skipped files).
+     */
+    async createSessionSnapshot(sessionId) {
+        try {
+            const result = await this.storage.createSnapshot(sessionId, this.config.appRootDirPath, this.maxSnapshotFileSizeBytes);
+            getLogger().info(`[recording] Created snapshot for session: ${sessionId}`);
+            // Record meta entry with snapshot info
+            this.recordMeta({
+                skippedFiles: result.skippedFiles.length > 0 ? result.skippedFiles : undefined,
+                message: "Session snapshot created",
+            });
+        }
+        catch (error) {
+            getLogger().warn(`[recording] Failed to create snapshot for session`, getErrorMeta(error));
+        }
+    }
+    /**
+     * Set the current commit ID for the active session.
+     * Called when commits occur during the session.
+     */
+    async setCurrentCommitId(commitId) {
+        if (!this.currentSessionId)
+            return;
+        const session = await this.storage.getSession(this.currentSessionId);
+        if (session) {
+            session.currentCommitId = commitId;
+            await this.storage.updateSession(session);
+            getLogger().info(`[recording] Updated currentCommitId`, {
+                sessionId: this.currentSessionId,
+                commitId,
+            });
+        }
+    }
+    /**
+     * Check if recording is currently enabled.
+     */
+    isEnabled() {
+        return this.enabled && this.currentSessionId !== null;
+    }
+    /**
+     * Perform the actual rotation check.
+     * Called by the throttled checkAndRotateIfNeeded.
+     */
+    async doRotationCheck() {
+        if (!this.currentSessionId)
+            return;
+        const size = await this.storage.getSessionFileSize(this.currentSessionId);
+        if (size >= this.maxSessionSizeBytes) {
+            getLogger().info(`[recording] Session file size ${size} exceeds limit ${this.maxSessionSizeBytes}, rotating`);
+            // Get current commit ID to pass to new session
+            const session = await this.storage.getSession(this.currentSessionId);
+            const currentCommitId = session?.currentCommitId;
+            // Start new session (this also handles cleanup)
+            this.startSession(currentCommitId);
+        }
+    }
+    /**
+     * Get the current session ID.
+     */
+    getCurrentSessionId() {
+        return this.currentSessionId;
+    }
+    /**
+     * List all recorded sessions from the persistent index.
+     *
+     * @returns Promise resolving to array of sessions (oldest first)
+     */
+    async listSessions() {
+        return this.storage.listSessions();
+    }
+    /**
+     * Record a socket message.
+     *
+     * By default, only records method name and peerId.
+     * For specific methods (like aiGenerate), also records cleaned request data.
+     */
+    recordSocket(data) {
+        if (!this.isEnabled())
+            return;
+        // Skip noisy methods entirely
+        if (data.method === "editor.ping")
+            return;
+        let cleanedData;
+        try {
+            // Method-specific data cleaning
+            switch (data.method) {
+                case "aiGenerate":
+                    // Record cleaned request data for aiGenerate
+                    cleanedData = {
+                        method: data.method,
+                        peerId: data.peerId,
+                        request: pick(data.request, [
+                            "prompt",
+                            "promptContext",
+                            "planContext",
+                            "mockGeneration",
+                            "llmConfig",
+                            "mode",
+                            "responseMetadata",
+                        ]),
+                    };
+                    break;
+                // Record full request for mutation methods (useful for replay/debugging)
+                case "aiRestoreToCommit":
+                case "apiUpdate":
+                case "apiDelete":
+                case "renameApi":
+                case "renameElement":
+                    cleanedData = {
+                        method: data.method,
+                        peerId: data.peerId,
+                        request: data.request,
+                    };
+                    break;
+                default:
+                    // For all other methods, record just method name and peerId
+                    cleanedData = {
+                        method: data.method,
+                        peerId: data.peerId,
+                        request: `[Truncated]`,
+                    };
+            }
+        }
+        catch {
+            cleanedData = {
+                message: "Error cleaning this record",
+            };
+        }
+        const entry = {
+            id: crypto.randomUUID(),
+            timestamp: Date.now(),
+            type: "socket",
+            data: cleanedData,
+        };
+        this.storage.add(this.currentSessionId, entry);
+        this.checkAndRotateIfNeeded();
+    }
+    /**
+     * Record a tool call.
+     */
+    recordTool(data) {
+        if (!this.isEnabled())
+            return;
+        const entry = {
+            id: crypto.randomUUID(),
+            timestamp: Date.now(),
+            type: "tool",
+            data,
+        };
+        this.storage.add(this.currentSessionId, entry);
+        this.checkAndRotateIfNeeded();
+    }
+    /**
+     * Record an LLM call.
+     */
+    recordLLM(data) {
+        if (!this.isEnabled())
+            return;
+        let cleanedData = {};
+        try {
+            cleanedData = {
+                request: {
+                    model: data.request.model,
+                    messages: data.request.messages.map((message, idx) => {
+                        if (idx < data.request.messages.length - 1) {
+                            return `[Truncated]`;
+                        }
+                        return message;
+                    }),
+                    tools: data.request.tools?.map((tool) => {
+                        return typeof tool === "object" && tool != null && "name" in tool
+                            ? `[Truncated] ${tool.name}`
+                            : "[Truncated] Tool";
+                    }),
+                    system: `[Truncated]`,
+                },
+                response: data.response,
+            };
+        }
+        catch {
+            cleanedData = {
+                message: "Error cleaning this record",
+            };
+        }
+        const entry = {
+            id: crypto.randomUUID(),
+            timestamp: Date.now(),
+            type: "llm",
+            data: cleanedData,
+        };
+        this.storage.add(this.currentSessionId, entry);
+        this.checkAndRotateIfNeeded();
+    }
+    /**
+     * Record a meta entry (session metadata like snapshot info).
+     */
+    recordMeta(data) {
+        if (!this.isEnabled())
+            return;
+        const entry = {
+            id: crypto.randomUUID(),
+            timestamp: Date.now(),
+            type: "meta",
+            data,
+        };
+        this.storage.add(this.currentSessionId, entry);
+    }
+    /**
+     * Clear all recordings, optionally for a specific session.
+     */
+    async clear(sessionId) {
+        await this.storage.clear(sessionId);
+    }
+}
+//# sourceMappingURL=recording-manager.js.map

package/dist/ai-service/recording/recording-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-manager.js","sourceRoot":"","sources":["../../../src/ai-service/recording/recording-manager.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/recording/storage/session-recording-storage.d.ts

@@ -0,0 +1,143 @@
+/**
+ * File-based storage implementation for recording entries and session index.
+ *
+ * Stores recording entries in JSONL files organized by session:
+ * {recordingsDir}/{sessionId}/recording.jsonl
+ *
+ * Maintains a session index at:
+ * {recordingsDir}/sessions.json
+ *
+ * Uses buffered writes for performance - entries are added to a buffer
+ * and flushed to disk asynchronously.
+ */
+import type { RecordingEntry, RecordingSession } from "../types.js";
+/** Result from creating a snapshot */
+export interface SnapshotResult {
+    /** Files skipped from snapshot due to size limit */
+    skippedFiles: Array<{
+        path: string;
+        size: number;
+    }>;
+}
+/**
+ * File-based storage for recording entries and session index.
+ *
+ * Entries are stored in JSONL format (one JSON object per line) in
+ * session-specific directories. The session index is stored as a
+ * JSON array that gets overwritten on each update.
+ *
+ * Session index saves are debounced to avoid excessive disk writes
+ * when multiple updates occur in rapid succession.
+ */
+export declare class SessionRecordingStorage {
+    private readonly recordingsDir;
+    private buffer;
+    private flushPromise;
+    private currentSessionId;
+    private storageInitialized;
+    private sessions;
+    private sessionsLoaded;
+    private loadSessionIndexPromise;
+    private sessionIndexSaveTimeout;
+    private sessionIndexDirty;
+    constructor(recordingsDir: string);
+    /**
+     * Get the path to a session's directory.
+     */
+    private getSessionDir;
+    /**
+     * Get the path to a session's recording file.
+     */
+    private getSessionFilePath;
+    /**
+     * Get the path to the sessions index file.
+     */
+    private getSessionsIndexPath;
+    /**
+     * Ensures the storage directory exists for the current session.
+     * Creates directory if needed.
+     */
+    private ensureStorageExists;
+    /**
+     * Ensures the recordings directory exists.
+     */
+    private ensureRecordingsDirExists;
+    /**
+     * Load the session index from disk.
+     * Uses a promise to prevent concurrent loads from racing.
+     */
+    private loadSessionIndex;
+    /**
+     * Actually load the session index from disk.
+     */
+    private doLoadSessionIndex;
+    /**
+     * Save the session index to disk immediately.
+     * Clears any pending debounced save.
+     */
+    private saveSessionIndexNow;
+    /**
+     * Schedule a debounced save of the session index.
+     * Multiple calls within the debounce window will only trigger one save.
+     */
+    private scheduleSaveSessionIndex;
+    /**
+     * Add a new session to the index.
+     * Saves immediately since new sessions should be persisted right away.
+     */
+    addSession(session: RecordingSession): Promise<void>;
+    /**
+     * Update an existing session in the index.
+     * Uses debounced save to batch rapid updates.
+     */
+    updateSession(session: RecordingSession): Promise<void>;
+    /**
+     * Get a session by ID.
+     * Returns undefined if not found.
+     */
+    getSession(sessionId: string): Promise<RecordingSession | undefined>;
+    /**
+     * List all sessions from the index.
+     * Returns sessions in chronological order (oldest first).
+     */
+    listSessions(): Promise<RecordingSession[]>;
+    /**
+     * Get the size of a session's recording file in bytes.
+     * Returns 0 if the file doesn't exist yet.
+     */
+    getSessionFileSize(sessionId: string): Promise<number>;
+    /**
+     * Delete oldest sessions to keep only the specified number.
+     * Sessions are stored oldest-first, so we delete from the beginning.
+     */
+    deleteOldestSessions(keepCount: number): Promise<void>;
+    /**
+     * Add a recording entry for the given session.
+     * Appends to buffer and schedules async flush.
+     */
+    add(sessionId: string, entry: RecordingEntry): void;
+    /**
+     * Schedule a flush of the buffer to disk.
+     * Uses a simple debounce - if a flush is already pending, don't schedule another.
+     */
+    private scheduleFlush;
+    /**
+     * Flush all buffered entries to disk.
+     */
+    private flush;
+    /**
+     * Create a tar.gz snapshot of the app directory for a session.
+     * This captures the state of the codebase when the session started.
+     *
+     * @param sessionId - The session ID to create the snapshot for
+     * @param appRootDirPath - The root directory of the application
+     * @param maxFileSizeBytes - Max file size to include (default 1MB)
+     * @returns Information about skipped files
+     */
+    createSnapshot(sessionId: string, appRootDirPath: string, maxFileSizeBytes?: number): Promise<SnapshotResult>;
+    /**
+     * Clear all entries for a specific session or all sessions.
+     */
+    clear(sessionId?: string): Promise<void>;
+}
+//# sourceMappingURL=session-recording-storage.d.ts.map

package/dist/ai-service/recording/storage/session-recording-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-recording-storage.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/recording/storage/session-recording-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA6DpE,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED;;;;;;;;;GASG;AACH,qBAAa,uBAAuB;IAWtB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAV1C,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,uBAAuB,CAA8B;IAC7D,OAAO,CAAC,uBAAuB,CAA8C;IAC7E,OAAO,CAAC,iBAAiB,CAAkB;gBAEd,aAAa,EAAE,MAAM;IAElD;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;;OAGG;YACW,mBAAmB;IAYjC;;OAEG;YACW,yBAAyB;IAIvC;;;OAGG;YACW,gBAAgB;IAgB9B;;OAEG;YACW,kBAAkB;IAchC;;;OAGG;YACW,mBAAmB;IAqBjC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAehC;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7D;;;OAGG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAK1E;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKjD;;;OAGG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU5D;;;OAGG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB5D;;;OAGG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAKnD;;;OAGG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;YACW,KAAK;IAsBnB;;;;;;;;OAQG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,gBAAgB,GAAE,MAA6C,GAC9D,OAAO,CAAC,cAAc,CAAC;IAoC1B;;OAEG;IACG,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAkC/C"}