@heripo/model 0.1.45 → 0.1.46

package/README.ko.md

@@ -307,15 +307,23 @@ interface ModelUsageDetail {
   inputTokens: number; // 입력 토큰 수
   outputTokens: number; // 출력 토큰 수
   totalTokens: number; // 전체 토큰 수
+  cachedInputTokens?: number | null; // 캐시 읽기 토큰
+  cacheWriteTokens?: number | null; // 기본 기간 캐시 쓰기 토큰
+  cacheWrite1hTokens?: number | null; // 1시간 캐시 쓰기 토큰
 }
 
 interface TokenUsageSummary {
   inputTokens: number; // 입력 토큰 수
   outputTokens: number; // 출력 토큰 수
   totalTokens: number; // 전체 토큰 수
+  cachedInputTokens?: number | null; // 합산된 캐시 읽기 토큰
+  cacheWriteTokens?: number | null; // 합산된 기본 기간 캐시 쓰기 토큰
+  cacheWrite1hTokens?: number | null; // 합산된 1시간 캐시 쓰기 토큰
 }
 ```
 
+캐시 토큰은 `inputTokens`에 포함된 부분집합이며 추가 토큰이 아닙니다. 필드가 없거나 `null`이면 제공자가 완전한 값을 보고하지 않은 것이고, `0`은 사용량이 없다고 보고한 값입니다.
+
 ### Review Assistance 타입
 
 `correction.reviewAssistanceEnabled: true`일 때(파서 기본값) 생성하는 별도 감사 리포트입니다. `ProcessedDocument` 안에 포함되지 않습니다. [전체 타입 정의](./src/types/review-assistance.ts)는 명령, 근거, 이슈, 실행 추적 및 진행 이벤트를 제공합니다.

package/README.md

@@ -308,15 +308,23 @@ interface ModelUsageDetail {
   inputTokens: number; // Input token count
   outputTokens: number; // Output token count
   totalTokens: number; // Total token count
+  cachedInputTokens?: number | null; // Cache reads
+  cacheWriteTokens?: number | null; // Default-duration cache writes
+  cacheWrite1hTokens?: number | null; // One-hour cache writes
 }
 
 interface TokenUsageSummary {
   inputTokens: number; // Input token count
   outputTokens: number; // Output token count
   totalTokens: number; // Total token count
+  cachedInputTokens?: number | null; // Cache reads across contributing calls
+  cacheWriteTokens?: number | null; // Default-duration cache writes
+  cacheWrite1hTokens?: number | null; // One-hour cache writes
 }
 ```
 
+Cache counts are subsets of `inputTokens`, not additional tokens. Missing fields or `null` mean the provider did not report a complete count; `0` means it reported zero.
+
 ### Review Assistance Types
 
 A separate audit report is produced when `correction.reviewAssistanceEnabled` is true (the parser default). It is not embedded in `ProcessedDocument`. The [complete type definitions](./src/types/review-assistance.ts) cover commands, evidence, issues, call traces and progress events.

package/dist/index.d.cts

@@ -774,6 +774,12 @@ interface ModelUsageDetail {
      * Always equals inputTokens + outputTokens.
      */
     totalTokens: number;
+    /** Cached input tokens reported by the provider; null means unreported. */
+    cachedInputTokens?: number | null;
+    /** Cache creation tokens at the default duration; null means unreported. */
+    cacheWriteTokens?: number | null;
+    /** Cache creation tokens at the one-hour duration; null means unreported. */
+    cacheWrite1hTokens?: number | null;
 }
 /**
  * Summary of token usage
@@ -793,6 +799,12 @@ interface TokenUsageSummary {
      * Total tokens (input + output)
      */
     totalTokens: number;
+    /** Cached input tokens, when reported for every contributing call. */
+    cachedInputTokens?: number | null;
+    /** Default-duration cache writes, when reported for every contributing call. */
+    cacheWriteTokens?: number | null;
+    /** One-hour cache writes, when reported for every contributing call. */
+    cacheWrite1hTokens?: number | null;
 }
 type TokenUsageMetadataValue = string | number | boolean | null;
 type TokenUsageMetadata = Record<string, TokenUsageMetadataValue>;

package/dist/index.d.ts

@@ -774,6 +774,12 @@ interface ModelUsageDetail {
      * Always equals inputTokens + outputTokens.
      */
     totalTokens: number;
+    /** Cached input tokens reported by the provider; null means unreported. */
+    cachedInputTokens?: number | null;
+    /** Cache creation tokens at the default duration; null means unreported. */
+    cacheWriteTokens?: number | null;
+    /** Cache creation tokens at the one-hour duration; null means unreported. */
+    cacheWrite1hTokens?: number | null;
 }
 /**
  * Summary of token usage
@@ -793,6 +799,12 @@ interface TokenUsageSummary {
      * Total tokens (input + output)
      */
     totalTokens: number;
+    /** Cached input tokens, when reported for every contributing call. */
+    cachedInputTokens?: number | null;
+    /** Default-duration cache writes, when reported for every contributing call. */
+    cacheWriteTokens?: number | null;
+    /** One-hour cache writes, when reported for every contributing call. */
+    cacheWrite1hTokens?: number | null;
 }
 type TokenUsageMetadataValue = string | number | boolean | null;
 type TokenUsageMetadata = Record<string, TokenUsageMetadataValue>;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@heripo/model",
   "private": false,
   "type": "module",
-  "version": "0.1.45",
+  "version": "0.1.46",
   "description": "Document models and type definitions for heripo engine",
   "main": "dist/index.cjs",
   "module": "dist/index.js",