@qilin-agent/usage-local 3.1.7 → 3.1.8

package/lib/index.js

@@ -44,6 +44,7 @@ function collectSessionUsage(sessionId, events) {
 * @param records - the ledger's records.
 * @param from - inclusive window start in epoch milliseconds.
 * @param to - inclusive window end in epoch milliseconds, or undefined for no end.
+* @returns the records whose `at` falls inside the window, in ledger order.
 */
 function withinWindow(records, from, to) {
 	return records.filter((record) => record.at >= from && (to === void 0 || record.at <= to));
@@ -52,6 +53,7 @@ function withinWindow(records, from, to) {
 * Total the whole ledger: every Turn, the distinct sessions they belong to, and
 * the prompt cache hit rate.
 * @param records - the ledger's records.
+* @returns the aggregate: turn count, distinct sessions, token sums, and cache hit rate.
 */
 function totalOf(records) {
 	const sessions = new Set(records.map((record) => record.sessionId));
@@ -80,6 +82,7 @@ function totalOf(records) {
 * @param accountId - account the ledger names for display.
 * @param all - every Turn this runtime's logs prove.
 * @param windowed - the Turns inside the requested window.
+* @returns the page answer: account display, total over `all`, and windowed records sorted by time.
 */
 function usageAnswer(accountId, all, windowed) {
 	return {

package/lib/types/usage.d.ts

@@ -56,12 +56,14 @@ export declare function collectSessionUsage(sessionId: string, events: readonly
  * @param records - the ledger's records.
  * @param from - inclusive window start in epoch milliseconds.
  * @param to - inclusive window end in epoch milliseconds, or undefined for no end.
+ * @returns the records whose `at` falls inside the window, in ledger order.
  */
 export declare function withinWindow(records: readonly LocalUsageRecord[], from: number, to?: number): readonly LocalUsageRecord[];
 /**
  * Total the whole ledger: every Turn, the distinct sessions they belong to, and
  * the prompt cache hit rate.
  * @param records - the ledger's records.
+ * @returns the aggregate: turn count, distinct sessions, token sums, and cache hit rate.
  */
 export declare function totalOf(records: readonly LocalUsageRecord[]): LocalUsageTotal;
 /**
@@ -69,6 +71,7 @@ export declare function totalOf(records: readonly LocalUsageRecord[]): LocalUsag
  * @param accountId - account the ledger names for display.
  * @param all - every Turn this runtime's logs prove.
  * @param windowed - the Turns inside the requested window.
+ * @returns the page answer: account display, total over `all`, and windowed records sorted by time.
  */
 export declare function usageAnswer(accountId: string, all: readonly LocalUsageRecord[], windowed: readonly LocalUsageRecord[]): LocalUsageAnswer;
 /** The epoch-milliseconds window one request asked for. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/usage-local",
   "description": "Local usage ledger for single-user surfaces: derives /api/usage/me from this runtime's own session logs with the token-meter derivation",
-  "version": "3.1.7",
+  "version": "3.1.8",
   "publishConfig": {
     "access": "public"
   },
@@ -30,17 +30,17 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.5",
-    "@qilin-agent/client-connection": "3.1.7"
+    "@qilin-agent/kylin": "~4.0.6-alpha.2",
+    "@qilin-agent/client-connection": "3.1.8"
   },
   "dependencies": {
-    "@qilin-agent/token-meter": "3.1.7"
+    "@qilin-agent/token-meter": "3.1.8"
   },
   "devDependencies": {
-    "@qilin-agent/kylin": "~4.0.5",
-    "@qilin-agent/client-connection": "3.1.7",
-    "@qilin-agent/session": "3.1.7",
-    "@qilin-agent/session-query": "3.1.7",
-    "@qilin-agent/session-query-sqlite": "3.1.7"
+    "@qilin-agent/kylin": "~4.0.6-alpha.2",
+    "@qilin-agent/client-connection": "3.1.8",
+    "@qilin-agent/session": "3.1.8",
+    "@qilin-agent/session-query": "3.1.8",
+    "@qilin-agent/session-query-sqlite": "3.1.8"
   }
 }