@stackmemoryai/stackmemory 0.2.8 → 0.3.0

package/dist/src/core/context/frame-database.js

@@ -0,0 +1,333 @@
+/**
+ * Frame Database Operations
+ * Handles all database interactions for frames, events, and anchors
+ */
+import { logger } from '../monitoring/logger.js';
+import { DatabaseError, ErrorCode } from '../errors/index.js';
+export class FrameDatabase {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Initialize database schema
+     */
+    initSchema() {
+        try {
+            // Enable WAL mode for better concurrency
+            this.db.pragma('journal_mode = WAL');
+            this.db.pragma('synchronous = NORMAL');
+            // Create frames table
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS frames (
+          frame_id TEXT PRIMARY KEY,
+          run_id TEXT NOT NULL,
+          project_id TEXT NOT NULL,
+          parent_frame_id TEXT,
+          depth INTEGER NOT NULL DEFAULT 0,
+          type TEXT NOT NULL,
+          name TEXT NOT NULL,
+          state TEXT NOT NULL DEFAULT 'active',
+          inputs TEXT DEFAULT '{}',
+          outputs TEXT DEFAULT '{}',
+          digest_text TEXT,
+          digest_json TEXT DEFAULT '{}',
+          created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+          closed_at INTEGER,
+          FOREIGN KEY (parent_frame_id) REFERENCES frames(frame_id)
+        );
+      `);
+            // Create events table
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS events (
+          event_id TEXT PRIMARY KEY,
+          frame_id TEXT NOT NULL,
+          run_id TEXT NOT NULL,
+          seq INTEGER NOT NULL,
+          event_type TEXT NOT NULL,
+          payload TEXT NOT NULL DEFAULT '{}',
+          ts INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
+          FOREIGN KEY (frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE
+        );
+      `);
+            // Create anchors table
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS anchors (
+          anchor_id TEXT PRIMARY KEY,
+          frame_id TEXT NOT NULL,
+          type TEXT NOT NULL,
+          text TEXT NOT NULL,
+          priority INTEGER NOT NULL DEFAULT 5,
+          metadata TEXT DEFAULT '{}',
+          created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+          FOREIGN KEY (frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE
+        );
+      `);
+            // Create indexes for performance
+            this.db.exec(`
+        CREATE INDEX IF NOT EXISTS idx_frames_project_state ON frames(project_id, state);
+        CREATE INDEX IF NOT EXISTS idx_frames_parent ON frames(parent_frame_id);
+        CREATE INDEX IF NOT EXISTS idx_events_frame_seq ON events(frame_id, seq);
+        CREATE INDEX IF NOT EXISTS idx_anchors_frame_priority ON anchors(frame_id, priority DESC);
+      `);
+            logger.info('Frame database schema initialized');
+        }
+        catch (error) {
+            throw new DatabaseError('Failed to initialize frame database schema', ErrorCode.DB_SCHEMA_ERROR, { operation: 'initSchema' }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Insert new frame
+     */
+    insertFrame(frame) {
+        try {
+            const stmt = this.db.prepare(`
+        INSERT INTO frames (frame_id, run_id, project_id, parent_frame_id, depth, type, name, state, inputs, outputs, digest_json)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `);
+            const result = stmt.run(frame.frame_id, frame.run_id, frame.project_id, frame.parent_frame_id || null, frame.depth, frame.type, frame.name, frame.state, JSON.stringify(frame.inputs), JSON.stringify(frame.outputs), JSON.stringify(frame.digest_json));
+            if (result.changes === 0) {
+                throw new Error('Frame insertion failed - no rows affected');
+            }
+            // Return the created frame with timestamp
+            const createdFrame = this.getFrame(frame.frame_id);
+            if (!createdFrame) {
+                throw new Error('Failed to retrieve created frame');
+            }
+            return createdFrame;
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to insert frame: ${frame.frame_id}`, ErrorCode.DB_INSERT_FAILED, {
+                frameId: frame.frame_id,
+                frameName: frame.name,
+                operation: 'insertFrame',
+            }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get frame by ID
+     */
+    getFrame(frameId) {
+        try {
+            const row = this.db
+                .prepare('SELECT * FROM frames WHERE frame_id = ?')
+                .get(frameId);
+            if (!row)
+                return undefined;
+            return {
+                ...row,
+                inputs: JSON.parse(row.inputs || '{}'),
+                outputs: JSON.parse(row.outputs || '{}'),
+                digest_json: JSON.parse(row.digest_json || '{}'),
+            };
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to get frame: ${frameId}`, ErrorCode.DB_QUERY_FAILED, { frameId, operation: 'getFrame' }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Update frame state and outputs
+     */
+    updateFrame(frameId, updates) {
+        try {
+            const setClauses = [];
+            const values = [];
+            if (updates.state !== undefined) {
+                setClauses.push('state = ?');
+                values.push(updates.state);
+            }
+            if (updates.outputs !== undefined) {
+                setClauses.push('outputs = ?');
+                values.push(JSON.stringify(updates.outputs));
+            }
+            if (updates.digest_text !== undefined) {
+                setClauses.push('digest_text = ?');
+                values.push(updates.digest_text);
+            }
+            if (updates.digest_json !== undefined) {
+                setClauses.push('digest_json = ?');
+                values.push(JSON.stringify(updates.digest_json));
+            }
+            if (updates.closed_at !== undefined) {
+                setClauses.push('closed_at = ?');
+                values.push(updates.closed_at);
+            }
+            if (setClauses.length === 0) {
+                return; // No updates to apply
+            }
+            values.push(frameId);
+            const stmt = this.db.prepare(`
+        UPDATE frames SET ${setClauses.join(', ')} WHERE frame_id = ?
+      `);
+            const result = stmt.run(...values);
+            if (result.changes === 0) {
+                throw new Error(`Frame not found: ${frameId}`);
+            }
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to update frame: ${frameId}`, ErrorCode.DB_UPDATE_FAILED, { frameId, updates, operation: 'updateFrame' }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get frames by project and state
+     */
+    getFramesByProject(projectId, state) {
+        try {
+            const query = state
+                ? 'SELECT * FROM frames WHERE project_id = ? AND state = ? ORDER BY created_at'
+                : 'SELECT * FROM frames WHERE project_id = ? ORDER BY created_at';
+            const params = state ? [projectId, state] : [projectId];
+            const rows = this.db.prepare(query).all(...params);
+            return rows.map(row => ({
+                ...row,
+                inputs: JSON.parse(row.inputs || '{}'),
+                outputs: JSON.parse(row.outputs || '{}'),
+                digest_json: JSON.parse(row.digest_json || '{}'),
+            }));
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to get frames for project: ${projectId}`, ErrorCode.DB_QUERY_FAILED, { projectId, state, operation: 'getFramesByProject' }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Insert event
+     */
+    insertEvent(event) {
+        try {
+            const stmt = this.db.prepare(`
+        INSERT INTO events (event_id, frame_id, run_id, seq, event_type, payload)
+        VALUES (?, ?, ?, ?, ?, ?)
+      `);
+            const result = stmt.run(event.event_id, event.frame_id, event.run_id, event.seq, event.event_type, JSON.stringify(event.payload));
+            if (result.changes === 0) {
+                throw new Error('Event insertion failed');
+            }
+            // Return the created event with timestamp
+            const createdEvent = this.db
+                .prepare('SELECT * FROM events WHERE event_id = ?')
+                .get(event.event_id);
+            return {
+                ...createdEvent,
+                payload: JSON.parse(createdEvent.payload),
+            };
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to insert event: ${event.event_id}`, ErrorCode.DB_INSERT_FAILED, { eventId: event.event_id, frameId: event.frame_id, operation: 'insertEvent' }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get events for a frame
+     */
+    getFrameEvents(frameId, limit) {
+        try {
+            const query = limit
+                ? 'SELECT * FROM events WHERE frame_id = ? ORDER BY seq DESC LIMIT ?'
+                : 'SELECT * FROM events WHERE frame_id = ? ORDER BY seq ASC';
+            const params = limit ? [frameId, limit] : [frameId];
+            const rows = this.db.prepare(query).all(...params);
+            return rows.map(row => ({
+                ...row,
+                payload: JSON.parse(row.payload),
+            }));
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to get events for frame: ${frameId}`, ErrorCode.DB_QUERY_FAILED, { frameId, limit, operation: 'getFrameEvents' }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get next event sequence number
+     */
+    getNextEventSequence(frameId) {
+        try {
+            const result = this.db
+                .prepare('SELECT MAX(seq) as max_seq FROM events WHERE frame_id = ?')
+                .get(frameId);
+            return (result.max_seq || 0) + 1;
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to get next event sequence for frame: ${frameId}`, ErrorCode.DB_QUERY_FAILED, { frameId, operation: 'getNextEventSequence' }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Insert anchor
+     */
+    insertAnchor(anchor) {
+        try {
+            const stmt = this.db.prepare(`
+        INSERT INTO anchors (anchor_id, frame_id, type, text, priority, metadata)
+        VALUES (?, ?, ?, ?, ?, ?)
+      `);
+            const result = stmt.run(anchor.anchor_id, anchor.frame_id, anchor.type, anchor.text, anchor.priority, JSON.stringify(anchor.metadata));
+            if (result.changes === 0) {
+                throw new Error('Anchor insertion failed');
+            }
+            // Return the created anchor with timestamp
+            const createdAnchor = this.db
+                .prepare('SELECT * FROM anchors WHERE anchor_id = ?')
+                .get(anchor.anchor_id);
+            return {
+                ...createdAnchor,
+                metadata: JSON.parse(createdAnchor.metadata || '{}'),
+            };
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to insert anchor: ${anchor.anchor_id}`, ErrorCode.DB_INSERT_FAILED, { anchorId: anchor.anchor_id, frameId: anchor.frame_id, operation: 'insertAnchor' }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get anchors for a frame
+     */
+    getFrameAnchors(frameId) {
+        try {
+            const rows = this.db
+                .prepare('SELECT * FROM anchors WHERE frame_id = ? ORDER BY priority DESC, created_at ASC')
+                .all(frameId);
+            return rows.map(row => ({
+                ...row,
+                metadata: JSON.parse(row.metadata || '{}'),
+            }));
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to get anchors for frame: ${frameId}`, ErrorCode.DB_QUERY_FAILED, { frameId, operation: 'getFrameAnchors' }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Delete frame and all related data
+     */
+    deleteFrame(frameId) {
+        try {
+            // Delete in order due to foreign keys
+            this.db.prepare('DELETE FROM anchors WHERE frame_id = ?').run(frameId);
+            this.db.prepare('DELETE FROM events WHERE frame_id = ?').run(frameId);
+            this.db.prepare('DELETE FROM frames WHERE frame_id = ?').run(frameId);
+            logger.info('Frame deleted', { frameId });
+        }
+        catch (error) {
+            throw new DatabaseError(`Failed to delete frame: ${frameId}`, ErrorCode.DB_DELETE_FAILED, { frameId, operation: 'deleteFrame' }, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get database statistics
+     */
+    getStatistics() {
+        try {
+            const frameCount = this.db.prepare('SELECT COUNT(*) as count FROM frames').get();
+            const eventCount = this.db.prepare('SELECT COUNT(*) as count FROM events').get();
+            const anchorCount = this.db.prepare('SELECT COUNT(*) as count FROM anchors').get();
+            const activeFrames = this.db.prepare("SELECT COUNT(*) as count FROM frames WHERE state = 'active'").get();
+            return {
+                totalFrames: frameCount.count,
+                totalEvents: eventCount.count,
+                totalAnchors: anchorCount.count,
+                activeFrames: activeFrames.count,
+            };
+        }
+        catch (error) {
+            logger.warn('Failed to get database statistics', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return {};
+        }
+    }
+}
+//# sourceMappingURL=frame-database.js.map

package/dist/src/core/context/frame-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-database.js","sourceRoot":"","sources":["../../../../src/core/context/frame-database.ts"],"names":[],"mappings":"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"}

package/dist/src/core/context/frame-digest.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Frame Digest Generation
+ * Handles creation of frame summaries and digests
+ */
+import { DigestResult } from './frame-types.js';
+import { FrameDatabase } from './frame-database.js';
+export declare class FrameDigestGenerator {
+    private frameDb;
+    constructor(frameDb: FrameDatabase);
+    /**
+     * Generate digest for a frame
+     */
+    generateDigest(frameId: string): DigestResult;
+    /**
+     * Generate text summary of frame
+     */
+    private generateTextDigest;
+    /**
+     * Generate structured digest data
+     */
+    private generateStructuredDigest;
+    /**
+     * Summarize events into readable format
+     */
+    private summarizeEvents;
+    /**
+     * Group events by type
+     */
+    private groupEventsByType;
+    /**
+     * Group anchors by type
+     */
+    private groupAnchorsByType;
+    /**
+     * Count tool usage
+     */
+    private countTools;
+    /**
+     * Check if events contain errors
+     */
+    private hasErrorEvents;
+    /**
+     * Extract artifacts from events
+     */
+    private extractArtifacts;
+    /**
+     * Summarize a single event
+     */
+    private summarizeEvent;
+    /**
+     * Format duration
+     */
+    private formatDuration;
+    /**
+     * Format value for display
+     */
+    private formatValue;
+}
+//# sourceMappingURL=frame-digest.d.ts.map

package/dist/src/core/context/frame-digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-digest.d.ts","sourceRoot":"","sources":["../../../../src/core/context/frame-digest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAwB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,qBAAa,oBAAoB;IACnB,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE1C;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IA2B7C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoD1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAiDhC;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,WAAW;CASpB"}

package/dist/src/core/context/frame-digest.js

@@ -0,0 +1,264 @@
+/**
+ * Frame Digest Generation
+ * Handles creation of frame summaries and digests
+ */
+import { logger } from '../monitoring/logger.js';
+export class FrameDigestGenerator {
+    frameDb;
+    constructor(frameDb) {
+        this.frameDb = frameDb;
+    }
+    /**
+     * Generate digest for a frame
+     */
+    generateDigest(frameId) {
+        try {
+            const frame = this.frameDb.getFrame(frameId);
+            if (!frame) {
+                throw new Error(`Frame not found: ${frameId}`);
+            }
+            const events = this.frameDb.getFrameEvents(frameId);
+            const anchors = this.frameDb.getFrameAnchors(frameId);
+            // Generate text summary
+            const text = this.generateTextDigest(frame, events, anchors);
+            // Generate structured data
+            const structured = this.generateStructuredDigest(frame, events, anchors);
+            return { text, structured };
+        }
+        catch (error) {
+            logger.error('Failed to generate frame digest', { frameId, error });
+            return {
+                text: `Error generating digest for frame ${frameId}`,
+                structured: { error: error.message },
+            };
+        }
+    }
+    /**
+     * Generate text summary of frame
+     */
+    generateTextDigest(frame, events, anchors) {
+        const lines = [];
+        // Frame header
+        lines.push(`Frame: ${frame.name} (${frame.type})`);
+        lines.push(`Duration: ${this.formatDuration(frame.created_at, frame.closed_at)}`);
+        lines.push('');
+        // Goals and constraints
+        if (frame.inputs.goals) {
+            lines.push(`Goals: ${frame.inputs.goals}`);
+        }
+        if (frame.inputs.constraints && frame.inputs.constraints.length > 0) {
+            lines.push(`Constraints: ${frame.inputs.constraints.join(', ')}`);
+        }
+        // Key anchors
+        const importantAnchors = anchors
+            .filter(a => a.priority >= 7)
+            .sort((a, b) => b.priority - a.priority);
+        if (importantAnchors.length > 0) {
+            lines.push('');
+            lines.push('Key Decisions & Facts:');
+            importantAnchors.forEach(anchor => {
+                lines.push(`- ${anchor.type}: ${anchor.text}`);
+            });
+        }
+        // Activity summary
+        const eventSummary = this.summarizeEvents(events);
+        if (eventSummary.length > 0) {
+            lines.push('');
+            lines.push('Activity Summary:');
+            eventSummary.forEach(summary => {
+                lines.push(`- ${summary}`);
+            });
+        }
+        // Outputs
+        if (frame.outputs && Object.keys(frame.outputs).length > 0) {
+            lines.push('');
+            lines.push('Outputs:');
+            Object.entries(frame.outputs).forEach(([key, value]) => {
+                lines.push(`- ${key}: ${this.formatValue(value)}`);
+            });
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Generate structured digest data
+     */
+    generateStructuredDigest(frame, events, anchors) {
+        const eventsByType = this.groupEventsByType(events);
+        const anchorsByType = this.groupAnchorsByType(anchors);
+        return {
+            frameId: frame.frame_id,
+            frameName: frame.name,
+            frameType: frame.type,
+            duration: {
+                startTime: frame.created_at,
+                endTime: frame.closed_at,
+                durationMs: frame.closed_at ? (frame.closed_at - frame.created_at) * 1000 : null,
+            },
+            activity: {
+                totalEvents: events.length,
+                eventsByType,
+                eventTimeline: events.slice(-10).map(e => ({
+                    type: e.event_type,
+                    timestamp: e.ts,
+                    summary: this.summarizeEvent(e),
+                })),
+            },
+            knowledge: {
+                totalAnchors: anchors.length,
+                anchorsByType,
+                keyDecisions: anchors
+                    .filter(a => a.type === 'DECISION' && a.priority >= 7)
+                    .map(a => a.text),
+                constraints: anchors
+                    .filter(a => a.type === 'CONSTRAINT')
+                    .map(a => a.text),
+                risks: anchors
+                    .filter(a => a.type === 'RISK')
+                    .map(a => a.text),
+            },
+            outcomes: {
+                outputs: frame.outputs,
+                success: frame.state === 'closed' && !this.hasErrorEvents(events),
+                artifacts: this.extractArtifacts(events),
+            },
+            metadata: {
+                projectId: frame.project_id,
+                runId: frame.run_id,
+                parentFrameId: frame.parent_frame_id,
+                depth: frame.depth,
+            },
+        };
+    }
+    /**
+     * Summarize events into readable format
+     */
+    summarizeEvents(events) {
+        const summaries = [];
+        const eventsByType = this.groupEventsByType(events);
+        // Tool calls summary
+        if (eventsByType.tool_call && eventsByType.tool_call.length > 0) {
+            const toolCounts = this.countTools(eventsByType.tool_call);
+            const toolSummary = Object.entries(toolCounts)
+                .map(([tool, count]) => `${tool} (${count})`)
+                .join(', ');
+            summaries.push(`Tool calls: ${toolSummary}`);
+        }
+        // Decisions summary
+        if (eventsByType.decision && eventsByType.decision.length > 0) {
+            summaries.push(`Made ${eventsByType.decision.length} decisions`);
+        }
+        // Observations summary
+        if (eventsByType.observation && eventsByType.observation.length > 0) {
+            summaries.push(`Recorded ${eventsByType.observation.length} observations`);
+        }
+        // Error summary
+        const errorEvents = events.filter(e => e.payload.error || e.payload.status === 'error');
+        if (errorEvents.length > 0) {
+            summaries.push(`Encountered ${errorEvents.length} errors`);
+        }
+        return summaries;
+    }
+    /**
+     * Group events by type
+     */
+    groupEventsByType(events) {
+        const groups = {};
+        for (const event of events) {
+            if (!groups[event.event_type]) {
+                groups[event.event_type] = [];
+            }
+            groups[event.event_type].push(event);
+        }
+        return groups;
+    }
+    /**
+     * Group anchors by type
+     */
+    groupAnchorsByType(anchors) {
+        const groups = {};
+        for (const anchor of anchors) {
+            groups[anchor.type] = (groups[anchor.type] || 0) + 1;
+        }
+        return groups;
+    }
+    /**
+     * Count tool usage
+     */
+    countTools(toolEvents) {
+        const counts = {};
+        for (const event of toolEvents) {
+            const toolName = event.payload.tool_name || 'unknown';
+            counts[toolName] = (counts[toolName] || 0) + 1;
+        }
+        return counts;
+    }
+    /**
+     * Check if events contain errors
+     */
+    hasErrorEvents(events) {
+        return events.some(e => e.payload.error ||
+            e.payload.status === 'error');
+    }
+    /**
+     * Extract artifacts from events
+     */
+    extractArtifacts(events) {
+        const artifacts = [];
+        for (const event of events) {
+            if (event.event_type === 'artifact' && event.payload.path) {
+                artifacts.push(event.payload.path);
+            }
+        }
+        return [...new Set(artifacts)];
+    }
+    /**
+     * Summarize a single event
+     */
+    summarizeEvent(event) {
+        switch (event.event_type) {
+            case 'tool_call':
+                return `${event.payload.tool_name || 'tool'}`;
+            case 'decision':
+                return `${event.payload.type}: ${event.payload.content?.substring(0, 50)}...`;
+            case 'observation':
+                return `${event.payload.content?.substring(0, 50)}...`;
+            case 'artifact':
+                return `Created ${event.payload.path}`;
+            default:
+                return event.event_type;
+        }
+    }
+    /**
+     * Format duration
+     */
+    formatDuration(startTime, endTime) {
+        if (!endTime) {
+            return 'ongoing';
+        }
+        const durationMs = (endTime - startTime) * 1000;
+        if (durationMs < 1000) {
+            return `${durationMs.toFixed(0)}ms`;
+        }
+        else if (durationMs < 60000) {
+            return `${(durationMs / 1000).toFixed(1)}s`;
+        }
+        else {
+            return `${(durationMs / 60000).toFixed(1)}m`;
+        }
+    }
+    /**
+     * Format value for display
+     */
+    formatValue(value) {
+        if (typeof value === 'string') {
+            return value.length > 100 ? `${value.substring(0, 100)}...` : value;
+        }
+        else if (typeof value === 'object') {
+            return JSON.stringify(value).substring(0, 100) + '...';
+        }
+        else {
+            return String(value);
+        }
+    }
+}
+//# sourceMappingURL=frame-digest.js.map