@warlock.js/ai-panoptic 5.31.0 → 5.32.0

package/llms-full.txt

@@ -677,6 +677,20 @@ for (const trace of store.query({ sessionId })) {
 - The `export-traces` topic — sending traces to an external backend instead of (or alongside) retaining them in memory; writing a custom sink.
 - The `run-ai-agent` topic of the `warlock-js-ai` skill — the `BaseReport` the collector projects into the `Trace` this store retains.
 
+## Hosted-tool rollups
+
+`sumUsage` uses the framework's all-channel `mergeUsage`, so traces retain
+`usage.serverToolUse` and `usage.cost.serverTools` alongside cache lifetime
+counts and mixed-provider cache semantics. Request counts remain absent when
+unreported; unpriced requests do not erase priced siblings.
+
+```ts
+const stats = store.aggregate({ sessionId });
+console.log(stats.usage.serverToolUse?.webSearchRequests);
+console.log(stats.cost?.serverTools?.webSearch); // historical USD
+console.log(totalCost(stats.cost)); // includes hosted fees
+```
+
 
 ## use-local-dashboard  `@warlock.js/ai-panoptic/use-local-dashboard/SKILL.md`
 

package/package.json

@@ -19,9 +19,9 @@
   "peerDependencies": {
     "@opentelemetry/api": "*",
     "@opentelemetry/sdk-trace-base": "*",
-    "@warlock.js/ai": "5.31.0",
-    "@warlock.js/cache": "5.31.0",
-    "@warlock.js/logger": "5.31.0",
+    "@warlock.js/ai": "5.32.0",
+    "@warlock.js/cache": "5.32.0",
+    "@warlock.js/logger": "5.32.0",
     "langfuse": "*"
   },
   "peerDependenciesMeta": {
@@ -41,7 +41,7 @@
   "dependencies": {
     "langfuse": "^3.38.20"
   },
-  "version": "5.31.0",
+  "version": "5.32.0",
   "main": "./cjs/index.cjs",
   "module": "./esm/index.mjs",
   "types": "./esm/index.d.mts",

package/skills/query-traces/SKILL.md

@@ -199,3 +199,17 @@ for (const trace of store.query({ sessionId })) {
 - The `observe-with-panoptic` topic — wiring the `panoptic(...)` subscriber and bring-your-own-collector so the store fills as runs complete.
 - The `export-traces` topic — sending traces to an external backend instead of (or alongside) retaining them in memory; writing a custom sink.
 - The `run-ai-agent` topic of the `warlock-js-ai` skill — the `BaseReport` the collector projects into the `Trace` this store retains.
+
+## Hosted-tool rollups
+
+`sumUsage` uses the framework's all-channel `mergeUsage`, so traces retain
+`usage.serverToolUse` and `usage.cost.serverTools` alongside cache lifetime
+counts and mixed-provider cache semantics. Request counts remain absent when
+unreported; unpriced requests do not erase priced siblings.
+
+```ts
+const stats = store.aggregate({ sessionId });
+console.log(stats.usage.serverToolUse?.webSearchRequests);
+console.log(stats.cost?.serverTools?.webSearch); // historical USD
+console.log(totalCost(stats.cost)); // includes hosted fees
+```