@kenz1117/dsh-ui-usage-billing 1.7.4 → 1.8.0-alpha.2

package/lib/types/client/TaskQueuePanel.d.ts

@@ -0,0 +1,19 @@
+/** Off-peak task queue panel: explicit enqueue, visible outcomes, safe old-host fallback. */
+import type { BillingLanguage } from './usage-billing-settings.ts';
+import type { UsageBillingKey } from './locales.ts';
+import type { TaskQueueInput } from '../task-queue-shared.ts';
+interface TaskQueuePanelProps {
+    readonly t: (key: UsageBillingKey, params?: Record<string, unknown>) => string;
+    readonly language: BillingLanguage;
+    readonly navigateToSession: (sessionId: string) => 'opened' | 'unavailable' | 'failed';
+}
+interface ImportDefaults {
+    readonly cwd: string;
+    readonly provider: string;
+    readonly model: string;
+}
+/** Normalize only the transport shape; authoritative validation stays atomic on the server. */
+export declare function parseTaskQueueImport(text: string, defaults: ImportDefaults): TaskQueueInput[];
+export declare function TaskQueuePanel({ t, language, navigateToSession }: TaskQueuePanelProps): React.ReactNode;
+export {};
+//# sourceMappingURL=TaskQueuePanel.d.ts.map

package/lib/types/client/api/task-queue.d.ts

@@ -0,0 +1,21 @@
+/** API client for the new-host off-peak task queue preview (issue #106). */
+import type { TaskQueueInput, TaskQueueSnapshot, TaskQueueSummary } from '../../task-queue-shared.ts';
+export declare function loadTaskQueue(): Promise<TaskQueueSnapshot>;
+export declare function loadTaskQueueSummary(): Promise<TaskQueueSummary>;
+export type TaskQueueAction = {
+    action: 'enqueue';
+    prompt: string;
+    cwd: string;
+    provider: string;
+    model: string;
+} | {
+    action: 'enqueueMany';
+    tasks: readonly TaskQueueInput[];
+} | {
+    action: 'remove';
+    id: string;
+} | {
+    action: 'clearFinished';
+};
+export declare function mutateTaskQueue(action: TaskQueueAction): Promise<TaskQueueSnapshot>;
+//# sourceMappingURL=task-queue.d.ts.map

package/lib/types/client/domain/types.d.ts

@@ -27,12 +27,12 @@ export interface ModelHealth {
 /** Idle health state before the probe settles. */
 export declare const IDLE_HEALTH: ModelHealth;
 /** 仪表盘分区 Tab id。 */
-export type DashboardTab = 'overview' | 'context' | 'agents' | 'token' | 'trends' | 'providers' | 'pricing' | 'settings';
+export type DashboardTab = 'overview' | 'queue' | 'agents' | 'token' | 'trends' | 'providers' | 'pricing' | 'settings';
 import type { UsageBillingKey } from '../locales.ts';
 /**
- * Tab 定义（顺序即渲染顺序）：概览=主数字/KPI/热力图，账单=厂商计费与订阅，
- * 用量=Token 用量，趋势=趋势图/每轮费用，费率=模型单价表，设置=预算与峰谷提醒。
- * 导出供测试断言 tab 与文案 key 对齐、decor 锚点落在正确分区。
+ * Tab 定义（顺序即渲染顺序）：概览=主数字/KPI/热力图，队列=低谷任务（新宿主预览），
+ * 账单=厂商计费与订阅，用量=Token 用量，趋势=趋势图/每轮费用，费率=模型单价表，
+ * 设置=预算与峰谷提醒。导出供测试断言 tab 与文案 key 对齐。
  */
 export declare const DASHBOARD_TABS: readonly {
     id: DashboardTab;

package/lib/types/client/live-cost.d.ts

@@ -21,7 +21,6 @@
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { LiveCostBarPrefs } from './usage-billing-settings.ts';
 import type { UsageBillingKey } from './locales.ts';
-import type { UseProjection } from '@deepseek-ai/dsh-api-session-controller/client';
 /** The usage-stats shape the composer bar needs (a thin slice, not the whole doc). */
 export interface LiveStats {
     bySession?: readonly {
@@ -117,12 +116,6 @@ export declare function isBlankPhase(session: SessionPhaseSlice): boolean;
 export interface LiveCostBarProps {
     /** Current Session identity supplied by the session-scope standard kit. */
     sessionId: SessionId;
-    /**
-     * Host projection reader (session-scope standard kit). Present only on hosts
-     * that serve session projections; absent → no context dimension (the
-     * dashboard hides that card entirely rather than showing zeros).
-     */
-    useProjection?: UseProjection;
     /** The owning seat's locale seat (bound to the billing NS). */
     t: (key: UsageBillingKey) => string;
     /** Which host seat this instance occupies; it renders only when the position pref matches. */
@@ -135,7 +128,7 @@ export interface LiveCostBarProps {
  * @param props - framework session identity, locale, the seat occupied, and
  * (input.dock only) the owner session snapshot.
  */
-export declare function LiveCostBar({ sessionId, t, seat, session, useProjection }: LiveCostBarProps): React.ReactNode;
+export declare function LiveCostBar({ sessionId, t, seat, session }: LiveCostBarProps): React.ReactNode;
 /** Props of the tool-row chip: session identity and locale only (its seat is fixed to input.right). */
 export type LiveCostChipProps = Pick<LiveCostBarProps, 'sessionId' | 't'>;
 /**

package/lib/types/client/locales.d.ts

@@ -1,5 +1,5 @@
 /** Locale dictionaries for the usage billing surface. */
-export type UsageBillingKey = 'title' | 'cost' | 'todayCost' | 'monthCost' | 'yearCost' | 'monthProjected' | 'monthProjectedHint' | 'liveTurn' | 'liveSession' | 'liveSessionSub' | 'calls' | 'cacheHitRate' | 'tokens' | 'inputTokens' | 'outputTokens' | 'avgCost' | 'kpiRange' | 'avgRangeToday' | 'avgRange7d' | 'avgRangeWeek' | 'avgRangeMonth' | 'avgRangeAll' | 'trend' | 'trend7d' | 'trend30d' | 'trendMetric' | 'trendMetricCost' | 'trendMetricTokens' | 'pricingSearch' | 'bandPinHint' | 'trendEmpty' | 'trendTotal' | 'roundsUnit' | 'healthModelsLive' | 'healthVendorsDown' | 'healthVendorsUnavailable' | 'budget' | 'budgetRemain' | 'budgetAmount' | 'budgetSummary' | 'sessions' | 'sessionTitle' | 'lastActive' | 'sessionOverflow' | 'budgetTierBody' | 'models' | 'providerBilling' | 'channelUnknown' | 'directTag' | 'relayTag' | 'unknownTag' | 'unknownChannelHint' | 'planCountUnit' | 'actual' | 'pricing' | 'input' | 'output' | 'cacheHit' | 'peak' | 'offPeak' | 'flat' | 'band' | 'close' | 'footer' | 'footerCredit' | 'lastUpdated' | 'noData' | 'todayRate' | 'rateLive' | 'rateBuiltin' | 'pricingSyncedAt' | 'pricingSyncNow' | 'pricingSyncing' | 'promoBadge' | 'promoUntil' | 'promoOpenEnded' | 'pricingTip' | 'pricingUnit' | 'pricingNotes' | 'ubPeak' | 'ubOff' | 'ubStd' | 'peakBand' | 'pricingSource' | 'noteCache' | 'noteBand' | 'noteSource' | 'balance' | 'recharge' | 'rechargeHint' | 'balanceUnconfigured' | 'balanceUnauthorized' | 'balanceUnreachable' | 'uncatalogued' | 'estimatedPricing' | 'balanceDays' | 'balanceLowBody' | 'reconcileDrift' | 'reconcileDismiss' | 'subscriptionNotConfigured' | 'subscriptionUnauthorized' | 'subscriptionUnavailable' | 'subscriptionInvalid' | 'subscriptionRateLimited' | 'subscriptionSession' | 'subscriptionWeekly' | 'subscriptionMonthly' | 'subscriptionBilling' | 'subscriptionRemaining' | 'subscriptionExhausted' | 'subscriptionReset' | 'subscriptionNoApi' | 'floatWindow' | 'floatModeCombined' | 'floatModeSubscription' | 'floatMode' | 'floatTargets' | 'floatWindowHint' | 'floatPrimaryToday' | 'floatPrimaryWeek' | 'floatPrimaryMonth' | 'floatNoTargets' | 'floatNoTargetsHint' | 'cardDisplay' | 'cardDisplayHint' | 'cardMetric' | 'cardMetricMoney' | 'cardMetricTokens' | 'cardSpan' | 'cardSpanDay' | 'cardSpanWeek' | 'cardSpanMonth' | 'cardDeltaBadge' | 'cardDeltaShow' | 'cardDeltaHide' | 'triggerMonthTokens' | 'triggerTodayTokens' | 'triggerWeekTokens' | 'subscriptionsStale' | 'balanceStaleNotice' | 'staleLedgerNotice' | 'staleSnapshotNotice' | 'unreadableNotice' | 'unreadableFormatNotice' | 'unreadableNoLedgerNotice' | 'tokenCacheWrite' | 'toolRank' | 'toolName' | 'userPrices' | 'userPricesHint' | 'userPriceSave' | 'userPriceModel' | 'userPriceSource' | 'userPriceSourceHint' | 'userPriceOffPeak' | 'userPriceNormal' | 'userPriceCurrency' | 'userPriceAdd' | 'userPriceRemoveSelected' | 'userPriceSelect' | 'sessionStaleBadge' | 'sessionUntitled' | 'sessionSubCost' | 'sessionSubCalls' | 'sessionSubRow' | 'heatmapLess' | 'heatmapMore' | 'currency' | 'currencyCny' | 'currencyUsd' | 'currencyEur' | 'language' | 'heatmap' | 'rounds' | 'roundsHint' | 'anomaly' | 'model' | 'thModel' | 'thInputMiss' | 'thInputHit' | 'costAbbr' | 'tabOverview' | 'tabTrends' | 'tabProviders' | 'tabPricing' | 'tabSettings' | 'budgetHint' | 'peakAlertHint' | 'peakAlertDescPeak' | 'peakAlertDescOff' | 'peakAlertDescPeakZhipu' | 'peakAlertDescOffZhipu' | 'export' | 'exportCsvDay' | 'exportCsvSession' | 'exportJson' | 'peakShare' | 'peakSharePerCall' | 'offPeakSavings' | 'perfMax' | 'weekCost' | 'roleCost' | 'roleUser' | 'roleAssistant' | 'roleTool' | 'roleHint' | 'tierPeak' | 'tierOff' | 'tierToPeak' | 'tierToOff' | 'tierAlertEnterPeak' | 'tierAlertEnterOff' | 'tierAlertEnterPeakZhipu' | 'tierAlertEnterOffZhipu' | 'peakAlertTitlePeak' | 'peakAlertTitleOff' | 'peakAlert' | 'peakAlertLeadMin' | 'peakAlertPos' | 'peakAlertMode' | 'peakAlertPosCorner' | 'peakAlertPosCenter' | 'peakAlertModePeak' | 'peakAlertModeOff' | 'peakAlertModeBoth' | 'peakAlertWebNotify' | 'peakAlertPreview' | 'planTypeCode' | 'planTypeToken' | 'subscriptionFeePerMonth' | 'triggerToday' | 'triggerMonth' | 'subscriptionTag' | 'cellEstimateHint' | 'free' | 'perfSamples' | 'perfTtft' | 'perfP50' | 'perfP90' | 'perfTps' | 'perfLatency' | 'perfEstimated' | 'perfEmpty' | 'perfTpsUnit' | 'perfTitle' | 'perfHint' | 'perfAll' | 'perfChartEmpty' | 'heatmapYear' | 'heatmapHalf' | 'heatmapMonth' | 'metricCost' | 'metricTokens' | 'heatmapTotal' | 'activeDays' | 'streakDays' | 'subscriptionAutoDetect' | 'pluginAuthor' | 'pluginRepository' | 'pluginNpm' | 'pluginLicense' | 'tabToken' | 'tokenExport' | 'tokenExportCsv' | 'tokenReasoningShare' | 'tokenReasoningShort' | 'tokenIo' | 'tokenPeak' | 'densityLabel' | 'densityHint' | 'densityCompact' | 'densityDefault' | 'densityComfortable' | 'motionLabel' | 'motionHint' | 'motionOff' | 'motionSubtle' | 'motionRich' | 'settingsNavDisplayPref' | 'settingsNavBudget' | 'settingsNavAlert' | 'settingsNavDisplay' | 'settingsNavAdvanced' | 'settingsNavAbout' | 'settingsSearchPlaceholder' | 'settingsSearchEmpty' | 'sessionsViewAll' | 'sessionViewerSearch' | 'modelBudgetTitle' | 'modelBudgetHint' | 'modelBudgetBody' | 'modelBudgetPlaceholder' | 'moreWorksTitle' | 'adEngramName' | 'adEngramDesc' | 'adRainbowName' | 'adRainbowDesc' | 'kpiDescCacheHit' | 'kpiDescTokens' | 'kpiDescAvgCost' | 'kpiDescCalls' | 'kpiDescReasoning' | 'kpiDescIo' | 'kpiDescPeak' | 'healthDotLive' | 'healthDotFailed' | 'healthDotUnknown' | 'settingsSectionDisplay' | 'emptyHint' | 'tokenDaily' | 'tokenByModel' | 'tokenMiss' | 'tokenHit' | 'tokenOutput' | 'tokenViewStructure' | 'tokenViewModel' | 'tokenHitShort' | 'tokenMissShort' | 'tokenTotal' | 'tokenShare' | 'usageStatsTool' | 'usageStatsToolHint' | 'balanceGranted' | 'balanceTopped' | 'balanceDaily' | 'balanceDaysLong' | 'balanceDaysUnit' | 'popTodayModel' | 'popNoConsumption' | 'popTitle' | 'popDirectLead' | 'popSubLead' | 'unpricedHint' | 'searchEstimateHint' | 'siteListDisplay' | 'siteListDisplayHint' | 'liveCostBar' | 'liveCostBarHint' | 'liveCostBarPosition' | 'liveCostBarPosBelow' | 'liveCostBarPosAbove' | 'liveCostBarPosToolbar' | 'exportCsvSite' | 'panelRelayQuota' | 'relayBalance' | 'relayNoQuota' | 'relayWindowUsed' | 'relayKindNewApi' | 'relayKindSub2Api' | 'relayKindUnknown' | 'expandAll' | 'collapseAll' | 'todayOnly' | 'todayNoConsumption' | 'commandUsageLabel' | 'commandUsageDescription' | 'sessionOpen' | 'sessionOpenFailed' | 'sessionOpenUnavailable' | 'contextOccupancy' | 'contextWindow' | 'contextSystem' | 'contextTools' | 'contextMessages' | 'contextNoData' | 'tabContext' | 'tabAgents' | 'contextNextRequest' | 'contextLastRequest' | 'contextComposition' | 'contextCompositionHint' | 'agentsSummary' | 'agentsCount' | 'agentsDelegations' | 'agentsRoots' | 'agentsMostExpensive' | 'agentsChainTotal' | 'agentsNoData' | 'agentsSubagent' | 'agentsRoot';
+export type UsageBillingKey = 'title' | 'cost' | 'todayCost' | 'monthCost' | 'yearCost' | 'monthProjected' | 'monthProjectedHint' | 'liveTurn' | 'liveSession' | 'liveSessionSub' | 'calls' | 'cacheHitRate' | 'tokens' | 'inputTokens' | 'outputTokens' | 'avgCost' | 'kpiRange' | 'avgRangeToday' | 'avgRange7d' | 'avgRangeWeek' | 'avgRangeMonth' | 'avgRangeAll' | 'trend' | 'trend7d' | 'trend30d' | 'trendMetric' | 'trendMetricCost' | 'trendMetricTokens' | 'pricingSearch' | 'bandPinHint' | 'trendEmpty' | 'trendTotal' | 'roundsUnit' | 'healthModelsLive' | 'healthVendorsDown' | 'healthVendorsUnavailable' | 'budget' | 'budgetRemain' | 'budgetAmount' | 'budgetSummary' | 'sessions' | 'sessionTitle' | 'lastActive' | 'sessionOverflow' | 'budgetTierBody' | 'models' | 'providerBilling' | 'channelUnknown' | 'directTag' | 'relayTag' | 'unknownTag' | 'unknownChannelHint' | 'planCountUnit' | 'actual' | 'pricing' | 'input' | 'output' | 'cacheHit' | 'peak' | 'offPeak' | 'flat' | 'band' | 'close' | 'footer' | 'footerCredit' | 'lastUpdated' | 'noData' | 'todayRate' | 'rateLive' | 'rateBuiltin' | 'pricingSyncedAt' | 'pricingSyncNow' | 'pricingSyncing' | 'promoBadge' | 'promoUntil' | 'promoOpenEnded' | 'pricingTip' | 'pricingUnit' | 'pricingNotes' | 'ubPeak' | 'ubOff' | 'ubStd' | 'peakBand' | 'pricingSource' | 'noteCache' | 'noteBand' | 'noteSource' | 'balance' | 'recharge' | 'rechargeHint' | 'balanceUnconfigured' | 'balanceUnauthorized' | 'balanceUnreachable' | 'uncatalogued' | 'estimatedPricing' | 'balanceDays' | 'balanceLowBody' | 'reconcileDrift' | 'reconcileDismiss' | 'subscriptionNotConfigured' | 'subscriptionUnauthorized' | 'subscriptionUnavailable' | 'subscriptionInvalid' | 'subscriptionRateLimited' | 'subscriptionSession' | 'subscriptionWeekly' | 'subscriptionMonthly' | 'subscriptionBilling' | 'subscriptionRemaining' | 'subscriptionExhausted' | 'subscriptionReset' | 'subscriptionNoApi' | 'floatWindow' | 'floatModeCombined' | 'floatModeSubscription' | 'floatMode' | 'floatTargets' | 'floatWindowHint' | 'floatPrimaryToday' | 'floatPrimaryWeek' | 'floatPrimaryMonth' | 'floatNoTargets' | 'floatNoTargetsHint' | 'cardDisplay' | 'cardDisplayHint' | 'cardMetric' | 'cardMetricMoney' | 'cardMetricTokens' | 'cardSpan' | 'cardSpanDay' | 'cardSpanWeek' | 'cardSpanMonth' | 'cardDeltaBadge' | 'cardDeltaShow' | 'cardDeltaHide' | 'triggerMonthTokens' | 'triggerTodayTokens' | 'triggerWeekTokens' | 'subscriptionsStale' | 'balanceStaleNotice' | 'staleLedgerNotice' | 'staleSnapshotNotice' | 'unreadableNotice' | 'unreadableFormatNotice' | 'unreadableNoLedgerNotice' | 'tokenCacheWrite' | 'toolRank' | 'toolName' | 'userPrices' | 'userPricesHint' | 'userPriceSave' | 'userPriceModel' | 'userPriceSource' | 'userPriceSourceHint' | 'userPriceOffPeak' | 'userPriceNormal' | 'userPriceCurrency' | 'userPriceAdd' | 'userPriceRemoveSelected' | 'userPriceSelect' | 'sessionStaleBadge' | 'sessionUntitled' | 'sessionSubCost' | 'sessionSubCalls' | 'sessionSubRow' | 'heatmapLess' | 'heatmapMore' | 'currency' | 'currencyCny' | 'currencyUsd' | 'currencyEur' | 'language' | 'heatmap' | 'rounds' | 'roundsHint' | 'anomaly' | 'model' | 'thModel' | 'thInputMiss' | 'thInputHit' | 'costAbbr' | 'tabOverview' | 'tabTrends' | 'tabProviders' | 'tabPricing' | 'tabSettings' | 'budgetHint' | 'peakAlertHint' | 'peakAlertDescPeak' | 'peakAlertDescOff' | 'peakAlertDescPeakZhipu' | 'peakAlertDescOffZhipu' | 'peakAlertQueuePeak' | 'peakAlertQueueOff' | 'export' | 'exportCsvDay' | 'exportCsvSession' | 'exportJson' | 'peakShare' | 'peakSharePerCall' | 'offPeakSavings' | 'perfMax' | 'weekCost' | 'roleCost' | 'roleUser' | 'roleAssistant' | 'roleTool' | 'roleHint' | 'tierPeak' | 'tierOff' | 'tierToPeak' | 'tierToOff' | 'tierAlertEnterPeak' | 'tierAlertEnterOff' | 'tierAlertEnterPeakZhipu' | 'tierAlertEnterOffZhipu' | 'peakAlertTitlePeak' | 'peakAlertTitleOff' | 'peakAlert' | 'peakAlertLeadMin' | 'peakAlertPos' | 'peakAlertMode' | 'peakAlertPosCorner' | 'peakAlertPosCenter' | 'peakAlertModePeak' | 'peakAlertModeOff' | 'peakAlertModeBoth' | 'peakAlertWebNotify' | 'peakAlertPreview' | 'planTypeCode' | 'planTypeToken' | 'subscriptionFeePerMonth' | 'triggerToday' | 'triggerMonth' | 'subscriptionTag' | 'cellEstimateHint' | 'free' | 'perfSamples' | 'perfTtft' | 'perfP50' | 'perfP90' | 'perfTps' | 'perfLatency' | 'perfEstimated' | 'perfEmpty' | 'perfTpsUnit' | 'perfTitle' | 'perfHint' | 'perfAll' | 'perfChartEmpty' | 'heatmapYear' | 'heatmapHalf' | 'heatmapMonth' | 'metricCost' | 'metricTokens' | 'heatmapTotal' | 'activeDays' | 'streakDays' | 'subscriptionAutoDetect' | 'pluginAuthor' | 'pluginRepository' | 'pluginNpm' | 'pluginLicense' | 'tabToken' | 'tokenExport' | 'tokenExportCsv' | 'tokenReasoningShare' | 'tokenReasoningShort' | 'tokenIo' | 'tokenPeak' | 'densityLabel' | 'densityHint' | 'densityCompact' | 'densityDefault' | 'densityComfortable' | 'motionLabel' | 'motionHint' | 'motionOff' | 'motionSubtle' | 'motionRich' | 'settingsNavDisplayPref' | 'settingsNavBudget' | 'settingsNavAlert' | 'settingsNavDisplay' | 'settingsNavAdvanced' | 'settingsNavAbout' | 'settingsSearchPlaceholder' | 'settingsSearchEmpty' | 'sessionsViewAll' | 'sessionViewerSearch' | 'modelBudgetTitle' | 'modelBudgetHint' | 'modelBudgetBody' | 'modelBudgetPlaceholder' | 'moreWorksTitle' | 'adEngramName' | 'adEngramDesc' | 'adRainbowName' | 'adRainbowDesc' | 'kpiDescCacheHit' | 'kpiDescTokens' | 'kpiDescAvgCost' | 'kpiDescCalls' | 'kpiDescReasoning' | 'kpiDescIo' | 'kpiDescPeak' | 'healthDotLive' | 'healthDotFailed' | 'healthDotUnknown' | 'settingsSectionDisplay' | 'emptyHint' | 'tokenDaily' | 'tokenByModel' | 'tokenMiss' | 'tokenHit' | 'tokenOutput' | 'tokenViewStructure' | 'tokenViewModel' | 'tokenHitShort' | 'tokenMissShort' | 'tokenTotal' | 'tokenShare' | 'usageStatsTool' | 'usageStatsToolHint' | 'balanceGranted' | 'balanceTopped' | 'balanceDaily' | 'balanceDaysLong' | 'balanceDaysUnit' | 'popTodayModel' | 'popNoConsumption' | 'popTitle' | 'popDirectLead' | 'popSubLead' | 'unpricedHint' | 'searchEstimateHint' | 'siteListDisplay' | 'siteListDisplayHint' | 'liveCostBar' | 'liveCostBarHint' | 'liveCostBarPosition' | 'liveCostBarPosBelow' | 'liveCostBarPosAbove' | 'liveCostBarPosToolbar' | 'exportCsvSite' | 'panelRelayQuota' | 'relayBalance' | 'relayNoQuota' | 'relayWindowUsed' | 'relayKindNewApi' | 'relayKindSub2Api' | 'relayKindUnknown' | 'expandAll' | 'collapseAll' | 'todayOnly' | 'todayNoConsumption' | 'commandUsageLabel' | 'commandUsageDescription' | 'sessionOpen' | 'sessionOpenFailed' | 'sessionOpenUnavailable' | 'tabAgents' | 'tabQueue' | 'queueSubtitle' | 'queueUntilPeak' | 'queueUntilOffPeak' | 'queueUnsupportedTitle' | 'queueUnsupportedBody' | 'queueSafety' | 'queueWorkspace' | 'queueModel' | 'queueNoOptions' | 'queuePromptLabel' | 'queuePromptPlaceholder' | 'queuePrivacy' | 'queueEnqueue' | 'queueImport' | 'queueImportHint' | 'queueImported' | 'queueImportFormat' | 'queueImportTooLarge' | 'queueActive' | 'queueClearFinished' | 'queueEmpty' | 'queueLoading' | 'queueOpenSession' | 'queueRemoveQueued' | 'queueRemoveHistory' | 'queueStatusQueued' | 'queueStatusStarting' | 'queueStatusRunning' | 'queueStatusCompleted' | 'queueStatusFailed' | 'agentsSummary' | 'agentsCount' | 'agentsDelegations' | 'agentsRoots' | 'agentsMostExpensive' | 'agentsChainTotal' | 'agentsNoData' | 'agentsSubagent' | 'agentsRoot';
 export declare const NS = "usageBilling";
 export declare const zh: Record<UsageBillingKey, string>;
 export declare const en: Record<UsageBillingKey, string>;

package/lib/types/client/peak-alert.d.ts

@@ -33,7 +33,13 @@ export interface PeakAlertHit {
     entering: PriceTierId;
     atMs: number;
     channel: RateChannel;
+    /** Waiting DeepSeek queue items; informational only, never an execution action. */
+    queueCount?: number;
 }
+/** Prefer the current model's alert; merge queue context only at the same switch. */
+export declare function mergeQueuePeakAlert(current: PeakAlertHit | null, queue: PeakAlertHit | null, queuedCount: number): PeakAlertHit | null;
+/** Keep an already-visible banner truthful as the lightweight queue count changes. */
+export declare function refreshQueuePeakAlert(current: PeakAlertHit | null, queuedCount: number): PeakAlertHit | null;
 /** 读取本地偏好（缺失/损坏回退默认，字段宽松校验）。 */
 export declare function loadPeakAlertConfig(): PeakAlertConfig;
 /** 保存偏好；存储失败静默（降级为关闭，不影响其它能力）。 */

package/lib/types/config.d.ts

@@ -46,6 +46,9 @@ export interface UsageBillingConfig {
     ledgerPath?: string;
     /** 余额差对账基准的持久化路径；默认 `<harness home>/.dsh-usage-reconcile.json`。 */
     reconcilePath?: string;
+    /** 低谷任务队列的持久化路径；默认 `<harness home>/.dsh-usage-task-queue.json`。
+     *  文件包含待执行 Prompt，以 0600 写入；测试可注入临时路径隔离真实队列。 */
+    taskQueuePath?: string;
     /** 订阅制（coding / token / agent plan）provider id 列表；默认 kimi-coding、xiaomi-token-plan-cn。 */
     subscriptionProviders?: string[];
     /** 订阅套餐额度适配器（kimi / zai / opencode-go）；默认全部内置。 */

package/lib/types/routes/task-queue.d.ts

@@ -0,0 +1,9 @@
+/** Loopback-only GET/POST /api/billing/task-queue (issue #106). */
+import type { Context } from '@deepseek-ai/cordis';
+import { type TaskQueueEngine } from '../task-queue.ts';
+export interface TaskQueueRouteDeps {
+    readonly trustedHosts: ReadonlySet<string>;
+    readonly engine: TaskQueueEngine;
+}
+export declare function registerTaskQueueRoute(ctx: Context, deps: TaskQueueRouteDeps): void;
+//# sourceMappingURL=task-queue.d.ts.map

package/lib/types/task-queue-shared.d.ts

@@ -0,0 +1,54 @@
+/** Browser-safe wire types for the opt-in off-peak task queue (issue #106). */
+export type TaskQueueStatus = 'queued' | 'starting' | 'running' | 'completed' | 'failed';
+/** Unvalidated enqueue input shared by the HTTP client and server-side engine. */
+export interface TaskQueueInput {
+    readonly prompt?: unknown;
+    readonly cwd?: unknown;
+    readonly provider?: unknown;
+    readonly model?: unknown;
+}
+export interface TaskQueueTask {
+    readonly id: string;
+    readonly prompt: string;
+    readonly cwd: string;
+    readonly provider: string;
+    readonly model: string;
+    readonly status: TaskQueueStatus;
+    readonly createdAt: number;
+    readonly startedAt?: number | undefined;
+    readonly finishedAt?: number | undefined;
+    readonly sessionId?: string | undefined;
+    readonly error?: string | undefined;
+}
+export interface TaskQueueWorkspace {
+    readonly path: string;
+    readonly title: string;
+}
+export interface TaskQueueModel {
+    readonly provider: string;
+    readonly providerName: string;
+    readonly id: string;
+    readonly name: string;
+}
+export interface TaskQueueSnapshot {
+    /** All required host Session-control methods are available. */
+    readonly supported: boolean;
+    readonly tier: 'peak' | 'offPeak';
+    readonly nextSwitchInMs: number;
+    readonly tasks: readonly TaskQueueTask[];
+    readonly workspaces: readonly TaskQueueWorkspace[];
+    readonly models: readonly TaskQueueModel[];
+    readonly optionsError?: string;
+}
+/** Lightweight alert polling shape: never transports Prompt or Session content. */
+export interface TaskQueueSummary {
+    readonly supported: boolean;
+    readonly tier: 'peak' | 'offPeak';
+    readonly nextSwitchInMs: number;
+    readonly queuedCount: number;
+}
+export interface TaskQueueMutation {
+    readonly ok: true;
+    readonly snapshot: TaskQueueSnapshot;
+}
+//# sourceMappingURL=task-queue-shared.d.ts.map

package/lib/types/task-queue.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Durable off-peak FIFO task queue (issue #106, new-host capability preview).
+ *
+ * Safety contract: tasks START only in the DeepSeek off-peak window; an admitted
+ * turn is never cancelled at the next peak. Failed/unknown outcomes never auto-
+ * retry. A file lock + owner lease prevents two DSH instances sharing DSH_HOME
+ * from submitting the same task. Prompts are persisted with mode 0600.
+ */
+import type { SessionController } from '@deepseek-ai/dsh-api-session-controller';
+import type { TaskQueueInput, TaskQueueSnapshot, TaskQueueSummary, TaskQueueWorkspace } from './task-queue-shared.ts';
+export type TaskQueueController = Pick<SessionController, 'create' | 'selectModel' | 'prompt' | 'follow' | 'modelCatalog'>;
+type ControllerFace = TaskQueueController;
+export interface TaskQueueEngineOptions {
+    readonly filePath: string;
+    readonly getController: () => ControllerFace | undefined;
+    readonly getWorkspaces: () => readonly TaskQueueWorkspace[];
+    readonly now?: () => number;
+    readonly createId?: () => string;
+    readonly ownerId?: string;
+    readonly pollMs?: number;
+}
+export declare class TaskQueueError extends Error {
+    readonly status: number;
+    constructor(message: string, status?: number);
+}
+export declare class TaskQueueEngine {
+    private readonly options;
+    private readonly now;
+    private readonly createId;
+    private readonly ownerId;
+    private readonly pollMs;
+    private timer;
+    private heartbeat;
+    private taskAbort;
+    private stopped;
+    private pumping;
+    private modelCache;
+    constructor(options: TaskQueueEngineOptions);
+    start(): void;
+    stop(): void;
+    snapshot(): Promise<TaskQueueSnapshot>;
+    summary(): Promise<TaskQueueSummary>;
+    enqueue(input: TaskQueueInput): Promise<void>;
+    /** Validate the whole batch before one locked append: no partially admitted import. */
+    enqueueMany(inputs: readonly TaskQueueInput[]): Promise<void>;
+    remove(id: string): Promise<void>;
+    clearFinished(): Promise<void>;
+    private modelOptions;
+    private pump;
+    private claimNext;
+    private recoverExpired;
+    private execute;
+    private watch;
+    private renewLease;
+    private requeue;
+    private finish;
+    private patch;
+    private update;
+    private readDocument;
+    private readDocumentWithRaw;
+}
+export {};
+//# sourceMappingURL=task-queue.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kenz1117/dsh-ui-usage-billing",
   "description": "Usage billing dashboard for DeepSeek Harness: sidebar cost metrics plus a full dashboard modal, priced from a current multi-provider catalog with real usage aggregated from session logs.",
-  "version": "1.7.4",
+  "version": "1.8.0-alpha.2",
   "keywords": [
     "deepseek-harness",
     "deepseek",
@@ -115,7 +115,6 @@
     "@deepseek-ai/dsh-client-ui-slots": "*",
     "@deepseek-ai/dsh-client-ui-commands": "*",
     "@deepseek-ai/dsh-client-ui-workspace": "*",
-    "@deepseek-ai/dsh-token-meter": "*",
     "@deepseek-ai/dsh-credentials": "*",
     "@deepseek-ai/dsh-home-paths": "*",
     "@deepseek-ai/dsh-host-webserver": "*",
@@ -162,7 +161,6 @@
     "@deepseek-ai/dsh-session-persistence": "0.2.1-rc.4",
     "@deepseek-ai/dsh-settings": "0.2.1-rc.4",
     "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-token-meter": "0.2.1-rc.4",
     "@deepseek-ai/dsh-tools": "0.2.1-rc.4",
     "@deepseek-ai/dsh-typert-protocol": "0.2.1-rc.4",
     "@deepseek-ai/dsh-user-approval": "0.2.1-rc.4",

package/lib/types/client/context-store.d.ts

@@ -1,68 +0,0 @@
-/**
- * 上下文占用快照 store：把宿主的 token-meter 投影从**会话作用域**搬到全局弹窗。
- *
- * 宿主能力（@deepseek-ai/dsh-token-meter，经会话作用域标准 props 的 useProjection 读）：
- * - `contextPressure`：{ pressureTokens?, projectedTokens?, contextWindow? }
- *   —— provider 上报的最近一次提示词占用、下一次请求的占用外推、路由容量上限。
- * - `contextBreakdown`：{ systemTokens, toolsTokens, messageTokens }
- *   —— 下一次请求上下文的构成拆解（**启发式 token 估算**，三项之和不等于
- *   provider 锚定的 projectedTokens：估算器系统性低估 CJK 与 JSON schema）。
- *
- * 为什么需要这个 store：`contextPressure` / `contextBreakdown` 只在**会话作用域**
- * 的槽位里可读（投影按会话分发），而仪表盘弹窗是全局的——侧边栏触发的弹窗不在
- * 任何会话作用域内。解法：会话作用域里已有的即时代费用条（conversation.composer.dock
- * 座位）顺手读一次投影并发布到本 store，弹窗订阅它。
- *
- * 降级：没有会话 / 宿主不提供该投影 / 老宿主没有 token-meter → store 保持空，
- * 界面整块隐藏（**不显示 0、不显示占位假数据**）。
- */
-/** 上下文占用快照（两个投影的合并视图）。 */
-export interface ContextOccupancy {
-    /** 下一次请求的提示词占用（provider 锚定 + 增量外推）——面板主指标。 */
-    projectedTokens?: number;
-    /** 最近一次请求的提示词占用（provider 上报值）。 */
-    pressureTokens?: number;
-    /** 路由容量（上下文窗口上限）；适配器未上报时缺席。 */
-    contextWindow?: number;
-    /** 系统提示词占用（启发式估算）。 */
-    systemTokens?: number;
-    /** 工具 schema 占用（启发式估算）。 */
-    toolsTokens?: number;
-    /** 消息占用（启发式估算）。 */
-    messageTokens?: number;
-}
-/** 空快照：无数据（界面据此整块隐藏）。 */
-export declare const EMPTY_CONTEXT: ContextOccupancy;
-/** 上下文 store：写入方 = 会话作用域的费用条；读取方 = 全局仪表盘弹窗。 */
-export interface ContextStore {
-    /** 发布新快照（内容未变时保持同一对象引用，避免无谓重渲染）。 */
-    publish(next: ContextOccupancy): void;
-    /** 订阅变更；立即收到当前值一次（若为空则收到 undefined）。 */
-    subscribe(listener: (value: ContextOccupancy | undefined) => void): () => void;
-    /** 读取当前快照（无数据返回 undefined）。 */
-    read(): ContextOccupancy | undefined;
-}
-/**
- * 创建上下文 store。
- * @returns store 实例。
- */
-export declare function createContextStore(): ContextStore;
-/**
- * 占用率（0..1）：以外推占用除以窗口容量。
- * 缺任一要素 → undefined（界面不画进度，不以 0 冒充）。
- * @param occupancy - 占用快照。
- * @returns 占用率或 undefined。
- */
-export declare function occupancyRatio(occupancy: ContextOccupancy | undefined): number | undefined;
-/**
- * 构成拆解的三项（顺序固定，便于渲染与比较）。
- * @param occupancy - 占用快照。
- * @returns 构成项数组（无任何构成数据时返回空数组）。
- */
-export declare function occupancyBreakdown(occupancy: ContextOccupancy | undefined): readonly {
-    key: 'system' | 'tools' | 'message';
-    tokens: number;
-}[];
-/** 页面级单例：同一页面只有一个计费插件实例，与其它模块级单例同口径。 */
-export declare const contextStore: ContextStore;
-//# sourceMappingURL=context-store.d.ts.map