sidekick-shared 0.25.0 → 0.26.1

package/dist/schemas/quota.js

@@ -10,7 +10,7 @@
  * @module schemas/quota
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaWindowSchema = void 0;
+exports.providerQuotaMapSchema = exports.zaiProviderQuotaStateSchema = exports.codexProviderQuotaStateSchema = exports.claudeProviderQuotaStateSchema = exports.providerQuotaStateSchema = exports.runtimeQuotaProviderSchema = exports.quotaFailureDescriptorSchema = exports.peakHoursStateSchema = exports.quotaStateSchema = exports.codexResetCreditsSnapshotSchema = exports.codexResetCreditSchema = exports.quotaFreshnessSchema = exports.quotaCapturedSourceSchema = exports.quotaSourceSchema = exports.quotaProviderIdSchema = exports.quotaFailureKindSchema = exports.quotaWindowSchema = void 0;
 const zod_1 = require("zod");
 const providerIds_1 = require("../providerIds");
 // ── QuotaWindow ──
@@ -27,7 +27,18 @@ exports.quotaFailureKindSchema = zod_1.z.enum([
     'unknown',
 ]);
 exports.quotaProviderIdSchema = zod_1.z.enum(providerIds_1.QUOTA_PROVIDER_IDS);
-exports.quotaSourceSchema = zod_1.z.enum(['api', 'session', 'cache']);
+exports.quotaSourceSchema = zod_1.z.enum([
+    'api',
+    'session',
+    'cache',
+    'statusline',
+]);
+exports.quotaCapturedSourceSchema = zod_1.z.enum([
+    'api',
+    'session',
+    'statusline',
+]);
+exports.quotaFreshnessSchema = zod_1.z.enum(['fresh', 'aging', 'stale']);
 exports.codexResetCreditSchema = zod_1.z.object({
     title: zod_1.z.string().optional(),
     status: zod_1.z.string(),
@@ -54,8 +65,11 @@ exports.quotaStateSchema = zod_1.z.object({
     projectedSevenDay: zod_1.z.number().optional(),
     providerId: exports.quotaProviderIdSchema.optional(),
     source: exports.quotaSourceSchema.optional(),
+    capturedSource: exports.quotaCapturedSourceSchema.optional(),
     capturedAt: zod_1.z.string().optional(),
     stale: zod_1.z.boolean().optional(),
+    ageMs: zod_1.z.number().finite().nonnegative().optional(),
+    freshness: exports.quotaFreshnessSchema.optional(),
     fiveHourLabel: zod_1.z.string().optional(),
     sevenDayLabel: zod_1.z.string().optional(),
     limitId: zod_1.z.string().optional(),
@@ -78,6 +92,7 @@ exports.peakHoursStateSchema = zod_1.z.object({
     updatedAt: zod_1.z.string(),
     unavailable: zod_1.z.boolean(),
     notApplicable: zod_1.z.boolean().optional(),
+    source: zod_1.z.enum(['promoclock', 'schedule']).optional(),
 });
 // ── QuotaFailureDescriptor ──
 exports.quotaFailureDescriptorSchema = zod_1.z.object({

package/dist/schemas/quotaHistory.d.ts

@@ -37,6 +37,7 @@ export declare const quotaHistorySampleSchema: z.ZodObject<{
         api: "api";
         cache: "cache";
         session: "session";
+        statusline: "statusline";
     }>>;
     stale: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;

package/dist/schemas/quotaHistory.js

@@ -28,7 +28,7 @@ exports.quotaHistorySampleSchema = zod_1.z.object({
     sevenDay: zod_1.z.object({ utilization: zod_1.z.number(), resetsAt: zod_1.z.string() }),
     available: zod_1.z.boolean(),
     error: zod_1.z.string().optional(),
-    source: zod_1.z.enum(['session', 'cache', 'api']).optional(),
+    source: zod_1.z.enum(['session', 'cache', 'api', 'statusline']).optional(),
     stale: zod_1.z.boolean().optional(),
 });
 // ── QuotaHistoryDailyBucket ──

package/dist/schemas/sessionEvent.d.ts

@@ -52,6 +52,7 @@ export declare const sessionMessageSchema: z.ZodObject<{
         }, z.core.$strip>;
     }, z.core.$strip>>;
     content: z.ZodOptional<z.ZodUnknown>;
+    stop_reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const permissionModeSchema: z.ZodEnum<{
     default: "default";
@@ -136,6 +137,7 @@ export declare const userSessionEventSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
         content: z.ZodOptional<z.ZodUnknown>;
+        stop_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const assistantSessionEventSchema: z.ZodObject<{
@@ -215,6 +217,7 @@ export declare const assistantSessionEventSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
         content: z.ZodOptional<z.ZodUnknown>;
+        stop_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const summarySessionEventSchema: z.ZodType<SummarySessionEvent>;
@@ -295,6 +298,7 @@ export declare const systemSessionEventSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
         content: z.ZodOptional<z.ZodUnknown>;
+        stop_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const toolUseSessionEventSchema: z.ZodObject<{
@@ -378,6 +382,7 @@ export declare const toolUseSessionEventSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
         content: z.ZodOptional<z.ZodUnknown>;
+        stop_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const toolResultSessionEventSchema: z.ZodObject<{
@@ -462,6 +467,7 @@ export declare const toolResultSessionEventSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
         content: z.ZodOptional<z.ZodUnknown>;
+        stop_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const sessionEventSchema: z.ZodType<SessionEvent>;

package/dist/schemas/sessionEvent.js

@@ -30,6 +30,7 @@ exports.sessionMessageSchema = zod_1.z.object({
     usage: exports.messageUsageSchema.optional(),
     normalizedUsage: usageNormalization_1.normalizedUsageSchema.optional(),
     content: zod_1.z.unknown().optional(),
+    stop_reason: zod_1.z.string().optional(),
 });
 // ── PermissionMode ──
 exports.permissionModeSchema = zod_1.z.enum([

package/dist/schemas/stateFile.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Zod schema for the public `state.json` contract (`schemaVersion: 1`).
+ *
+ * Mirrors the interfaces in `stateFile.ts` (keep in sync when those change;
+ * fields are only ever added). Consumers validating the file from another
+ * process import this from `sidekick-shared/schemas`.
+ *
+ * @module schemas/stateFile
+ */
+import { z } from 'zod';
+export declare const stateFileWriterSchema: z.ZodEnum<{
+    statusline: "statusline";
+    "cli-dashboard": "cli-dashboard";
+    "vscode-dashboard": "vscode-dashboard";
+}>;
+export declare const stateFileQuotaWindowSchema: z.ZodObject<{
+    utilization: z.ZodNumber;
+    resetsAt: z.ZodString;
+}, z.core.$strip>;
+export declare const stateFileQuotaSchema: z.ZodObject<{
+    fiveHour: z.ZodObject<{
+        utilization: z.ZodNumber;
+        resetsAt: z.ZodString;
+    }, z.core.$strip>;
+    sevenDay: z.ZodObject<{
+        utilization: z.ZodNumber;
+        resetsAt: z.ZodString;
+    }, z.core.$strip>;
+    source: z.ZodNullable<z.ZodEnum<{
+        api: "api";
+        cache: "cache";
+        session: "session";
+        statusline: "statusline";
+    }>>;
+    capturedSource: z.ZodNullable<z.ZodEnum<{
+        api: "api";
+        session: "session";
+        statusline: "statusline";
+    }>>;
+    capturedAt: z.ZodNullable<z.ZodString>;
+    ageMs: z.ZodNullable<z.ZodNumber>;
+    freshness: z.ZodNullable<z.ZodEnum<{
+        fresh: "fresh";
+        aging: "aging";
+        stale: "stale";
+    }>>;
+}, z.core.$strip>;
+export declare const stateFileAccountSchema: z.ZodObject<{
+    providerId: z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+    }>;
+    id: z.ZodNullable<z.ZodString>;
+    label: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const stateFileContextSchema: z.ZodObject<{
+    usedPercentage: z.ZodNullable<z.ZodNumber>;
+    contextWindowSize: z.ZodNullable<z.ZodNumber>;
+    totalInputTokens: z.ZodNullable<z.ZodNumber>;
+    totalOutputTokens: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const stateFileSessionSchema: z.ZodObject<{
+    sessionId: z.ZodNullable<z.ZodString>;
+    cwd: z.ZodNullable<z.ZodString>;
+    model: z.ZodNullable<z.ZodString>;
+    costUsd: z.ZodNullable<z.ZodNumber>;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    linesAdded: z.ZodNullable<z.ZodNumber>;
+    linesRemoved: z.ZodNullable<z.ZodNumber>;
+    promptCacheHitRatio: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const stateFileBillingBlockSchema: z.ZodObject<{
+    start: z.ZodString;
+    end: z.ZodString;
+    isActive: z.ZodBoolean;
+    tokens: z.ZodNumber;
+    costUsd: z.ZodNumber;
+    costProvenance: z.ZodEnum<{
+        none: "none";
+        reported: "reported";
+        estimated: "estimated";
+        unpriced: "unpriced";
+        mixed: "mixed";
+    }>;
+    burnRatePerMinute: z.ZodNumber;
+    projectedTokens: z.ZodNumber;
+    projectedCostUsd: z.ZodNumber;
+    remainingMs: z.ZodNumber;
+}, z.core.$strip>;
+export declare const sidekickStateFileSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    writtenAt: z.ZodString;
+    writer: z.ZodEnum<{
+        statusline: "statusline";
+        "cli-dashboard": "cli-dashboard";
+        "vscode-dashboard": "vscode-dashboard";
+    }>;
+    account: z.ZodNullable<z.ZodObject<{
+        providerId: z.ZodEnum<{
+            "claude-code": "claude-code";
+            codex: "codex";
+        }>;
+        id: z.ZodNullable<z.ZodString>;
+        label: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    quota: z.ZodObject<{
+        claude: z.ZodNullable<z.ZodObject<{
+            fiveHour: z.ZodObject<{
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodString;
+            }, z.core.$strip>;
+            sevenDay: z.ZodObject<{
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodString;
+            }, z.core.$strip>;
+            source: z.ZodNullable<z.ZodEnum<{
+                api: "api";
+                cache: "cache";
+                session: "session";
+                statusline: "statusline";
+            }>>;
+            capturedSource: z.ZodNullable<z.ZodEnum<{
+                api: "api";
+                session: "session";
+                statusline: "statusline";
+            }>>;
+            capturedAt: z.ZodNullable<z.ZodString>;
+            ageMs: z.ZodNullable<z.ZodNumber>;
+            freshness: z.ZodNullable<z.ZodEnum<{
+                fresh: "fresh";
+                aging: "aging";
+                stale: "stale";
+            }>>;
+        }, z.core.$strip>>;
+        codex: z.ZodNullable<z.ZodObject<{
+            fiveHour: z.ZodObject<{
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodString;
+            }, z.core.$strip>;
+            sevenDay: z.ZodObject<{
+                utilization: z.ZodNumber;
+                resetsAt: z.ZodString;
+            }, z.core.$strip>;
+            source: z.ZodNullable<z.ZodEnum<{
+                api: "api";
+                cache: "cache";
+                session: "session";
+                statusline: "statusline";
+            }>>;
+            capturedSource: z.ZodNullable<z.ZodEnum<{
+                api: "api";
+                session: "session";
+                statusline: "statusline";
+            }>>;
+            capturedAt: z.ZodNullable<z.ZodString>;
+            ageMs: z.ZodNullable<z.ZodNumber>;
+            freshness: z.ZodNullable<z.ZodEnum<{
+                fresh: "fresh";
+                aging: "aging";
+                stale: "stale";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    context: z.ZodNullable<z.ZodObject<{
+        usedPercentage: z.ZodNullable<z.ZodNumber>;
+        contextWindowSize: z.ZodNullable<z.ZodNumber>;
+        totalInputTokens: z.ZodNullable<z.ZodNumber>;
+        totalOutputTokens: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    session: z.ZodNullable<z.ZodObject<{
+        sessionId: z.ZodNullable<z.ZodString>;
+        cwd: z.ZodNullable<z.ZodString>;
+        model: z.ZodNullable<z.ZodString>;
+        costUsd: z.ZodNullable<z.ZodNumber>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        linesAdded: z.ZodNullable<z.ZodNumber>;
+        linesRemoved: z.ZodNullable<z.ZodNumber>;
+        promptCacheHitRatio: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    billingBlock: z.ZodNullable<z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+        isActive: z.ZodBoolean;
+        tokens: z.ZodNumber;
+        costUsd: z.ZodNumber;
+        costProvenance: z.ZodEnum<{
+            none: "none";
+            reported: "reported";
+            estimated: "estimated";
+            unpriced: "unpriced";
+            mixed: "mixed";
+        }>;
+        burnRatePerMinute: z.ZodNumber;
+        projectedTokens: z.ZodNumber;
+        projectedCostUsd: z.ZodNumber;
+        remainingMs: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

package/dist/schemas/stateFile.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Zod schema for the public `state.json` contract (`schemaVersion: 1`).
+ *
+ * Mirrors the interfaces in `stateFile.ts` (keep in sync when those change;
+ * fields are only ever added). Consumers validating the file from another
+ * process import this from `sidekick-shared/schemas`.
+ *
+ * @module schemas/stateFile
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sidekickStateFileSchema = exports.stateFileBillingBlockSchema = exports.stateFileSessionSchema = exports.stateFileContextSchema = exports.stateFileAccountSchema = exports.stateFileQuotaSchema = exports.stateFileQuotaWindowSchema = exports.stateFileWriterSchema = void 0;
+const zod_1 = require("zod");
+exports.stateFileWriterSchema = zod_1.z.enum([
+    'statusline',
+    'cli-dashboard',
+    'vscode-dashboard',
+]);
+exports.stateFileQuotaWindowSchema = zod_1.z.object({
+    utilization: zod_1.z.number(),
+    resetsAt: zod_1.z.string(),
+});
+exports.stateFileQuotaSchema = zod_1.z.object({
+    fiveHour: exports.stateFileQuotaWindowSchema,
+    sevenDay: exports.stateFileQuotaWindowSchema,
+    source: zod_1.z.enum(['api', 'session', 'cache', 'statusline']).nullable(),
+    capturedSource: zod_1.z.enum(['api', 'session', 'statusline']).nullable(),
+    capturedAt: zod_1.z.string().nullable(),
+    ageMs: zod_1.z.number().nullable(),
+    freshness: zod_1.z.enum(['fresh', 'aging', 'stale']).nullable(),
+});
+exports.stateFileAccountSchema = zod_1.z.object({
+    providerId: zod_1.z.enum(['claude-code', 'codex']),
+    id: zod_1.z.string().nullable(),
+    label: zod_1.z.string().nullable(),
+});
+exports.stateFileContextSchema = zod_1.z.object({
+    usedPercentage: zod_1.z.number().nullable(),
+    contextWindowSize: zod_1.z.number().nullable(),
+    totalInputTokens: zod_1.z.number().nullable(),
+    totalOutputTokens: zod_1.z.number().nullable(),
+});
+exports.stateFileSessionSchema = zod_1.z.object({
+    sessionId: zod_1.z.string().nullable(),
+    cwd: zod_1.z.string().nullable(),
+    model: zod_1.z.string().nullable(),
+    costUsd: zod_1.z.number().nullable(),
+    durationMs: zod_1.z.number().nullable(),
+    linesAdded: zod_1.z.number().nullable(),
+    linesRemoved: zod_1.z.number().nullable(),
+    promptCacheHitRatio: zod_1.z.number().nullable(),
+});
+exports.stateFileBillingBlockSchema = zod_1.z.object({
+    start: zod_1.z.string(),
+    end: zod_1.z.string(),
+    isActive: zod_1.z.boolean(),
+    tokens: zod_1.z.number(),
+    costUsd: zod_1.z.number(),
+    costProvenance: zod_1.z.enum(['reported', 'estimated', 'mixed', 'unpriced', 'none']),
+    burnRatePerMinute: zod_1.z.number(),
+    projectedTokens: zod_1.z.number(),
+    projectedCostUsd: zod_1.z.number(),
+    remainingMs: zod_1.z.number(),
+});
+exports.sidekickStateFileSchema = zod_1.z.object({
+    schemaVersion: zod_1.z.literal(1),
+    writtenAt: zod_1.z.string(),
+    writer: exports.stateFileWriterSchema,
+    account: exports.stateFileAccountSchema.nullable(),
+    quota: zod_1.z.object({
+        claude: exports.stateFileQuotaSchema.nullable(),
+        codex: exports.stateFileQuotaSchema.nullable(),
+    }),
+    context: exports.stateFileContextSchema.nullable(),
+    session: exports.stateFileSessionSchema.nullable(),
+    billingBlock: exports.stateFileBillingBlockSchema.nullable(),
+});

package/dist/schemas/transcript.js

@@ -78,6 +78,8 @@ exports.canonicalSessionTranscriptSchema = zod_1.z.object({
             totalTokens: zod_1.z.number().finite().nonnegative(),
         }),
         totalCostUsd: zod_1.z.number().finite().nonnegative().nullable(),
+        pricedCostUsd: zod_1.z.number().finite().nonnegative(),
+        unpricedEvents: zod_1.z.number().int().nonnegative(),
     }),
     provenance: zod_1.z.object({
         source: zod_1.z.literal('session-events'),

package/dist/sessionFingerprint.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Size/mtime fingerprints for session sources.
+ *
+ * Shared by the observed-session collector, the V1 adapter's watch loop, and
+ * the usage cache, so "has this session changed?" is answered the same way
+ * everywhere without re-reading content.
+ *
+ * @module sessionFingerprint
+ */
+import type { SessionProviderBase } from './providers/types';
+export interface ObservedSessionFingerprintParts {
+    sizeBytes: number;
+    mtimeMs: number;
+}
+/** Structured size/mtime fingerprint; returns null for inaccessible or synthetic paths. */
+export declare function fileFingerprintParts(sourcePath: string): ObservedSessionFingerprintParts | null;
+/** Size/mtime fingerprint suitable for retry bypass; returns null for synthetic DB locators. */
+export declare function fileFingerprint(sourcePath: string): string | null;
+/** Canonical `${sizeBytes}:${mtimeMs}` form of a fingerprint. */
+export declare function fingerprintString(parts: ObservedSessionFingerprintParts): string;
+/**
+ * Fingerprint for a session path, falling back to provider metadata (mtime
+ * only) for database-backed sessions whose path is synthetic.
+ */
+export declare function sessionFingerprintParts(provider: SessionProviderBase, sessionPath: string): ObservedSessionFingerprintParts | null;

package/dist/sessionFingerprint.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Size/mtime fingerprints for session sources.
+ *
+ * Shared by the observed-session collector, the V1 adapter's watch loop, and
+ * the usage cache, so "has this session changed?" is answered the same way
+ * everywhere without re-reading content.
+ *
+ * @module sessionFingerprint
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileFingerprintParts = fileFingerprintParts;
+exports.fileFingerprint = fileFingerprint;
+exports.fingerprintString = fingerprintString;
+exports.sessionFingerprintParts = sessionFingerprintParts;
+const node_fs_1 = require("node:fs");
+/** Structured size/mtime fingerprint; returns null for inaccessible or synthetic paths. */
+function fileFingerprintParts(sourcePath) {
+    try {
+        const stat = (0, node_fs_1.statSync)(sourcePath);
+        return { sizeBytes: stat.size, mtimeMs: stat.mtimeMs };
+    }
+    catch {
+        return null;
+    }
+}
+/** Size/mtime fingerprint suitable for retry bypass; returns null for synthetic DB locators. */
+function fileFingerprint(sourcePath) {
+    const parts = fileFingerprintParts(sourcePath);
+    return parts ? fingerprintString(parts) : null;
+}
+/** Canonical `${sizeBytes}:${mtimeMs}` form of a fingerprint. */
+function fingerprintString(parts) {
+    return `${parts.sizeBytes}:${parts.mtimeMs}`;
+}
+/**
+ * Fingerprint for a session path, falling back to provider metadata (mtime
+ * only) for database-backed sessions whose path is synthetic.
+ */
+function sessionFingerprintParts(provider, sessionPath) {
+    const parts = fileFingerprintParts(sessionPath);
+    if (parts)
+        return parts;
+    const metadata = provider.getSessionMetadata?.(sessionPath);
+    return metadata ? { sizeBytes: 0, mtimeMs: metadata.mtime.getTime() } : null;
+}

package/dist/sessionPreviews.d.ts

@@ -36,7 +36,11 @@ export interface SessionPreview {
     workspacePath: string | null;
 }
 export interface ReadSessionPreviewOptions {
-    /** Byte budget for the generic prefix scan (default 16 KiB). */
+    /**
+     * Byte budget for the generic prefix scan (default 16 KiB). `0` skips the
+     * scan entirely for callers that ignore `firstTimestamp` and
+     * `workspacePath`; both come back `null` and the file is not opened.
+     */
     maxPrefixBytes?: number;
 }
 export interface ListSessionPreviewsOptions extends ReadSessionPreviewOptions {
@@ -64,6 +68,8 @@ export interface SessionPreviewReadResult {
 export interface SessionPreviewListResult {
     previews: SessionPreview[];
     diagnostics: SessionProviderDiagnostic[];
+    /** True when more candidates existed than `limit` allowed; the caller may offer a larger limit. */
+    hasMore: boolean;
 }
 /**
  * Reads a bounded preview of one session file. Returns `null` when the file is

package/dist/sessionPreviews.js

@@ -57,6 +57,9 @@ exports.readSessionPreviewAsync = readSessionPreviewAsync;
 exports.listSessionPreviews = listSessionPreviews;
 exports.listSessionPreviewsAsync = listSessionPreviewsAsync;
 const fs = __importStar(require("fs"));
+function emptyPrefixScan() {
+    return { firstTimestamp: null, workspacePath: null };
+}
 const DEFAULT_PREFIX_BYTES = 16 * 1024;
 const DEFAULT_LIMIT = 50;
 const DEFAULT_CONCURRENCY = 4;
@@ -108,7 +111,8 @@ function readSessionPreview(provider, sessionPath, options = {}) {
     catch {
         // A provider that cannot identify the file still yields a usable preview.
     }
-    const prefix = scanPrefix(sessionPath, options.maxPrefixBytes ?? DEFAULT_PREFIX_BYTES);
+    const prefixBudget = options.maxPrefixBytes ?? DEFAULT_PREFIX_BYTES;
+    const prefix = prefixBudget > 0 ? scanPrefix(sessionPath, prefixBudget) : emptyPrefixScan();
     return {
         provider: provider.id,
         sessionId,
@@ -238,6 +242,7 @@ async function listSessionPreviewsAsync(providers, options = {}) {
     }, concurrency(options));
     return {
         previews: previews.filter((preview) => preview !== null),
+        hasMore: candidates.length > limit,
         diagnostics: dedupeDiagnostics([
             ...operationDiagnostics,
             ...providers.flatMap(providerDiagnostics),
@@ -248,7 +253,13 @@ function resolveSinceMs(since) {
     if (since === undefined)
         return null;
     const ms = since instanceof Date ? since.getTime() : Date.parse(since);
-    return Number.isFinite(ms) ? ms : null;
+    if (!Number.isFinite(ms)) {
+        // An unparseable cutoff used to mean "no cutoff", silently returning
+        // every session. Fail loudly instead so a typo cannot masquerade as a
+        // full listing.
+        throw new RangeError(`Invalid \`since\` value: ${String(since)}`);
+    }
+    return ms;
 }
 function enumerateSessionFiles(provider, workspacePath) {
     try {
@@ -359,7 +370,8 @@ async function readSessionPreviewFromInfoAsync(provider, info, firstUserPrompt,
     catch {
         return null;
     }
-    const prefix = await scanPrefixAsync(info.path, options.maxPrefixBytes ?? DEFAULT_PREFIX_BYTES);
+    const prefixBudget = options.maxPrefixBytes ?? DEFAULT_PREFIX_BYTES;
+    const prefix = prefixBudget > 0 ? await scanPrefixAsync(info.path, prefixBudget) : emptyPrefixScan();
     return {
         provider: provider.id,
         sessionId: info.sessionId ?? safeSessionId(provider, info.path),

package/dist/sessionStats.d.ts

@@ -0,0 +1,51 @@
+/**
+ * One `readSessionStats()` implementation for every session provider.
+ *
+ * Claude Code, Codex, and OpenCode used to compute session stats three
+ * different ways (a hand-rolled JSONL scan, an aggregator drain, and a direct
+ * SQLite read with hardcoded zeros). Every provider now drains its reader once
+ * into the shared `EventAggregator`, so per-model totals use the
+ * cache-inclusive vocabulary, cost carries provenance, tool failures are
+ * split out, and compaction and truncation counts are real for all three.
+ */
+import type { EventAggregatorOptions } from './aggregation/types';
+import type { ProviderId, SessionFileStats, SessionFileStatsAvailability, SessionProviderBase } from './providers/types';
+import type { SessionEvent } from './types/sessionEvent';
+export interface ComputeSessionFileStatsOptions {
+    providerId: ProviderId;
+    sessionId: string;
+    filePath: string;
+    /** Label to use; derived from the first user prompt when omitted or null. */
+    label?: string | null;
+    /** Provider-specific context formula, forwarded to the aggregator. */
+    computeContextSize?: EventAggregatorOptions['computeContextSize'];
+    /** Defaults to `full`. */
+    availability?: SessionFileStatsAvailability;
+    unavailableReason?: string;
+}
+export interface ReadSessionFileStatsOptions {
+    /**
+     * Cheap label source consulted before the events (for example a SQLite
+     * thread title). Return null to fall back to the first user prompt.
+     */
+    resolveLabel?: () => string | null;
+}
+/**
+ * First user prompt in a session, compacted to one line and truncated the
+ * way every provider's `extractSessionLabel()` truncates (60 characters).
+ */
+export declare function firstUserPrompt(events: readonly SessionEvent[], maxLength?: number): string | null;
+/** Compute stats for an already-read event array through the shared aggregator. */
+export declare function computeSessionFileStats(events: readonly SessionEvent[], options: ComputeSessionFileStatsOptions): SessionFileStats;
+/** The aggregator's context-size hook for a provider, or undefined for the default formula. */
+export declare function providerContextSizeFn(provider: SessionProviderBase): EventAggregatorOptions['computeContextSize'];
+/**
+ * Read a session once through the provider's reader and compute its stats.
+ *
+ * The reader is drained with `readAll()` and then `flush()`ed so a final line
+ * without a trailing newline is included, and it is never opened a second
+ * time for the label. A source that cannot be read yields
+ * `availability: 'unavailable'` with a reason instead of silent zeros; a
+ * reader that reports truncation yields `partial`.
+ */
+export declare function readSessionFileStats(provider: SessionProviderBase, sessionPath: string, options?: ReadSessionFileStatsOptions): SessionFileStats;