@moneysiren/cli 0.1.0-alpha.0 → 0.1.0-alpha.10

package/dist/packages/view-model/src/hud-model.d.ts

@@ -0,0 +1,74 @@
+import { type AggregateSyncStatus, type ItemSyncView, type RiskSeverity } from "./sync-state.js";
+import { type UsageProgressView } from "./usage-progress.js";
+import type { TodayLiveProviderView, TodayLiveView } from "./view-model.js";
+import type { NotificationWidgetKey } from "./notification-preferences-model.js";
+export type CreditAccuracy = "exact" | "estimated" | "bounded" | "unknown";
+export interface CreditItemView {
+    itemKey: string;
+    expiresAt: string | null;
+    estimatedEarliestAt: string | null;
+    estimatedLatestAt: string | null;
+    accuracy: CreditAccuracy;
+    status: "active" | "expiring_soon" | "expired" | "unknown";
+}
+export interface CreditPoolView {
+    kind: "credit_pool";
+    id: string;
+    providerKey: "codex-app" | "codex-cli";
+    variant: "count" | "expiry";
+    availableCount: number | null;
+    totalEarnedCount: number | null;
+    credits: readonly CreditItemView[];
+    unresolvedCount: number;
+    nearestExpiryAt: string | null;
+    accuracy: CreditAccuracy;
+    sync: ItemSyncView;
+    riskSeverity: RiskSeverity;
+    target: {
+        type: "service";
+        providerKey: "codex-app" | "codex-cli";
+    };
+}
+export interface QuotaItemView {
+    kind: "quota";
+    id: string;
+    providerKey: string;
+    window: "five_hour" | "weekly" | "context" | "budget";
+    progress: UsageProgressView;
+    resetAt: string | null;
+    sync: ItemSyncView;
+    riskSeverity: RiskSeverity;
+    target: {
+        type: "service" | "dashboard";
+        providerKey?: string;
+        routeKey?: string;
+    };
+}
+export type HudItemView = QuotaItemView | CreditPoolView;
+export interface HudViewModel {
+    generatedAt: string;
+    localOnly: true;
+    secretsReturned: false;
+    dataRevision: string;
+    sync: {
+        status: AggregateSyncStatus;
+        freshCount: number;
+        staleCount: number;
+        errorCount: number;
+        neutralCount: number;
+        lastSuccessAt: string | null;
+    };
+    risk: {
+        severity: RiskSeverity;
+        warningCount: number;
+        criticalCount: number;
+    };
+    items: readonly HudItemView[];
+}
+export declare const CODEX_APP_PROVIDER_KEY = "codex-app";
+export declare const CODEX_CLI_PROVIDER_KEY = "codex-cli";
+export declare function buildHudViewModel(todayLive: TodayLiveView): HudViewModel;
+export declare function filterHudViewModelByWidgets(model: HudViewModel, selectedWidgets: readonly NotificationWidgetKey[]): HudViewModel;
+export declare function buildCreditPoolFromProvider(provider: TodayLiveProviderView, generatedAt: string): CreditPoolView | null;
+export declare function buildCreditPoolsFromProvider(provider: TodayLiveProviderView, generatedAt: string): CreditPoolView[];
+//# sourceMappingURL=hud-model.d.ts.map

package/dist/packages/view-model/src/hud-model.js

@@ -0,0 +1,295 @@
+import { summarizeAggregateSync, syncViewFromFreshness, } from "./sync-state.js";
+import { usageProgressFromTokens, usageProgressFromUsedPercent, usageProgressSeverity, } from "./usage-progress.js";
+export const CODEX_APP_PROVIDER_KEY = "codex-app";
+export const CODEX_CLI_PROVIDER_KEY = "codex-cli";
+const CODEX_PROVIDER_KEYS = [CODEX_APP_PROVIDER_KEY, CODEX_CLI_PROVIDER_KEY];
+const CREDIT_WARNING_MS = 7 * 24 * 60 * 60 * 1000;
+const CREDIT_CRITICAL_MS = 24 * 60 * 60 * 1000;
+export function buildHudViewModel(todayLive) {
+    const items = todayLive.providers.flatMap((provider) => hudItemsForProvider(provider, todayLive.generatedAt));
+    const sync = summarizeAggregateSync(items.map((item) => item.sync));
+    const warningCount = items.filter((item) => item.riskSeverity === "warning").length;
+    const criticalCount = items.filter((item) => item.riskSeverity === "critical").length;
+    return {
+        generatedAt: todayLive.generatedAt,
+        localOnly: true,
+        secretsReturned: false,
+        dataRevision: dataRevisionFor(todayLive),
+        sync,
+        risk: {
+            severity: criticalCount > 0 ? "critical" : warningCount > 0 ? "warning" : "info",
+            warningCount,
+            criticalCount,
+        },
+        items,
+    };
+}
+export function filterHudViewModelByWidgets(model, selectedWidgets) {
+    const itemsByWidget = new Map();
+    for (const item of model.items) {
+        for (const widgetKey of hudWidgetKeysForItem(item)) {
+            itemsByWidget.set(widgetKey, [...(itemsByWidget.get(widgetKey) ?? []), item]);
+        }
+    }
+    const items = selectedWidgets.flatMap((widgetKey) => itemsByWidget.get(widgetKey) ?? []);
+    const sync = summarizeAggregateSync(items.map((item) => item.sync));
+    const warningCount = items.filter((item) => item.riskSeverity === "warning").length;
+    const criticalCount = items.filter((item) => item.riskSeverity === "critical").length;
+    return {
+        ...model,
+        dataRevision: `${model.dataRevision}#widgets:${selectedWidgets.join(",")}`,
+        sync,
+        risk: {
+            severity: criticalCount > 0 ? "critical" : warningCount > 0 ? "warning" : "info",
+            warningCount,
+            criticalCount,
+        },
+        items,
+    };
+}
+export function buildCreditPoolFromProvider(provider, generatedAt) {
+    return buildCreditPoolsFromProvider(provider, generatedAt)[0] ?? null;
+}
+export function buildCreditPoolsFromProvider(provider, generatedAt) {
+    if (!isCodexProviderKey(provider.providerKey)) {
+        return [];
+    }
+    const metrics = provider.metrics;
+    const explicitCount = firstMetric(metrics, "usage_reset_credits")?.value ?? null;
+    const exactMetrics = metrics.filter((metric) => metric.key === "usage_reset_credit");
+    const estimatedMetrics = metrics.filter((metric) => metric.key === "usage_reset_credit_estimate");
+    const selectedMetrics = exactMetrics.length > 0 ? exactMetrics : estimatedMetrics;
+    const credits = selectedMetrics
+        .map((metric, index) => creditItemFromMetric(metric, index, generatedAt))
+        .sort(compareCreditItems);
+    const activeCreditCount = credits.filter((credit) => credit.status !== "expired").length;
+    const availableCount = normalizeCount(explicitCount) ?? activeCreditCount;
+    const unresolvedCount = Math.max(0, availableCount - credits.length);
+    if (availableCount === 0 && credits.length === 0) {
+        return [];
+    }
+    const nearestExpiryAt = credits
+        .map((credit) => credit.expiresAt ?? credit.estimatedEarliestAt)
+        .filter((value) => value !== null)
+        .sort((left, right) => Date.parse(left) - Date.parse(right))[0] ?? null;
+    const accuracy = summarizeCreditAccuracy(credits, selectedMetrics.length > 0 ? selectedMetrics : metrics);
+    const sync = syncViewForProvider(provider, generatedAt);
+    const invalidKnownCount = explicitCount !== null && activeCreditCount > explicitCount;
+    const basePool = {
+        kind: "credit_pool",
+        providerKey: provider.providerKey,
+        availableCount,
+        totalEarnedCount: firstMetric(metrics, "usage_reset_credit_total_earned")?.value ?? null,
+        credits,
+        unresolvedCount,
+        nearestExpiryAt,
+        accuracy,
+        sync: invalidKnownCount
+            ? {
+                ...sync,
+                state: "error",
+                error: {
+                    code: "invalid_data",
+                    retryable: false,
+                    userActionRequired: false,
+                    message: "Reset credit count is lower than the known active credit list.",
+                },
+                lastRefreshFailed: true,
+            }
+            : sync,
+        riskSeverity: riskFromNearestExpiry(nearestExpiryAt, generatedAt),
+        target: {
+            type: "service",
+            providerKey: provider.providerKey,
+        },
+    };
+    return [
+        {
+            ...basePool,
+            id: `${provider.providerKey}:credit-pool:count`,
+            variant: "count",
+        },
+        {
+            ...basePool,
+            id: `${provider.providerKey}:credit-pool:expiry`,
+            variant: "expiry",
+        },
+    ];
+}
+function hudItemsForProvider(provider, generatedAt) {
+    const quotaItems = [
+        quotaItemForProvider(provider, generatedAt, "five_hour", "five_hour_limit_percent", "five_hour_tokens", "five_hour_remaining_tokens"),
+        quotaItemForProvider(provider, generatedAt, "weekly", "weekly_limit_percent", "weekly_tokens", "weekly_remaining_tokens"),
+        quotaItemForProvider(provider, generatedAt, "context", "context_percent", "context_tokens", null),
+    ].filter((item) => item !== null);
+    const creditPools = buildCreditPoolsFromProvider(provider, generatedAt);
+    return [...quotaItems, ...creditPools];
+}
+function quotaItemForProvider(provider, generatedAt, window, percentMetricKey, usedTokensMetricKey, remainingTokensMetricKey) {
+    const usedPercentMetric = firstMetric(provider.metrics, percentMetricKey);
+    const usedTokensMetric = firstMetric(provider.metrics, usedTokensMetricKey);
+    const remainingTokensMetric = remainingTokensMetricKey === null ? undefined : firstMetric(provider.metrics, remainingTokensMetricKey);
+    const progress = usedPercentMetric === undefined
+        ? remainingTokensMetric === undefined
+            ? null
+            : usageProgressFromTokens(usedTokensMetric?.value ?? null, remainingTokensMetric.value)
+        : usageProgressFromUsedPercent(usedPercentMetric.value);
+    if (progress === null || progress.usedPercent === null) {
+        return null;
+    }
+    const resetAt = remainingTokensMetric?.resetAt ?? usedPercentMetric?.resetAt ?? null;
+    const riskSeverity = usageProgressSeverity(progress);
+    return {
+        kind: "quota",
+        id: `${provider.providerKey}:${window}`,
+        providerKey: provider.providerKey,
+        window,
+        progress,
+        resetAt,
+        sync: syncViewForProvider(provider, generatedAt),
+        riskSeverity,
+        target: {
+            type: "service",
+            providerKey: provider.providerKey,
+        },
+    };
+}
+function hudWidgetKeysForItem(item) {
+    if (item.kind === "credit_pool") {
+        return item.variant === "count"
+            ? ["codex_reset_credit_count"]
+            : ["codex_reset_credit_expiry"];
+    }
+    if (item.window === "five_hour") {
+        if (item.providerKey.startsWith("codex-")) {
+            return ["codex_five_hour_percent"];
+        }
+        if (item.providerKey.startsWith("claude-")) {
+            return ["claude_five_hour_percent"];
+        }
+    }
+    if (item.window === "weekly") {
+        if (item.providerKey.startsWith("codex-")) {
+            return ["codex_weekly_percent"];
+        }
+        if (item.providerKey.startsWith("claude-")) {
+            return ["claude_weekly_percent"];
+        }
+    }
+    return [];
+}
+function creditItemFromMetric(metric, index, generatedAt) {
+    const accuracy = normalizeCreditAccuracy(metric.accuracy, metric.key);
+    const expiresAt = metric.key === "usage_reset_credit" ? metric.resetAt ?? null : null;
+    const estimatedEarliestAt = metric.key === "usage_reset_credit_estimate" ? metric.resetAt ?? null : null;
+    const estimatedLatestAt = metric.resetAtLatest ?? null;
+    const riskTime = expiresAt ?? estimatedEarliestAt;
+    return {
+        itemKey: metric.itemKey ?? `${metric.key}:${index + 1}`,
+        expiresAt,
+        estimatedEarliestAt,
+        estimatedLatestAt,
+        accuracy,
+        status: creditStatus(riskTime, generatedAt),
+    };
+}
+function syncViewForProvider(provider, generatedAt) {
+    return syncViewFromFreshness({
+        freshness: provider.freshness,
+        checkedAt: provider.checkedAt,
+        generatedAt,
+        source: provider.providerKey,
+        ...(provider.ttlSeconds === undefined ? {} : { ttlSeconds: provider.ttlSeconds }),
+        ...(provider.message === undefined ? {} : { message: provider.message }),
+        ...(provider.lastAttemptAt === undefined ? {} : { lastAttemptAt: provider.lastAttemptAt }),
+        ...(provider.lastSuccessAt === undefined ? {} : { lastSuccessAt: provider.lastSuccessAt }),
+        ...(provider.freshUntil === undefined ? {} : { freshUntil: provider.freshUntil }),
+        ...(provider.staleUntil === undefined ? {} : { staleUntil: provider.staleUntil }),
+        ...(provider.lastRefreshFailed === undefined ? {} : { lastRefreshFailed: provider.lastRefreshFailed }),
+    });
+}
+function riskFromNearestExpiry(value, generatedAt) {
+    if (value === null) {
+        return "info";
+    }
+    const remainingMs = Date.parse(value) - Date.parse(generatedAt);
+    if (!Number.isFinite(remainingMs) || remainingMs <= CREDIT_CRITICAL_MS) {
+        return "critical";
+    }
+    return remainingMs <= CREDIT_WARNING_MS ? "warning" : "info";
+}
+function creditStatus(expiresAt, generatedAt) {
+    if (expiresAt === null) {
+        return "unknown";
+    }
+    const remainingMs = Date.parse(expiresAt) - Date.parse(generatedAt);
+    if (!Number.isFinite(remainingMs)) {
+        return "unknown";
+    }
+    if (remainingMs <= 0) {
+        return "expired";
+    }
+    return remainingMs <= CREDIT_WARNING_MS ? "expiring_soon" : "active";
+}
+function firstMetric(metrics, key) {
+    return metrics.find((metric) => metric.key === key);
+}
+function normalizeCount(value) {
+    return value === null || !Number.isFinite(value) || value < 0 ? null : Math.floor(value);
+}
+function summarizeCreditAccuracy(credits, metrics) {
+    if (credits.length === 0 && metrics.length === 0) {
+        return "unknown";
+    }
+    if (credits.length > 0 && credits.every((credit) => credit.accuracy === "exact")) {
+        return "exact";
+    }
+    if (credits.some((credit) => credit.accuracy === "bounded")) {
+        return "bounded";
+    }
+    if (credits.some((credit) => credit.accuracy === "estimated")) {
+        return "estimated";
+    }
+    return "unknown";
+}
+function normalizeCreditAccuracy(value, key) {
+    if (value === "exact" || value === "estimated" || value === "bounded" || value === "unknown") {
+        return value;
+    }
+    return key === "usage_reset_credit"
+        ? "exact"
+        : key === "usage_reset_credit_estimate"
+            ? "bounded"
+            : "unknown";
+}
+function compareCreditItems(left, right) {
+    return compareNullableIso(left.expiresAt ?? left.estimatedEarliestAt, right.expiresAt ?? right.estimatedEarliestAt) ||
+        left.itemKey.localeCompare(right.itemKey);
+}
+function compareNullableIso(left, right) {
+    if (left === null && right === null) {
+        return 0;
+    }
+    if (left === null) {
+        return 1;
+    }
+    if (right === null) {
+        return -1;
+    }
+    return Date.parse(left) - Date.parse(right);
+}
+function dataRevisionFor(todayLive) {
+    return [
+        todayLive.generatedAt,
+        todayLive.providers.map((provider) => [
+            provider.providerKey,
+            provider.checkedAt ?? "",
+            provider.lastSuccessAt ?? "",
+            provider.revision ?? "",
+        ].join(":")).join("|"),
+    ].join("#");
+}
+function isCodexProviderKey(value) {
+    return CODEX_PROVIDER_KEYS.includes(value);
+}
+//# sourceMappingURL=hud-model.js.map

package/dist/packages/view-model/src/index.d.ts

@@ -1,3 +1,6 @@
-export { buildNotificationDigest, buildOperationsOverview, buildTodayLiveView, buildTrayMenuModel, readNotificationDigest, readOperationsOverview, readTodayLiveView, readTrayMenuModel, type LocalSafeEnvelope, type NotificationDigest, type NotificationDigestItem, type OperationsOverview, type OperationsOverviewAlert, type OperationsOverviewProvider, type ReadNotificationDigestOptions, type ReadOperationsOverviewOptions, type ReadTodayLiveViewOptions, type ReadTrayMenuModelOptions, type TodayLiveProviderInput, type TodayLiveProviderView, type TodayLiveView, type TrayMenuItem, type TrayMenuModel, type ViewModelAlertRecord, type ViewModelBillingSnapshotRecord, type ViewModelCostEstimateRecord, type ViewModelHealthStatus, type ViewModelProviderRecord, type ViewModelReadStore, type ViewModelRiskSeverity, type ViewModelServiceHealthSnapshotRecord, type ViewModelStore, type ViewModelUsageSnapshotRecord, } from "./view-model.js";
-export { cloneNotificationPreferences, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, readNotificationPreferencesFile, resolveNotificationPreferencesPath, writeNotificationPreferencesFile, type DashboardDisplayPreferences, type DigestInterval, type LocalCliDashboardMetricKey, type NotificationPreferenceFileOptions, type NotificationPreferences, type NotificationThresholdRule, type NotificationWidgetKey, type ThresholdOperator, } from "./notification-preferences.js";
+export { buildNotificationDigest, buildOperationsOverview, buildTodayLiveView, buildTrayMenuModel, readNotificationDigest, readOperationsOverview, readTodayLiveView, readTrayMenuModel, type LocalSafeEnvelope, type NotificationDigest, type NotificationDigestItem, type OperationsOverview, type OperationsOverviewAlert, type OperationsOverviewProvider, type ReadNotificationDigestOptions, type ReadOperationsOverviewOptions, type ReadTodayLiveViewOptions, type ReadTrayMenuModelOptions, type TodayLiveProviderInput, type TodayLiveProviderView, type TodayLiveMetric, type TodayLiveView, type TrayMenuItem, type TrayMenuModel, type ViewModelAlertRecord, type ViewModelBillingSnapshotRecord, type ViewModelCostEstimateRecord, type ViewModelHealthStatus, type ViewModelProviderRecord, type ViewModelReadStore, type ViewModelRiskSeverity, type ViewModelServiceHealthSnapshotRecord, type ViewModelStore, type ViewModelUsageSnapshotRecord, } from "./view-model.js";
+export { CODEX_APP_PROVIDER_KEY, CODEX_CLI_PROVIDER_KEY, buildCreditPoolFromProvider, buildCreditPoolsFromProvider, buildHudViewModel, filterHudViewModelByWidgets, type CreditAccuracy, type CreditItemView, type CreditPoolView, type HudItemView, type HudViewModel, type QuotaItemView, } from "./hud-model.js";
+export { createSyncError, isNeutralSyncState, summarizeAggregateSync, syncStateFromFreshness, syncViewFromFreshness, type AggregateSyncStatus, type ItemSyncView, type RiskSeverity, type SyncErrorCode, type SyncErrorView, type SyncStateValue, } from "./sync-state.js";
+export { normalizePercent, usageProgressFromRemainingPercent, usageProgressFromTokens, usageProgressFromUsedPercent, usageProgressSeverity, type UsageProgressSeverity, type UsageProgressView, } from "./usage-progress.js";
+export { cloneNotificationPreferences, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_DASHBOARD_WIDGET_LAYOUTS, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, DASHBOARD_VIEW_KEYS, DASHBOARD_WIDGET_KEYS_BY_VIEW, DASHBOARD_WIDGET_SIZES, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, readNotificationPreferencesFile, resolveNotificationPreferencesPath, writeNotificationPreferencesFile, type DashboardBudgetPreferences, type DashboardDisplayPreferences, type DashboardViewKey, type DashboardWidgetKey, type DashboardWidgetLayoutItem, type DashboardWidgetLayoutPreferences, type DashboardWidgetSize, type DigestInterval, type LocalCliDashboardMetricKey, type NotificationPreferenceFileOptions, type NotificationPreferences, type NotificationThresholdRule, type NotificationWidgetKey, type ThresholdOperator, } from "./notification-preferences.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/view-model/src/index.js

@@ -1,3 +1,6 @@
 export { buildNotificationDigest, buildOperationsOverview, buildTodayLiveView, buildTrayMenuModel, readNotificationDigest, readOperationsOverview, readTodayLiveView, readTrayMenuModel, } from "./view-model.js";
-export { cloneNotificationPreferences, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, readNotificationPreferencesFile, resolveNotificationPreferencesPath, writeNotificationPreferencesFile, } from "./notification-preferences.js";
+export { CODEX_APP_PROVIDER_KEY, CODEX_CLI_PROVIDER_KEY, buildCreditPoolFromProvider, buildCreditPoolsFromProvider, buildHudViewModel, filterHudViewModelByWidgets, } from "./hud-model.js";
+export { createSyncError, isNeutralSyncState, summarizeAggregateSync, syncStateFromFreshness, syncViewFromFreshness, } from "./sync-state.js";
+export { normalizePercent, usageProgressFromRemainingPercent, usageProgressFromTokens, usageProgressFromUsedPercent, usageProgressSeverity, } from "./usage-progress.js";
+export { cloneNotificationPreferences, DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS, DEFAULT_DASHBOARD_WIDGET_LAYOUTS, DEFAULT_NOTIFICATION_PREFERENCES, DEFAULT_NOTIFICATION_THRESHOLD_RULES, DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS, DASHBOARD_VIEW_KEYS, DASHBOARD_WIDGET_KEYS_BY_VIEW, DASHBOARD_WIDGET_SIZES, LOCAL_CLI_DASHBOARD_METRIC_KEYS, NOTIFICATION_WIDGET_KEYS, parseNotificationPreferences, readNotificationPreferencesFile, resolveNotificationPreferencesPath, writeNotificationPreferencesFile, } from "./notification-preferences.js";
 //# sourceMappingURL=index.js.map

package/dist/packages/view-model/src/notification-preferences-model.d.ts

@@ -1,7 +1,18 @@
-export declare const NOTIFICATION_WIDGET_KEYS: readonly ["month_forecast", "today_live_cost", "risk_high_count", "stale_connection_count", "aws_month_forecast", "openai_today_cost", "openai_today_tokens", "claude_five_hour_percent", "claude_weekly_percent", "codex_five_hour_percent", "codex_weekly_percent", "supabase_usage_health", "cloudflare_month_to_date"];
-export declare const LOCAL_CLI_DASHBOARD_METRIC_KEYS: readonly ["context_percent", "last_request_tokens", "total_tokens", "five_hour_limit_percent", "weekly_limit_percent", "five_hour_remaining_tokens", "weekly_remaining_tokens", "context_tokens", "input_tokens", "output_tokens", "cache_tokens", "reasoning_tokens", "sessions", "turns", "tool_calls", "log_files"];
+export declare const NOTIFICATION_WIDGET_KEYS: readonly ["month_forecast", "today_live_cost", "risk_high_count", "stale_connection_count", "aws_month_forecast", "openai_today_cost", "openai_today_tokens", "claude_five_hour_percent", "claude_weekly_percent", "codex_five_hour_percent", "codex_weekly_percent", "codex_reset_credit_count", "codex_reset_credit_expiry", "supabase_usage_health", "cloudflare_month_to_date"];
+export declare const LOCAL_CLI_DASHBOARD_METRIC_KEYS: readonly ["context_percent", "last_request_tokens", "total_tokens", "five_hour_limit_percent", "weekly_limit_percent", "five_hour_remaining_tokens", "weekly_remaining_tokens", "usage_reset_credits", "usage_reset_credit_estimate", "context_tokens", "input_tokens", "output_tokens", "cache_tokens", "reasoning_tokens", "sessions", "turns", "tool_calls", "log_files"];
+export declare const DASHBOARD_VIEW_KEYS: readonly ["overview", "today", "forecast", "risks"];
+export declare const DASHBOARD_WIDGET_SIZES: readonly ["compact", "normal", "wide", "full"];
+export declare const DASHBOARD_WIDGET_KEYS_BY_VIEW: {
+    readonly overview: readonly ["overview_meta", "overview_metrics", "overview_trend", "overview_grouping", "overview_services", "overview_insights"];
+    readonly today: readonly ["today_main", "today_rail"];
+    readonly forecast: readonly ["forecast_metrics", "forecast_table", "forecast_breakdown"];
+    readonly risks: readonly ["risks_summary", "risks_table"];
+};
 export type NotificationWidgetKey = (typeof NOTIFICATION_WIDGET_KEYS)[number];
 export type LocalCliDashboardMetricKey = (typeof LOCAL_CLI_DASHBOARD_METRIC_KEYS)[number];
+export type DashboardViewKey = (typeof DASHBOARD_VIEW_KEYS)[number];
+export type DashboardWidgetSize = (typeof DASHBOARD_WIDGET_SIZES)[number];
+export type DashboardWidgetKey = (typeof DASHBOARD_WIDGET_KEYS_BY_VIEW)[DashboardViewKey][number];
 export type ThresholdOperator = "gte" | "lte" | "eq";
 export type DigestInterval = "six-hours" | "daily" | "weekly";
 export interface NotificationThresholdRule {
@@ -24,8 +35,24 @@ export interface NotificationPreferences {
     dashboard: DashboardDisplayPreferences;
     hud: HudPreferences;
 }
+export interface DashboardBudgetPreferences {
+    monthlyBudgetMinor: number | null;
+    currency: string;
+    warningPercent: number;
+    criticalPercent: number;
+}
 export interface DashboardDisplayPreferences {
     localCliMetricKeys: readonly LocalCliDashboardMetricKey[];
+    budget: DashboardBudgetPreferences;
+    widgetLayouts: DashboardWidgetLayoutPreferences;
+}
+export type DashboardWidgetLayoutPreferences = {
+    readonly [ViewKey in DashboardViewKey]: readonly DashboardWidgetLayoutItem[];
+};
+export interface DashboardWidgetLayoutItem {
+    widgetKey: DashboardWidgetKey;
+    visible: boolean;
+    size: DashboardWidgetSize;
 }
 export interface HudPreferences {
     alwaysOnTop: boolean;
@@ -40,6 +67,7 @@ export interface NotificationPreferenceFileOptions {
 }
 export declare const DEFAULT_SELECTED_NOTIFICATION_WIDGET_KEYS: readonly NotificationWidgetKey[];
 export declare const DEFAULT_LOCAL_CLI_DASHBOARD_METRIC_KEYS: readonly LocalCliDashboardMetricKey[];
+export declare const DEFAULT_DASHBOARD_WIDGET_LAYOUTS: DashboardWidgetLayoutPreferences;
 export declare const DEFAULT_NOTIFICATION_THRESHOLD_RULES: readonly NotificationThresholdRule[];
 export declare const DEFAULT_NOTIFICATION_PREFERENCES: NotificationPreferences;
 export declare function parseNotificationPreferences(value: unknown): NotificationPreferences;