@warlock.js/ai-panoptic 5.32.0 → 5.34.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
@@ -25,83 +33,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Tool spans carry the provider's tool-call id as the `tool.callId` attribute.
 - Agent runs with `status: "incomplete"` (their final answer was cut off) are exported as errors: OTel `ERROR` status, Langfuse level `ERROR`, the console exporter's error stream (marked `INCOMPLETE`), the dashboard's error filter, and the `failed` count of trace-store aggregates. `?status=incomplete` is accepted by the dashboard API.
 
-## 5.30.0 - 2026-10-16
-
-### Changed
-
-- Lockstep release; package APIs are unchanged.
-
 ## 5.29.0 - 2026-10-01
 
 ### Changed
 
-- Lockstep release; package APIs are unchanged. Skills refer to other topics by name instead of file paths, so cross-references keep working after `agent-kit` copies them into an app.
+- Skills refer to other topics by name instead of file paths, so cross-references keep working after `agent-kit` copies them into an app.
 
 ## 5.28.0 - 2026-10-01
 
 ### Changed
 
-- Lockstep release; package APIs are unchanged. `llms.txt` now lists every skill topic with its description (frontmatter in CRLF files was skipped).
-
-## 5.27.0 - 2026-10-01
-
-### Changed
-
-- Lockstep release; package APIs are unchanged.
-
-## 5.26.0 - 2026-09-30
-
-### Changed
-
-- Lockstep release; package APIs are unchanged.
-
-## 5.25.0 - 2026-09-28
-
-### Changed
-
-- Lockstep release; package APIs are unchanged.
-
-## 5.24.0 - 2026-09-27
-
-### Changed
-
-- Lockstep release; package APIs are unchanged.
-
-## 5.23.2 - 2026-09-26
-
-### Changed
-
-- Lockstep patch release; package APIs are unchanged.
-
-## 5.23.1 - 2026-09-26
-
-### Changed
-
-- Lockstep patch release; package APIs are unchanged.
-
-## 5.23.0 - 2026-09-25
-
-### Changed
-
-- Lockstep patch release; package APIs are unchanged.
-
-## 5.22.1 - 2026-09-25
-
-### Changed
-
-- Lockstep patch release; package APIs are unchanged.
-
-## 5.22.0 - 2026-09-25
-
-### Changed
-
-- Lockstep release maintenance and dependency refresh.
-
-## 5.21.0 - 2026-09-25
-
-### Changed
-
-- Lockstep release maintenance and dependency refresh.
+- `llms.txt` now lists every skill topic with its description (frontmatter in CRLF files was skipped).
 
 ## 5.20.0 - 2026-09-24
 
@@ -115,53 +57,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 - Refined package skill-discovery descriptions and regenerated the llms projections.
 
-## 5.11.0 - 2026-09-14
-
-_Released in lockstep with the `@warlock.js/*` family; no package-specific changes in 5.11.0._
-
-## 5.10.0 - 2026-09-14
-
-_Released in lockstep with the `@warlock.js/*` family; no package-specific changes in 5.10.0._
-
-## 5.9.0 - 2026-09-13
-
-_Released in lockstep with the `@warlock.js/*` family; no package-specific changes in 5.9.0._
-
-## 5.2.3 - 2026-09-02
-
-### Fixed
-
-- Released in exact lockstep with Core's Web generator repairs so every family dependency remains installable at 5.2.3.
-
 ## 5.2.2
 
 ### Maintenance
 
 - Restored the Warlock family to one exact, installable lockstep version.
 
-## 5.1.0
-
-No changes to `@warlock.js/ai-panoptic`. Released in lockstep with the `@warlock.js/web`
-React-execution fix and the `@warlock.js/core` CLI additions — see those packages'
-changelogs.
-
-## 5.0.2 - 2026-08-25
-
-No changes to `@warlock.js/ai-panoptic`. Released in lockstep with the `@warlock.js/web` SSR
-fix (`ssr.noExternal`) — see that package's changelog.
-
-## 5.0.1 - 2026-08-25
-
-No changes to `@warlock.js/ai-panoptic`. Released in lockstep with the `create-warlock` vite
-resolution pin and the `@warlock.js/web` peer narrowing — see those packages'
-changelogs.
-
-## 5.0.0 - 2026-08-25
-
-### Changed
-
-- This package is unchanged in 5.0.0; its version moved only because the Warlock family releases in lockstep.
-
 ## 4.16.0 - 2026-08-18
 
 ### Security

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;