@telemetry-dev/sdk 0.1.7 → 0.1.8

package/README.md

@@ -102,6 +102,8 @@ The SDK installs the [session sampling wrapper](../otel/README.md#correlation-at
   or inject W3C trace context. Baggage is omitted unless `includeBaggage` is true.
 - `captureEnabled("input" | "output")` — report whether the active initialized client permits that
   capture direction. Returns `false` when no client is initialized.
+- `captureMasked()` — report whether the active initialized client has a `mask` configured.
+  Returns `false` when no client is initialized.
 - `boundedCapture(value, options?)` — copy a JSON-compatible value within bounded work and retained
   size. Defaults to 48 KiB, depth 32, and 1,000 traversal items. Returns `{ value, truncated }`;
   `value` can be partial or `undefined` when a limit, cycle, getter, or skip rule prevents capture.
@@ -126,9 +128,9 @@ histogram state and does not retain individual intervals. Pull-based timing incl
 between reads. An explicit timestamp uses the same monotonic millisecond clock for every chunk.
 
 Provider integrations feature-detect stream APIs. With an older core SDK that lacks the stream
-capture policy, streams are still traced with usage, model, finish reason, and timing, but output
-retention assumes the default 65536 limit and treats a mask as configured, so incomplete output is
-withheld. Instrumentation failures are not reported to `onError` with such a core. If only
+capture policy, streams are still traced with usage, model, finish reason, and timing. Output is
+retained within the same fixed bounds as with a current core, but a mask is assumed to be
+configured, so incomplete output is withheld. Instrumentation failures are not reported to `onError` with such a core. If only
 `recordOutputChunk` is unavailable, tracing and reconstruction continue but chunk-interval metrics
 are unavailable. Upgrade the core SDK with provider integrations to enable the full stream
 telemetry.

package/dist/index.d.mts

@@ -154,6 +154,8 @@ interface TelemetryClient {
   shutdown(): Promise<void>;
 }
 declare function captureEnabled(kind: "input" | "output"): boolean;
+/** Whether the active client runs captured values through a mask; false before `init`. */
+declare function captureMasked(): boolean;
 declare function flush(): Promise<void>;
 declare function shutdown(): Promise<void>;
 declare function init(options?: TelemetryOptions, overrides?: ClientOverrides): TelemetryClient;
@@ -242,4 +244,4 @@ interface ObserveOptions extends StartSpanOptions {
  */
 declare function observe<TThis, TArgs extends unknown[], TReturn>(fn: (this: TThis, ...args: TArgs) => TReturn, options?: ObserveOptions): (...args: TArgs) => TReturn;
 //#endregion
-export { type AgentFields, type BatchOptions, type BoundedCaptureDetails, type BoundedCaptureOptions, type BoundedCaptureResult, type ClientOverrides, type ExportMode, type GenerationFields, type LogLevel, type LogOptions, type MaskFn, type ObserveOptions, type ParentRef, type PropagatedAttributes, SCOPE_NAME, type SdkLogLevel, type SpanCapturePolicy, type SpanFields, type SpanHandle, type SpanType, type StartSpanOptions, type TelemetryClient, type TelemetryOptions, TelemetrySpanProcessor, type TelemetrySpanProcessorOptions, type TokenUsage, type ToolFields, activeContext, boundedCapture, boundedCaptureDetails, captureEnabled, extractW3cContext, flush, getTraceparent, init, injectW3cContext, log, observe, propagateAttributes, shutdown, startActiveSpan, startSpan, updateActiveSpan, withContext };
+export { type AgentFields, type BatchOptions, type BoundedCaptureDetails, type BoundedCaptureOptions, type BoundedCaptureResult, type ClientOverrides, type ExportMode, type GenerationFields, type LogLevel, type LogOptions, type MaskFn, type ObserveOptions, type ParentRef, type PropagatedAttributes, SCOPE_NAME, type SdkLogLevel, type SpanCapturePolicy, type SpanFields, type SpanHandle, type SpanType, type StartSpanOptions, type TelemetryClient, type TelemetryOptions, TelemetrySpanProcessor, type TelemetrySpanProcessorOptions, type TokenUsage, type ToolFields, activeContext, boundedCapture, boundedCaptureDetails, captureEnabled, captureMasked, extractW3cContext, flush, getTraceparent, init, injectW3cContext, log, observe, propagateAttributes, shutdown, startActiveSpan, startSpan, updateActiveSpan, withContext };

package/dist/index.mjs

@@ -63,6 +63,10 @@ function captureEnabled(kind) {
 	const config = currentClient().core?.config;
 	return kind === "input" ? config?.captureInput ?? false : config?.captureOutput ?? false;
 }
+/** Whether the active client runs captured values through a mask; false before `init`. */
+function captureMasked() {
+	return currentClient().core?.config.mask !== void 0;
+}
 function flush() {
 	return currentClient().flush();
 }
@@ -805,4 +809,4 @@ function observe(fn, options) {
 	return wrapped;
 }
 //#endregion
-export { SCOPE_NAME, TelemetrySpanProcessor, activeContext, boundedCapture, boundedCaptureDetails, captureEnabled, extractW3cContext, flush, getTraceparent, init, injectW3cContext, log, observe, propagateAttributes, shutdown, startActiveSpan, startSpan, updateActiveSpan, withContext };
+export { SCOPE_NAME, TelemetrySpanProcessor, activeContext, boundedCapture, boundedCaptureDetails, captureEnabled, captureMasked, extractW3cContext, flush, getTraceparent, init, injectW3cContext, log, observe, propagateAttributes, shutdown, startActiveSpan, startSpan, updateActiveSpan, withContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telemetry-dev/sdk",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Pure TypeScript SDK for telemetry.dev: LLM traces, logs, and GenAI metrics on OpenTelemetry, for Node and edge runtimes.",
   "keywords": [
     "genai",

package/src/client.ts

@@ -94,6 +94,11 @@ export function captureEnabled(kind: "input" | "output"): boolean {
   return kind === "input" ? (config?.captureInput ?? false) : (config?.captureOutput ?? false);
 }
 
+/** Whether the active client runs captured values through a mask; false before `init`. */
+export function captureMasked(): boolean {
+  return currentClient().core?.config.mask !== undefined;
+}
+
 export function flush(): Promise<void> {
   return currentClient().flush();
 }

package/src/index.ts

@@ -9,6 +9,7 @@ export type {
 
 export {
   captureEnabled,
+  captureMasked,
   type ClientOverrides,
   flush,
   init,