@stackmemoryai/stackmemory 0.1.0

package/dist/scripts/status.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env tsx
+/**
+ * Check StackMemory status and statistics
+ */
+import Database from 'better-sqlite3';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+const projectRoot = process.cwd();
+const dbPath = join(projectRoot, '.stackmemory', 'context.db');
+if (!existsSync(dbPath)) {
+    console.log(chalk.red('❌ StackMemory not initialized in this project'));
+    console.log(chalk.gray('Run: npm run init'));
+    process.exit(1);
+}
+const db = new Database(dbPath, { readonly: true });
+console.log(chalk.blue.bold('\n📊 StackMemory Status\n'));
+// Get statistics
+const stats = {
+    contexts: db.prepare('SELECT COUNT(*) as count FROM contexts').get(),
+    frames: db.prepare('SELECT COUNT(*) as count FROM frames').get(),
+    attention: db.prepare('SELECT COUNT(*) as count FROM attention_log').get(),
+};
+console.log(chalk.green('Database:') + ` ${dbPath}`);
+console.log(chalk.green('Contexts:') + ` ${stats.contexts.count}`);
+console.log(chalk.green('Frames:') + ` ${stats.frames.count}`);
+console.log(chalk.green('Attention logs:') + ` ${stats.attention.count}`);
+// Get top contexts by importance
+console.log(chalk.blue('\n🎯 Top Contexts by Importance:\n'));
+const topContexts = db.prepare(`
+  SELECT type, substr(content, 1, 60) as preview, importance, access_count
+  FROM contexts
+  ORDER BY importance DESC, access_count DESC
+  LIMIT 5
+`).all();
+topContexts.forEach((ctx, i) => {
+    const importance = '●'.repeat(Math.round(ctx.importance * 5));
+    console.log(chalk.cyan(`${i + 1}.`) +
+        ` [${ctx.type}] ` +
+        chalk.gray(`(${ctx.access_count} uses)`) +
+        ` ${importance}`);
+    console.log(chalk.gray(`   ${ctx.preview}...`));
+});
+// Get active frames
+const activeFrames = db.prepare(`
+  SELECT task, datetime(created_at, 'unixepoch') as started
+  FROM frames
+  WHERE status = 'active'
+  ORDER BY created_at DESC
+  LIMIT 3
+`).all();
+if (activeFrames.length > 0) {
+    console.log(chalk.blue('\n🔄 Active Tasks:\n'));
+    activeFrames.forEach(frame => {
+        console.log(chalk.green('•') + ` ${frame.task}`);
+        console.log(chalk.gray(`  Started: ${frame.started}`));
+    });
+}
+// Get recent attention patterns
+const recentAttention = db.prepare(`
+  SELECT 
+    substr(query, 1, 50) as query_preview,
+    COUNT(*) as count
+  FROM attention_log
+  WHERE timestamp > unixepoch() - 86400
+  GROUP BY query_preview
+  ORDER BY count DESC
+  LIMIT 3
+`).all();
+if (recentAttention.length > 0) {
+    console.log(chalk.blue('\n👁️ Recent Query Patterns:\n'));
+    recentAttention.forEach(pattern => {
+        console.log(chalk.yellow('?') + ` "${pattern.query_preview}..." (${pattern.count}x)`);
+    });
+}
+// Show context decay
+const oldContexts = db.prepare(`
+  SELECT COUNT(*) as count
+  FROM contexts
+  WHERE last_accessed < unixepoch() - 86400 * 7
+`).get();
+if (oldContexts.count > 0) {
+    console.log(chalk.yellow(`\n⚠️  ${oldContexts.count} contexts haven't been accessed in 7+ days`));
+}
+console.log(chalk.gray('\n💡 Tip: Run "npm run analyze" for detailed attention analysis\n'));
+db.close();
+//# sourceMappingURL=status.js.map

package/dist/scripts/status.js.map

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

package/dist/src/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * StackMemory CLI
+ * Command-line interface for StackMemory operations
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/src/cli.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+/**
+ * StackMemory CLI
+ * Command-line interface for StackMemory operations
+ */
+import { program } from 'commander';
+import { logger } from './logger.js';
+import { FrameManager } from './frame-manager.js';
+import Database from 'better-sqlite3';
+import { join } from 'path';
+import { existsSync, mkdirSync } from 'fs';
+program
+    .name('stackmemory')
+    .description('Lossless memory runtime for AI coding tools')
+    .version('0.1.0');
+program
+    .command('init')
+    .description('Initialize StackMemory in current project')
+    .action(async () => {
+    try {
+        const projectRoot = process.cwd();
+        const dbDir = join(projectRoot, '.stackmemory');
+        if (!existsSync(dbDir)) {
+            mkdirSync(dbDir, { recursive: true });
+        }
+        const dbPath = join(dbDir, 'context.db');
+        const db = new Database(dbPath);
+        const frameManager = new FrameManager(db, 'cli-project');
+        logger.info('StackMemory initialized successfully', { projectRoot });
+        console.log('✅ StackMemory initialized in', projectRoot);
+        db.close();
+    }
+    catch (error) {
+        logger.error('Failed to initialize StackMemory', error);
+        console.error('❌ Initialization failed:', error.message);
+        process.exit(1);
+    }
+});
+program
+    .command('status')
+    .description('Show current StackMemory status')
+    .action(async () => {
+    try {
+        const projectRoot = process.cwd();
+        const dbPath = join(projectRoot, '.stackmemory', 'context.db');
+        if (!existsSync(dbPath)) {
+            console.log('❌ StackMemory not initialized. Run "stackmemory init" first.');
+            return;
+        }
+        const db = new Database(dbPath);
+        const frameManager = new FrameManager(db, 'cli-project');
+        const activeFrames = frameManager.getActiveFramePath();
+        const stackDepth = frameManager.getStackDepth();
+        console.log('📊 StackMemory Status:');
+        console.log(`   Stack depth: ${stackDepth}`);
+        console.log(`   Active frames: ${activeFrames.length}`);
+        if (activeFrames.length > 0) {
+            console.log('\\n📚 Active Frames:');
+            activeFrames.forEach((frame, i) => {
+                const indent = '  '.repeat(i);
+                console.log(`${indent}${i + 1}. ${frame.name} (${frame.type})`);
+            });
+        }
+        db.close();
+    }
+    catch (error) {
+        logger.error('Failed to get status', error);
+        console.error('❌ Status check failed:', error.message);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/error-handler.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Comprehensive error handling for StackMemory CLI
+ */
+export declare enum ErrorCode {
+    AUTH_FAILED = "AUTH_FAILED",
+    TOKEN_EXPIRED = "TOKEN_EXPIRED",
+    INVALID_CREDENTIALS = "INVALID_CREDENTIALS",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    DISK_FULL = "DISK_FULL",
+    NOT_GIT_REPO = "NOT_GIT_REPO",
+    GIT_COMMAND_FAILED = "GIT_COMMAND_FAILED",
+    INVALID_BRANCH = "INVALID_BRANCH",
+    DB_CONNECTION_FAILED = "DB_CONNECTION_FAILED",
+    DB_QUERY_FAILED = "DB_QUERY_FAILED",
+    DB_CORRUPTION = "DB_CORRUPTION",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    API_ERROR = "API_ERROR",
+    TIMEOUT = "TIMEOUT",
+    INVALID_INPUT = "INVALID_INPUT",
+    VALIDATION_FAILED = "VALIDATION_FAILED",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    OPERATION_FAILED = "OPERATION_FAILED",
+    CONFIGURATION_ERROR = "CONFIGURATION_ERROR"
+}
+export declare class StackMemoryError extends Error {
+    readonly code: ErrorCode;
+    readonly context: Record<string, unknown>;
+    readonly userMessage: string;
+    readonly recoverable: boolean;
+    constructor(code: ErrorCode, message: string, userMessage?: string, context?: Record<string, unknown>, recoverable?: boolean, cause?: Error);
+    private getDefaultUserMessage;
+    static fromNodeError(nodeError: NodeJS.ErrnoException, context?: Record<string, unknown>): StackMemoryError;
+}
+export declare class ErrorHandler {
+    static handle(error: unknown, operation: string): never;
+    static safeExecute<T>(operation: () => Promise<T> | T, operationName: string, fallback?: T): Promise<T | undefined>;
+}
+export declare const validateInput: (value: unknown, name: string, validator: (val: unknown) => boolean) => asserts value is NonNullable<unknown>;
+export declare const validateEmail: (email: string) => asserts email is string;
+export declare const validatePath: (filePath: string) => asserts filePath is string;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/src/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,oBAAY,SAAS;IAEnB,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,mBAAmB,wBAAwB;IAG3C,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,SAAS,cAAc;IAGvB,YAAY,iBAAiB;IAC7B,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IAGjC,oBAAoB,yBAAyB;IAC7C,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAG/B,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,OAAO,YAAY;IAGnB,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IAGvC,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;CAC5C;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAGnC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,WAAW,GAAE,OAAe,EAC5B,KAAK,CAAC,EAAE,KAAK;IAsBf,OAAO,CAAC,qBAAqB;IAqB7B,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,gBAAgB;CAwDhH;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK;WAkD1C,WAAW,CAAC,CAAC,EACxB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC/B,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,CAAC,GACX,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAY1B;AAGD,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,MAAM,MAAM,EAAE,WAAW,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,KAAG,QAAQ,KAAK,IAAI,WAAW,CAAC,OAAO,CAUtI,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,QAAQ,KAAK,IAAI,MAW9D,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,KAAG,QAAQ,QAAQ,IAAI,MAUnE,CAAC"}

package/dist/src/error-handler.js

@@ -0,0 +1,155 @@
+/**
+ * Comprehensive error handling for StackMemory CLI
+ */
+import { logger } from './logger.js';
+export var ErrorCode;
+(function (ErrorCode) {
+    // Authentication errors
+    ErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
+    ErrorCode["TOKEN_EXPIRED"] = "TOKEN_EXPIRED";
+    ErrorCode["INVALID_CREDENTIALS"] = "INVALID_CREDENTIALS";
+    // File system errors
+    ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    ErrorCode["DISK_FULL"] = "DISK_FULL";
+    // Git operation errors
+    ErrorCode["NOT_GIT_REPO"] = "NOT_GIT_REPO";
+    ErrorCode["GIT_COMMAND_FAILED"] = "GIT_COMMAND_FAILED";
+    ErrorCode["INVALID_BRANCH"] = "INVALID_BRANCH";
+    // Database errors
+    ErrorCode["DB_CONNECTION_FAILED"] = "DB_CONNECTION_FAILED";
+    ErrorCode["DB_QUERY_FAILED"] = "DB_QUERY_FAILED";
+    ErrorCode["DB_CORRUPTION"] = "DB_CORRUPTION";
+    // Network errors
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["API_ERROR"] = "API_ERROR";
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    // Validation errors
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    // General errors
+    ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    ErrorCode["OPERATION_FAILED"] = "OPERATION_FAILED";
+    ErrorCode["CONFIGURATION_ERROR"] = "CONFIGURATION_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+export class StackMemoryError extends Error {
+    code;
+    context;
+    userMessage;
+    recoverable;
+    constructor(code, message, userMessage, context = {}, recoverable = false, cause) {
+        super(message);
+        this.name = 'StackMemoryError';
+        this.code = code;
+        this.context = context;
+        this.userMessage = userMessage || this.getDefaultUserMessage(code);
+        this.recoverable = recoverable;
+        if (cause && Error.captureStackTrace) {
+            Error.captureStackTrace(this, StackMemoryError);
+        }
+        // Log the error
+        logger.error(message, cause, {
+            code,
+            context,
+            recoverable,
+            userMessage: this.userMessage
+        });
+    }
+    getDefaultUserMessage(code) {
+        switch (code) {
+            case ErrorCode.AUTH_FAILED:
+                return 'Authentication failed. Please check your credentials and try again.';
+            case ErrorCode.NOT_GIT_REPO:
+                return 'This command requires a git repository. Please run it from within a git repository.';
+            case ErrorCode.PERMISSION_DENIED:
+                return 'Permission denied. Please check file permissions or run with appropriate privileges.';
+            case ErrorCode.NETWORK_ERROR:
+                return 'Network error. Please check your internet connection and try again.';
+            case ErrorCode.INVALID_INPUT:
+                return 'Invalid input provided. Please check your command and try again.';
+            case ErrorCode.DB_CONNECTION_FAILED:
+                return 'Database connection failed. Please try again or contact support if the issue persists.';
+            case ErrorCode.GIT_COMMAND_FAILED:
+                return 'Git operation failed. Please ensure your repository is in a valid state.';
+            default:
+                return 'An unexpected error occurred. Please try again or contact support.';
+        }
+    }
+    static fromNodeError(nodeError, context = {}) {
+        const code = nodeError.code;
+        switch (code) {
+            case 'ENOENT':
+                return new StackMemoryError(ErrorCode.FILE_NOT_FOUND, `File or directory not found: ${nodeError.path}`, 'The requested file or directory was not found.', { ...context, path: nodeError.path }, false, nodeError);
+            case 'EACCES':
+            case 'EPERM':
+                return new StackMemoryError(ErrorCode.PERMISSION_DENIED, `Permission denied: ${nodeError.path}`, 'Permission denied. Please check file permissions.', { ...context, path: nodeError.path }, true, nodeError);
+            case 'ENOSPC':
+                return new StackMemoryError(ErrorCode.DISK_FULL, 'No space left on device', 'Insufficient disk space. Please free up space and try again.', context, true, nodeError);
+            case 'ETIMEDOUT':
+                return new StackMemoryError(ErrorCode.TIMEOUT, 'Operation timed out', 'The operation timed out. Please try again.', context, true, nodeError);
+            default:
+                return new StackMemoryError(ErrorCode.UNKNOWN_ERROR, nodeError.message, 'An unexpected system error occurred.', { ...context, nodeErrorCode: code }, false, nodeError);
+        }
+    }
+}
+export class ErrorHandler {
+    static handle(error, operation) {
+        if (error instanceof StackMemoryError) {
+            // Already a well-formed StackMemory error
+            console.error(`❌ ${error.userMessage}`);
+            if (error.recoverable) {
+                console.error('💡 This error may be recoverable. Please try again.');
+            }
+            process.exit(1);
+        }
+        if (error instanceof Error) {
+            // Convert Node.js error to StackMemoryError
+            let stackMemoryError;
+            if ('code' in error && typeof error.code === 'string') {
+                stackMemoryError = StackMemoryError.fromNodeError(error, { operation });
+            }
+            else {
+                stackMemoryError = new StackMemoryError(ErrorCode.OPERATION_FAILED, `Operation '${operation}' failed: ${error.message}`, `Operation failed: ${error.message}`, { operation }, false, error);
+            }
+            console.error(`❌ ${stackMemoryError.userMessage}`);
+            if (stackMemoryError.recoverable) {
+                console.error('💡 This error may be recoverable. Please try again.');
+            }
+            process.exit(1);
+        }
+        // Unknown error type
+        const unknownError = new StackMemoryError(ErrorCode.UNKNOWN_ERROR, `Unknown error in operation '${operation}': ${String(error)}`, 'An unexpected error occurred.', { operation, errorType: typeof error }, false);
+        console.error(`❌ ${unknownError.userMessage}`);
+        process.exit(1);
+    }
+    static async safeExecute(operation, operationName, fallback) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (fallback !== undefined) {
+                logger.warn(`Operation '${operationName}' failed, using fallback`, { error: String(error) });
+                return fallback;
+            }
+            ErrorHandler.handle(error, operationName);
+        }
+    }
+}
+// Utility functions for common error scenarios
+export const validateInput = (value, name, validator) => {
+    if (!validator(value)) {
+        throw new StackMemoryError(ErrorCode.INVALID_INPUT, `Invalid ${name}: ${String(value)}`, `Please provide a valid ${name}.`, { name, value }, true);
+    }
+};
+export const validateEmail = (email) => {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    if (!emailRegex.test(email) || email.length > 254) {
+        throw new StackMemoryError(ErrorCode.INVALID_INPUT, `Invalid email format: ${email}`, 'Please provide a valid email address.', { email }, true);
+    }
+};
+export const validatePath = (filePath) => {
+    if (!filePath || filePath.includes('..') || filePath.includes('\0')) {
+        throw new StackMemoryError(ErrorCode.INVALID_INPUT, `Invalid path: ${filePath}`, 'Invalid file path provided.', { path: filePath }, true);
+    }
+};
+//# sourceMappingURL=error-handler.js.map

package/dist/src/error-handler.js.map

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

package/dist/src/frame-manager.d.ts

@@ -0,0 +1,106 @@
+/**
+ * StackMemory Frame Manager - Call Stack Implementation
+ * Manages nested frames representing the call stack of work
+ */
+import Database from 'better-sqlite3';
+export type FrameType = 'task' | 'subtask' | 'tool_scope' | 'review' | 'write' | 'debug';
+export type FrameState = 'active' | 'closed';
+export interface Frame {
+    frame_id: string;
+    run_id: string;
+    project_id: string;
+    parent_frame_id?: string;
+    depth: number;
+    type: FrameType;
+    name: string;
+    state: FrameState;
+    inputs: Record<string, any>;
+    outputs: Record<string, any>;
+    digest_text?: string;
+    digest_json: Record<string, any>;
+    created_at: number;
+    closed_at?: number;
+}
+export interface FrameContext {
+    frameId: string;
+    header: {
+        goal: string;
+        constraints?: string[];
+        definitions?: Record<string, string>;
+    };
+    anchors: Anchor[];
+    recentEvents: Event[];
+    activeArtifacts: string[];
+}
+export interface Anchor {
+    anchor_id: string;
+    frame_id: string;
+    type: 'FACT' | 'DECISION' | 'CONSTRAINT' | 'INTERFACE_CONTRACT' | 'TODO' | 'RISK';
+    text: string;
+    priority: number;
+    metadata: Record<string, any>;
+}
+export interface Event {
+    event_id: string;
+    frame_id: string;
+    run_id: string;
+    seq: number;
+    event_type: 'user_message' | 'assistant_message' | 'tool_call' | 'tool_result' | 'decision' | 'constraint' | 'artifact' | 'observation';
+    payload: Record<string, any>;
+    ts: number;
+}
+export declare class FrameManager {
+    private db;
+    private currentRunId;
+    private projectId;
+    private activeStack;
+    constructor(db: Database.Database, projectId: string, runId?: string);
+    private initializeSchema;
+    private loadActiveStack;
+    private buildStackOrder;
+    /**
+     * Create a new frame and push to stack
+     */
+    createFrame(options: {
+        type: FrameType;
+        name: string;
+        inputs?: Record<string, any>;
+        parentFrameId?: string;
+    }): string;
+    /**
+     * Close the current frame and generate digest
+     */
+    closeFrame(frameId?: string, outputs?: Record<string, any>): void;
+    private closeChildFrames;
+    /**
+     * Generate digest for a frame
+     */
+    private generateDigest;
+    private generateDigestText;
+    /**
+     * Add event to current frame
+     */
+    addEvent(eventType: Event['event_type'], payload: Record<string, any>, frameId?: string): string;
+    /**
+     * Add anchor to frame
+     */
+    addAnchor(type: Anchor['type'], text: string, priority?: number, metadata?: Record<string, any>, frameId?: string): string;
+    /**
+     * Get hot stack context for current active frames
+     */
+    getHotStackContext(maxEvents?: number): FrameContext[];
+    /**
+     * Get active frame path (root to current)
+     */
+    getActiveFramePath(): Frame[];
+    getCurrentFrameId(): string | undefined;
+    getStackDepth(): number;
+    private getFrameDepth;
+    private getFrame;
+    private getFrameEvents;
+    private getFrameAnchors;
+    private getNextEventSequence;
+    private extractConstraints;
+    private getActiveArtifacts;
+}
+//# sourceMappingURL=frame-manager.d.ts.map

package/dist/src/frame-manager.d.ts.map

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