claudecode-omc 4.3.4

package/dist/hud/background-cleanup.d.ts

@@ -0,0 +1,28 @@
+/**
+ * OMC HUD - Background Task Cleanup
+ *
+ * Handles cleanup of stale and orphaned background tasks on HUD startup.
+ */
+import type { BackgroundTask } from './types.js';
+/**
+ * Clean up stale background tasks from HUD state.
+ * Removes tasks that are old and not recently completed.
+ *
+ * @param thresholdMs Age threshold in milliseconds (default: 30 minutes)
+ * @returns Number of tasks removed
+ */
+export declare function cleanupStaleBackgroundTasks(thresholdMs?: number): Promise<number>;
+/**
+ * Detect orphaned background tasks that are still marked as running
+ * but are likely from a previous session crash.
+ *
+ * @returns Array of orphaned tasks
+ */
+export declare function detectOrphanedTasks(): Promise<BackgroundTask[]>;
+/**
+ * Mark orphaned tasks as stale/completed to clean up the display.
+ *
+ * @returns Number of tasks marked
+ */
+export declare function markOrphanedTasksAsStale(): Promise<number>;
+//# sourceMappingURL=background-cleanup.d.ts.map

package/dist/hud/background-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-cleanup.d.ts","sourceRoot":"","sources":["../../src/hud/background-cleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,GAAE,MAAgC,GAC5C,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAyBrE;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuBhE"}

package/dist/hud/background-cleanup.js

@@ -0,0 +1,92 @@
+/**
+ * OMC HUD - Background Task Cleanup
+ *
+ * Handles cleanup of stale and orphaned background tasks on HUD startup.
+ */
+import { readHudState, writeHudState } from './state.js';
+const STALE_TASK_THRESHOLD_MS = 30 * 60 * 1000; // 30 minutes default
+/**
+ * Clean up stale background tasks from HUD state.
+ * Removes tasks that are old and not recently completed.
+ *
+ * @param thresholdMs Age threshold in milliseconds (default: 30 minutes)
+ * @returns Number of tasks removed
+ */
+export async function cleanupStaleBackgroundTasks(thresholdMs = STALE_TASK_THRESHOLD_MS) {
+    const state = readHudState();
+    if (!state || !state.backgroundTasks) {
+        return 0;
+    }
+    const now = Date.now();
+    const originalCount = state.backgroundTasks.length;
+    // Filter out stale tasks
+    state.backgroundTasks = state.backgroundTasks.filter(task => {
+        // Use startedAt for age calculation
+        const taskAge = now - new Date(task.startedAt).getTime();
+        // Keep if:
+        // - Task is completed (for history)
+        // - Task is recent (within threshold)
+        return task.status === 'completed' || taskAge < thresholdMs;
+    });
+    // Limit history to 20 most recent
+    if (state.backgroundTasks.length > 20) {
+        state.backgroundTasks = state.backgroundTasks.slice(-20);
+    }
+    const removedCount = originalCount - state.backgroundTasks.length;
+    if (removedCount > 0) {
+        writeHudState(state);
+    }
+    return removedCount;
+}
+/**
+ * Detect orphaned background tasks that are still marked as running
+ * but are likely from a previous session crash.
+ *
+ * @returns Array of orphaned tasks
+ */
+export async function detectOrphanedTasks() {
+    const state = readHudState();
+    if (!state || !state.backgroundTasks) {
+        return [];
+    }
+    // Detect tasks that are marked as running but should have completed
+    // (e.g., from previous session crashes)
+    const orphaned = [];
+    for (const task of state.backgroundTasks) {
+        if (task.status === 'running') {
+            // Check if task is from a previous HUD session
+            // (simple heuristic: running for more than 2 hours is likely orphaned)
+            const taskAge = Date.now() - new Date(task.startedAt).getTime();
+            const TWO_HOURS_MS = 2 * 60 * 60 * 1000;
+            if (taskAge > TWO_HOURS_MS) {
+                orphaned.push(task);
+            }
+        }
+    }
+    return orphaned;
+}
+/**
+ * Mark orphaned tasks as stale/completed to clean up the display.
+ *
+ * @returns Number of tasks marked
+ */
+export async function markOrphanedTasksAsStale() {
+    const state = readHudState();
+    if (!state || !state.backgroundTasks) {
+        return 0;
+    }
+    const orphaned = await detectOrphanedTasks();
+    let marked = 0;
+    for (const orphanedTask of orphaned) {
+        const task = state.backgroundTasks.find(t => t.id === orphanedTask.id);
+        if (task && task.status === 'running') {
+            task.status = 'completed'; // Mark as completed to remove from active display
+            marked++;
+        }
+    }
+    if (marked > 0) {
+        writeHudState(state);
+    }
+    return marked;
+}
+//# sourceMappingURL=background-cleanup.js.map

package/dist/hud/background-cleanup.js.map

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

package/dist/hud/background-tasks.d.ts

@@ -0,0 +1,26 @@
+/**
+ * OMC HUD - Background Task Management
+ *
+ * Functions for tracking background tasks via hooks.
+ * Called from bridge.ts pre-tool-use and post-tool-use handlers.
+ */
+/**
+ * Add a background task to HUD state.
+ * Called when a Task tool starts with run_in_background=true.
+ */
+export declare function addBackgroundTask(id: string, description: string, agentType?: string, directory?: string): boolean;
+/**
+ * Mark a background task as completed.
+ * Called when a Task tool completes.
+ */
+export declare function completeBackgroundTask(id: string, directory?: string, failed?: boolean): boolean;
+/**
+ * Get count of running background tasks.
+ */
+export declare function getRunningTaskCount(directory?: string): number;
+/**
+ * Clear all background tasks.
+ * Useful for cleanup or reset.
+ */
+export declare function clearBackgroundTasks(directory?: string): boolean;
+//# sourceMappingURL=background-tasks.d.ts.map

package/dist/hud/background-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-tasks.d.ts","sourceRoot":"","sources":["../../src/hud/background-tasks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAuBT;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,EACV,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,GAAE,OAAe,GACtB,OAAO,CAoBT;AA6CD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAOhE"}

package/dist/hud/background-tasks.js

@@ -0,0 +1,116 @@
+/**
+ * OMC HUD - Background Task Management
+ *
+ * Functions for tracking background tasks via hooks.
+ * Called from bridge.ts pre-tool-use and post-tool-use handlers.
+ */
+import { readHudState, writeHudState, createEmptyHudState } from './state.js';
+const MAX_TASK_HISTORY = 20;
+const TASK_EXPIRY_MS = 30 * 60 * 1000; // 30 minutes
+/**
+ * Add a background task to HUD state.
+ * Called when a Task tool starts with run_in_background=true.
+ */
+export function addBackgroundTask(id, description, agentType, directory) {
+    try {
+        let state = readHudState(directory) || createEmptyHudState();
+        // Clean up old/expired tasks
+        state = cleanupTasks(state);
+        // Add new task
+        const task = {
+            id,
+            description,
+            agentType,
+            startedAt: new Date().toISOString(),
+            status: 'running',
+        };
+        state.backgroundTasks.push(task);
+        state.timestamp = new Date().toISOString();
+        return writeHudState(state, directory);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Mark a background task as completed.
+ * Called when a Task tool completes.
+ */
+export function completeBackgroundTask(id, directory, failed = false) {
+    try {
+        const state = readHudState(directory);
+        if (!state) {
+            return false;
+        }
+        const task = state.backgroundTasks.find((t) => t.id === id);
+        if (!task) {
+            return false;
+        }
+        task.status = failed ? 'failed' : 'completed';
+        task.completedAt = new Date().toISOString();
+        state.timestamp = new Date().toISOString();
+        return writeHudState(state, directory);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clean up old and expired tasks from state.
+ */
+function cleanupTasks(state) {
+    const now = Date.now();
+    // Filter out expired completed/failed tasks
+    state.backgroundTasks = state.backgroundTasks.filter((task) => {
+        // Keep running tasks
+        if (task.status === 'running') {
+            // But check if they're stale (started more than expiry time ago)
+            const startedAt = new Date(task.startedAt).getTime();
+            if (now - startedAt > TASK_EXPIRY_MS) {
+                // Mark as failed and keep for history
+                task.status = 'failed';
+                task.completedAt = new Date().toISOString();
+            }
+            return true;
+        }
+        // For completed/failed, check expiry
+        if (task.completedAt) {
+            const completedAt = new Date(task.completedAt).getTime();
+            return now - completedAt < TASK_EXPIRY_MS;
+        }
+        return true;
+    });
+    // Limit total history
+    if (state.backgroundTasks.length > MAX_TASK_HISTORY) {
+        // Keep running tasks and most recent completed
+        const running = state.backgroundTasks.filter((t) => t.status === 'running');
+        const completed = state.backgroundTasks
+            .filter((t) => t.status !== 'running')
+            .slice(-Math.max(0, MAX_TASK_HISTORY - running.length));
+        state.backgroundTasks = [...running, ...completed];
+    }
+    return state;
+}
+/**
+ * Get count of running background tasks.
+ */
+export function getRunningTaskCount(directory) {
+    const state = readHudState(directory);
+    if (!state)
+        return 0;
+    return state.backgroundTasks.filter((t) => t.status === 'running').length;
+}
+/**
+ * Clear all background tasks.
+ * Useful for cleanup or reset.
+ */
+export function clearBackgroundTasks(directory) {
+    try {
+        const state = createEmptyHudState();
+        return writeHudState(state, directory);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=background-tasks.js.map

package/dist/hud/background-tasks.js.map

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

package/dist/hud/colors.d.ts

@@ -0,0 +1,54 @@
+/**
+ * OMC HUD - ANSI Color Utilities
+ *
+ * Terminal color codes for statusline rendering.
+ * Based on claude-hud reference implementation.
+ */
+export declare const RESET = "\u001B[0m";
+export declare function green(text: string): string;
+export declare function yellow(text: string): string;
+export declare function red(text: string): string;
+export declare function cyan(text: string): string;
+export declare function magenta(text: string): string;
+export declare function blue(text: string): string;
+export declare function dim(text: string): string;
+export declare function bold(text: string): string;
+export declare function white(text: string): string;
+export declare function brightCyan(text: string): string;
+export declare function brightMagenta(text: string): string;
+export declare function brightBlue(text: string): string;
+/**
+ * Get color code based on context window percentage.
+ */
+export declare function getContextColor(percent: number): string;
+/**
+ * Get color code based on ralph iteration.
+ */
+export declare function getRalphColor(iteration: number, maxIterations: number): string;
+/**
+ * Get color for todo progress.
+ */
+export declare function getTodoColor(completed: number, total: number): string;
+/**
+ * Get color for model tier.
+ * - Opus: Magenta (high-powered)
+ * - Sonnet: Yellow (standard)
+ * - Haiku: Green (lightweight)
+ */
+export declare function getModelTierColor(model: string | undefined): string;
+/**
+ * Get color for agent duration (warning/alert).
+ * - <2min: normal (green)
+ * - 2-5min: warning (yellow)
+ * - >5min: alert (red)
+ */
+export declare function getDurationColor(durationMs: number): string;
+/**
+ * Create a colored progress bar.
+ */
+export declare function coloredBar(percent: number, width?: number): string;
+/**
+ * Create a simple numeric display with color.
+ */
+export declare function coloredValue(value: number, total: number, getColor: (value: number, total: number) => string): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/hud/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/hud/colors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,KAAK,cAAY,CAAC;AAkB/B,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAO9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMrE;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAOnE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3D;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM,CAWtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GACjD,MAAM,CAGR"}

package/dist/hud/colors.js

@@ -0,0 +1,156 @@
+/**
+ * OMC HUD - ANSI Color Utilities
+ *
+ * Terminal color codes for statusline rendering.
+ * Based on claude-hud reference implementation.
+ */
+// ANSI escape codes
+export const RESET = '\x1b[0m';
+const DIM = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const RED = '\x1b[31m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const BLUE = '\x1b[34m';
+const MAGENTA = '\x1b[35m';
+const CYAN = '\x1b[36m';
+const WHITE = '\x1b[37m';
+const BRIGHT_BLUE = '\x1b[94m';
+const BRIGHT_MAGENTA = '\x1b[95m';
+const BRIGHT_CYAN = '\x1b[96m';
+// ============================================================================
+// Color Functions
+// ============================================================================
+export function green(text) {
+    return `${GREEN}${text}${RESET}`;
+}
+export function yellow(text) {
+    return `${YELLOW}${text}${RESET}`;
+}
+export function red(text) {
+    return `${RED}${text}${RESET}`;
+}
+export function cyan(text) {
+    return `${CYAN}${text}${RESET}`;
+}
+export function magenta(text) {
+    return `${MAGENTA}${text}${RESET}`;
+}
+export function blue(text) {
+    return `${BLUE}${text}${RESET}`;
+}
+export function dim(text) {
+    return `${DIM}${text}${RESET}`;
+}
+export function bold(text) {
+    return `${BOLD}${text}${RESET}`;
+}
+export function white(text) {
+    return `${WHITE}${text}${RESET}`;
+}
+export function brightCyan(text) {
+    return `${BRIGHT_CYAN}${text}${RESET}`;
+}
+export function brightMagenta(text) {
+    return `${BRIGHT_MAGENTA}${text}${RESET}`;
+}
+export function brightBlue(text) {
+    return `${BRIGHT_BLUE}${text}${RESET}`;
+}
+// ============================================================================
+// Threshold-based Colors
+// ============================================================================
+/**
+ * Get color code based on context window percentage.
+ */
+export function getContextColor(percent) {
+    if (percent >= 85)
+        return RED;
+    if (percent >= 70)
+        return YELLOW;
+    return GREEN;
+}
+/**
+ * Get color code based on ralph iteration.
+ */
+export function getRalphColor(iteration, maxIterations) {
+    const warningThreshold = Math.floor(maxIterations * 0.7);
+    const criticalThreshold = Math.floor(maxIterations * 0.9);
+    if (iteration >= criticalThreshold)
+        return RED;
+    if (iteration >= warningThreshold)
+        return YELLOW;
+    return GREEN;
+}
+/**
+ * Get color for todo progress.
+ */
+export function getTodoColor(completed, total) {
+    if (total === 0)
+        return DIM;
+    const percent = (completed / total) * 100;
+    if (percent >= 80)
+        return GREEN;
+    if (percent >= 50)
+        return YELLOW;
+    return CYAN;
+}
+// ============================================================================
+// Model Tier Colors (for agent visualization)
+// ============================================================================
+/**
+ * Get color for model tier.
+ * - Opus: Magenta (high-powered)
+ * - Sonnet: Yellow (standard)
+ * - Haiku: Green (lightweight)
+ */
+export function getModelTierColor(model) {
+    if (!model)
+        return CYAN; // Default/unknown
+    const tier = model.toLowerCase();
+    if (tier.includes('opus'))
+        return MAGENTA;
+    if (tier.includes('sonnet'))
+        return YELLOW;
+    if (tier.includes('haiku'))
+        return GREEN;
+    return CYAN; // Unknown model
+}
+/**
+ * Get color for agent duration (warning/alert).
+ * - <2min: normal (green)
+ * - 2-5min: warning (yellow)
+ * - >5min: alert (red)
+ */
+export function getDurationColor(durationMs) {
+    const minutes = durationMs / 60000;
+    if (minutes >= 5)
+        return RED;
+    if (minutes >= 2)
+        return YELLOW;
+    return GREEN;
+}
+// ============================================================================
+// Progress Bars
+// ============================================================================
+/**
+ * Create a colored progress bar.
+ */
+export function coloredBar(percent, width = 10) {
+    const safeWidth = Number.isFinite(width) ? Math.max(0, Math.round(width)) : 0;
+    const safePercent = Number.isFinite(percent)
+        ? Math.min(100, Math.max(0, percent))
+        : 0;
+    const filled = Math.round((safePercent / 100) * safeWidth);
+    const empty = safeWidth - filled;
+    const color = getContextColor(safePercent);
+    return `${color}${'█'.repeat(filled)}${DIM}${'░'.repeat(empty)}${RESET}`;
+}
+/**
+ * Create a simple numeric display with color.
+ */
+export function coloredValue(value, total, getColor) {
+    const color = getColor(value, total);
+    return `${color}${value}/${total}${RESET}`;
+}
+//# sourceMappingURL=colors.js.map

package/dist/hud/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/hud/colors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAoB;AACpB,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC;AAC/B,MAAM,GAAG,GAAG,SAAS,CAAC;AACtB,MAAM,IAAI,GAAG,SAAS,CAAC;AACvB,MAAM,GAAG,GAAG,UAAU,CAAC;AACvB,MAAM,KAAK,GAAG,UAAU,CAAC;AACzB,MAAM,MAAM,GAAG,UAAU,CAAC;AAC1B,MAAM,IAAI,GAAG,UAAU,CAAC;AACxB,MAAM,OAAO,GAAG,UAAU,CAAC;AAC3B,MAAM,IAAI,GAAG,UAAU,CAAC;AACxB,MAAM,KAAK,GAAG,UAAU,CAAC;AACzB,MAAM,WAAW,GAAG,UAAU,CAAC;AAC/B,MAAM,cAAc,GAAG,UAAU,CAAC;AAClC,MAAM,WAAW,GAAG,UAAU,CAAC;AAE/B,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAY;IAC9B,OAAO,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAY;IAC9B,OAAO,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,GAAG,WAAW,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,GAAG,cAAc,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,GAAG,WAAW,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;AACzC,CAAC;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC9B,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,aAAqB;IACpE,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;IACzD,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;IAE1D,IAAI,SAAS,IAAI,iBAAiB;QAAE,OAAO,GAAG,CAAC;IAC/C,IAAI,SAAS,IAAI,gBAAgB;QAAE,OAAO,MAAM,CAAC;IACjD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,KAAa;IAC3D,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5B,MAAM,OAAO,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IAC1C,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,8CAA8C;AAC9C,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,CAAC,kBAAkB;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,IAAI,CAAC,CAAC,gBAAgB;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC;IACnC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAC7B,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAChC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,QAAgB,EAAE;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC1C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC,CAAC;IAEN,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IAEjC,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,KAAa,EACb,QAAkD;IAElD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,GAAG,KAAK,GAAG,KAAK,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;AAC7C,CAAC"}

package/dist/hud/custom-rate-provider.d.ts

@@ -0,0 +1,33 @@
+/**
+ * OMC HUD - Custom Rate Limit Provider
+ *
+ * Executes a user-supplied command (omcHud.rateLimitsProvider) to fetch
+ * rate limit / quota data and maps the output to CustomProviderResult.
+ *
+ * Output contract (stdout JSON):
+ *   { version: 1, generatedAt: string, buckets: CustomBucket[] }
+ *
+ * Each bucket:
+ *   { id, label, usage: {type, ...}, resetsAt? }
+ *
+ * Usage types:
+ *   percent  – { type: 'percent', value: number }   → renders as "32%"
+ *   credit   – { type: 'credit', used, limit }       → renders as "250/300"
+ *   string   – { type: 'string', value: string }     → renders as-is
+ *
+ * Caching: last-good result is persisted for 30 s. On failure the stale
+ * cache is returned (stale: true); if no cache exists, error is set.
+ */
+import type { RateLimitsProviderConfig, CustomProviderResult } from './types.js';
+/**
+ * Execute the custom rate limit provider and return buckets.
+ *
+ * Behaviour:
+ * - Returns fresh cached data if within 30-second TTL.
+ * - On cache miss, spawns the command with the configured timeout.
+ * - On success, writes cache and returns {buckets, stale: false}.
+ * - On failure, returns last-good cache as {buckets, stale: true}.
+ * - If no cache exists, returns {buckets: [], error: 'command failed'}.
+ */
+export declare function executeCustomProvider(config: RateLimitsProviderConfig): Promise<CustomProviderResult>;
+//# sourceMappingURL=custom-rate-provider.d.ts.map

package/dist/hud/custom-rate-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-rate-provider.d.ts","sourceRoot":"","sources":["../../src/hud/custom-rate-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EACV,wBAAwB,EAGxB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AA6IpB;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAkC/B"}