@warlock.js/ai-panoptic 5.32.0 → 5.33.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to `@warlock.js/ai-panoptic` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 5.33.0 - 2026-10-19
+
+### Added
+
+- `subscribeTraces(listener)` and `TraceListener` for process-local adapters observing finalized traces from every built-in collector before exporter dispatch, with isolated listener failures and independent teardown.
+- Optional `Trace.requestId` and exact `TraceQuery.requestId` filters for both in-memory and cache-backed query/aggregate APIs.
+- Content-free retry-attempt timings, provider cache-hit and truncated-trip counts, agent compaction decisions and provider compaction-block counts on trace attributes, surfaced by the devtools AI panel.
+
 ## 5.32.0 - 2026-10-18
 
 ### Changed

package/cjs/index.cjs

@@ -99,7 +99,16 @@ function pickString(value) {
 function extractSpanAttributes(report) {
 	const extensions = report;
 	const attributes = {};
-	if (report.attempts !== void 0 && report.attempts.length > 0) attributes["retries"] = report.attempts.length;
+	if (report.attempts !== void 0 && report.attempts.length > 0) {
+		attributes["retries"] = report.attempts.length;
+		attributes["retry.attempts"] = report.attempts.map((attempt) => ({
+			index: attempt.index,
+			startedAt: attempt.startedAt,
+			endedAt: attempt.endedAt,
+			duration: attempt.duration,
+			status: attempt.status
+		}));
+	}
 	switch (report.type) {
 		case "agent":
 			addAgentAttributes(attributes, extensions);
@@ -120,7 +129,25 @@ function extractSpanAttributes(report) {
 	return attributes;
 }
 function addAgentAttributes(attributes, extensions) {
-	if (Array.isArray(extensions.trips)) attributes["agent.trips"] = extensions.trips.length;
+	if (Array.isArray(extensions.trips)) {
+		attributes["agent.trips"] = extensions.trips.length;
+		if (extensions.trips.some((trip) => trip.usage?.cachedTokens !== void 0)) attributes["agent.cacheHits"] = extensions.trips.filter((trip) => (trip.usage?.cachedTokens ?? 0) > 0).length;
+		const truncatedTrips = extensions.trips.filter((trip) => trip.finishReason === "length" || trip.finishReason === "context_exceeded").length;
+		if (truncatedTrips > 0) attributes["agent.truncatedTrips"] = truncatedTrips;
+		const providerCompactions = extensions.trips.reduce((count, trip) => count + (trip.blocks?.filter((block) => block.type === "compaction").length ?? 0), 0);
+		if (providerCompactions > 0) attributes["agent.providerCompactions"] = providerCompactions;
+	}
+	if (extensions.compactions?.length) attributes["agent.compactions"] = extensions.compactions.map((record) => ({
+		type: record.type,
+		tripIndex: record.tripIndex,
+		inputTokens: record.inputTokens,
+		counting: record.counting,
+		reason: record.reason,
+		...record.compaction ? {
+			replacesFromIndex: record.compaction.replacesFromIndex,
+			replacesToIndex: record.compaction.replacesToIndex
+		} : {}
+	}));
 	if (extensions.model?.name !== void 0) attributes["agent.model.name"] = extensions.model.name;
 	if (extensions.model?.provider !== void 0) attributes["agent.model.provider"] = extensions.model.provider;
 	if (extensions.promptName !== void 0) attributes["agent.promptName"] = extensions.promptName;
@@ -331,6 +358,30 @@ function reportToTrace(report, rootError, options) {
 	return trace;
 }
 
+//#endregion
+//#region ../../packages/ai-panoptic/src/collector/trace-subscriptions.ts
+const listeners = /* @__PURE__ */ new Set();
+/**
+* Subscribe to traces from every built-in collector in this process, including
+* collectors created before subscribing. No replay or retention. Called before
+* exporter dispatch, so adapters can read request-local context synchronously.
+* Listener failures are isolated; async listeners are not awaited. The returned
+* disposer removes only this subscription. Does not enable flow observation.
+*/
+function subscribeTraces(listener) {
+	const subscription = (trace) => listener(trace);
+	listeners.add(subscription);
+	return () => {
+		listeners.delete(subscription);
+	};
+}
+/** Internal collector notification; pure toTrace projections never publish. */
+function publishTrace(trace) {
+	for (const listener of listeners) try {
+		Promise.resolve(listener(trace)).catch(() => {});
+	} catch {}
+}
+
 //#endregion
 //#region ../../packages/ai-panoptic/src/collector/collector.ts
 /**
@@ -382,6 +433,7 @@ var Collector = class {
 	}
 	async collect(report, rootError) {
 		const trace = this.toTrace(report, rootError);
+		publishTrace(trace);
 		await this.dispatch(trace);
 	}
 	async flush() {
@@ -472,6 +524,7 @@ function createCollector(options = {}) {
 */
 function matchTrace(trace, filter) {
 	if (!filter) return true;
+	if (filter.requestId !== void 0 && trace.requestId !== filter.requestId) return false;
 	if (filter.traceId !== void 0 && trace.traceId !== filter.traceId) return false;
 	if (filter.sessionId !== void 0 && trace.sessionId !== filter.sessionId) return false;
 	if (filter.status !== void 0 && !statusMatches(trace.root.status, filter.status)) return false;
@@ -4244,6 +4297,7 @@ exports.percentile = percentile;
 exports.reportToSpan = reportToSpan;
 exports.reportToTrace = reportToTrace;
 exports.rollupCost = rollupCost;
+exports.subscribeTraces = subscribeTraces;
 exports.sumUsage = sumUsage;
 exports.toGenAiAttributes = toGenAiAttributes;
 exports.totalCostUsd = totalCostUsd;