ccusage 15.9.3 → 15.9.5

package/README.md

@@ -106,11 +106,11 @@ Full documentation is available at **[ccusage.com](https://ccusage.com/)**
 
 ### Featured Sponsor
 
-Check out these [47 Claude Code ProTips from Greg Baugues.](https://www.youtube.com/watch?v=TiNpzxoBPz0&lc=UgyVgQyOhfJJlheVMcB4AaABAg)
+Check out [ccusage: The Claude Code cost scorecard that went viral](https://www.youtube.com/watch?v=Ak6qpQ5qdgk)
 
 <p align="center">
-    <a href="https://www.youtube.com/watch?v=TiNpzxoBPz0&lc=UgyVgQyOhfJJlheVMcB4AaABAg">
-        <img src="https://cdn.jsdelivr.net/gh/ryoppippi/ccusage@main/docs/public/claude_code_protips_thumbnail_v1.png" alt="47 Claude Code ProTips from Greg Baugues" width="600">
+    <a href="https://www.youtube.com/watch?v=Ak6qpQ5qdgk">
+        <img src="https://cdn.jsdelivr.net/gh/ryoppippi/ccusage@main/docs/public/ccusage_thumbnail.png" alt="ccusage: The Claude Code cost scorecard that went viral" width="600">
     </a>
 </p>
 

package/dist/calculate-cost.d.ts

@@ -1,5 +1,5 @@
 import "./pricing-fetcher-B5m_kEpz.js";
-import { DailyUsage, MonthlyUsage, SessionUsage, WeeklyUsage } from "./data-loader-B2FL7oh0.js";
+import { DailyUsage, MonthlyUsage, SessionUsage, WeeklyUsage } from "./data-loader-BPepPoPg.js";
 
 //#region src/_token-utils.d.ts
 

package/dist/{data-loader-B2FL7oh0.d.ts → data-loader-BPepPoPg.d.ts}

@@ -62,6 +62,16 @@ type SessionBlock = {
  * @returns Array of valid Claude data directory paths
  */
 declare function getClaudePaths(): string[];
+/**
+ * Get context usage percentage thresholds for color coding
+ * Can be configured via environment variables or uses defaults
+ * Validates and clamps values to 0-100 range and enforces LOW < MEDIUM ordering
+ * @returns Context usage thresholds with LOW and MEDIUM percentages
+ */
+declare function getContextUsageThresholds(): {
+  readonly LOW: number;
+  readonly MEDIUM: number;
+};
 /**
  * Extract project name from Claude JSONL file path
  * @param jsonlPath - Absolute path to JSONL file
@@ -173,6 +183,83 @@ declare const usageDataSchema: z.ZodObject<{
   requestId?: string | undefined;
   isApiErrorMessage?: boolean | undefined;
 }>;
+/**
+ * Zod schema for transcript usage data from Claude messages
+ */
+declare const transcriptUsageSchema: z.ZodObject<{
+  input_tokens: z.ZodOptional<z.ZodNumber>;
+  cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+  cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+  output_tokens: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+  input_tokens?: number | undefined;
+  cache_creation_input_tokens?: number | undefined;
+  cache_read_input_tokens?: number | undefined;
+  output_tokens?: number | undefined;
+}, {
+  input_tokens?: number | undefined;
+  cache_creation_input_tokens?: number | undefined;
+  cache_read_input_tokens?: number | undefined;
+  output_tokens?: number | undefined;
+}>;
+/**
+ * Zod schema for transcript message data
+ */
+declare const transcriptMessageSchema: z.ZodObject<{
+  type: z.ZodOptional<z.ZodString>;
+  message: z.ZodOptional<z.ZodObject<{
+    usage: z.ZodOptional<z.ZodObject<{
+      input_tokens: z.ZodOptional<z.ZodNumber>;
+      cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+      cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+      output_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+      input_tokens?: number | undefined;
+      cache_creation_input_tokens?: number | undefined;
+      cache_read_input_tokens?: number | undefined;
+      output_tokens?: number | undefined;
+    }, {
+      input_tokens?: number | undefined;
+      cache_creation_input_tokens?: number | undefined;
+      cache_read_input_tokens?: number | undefined;
+      output_tokens?: number | undefined;
+    }>>;
+  }, "strip", z.ZodTypeAny, {
+    usage?: {
+      input_tokens?: number | undefined;
+      cache_creation_input_tokens?: number | undefined;
+      cache_read_input_tokens?: number | undefined;
+      output_tokens?: number | undefined;
+    } | undefined;
+  }, {
+    usage?: {
+      input_tokens?: number | undefined;
+      cache_creation_input_tokens?: number | undefined;
+      cache_read_input_tokens?: number | undefined;
+      output_tokens?: number | undefined;
+    } | undefined;
+  }>>;
+}, "strip", z.ZodTypeAny, {
+  type?: string | undefined;
+  message?: {
+    usage?: {
+      input_tokens?: number | undefined;
+      cache_creation_input_tokens?: number | undefined;
+      cache_read_input_tokens?: number | undefined;
+      output_tokens?: number | undefined;
+    } | undefined;
+  } | undefined;
+}, {
+  type?: string | undefined;
+  message?: {
+    usage?: {
+      input_tokens?: number | undefined;
+      cache_creation_input_tokens?: number | undefined;
+      cache_read_input_tokens?: number | undefined;
+      output_tokens?: number | undefined;
+    } | undefined;
+  } | undefined;
+}>;
 /**
  * Type definition for Claude usage data entries from JSONL files
  */
@@ -696,6 +783,17 @@ declare function loadSessionUsageById(sessionId: string, options?: {
   entries: UsageData[];
 } | null>;
 declare function loadBucketUsageData(groupingFn: (data: DailyUsage) => Bucket, options?: LoadOptions): Promise<BucketUsage[]>;
+/**
+ * Calculate context tokens from transcript file using improved JSONL parsing
+ * Based on the Python reference implementation for better accuracy
+ * @param transcriptPath - Path to the transcript JSONL file
+ * @returns Object with context tokens info or null if unavailable
+ */
+declare function calculateContextTokens(transcriptPath: string): Promise<{
+  inputTokens: number;
+  percentage: number;
+  contextLimit: number;
+} | null>;
 /**
  * Loads usage data and organizes it into session blocks (typically 5-hour billing periods)
  * Processes all usage data and groups it into time-based blocks for billing analysis
@@ -704,4 +802,4 @@ declare function loadBucketUsageData(groupingFn: (data: DailyUsage) => Bucket, o
  */
 declare function loadSessionBlockData(options?: LoadOptions): Promise<SessionBlock[]>;
 //#endregion
-export { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema };
+export { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema };

package/dist/{data-loader-B_nfl1Pr.js → data-loader-Plh5X-UR.js}

@@ -1,7 +1,7 @@
-import { CLAUDE_CONFIG_DIR_ENV, CLAUDE_PROJECTS_DIR_NAME, DEFAULT_CLAUDE_CODE_PATH, DEFAULT_CLAUDE_CONFIG_PATH, DEFAULT_RECENT_DAYS, PricingFetcher, USAGE_DATA_GLOB_PATTERN, USER_HOME_DIR, __commonJSMin, __require, __toESM, isFailure, isPromise, require_usingCtx } from "./pricing-fetcher-ZrH9X6Xp.js";
+import { CLAUDE_CONFIG_DIR_ENV, CLAUDE_PROJECTS_DIR_NAME, CONTEXT_LIMIT, CONTEXT_LOW_THRESHOLD_ENV, CONTEXT_MEDIUM_THRESHOLD_ENV, DEFAULT_CLAUDE_CODE_PATH, DEFAULT_CLAUDE_CONFIG_PATH, DEFAULT_CONTEXT_USAGE_THRESHOLDS, DEFAULT_RECENT_DAYS, PricingFetcher, USAGE_DATA_GLOB_PATTERN, USER_HOME_DIR, __commonJSMin, __require, __toESM, isFailure, isPromise, require_usingCtx } from "./pricing-fetcher-CTYPN13Y.js";
 import { getTotalTokens } from "./_token-utils-WjkbrjKv.js";
 import { activityDateSchema, arrayType, booleanType, createBucket, createDailyDate, createMonthlyDate, createProjectPath, createSessionId, createWeeklyDate, dailyDateSchema, isoTimestampSchema, messageIdSchema, modelNameSchema, monthlyDateSchema, numberType, objectType, projectPathSchema, requestIdSchema, sessionIdSchema, stringType, unionType, versionSchema, weeklyDateSchema } from "./_types-C0oFKDO-.js";
-import { logger } from "./logger-L_zzb0iT.js";
+import { logger } from "./logger-dT_AJeHG.js";
 import a, { readFile } from "node:fs/promises";
 import path, { posix } from "node:path";
 import process$1 from "node:process";
@@ -2201,6 +2201,23 @@ function getClaudePaths() {
 - Or set ${CLAUDE_CONFIG_DIR_ENV} environment variable to valid directory path(s) containing a '${CLAUDE_PROJECTS_DIR_NAME}' subdirectory`.trim());
 	return paths;
 }
+function getContextUsageThresholds() {
+	const lowThresholdStr = process$1.env[CONTEXT_LOW_THRESHOLD_ENV], mediumThresholdStr = process$1.env[CONTEXT_MEDIUM_THRESHOLD_ENV];
+	let lowThreshold = DEFAULT_CONTEXT_USAGE_THRESHOLDS.LOW, mediumThreshold = DEFAULT_CONTEXT_USAGE_THRESHOLDS.MEDIUM;
+	if (lowThresholdStr != null) {
+		const parsed = Number.parseInt(lowThresholdStr, 10);
+		if (!Number.isNaN(parsed)) lowThreshold = Math.max(0, Math.min(100, parsed));
+	}
+	if (mediumThresholdStr != null) {
+		const parsed = Number.parseInt(mediumThresholdStr, 10);
+		if (!Number.isNaN(parsed)) mediumThreshold = Math.max(0, Math.min(100, parsed));
+	}
+	if (lowThreshold >= mediumThreshold) lowThreshold = DEFAULT_CONTEXT_USAGE_THRESHOLDS.LOW, mediumThreshold = DEFAULT_CONTEXT_USAGE_THRESHOLDS.MEDIUM;
+	return {
+		LOW: lowThreshold,
+		MEDIUM: mediumThreshold
+	};
+}
 function extractProjectFromPath(jsonlPath) {
 	const normalizedPath = jsonlPath.replace(/[/\\]/g, path.sep), segments = normalizedPath.split(path.sep), projectsIndex = segments.findIndex((segment) => segment === CLAUDE_PROJECTS_DIR_NAME);
 	if (projectsIndex === -1 || projectsIndex + 1 >= segments.length) return "unknown";
@@ -2226,6 +2243,14 @@ const usageDataSchema = objectType({
 	costUSD: numberType().optional(),
 	requestId: requestIdSchema.optional(),
 	isApiErrorMessage: booleanType().optional()
+}), transcriptUsageSchema = objectType({
+	input_tokens: numberType().optional(),
+	cache_creation_input_tokens: numberType().optional(),
+	cache_read_input_tokens: numberType().optional(),
+	output_tokens: numberType().optional()
+}), transcriptMessageSchema = objectType({
+	type: stringType().optional(),
+	message: objectType({ usage: transcriptUsageSchema.optional() }).optional()
 }), modelBreakdownSchema = objectType({
 	modelName: modelNameSchema,
 	inputTokens: numberType(),
@@ -2397,7 +2422,7 @@ function formatDate(dateStr, timezone, locale) {
 	return formatter.format(date);
 }
 function formatDateCompact(dateStr, timezone, locale) {
-	const date = new Date(dateStr), formatter = createDatePartsFormatter(timezone, locale), parts = formatter.formatToParts(date), year = parts.find((p) => p.type === "year")?.value ?? "", month = parts.find((p) => p.type === "month")?.value ?? "", day = parts.find((p) => p.type === "day")?.value ?? "";
+	const parseResult = dailyDateSchema.safeParse(dateStr), date = parseResult.success ? timezone != null ? /* @__PURE__ */ new Date(`${dateStr}T00:00:00Z`) : /* @__PURE__ */ new Date(`${dateStr}T00:00:00`) : new Date(dateStr), formatter = createDatePartsFormatter(timezone, locale), parts = formatter.formatToParts(date), year = parts.find((p) => p.type === "year")?.value ?? "", month = parts.find((p) => p.type === "month")?.value ?? "", day = parts.find((p) => p.type === "day")?.value ?? "";
 	return `${year}\n${month}-${day}`;
 }
 function sortByDate(items, getDate, order = "desc") {
@@ -2644,6 +2669,35 @@ async function loadBucketUsageData(groupingFn, options) {
 	}
 	return sortByDate(buckets, (item) => item.bucket, options?.order);
 }
+async function calculateContextTokens(transcriptPath) {
+	let content;
+	try {
+		content = await readFile(transcriptPath, "utf-8");
+	} catch (error) {
+		return logger.debug(`Failed to read transcript file: ${String(error)}`), null;
+	}
+	const lines = content.split("\n").reverse();
+	for (const line of lines) {
+		const trimmedLine = line.trim();
+		if (trimmedLine === "") continue;
+		try {
+			const parsed = JSON.parse(trimmedLine), result = transcriptMessageSchema.safeParse(parsed);
+			if (!result.success) continue;
+			const obj = result.data;
+			if (obj.type === "assistant" && obj.message != null && obj.message.usage != null && obj.message.usage.input_tokens != null) {
+				const usage = obj.message.usage, inputTokens = usage.input_tokens + (usage.cache_creation_input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0), percentage = Math.min(100, Math.max(0, Math.round(inputTokens / CONTEXT_LIMIT * 100)));
+				return {
+					inputTokens,
+					percentage,
+					contextLimit: CONTEXT_LIMIT
+				};
+			}
+		} catch {
+			continue;
+		}
+	}
+	return logger.debug("No usage information found in transcript"), null;
+}
 async function loadSessionBlockData(options) {
 	try {
 		var _usingCtx5 = (0, import_usingCtx.default)();
@@ -2694,4 +2748,4 @@ async function loadSessionBlockData(options) {
 		_usingCtx5.d();
 	}
 }
-export { DEFAULT_SESSION_DURATION_HOURS, bucketUsageSchema, calculateBurnRate, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, filterRecentBlocks, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, glob, globUsageFiles, identifySessionBlocks, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, projectBlockUsage, sessionUsageSchema, sortFilesByTimestamp, uniq, unwrap, usageDataSchema, weeklyUsageSchema };
+export { DEFAULT_SESSION_DURATION_HOURS, bucketUsageSchema, calculateBurnRate, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, filterRecentBlocks, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, glob, globUsageFiles, identifySessionBlocks, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, projectBlockUsage, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, uniq, unwrap, usageDataSchema, weeklyUsageSchema };

package/dist/data-loader.d.ts

@@ -1,3 +1,3 @@
 import "./pricing-fetcher-B5m_kEpz.js";
-import { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema } from "./data-loader-B2FL7oh0.js";
-export { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema };
+import { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema } from "./data-loader-BPepPoPg.js";
+export { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema };

package/dist/data-loader.js

@@ -1,6 +1,6 @@
-import "./pricing-fetcher-ZrH9X6Xp.js";
+import "./pricing-fetcher-CTYPN13Y.js";
 import "./_token-utils-WjkbrjKv.js";
 import "./_types-C0oFKDO-.js";
-import { bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema } from "./data-loader-B_nfl1Pr.js";
-import "./logger-L_zzb0iT.js";
-export { bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema };
+import { bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema } from "./data-loader-Plh5X-UR.js";
+import "./logger-dT_AJeHG.js";
+export { bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema };

package/dist/{debug-BoSgT8lp.js → debug-C4f2zPfQ.js}

@@ -1,6 +1,6 @@
-import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-ZrH9X6Xp.js";
-import { getClaudePaths, glob, unwrap, usageDataSchema } from "./data-loader-B_nfl1Pr.js";
-import { logger } from "./logger-L_zzb0iT.js";
+import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-CTYPN13Y.js";
+import { getClaudePaths, glob, unwrap, usageDataSchema } from "./data-loader-Plh5X-UR.js";
+import { logger } from "./logger-dT_AJeHG.js";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 var import_usingCtx = /* @__PURE__ */ __toESM(require_usingCtx(), 1);

package/dist/debug.js

@@ -1,7 +1,7 @@
-import "./pricing-fetcher-ZrH9X6Xp.js";
+import "./pricing-fetcher-CTYPN13Y.js";
 import "./_token-utils-WjkbrjKv.js";
 import "./_types-C0oFKDO-.js";
-import "./data-loader-B_nfl1Pr.js";
-import "./logger-L_zzb0iT.js";
-import { detectMismatches, printMismatchReport } from "./debug-BoSgT8lp.js";
+import "./data-loader-Plh5X-UR.js";
+import "./logger-dT_AJeHG.js";
+import { detectMismatches, printMismatchReport } from "./debug-C4f2zPfQ.js";
 export { detectMismatches, printMismatchReport };

package/dist/index.d.ts

@@ -1 +1,2 @@
-export { };
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { BLOCKS_COMPACT_WIDTH_THRESHOLD, BLOCKS_DEFAULT_TERMINAL_WIDTH, BLOCKS_WARNING_THRESHOLD, BURN_RATE_THRESHOLDS, DEFAULT_RECENT_DAYS, DEFAULT_REFRESH_INTERVAL_SECONDS, MAX_REFRESH_INTERVAL_SECONDS, MCP_DEFAULT_PORT, MIN_REFRESH_INTERVAL_SECONDS, MIN_RENDER_INTERVAL_MS, PROJECT_ALIASES_ENV, PricingFetcher, WEEK_DAYS, __commonJSMin, __require, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-ZrH9X6Xp.js";
+import { BLOCKS_COMPACT_WIDTH_THRESHOLD, BLOCKS_DEFAULT_TERMINAL_WIDTH, BLOCKS_WARNING_THRESHOLD, BURN_RATE_THRESHOLDS, DEFAULT_RECENT_DAYS, DEFAULT_REFRESH_INTERVAL_SECONDS, MAX_REFRESH_INTERVAL_SECONDS, MCP_DEFAULT_PORT, MIN_REFRESH_INTERVAL_SECONDS, MIN_RENDER_INTERVAL_MS, PROJECT_ALIASES_ENV, PricingFetcher, WEEK_DAYS, __commonJSMin, __require, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-CTYPN13Y.js";
 import { getTotalTokens } from "./_token-utils-WjkbrjKv.js";
 import { CostModes, SortOrders, filterDateSchema, statuslineHookJsonSchema } from "./_types-C0oFKDO-.js";
 import { calculateTotals, createTotalsObject } from "./calculate-cost-BDqO4yWA.js";
-import { DEFAULT_SESSION_DURATION_HOURS, calculateBurnRate, calculateCostForEntry, createUniqueHash, filterRecentBlocks, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, identifySessionBlocks, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, projectBlockUsage, sortFilesByTimestamp, uniq, usageDataSchema } from "./data-loader-B_nfl1Pr.js";
-import { description, log, logger, name, version } from "./logger-L_zzb0iT.js";
-import { detectMismatches, printMismatchReport } from "./debug-BoSgT8lp.js";
-import { createMcpHttpApp, createMcpServer, startMcpServerStdio } from "./mcp-Bqi6ayed.js";
+import { DEFAULT_SESSION_DURATION_HOURS, calculateBurnRate, calculateContextTokens, calculateCostForEntry, createUniqueHash, filterRecentBlocks, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, identifySessionBlocks, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, projectBlockUsage, sortFilesByTimestamp, uniq, usageDataSchema } from "./data-loader-Plh5X-UR.js";
+import { description, log, logger, name, version } from "./logger-dT_AJeHG.js";
+import { detectMismatches, printMismatchReport } from "./debug-C4f2zPfQ.js";
+import { createMcpHttpApp, createMcpServer, startMcpServerStdio } from "./mcp-DfY3l9w7.js";
 import a, { readFile } from "node:fs/promises";
 import path from "node:path";
 import process$1 from "node:process";
@@ -815,7 +815,7 @@ var require_picocolors = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		};
 	};
 	module.exports = createColors(), module.exports.createColors = createColors;
-}));
+})), import_picocolors$8 = /* @__PURE__ */ __toESM(require_picocolors(), 1);
 const getContext = (raw) => ({
 	start: process$1.hrtime.bigint(),
 	command: raw.map((part) => getCommandPart(stripVTControlCharacters(part))).join(" "),
@@ -2320,7 +2320,7 @@ var require_debug$1 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = Table$1;
 })), require_cli_table3 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	module.exports = require_table();
-}));
+})), import_cli_table3 = /* @__PURE__ */ __toESM(require_cli_table3(), 1);
 function ansiRegex({ onlyFirst = false } = {}) {
 	const ST = "(?:\\u0007|\\u001B\\u005C|\\u009C)", pattern = [`[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?${ST})`, "(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]))"].join("|");
 	return new RegExp(pattern, onlyFirst ? void 0 : "g");
@@ -2369,7 +2369,7 @@ function stringWidth(string, options = {}) {
 	}
 	return width;
 }
-var import_cli_table3 = /* @__PURE__ */ __toESM(require_cli_table3(), 1), import_picocolors$8 = /* @__PURE__ */ __toESM(require_picocolors(), 1), ResponsiveTable = class {
+var ResponsiveTable = class {
 	head;
 	rows = [];
 	colAligns;
@@ -3963,14 +3963,105 @@ const monthlyCommand = define({
 		}
 	}
 });
+async function handleSessionIdLookup(ctx, useJson) {
+	const sessionUsage = await loadSessionUsageById(ctx.values.id, {
+		mode: ctx.values.mode,
+		offline: ctx.values.offline
+	});
+	if (sessionUsage == null) {
+		if (useJson) log(JSON.stringify(null));
+		else logger.warn(`No session found with ID: ${ctx.values.id}`);
+		process$1.exit(0);
+	}
+	if (useJson) {
+		const jsonOutput = {
+			sessionId: ctx.values.id,
+			totalCost: sessionUsage.totalCost,
+			totalTokens: calculateSessionTotalTokens(sessionUsage.entries),
+			entries: sessionUsage.entries.map((entry) => ({
+				timestamp: entry.timestamp,
+				inputTokens: entry.message.usage.input_tokens,
+				outputTokens: entry.message.usage.output_tokens,
+				cacheCreationTokens: entry.message.usage.cache_creation_input_tokens ?? 0,
+				cacheReadTokens: entry.message.usage.cache_read_input_tokens ?? 0,
+				model: entry.message.model ?? "unknown",
+				costUSD: entry.costUSD ?? 0
+			}))
+		};
+		if (ctx.values.jq != null) {
+			const jqResult = await processWithJq(jsonOutput, ctx.values.jq);
+			if (isFailure(jqResult)) logger.error(jqResult.error.message), process$1.exit(1);
+			log(jqResult.value);
+		} else log(JSON.stringify(jsonOutput, null, 2));
+	} else {
+		logger.box(`Claude Code Session Usage - ${ctx.values.id}`);
+		const totalTokens = calculateSessionTotalTokens(sessionUsage.entries);
+		if (log(`Total Cost: ${formatCurrency(sessionUsage.totalCost)}`), log(`Total Tokens: ${formatNumber(totalTokens)}`), log(`Total Entries: ${sessionUsage.entries.length}`), log(""), sessionUsage.entries.length > 0) {
+			const table = new ResponsiveTable({
+				head: [
+					"Timestamp",
+					"Model",
+					"Input",
+					"Output",
+					"Cache Create",
+					"Cache Read",
+					"Cost (USD)"
+				],
+				style: { head: ["cyan"] },
+				colAligns: [
+					"left",
+					"left",
+					"right",
+					"right",
+					"right",
+					"right",
+					"right"
+				]
+			});
+			for (const entry of sessionUsage.entries) table.push([
+				formatDateCompact(entry.timestamp, ctx.values.timezone, ctx.values.locale),
+				entry.message.model ?? "unknown",
+				formatNumber(entry.message.usage.input_tokens),
+				formatNumber(entry.message.usage.output_tokens),
+				formatNumber(entry.message.usage.cache_creation_input_tokens ?? 0),
+				formatNumber(entry.message.usage.cache_read_input_tokens ?? 0),
+				formatCurrency(entry.costUSD ?? 0)
+			]);
+			log(table.toString());
+		}
+	}
+}
+function calculateSessionTotalTokens(entries) {
+	return entries.reduce((sum, entry) => {
+		const usage = entry.message.usage;
+		return sum + usage.input_tokens + usage.output_tokens + (usage.cache_creation_input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0);
+	}, 0);
+}
 var import_picocolors$2 = /* @__PURE__ */ __toESM(require_picocolors(), 1);
 const sessionCommand = define({
 	name: "session",
 	description: "Show usage report grouped by conversation session",
 	...sharedCommandConfig,
+	args: {
+		...sharedCommandConfig.args,
+		id: {
+			type: "string",
+			short: "i",
+			description: "Load usage data for a specific session ID"
+		}
+	},
+	toKebab: true,
 	async run(ctx) {
 		const useJson = ctx.values.json || ctx.values.jq != null;
 		if (useJson) logger.level = 0;
+		if (ctx.values.id != null) return handleSessionIdLookup({ values: {
+			id: ctx.values.id,
+			mode: ctx.values.mode,
+			offline: ctx.values.offline,
+			jq: ctx.values.jq,
+			timezone: ctx.values.timezone,
+			locale: ctx.values.locale ?? "en-CA"
+		} }, useJson);
 		const sessionData = await loadSessionData({
 			since: ctx.values.since,
 			until: ctx.values.until,
@@ -4185,7 +4276,17 @@ const statuslineCommand = define({
 		} catch (error) {
 			logger.error("Failed to load block data:", error), blockInfo = "No active block";
 		}
-		const modelName = hookData.model.display_name, sessionDisplay = sessionCost !== null ? formatCurrency(sessionCost) : "N/A", statusLine = `🤖 ${modelName} | 💰 ${sessionDisplay} session / ${formatCurrency(todayCost)} today / ${blockInfo}${burnRateInfo}`;
+		let contextInfo = "";
+		try {
+			const contextData = await calculateContextTokens(hookData.transcript_path);
+			if (contextData != null) {
+				const p$1 = contextData.percentage, thresholds = getContextUsageThresholds(), color = p$1 < thresholds.LOW ? import_picocolors$1.default.green : p$1 < thresholds.MEDIUM ? import_picocolors$1.default.yellow : import_picocolors$1.default.red, coloredPercentage = color(`${p$1}%`), tokenDisplay = contextData.inputTokens.toLocaleString();
+				contextInfo = ` | 🧠 ${tokenDisplay} (${coloredPercentage})`;
+			}
+		} catch (error) {
+			logger.debug(`Failed to calculate context tokens: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		const modelName = hookData.model.display_name, sessionDisplay = sessionCost !== null ? formatCurrency(sessionCost) : "N/A", statusLine = `🤖 ${modelName} | 💰 ${sessionDisplay} session / ${formatCurrency(todayCost)} today / ${blockInfo}${burnRateInfo}${contextInfo}`;
 		log(statusLine);
 	}
 });
@@ -4341,3 +4442,4 @@ await cli(process$1.argv.slice(2), mainCommand, {
 	subCommands,
 	renderHeader: null
 });
+export {};

package/dist/{logger-L_zzb0iT.js → logger-dT_AJeHG.js}

@@ -761,7 +761,7 @@ function _getDefaultLogLevel() {
 	return g ? LogLevels.debug : R ? LogLevels.warn : LogLevels.info;
 }
 const consola = createConsola$1();
-var name = "ccusage", version = "15.9.3", description = "Usage analysis tool for Claude Code";
+var name = "ccusage", version = "15.9.5", description = "Usage analysis tool for Claude Code";
 const logger = consola.withTag(name);
 if (process$1.env.LOG_LEVEL != null) {
 	const level = Number.parseInt(process$1.env.LOG_LEVEL, 10);

package/dist/logger.js

@@ -1,2 +1,2 @@
-import { log, logger } from "./logger-L_zzb0iT.js";
+import { log, logger } from "./logger-dT_AJeHG.js";
 export { log, logger };

package/dist/{mcp-Bqi6ayed.js → mcp-DfY3l9w7.js}

@@ -1,9 +1,9 @@
-import { __commonJSMin, __toESM, require_usingCtx } from "./pricing-fetcher-ZrH9X6Xp.js";
+import { __commonJSMin, __toESM, require_usingCtx } from "./pricing-fetcher-CTYPN13Y.js";
 import { getTotalTokens } from "./_token-utils-WjkbrjKv.js";
 import { ZodFirstPartyTypeKind, ZodOptional, ZodType, arrayType, booleanType, discriminatedUnionType, enumType, filterDateSchema, literalType, numberType, objectType, optionalType, recordType, stringType, unionType, unknownType } from "./_types-C0oFKDO-.js";
 import { calculateTotals, createTotalsObject } from "./calculate-cost-BDqO4yWA.js";
-import { getClaudePaths, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData } from "./data-loader-B_nfl1Pr.js";
-import { name, version } from "./logger-L_zzb0iT.js";
+import { getClaudePaths, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData } from "./data-loader-Plh5X-UR.js";
+import { name, version } from "./logger-dT_AJeHG.js";
 import process from "node:process";
 const LATEST_PROTOCOL_VERSION = "2025-06-18", SUPPORTED_PROTOCOL_VERSIONS = [
 	LATEST_PROTOCOL_VERSION,

package/dist/mcp.d.ts

@@ -1,5 +1,5 @@
 import "./pricing-fetcher-B5m_kEpz.js";
-import { LoadOptions } from "./data-loader-B2FL7oh0.js";
+import { LoadOptions } from "./data-loader-BPepPoPg.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { Hono } from "hono/tiny";
 

package/dist/mcp.js

@@ -1,8 +1,8 @@
-import "./pricing-fetcher-ZrH9X6Xp.js";
+import "./pricing-fetcher-CTYPN13Y.js";
 import "./_token-utils-WjkbrjKv.js";
 import "./_types-C0oFKDO-.js";
 import "./calculate-cost-BDqO4yWA.js";
-import "./data-loader-B_nfl1Pr.js";
-import "./logger-L_zzb0iT.js";
-import { createMcpHttpApp, createMcpServer, startMcpServerStdio } from "./mcp-Bqi6ayed.js";
+import "./data-loader-Plh5X-UR.js";
+import "./logger-dT_AJeHG.js";
+import { createMcpHttpApp, createMcpServer, startMcpServerStdio } from "./mcp-DfY3l9w7.js";
 export { createMcpHttpApp, createMcpServer, startMcpServerStdio };

package/dist/{pricing-fetcher-ZrH9X6Xp.js → pricing-fetcher-CTYPN13Y.js}

@@ -1,5 +1,5 @@
 import { modelPricingSchema } from "./_types-C0oFKDO-.js";
-import { logger } from "./logger-L_zzb0iT.js";
+import { logger } from "./logger-dT_AJeHG.js";
 import { createRequire } from "node:module";
 import path from "node:path";
 import F, { homedir } from "node:os";
@@ -94,7 +94,10 @@ if (xdgConfig) xdgConfigDirectories.unshift(xdgConfig);
 const LITELLM_PRICING_URL = "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json", DEFAULT_RECENT_DAYS = 3, BLOCKS_WARNING_THRESHOLD = .8, BLOCKS_COMPACT_WIDTH_THRESHOLD = 120, BLOCKS_DEFAULT_TERMINAL_WIDTH = 120, DEBUG_MATCH_THRESHOLD_PERCENT = .1, USER_HOME_DIR = homedir(), XDG_CONFIG_DIR = xdgConfig ?? `${USER_HOME_DIR}/.config`, DEFAULT_CLAUDE_CODE_PATH = ".claude", DEFAULT_CLAUDE_CONFIG_PATH = `${XDG_CONFIG_DIR}/claude`, CLAUDE_CONFIG_DIR_ENV = "CLAUDE_CONFIG_DIR", PROJECT_ALIASES_ENV = "CCUSAGE_PROJECT_ALIASES", CLAUDE_PROJECTS_DIR_NAME = "projects", USAGE_DATA_GLOB_PATTERN = "**/*.jsonl", MCP_DEFAULT_PORT = 8080, DEFAULT_REFRESH_INTERVAL_SECONDS = 1, MIN_REFRESH_INTERVAL_SECONDS = 1, MAX_REFRESH_INTERVAL_SECONDS = 60, MIN_RENDER_INTERVAL_MS = 16, BURN_RATE_THRESHOLDS = {
 	HIGH: 1e3,
 	MODERATE: 500
-}, WEEK_DAYS = [
+}, CONTEXT_LIMIT = 2e5, DEFAULT_CONTEXT_USAGE_THRESHOLDS = {
+	LOW: 50,
+	MEDIUM: 80
+}, CONTEXT_LOW_THRESHOLD_ENV = "CCUSAGE_CONTEXT_LOW_THRESHOLD", CONTEXT_MEDIUM_THRESHOLD_ENV = "CCUSAGE_CONTEXT_MEDIUM_THRESHOLD", WEEK_DAYS = [
 	"sunday",
 	"monday",
 	"tuesday",
@@ -339,4 +342,4 @@ var require_usingCtx = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		return cost;
 	}
 };
-export { BLOCKS_COMPACT_WIDTH_THRESHOLD, BLOCKS_DEFAULT_TERMINAL_WIDTH, BLOCKS_WARNING_THRESHOLD, BURN_RATE_THRESHOLDS, CLAUDE_CONFIG_DIR_ENV, CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, DEFAULT_CLAUDE_CODE_PATH, DEFAULT_CLAUDE_CONFIG_PATH, DEFAULT_RECENT_DAYS, DEFAULT_REFRESH_INTERVAL_SECONDS, MAX_REFRESH_INTERVAL_SECONDS, MCP_DEFAULT_PORT, MIN_REFRESH_INTERVAL_SECONDS, MIN_RENDER_INTERVAL_MS, PROJECT_ALIASES_ENV, PricingFetcher, USAGE_DATA_GLOB_PATTERN, USER_HOME_DIR, WEEK_DAYS, __commonJSMin, __require, __toESM, isFailure, isPromise, require_usingCtx, try_ };
+export { BLOCKS_COMPACT_WIDTH_THRESHOLD, BLOCKS_DEFAULT_TERMINAL_WIDTH, BLOCKS_WARNING_THRESHOLD, BURN_RATE_THRESHOLDS, CLAUDE_CONFIG_DIR_ENV, CLAUDE_PROJECTS_DIR_NAME, CONTEXT_LIMIT, CONTEXT_LOW_THRESHOLD_ENV, CONTEXT_MEDIUM_THRESHOLD_ENV, DEBUG_MATCH_THRESHOLD_PERCENT, DEFAULT_CLAUDE_CODE_PATH, DEFAULT_CLAUDE_CONFIG_PATH, DEFAULT_CONTEXT_USAGE_THRESHOLDS, DEFAULT_RECENT_DAYS, DEFAULT_REFRESH_INTERVAL_SECONDS, MAX_REFRESH_INTERVAL_SECONDS, MCP_DEFAULT_PORT, MIN_REFRESH_INTERVAL_SECONDS, MIN_RENDER_INTERVAL_MS, PROJECT_ALIASES_ENV, PricingFetcher, USAGE_DATA_GLOB_PATTERN, USER_HOME_DIR, WEEK_DAYS, __commonJSMin, __require, __toESM, isFailure, isPromise, require_usingCtx, try_ };

package/dist/pricing-fetcher.js

@@ -1,4 +1,4 @@
-import { PricingFetcher } from "./pricing-fetcher-ZrH9X6Xp.js";
+import { PricingFetcher } from "./pricing-fetcher-CTYPN13Y.js";
 import "./_types-C0oFKDO-.js";
-import "./logger-L_zzb0iT.js";
+import "./logger-dT_AJeHG.js";
 export { PricingFetcher };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccusage",
-  "version": "15.9.3",
+  "version": "15.9.5",
   "description": "Usage analysis tool for Claude Code",
   "homepage": "https://github.com/ryoppippi/ccusage#readme",
   "bugs": {