@agents-ensemble/core 0.12.0 → 0.13.0

package/dist/usage/types.d.ts

@@ -31,6 +31,19 @@ export interface SessionUsageAgentTotals {
     roundsWithUsage: number;
     tokens: LlmTokenCounts | null;
 }
+export interface SessionUsageCacheStats {
+    /** Input-token cache hits divided by input tokens plus cache hits (0–1). */
+    cacheHitRate?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+export interface SessionUsageCacheSummary {
+    totals: SessionUsageCacheStats;
+    byAgent: {
+        conductor: SessionUsageCacheStats | null;
+        workers: Record<string, SessionUsageCacheStats | null>;
+    };
+}
 export interface SessionContextUtilization {
     limit: number | null;
     /** limit 算出に使った累計 input tokens。limit 不明時も参考値として返す。 */
@@ -38,7 +51,18 @@ export interface SessionContextUtilization {
     percent: number | null;
     limitUnavailableReason?: string;
 }
+/** Reported conductor billing only; worker charges are not included. */
+export interface SessionUsageCost extends ConductorUsageCost {
+    /** Present on runtime-enriched summaries; optional for source compatibility. */
+    scope?: 'conductor-only';
+}
+export type SessionUsageTokenScope = 'recorded-usage-only';
 export interface SessionUsageSummary {
+    /**
+     * Totals include recorded usage only; failed rounds without usage are absent.
+     * Runtime tracker summaries always set this field.
+     */
+    tokenScope?: SessionUsageTokenScope;
     totals: {
         rounds: number;
         roundsWithUsage: number;
@@ -50,7 +74,11 @@ export interface SessionUsageSummary {
     };
     context: SessionContextUtilization;
     latestRound: SessionUsageRound | null;
-    /** conductor `getUsage().cost`（セッション累計。未取得時は省略）。 */
-    cost?: ConductorUsageCost;
+    /** Cache-derived metrics. Omitted when no round reported cache counters. */
+    cacheStats?: SessionUsageCacheSummary;
+    /** Successful context compactions, when the selected backend has a reliable counter. */
+    compactionCount?: number;
+    /** Conductor の請求記録（worker 分を含まない。推定値・未取得時は省略）。 */
+    cost?: SessionUsageCost;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/usage/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/usage/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;AAEzD,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,qBAAqB,CAAC;IACjC,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;KAC/B,CAAC;IACF,OAAO,EAAE;QACP,SAAS,EAAE,uBAAuB,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;KAClD,CAAC;IACF,OAAO,EAAE,yBAAyB,CAAC;IACnC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,oDAAoD;IACpD,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/usage/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-ensemble/core",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "type": "module",
   "description": "Core types and orchestration logic for agents-ensemble",
   "main": "dist/index.js",
@@ -13,6 +13,10 @@
     "./testing": {
       "types": "./dist/testing/index.d.ts",
       "import": "./dist/testing/index.js"
+    },
+    "./operator-runtime": {
+      "types": "./dist/operator-runtime.d.ts",
+      "import": "./dist/operator-runtime.js"
     }
   },
   "license": "MIT",