npm / @earendil-works/pi-telemetry
@earendil-works/pi-telemetry
What changed in @earendil-works/pi-telemetry 0.84 to 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-11.
3 breaking1 security15 new APIs and options2 behavior and defaults1 tooling3 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@earendil-works/pi-telemetry 119 changes
Breaking changes 3
Contexts can carry an optional metrics capability on roots, spans, and extracted parents.
Contexts can carry an optional propagation capability on roots, spans, and extracted parents.
Adapters must implement addLink() for links with context targets and optional attributes.
Security 1
Escapes control characters in span and event names, linked trace and span ids, attribute keys, and error names and messages so ids from another process's carrier are not emitted raw.
New APIs and options 10
Adds a span clock that provides wall-clock milliseconds at microsecond resolution, anchored to Date.now() and recalibrated when the clocks diverge by more than 10 ms.
Creates metrics from schema definitions with exact instrument names, kinds, and required or optional low-cardinality attributes.
Exports renderTrace() for plain-text span trees with attributes, durations, errors, events, and cross-trace links; merged spans are deduplicated by ID and links are never followed.
Shared no-op metric instruments are available.
A shared no-op propagation implementation is available.
Initial spans can specify links with context targets and optional attributes, including settled target spans and extracted remote parents.
Defines a backend-independent representation for trace discovery, trace retrieval, and metric queries.
Optional metrics support adds counters, up-down counters, and histograms with boundary hints and exemplar contexts.
Optional propagation injection and extraction use opaque string-map carriers, with passive root fallback for absent or invalid carriers.
Defines backend-independent trace discovery, trace retrieval, and metric queries.
Behavior and default changes 2
Trace output prints lengths of time to the microsecond.
Adapters trust typed instrumentation inputs; malformed values have unspecified behavior. Carrier extraction checks required string identities but does not validate their format.
Fixes and other changes 3
The package root export now has a source condition, allowing workspace tests that resolve with source to work without a build.
The
./testingexport now has a source condition, allowing workspace tests that resolve with source to work without a build.Its type is now TelemetrySpan, matching the shared inert span it provides.
@earendil-works/pi-telemetry 0.846 changes
New APIs and options 5
Adds a callback-based telemetry context contract for integrations.
Adds a deterministic in-memory reference adapter.
Adds typed span starters for multiple schemas with explicit child propagation.
Adds a shared no-op context.
Adds typed utilities for serializable schemas.
Tooling 1
Adds a reusable conformance suite for adapters.