@dxos/observability 0.14.0 → 0.16.0

package/dist/lib/chunk-AiObservability.mjs

@@ -0,0 +1,238 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { log } from "@dxos/log";
+import { SpanStatusCode } from "@opentelemetry/api";
+import * as SpanAttributes from "@dxos/effect/SpanAttributes";
+//#region src/ai/AiObservability.ts
+var AiObservability_exports = /* @__PURE__ */ __exportAll({
+	AiSpanProcessor: () => AiSpanProcessor,
+	contentCaptureAllowed: () => contentCaptureAllowed,
+	stripUndefined: () => stripUndefined
+});
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/observability/src/ai/AiObservability.ts";
+/**
+* AI telemetry capture — data policy.
+*
+* The AI stack already annotates every model call with the OTel GenAI conventions (`gen_ai.*`,
+* emitted by the `effect/ai` provider layers) plus the `dxos.ai.*` attributes those
+* conventions have no room for. This reads the finished spans, applies the capture policy, and
+* hands each surviving call to a sink as a {@link ObservabilityExtension.Inference} — a shape
+* that follows the GenAI conventions, not any vendor's schema. Mapping onto a backend's own
+* vocabulary belongs to that backend's extension.
+*
+* It is the only place the policy is evaluated, so everything leaving passes through it:
+*
+* - **Nothing** unless {@link Options.captureEnabled} reports the user's telemetry opt-in as on.
+*   The gate is checked here, before a record is built, rather than left to a backend client's own
+*   opt-out flag: that flag is a separate store, so it is not the same answer as the user's
+*   DXOS-side preference.
+* - **Metadata** — model, provider, request parameters, token counts (including the prompt-cache
+*   reads and writes, which price the call and give the hit rate), latency, trace/span/session ids,
+*   error class.
+* - **Content** — prompt, response and tool names, kept only for a span that names its space and
+*   whose space {@link Options.allowContent} accepts. Content is always stamped on the span
+*   upstream (`AiTelemetry` in `@dxos/ai`) and dropped here, rather than conditionally stamped, so
+*   a source that forgets the policy cannot bypass it.
+*
+* Scrub rules enforced here regardless of the above:
+* - A span that does not name its space is treated as unknown, and unknown **denies** content. Only
+*   a call that runs in a known space can have its content captured, so the policy fails closed
+*   for one that does not (`AiSession` names it, and a process scoped to a space stamps it on every
+*   span it runs; a utility model call outside both is reported as metadata only).
+* - Attribute **allowlist**: only the fields of `Inference` are read; every other span attribute
+*   is dropped (so an accidental attribute upstream cannot leak through telemetry).
+* - Errors are reduced to the exception **class name** — `exception.message` and
+*   `exception.stacktrace` recorded on the span are never forwarded, since provider error
+*   messages can embed request or response fragments.
+*
+* Nothing here may throw: `onEnd` runs inside `Span.end()` on the fiber that made the model call,
+* and OTel's `MultiSpanProcessor` does not catch, so an escaping error would fail that call.
+*/
+/**
+* AI telemetry capture policy:
+*
+* | Observability toggle | Space                                 | Capture          |
+* |----------------------|---------------------------------------|------------------|
+* | off                  | any                                   | nothing          |
+* | on                   | EDGE has plaintext access (all today) | metadata+content |
+* | on                   | E2E-encrypted (future)                | metadata only    |
+* | on                   | not declared by the call site         | metadata only    |
+*
+* Metadata is model, provider, tokens, latency, and trace/session ids. Content adds the prompt,
+* the response, and tool names — including tool results, i.e. data the agent read from the space.
+* The rationale: content that already leaves the device in plaintext for EDGE to replicate is not
+* newly exposed in kind by telemetry, whereas an E2E space promises that plaintext never reaches
+* infrastructure, and telemetry must not become the side channel that breaks it.
+*
+* The last row is the fail-closed default. A space id reaches the span only from a call site that
+* declares one (`AiSession` does; the utility model calls behind summarization, tagging, and
+* extraction do not), so content capture is opt-in per call site and an undeclared one reports
+* metadata only. That is what keeps this predicate honest once it stops returning true: it can
+* never be asked about a space nobody named.
+*
+* Both this predicate and the telemetry opt-in are evaluated in the sink, not at the model call, so
+* they apply to every event on the way out (see `AiSpanProcessor` in `@dxos/observability`, which
+* also holds the scrub rules).
+*/
+var contentCaptureAllowed = (_spaceId) => {
+	return true;
+};
+/** The span `effect/ai` names for a streamed call; anything else is a single response. */
+var STREAM_SPAN_NAME = "LanguageModel.streamText";
+/** Marker attributes identifying a GenAI span (per OTel GenAI semantic conventions). */
+var GEN_AI_MARKERS = [
+	"gen_ai.provider.name",
+	"gen_ai.request.model",
+	"gen_ai.response.model"
+];
+/**
+* Session/content attributes stamped by `AiTelemetry.ATTRIBUTES` in `@dxos/ai` (not part of the
+* GenAI spec). Restated rather than imported because telemetry sits below the AI stack, not above
+* it; the `wired to @dxos/ai` cases in `AiObservability.test.ts` drive both halves so a rename fails there.
+*/
+var SESSION_ID_ATTR = SpanAttributes.AI.sessionId;
+/**
+* Shared with the process handle and ECHO rather than AI-specific: a model call inside a
+* space-scoped process carries it whether or not the call site named its space itself.
+*/
+var SPACE_ID_ATTR = SpanAttributes.SPACE_ID;
+var INPUT_ATTR = SpanAttributes.AI.input;
+var OUTPUT_ATTR = SpanAttributes.AI.output;
+var TOOLS_ATTR = SpanAttributes.AI.tools;
+var TRUNCATED_ATTR = SpanAttributes.AI.truncated;
+var CACHE_READ_TOKENS_ATTR = SpanAttributes.AI.cacheReadTokens;
+var CACHE_WRITE_TOKENS_ATTR = SpanAttributes.AI.cacheWriteTokens;
+/** What a non-model span is (`AiTelemetry.KIND`); a span with neither value is not AI at all. */
+var KIND_ATTR = SpanAttributes.AI.kind;
+var KIND_TURN = SpanAttributes.AI_KIND.turn;
+var KIND_TOOL = SpanAttributes.AI_KIND.tool;
+/** Display name for a span whose OTel name is generic, e.g. the tool a `callTool` span ran. */
+var NAME_ATTR = SpanAttributes.AI.name;
+/**
+* Reports finished AI spans to the injected sinks: model calls (`gen_ai.*`) as inferences, and the
+* turn and tool-call spans the AI stack marks with `dxos.ai.kind`. Every other span passes through
+* untouched.
+*
+* Attaches to the realm's tracer provider via `Otel.addSpanProcessor` rather than owning one: the
+* process manager's baseline tracer already records every span, so a second provider would mean a
+* second sampler and a second tracer over the same spans.
+*/
+var AiSpanProcessor = class {
+	_captureInference;
+	_captureTurn;
+	_captureToolCall;
+	_captureEnabled;
+	_allowContent;
+	constructor({ captureInference, captureTurn, captureToolCall, captureEnabled, allowContent }) {
+		this._captureInference = captureInference;
+		this._captureTurn = captureTurn;
+		this._captureToolCall = captureToolCall;
+		this._captureEnabled = captureEnabled;
+		this._allowContent = allowContent;
+	}
+	onStart(_span, _parentContext) {}
+	onEnd(span) {
+		try {
+			this._capture(span);
+		} catch (err) {
+			log.catch(err, { span: span.name }, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 168,
+				S: this
+			});
+		}
+	}
+	_capture(span) {
+		const attributes = span.attributes;
+		const kind = attributes[KIND_ATTR];
+		const isModelCall = GEN_AI_MARKERS.some((key) => attributes[key] !== void 0);
+		if (kind !== KIND_TURN && kind !== KIND_TOOL && !isModelCall) return;
+		if (!this._captureEnabled()) return;
+		const spaceId = attributes[SPACE_ID_ATTR];
+		const content = typeof spaceId === "string" && this._allowContent(spaceId);
+		if (kind === KIND_TURN || kind === KIND_TOOL) {
+			const spanContext = span.spanContext();
+			const record = {
+				traceId: spanContext.traceId,
+				spanId: spanContext.spanId,
+				parentSpanId: span.parentSpanContext?.spanId,
+				spanName: stringAttribute(attributes[NAME_ATTR]) ?? span.name,
+				sessionId: stringAttribute(attributes[SESSION_ID_ATTR]),
+				latency: hrTimeToSeconds(span.duration),
+				content: content ? {
+					input: parseJsonOrRaw(attributes[INPUT_ATTR]),
+					output: parseJsonOrRaw(attributes[OUTPUT_ATTR]),
+					truncated: attributes[TRUNCATED_ATTR] === true ? true : void 0
+				} : void 0,
+				errorClass: span.status.code === SpanStatusCode.ERROR ? errorClass(span) : void 0
+			};
+			if (kind === KIND_TURN) this._captureTurn(record);
+			else this._captureToolCall(record);
+			return;
+		}
+		const spanContext = span.spanContext();
+		const inference = {
+			traceId: spanContext.traceId,
+			spanId: spanContext.spanId,
+			parentSpanId: span.parentSpanContext?.spanId,
+			spanName: span.name,
+			provider: stringAttribute(attributes["gen_ai.provider.name"]),
+			model: stringAttribute(attributes["gen_ai.response.model"] ?? attributes["gen_ai.request.model"]),
+			sessionId: stringAttribute(attributes[SESSION_ID_ATTR]),
+			parameters: modelParameters(attributes),
+			inputTokens: numberAttribute(attributes["gen_ai.usage.input_tokens"]),
+			outputTokens: numberAttribute(attributes["gen_ai.usage.output_tokens"]),
+			cacheReadTokens: numberAttribute(attributes[CACHE_READ_TOKENS_ATTR]),
+			cacheWriteTokens: numberAttribute(attributes[CACHE_WRITE_TOKENS_ATTR]),
+			latency: hrTimeToSeconds(span.duration),
+			streaming: span.name === STREAM_SPAN_NAME,
+			content: content ? {
+				input: parseJsonOrRaw(attributes[INPUT_ATTR]),
+				output: parseJsonOrRaw(attributes[OUTPUT_ATTR]),
+				tools: parseJsonOrRaw(attributes[TOOLS_ATTR]),
+				truncated: attributes[TRUNCATED_ATTR] === true ? true : void 0
+			} : void 0,
+			errorClass: span.status.code === SpanStatusCode.ERROR ? errorClass(span) : void 0
+		};
+		this._captureInference(inference);
+	}
+	forceFlush() {
+		return Promise.resolve();
+	}
+	shutdown() {
+		return Promise.resolve();
+	}
+};
+var hrTimeToSeconds = ([seconds, nanos]) => seconds + nanos / 1e9;
+var stringAttribute = (value) => typeof value === "string" ? value : void 0;
+var numberAttribute = (value) => typeof value === "number" ? value : void 0;
+var modelParameters = (attributes) => {
+	const parameters = stripUndefined({
+		temperature: attributes["gen_ai.request.temperature"],
+		max_tokens: attributes["gen_ai.request.max_tokens"],
+		top_p: attributes["gen_ai.request.top_p"],
+		top_k: attributes["gen_ai.request.top_k"]
+	});
+	return Object.keys(parameters).length > 0 ? parameters : void 0;
+};
+var parseJsonOrRaw = (value) => {
+	if (typeof value !== "string") return;
+	try {
+		return JSON.parse(value);
+	} catch {
+		return value;
+	}
+};
+/** Only the exception class name — messages and stack traces can embed prompt/response content. */
+var errorClass = (span) => {
+	for (const event of span.events) {
+		const type = event.attributes?.["exception.type"];
+		if (typeof type === "string") return type;
+	}
+	return "Error";
+};
+var stripUndefined = (properties) => Object.fromEntries(Object.entries(properties).filter(([, value]) => value !== void 0));
+//#endregion
+export { stripUndefined as i, AiSpanProcessor as n, contentCaptureAllowed as r, AiObservability_exports as t };
+
+//# sourceMappingURL=chunk-AiObservability.mjs.map

package/dist/lib/chunk-AiObservability.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-AiObservability.mjs","names":[],"sources":["../../src/ai/AiObservability.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\n// Consumers import `@dxos/observability/AiObservability`, so only the lazily-activated plugin module\n// that uses the AI sink loads the OpenTelemetry SDK.\n\nimport { type Context, SpanStatusCode } from '@opentelemetry/api';\nimport type { ReadableSpan, Span, SpanProcessor } from '@opentelemetry/sdk-trace-base';\n\nimport * as SpanAttributes from '@dxos/effect/SpanAttributes';\nimport { log } from '@dxos/log';\n\nimport type * as ObservabilityExtension from '../ObservabilityExtension.ts';\n\n/**\n * AI telemetry capture — data policy.\n *\n * The AI stack already annotates every model call with the OTel GenAI conventions (`gen_ai.*`,\n * emitted by the `effect/ai` provider layers) plus the `dxos.ai.*` attributes those\n * conventions have no room for. This reads the finished spans, applies the capture policy, and\n * hands each surviving call to a sink as a {@link ObservabilityExtension.Inference} — a shape\n * that follows the GenAI conventions, not any vendor's schema. Mapping onto a backend's own\n * vocabulary belongs to that backend's extension.\n *\n * It is the only place the policy is evaluated, so everything leaving passes through it:\n *\n * - **Nothing** unless {@link Options.captureEnabled} reports the user's telemetry opt-in as on.\n *   The gate is checked here, before a record is built, rather than left to a backend client's own\n *   opt-out flag: that flag is a separate store, so it is not the same answer as the user's\n *   DXOS-side preference.\n * - **Metadata** — model, provider, request parameters, token counts (including the prompt-cache\n *   reads and writes, which price the call and give the hit rate), latency, trace/span/session ids,\n *   error class.\n * - **Content** — prompt, response and tool names, kept only for a span that names its space and\n *   whose space {@link Options.allowContent} accepts. Content is always stamped on the span\n *   upstream (`AiTelemetry` in `@dxos/ai`) and dropped here, rather than conditionally stamped, so\n *   a source that forgets the policy cannot bypass it.\n *\n * Scrub rules enforced here regardless of the above:\n * - A span that does not name its space is treated as unknown, and unknown **denies** content. Only\n *   a call that runs in a known space can have its content captured, so the policy fails closed\n *   for one that does not (`AiSession` names it, and a process scoped to a space stamps it on every\n *   span it runs; a utility model call outside both is reported as metadata only).\n * - Attribute **allowlist**: only the fields of `Inference` are read; every other span attribute\n *   is dropped (so an accidental attribute upstream cannot leak through telemetry).\n * - Errors are reduced to the exception **class name** — `exception.message` and\n *   `exception.stacktrace` recorded on the span are never forwarded, since provider error\n *   messages can embed request or response fragments.\n *\n * Nothing here may throw: `onEnd` runs inside `Span.end()` on the fiber that made the model call,\n * and OTel's `MultiSpanProcessor` does not catch, so an escaping error would fail that call.\n */\n\n/**\n * AI telemetry capture policy:\n *\n * | Observability toggle | Space                                 | Capture          |\n * |----------------------|---------------------------------------|------------------|\n * | off                  | any                                   | nothing          |\n * | on                   | EDGE has plaintext access (all today) | metadata+content |\n * | on                   | E2E-encrypted (future)                | metadata only    |\n * | on                   | not declared by the call site         | metadata only    |\n *\n * Metadata is model, provider, tokens, latency, and trace/session ids. Content adds the prompt,\n * the response, and tool names — including tool results, i.e. data the agent read from the space.\n * The rationale: content that already leaves the device in plaintext for EDGE to replicate is not\n * newly exposed in kind by telemetry, whereas an E2E space promises that plaintext never reaches\n * infrastructure, and telemetry must not become the side channel that breaks it.\n *\n * The last row is the fail-closed default. A space id reaches the span only from a call site that\n * declares one (`AiSession` does; the utility model calls behind summarization, tagging, and\n * extraction do not), so content capture is opt-in per call site and an undeclared one reports\n * metadata only. That is what keeps this predicate honest once it stops returning true: it can\n * never be asked about a space nobody named.\n *\n * Both this predicate and the telemetry opt-in are evaluated in the sink, not at the model call, so\n * they apply to every event on the way out (see `AiSpanProcessor` in `@dxos/observability`, which\n * also holds the scrub rules).\n */\nexport const contentCaptureAllowed = (_spaceId: string): boolean => {\n  // Always true today because every space replicates through EDGE in plaintext. This MUST NOT\n  // stay unconditional: once E2E-encrypted spaces exist this predicate has to return false for\n  // them — and apply at the data boundary, not just the conversation's home space, since a turn\n  // that reads from an E2E space via a cross-space reference would otherwise leak its content.\n  return true;\n};\n\nexport type Options = {\n  /** Sink for a call that survived the policy — typically `Observability.ai`. */\n  captureInference: (inference: ObservabilityExtension.Inference) => void;\n  /** Sink for a conversation turn (`dxos.ai.kind = turn`), the unit its model calls group under. */\n  captureTurn: (turn: ObservabilityExtension.Turn) => void;\n  /** Sink for a tool call inside a turn (`dxos.ai.kind = tool`). */\n  captureToolCall: (toolCall: ObservabilityExtension.ToolCall) => void;\n  /** Whether the user's telemetry opt-in is on. Checked before an event is built. */\n  captureEnabled: () => boolean;\n  /**\n   * Whether prompt/response content may leave for the given space. Only called for a span that\n   * names one — a span with no space never reaches this predicate and never reports content.\n   */\n  allowContent: (spaceId: string) => boolean;\n};\n\n/** The span `effect/ai` names for a streamed call; anything else is a single response. */\nconst STREAM_SPAN_NAME = 'LanguageModel.streamText';\n\n/** Marker attributes identifying a GenAI span (per OTel GenAI semantic conventions). */\nconst GEN_AI_MARKERS = ['gen_ai.provider.name', 'gen_ai.request.model', 'gen_ai.response.model'];\n\n/**\n * Session/content attributes stamped by `AiTelemetry.ATTRIBUTES` in `@dxos/ai` (not part of the\n * GenAI spec). Restated rather than imported because telemetry sits below the AI stack, not above\n * it; the `wired to @dxos/ai` cases in `AiObservability.test.ts` drive both halves so a rename fails there.\n */\nconst SESSION_ID_ATTR = SpanAttributes.AI.sessionId;\n/**\n * Shared with the process handle and ECHO rather than AI-specific: a model call inside a\n * space-scoped process carries it whether or not the call site named its space itself.\n */\nconst SPACE_ID_ATTR = SpanAttributes.SPACE_ID;\nconst INPUT_ATTR = SpanAttributes.AI.input;\nconst OUTPUT_ATTR = SpanAttributes.AI.output;\nconst TOOLS_ATTR = SpanAttributes.AI.tools;\nconst TRUNCATED_ATTR = SpanAttributes.AI.truncated;\nconst CACHE_READ_TOKENS_ATTR = SpanAttributes.AI.cacheReadTokens;\nconst CACHE_WRITE_TOKENS_ATTR = SpanAttributes.AI.cacheWriteTokens;\n/** What a non-model span is (`AiTelemetry.KIND`); a span with neither value is not AI at all. */\nconst KIND_ATTR = SpanAttributes.AI.kind;\nconst KIND_TURN = SpanAttributes.AI_KIND.turn;\nconst KIND_TOOL = SpanAttributes.AI_KIND.tool;\n/** Display name for a span whose OTel name is generic, e.g. the tool a `callTool` span ran. */\nconst NAME_ATTR = SpanAttributes.AI.name;\n\n/**\n * Reports finished AI spans to the injected sinks: model calls (`gen_ai.*`) as inferences, and the\n * turn and tool-call spans the AI stack marks with `dxos.ai.kind`. Every other span passes through\n * untouched.\n *\n * Attaches to the realm's tracer provider via `Otel.addSpanProcessor` rather than owning one: the\n * process manager's baseline tracer already records every span, so a second provider would mean a\n * second sampler and a second tracer over the same spans.\n */\nexport class AiSpanProcessor implements SpanProcessor {\n  private readonly _captureInference: Options['captureInference'];\n  private readonly _captureTurn: Options['captureTurn'];\n  private readonly _captureToolCall: Options['captureToolCall'];\n  private readonly _captureEnabled: Options['captureEnabled'];\n  private readonly _allowContent: Options['allowContent'];\n\n  constructor({ captureInference, captureTurn, captureToolCall, captureEnabled, allowContent }: Options) {\n    this._captureInference = captureInference;\n    this._captureTurn = captureTurn;\n    this._captureToolCall = captureToolCall;\n    this._captureEnabled = captureEnabled;\n    this._allowContent = allowContent;\n  }\n\n  onStart(_span: Span, _parentContext: Context): void {}\n\n  onEnd(span: ReadableSpan): void {\n    try {\n      this._capture(span);\n    } catch (err) {\n      // The caller is `Span.end()` on the model call's own fiber; failing telemetry must not fail it.\n      log.catch(err, { span: span.name });\n    }\n  }\n\n  private _capture(span: ReadableSpan): void {\n    const attributes = span.attributes;\n    const kind = attributes[KIND_ATTR];\n    const isModelCall = GEN_AI_MARKERS.some((key) => attributes[key] !== undefined);\n    if (kind !== KIND_TURN && kind !== KIND_TOOL && !isModelCall) {\n      return;\n    }\n    if (!this._captureEnabled()) {\n      return;\n    }\n\n    const spaceId = attributes[SPACE_ID_ATTR];\n    const content = typeof spaceId === 'string' && this._allowContent(spaceId);\n\n    if (kind === KIND_TURN || kind === KIND_TOOL) {\n      const spanContext = span.spanContext();\n      const record: ObservabilityExtension.AiSpanBase = {\n        traceId: spanContext.traceId,\n        spanId: spanContext.spanId,\n        parentSpanId: span.parentSpanContext?.spanId,\n        spanName: stringAttribute(attributes[NAME_ATTR]) ?? span.name,\n        sessionId: stringAttribute(attributes[SESSION_ID_ATTR]),\n        latency: hrTimeToSeconds(span.duration),\n        content: content\n          ? {\n              input: parseJsonOrRaw(attributes[INPUT_ATTR]),\n              output: parseJsonOrRaw(attributes[OUTPUT_ATTR]),\n              truncated: attributes[TRUNCATED_ATTR] === true ? true : undefined,\n            }\n          : undefined,\n        errorClass: span.status.code === SpanStatusCode.ERROR ? errorClass(span) : undefined,\n      };\n      if (kind === KIND_TURN) {\n        this._captureTurn(record);\n      } else {\n        this._captureToolCall(record);\n      }\n      return;\n    }\n\n    const spanContext = span.spanContext();\n    const inference: ObservabilityExtension.Inference = {\n      traceId: spanContext.traceId,\n      spanId: spanContext.spanId,\n      parentSpanId: span.parentSpanContext?.spanId,\n      spanName: span.name,\n      provider: stringAttribute(attributes['gen_ai.provider.name']),\n      model: stringAttribute(attributes['gen_ai.response.model'] ?? attributes['gen_ai.request.model']),\n      sessionId: stringAttribute(attributes[SESSION_ID_ATTR]),\n      parameters: modelParameters(attributes),\n      // The uncached count: add `cacheReadTokens` for what the model actually read.\n      inputTokens: numberAttribute(attributes['gen_ai.usage.input_tokens']),\n      outputTokens: numberAttribute(attributes['gen_ai.usage.output_tokens']),\n      cacheReadTokens: numberAttribute(attributes[CACHE_READ_TOKENS_ATTR]),\n      cacheWriteTokens: numberAttribute(attributes[CACHE_WRITE_TOKENS_ATTR]),\n      latency: hrTimeToSeconds(span.duration),\n      streaming: span.name === STREAM_SPAN_NAME,\n      content: content\n        ? {\n            input: parseJsonOrRaw(attributes[INPUT_ATTR]),\n            output: parseJsonOrRaw(attributes[OUTPUT_ATTR]),\n            tools: parseJsonOrRaw(attributes[TOOLS_ATTR]),\n            // A cut value no longer parses, so it is carried as the raw fragment; saying so keeps a\n            // consumer from reading a string where an array was expected as a bug.\n            truncated: attributes[TRUNCATED_ATTR] === true ? true : undefined,\n          }\n        : undefined,\n      errorClass: span.status.code === SpanStatusCode.ERROR ? errorClass(span) : undefined,\n    };\n\n    this._captureInference(inference);\n  }\n\n  forceFlush(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n\nconst hrTimeToSeconds = ([seconds, nanos]: [number, number]): number => seconds + nanos / 1e9;\n\n// Span attributes are `unknown` to us; narrowing is what keeps a stray value out of the record.\nconst stringAttribute = (value: unknown): string | undefined => (typeof value === 'string' ? value : undefined);\nconst numberAttribute = (value: unknown): number | undefined => (typeof value === 'number' ? value : undefined);\n\nconst modelParameters = (attributes: ReadableSpan['attributes']): Record<string, unknown> | undefined => {\n  const parameters = stripUndefined({\n    temperature: attributes['gen_ai.request.temperature'],\n    max_tokens: attributes['gen_ai.request.max_tokens'],\n    top_p: attributes['gen_ai.request.top_p'],\n    top_k: attributes['gen_ai.request.top_k'],\n  });\n  return Object.keys(parameters).length > 0 ? parameters : undefined;\n};\n\nconst parseJsonOrRaw = (value: unknown): unknown => {\n  if (typeof value !== 'string') {\n    return undefined;\n  }\n  try {\n    return JSON.parse(value);\n  } catch {\n    // Truncated content attributes are expected to no longer parse; forward the raw string.\n    return value;\n  }\n};\n\n/** Only the exception class name — messages and stack traces can embed prompt/response content. */\nconst errorClass = (span: ReadableSpan): string => {\n  for (const event of span.events) {\n    const type = event.attributes?.['exception.type'];\n    if (typeof type === 'string') {\n      return type;\n    }\n  }\n  return 'Error';\n};\n\nexport const stripUndefined = (properties: Record<string, unknown>): Record<string, unknown> =>\n  Object.fromEntries(Object.entries(properties).filter(([, value]) => value !== undefined));\n"],"mappings":"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"}

package/dist/lib/chunk-Observability.mjs

@@ -0,0 +1,248 @@
+import { n as __reExport, t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { t as storage_exports } from "./chunk-storage.mjs";
+import { log } from "@dxos/log";
+import * as Effect from "effect/Effect";
+import { SubscriptionList } from "@dxos/async";
+import * as Array from "effect/Array";
+import * as Function from "effect/Function";
+import { invariant } from "@dxos/invariant";
+//#region src/Observability.ts
+var Observability_exports = /* @__PURE__ */ __exportAll({
+	addDataProvider: () => addDataProvider,
+	addExtension: () => addExtension,
+	initialize: () => initialize,
+	make: () => make
+});
+__reExport(Observability_exports, storage_exports);
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/observability/src/Observability.ts";
+var attachAiCapture = async (observability) => {
+	const { AiSpanProcessor, contentCaptureAllowed } = await import("./ai/AiObservability.mjs");
+	const { Otel } = await import("./chunk-extensions.mjs").then((n) => n.t);
+	return Otel.addSpanProcessor(new AiSpanProcessor({
+		captureInference: (inference) => observability.ai.captureInference(inference),
+		captureTurn: (turn) => observability.ai.captureTurn(turn),
+		captureToolCall: (toolCall) => observability.ai.captureToolCall(toolCall),
+		captureEnabled: () => observability.enabled,
+		allowContent: contentCaptureAllowed
+	}));
+};
+var ObservabilityImpl = class {
+	_initialized = false;
+	_extensions = [];
+	_dataProviders = [];
+	_subscriptions = new SubscriptionList();
+	initialize() {
+		if (this._initialized) return Effect.succeed(void 0);
+		const initializedExtensions = [];
+		return Effect.gen({ self: this }, function* () {
+			const context = { setTags: (tags, kind) => this.setTags(tags, kind) };
+			for (const extension of this._extensions) {
+				if (extension.initialize) yield* extension.initialize(context);
+				initializedExtensions.push(extension);
+			}
+			const cleanups = yield* Effect.all(this._dataProviders.map((provider) => provider(this)));
+			this._subscriptions.add(...cleanups.filter((cleanup) => cleanup !== void 0));
+			this._subscriptions.add(yield* Effect.promise(() => attachAiCapture(this)));
+			this._initialized = true;
+		}).pipe(Effect.catch((error) => Effect.gen({ self: this }, function* () {
+			log.catch(error, void 0, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 102,
+				S: this
+			});
+			for (const extension of initializedExtensions) if (extension.close) yield* extension.close().pipe(Effect.catch(() => Effect.succeed(void 0)));
+			this._subscriptions.clear();
+		})));
+	}
+	close() {
+		return Effect.gen({ self: this }, function* () {
+			this._subscriptions.clear();
+			this._dataProviders.length = 0;
+			for (const extension of this._extensions) if (extension.close) yield* extension.close();
+			this._initialized = false;
+		});
+	}
+	enable() {
+		return Effect.gen({ self: this }, function* () {
+			for (const extension of this._extensions) if (extension.enable) yield* extension.enable();
+		});
+	}
+	disable() {
+		return Effect.gen({ self: this }, function* () {
+			for (const extension of this._extensions) if (extension.disable) yield* extension.disable();
+		});
+	}
+	flush() {
+		return Effect.gen({ self: this }, function* () {
+			for (const extension of this._extensions) if (extension.flush) yield* extension.flush();
+		});
+	}
+	_addExtension(extension) {
+		invariant(!this._initialized, "Observability is already initialized", {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 159,
+			S: this,
+			A: ["!this._initialized", "'Observability is already initialized'"]
+		});
+		this._extensions.push(extension);
+	}
+	_addDataProvider(dataProvider) {
+		invariant(!this._initialized, "Observability is already initialized", {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 164,
+			S: this,
+			A: ["!this._initialized", "'Observability is already initialized'"]
+		});
+		this._dataProviders.push(dataProvider);
+	}
+	/**
+	* Adds a data provider and initializes it.
+	*/
+	addDataProvider(dataProvider) {
+		return Effect.gen({ self: this }, function* () {
+			this._dataProviders.push(dataProvider);
+			const cleanup = yield* dataProvider(this);
+			if (cleanup) this._subscriptions.add(cleanup);
+		});
+	}
+	identify(distinctId, attributes, setOnceAttributes) {
+		for (const extension of this._extensions) extension.identify?.(distinctId, attributes, setOnceAttributes);
+	}
+	alias(distinctId, previousId) {
+		for (const extension of this._extensions) extension.alias?.(distinctId, previousId);
+	}
+	setTags(tags, kind) {
+		for (const extension of this._extensions) {
+			if (kind && !extension.apis.some((api) => api.kind === kind)) continue;
+			const processedTags = Object.fromEntries(Object.entries(tags).filter((entry) => entry[1] !== void 0).map(([key, value]) => [key, value.toString()]));
+			extension.setTags?.(processedTags, kind);
+		}
+	}
+	get enabled() {
+		return this._extensions.every((extension) => extension.enabled);
+	}
+	get errors() {
+		return { captureException: (error, attributes) => {
+			for (const extension of this._getExtensions("errors")) extension.captureException(error, attributes);
+		} };
+	}
+	get events() {
+		return { captureEvent: (event, attributes) => {
+			for (const extension of this._getExtensions("events")) extension.captureEvent(event, attributes);
+		} };
+	}
+	get mcp() {
+		return {
+			captureInitialize: (client) => {
+				for (const extension of this._getExtensions("mcp")) extension.captureInitialize(client);
+			},
+			captureToolCall: (call) => {
+				for (const extension of this._getExtensions("mcp")) extension.captureToolCall(call);
+			}
+		};
+	}
+	get ai() {
+		return {
+			captureInference: (inference) => {
+				for (const extension of this._getExtensions("ai")) extension.captureInference(inference);
+			},
+			captureTurn: (turn) => {
+				for (const extension of this._getExtensions("ai")) extension.captureTurn(turn);
+			},
+			captureToolCall: (toolCall) => {
+				for (const extension of this._getExtensions("ai")) extension.captureToolCall(toolCall);
+			}
+		};
+	}
+	get support() {
+		return {
+			uploadLogs: async () => {
+				let key;
+				for (const extension of this._getExtensions("support")) key = await extension.uploadLogs() ?? key;
+				return key;
+			},
+			uploadNdjson: async (ndjson, kind) => {
+				let key;
+				for (const extension of this._getExtensions("support")) key = await extension.uploadNdjson(ndjson, kind) ?? key;
+				return key;
+			},
+			sessionContext: () => {
+				for (const extension of this._getExtensions("support")) {
+					const context = extension.sessionContext();
+					if (context) return context;
+				}
+			},
+			flushLogs: async (attributes) => {
+				for (const extension of this._getExtensions("support")) await extension.flushLogs(attributes);
+			}
+		};
+	}
+	isAvailable(kind) {
+		const apis = this._getExtensions(kind);
+		if (apis.length === 0) return Effect.succeed(false);
+		return Effect.gen({ self: this }, function* () {
+			for (const api of apis) if (yield* api.isAvailable()) return true;
+			return false;
+		});
+	}
+	get metrics() {
+		return {
+			gauge: (name, value, attributes, meta) => {
+				for (const extension of this._getExtensions("metrics")) extension.gauge(name, value, attributes, meta);
+			},
+			increment: (name, value, attributes, meta) => {
+				for (const extension of this._getExtensions("metrics")) extension.increment(name, value, attributes, meta);
+			},
+			distribution: (name, value, attributes, meta) => {
+				for (const extension of this._getExtensions("metrics")) extension.distribution(name, value, attributes, meta);
+			},
+			observe: (name, callback, attributes, meta) => {
+				const cleanups = this._getExtensions("metrics").map((extension) => extension.observe(name, callback, attributes, meta));
+				return () => {
+					for (const cleanup of cleanups) cleanup();
+				};
+			}
+		};
+	}
+	_getExtensions(kind) {
+		return Function.pipe(this._extensions, Array.flatMap((extension) => extension.apis), Array.filter((api) => api.kind === kind));
+	}
+};
+var make = () => Effect.succeed(new ObservabilityImpl());
+var addExtension = (_extension) => Effect.fn(function* (_observability) {
+	const observability = yield* _observability;
+	const extension = yield* _extension;
+	invariant("_addExtension" in observability && typeof observability._addExtension === "function", void 0, {
+		"~LogMeta": "~LogMeta",
+		F: __dxlog_file,
+		L: 367,
+		S: this,
+		A: ["'_addExtension' in observability && typeof observability._addExtension === 'function'", ""]
+	});
+	observability._addExtension(extension);
+	return observability;
+});
+var addDataProvider = (dataProvider) => Effect.fn(function* (_observability) {
+	const observability = yield* _observability;
+	invariant("_addDataProvider" in observability && typeof observability._addDataProvider === "function", void 0, {
+		"~LogMeta": "~LogMeta",
+		F: __dxlog_file,
+		L: 375,
+		S: this,
+		A: ["'_addDataProvider' in observability && typeof observability._addDataProvider === 'function'", ""]
+	});
+	observability._addDataProvider(dataProvider);
+	return observability;
+});
+var initialize = Effect.fn(function* (_observability) {
+	const observability = yield* _observability;
+	yield* observability.initialize();
+	return observability;
+});
+//#endregion
+export { make as a, initialize as i, addDataProvider as n, addExtension as r, Observability_exports as t };
+
+//# sourceMappingURL=chunk-Observability.mjs.map

package/dist/lib/chunk-Observability.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-Observability.mjs","names":[],"sources":["../../src/Observability.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Array from 'effect/Array';\nimport * as Effect from 'effect/Effect';\nimport * as Function from 'effect/Function';\n\nimport { type CleanupFn, SubscriptionList } from '@dxos/async';\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\n\nimport * as ObservabilityExtension from './ObservabilityExtension.ts';\n\nexport * from './storage/index.ts';\n\nconst attachAiCapture = async (observability: Observability): Promise<CleanupFn> => {\n  const { AiSpanProcessor, contentCaptureAllowed } = await import('./ai/AiObservability.ts');\n  const { Otel } = await import('./extensions/index.ts');\n  return Otel.addSpanProcessor(\n    new AiSpanProcessor({\n      captureInference: (inference) => observability.ai.captureInference(inference),\n      captureTurn: (turn) => observability.ai.captureTurn(turn),\n      captureToolCall: (toolCall) => observability.ai.captureToolCall(toolCall),\n      captureEnabled: () => observability.enabled,\n      allowContent: contentCaptureAllowed,\n    }),\n  );\n};\n\n// TODO(wittjosiah): Figure out how to handle when telemetry is disabled.\n//   In theory the setting should be both persisted and synchronized.\n//   Initialize probably should still run for the cases where data is emitted manually (e.g., support tickets).\n\n/**\n * Provider of observability data.\n */\nexport type DataProvider = (observability: Observability) => Effect.Effect<CleanupFn | void, Error>;\n\n/**\n * Extensible observability provider.\n */\n// TODO(wittjosiah): Add pipe method.\nexport interface Observability {\n  initialize(): Effect.Effect<void>;\n  close(): Effect.Effect<void>;\n  enable(): Effect.Effect<void>;\n  disable(): Effect.Effect<void>;\n  flush(): Effect.Effect<void>;\n  addDataProvider(dataProvider: DataProvider): Effect.Effect<void, Error>;\n  identify(\n    distinctId: string,\n    attributes?: ObservabilityExtension.Attributes,\n    setOnceAttributes?: ObservabilityExtension.Attributes,\n  ): void;\n  alias(distinctId: string, previousId?: string): void;\n  setTags(tags: ObservabilityExtension.Attributes, kind?: ObservabilityExtension.Kind): void;\n  enabled: boolean;\n  errors: ObservabilityExtension.Errors;\n  events: ObservabilityExtension.Events;\n  support: ObservabilityExtension.Support;\n  ai: ObservabilityExtension.Ai;\n  mcp: ObservabilityExtension.Mcp;\n  /** True if at least one extension of the given kind reports as available. */\n  isAvailable(kind: ObservabilityExtension.Kind): Effect.Effect<boolean>;\n  metrics: ObservabilityExtension.Metrics;\n}\n\nclass ObservabilityImpl implements Observability {\n  private _initialized = false;\n  private readonly _extensions: ObservabilityExtension.Extension[] = [];\n  private readonly _dataProviders: DataProvider[] = [];\n  private readonly _subscriptions = new SubscriptionList();\n\n  initialize(): Effect.Effect<void> {\n    if (this._initialized) {\n      return Effect.succeed(undefined);\n    }\n\n    const initializedExtensions: ObservabilityExtension.Extension[] = [];\n\n    return Effect.gen({ self: this }, function* () {\n      const context: ObservabilityExtension.ExtensionContext = {\n        setTags: (tags, kind) => this.setTags(tags, kind),\n      };\n      for (const extension of this._extensions) {\n        if (extension.initialize) {\n          yield* extension.initialize(context);\n        }\n        initializedExtensions.push(extension);\n      }\n\n      const cleanups = yield* Effect.all(this._dataProviders.map((provider) => provider(this)));\n      this._subscriptions.add(...cleanups.filter((cleanup) => cleanup !== undefined));\n      this._subscriptions.add(yield* Effect.promise(() => attachAiCapture(this)));\n      this._initialized = true;\n    }).pipe(\n      Effect.catch((error) =>\n        Effect.gen({ self: this }, function* () {\n          log.catch(error);\n          // Roll back already-initialized extensions.\n          for (const extension of initializedExtensions) {\n            if (extension.close) {\n              yield* extension.close().pipe(Effect.catch(() => Effect.succeed(undefined)));\n            }\n          }\n          this._subscriptions.clear();\n        }),\n      ),\n    );\n  }\n\n  close(): Effect.Effect<void> {\n    return Effect.gen({ self: this }, function* () {\n      this._subscriptions.clear();\n      this._dataProviders.length = 0;\n      for (const extension of this._extensions) {\n        if (extension.close) {\n          yield* extension.close();\n        }\n      }\n      this._initialized = false;\n    });\n  }\n\n  enable(): Effect.Effect<void> {\n    return Effect.gen({ self: this }, function* () {\n      for (const extension of this._extensions) {\n        if (extension.enable) {\n          yield* extension.enable();\n        }\n      }\n    });\n  }\n\n  disable(): Effect.Effect<void> {\n    return Effect.gen({ self: this }, function* () {\n      for (const extension of this._extensions) {\n        if (extension.disable) {\n          yield* extension.disable();\n        }\n      }\n    });\n  }\n\n  flush(): Effect.Effect<void> {\n    return Effect.gen({ self: this }, function* () {\n      for (const extension of this._extensions) {\n        if (extension.flush) {\n          yield* extension.flush();\n        }\n      }\n    });\n  }\n\n  _addExtension(extension: ObservabilityExtension.Extension): void {\n    invariant(!this._initialized, 'Observability is already initialized');\n    this._extensions.push(extension);\n  }\n\n  _addDataProvider(dataProvider: DataProvider): void {\n    invariant(!this._initialized, 'Observability is already initialized');\n    this._dataProviders.push(dataProvider);\n  }\n\n  /**\n   * Adds a data provider and initializes it.\n   */\n  addDataProvider(dataProvider: DataProvider): Effect.Effect<void, Error> {\n    return Effect.gen({ self: this }, function* () {\n      this._dataProviders.push(dataProvider);\n      const cleanup = yield* dataProvider(this);\n      if (cleanup) {\n        this._subscriptions.add(cleanup);\n      }\n    });\n  }\n\n  identify(\n    distinctId: string,\n    attributes?: ObservabilityExtension.Attributes,\n    setOnceAttributes?: ObservabilityExtension.Attributes,\n  ): void {\n    for (const extension of this._extensions) {\n      extension.identify?.(distinctId, attributes, setOnceAttributes);\n    }\n  }\n\n  alias(distinctId: string, previousId?: string): void {\n    for (const extension of this._extensions) {\n      extension.alias?.(distinctId, previousId);\n    }\n  }\n\n  setTags(tags: ObservabilityExtension.Attributes, kind?: ObservabilityExtension.Kind): void {\n    for (const extension of this._extensions) {\n      if (kind && !extension.apis.some((api) => api.kind === kind)) {\n        continue;\n      }\n\n      const processedTags = Object.fromEntries(\n        Object.entries(tags)\n          .filter((entry): entry is [string, string | number | boolean] => entry[1] !== undefined)\n          .map(([key, value]) => [key, value.toString()]),\n      );\n      extension.setTags?.(processedTags, kind);\n    }\n  }\n\n  get enabled(): boolean {\n    return this._extensions.every((extension) => extension.enabled);\n  }\n\n  get errors(): ObservabilityExtension.Errors {\n    return {\n      captureException: (error, attributes) => {\n        for (const extension of this._getExtensions('errors')) {\n          extension.captureException(error, attributes);\n        }\n      },\n    };\n  }\n\n  get events(): ObservabilityExtension.Events {\n    return {\n      captureEvent: (event, attributes) => {\n        for (const extension of this._getExtensions('events')) {\n          extension.captureEvent(event, attributes);\n        }\n      },\n    };\n  }\n\n  get mcp(): ObservabilityExtension.Mcp {\n    return {\n      captureInitialize: (client) => {\n        for (const extension of this._getExtensions('mcp')) {\n          extension.captureInitialize(client);\n        }\n      },\n      captureToolCall: (call) => {\n        for (const extension of this._getExtensions('mcp')) {\n          extension.captureToolCall(call);\n        }\n      },\n    };\n  }\n\n  get ai(): ObservabilityExtension.Ai {\n    return {\n      captureInference: (inference) => {\n        for (const extension of this._getExtensions('ai')) {\n          extension.captureInference(inference);\n        }\n      },\n      captureTurn: (turn) => {\n        for (const extension of this._getExtensions('ai')) {\n          extension.captureTurn(turn);\n        }\n      },\n      captureToolCall: (toolCall) => {\n        for (const extension of this._getExtensions('ai')) {\n          extension.captureToolCall(toolCall);\n        }\n      },\n    };\n  }\n\n  get support(): ObservabilityExtension.Support {\n    return {\n      uploadLogs: async () => {\n        let key: string | undefined;\n        for (const extension of this._getExtensions('support')) {\n          key = (await extension.uploadLogs()) ?? key;\n        }\n        return key;\n      },\n      uploadNdjson: async (ndjson, kind) => {\n        let key: string | undefined;\n        for (const extension of this._getExtensions('support')) {\n          key = (await extension.uploadNdjson(ndjson, kind)) ?? key;\n        }\n        return key;\n      },\n      sessionContext: () => {\n        for (const extension of this._getExtensions('support')) {\n          const context = extension.sessionContext();\n          if (context) {\n            return context;\n          }\n        }\n        return undefined;\n      },\n      flushLogs: async (attributes) => {\n        for (const extension of this._getExtensions('support')) {\n          await extension.flushLogs(attributes);\n        }\n      },\n    };\n  }\n\n  isAvailable(kind: ObservabilityExtension.Kind): Effect.Effect<boolean> {\n    const apis = this._getExtensions(kind);\n    if (apis.length === 0) {\n      return Effect.succeed(false);\n    }\n    return Effect.gen({ self: this }, function* () {\n      for (const api of apis) {\n        const available = yield* api.isAvailable();\n        if (available) {\n          return true;\n        }\n      }\n      return false;\n    });\n  }\n\n  get metrics(): ObservabilityExtension.Metrics {\n    return {\n      gauge: (name, value, attributes, meta) => {\n        for (const extension of this._getExtensions('metrics')) {\n          extension.gauge(name, value, attributes, meta);\n        }\n      },\n      increment: (name, value, attributes, meta) => {\n        for (const extension of this._getExtensions('metrics')) {\n          extension.increment(name, value, attributes, meta);\n        }\n      },\n      distribution: (name, value, attributes, meta) => {\n        for (const extension of this._getExtensions('metrics')) {\n          extension.distribution(name, value, attributes, meta);\n        }\n      },\n      observe: (name, callback, attributes, meta) => {\n        const cleanups = this._getExtensions('metrics').map((extension) =>\n          extension.observe(name, callback, attributes, meta),\n        );\n        return () => {\n          for (const cleanup of cleanups) {\n            cleanup();\n          }\n        };\n      },\n    };\n  }\n\n  private _getExtensions<T extends ObservabilityExtension.Kind>(\n    kind: T,\n  ): Extract<ObservabilityExtension.ExtensionApi, { kind: T }>[] {\n    return Function.pipe(\n      this._extensions,\n      Array.flatMap((extension) => extension.apis),\n      Array.filter((api): api is Extract<ObservabilityExtension.ExtensionApi, { kind: T }> => api.kind === kind),\n    );\n  }\n}\n\nexport const make = (): Effect.Effect<Observability> => Effect.succeed(new ObservabilityImpl());\n\nexport const addExtension = (_extension: Effect.Effect<ObservabilityExtension.Extension>) =>\n  Effect.fn(function* (_observability: Effect.Effect<Observability>) {\n    const observability = yield* _observability;\n    const extension = yield* _extension;\n    invariant('_addExtension' in observability && typeof observability._addExtension === 'function');\n    observability._addExtension(extension);\n    return observability;\n  });\n\nexport const addDataProvider = (dataProvider: DataProvider) =>\n  Effect.fn(function* (_observability: Effect.Effect<Observability>) {\n    const observability = yield* _observability;\n    invariant('_addDataProvider' in observability && typeof observability._addDataProvider === 'function');\n    observability._addDataProvider(dataProvider);\n    return observability;\n  });\n\nexport const initialize = Effect.fn(function* (_observability: Effect.Effect<Observability>) {\n  const observability = yield* _observability;\n  yield* observability.initialize();\n  return observability;\n});\n"],"mappings":"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"}