@compass-ai/nova 1.0.73 → 1.0.74

package/dist/services/temp-file-service.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Temp File Service
+ *
+ * Temp file management for preview functionality.
+ * Manages temporary files with automatic cleanup, startup cleanup for orphaned files,
+ * and registry tracking for active temp files.
+ *
+ * Features:
+ * - Centralized temp directory management (.compass/temp/previews/)
+ * - Unique naming with preserved extensions for syntax highlighting
+ * - In-memory registry for active temp files
+ * - Startup cleanup for orphaned files (>1 hour old)
+ * - Graceful degradation on errors
+ */
+import { TEMP_DIR } from '../constants/defaults.js';
+export { TEMP_DIR };
+/**
+ * Name of the previews subdirectory within temp
+ */
+export declare const PREVIEW_TEMP_DIR = "previews";
+/**
+ * Maximum age for temp files before cleanup (1 hour in milliseconds)
+ */
+export declare const TEMP_FILE_MAX_AGE_MS: number;
+/**
+ * Options for creating a temp file
+ */
+export interface TempFileOptions {
+    /** Prefix for the temp file name (default: 'temp') */
+    prefix?: string;
+    /** File extension to preserve for syntax highlighting (include the dot, e.g., '.ts') */
+    extension?: string;
+    /** Content to write to the temp file */
+    content: string;
+    /** Optional metadata to associate with the temp file */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Record of a created temp file
+ */
+export interface TempFileRecord {
+    /** Unique identifier for the temp file */
+    id: string;
+    /** Full path to the temp file */
+    tempPath: string;
+    /** Original target file path (if applicable) */
+    originalPath?: string;
+    /** Timestamp when the temp file was created */
+    createdAt: number;
+    /** Purpose of the temp file */
+    purpose: 'preview' | 'atomic' | 'other';
+    /** Associated metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Service for managing temporary files with automatic cleanup.
+ *
+ * @example
+ * ```typescript
+ * const tempService = getTempFileService();
+ *
+ * // Create a temp file for preview
+ * const record = await tempService.createTempFile({
+ *   prefix: 'preview',
+ *   extension: '.ts',
+ *   content: 'const x = 1;',
+ *   metadata: { originalPath: '/path/to/file.ts' }
+ * });
+ *
+ * // Use the temp file...
+ * console.log(record.tempPath);
+ *
+ * // Clean up when done
+ * await tempService.deleteTempFile(record.id);
+ * ```
+ */
+export declare class TempFileService {
+    /** In-memory registry of active temp files */
+    private registry;
+    /** Base temp directory path */
+    private tempDir;
+    /** Whether the service has been initialized */
+    private initialized;
+    constructor();
+    /**
+     * Sets a custom temp directory path.
+     * Useful for testing or when working directory changes.
+     *
+     * @param dir - New temp directory path
+     */
+    setTempDir(dir: string): void;
+    /**
+     * Gets the current temp directory path.
+     *
+     * @returns The temp directory path
+     */
+    getTempDir(): string;
+    /**
+     * Initializes the temp file service.
+     * Creates the temp directory if it doesn't exist and cleans up stale files.
+     * Should be called on CLI startup.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Creates a temporary file with the given content.
+     *
+     * @param options - Options for creating the temp file
+     * @returns Record containing the temp file info, or undefined on error
+     */
+    createTempFile(options: TempFileOptions): Promise<TempFileRecord | undefined>;
+    /**
+     * Deletes a temporary file by its ID.
+     *
+     * @param id - The ID of the temp file to delete
+     * @returns True if deleted successfully, false otherwise
+     */
+    deleteTempFile(id: string): Promise<boolean>;
+    /**
+     * Cleans up all temp files in the registry.
+     *
+     * @returns Number of files cleaned up
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Cleans up stale temp files older than the specified age.
+     * This includes both registry entries and orphaned files on disk.
+     *
+     * @param maxAgeMs - Maximum age in milliseconds
+     * @returns Number of files cleaned up
+     */
+    cleanupStale(maxAgeMs: number): Promise<number>;
+    /**
+     * Gets the count of active temp files in the registry.
+     *
+     * @returns Number of active temp files
+     */
+    getActiveCount(): number;
+    /**
+     * Gets a temp file record by ID.
+     *
+     * @param id - The ID of the temp file
+     * @returns The temp file record, or undefined if not found
+     */
+    getRecord(id: string): TempFileRecord | undefined;
+    /**
+     * Checks if a temp file exists by ID.
+     *
+     * @param id - The ID of the temp file
+     * @returns True if the temp file exists in the registry
+     */
+    hasRecord(id: string): boolean;
+}
+/**
+ * Gets the singleton TempFileService instance.
+ *
+ * @returns The TempFileService instance
+ */
+export declare function getTempFileService(): TempFileService;
+/**
+ * Resets the singleton instance (mainly for testing).
+ */
+export declare function resetTempFileService(): void;
+export { TempFileService as default };
+//# sourceMappingURL=temp-file-service.d.ts.map

package/dist/services/temp-file-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temp-file-service.d.ts","sourceRoot":"","sources":["../../src/services/temp-file-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,EAAuB,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAMpB;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAiB,CAAC;AAMnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,OAAO,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAe;IAC1B,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAA0C;IAE1D,+BAA+B;IAC/B,OAAO,CAAC,OAAO,CAAS;IAExB,+CAA+C;IAC/C,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7B;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBjC;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAsDnF;;;;;OAKG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BlD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAYhC;;;;;;OAMG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2CrD;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIjD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAG/B;AASD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,CAAC"}

package/dist/services/temp-file-service.js

@@ -0,0 +1,303 @@
+/**
+ * Temp File Service
+ *
+ * Temp file management for preview functionality.
+ * Manages temporary files with automatic cleanup, startup cleanup for orphaned files,
+ * and registry tracking for active temp files.
+ *
+ * Features:
+ * - Centralized temp directory management (.compass/temp/previews/)
+ * - Unique naming with preserved extensions for syntax highlighting
+ * - In-memory registry for active temp files
+ * - Startup cleanup for orphaned files (>1 hour old)
+ * - Graceful degradation on errors
+ */
+import path from 'path';
+import fs from 'fs-extra';
+import { v4 as uuidv4 } from 'uuid';
+import { logger } from '../utils/logger.js';
+import { ensureDir } from '../utils/file-system.js';
+import { PROJECT_COMPASS_DIR, TEMP_DIR } from '../constants/defaults.js';
+// Re-export TEMP_DIR so existing consumers that import it from here continue to work
+export { TEMP_DIR };
+// =============================================================================
+// Constants
+// =============================================================================
+/**
+ * Name of the previews subdirectory within temp
+ */
+export const PREVIEW_TEMP_DIR = 'previews';
+/**
+ * Maximum age for temp files before cleanup (1 hour in milliseconds)
+ */
+export const TEMP_FILE_MAX_AGE_MS = 60 * 60 * 1000;
+// =============================================================================
+// TempFileService Class
+// =============================================================================
+/**
+ * Service for managing temporary files with automatic cleanup.
+ *
+ * @example
+ * ```typescript
+ * const tempService = getTempFileService();
+ *
+ * // Create a temp file for preview
+ * const record = await tempService.createTempFile({
+ *   prefix: 'preview',
+ *   extension: '.ts',
+ *   content: 'const x = 1;',
+ *   metadata: { originalPath: '/path/to/file.ts' }
+ * });
+ *
+ * // Use the temp file...
+ * console.log(record.tempPath);
+ *
+ * // Clean up when done
+ * await tempService.deleteTempFile(record.id);
+ * ```
+ */
+export class TempFileService {
+    /** In-memory registry of active temp files */
+    registry = new Map();
+    /** Base temp directory path */
+    tempDir;
+    /** Whether the service has been initialized */
+    initialized = false;
+    constructor() {
+        // Default temp directory - can be customized via setTempDir
+        this.tempDir = path.join(process.cwd(), PROJECT_COMPASS_DIR, TEMP_DIR, PREVIEW_TEMP_DIR);
+    }
+    /**
+     * Sets a custom temp directory path.
+     * Useful for testing or when working directory changes.
+     *
+     * @param dir - New temp directory path
+     */
+    setTempDir(dir) {
+        this.tempDir = dir;
+        this.initialized = false; // Reset initialization state
+    }
+    /**
+     * Gets the current temp directory path.
+     *
+     * @returns The temp directory path
+     */
+    getTempDir() {
+        return this.tempDir;
+    }
+    /**
+     * Initializes the temp file service.
+     * Creates the temp directory if it doesn't exist and cleans up stale files.
+     * Should be called on CLI startup.
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        try {
+            // Ensure temp directory exists
+            await ensureDir(this.tempDir);
+            // Clean up stale files from previous sessions
+            const cleanedCount = await this.cleanupStale(TEMP_FILE_MAX_AGE_MS);
+            if (cleanedCount > 0) {
+                logger.debug(`TempFileService: Cleaned up ${cleanedCount} stale temp files`);
+            }
+            this.initialized = true;
+            logger.debug('TempFileService initialized', { tempDir: this.tempDir });
+        }
+        catch (error) {
+            // Log but don't fail - temp file service is non-critical
+            logger.warn('TempFileService initialization failed', { error });
+            this.initialized = true; // Mark as initialized to prevent repeated attempts
+        }
+    }
+    /**
+     * Creates a temporary file with the given content.
+     *
+     * @param options - Options for creating the temp file
+     * @returns Record containing the temp file info, or undefined on error
+     */
+    async createTempFile(options) {
+        const { prefix = 'temp', extension = '', content, metadata } = options;
+        try {
+            // Ensure temp directory exists
+            await ensureDir(this.tempDir);
+            // Generate unique ID and filename
+            const id = uuidv4();
+            const shortId = id.substring(0, 8);
+            // Sanitize the original filename if provided in metadata
+            let sanitizedName = '';
+            if (metadata?.originalPath && typeof metadata.originalPath === 'string') {
+                const originalName = path.basename(metadata.originalPath, path.extname(metadata.originalPath));
+                // Remove any characters that might cause issues in filenames
+                sanitizedName = originalName.replace(/[^a-zA-Z0-9_-]/g, '_').substring(0, 50);
+                if (sanitizedName) {
+                    sanitizedName = `-${sanitizedName}`;
+                }
+            }
+            // Build filename: prefix-sanitizedName-shortId.extension
+            const filename = `${prefix}${sanitizedName}-${shortId}${extension}`;
+            const tempPath = path.join(this.tempDir, filename);
+            // Write the file
+            await fs.writeFile(tempPath, content, 'utf8');
+            // Create and register the record
+            const record = {
+                id,
+                tempPath,
+                originalPath: metadata?.originalPath,
+                createdAt: Date.now(),
+                purpose: prefix === 'preview' ? 'preview' : 'other',
+                metadata,
+            };
+            this.registry.set(id, record);
+            logger.debug('TempFileService: Created temp file', {
+                id,
+                tempPath,
+                originalPath: record.originalPath,
+            });
+            return record;
+        }
+        catch (error) {
+            logger.warn('TempFileService: Failed to create temp file', { error, options });
+            return undefined;
+        }
+    }
+    /**
+     * Deletes a temporary file by its ID.
+     *
+     * @param id - The ID of the temp file to delete
+     * @returns True if deleted successfully, false otherwise
+     */
+    async deleteTempFile(id) {
+        const record = this.registry.get(id);
+        if (!record) {
+            logger.debug('TempFileService: Temp file not found in registry', { id });
+            return false;
+        }
+        try {
+            // Remove from filesystem
+            if (await fs.pathExists(record.tempPath)) {
+                await fs.remove(record.tempPath);
+            }
+            // Remove from registry
+            this.registry.delete(id);
+            logger.debug('TempFileService: Deleted temp file', { id, tempPath: record.tempPath });
+            return true;
+        }
+        catch (error) {
+            logger.warn('TempFileService: Failed to delete temp file', { id, error });
+            // Still remove from registry even if filesystem delete fails
+            this.registry.delete(id);
+            return false;
+        }
+    }
+    /**
+     * Cleans up all temp files in the registry.
+     *
+     * @returns Number of files cleaned up
+     */
+    async cleanup() {
+        let cleanedCount = 0;
+        for (const [id] of this.registry) {
+            if (await this.deleteTempFile(id)) {
+                cleanedCount++;
+            }
+        }
+        return cleanedCount;
+    }
+    /**
+     * Cleans up stale temp files older than the specified age.
+     * This includes both registry entries and orphaned files on disk.
+     *
+     * @param maxAgeMs - Maximum age in milliseconds
+     * @returns Number of files cleaned up
+     */
+    async cleanupStale(maxAgeMs) {
+        let cleanedCount = 0;
+        const now = Date.now();
+        const cutoffTime = now - maxAgeMs;
+        // Clean up stale registry entries
+        for (const [id, record] of this.registry) {
+            if (record.createdAt < cutoffTime) {
+                if (await this.deleteTempFile(id)) {
+                    cleanedCount++;
+                }
+            }
+        }
+        // Clean up orphaned files on disk (from crashed sessions)
+        try {
+            if (await fs.pathExists(this.tempDir)) {
+                const files = await fs.readdir(this.tempDir);
+                for (const file of files) {
+                    const filePath = path.join(this.tempDir, file);
+                    try {
+                        const stats = await fs.stat(filePath);
+                        // Check if file is older than max age
+                        if (stats.mtimeMs < cutoffTime) {
+                            await fs.remove(filePath);
+                            cleanedCount++;
+                            logger.debug('TempFileService: Cleaned up orphaned temp file', { filePath });
+                        }
+                    }
+                    catch {
+                        // Ignore errors for individual files
+                    }
+                }
+            }
+        }
+        catch (error) {
+            logger.warn('TempFileService: Error during stale cleanup', { error });
+        }
+        return cleanedCount;
+    }
+    /**
+     * Gets the count of active temp files in the registry.
+     *
+     * @returns Number of active temp files
+     */
+    getActiveCount() {
+        return this.registry.size;
+    }
+    /**
+     * Gets a temp file record by ID.
+     *
+     * @param id - The ID of the temp file
+     * @returns The temp file record, or undefined if not found
+     */
+    getRecord(id) {
+        return this.registry.get(id);
+    }
+    /**
+     * Checks if a temp file exists by ID.
+     *
+     * @param id - The ID of the temp file
+     * @returns True if the temp file exists in the registry
+     */
+    hasRecord(id) {
+        return this.registry.has(id);
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+/** Singleton instance of TempFileService */
+let tempFileServiceInstance = null;
+/**
+ * Gets the singleton TempFileService instance.
+ *
+ * @returns The TempFileService instance
+ */
+export function getTempFileService() {
+    if (!tempFileServiceInstance) {
+        tempFileServiceInstance = new TempFileService();
+    }
+    return tempFileServiceInstance;
+}
+/**
+ * Resets the singleton instance (mainly for testing).
+ */
+export function resetTempFileService() {
+    tempFileServiceInstance = null;
+}
+export { TempFileService as default };
+//# sourceMappingURL=temp-file-service.js.map

package/dist/services/temp-file-service.js.map

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

package/dist/services/token-limit-enforcer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @deprecated Use TokenTracker directly for all token limit enforcement.
+ *
+ * This file is a thin backward-compatibility facade. All state management,
+ * rolling window logic, and limit checking now live in TokenTracker and
+ * TokenLimitStore. This class delegates every call to those services.
+ *
+ * Will be removed in a future release once all consumers are migrated.
+ */
+import { TokenLimitStore } from './token-limit-store.js';
+/**
+ * @deprecated Use TokenTracker.checkLimit() and TokenTracker.recordLimitUsage() instead.
+ *
+ * Retained for backward compatibility with consumers that haven't migrated yet.
+ * All methods delegate to the underlying TokenLimitStore (which now uses the
+ * unified rolling window format).
+ */
+export declare class TokenLimitEnforcer {
+    private readonly store;
+    private constructor();
+    /**
+     * @deprecated Use TokenTracker directly.
+     */
+    static create(): TokenLimitEnforcer;
+    /**
+     * @deprecated Use TokenTracker directly.
+     */
+    static createWithStore(store: TokenLimitStore): TokenLimitEnforcer;
+    /**
+     * @deprecated Always returns true — enforcement is now in TokenTracker.
+     */
+    isEnabled(): boolean;
+    /**
+     * @deprecated Use TokenTracker.checkLimit() instead.
+     *
+     * No-op in the facade — the real enforcement happens in anthropic-client.ts
+     * via TokenTracker.checkLimit(). Kept to avoid breaking callers during migration.
+     */
+    checkLimits(_provider: string, _model: string, _estimatedTokens: number): Promise<void>;
+    /**
+     * @deprecated Use TokenTracker.recordLimitUsage() instead.
+     *
+     * Still records to the store for backward compat, but the canonical
+     * recording path is TokenTracker.recordLimitUsage().
+     */
+    recordActualUsage(provider: string, model: string, actualTokens: number): Promise<void>;
+    /**
+     * Returns the underlying store.
+     * @deprecated Access the store via createTokenLimitStore() directly.
+     */
+    getStore(): TokenLimitStore;
+}
+//# sourceMappingURL=token-limit-enforcer.d.ts.map

package/dist/services/token-limit-enforcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-limit-enforcer.d.ts","sourceRoot":"","sources":["../../src/services/token-limit-enforcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAyB,MAAM,wBAAwB,CAAC;AAgBhF;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IADxB,OAAO;IAQP;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,kBAAkB;IAKnC;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,kBAAkB;IAQlE;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;OAKG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;OAKG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAUhB;;;OAGG;IACH,QAAQ,IAAI,eAAe;CAG5B"}

package/dist/services/token-limit-enforcer.js

@@ -0,0 +1,90 @@
+/**
+ * @deprecated Use TokenTracker directly for all token limit enforcement.
+ *
+ * This file is a thin backward-compatibility facade. All state management,
+ * rolling window logic, and limit checking now live in TokenTracker and
+ * TokenLimitStore. This class delegates every call to those services.
+ *
+ * Will be removed in a future release once all consumers are migrated.
+ */
+import { createTokenLimitStore } from './token-limit-store.js';
+import { logger } from '../utils/logger.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Normalise a provider or model key to lowercase, trimmed. */
+function normaliseKey(key) {
+    return key.toLowerCase().trim();
+}
+// ---------------------------------------------------------------------------
+// TokenLimitEnforcer (deprecated facade)
+// ---------------------------------------------------------------------------
+/**
+ * @deprecated Use TokenTracker.checkLimit() and TokenTracker.recordLimitUsage() instead.
+ *
+ * Retained for backward compatibility with consumers that haven't migrated yet.
+ * All methods delegate to the underlying TokenLimitStore (which now uses the
+ * unified rolling window format).
+ */
+export class TokenLimitEnforcer {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    // -------------------------------------------------------------------------
+    // Factory
+    // -------------------------------------------------------------------------
+    /**
+     * @deprecated Use TokenTracker directly.
+     */
+    static create() {
+        const store = createTokenLimitStore();
+        return new TokenLimitEnforcer(store);
+    }
+    /**
+     * @deprecated Use TokenTracker directly.
+     */
+    static createWithStore(store) {
+        return new TokenLimitEnforcer(store);
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /**
+     * @deprecated Always returns true — enforcement is now in TokenTracker.
+     */
+    isEnabled() {
+        return true;
+    }
+    /**
+     * @deprecated Use TokenTracker.checkLimit() instead.
+     *
+     * No-op in the facade — the real enforcement happens in anthropic-client.ts
+     * via TokenTracker.checkLimit(). Kept to avoid breaking callers during migration.
+     */
+    async checkLimits(_provider, _model, _estimatedTokens) {
+        // No-op — enforcement delegated to TokenTracker.checkLimit()
+    }
+    /**
+     * @deprecated Use TokenTracker.recordLimitUsage() instead.
+     *
+     * Still records to the store for backward compat, but the canonical
+     * recording path is TokenTracker.recordLimitUsage().
+     */
+    async recordActualUsage(provider, model, actualTokens) {
+        try {
+            await this.store.recordUsage(normaliseKey(model), actualTokens);
+        }
+        catch (err) {
+            logger.warn(`[TokenLimitEnforcer] Failed to record usage for ${provider}/${model}: ${String(err)}`);
+        }
+    }
+    /**
+     * Returns the underlying store.
+     * @deprecated Access the store via createTokenLimitStore() directly.
+     */
+    getStore() {
+        return this.store;
+    }
+}
+//# sourceMappingURL=token-limit-enforcer.js.map

package/dist/services/token-limit-enforcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-limit-enforcer.js","sourceRoot":"","sources":["../../src/services/token-limit-enforcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAmB,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,+DAA+D;AAC/D,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IAEV;IADnB,YACmB,KAAsB;QAAtB,UAAK,GAAL,KAAK,CAAiB;IACtC,CAAC;IAEJ,4EAA4E;IAC5E,UAAU;IACV,4EAA4E;IAE5E;;OAEG;IACH,MAAM,CAAC,MAAM;QACX,MAAM,KAAK,GAAG,qBAAqB,EAAE,CAAC;QACtC,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAsB;QAC3C,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CACf,SAAiB,EACjB,MAAc,EACd,gBAAwB;QAExB,6DAA6D;IAC/D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CACrB,QAAgB,EAChB,KAAa,EACb,YAAoB;QAEpB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACT,mDAAmD,QAAQ,IAAI,KAAK,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CACvF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}