deepseek-coder-cli 1.0.0

package/dist/ui/globalWriteLock.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Global Write Lock - Robust streaming-safe output coordination
+ *
+ * This module provides a thread-safe mechanism to ensure streaming content
+ * is not interrupted by other UI components during streaming.
+ *
+ * Design Principles:
+ * - During streaming, ONLY streaming content writes to stdout
+ * - All other UI components (status, input area, etc.) wait until streaming ends
+ * - Supports nested/re-entrant locking with reference counting
+ * - Provides timeout-based automatic unlock for safety
+ *
+ * This prevents the garbled output and cutoffs that occur when multiple
+ * components try to write simultaneously with cursor positioning.
+ */
+/**
+ * Check if streaming mode is currently active
+ */
+export declare function isStreamingMode(): boolean;
+/**
+ * Get current lock depth (for debugging)
+ */
+export declare function getLockDepth(): number;
+/**
+ * Enter streaming mode - blocks all non-streaming output
+ * Supports nested calls with reference counting
+ */
+export declare function enterStreamingMode(): void;
+/**
+ * Exit streaming mode - allows normal UI output to resume
+ * Only fully exits when all nested locks are released
+ */
+export declare function exitStreamingMode(): void;
+/**
+ * Force release all locks (emergency/cleanup use)
+ */
+export declare function forceRelease(): void;
+/**
+ * Execute a callback only if not in streaming mode.
+ * Returns true if the callback was executed, false if skipped.
+ */
+export declare function ifNotStreaming(callback: () => void): boolean;
+/**
+ * Execute a callback when streaming ends (immediately if not streaming)
+ * Queues the callback if currently streaming
+ */
+export declare function whenStreamingEnds(callback: () => void): void;
+/**
+ * Execute callback with exclusive stream lock
+ * Automatically acquires and releases the lock
+ */
+export declare function withStreamLock<T>(callback: () => T | Promise<T>): Promise<T>;
+/**
+ * Legacy: installGlobalWriteLock is now a no-op
+ * The old approach of wrapping stdout.write caused nested lock issues.
+ * We now use a simpler streaming mode flag instead.
+ */
+export declare function installGlobalWriteLock(): void;
+/**
+ * Reset all state (for testing)
+ */
+export declare function resetGlobalWriteLock(): void;
+//# sourceMappingURL=globalWriteLock.d.ts.map

package/dist/ui/globalWriteLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalWriteLock.d.ts","sourceRoot":"","sources":["../../src/ui/globalWriteLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAczC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAWxC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAKnC;AA2BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAW5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAc5D;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOlF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/dist/ui/globalWriteLock.js

@@ -0,0 +1,173 @@
+/**
+ * Global Write Lock - Robust streaming-safe output coordination
+ *
+ * This module provides a thread-safe mechanism to ensure streaming content
+ * is not interrupted by other UI components during streaming.
+ *
+ * Design Principles:
+ * - During streaming, ONLY streaming content writes to stdout
+ * - All other UI components (status, input area, etc.) wait until streaming ends
+ * - Supports nested/re-entrant locking with reference counting
+ * - Provides timeout-based automatic unlock for safety
+ *
+ * This prevents the garbled output and cutoffs that occur when multiple
+ * components try to write simultaneously with cursor positioning.
+ */
+/** Current lock depth for re-entrant locking */
+let lockDepth = 0;
+/** Streaming mode flag (true when actively streaming content) */
+let streamingActive = false;
+/** Queue of callbacks waiting for stream to finish */
+const pendingCallbacks = [];
+/** Maximum pending callbacks to prevent memory leaks */
+const MAX_PENDING_CALLBACKS = 100;
+/** Safety timeout to auto-release stuck locks (30 seconds) */
+const LOCK_TIMEOUT_MS = 30000;
+/** Timer for auto-unlock safety mechanism */
+let safetyTimer = null;
+/**
+ * Check if streaming mode is currently active
+ */
+export function isStreamingMode() {
+    return streamingActive || lockDepth > 0;
+}
+/**
+ * Get current lock depth (for debugging)
+ */
+export function getLockDepth() {
+    return lockDepth;
+}
+/**
+ * Enter streaming mode - blocks all non-streaming output
+ * Supports nested calls with reference counting
+ */
+export function enterStreamingMode() {
+    lockDepth++;
+    streamingActive = true;
+    // Set safety timer on first lock
+    if (lockDepth === 1 && !safetyTimer) {
+        safetyTimer = setTimeout(() => {
+            if (streamingActive) {
+                // Force release if lock is held too long (safety mechanism)
+                console.warn('[GlobalWriteLock] Safety timeout triggered - forcing release');
+                forceRelease();
+            }
+        }, LOCK_TIMEOUT_MS);
+    }
+}
+/**
+ * Exit streaming mode - allows normal UI output to resume
+ * Only fully exits when all nested locks are released
+ */
+export function exitStreamingMode() {
+    if (lockDepth > 0) {
+        lockDepth--;
+    }
+    // Only clear streaming mode when all locks are released
+    if (lockDepth === 0) {
+        streamingActive = false;
+        clearSafetyTimer();
+        flushPendingCallbacks();
+    }
+}
+/**
+ * Force release all locks (emergency/cleanup use)
+ */
+export function forceRelease() {
+    lockDepth = 0;
+    streamingActive = false;
+    clearSafetyTimer();
+    flushPendingCallbacks();
+}
+/**
+ * Clear the safety timer
+ */
+function clearSafetyTimer() {
+    if (safetyTimer) {
+        clearTimeout(safetyTimer);
+        safetyTimer = null;
+    }
+}
+/**
+ * Flush all pending callbacks
+ */
+function flushPendingCallbacks() {
+    // Process callbacks in order
+    while (pendingCallbacks.length > 0) {
+        const callback = pendingCallbacks.shift();
+        try {
+            callback?.();
+        }
+        catch {
+            // Silently ignore callback errors to prevent cascading failures
+        }
+    }
+}
+/**
+ * Execute a callback only if not in streaming mode.
+ * Returns true if the callback was executed, false if skipped.
+ */
+export function ifNotStreaming(callback) {
+    if (isStreamingMode()) {
+        return false;
+    }
+    try {
+        callback();
+        return true;
+    }
+    catch {
+        // Silently handle callback errors
+        return false;
+    }
+}
+/**
+ * Execute a callback when streaming ends (immediately if not streaming)
+ * Queues the callback if currently streaming
+ */
+export function whenStreamingEnds(callback) {
+    if (!isStreamingMode()) {
+        try {
+            callback();
+        }
+        catch {
+            // Silently handle callback errors
+        }
+        return;
+    }
+    // Queue callback for later, with overflow protection
+    if (pendingCallbacks.length < MAX_PENDING_CALLBACKS) {
+        pendingCallbacks.push(callback);
+    }
+}
+/**
+ * Execute callback with exclusive stream lock
+ * Automatically acquires and releases the lock
+ */
+export async function withStreamLock(callback) {
+    enterStreamingMode();
+    try {
+        return await callback();
+    }
+    finally {
+        exitStreamingMode();
+    }
+}
+/**
+ * Legacy: installGlobalWriteLock is now a no-op
+ * The old approach of wrapping stdout.write caused nested lock issues.
+ * We now use a simpler streaming mode flag instead.
+ */
+export function installGlobalWriteLock() {
+    // No-op - we no longer wrap stdout.write
+    // The streaming mode flag handles coordination instead
+}
+/**
+ * Reset all state (for testing)
+ */
+export function resetGlobalWriteLock() {
+    lockDepth = 0;
+    streamingActive = false;
+    clearSafetyTimer();
+    pendingCallbacks.length = 0;
+}
+//# sourceMappingURL=globalWriteLock.js.map

package/dist/ui/globalWriteLock.js.map

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

package/dist/ui/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * UI Layer - AGI CLI User Interface System
+ *
+ * Layers (current stack):
+ * - Core primitives: theme.ts, layout.ts, uiConstants.ts, richText.ts
+ * - Render helpers: codeHighlighter.ts, textHighlighter.ts, errorFormatter.ts, toolDisplay.ts
+ * - Animation: animatedStatus.ts (uses animation/AnimationScheduler)
+ * - Controllers: PromptController.ts (input + key handling)
+ * - Renderer: UnifiedUIRenderer.ts (single event pipeline for terminal UI)
+ * - Integration: outputMode.ts + globalWriteLock.ts for shell safety
+ *
+ * Usage:
+ * - Colors/primitives: import { theme } from './theme.js';
+ * - Renderer: import { UnifiedUIRenderer } from './UnifiedUIRenderer.js';
+ * - Input handling: import { PromptController } from './PromptController.js';
+ * - Output selection helpers: import { isPlainOutputMode } from './outputMode.js';
+ */
+export { theme, icons, spinnerFrames, progressChars, boxChars, formatBanner, formatUserPrompt, USER_PROMPT_PREFIX, formatToolCall, formatMessage, neon, palette, getToolColor, formatToolName, } from './theme.js';
+export * from './uiConstants.js';
+export * from './designSystem.js';
+export * from './codeHighlighter.js';
+export * from './textHighlighter.js';
+export { formatError, formatErrorList, type ErrorInfo, type ErrorFormatOptions, } from './errorFormatter.js';
+export * from './toolDisplay.js';
+export * from './animatedStatus.js';
+export { formatThought, formatToolResult as formatToolResultPremium, formatProgressIndicator, formatSectionHeader, type ThoughtDisplayOptions, type ToolResultDisplayOptions, type ProgressIndicatorOptions, type VisualTone, } from './premiumComponents.js';
+export { PromptController } from './PromptController.js';
+export { UnifiedUIRenderer } from './UnifiedUIRenderer.js';
+export * from './outputMode.js';
+export { isStreamingMode, enterStreamingMode, exitStreamingMode, ifNotStreaming, whenStreamingEnds, withStreamLock, forceRelease, installGlobalWriteLock, resetGlobalWriteLock, } from './globalWriteLock.js';
+export { getTerminalColumns, isUltraNarrowMode, getContentWidth, wrapParagraph, wrapPreformatted, normalizePanelWidth, renderPanel, measure, stripAnsi, padLine, truncate, type Colorize, type PanelOptions, } from './layout.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EACL,KAAK,EACL,KAAK,EACL,aAAa,EACb,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,IAAI,EACJ,OAAO,EACP,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAMlC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,WAAW,EACX,eAAe,EACf,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAMjC,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EACL,aAAa,EACb,gBAAgB,IAAI,uBAAuB,EAC3C,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,UAAU,GAChB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,OAAO,EACP,SAAS,EACT,OAAO,EACP,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC"}

package/dist/ui/index.js

@@ -0,0 +1,54 @@
+/**
+ * UI Layer - AGI CLI User Interface System
+ *
+ * Layers (current stack):
+ * - Core primitives: theme.ts, layout.ts, uiConstants.ts, richText.ts
+ * - Render helpers: codeHighlighter.ts, textHighlighter.ts, errorFormatter.ts, toolDisplay.ts
+ * - Animation: animatedStatus.ts (uses animation/AnimationScheduler)
+ * - Controllers: PromptController.ts (input + key handling)
+ * - Renderer: UnifiedUIRenderer.ts (single event pipeline for terminal UI)
+ * - Integration: outputMode.ts + globalWriteLock.ts for shell safety
+ *
+ * Usage:
+ * - Colors/primitives: import { theme } from './theme.js';
+ * - Renderer: import { UnifiedUIRenderer } from './UnifiedUIRenderer.js';
+ * - Input handling: import { PromptController } from './PromptController.js';
+ * - Output selection helpers: import { isPlainOutputMode } from './outputMode.js';
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// Layer 1 - Core Primitives
+// ═══════════════════════════════════════════════════════════════════════════════
+export { theme, icons, spinnerFrames, progressChars, boxChars, formatBanner, formatUserPrompt, USER_PROMPT_PREFIX, formatToolCall, formatMessage, neon, palette, getToolColor, formatToolName, } from './theme.js';
+// Note: layout.js exports are at the bottom of this file to avoid conflicts
+export * from './uiConstants.js';
+export * from './designSystem.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Layer 2 - Specialized Renderers
+// ═══════════════════════════════════════════════════════════════════════════════
+export * from './codeHighlighter.js';
+export * from './textHighlighter.js';
+export { formatError, formatErrorList, } from './errorFormatter.js';
+export * from './toolDisplay.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Layer 3 - Components
+// ═══════════════════════════════════════════════════════════════════════════════
+export * from './animatedStatus.js';
+// Premium UI Components (enhanced visual design system)
+export { formatThought, formatToolResult as formatToolResultPremium, formatProgressIndicator, formatSectionHeader, } from './premiumComponents.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Layer 4 - Controllers
+// ═══════════════════════════════════════════════════════════════════════════════
+export { PromptController } from './PromptController.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Layer 5 - High-Level Renderers
+// ═══════════════════════════════════════════════════════════════════════════════
+export { UnifiedUIRenderer } from './UnifiedUIRenderer.js';
+// export * from './designSystem.js'; // File doesn't exist
+// ═══════════════════════════════════════════════════════════════════════════════
+// Layer 6 - Integration
+// ═══════════════════════════════════════════════════════════════════════════════
+export * from './outputMode.js';
+export { isStreamingMode, enterStreamingMode, exitStreamingMode, ifNotStreaming, whenStreamingEnds, withStreamLock, forceRelease, installGlobalWriteLock, resetGlobalWriteLock, } from './globalWriteLock.js';
+// Re-export layout utilities explicitly to avoid conflicts
+export { getTerminalColumns, isUltraNarrowMode, getContentWidth, wrapParagraph, wrapPreformatted, normalizePanelWidth, renderPanel, measure, stripAnsi, padLine, truncate, } from './layout.js';
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,kFAAkF;AAClF,4BAA4B;AAC5B,kFAAkF;AAElF,OAAO,EACL,KAAK,EACL,KAAK,EACL,aAAa,EACb,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,IAAI,EACJ,OAAO,EACP,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,4EAA4E;AAC5E,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAElC,kFAAkF;AAClF,kCAAkC;AAClC,kFAAkF;AAElF,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,WAAW,EACX,eAAe,GAGhB,MAAM,qBAAqB,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAEjC,kFAAkF;AAClF,uBAAuB;AACvB,kFAAkF;AAElF,cAAc,qBAAqB,CAAC;AAEpC,wDAAwD;AACxD,OAAO,EACL,aAAa,EACb,gBAAgB,IAAI,uBAAuB,EAC3C,uBAAuB,EACvB,mBAAmB,GAKpB,MAAM,wBAAwB,CAAC;AAEhC,kFAAkF;AAClF,wBAAwB;AACxB,kFAAkF;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,kFAAkF;AAClF,iCAAiC;AACjC,kFAAkF;AAElF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,2DAA2D;AAE3D,kFAAkF;AAClF,wBAAwB;AACxB,kFAAkF;AAElF,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,2DAA2D;AAC3D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,OAAO,EACP,SAAS,EACT,OAAO,EACP,QAAQ,GAGT,MAAM,aAAa,CAAC"}

package/dist/ui/interrupts/InterruptManager.d.ts

@@ -0,0 +1,157 @@
+/**
+ * InterruptManager - Manages user interruptions with priority queuing
+ * Handles interrupt prioritization, deferred execution, and smooth transitions
+ */
+import { EventEmitter } from 'events';
+export declare enum InterruptPriority {
+    CRITICAL = 100,// System errors, critical failures
+    HIGH = 75,// User cancellation requests, important alerts
+    NORMAL = 50,// Standard user input, questions
+    LOW = 25,// Hints, suggestions
+    BACKGROUND = 0
+}
+export type InterruptType = 'user-cancel' | 'user-input' | 'system-error' | 'confirmation' | 'hint' | 'alert' | 'question' | 'menu-selection';
+export interface InterruptConfig {
+    id: string;
+    type: InterruptType;
+    priority: InterruptPriority;
+    message: string;
+    metadata?: Record<string, unknown>;
+    timestamp: number;
+    ttl?: number;
+    deferrable?: boolean;
+    blocking?: boolean;
+    handler?: (interrupt: Interrupt) => void | Promise<void>;
+}
+export interface Interrupt extends InterruptConfig {
+    status: 'pending' | 'active' | 'deferred' | 'completed' | 'expired' | 'cancelled';
+    activatedAt?: number;
+    completedAt?: number;
+    deferredCount: number;
+}
+export interface InterruptPolicy {
+    maxQueueSize: number;
+    maxDeferrals: number;
+    defaultTTL: number;
+    allowConcurrent: boolean;
+    transitionDuration: number;
+}
+export declare class InterruptManager extends EventEmitter {
+    private pendingQueue;
+    private activeInterrupts;
+    private deferredInterrupts;
+    private policy;
+    private isProcessing;
+    private transitionTimer;
+    private expiryTimers;
+    private completionPollers;
+    private disposed;
+    constructor(policy?: Partial<InterruptPolicy>);
+    /**
+     * Queue a new interrupt
+     */
+    queue(config: Omit<InterruptConfig, 'id' | 'timestamp'>): string;
+    /**
+     * Process the interrupt queue
+     */
+    private processQueue;
+    /**
+     * Check if interrupt can be activated
+     */
+    private canActivate;
+    /**
+     * Activate an interrupt
+     */
+    private activateInterrupt;
+    /**
+     * Complete an interrupt
+     */
+    completeInterrupt(id: string): void;
+    /**
+     * Cancel an interrupt
+     */
+    cancelInterrupt(id: string): void;
+    /**
+     * Defer an interrupt
+     */
+    private deferInterrupt;
+    /**
+     * Restore deferred interrupts to queue
+     */
+    private restoreDeferredInterrupts;
+    /**
+     * Expire an interrupt
+     */
+    private expireInterrupt;
+    /**
+     * Check if interrupt has expired
+     */
+    private isExpired;
+    /**
+     * Schedule interrupt expiry
+     */
+    private scheduleExpiry;
+    /**
+     * Clear expiry timer for an interrupt
+     */
+    private clearExpiryTimer;
+    /**
+     * Wait for interrupt completion with timeout
+     */
+    private waitForCompletion;
+    /**
+     * Clear completion poller for an interrupt
+     */
+    private clearCompletionPoller;
+    /**
+     * Handle smooth transitions
+     */
+    private smoothTransition;
+    /**
+     * Find insertion index based on priority
+     */
+    private findInsertIndex;
+    /**
+     * Prune expired and low-priority interrupts from queue
+     */
+    private pruneQueue;
+    /**
+     * Generate unique interrupt ID
+     */
+    private generateId;
+    /**
+     * Get interrupt by ID
+     */
+    getInterrupt(id: string): Interrupt | undefined;
+    /**
+     * Get all interrupts with a specific status
+     */
+    getInterruptsByStatus(status: Interrupt['status']): Interrupt[];
+    /**
+     * Get queue statistics
+     */
+    getStatistics(): {
+        queueLength: number;
+        activeCount: number;
+        deferredCount: number;
+        averagePriority: number;
+        oldestTimestamp: number | null;
+    };
+    /**
+     * Clear all interrupts
+     */
+    clearAll(): void;
+    /**
+     * Update interrupt policy
+     */
+    updatePolicy(policy: Partial<InterruptPolicy>): void;
+    /**
+     * Dispose of the manager
+     */
+    dispose(): void;
+    /**
+     * Check if the manager has been disposed
+     */
+    isDisposed(): boolean;
+}
+//# sourceMappingURL=InterruptManager.d.ts.map

package/dist/ui/interrupts/InterruptManager.d.ts.map

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