@jxgame2020/dsh-token-quota 0.1.11 → 0.1.13

package/lib/index.js

@@ -225,6 +225,8 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 	checkUpdates = true;
 	/** Cached upgrade availability; recomputed by {@link refreshUpgrade}. */
 	upgrade = null;
+	/** Error message from the most recent update check; null = no error. */
+	upgradeError = null;
 	/** Timer for the periodic update check. */
 	updateTimer;
 	/** In-flight update check, to coalesce the periodic and manual triggers. */
@@ -243,6 +245,8 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 	disposeRouteLog;
 	/** Disposer for the optional manual-check route (`POST /token-quota/check-updates`). */
 	disposeRouteCheck;
+	/** Disposer for the optional clear-log route (`POST /token-quota/clear-log`). */
+	disposeRouteClear;
 	/** Disposer for the webServer-arrival watcher when the service mounts later. */
 	disposeRouteWatcher;
 	/**
@@ -353,6 +357,41 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 				});
 			}
 		});
+		this.disposeRouteClear = server.register({
+			kind: "exact",
+			path: "/token-quota/clear-log",
+			handler: (req, res) => {
+				if (req.method !== "POST") {
+					res.writeHead(405);
+					res.end();
+					return;
+				}
+				const chunks = [];
+				req.on("data", (chunk) => {
+					chunks.push(Buffer.from(chunk));
+				});
+				req.on("end", () => {
+					let before = "";
+					try {
+						const raw = Buffer.concat(chunks).toString("utf8");
+						if (raw.length > 0) {
+							const payload = JSON.parse(raw);
+							before = typeof payload.before === "string" ? payload.before : "";
+						}
+					} catch {
+						res.writeHead(400, { "content-type": "application/json" });
+						res.end(JSON.stringify({ error: "bad payload" }));
+						return;
+					}
+					const updated = this.clearLogBefore(before);
+					res.writeHead(200, {
+						"content-type": "application/json",
+						"cache-control": "no-store"
+					});
+					res.end(JSON.stringify(updated));
+				});
+			}
+		});
 	}
 	/** Query the npm registry and rebuild the cached upgrade info (coalesced). */
 	refreshUpgrade() {
@@ -367,7 +406,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		return this.upgradeCheck;
 	}
 	async doRefreshUpgrade() {
-		const current = "0.1.11";
+		const current = "0.1.13";
 		let latest;
 		try {
 			const response = await fetch(REGISTRY_LATEST_URL, {
@@ -376,16 +415,20 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 			});
 			if (!response.ok) {
 				this.upgrade = null;
+				this.upgradeError = `registry responded ${response.status} ${response.statusText}`;
 				return;
 			}
 			const manifest = await response.json();
 			latest = typeof manifest.version === "string" ? manifest.version : void 0;
-		} catch {
+		} catch (err) {
 			this.upgrade = null;
+			const msg = err instanceof Error ? err.message : String(err);
+			this.upgradeError = msg.includes("fetch failed") ? "无法访问 npm registry（网络超时或被墙）" : msg.includes("aborted") ? "请求超时（10s）" : msg;
 			return;
 		}
 		if (latest === void 0 || !isNewer(latest, current)) {
 			this.upgrade = null;
+			this.upgradeError = null;
 			return;
 		}
 		const profile = findProfile();
@@ -395,6 +438,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 			commands,
 			installKind: profile?.installKind ?? "registry"
 		};
+		this.upgradeError = null;
 	}
 	/** Start or stop the periodic update check to match the current setting. */
 	syncUpdateChecking() {
@@ -442,6 +486,19 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		entries.sort((left, right) => right.day.localeCompare(left.day) || left.key.localeCompare(right.key));
 		return { entries };
 	}
+	/**
+	* Remove all historical cycles whose day portion strictly precedes `before`
+	* (format `YYYY-MM-DD`). The current cycle is never cleared. Returns the
+	* trimmed log so the client can refresh immediately.
+	*/
+	clearLogBefore(before) {
+		if (!/^\d{4}-\d{2}-\d{2}$/.test(before)) return this.readLog();
+		const kept = {};
+		for (const [cycle, usageByKey] of Object.entries(this.history)) if (cycle.slice(0, 10) >= before) kept[cycle] = usageByKey;
+		this.history = kept;
+		this.scheduleWrite();
+		return this.readLog();
+	}
 	/** Read the current snapshot (also used by tests and inspection). */
 	readSnapshot() {
 		this.rollCycleIfNeeded();
@@ -462,7 +519,8 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		return {
 			day: this.cycle,
 			entries,
-			upgrade: this.upgrade
+			upgrade: this.upgrade,
+			upgradeError: this.upgradeError
 		};
 	}
 	/** Today's used tokens for one model key, or `0`. */
@@ -644,6 +702,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		if (this.disposeRoute !== void 0) this.disposeRoute();
 		if (this.disposeRouteLog !== void 0) this.disposeRouteLog();
 		if (this.disposeRouteCheck !== void 0) this.disposeRouteCheck();
+		if (this.disposeRouteClear !== void 0) this.disposeRouteClear();
 		this.flush();
 	}
 	safeSplit(key) {

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

@@ -20,6 +20,8 @@ export interface TokenQuotaPanelInjected {
     setCheckUpdates: (enabled: boolean) => void;
     /** Ask the Host to check the registry right now, then refresh the snapshot. */
     checkUpdatesNow: () => void;
+    /** Ask the Host to clear log entries before a date, then refresh the log. */
+    clearLogBefore: (before: string) => void;
 }
 /** Full component props: runtime + store + locale + injected face. */
 export type TokenQuotaPanelComponentProps = PropsRuntime<'shell.overlay'> & PropsStore<ReturnType<typeof createTokenQuotaPanelStore>> & PropsLocale<'token-quota'> & TokenQuotaPanelInjected;
@@ -28,5 +30,5 @@ export type TokenQuotaPanelComponentProps = PropsRuntime<'shell.overlay'> & Prop
  * @param props - composed slot props.
  * @returns the panel element tree.
  */
-export declare function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored, setOnFull, setReset, setCheckUpdates, checkUpdatesNow, useStore, actions, useSessions, }: TokenQuotaPanelComponentProps): import("react").JSX.Element;
+export declare function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored, setOnFull, setReset, setCheckUpdates, checkUpdatesNow, clearLogBefore, useStore, actions, useSessions, }: TokenQuotaPanelComponentProps): import("react").JSX.Element;
 //# sourceMappingURL=TokenQuotaPanel.d.ts.map

package/lib/types/client/TokenQuotaPanel.js

@@ -86,7 +86,7 @@ function loadPanelPos() {
  * @param props - composed slot props.
  * @returns the panel element tree.
  */
-export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored, setOnFull, setReset, setCheckUpdates, checkUpdatesNow, useStore, actions, useSessions, }) {
+export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored, setOnFull, setReset, setCheckUpdates, checkUpdatesNow, clearLogBefore, useStore, actions, useSessions, }) {
     const [collapsed, setCollapsed] = useState(false);
     const [drafts, setDrafts] = useState({});
     const [editingKey, setEditingKey] = useState(null);
@@ -117,10 +117,18 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
     const upgrade = useStore(s => s.upgrade);
     const upgradeDismissed = useStore(s => s.upgradeDismissed);
     const checkingUpdates = useStore(s => s.checkingUpdates);
+    const lastCheckResult = useStore(s => s.lastCheckResult);
+    const upgradeError = useStore(s => s.upgradeError);
     const reset = useStore(s => s.reset);
     const dialogOpen = useStore(s => s.dialogOpen);
     const logOpen = useStore(s => s.logOpen);
     const log = useStore(s => s.log);
+    const logSearch = useStore(s => s.logSearch);
+    const logPage = useStore(s => s.logPage);
+    const logPageSize = useStore(s => s.logPageSize);
+    const logClearOpen = useStore(s => s.logClearOpen);
+    const logClearBefore = useStore(s => s.logClearBefore);
+    const logClearing = useStore(s => s.logClearing);
     const fullNotice = useStore(s => s.fullNotice);
     const loading = useStore(s => s.loading);
     const error = useStore(s => s.error);
@@ -136,6 +144,23 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
         name: model.name,
     }))).sort((a, b) => a.key.localeCompare(b.key)), [groups]);
     const isMonitoredKey = (key) => monitored === null || monitored.includes(key);
+    // Log dialog: filter by search, then paginate.
+    const filteredLogEntries = useMemo(() => {
+        if (log === null)
+            return [];
+        const q = logSearch.trim().toLowerCase();
+        if (q === '')
+            return log.entries;
+        return log.entries.filter(e => e.key.toLowerCase().includes(q)
+            || e.provider.toLowerCase().includes(q)
+            || e.model.toLowerCase().includes(q));
+    }, [log, logSearch]);
+    const logTotalPages = Math.max(1, Math.ceil(filteredLogEntries.length / logPageSize));
+    const logCurrentPage = Math.min(logPage, logTotalPages - 1);
+    const logPageEntries = useMemo(() => {
+        const start = logCurrentPage * logPageSize;
+        return filteredLogEntries.slice(start, start + logPageSize);
+    }, [filteredLogEntries, logCurrentPage, logPageSize]);
     /** Copy text to the clipboard (clipboard API with execCommand fallback). */
     const copyToClipboard = async (text) => {
         try {
@@ -237,6 +262,15 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
                                                 hour: reset?.hour ?? 0,
                                                 minute: Number(event.target.value),
                                             });
-                                        }, children: Array.from({ length: 12 }, (_, i) => i * 5).map(minute => (_jsxs("option", { value: minute, children: [String(minute).padStart(2, '0'), " \u5206"] }, minute))) })] })] }), _jsxs("div", { className: css.dialogSection, children: [_jsxs("label", { className: css.radioRow, children: [_jsx("input", { type: "checkbox", checked: checkUpdates, onChange: (event) => { setCheckUpdates(event.target.checked); } }), _jsx("span", { children: t('checkUpdatesLabel') })] }), _jsx("div", { className: css.checkUpdatesRow, children: _jsx("button", { type: "button", className: css.checkBtn, disabled: checkingUpdates, onClick: checkUpdatesNow, children: checkingUpdates ? t('checkingUpdates') : t('checkUpdatesNow') }) })] })] })), logOpen && (_jsxs("div", { ref: logRef, className: `${css.dialog} ${css.logDialog}`, style: logPos !== null ? { left: logPos.x, top: logPos.y, transform: 'none' } : undefined, children: [_jsxs("div", { className: css.logHeader, onPointerDown: (event) => { beginDrag(event, logRef.current, setLogPos); }, children: [_jsx("div", { className: css.dialogTitle, children: t('logsTitle') }), _jsx("button", { type: "button", className: css.dialogClose, title: t('close'), onClick: () => { actions.setLogOpen(false); }, children: "\u00D7" })] }), log !== null && log.entries.length === 0 && (_jsx("div", { className: css.notice, children: t('logEmpty') })), _jsx("div", { className: css.logScroll, children: _jsxs("table", { className: css.logTable, children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { children: t('logDay') }), _jsx("th", { children: t('logModel') }), _jsx("th", { className: css.logUsedCol, children: t('logUsed') })] }) }), _jsx("tbody", { children: log?.entries.map(entry => (_jsxs("tr", { children: [_jsx("td", { className: css.logDayCol, children: entry.day }), _jsx("td", { className: css.logModelCol, title: entry.key, children: entry.key }), _jsx("td", { className: css.logUsedCol, children: formatTokens(entry.used) })] }, `${entry.day}/${entry.key}`))) })] }) })] }))] }));
+                                        }, children: Array.from({ length: 12 }, (_, i) => i * 5).map(minute => (_jsxs("option", { value: minute, children: [String(minute).padStart(2, '0'), " \u5206"] }, minute))) })] })] }), _jsxs("div", { className: css.dialogSection, children: [_jsxs("div", { className: css.checkUpdatesRow, children: [_jsxs("label", { className: css.checkUpdatesLabel, children: [_jsx("input", { type: "checkbox", checked: checkUpdates, onChange: (event) => { setCheckUpdates(event.target.checked); } }), _jsx("span", { children: t('checkUpdatesLabel') })] }), _jsx("button", { type: "button", className: css.checkBtn, disabled: checkingUpdates, onClick: checkUpdatesNow, children: checkingUpdates
+                                            ? t('checkingUpdates')
+                                            : lastCheckResult === 'up-to-date'
+                                                ? t('checkUpToDate')
+                                                : lastCheckResult === 'error'
+                                                    ? t('checkFailed')
+                                                    : t('checkUpdatesNow') })] }), lastCheckResult === 'error' && upgradeError !== null && (_jsx("div", { className: css.checkErrorHint, role: "alert", children: upgradeError }))] })] })), logOpen && (_jsxs("div", { ref: logRef, className: `${css.dialog} ${css.logDialog}`, style: logPos !== null ? { left: logPos.x, top: logPos.y, transform: 'none' } : undefined, children: [_jsxs("div", { className: css.logHeader, onPointerDown: (event) => { beginDrag(event, logRef.current, setLogPos); }, children: [_jsx("div", { className: css.dialogTitle, children: t('logsTitle') }), _jsxs("div", { className: css.logToolbar, onPointerDown: (event) => { event.stopPropagation(); }, children: [_jsx("input", { type: "search", className: css.logSearch, placeholder: t('logSearchPlaceholder'), value: logSearch, onChange: (event) => { actions.setLogSearch(event.target.value); } }), _jsx("button", { type: "button", className: css.logClearBtn, onClick: () => { actions.setLogClearOpen(true); }, children: t('logClear') })] }), _jsx("button", { type: "button", className: css.dialogClose, title: t('close'), onClick: () => { actions.setLogOpen(false); }, children: "\u00D7" })] }), log !== null && filteredLogEntries.length === 0 && (_jsx("div", { className: css.notice, children: logSearch.trim() !== '' ? t('logNoMatch') : t('logEmpty') })), _jsx("div", { className: css.logScroll, children: _jsxs("table", { className: css.logTable, children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { children: t('logDay') }), _jsx("th", { children: t('logModel') }), _jsx("th", { className: css.logUsedCol, children: t('logUsed') })] }) }), _jsx("tbody", { children: logPageEntries.map(entry => (_jsxs("tr", { children: [_jsx("td", { className: css.logDayCol, children: entry.day }), _jsx("td", { className: css.logModelCol, title: entry.key, children: entry.key }), _jsx("td", { className: css.logUsedCol, children: formatTokens(entry.used) })] }, `${entry.day}/${entry.key}`))) })] }) }), _jsxs("div", { className: css.logPager, children: [_jsx("span", { className: css.logPagerInfo, children: t('logPagerInfo')
+                                    .replace('{from}', String(logCurrentPage * logPageSize + 1))
+                                    .replace('{to}', String(Math.min((logCurrentPage + 1) * logPageSize, filteredLogEntries.length)))
+                                    .replace('{total}', String(filteredLogEntries.length)) }), _jsxs("div", { className: css.logPagerControls, children: [_jsx("button", { type: "button", className: css.logPagerBtn, disabled: logCurrentPage <= 0, onClick: () => { actions.setLogPage(logCurrentPage - 1); }, children: "\u2039" }), _jsxs("span", { className: css.logPagerPages, children: [logCurrentPage + 1, " / ", logTotalPages] }), _jsx("button", { type: "button", className: css.logPagerBtn, disabled: logCurrentPage >= logTotalPages - 1, onClick: () => { actions.setLogPage(logCurrentPage + 1); }, children: "\u203A" }), _jsx("select", { className: css.logPageSizeSelect, value: logPageSize, onChange: (event) => { actions.setLogPageSize(Number(event.target.value)); }, children: [10, 15, 20, 50, 100].map(size => (_jsxs("option", { value: size, children: [size, t('logPerPage')] }, size))) })] })] })] })), logClearOpen && (_jsx("div", { className: css.dialogOverlay, children: _jsxs("div", { className: `${css.dialog} ${css.logClearDialog}`, children: [_jsx("div", { className: css.dialogTitle, children: t('logClearTitle') }), _jsx("div", { className: css.dialogBody, children: t('logClearHint') }), _jsx("input", { type: "date", className: css.logClearDate, value: logClearBefore, onChange: (event) => { actions.setLogClearBefore(event.target.value); } }), _jsxs("div", { className: css.dialogActions, children: [_jsx("button", { type: "button", className: css.checkBtn, disabled: logClearBefore === '' || logClearing, onClick: () => { clearLogBefore(logClearBefore); }, children: logClearing ? t('logClearing') : t('logClearConfirm') }), _jsx("button", { type: "button", className: css.checkBtn, onClick: () => { actions.setLogClearOpen(false); }, children: t('logClearCancel') })] })] }) }))] }));
 }
 //# sourceMappingURL=TokenQuotaPanel.js.map

package/lib/types/client/index.js

@@ -185,6 +185,7 @@ export function apply(ctx) {
                 return;
             bound?.setSnapshot(snapshot);
             bound?.setUpgrade(snapshot.upgrade ?? null);
+            bound?.setUpgradeError(snapshot.upgradeError ?? null);
             actOnFull(snapshot);
         });
         if (pullCount % 2 === 0)
@@ -236,21 +237,33 @@ export function apply(ctx) {
     /** Ask the Host to check the registry right now, then refresh the snapshot. */
     const checkUpdatesNow = () => {
         bound?.setCheckingUpdates(true);
+        bound?.setLastCheckResult('idle');
         void fetch('/token-quota/check-updates', { method: 'POST' }).then((response) => {
             if (!response.ok) {
                 bound?.setError(`check-updates route: ${String(response.status)}`);
+                bound?.setLastCheckResult('error');
                 return undefined;
             }
             return response.json();
         }, () => {
             bound?.setError('update check failed');
+            bound?.setLastCheckResult('error');
         }).then((snapshot) => {
             if (snapshot !== undefined) {
                 bound?.setSnapshot(snapshot);
                 bound?.setUpgrade(snapshot.upgrade ?? null);
+                bound?.setUpgradeError(snapshot.upgradeError ?? null);
                 actOnFull(snapshot);
+                if (snapshot.upgrade === null) {
+                    // No newer version known: distinguish "checked OK, up to date"
+                    // from "check failed" via the host-provided error message.
+                    bound?.setLastCheckResult(snapshot.upgradeError !== null ? 'error' : 'up-to-date');
+                }
             }
             bound?.setCheckingUpdates(false);
+            // Clear the transient result hint after a short delay so the button
+            // returns to its idle label. The error message stays until the next check.
+            setTimeout(() => { bound?.setLastCheckResult('idle'); }, 4000);
         });
     };
     const setReset = (reset) => {
@@ -276,11 +289,33 @@ export function apply(ctx) {
             bound?.setError('model switch failed');
         });
     };
+    /** Ask the Host to clear log entries before a given date, then refresh. */
+    const clearLogBefore = (before) => {
+        bound?.setLogClearing(true);
+        void fetch('/token-quota/clear-log', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ before }),
+        }).then((response) => {
+            if (!response.ok) {
+                bound?.setError(`clear-log route: ${String(response.status)}`);
+                return undefined;
+            }
+            return response.json();
+        }, () => {
+            bound?.setError('clear log failed');
+        }).then((log) => {
+            if (log !== undefined)
+                bound?.setLog(log);
+            bound?.setLogClearing(false);
+            bound?.setLogClearOpen(false);
+        });
+    };
     const injected = (actions) => {
         bound = actions;
         return {
             load, setLimit, selectModel, setMonitored, setOnFull, setReset,
-            setCheckUpdates, checkUpdatesNow,
+            setCheckUpdates, checkUpdatesNow, clearLogBefore,
         };
     };
     ctx.slots.inject('shell.overlay', () => ctx.slots.register({

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

@@ -41,6 +41,16 @@ export declare const zh: {
     logs: string;
     logsTitle: string;
     logEmpty: string;
+    logNoMatch: string;
+    logSearchPlaceholder: string;
+    logClear: string;
+    logClearTitle: string;
+    logClearHint: string;
+    logClearConfirm: string;
+    logClearCancel: string;
+    logClearing: string;
+    logPagerInfo: string;
+    logPerPage: string;
     logDay: string;
     logModel: string;
     logUsed: string;
@@ -55,6 +65,8 @@ export declare const zh: {
     checkUpdatesLabel: string;
     checkUpdatesNow: string;
     checkingUpdates: string;
+    checkUpToDate: string;
+    checkFailed: string;
 };
 /** Dictionary keys owned by the token-quota panel (a string-literal union). */
 export type TokenQuotaKey = keyof typeof zh;
@@ -95,6 +107,16 @@ export declare const en: {
     logs: string;
     logsTitle: string;
     logEmpty: string;
+    logNoMatch: string;
+    logSearchPlaceholder: string;
+    logClear: string;
+    logClearTitle: string;
+    logClearHint: string;
+    logClearConfirm: string;
+    logClearCancel: string;
+    logClearing: string;
+    logPagerInfo: string;
+    logPerPage: string;
     logDay: string;
     logModel: string;
     logUsed: string;
@@ -109,5 +131,7 @@ export declare const en: {
     checkUpdatesLabel: string;
     checkUpdatesNow: string;
     checkingUpdates: string;
+    checkUpToDate: string;
+    checkFailed: string;
 };
 //# sourceMappingURL=locales.d.ts.map

package/lib/types/client/locales.js

@@ -41,6 +41,16 @@ export const zh = {
     logs: '日志',
     logsTitle: '用量日志',
     logEmpty: '暂无记录',
+    logNoMatch: '无匹配记录',
+    logSearchPlaceholder: '搜索模型…',
+    logClear: '清除',
+    logClearTitle: '清除历史日志',
+    logClearHint: '将删除所选日期之前的所有记录（不含当日）',
+    logClearConfirm: '确认清除',
+    logClearCancel: '取消',
+    logClearing: '清除中…',
+    logPagerInfo: '第 {from}-{to} 条 / 共 {total} 条',
+    logPerPage: '条/页',
     logDay: '日期',
     logModel: '模型',
     logUsed: '用量',
@@ -55,6 +65,8 @@ export const zh = {
     checkUpdatesLabel: '自动检查更新',
     checkUpdatesNow: '立即检查',
     checkingUpdates: '检查中…',
+    checkUpToDate: '已是最新',
+    checkFailed: '检查失败',
 };
 /** English copy. */
 export const en = {
@@ -93,6 +105,16 @@ export const en = {
     logs: 'Logs',
     logsTitle: 'Usage Log',
     logEmpty: 'No records',
+    logNoMatch: 'No matching records',
+    logSearchPlaceholder: 'Search model…',
+    logClear: 'Clear',
+    logClearTitle: 'Clear historical log',
+    logClearHint: 'This deletes all records before the selected date (the date itself is kept).',
+    logClearConfirm: 'Confirm',
+    logClearCancel: 'Cancel',
+    logClearing: 'Clearing…',
+    logPagerInfo: '{from}-{to} of {total}',
+    logPerPage: '/page',
     logDay: 'Day',
     logModel: 'Model',
     logUsed: 'Used',
@@ -107,5 +129,7 @@ export const en = {
     checkUpdatesLabel: 'Check for updates automatically',
     checkUpdatesNow: 'Check now',
     checkingUpdates: 'Checking…',
+    checkUpToDate: 'Up to date',
+    checkFailed: 'Check failed',
 };
 //# sourceMappingURL=locales.js.map

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

@@ -54,6 +54,10 @@ export interface TokenQuotaPanelState {
     upgradeDismissed: boolean;
     /** Whether a manual update check is in flight. */
     checkingUpdates: boolean;
+    /** Result of the most recent manual check; 'idle' = nothing to show. */
+    lastCheckResult: 'idle' | 'up-to-date' | 'error';
+    /** Error message from the most recent update check (shown when lastCheckResult='error'). */
+    upgradeError: string | null;
     /** Whether the settings dialog is open. */
     dialogOpen: boolean;
     /** Full-quota notice shown for the `'stop'` strategy; null when none. */
@@ -64,6 +68,18 @@ export interface TokenQuotaPanelState {
     logOpen: boolean;
     /** Latest usage history; null before the first fetch. */
     log: TokenQuotaLog | null;
+    /** Filter string for the log table (matches provider/model key). */
+    logSearch: string;
+    /** Current page index (0-based) in the filtered log table. */
+    logPage: number;
+    /** Rows per page in the log table. */
+    logPageSize: number;
+    /** Whether the clear-log confirmation dialog is open. */
+    logClearOpen: boolean;
+    /** The `YYYY-MM-DD` date before which log entries will be cleared. */
+    logClearBefore: string;
+    /** Whether a clear-log request is in flight. */
+    logClearing: boolean;
 }
 /** Declared write surface. */
 export type TokenQuotaPanelActions = {
@@ -76,11 +92,19 @@ export type TokenQuotaPanelActions = {
     setUpgrade: (d: TokenQuotaPanelState, upgrade: TokenQuotaUpgrade | null) => void;
     setUpgradeDismissed: (d: TokenQuotaPanelState, dismissed: boolean) => void;
     setCheckingUpdates: (d: TokenQuotaPanelState, checking: boolean) => void;
+    setLastCheckResult: (d: TokenQuotaPanelState, result: 'idle' | 'up-to-date' | 'error') => void;
+    setUpgradeError: (d: TokenQuotaPanelState, error: string | null) => void;
     setDialogOpen: (d: TokenQuotaPanelState, open: boolean) => void;
     setFullNotice: (d: TokenQuotaPanelState, notice: string | null) => void;
     setReset: (d: TokenQuotaPanelState, reset: TokenQuotaReset | null) => void;
     setLogOpen: (d: TokenQuotaPanelState, open: boolean) => void;
     setLog: (d: TokenQuotaPanelState, log: TokenQuotaLog | null) => void;
+    setLogSearch: (d: TokenQuotaPanelState, search: string) => void;
+    setLogPage: (d: TokenQuotaPanelState, page: number) => void;
+    setLogPageSize: (d: TokenQuotaPanelState, size: number) => void;
+    setLogClearOpen: (d: TokenQuotaPanelState, open: boolean) => void;
+    setLogClearBefore: (d: TokenQuotaPanelState, before: string) => void;
+    setLogClearing: (d: TokenQuotaPanelState, clearing: boolean) => void;
 };
 /**
  * Declares the panel state and write surface.

package/lib/types/client/store.js

@@ -30,11 +30,19 @@ export function createTokenQuotaPanelStore() {
             upgrade: null,
             upgradeDismissed: false,
             checkingUpdates: false,
+            lastCheckResult: 'idle',
+            upgradeError: null,
             dialogOpen: false,
             fullNotice: null,
             reset: null,
             logOpen: false,
             log: null,
+            logSearch: '',
+            logPage: 0,
+            logPageSize: 15,
+            logClearOpen: false,
+            logClearBefore: '',
+            logClearing: false,
         }),
         actions: {
             setSnapshot: (d, snapshot) => { d.snapshot = snapshot; },
@@ -53,11 +61,19 @@ export function createTokenQuotaPanelStore() {
             },
             setUpgradeDismissed: (d, dismissed) => { d.upgradeDismissed = dismissed; },
             setCheckingUpdates: (d, checking) => { d.checkingUpdates = checking; },
+            setLastCheckResult: (d, result) => { d.lastCheckResult = result; },
+            setUpgradeError: (d, error) => { d.upgradeError = error; },
             setDialogOpen: (d, open) => { d.dialogOpen = open; },
             setFullNotice: (d, notice) => { d.fullNotice = notice; },
             setReset: (d, reset) => { d.reset = reset; },
             setLogOpen: (d, open) => { d.logOpen = open; },
             setLog: (d, log) => { d.log = log; },
+            setLogSearch: (d, search) => { d.logSearch = search; d.logPage = 0; },
+            setLogPage: (d, page) => { d.logPage = page; },
+            setLogPageSize: (d, size) => { d.logPageSize = size; d.logPage = 0; },
+            setLogClearOpen: (d, open) => { d.logClearOpen = open; },
+            setLogClearBefore: (d, before) => { d.logClearBefore = before; },
+            setLogClearing: (d, clearing) => { d.logClearing = clearing; },
         },
     });
 }

package/lib/types/index.d.ts

@@ -59,6 +59,8 @@ export declare class TokenQuotaService extends Service {
     private checkUpdates;
     /** Cached upgrade availability; recomputed by {@link refreshUpgrade}. */
     private upgrade;
+    /** Error message from the most recent update check; null = no error. */
+    private upgradeError;
     /** Timer for the periodic update check. */
     private updateTimer;
     /** In-flight update check, to coalesce the periodic and manual triggers. */
@@ -77,6 +79,8 @@ export declare class TokenQuotaService extends Service {
     private disposeRouteLog;
     /** Disposer for the optional manual-check route (`POST /token-quota/check-updates`). */
     private disposeRouteCheck;
+    /** Disposer for the optional clear-log route (`POST /token-quota/clear-log`). */
+    private disposeRouteClear;
     /** Disposer for the webServer-arrival watcher when the service mounts later. */
     private disposeRouteWatcher;
     /**
@@ -93,6 +97,12 @@ export declare class TokenQuotaService extends Service {
     private syncUpdateChecking;
     /** Read the full per-cycle usage history (log dialog data). */
     readLog(): TokenQuotaLog;
+    /**
+     * Remove all historical cycles whose day portion strictly precedes `before`
+     * (format `YYYY-MM-DD`). The current cycle is never cleared. Returns the
+     * trimmed log so the client can refresh immediately.
+     */
+    clearLogBefore(before: string): TokenQuotaLog;
     /** Read the current snapshot (also used by tests and inspection). */
     readSnapshot(): TokenQuotaSnapshot;
     /** Today's used tokens for one model key, or `0`. */