@jsonstudio/rcc 0.89.2239 → 0.90.89

package/dist/server/runtime/http-server/session-scope-resolution.js

@@ -0,0 +1,208 @@
+import { extractSessionClientScopeIdFromApiKey } from '../../../utils/session-client-token.js';
+function readToken(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function extractHeaderValue(headers, name) {
+    if (!headers) {
+        return undefined;
+    }
+    const target = name.toLowerCase();
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() !== target) {
+            continue;
+        }
+        if (typeof value === 'string') {
+            return value.trim() || undefined;
+        }
+        if (Array.isArray(value) && value.length > 0) {
+            return String(value[0]).trim() || undefined;
+        }
+        return undefined;
+    }
+    return undefined;
+}
+function extractTmuxSessionIdFromTurnMetadata(rawValue) {
+    if (!rawValue) {
+        return undefined;
+    }
+    const normalizeTmuxToken = (value) => {
+        const token = readToken(value);
+        if (!token) {
+            return undefined;
+        }
+        if (!/^[a-zA-Z0-9._:-]+$/.test(token)) {
+            return undefined;
+        }
+        return token;
+    };
+    const parseFromObject = (root) => {
+        if (!root || typeof root !== 'object') {
+            return undefined;
+        }
+        const queue = [root];
+        const visited = new Set();
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (!current || typeof current !== 'object') {
+                continue;
+            }
+            if (visited.has(current)) {
+                continue;
+            }
+            visited.add(current);
+            if (Array.isArray(current)) {
+                for (const value of current) {
+                    if (value && typeof value === 'object') {
+                        queue.push(value);
+                    }
+                }
+                continue;
+            }
+            const record = current;
+            const directTmux = normalizeTmuxToken(record.tmuxSessionId)
+                || normalizeTmuxToken(record.tmux_session_id)
+                || normalizeTmuxToken(record.tmuxSession)
+                || normalizeTmuxToken(record.tmux_session)
+                || normalizeTmuxToken(record.rccTmuxSessionId)
+                || normalizeTmuxToken(record.rcc_tmux_session_id)
+                || normalizeTmuxToken(record.clientTmuxSessionId)
+                || normalizeTmuxToken(record.client_tmux_session_id)
+                || normalizeTmuxToken(record.rccSessionClientTmuxSessionId)
+                || normalizeTmuxToken(record.rcc_session_client_tmux_session_id);
+            if (directTmux) {
+                return directTmux;
+            }
+            for (const [key, value] of Object.entries(record)) {
+                if (value && typeof value === 'object') {
+                    queue.push(value);
+                    continue;
+                }
+                if (typeof value !== 'string') {
+                    continue;
+                }
+                const normalizedKey = key.trim().toLowerCase();
+                if (normalizedKey.includes('tmux')
+                    || normalizedKey === 'rcc_session_client_tmux_session_id'
+                    || normalizedKey === 'rccsessionclienttmuxsessionid') {
+                    const token = normalizeTmuxToken(value);
+                    if (token) {
+                        return token;
+                    }
+                }
+            }
+        }
+        return undefined;
+    };
+    const candidates = [rawValue];
+    try {
+        candidates.push(decodeURIComponent(rawValue));
+    }
+    catch {
+        // ignore URI decoding errors
+    }
+    for (const candidate of [...candidates]) {
+        const normalized = candidate.trim();
+        if (!normalized) {
+            continue;
+        }
+        if (!/^[A-Za-z0-9+/=_-]+$/.test(normalized) || normalized.length < 12) {
+            continue;
+        }
+        try {
+            const padded = normalized.padEnd(Math.ceil(normalized.length / 4) * 4, '=');
+            const decoded = Buffer.from(padded, 'base64').toString('utf8').trim();
+            if (decoded) {
+                candidates.push(decoded);
+            }
+        }
+        catch {
+            // ignore base64 decoding errors
+        }
+    }
+    for (const candidate of candidates) {
+        try {
+            const parsed = JSON.parse(candidate);
+            const tmux = parseFromObject(parsed);
+            if (tmux) {
+                return tmux;
+            }
+        }
+        catch {
+            // continue to URLSearchParams fallback
+        }
+        try {
+            const params = new URLSearchParams(candidate);
+            const fromParams = normalizeTmuxToken(params.get('tmuxSessionId'))
+                || normalizeTmuxToken(params.get('tmux_session_id'))
+                || normalizeTmuxToken(params.get('tmuxSession'))
+                || normalizeTmuxToken(params.get('tmux_session'))
+                || normalizeTmuxToken(params.get('rccTmuxSessionId'))
+                || normalizeTmuxToken(params.get('rcc_tmux_session_id'))
+                || normalizeTmuxToken(params.get('clientTmuxSessionId'))
+                || normalizeTmuxToken(params.get('client_tmux_session_id'))
+                || normalizeTmuxToken(params.get('rcc_session_client_tmux_session_id'));
+            if (fromParams) {
+                return fromParams;
+            }
+        }
+        catch {
+            // ignore non-URLSearchParams text
+        }
+    }
+    return undefined;
+}
+function readTmuxFromHeaderSource(source) {
+    if (!source) {
+        return undefined;
+    }
+    const fromTurnMeta = extractTmuxSessionIdFromTurnMetadata(extractHeaderValue(source, 'x-codex-turn-metadata'));
+    if (fromTurnMeta) {
+        return fromTurnMeta;
+    }
+    const fromHeader = extractHeaderValue(source, 'x-routecodex-client-tmux-session-id')
+        || extractHeaderValue(source, 'x-rcc-client-tmux-session-id')
+        || extractHeaderValue(source, 'x-routecodex-client-tmuxsession-id')
+        || extractHeaderValue(source, 'x-rcc-client-tmuxsession-id')
+        || extractHeaderValue(source, 'x-routecodex-clienttmuxsessionid')
+        || extractHeaderValue(source, 'x-routecodex-tmux-session-id')
+        || extractHeaderValue(source, 'x-rcc-tmux-session-id')
+        || extractHeaderValue(source, 'x-tmux-session-id');
+    if (fromHeader) {
+        return fromHeader;
+    }
+    const fromApiKeyHeader = extractHeaderValue(source, 'x-routecodex-api-key')
+        || extractHeaderValue(source, 'x-api-key')
+        || extractHeaderValue(source, 'x-routecodex-apikey')
+        || extractHeaderValue(source, 'api-key')
+        || extractHeaderValue(source, 'apikey');
+    const fromApiKey = extractSessionClientScopeIdFromApiKey(fromApiKeyHeader);
+    if (fromApiKey) {
+        return fromApiKey;
+    }
+    const authorization = extractHeaderValue(source, 'authorization');
+    if (authorization) {
+        const match = authorization.match(/^(?:Bearer|ApiKey)\s+(.+)$/i);
+        const fromAuth = extractSessionClientScopeIdFromApiKey(match ? String(match[1]) : authorization);
+        if (fromAuth) {
+            return fromAuth;
+        }
+    }
+    return undefined;
+}
+export function resolveTmuxSessionIdAndSource(args) {
+    const tmuxFromHeaders = readTmuxFromHeaderSource(args.headers)
+        || readTmuxFromHeaderSource(args.clientHeaders);
+    if (tmuxFromHeaders) {
+        return { tmuxSessionId: tmuxFromHeaders, source: 'headers_or_api_key' };
+    }
+    const tmuxFromMeta = readToken(args.userMeta.tmuxSessionId) || readToken(args.userMeta.tmux_session_id);
+    if (tmuxFromMeta) {
+        return { tmuxSessionId: tmuxFromMeta, source: 'metadata' };
+    }
+    const tmuxFromBody = readToken(args.bodyMeta.tmuxSessionId) || readToken(args.bodyMeta.tmux_session_id);
+    if (tmuxFromBody) {
+        return { tmuxSessionId: tmuxFromBody, source: 'body_metadata' };
+    }
+    return { source: 'none' };
+}
+//# sourceMappingURL=session-scope-resolution.js.map

package/dist/server/runtime/http-server/session-scope-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-scope-resolution.js","sourceRoot":"","sources":["../../../../src/server/runtime/http-server/session-scope-resolution.ts"],"names":[],"mappings":"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"}

package/dist/server/runtime/http-server/stats-manager.d.ts

@@ -53,6 +53,20 @@ export interface HistoricalStatsSnapshot {
     sampleCount: number;
     totals: ProviderStatsView[];
 }
+export interface HistoricalPeriodBucket {
+    period: string;
+    requestCount: number;
+    errorCount: number;
+    totalPromptTokens: number;
+    totalCompletionTokens: number;
+    totalOutputTokens: number;
+}
+export interface HistoricalPeriodsSnapshot {
+    generatedAt: number;
+    daily: HistoricalPeriodBucket[];
+    weekly: HistoricalPeriodBucket[];
+    monthly: HistoricalPeriodBucket[];
+}
 export type StatsPersistOptions = {
     logPath?: string;
     reason?: string;
@@ -74,6 +88,17 @@ export declare class StatsManager {
     private historicalSnapshotCount;
     private historicalSampleCount;
     private historicalLoaded;
+    private readonly dailyPeriods;
+    private readonly weeklyPeriods;
+    private readonly monthlyPeriods;
+    private readonly persistIntervalMs;
+    private readonly maxDailyPeriods;
+    private readonly maxWeeklyPeriods;
+    private readonly maxMonthlyPeriods;
+    private periodicPersistTimer;
+    private persistSeq;
+    private lastPeriodicSignature;
+    private readonly persistSessionId;
     constructor();
     recordRequestStart(requestId: string): void;
     bindProvider(requestId: string, meta: {
@@ -91,12 +116,22 @@ export declare class StatsManager {
     }, payload: unknown): void;
     snapshot(uptimeMs: number): StatsSnapshot;
     logSummary(uptimeMs: number): StatsSnapshot;
+    logFinalSummary(uptimeMs: number): {
+        session: StatsSnapshot;
+        historical: HistoricalStatsSnapshot;
+    };
     persistSnapshot(snapshot: StatsSnapshot, options?: StatsPersistOptions): Promise<void>;
     logHistoricalSummary(options?: {
         logPath?: string;
     }): Promise<void>;
     snapshotHistorical(): HistoricalStatsSnapshot;
+    snapshotHistoricalPeriods(): HistoricalPeriodsSnapshot;
     private ensureHistoricalLoaded;
+    private startPeriodicPersistence;
+    private persistPeriodicSnapshot;
+    private buildSnapshotSignature;
+    private mergeSnapshotIntoPeriods;
+    private mergeSnapshotIntoHistorical;
     private loadHistoricalFromDisk;
     private normalizeLogPath;
     private resolveLogPath;

package/dist/server/runtime/http-server/stats-manager.js

@@ -7,6 +7,10 @@ import { buildHistoricalProviderRow, buildSessionProviderRow, composeBucketKey,
 const DEFAULT_STATS_LOG_PATH = path.join(os.homedir(), '.routecodex', 'logs', 'provider-stats.jsonl');
 const DEFAULT_HISTORY_MAX_TAIL_BYTES = 8 * 1024 * 1024;
 const DEFAULT_HISTORY_MAX_LINES = 20000;
+const DEFAULT_PERSIST_INTERVAL_MS = 30000;
+const DEFAULT_DAILY_PERIODS = 90;
+const DEFAULT_WEEKLY_PERIODS = 104;
+const DEFAULT_MONTHLY_PERIODS = 36;
 function resolveBoolFromEnv(value, fallback) {
     if (!value) {
         return fallback;
@@ -36,6 +40,84 @@ function resolvePositiveIntEnv(primary, secondary, fallback) {
     }
     return fallback;
 }
+function toUtcDayKey(ts) {
+    const date = new Date(ts);
+    const y = date.getUTCFullYear();
+    const m = String(date.getUTCMonth() + 1).padStart(2, '0');
+    const d = String(date.getUTCDate()).padStart(2, '0');
+    return `${y}-${m}-${d}`;
+}
+function toUtcMonthKey(ts) {
+    const date = new Date(ts);
+    const y = date.getUTCFullYear();
+    const m = String(date.getUTCMonth() + 1).padStart(2, '0');
+    return `${y}-${m}`;
+}
+function toUtcIsoWeekKey(ts) {
+    const date = new Date(ts);
+    const day = date.getUTCDay() || 7;
+    date.setUTCDate(date.getUTCDate() + 4 - day);
+    const yearStart = new Date(Date.UTC(date.getUTCFullYear(), 0, 1));
+    const week = Math.ceil((((date.getTime() - yearStart.getTime()) / 86400000) + 1) / 7);
+    return `${date.getUTCFullYear()}-W${String(week).padStart(2, '0')}`;
+}
+function sumSnapshotTotals(rows) {
+    const totals = {
+        requestCount: 0,
+        errorCount: 0,
+        totalPromptTokens: 0,
+        totalCompletionTokens: 0,
+        totalOutputTokens: 0
+    };
+    for (const row of rows) {
+        totals.requestCount += row.requestCount ?? 0;
+        totals.errorCount += row.errorCount ?? 0;
+        totals.totalPromptTokens += row.totalPromptTokens ?? 0;
+        totals.totalCompletionTokens += row.totalCompletionTokens ?? 0;
+        totals.totalOutputTokens += row.totalOutputTokens ?? 0;
+    }
+    return totals;
+}
+function sortSummaryRows(rows) {
+    return rows
+        .slice()
+        .sort((a, b) => {
+        const requestDelta = (b.requestCount ?? 0) - (a.requestCount ?? 0);
+        if (requestDelta !== 0) {
+            return requestDelta;
+        }
+        const keyA = composeBucketKey(a.providerKey, a.model);
+        const keyB = composeBucketKey(b.providerKey, b.model);
+        return keyA.localeCompare(keyB);
+    });
+}
+function upsertPeriodBucket(map, period, delta) {
+    const current = map.get(period) ?? {
+        requestCount: 0,
+        errorCount: 0,
+        totalPromptTokens: 0,
+        totalCompletionTokens: 0,
+        totalOutputTokens: 0
+    };
+    current.requestCount += delta.requestCount;
+    current.errorCount += delta.errorCount;
+    current.totalPromptTokens += delta.totalPromptTokens;
+    current.totalCompletionTokens += delta.totalCompletionTokens;
+    current.totalOutputTokens += delta.totalOutputTokens;
+    map.set(period, current);
+}
+function trimPeriodMap(map, maxEntries) {
+    if (map.size <= maxEntries) {
+        return;
+    }
+    const keys = Array.from(map.keys()).sort((a, b) => a.localeCompare(b));
+    while (map.size > maxEntries && keys.length) {
+        const key = keys.shift();
+        if (key) {
+            map.delete(key);
+        }
+    }
+}
 function readTailLines(filePath, maxTailBytes, maxLines) {
     let text = '';
     const stat = fsSync.statSync(filePath);
@@ -84,12 +166,30 @@ export class StatsManager {
     historicalSnapshotCount = 0;
     historicalSampleCount = 0;
     historicalLoaded = false;
+    dailyPeriods = new Map();
+    weeklyPeriods = new Map();
+    monthlyPeriods = new Map();
+    persistIntervalMs;
+    maxDailyPeriods;
+    maxWeeklyPeriods;
+    maxMonthlyPeriods;
+    periodicPersistTimer = null;
+    persistSeq = 0;
+    lastPeriodicSignature = '';
+    persistSessionId = `${process.pid}-${Date.now().toString(36)}-${Math.random()
+        .toString(36)
+        .slice(2, 8)}`;
     constructor() {
         this.enabled = isStatsEnabledByDefault();
         this.verboseLogging = isStatsVerboseEnabled(this.enabled);
         this.statsLogPath = this.resolveLogPath();
+        this.persistIntervalMs = resolvePositiveIntEnv(process.env.ROUTECODEX_STATS_PERSIST_INTERVAL_MS, process.env.RCC_STATS_PERSIST_INTERVAL_MS, DEFAULT_PERSIST_INTERVAL_MS);
+        this.maxDailyPeriods = resolvePositiveIntEnv(process.env.ROUTECODEX_STATS_DAILY_MAX_PERIODS, process.env.RCC_STATS_DAILY_MAX_PERIODS, DEFAULT_DAILY_PERIODS);
+        this.maxWeeklyPeriods = resolvePositiveIntEnv(process.env.ROUTECODEX_STATS_WEEKLY_MAX_PERIODS, process.env.RCC_STATS_WEEKLY_MAX_PERIODS, DEFAULT_WEEKLY_PERIODS);
+        this.maxMonthlyPeriods = resolvePositiveIntEnv(process.env.ROUTECODEX_STATS_MONTHLY_MAX_PERIODS, process.env.RCC_STATS_MONTHLY_MAX_PERIODS, DEFAULT_MONTHLY_PERIODS);
         if (this.enabled) {
             this.loadHistoricalFromDisk(this.statsLogPath, true);
+            this.startPeriodicPersistence();
         }
     }
     recordRequestStart(requestId) {
@@ -247,16 +347,7 @@ export class StatsManager {
             return snapshot;
         }
         this.ensureHistoricalLoaded();
-        const merged = mergeSnapshotIntoHistorical({
-            snapshot,
-            historicalBuckets: this.historicalBuckets,
-            historicalToolAggregate: this.historicalToolAggregate,
-            historicalToolByProvider: this.historicalToolByProvider,
-            historicalSnapshotCount: this.historicalSnapshotCount,
-            historicalSampleCount: this.historicalSampleCount
-        });
-        this.historicalSnapshotCount = merged.historicalSnapshotCount;
-        this.historicalSampleCount = merged.historicalSampleCount;
+        this.mergeSnapshotIntoHistorical(snapshot);
         if (!this.verboseLogging) {
             return snapshot;
         }
@@ -269,6 +360,42 @@ export class StatsManager {
         logToolSummary(snapshot.tools, formatProviderLabel);
         return snapshot;
     }
+    logFinalSummary(uptimeMs) {
+        const session = this.snapshot(uptimeMs);
+        if (!this.enabled) {
+            return { session, historical: this.snapshotHistorical() };
+        }
+        this.ensureHistoricalLoaded();
+        this.mergeSnapshotIntoHistorical(session);
+        const historical = this.snapshotHistorical();
+        const sessionTotals = sumSnapshotTotals(session.totals);
+        const historicalTotals = sumSnapshotTotals(historical.totals);
+        const sessionRows = sortSummaryRows(session.totals);
+        const historicalRows = sortSummaryRows(historical.totals);
+        console.log('\n[Stats][final][session] calls=%d errors=%d tokens(prompt/completion/total)=%d/%d/%d uptimeMs=%d', sessionTotals.requestCount, sessionTotals.errorCount, sessionTotals.totalPromptTokens, sessionTotals.totalCompletionTokens, sessionTotals.totalOutputTokens, Math.round(session.uptimeMs));
+        if (!sessionRows.length) {
+            console.log('[Stats][final][session] providers: none');
+        }
+        else {
+            console.log('[Stats][final][session] providers:');
+            for (const row of sessionRows) {
+                const providerLabel = formatProviderLabel(row.providerKey, row.model);
+                console.log('  - %s calls=%d tokens=%d/%d/%d', providerLabel, row.requestCount, row.totalPromptTokens, row.totalCompletionTokens, row.totalOutputTokens);
+            }
+        }
+        console.log('\n[Stats][final][historical] calls=%d errors=%d tokens(prompt/completion/total)=%d/%d/%d snapshots=%d samples=%d', historicalTotals.requestCount, historicalTotals.errorCount, historicalTotals.totalPromptTokens, historicalTotals.totalCompletionTokens, historicalTotals.totalOutputTokens, historical.snapshotCount, historical.sampleCount);
+        if (!historicalRows.length) {
+            console.log('[Stats][final][historical] providers: none');
+        }
+        else {
+            console.log('[Stats][final][historical] providers:');
+            for (const row of historicalRows) {
+                const providerLabel = formatProviderLabel(row.providerKey, row.model);
+                console.log('  - %s calls=%d tokens=%d/%d/%d', providerLabel, row.requestCount, row.totalPromptTokens, row.totalCompletionTokens, row.totalOutputTokens);
+            }
+        }
+        return { session, historical };
+    }
     async persistSnapshot(snapshot, options) {
         if (!this.enabled) {
             return;
@@ -279,7 +406,10 @@ export class StatsManager {
             const record = {
                 ...snapshot,
                 reason: options?.reason ?? 'shutdown',
-                pid: process.pid
+                pid: process.pid,
+                sessionId: this.persistSessionId,
+                snapshotSeq: ++this.persistSeq,
+                persistedAt: Date.now()
             };
             await fs.appendFile(logPath, `${JSON.stringify(record)}\n`, 'utf-8');
         }
@@ -318,12 +448,99 @@ export class StatsManager {
             totals
         };
     }
+    snapshotHistoricalPeriods() {
+        if (!this.enabled) {
+            return { generatedAt: Date.now(), daily: [], weekly: [], monthly: [] };
+        }
+        this.ensureHistoricalLoaded();
+        const toRows = (map) => Array.from(map.entries())
+            .sort((a, b) => b[0].localeCompare(a[0]))
+            .map(([period, bucket]) => ({ period, ...bucket }));
+        return {
+            generatedAt: Date.now(),
+            daily: toRows(this.dailyPeriods),
+            weekly: toRows(this.weeklyPeriods),
+            monthly: toRows(this.monthlyPeriods)
+        };
+    }
     ensureHistoricalLoaded() {
         if (!this.enabled || this.historicalLoaded) {
             return;
         }
         this.loadHistoricalFromDisk(this.statsLogPath, true);
     }
+    startPeriodicPersistence() {
+        if (!this.enabled || this.persistIntervalMs <= 0) {
+            return;
+        }
+        this.periodicPersistTimer = setInterval(() => {
+            void this.persistPeriodicSnapshot();
+        }, this.persistIntervalMs);
+        this.periodicPersistTimer.unref?.();
+    }
+    async persistPeriodicSnapshot() {
+        try {
+            const snapshot = this.snapshot(Math.round(process.uptime() * 1000));
+            if (!snapshot.totals.length) {
+                return;
+            }
+            const signature = this.buildSnapshotSignature(snapshot);
+            if (signature === this.lastPeriodicSignature) {
+                return;
+            }
+            await this.persistSnapshot(snapshot, { reason: 'periodic' });
+            this.lastPeriodicSignature = signature;
+        }
+        catch {
+            // persistence must be best-effort
+        }
+    }
+    buildSnapshotSignature(snapshot) {
+        const totals = sumSnapshotTotals(snapshot.totals || []);
+        const toolCalls = typeof snapshot.tools?.totalCalls === 'number' ? snapshot.tools.totalCalls : 0;
+        const toolResponses = typeof snapshot.tools?.totalResponses === 'number' ? snapshot.tools.totalResponses : 0;
+        return [
+            totals.requestCount,
+            totals.errorCount,
+            totals.totalPromptTokens,
+            totals.totalCompletionTokens,
+            totals.totalOutputTokens,
+            toolCalls,
+            toolResponses
+        ].join(':');
+    }
+    mergeSnapshotIntoPeriods(snapshot) {
+        const generatedAt = typeof snapshot.generatedAt === 'number' && Number.isFinite(snapshot.generatedAt)
+            ? snapshot.generatedAt
+            : Date.now();
+        const totals = Array.isArray(snapshot.totals) ? snapshot.totals : [];
+        if (!totals.length) {
+            return;
+        }
+        const delta = sumSnapshotTotals(totals);
+        const day = toUtcDayKey(generatedAt);
+        const week = toUtcIsoWeekKey(generatedAt);
+        const month = toUtcMonthKey(generatedAt);
+        upsertPeriodBucket(this.dailyPeriods, day, delta);
+        upsertPeriodBucket(this.weeklyPeriods, week, delta);
+        upsertPeriodBucket(this.monthlyPeriods, month, delta);
+        trimPeriodMap(this.dailyPeriods, this.maxDailyPeriods);
+        trimPeriodMap(this.weeklyPeriods, this.maxWeeklyPeriods);
+        trimPeriodMap(this.monthlyPeriods, this.maxMonthlyPeriods);
+    }
+    mergeSnapshotIntoHistorical(snapshot) {
+        const merged = mergeSnapshotIntoHistorical({
+            snapshot,
+            historicalBuckets: this.historicalBuckets,
+            historicalToolAggregate: this.historicalToolAggregate,
+            historicalToolByProvider: this.historicalToolByProvider,
+            historicalSnapshotCount: this.historicalSnapshotCount,
+            historicalSampleCount: this.historicalSampleCount
+        });
+        this.historicalSnapshotCount = merged.historicalSnapshotCount;
+        this.historicalSampleCount = merged.historicalSampleCount;
+        this.mergeSnapshotIntoPeriods(snapshot);
+    }
     loadHistoricalFromDisk(logPath, reset) {
         if (reset) {
             this.historicalBuckets.clear();
@@ -331,29 +548,60 @@ export class StatsManager {
             this.historicalToolByProvider.clear();
             this.historicalSnapshotCount = 0;
             this.historicalSampleCount = 0;
+            this.dailyPeriods.clear();
+            this.weeklyPeriods.clear();
+            this.monthlyPeriods.clear();
         }
         try {
             const maxTailBytes = resolvePositiveIntEnv(process.env.ROUTECODEX_STATS_HISTORY_MAX_TAIL_BYTES, process.env.RCC_STATS_HISTORY_MAX_TAIL_BYTES, DEFAULT_HISTORY_MAX_TAIL_BYTES);
             const maxLines = resolvePositiveIntEnv(process.env.ROUTECODEX_STATS_HISTORY_MAX_LINES, process.env.RCC_STATS_HISTORY_MAX_LINES, DEFAULT_HISTORY_MAX_LINES);
             const lines = readTailLines(logPath, maxTailBytes, maxLines);
+            const latestBySession = new Map();
+            const legacyRecords = [];
             for (const line of lines) {
                 try {
                     const record = JSON.parse(line);
-                    const merged = mergeSnapshotIntoHistorical({
-                        snapshot: record,
-                        historicalBuckets: this.historicalBuckets,
-                        historicalToolAggregate: this.historicalToolAggregate,
-                        historicalToolByProvider: this.historicalToolByProvider,
-                        historicalSnapshotCount: this.historicalSnapshotCount,
-                        historicalSampleCount: this.historicalSampleCount
-                    });
-                    this.historicalSnapshotCount = merged.historicalSnapshotCount;
-                    this.historicalSampleCount = merged.historicalSampleCount;
+                    if (typeof record?.sessionId === 'string' &&
+                        record.sessionId.trim() &&
+                        typeof record?.snapshotSeq === 'number' &&
+                        Number.isFinite(record.snapshotSeq)) {
+                        const key = record.sessionId.trim();
+                        const seq = Math.floor(record.snapshotSeq);
+                        const existing = latestBySession.get(key);
+                        if (!existing ||
+                            seq > existing.snapshotSeq ||
+                            (seq === existing.snapshotSeq &&
+                                (typeof record.generatedAt === 'number' ? record.generatedAt : 0) >
+                                    (typeof existing.generatedAt === 'number' ? existing.generatedAt : 0))) {
+                            latestBySession.set(key, { ...record, snapshotSeq: seq });
+                        }
+                    }
+                    else {
+                        legacyRecords.push(record);
+                    }
                 }
                 catch {
                     continue;
                 }
             }
+            const dedupedRecords = [
+                ...legacyRecords,
+                ...Array.from(latestBySession.values())
+            ].sort((a, b) => (typeof a.generatedAt === 'number' ? a.generatedAt : 0) -
+                (typeof b.generatedAt === 'number' ? b.generatedAt : 0));
+            for (const record of dedupedRecords) {
+                const merged = mergeSnapshotIntoHistorical({
+                    snapshot: record,
+                    historicalBuckets: this.historicalBuckets,
+                    historicalToolAggregate: this.historicalToolAggregate,
+                    historicalToolByProvider: this.historicalToolByProvider,
+                    historicalSnapshotCount: this.historicalSnapshotCount,
+                    historicalSampleCount: this.historicalSampleCount
+                });
+                this.historicalSnapshotCount = merged.historicalSnapshotCount;
+                this.historicalSampleCount = merged.historicalSampleCount;
+                this.mergeSnapshotIntoPeriods(record);
+            }
         }
         catch {
             // File missing or unreadable -> treat as empty history.