@saguiitay/eventhouse-ai-observability 0.1.1 → 0.2.0

package/dist/vercel.js

@@ -0,0 +1,369 @@
+import {
+  createObservability,
+  redactSecrets
+} from "./chunk-XGCHW72B.js";
+
+// src/adapters/vercel.ts
+import { AsyncLocalStorage } from "async_hooks";
+import {
+  trace,
+  INVALID_SPAN_CONTEXT,
+  SpanStatusCode
+} from "@opentelemetry/api";
+var operations = /* @__PURE__ */ new Set([
+  "invoke_agent",
+  "agent_step",
+  "chat",
+  "execute_tool"
+]);
+var textKeys = /* @__PURE__ */ new Set([
+  "ai.model.provider",
+  "ai.model.id",
+  "ai.response.id",
+  "ai.response.model",
+  "ai.response.finishReason",
+  "ai.toolCall.name",
+  "ai.toolCall.id",
+  "gen_ai.system",
+  "gen_ai.provider.name",
+  "gen_ai.tool.name",
+  "gen_ai.tool.call.id",
+  "gen_ai.tool.type",
+  "gen_ai.request.model",
+  "gen_ai.response.model",
+  "gen_ai.response.id",
+  "gen_ai.response.finish_reasons"
+]);
+var numberKeys = /* @__PURE__ */ new Set([
+  "gen_ai.request.frequency_penalty",
+  "gen_ai.request.max_tokens",
+  "gen_ai.request.presence_penalty",
+  "gen_ai.request.temperature",
+  "gen_ai.request.top_k",
+  "gen_ai.request.top_p",
+  "ai.response.msToFirstChunk",
+  "ai.response.msToFinish",
+  "ai.response.avgOutputTokensPerSecond",
+  "gen_ai.client.operation.duration",
+  "gen_ai.client.operation.time_to_first_chunk",
+  "gen_ai.client.operation.time_per_output_chunk",
+  "gen_ai.execute_tool.duration"
+]);
+var inputKeys = /* @__PURE__ */ new Set([
+  "ai.prompt",
+  "ai.prompt.messages",
+  "ai.toolCall.args",
+  "gen_ai.input.messages",
+  "gen_ai.system_instructions",
+  "gen_ai.tool.call.arguments"
+]);
+var outputKeys = /* @__PURE__ */ new Set([
+  "ai.response.text",
+  "ai.response.reasoning",
+  "ai.response.toolCalls",
+  "ai.toolCall.result",
+  "gen_ai.output.messages",
+  "gen_ai.tool.call.result"
+]);
+var aliases = {
+  "ai.model.provider": "gen_ai.provider.name",
+  "gen_ai.system": "gen_ai.provider.name",
+  "ai.model.id": "gen_ai.request.model",
+  "ai.response.id": "gen_ai.response.id",
+  "ai.response.model": "gen_ai.response.model",
+  "ai.toolCall.name": "gen_ai.tool.name",
+  "ai.toolCall.id": "gen_ai.tool.call.id",
+  "ai.prompt": "gen_ai.input.messages",
+  "ai.prompt.messages": "gen_ai.input.messages",
+  "ai.toolCall.args": "gen_ai.tool.arguments",
+  "ai.response.text": "gen_ai.output.messages",
+  "ai.response.reasoning": "gen_ai.output.reasoning",
+  "ai.response.toolCalls": "gen_ai.output.tool_calls",
+  "ai.toolCall.result": "gen_ai.tool.result",
+  "gen_ai.tool.call.arguments": "gen_ai.tool.arguments",
+  "gen_ai.tool.call.result": "gen_ai.tool.result"
+};
+var tokenAliases = {
+  "ai.usage.promptTokens": "gen_ai.usage.input_tokens",
+  "ai.usage.inputTokens": "gen_ai.usage.input_tokens",
+  "ai.usage.completionTokens": "gen_ai.usage.output_tokens",
+  "ai.usage.outputTokens": "gen_ai.usage.output_tokens",
+  "ai.usage.reasoningTokens": "gen_ai.usage.reasoning.output_tokens",
+  "ai.usage.outputTokenDetails.reasoningTokens": "gen_ai.usage.reasoning.output_tokens",
+  "ai.usage.cachedInputTokens": "gen_ai.usage.cache_read.input_tokens",
+  "ai.usage.inputTokenDetails.cacheReadTokens": "gen_ai.usage.cache_read.input_tokens",
+  "ai.usage.inputTokenDetails.cacheWriteTokens": "gen_ai.usage.cache_creation.input_tokens",
+  "gen_ai.usage.input_tokens": "gen_ai.usage.input_tokens",
+  "gen_ai.usage.output_tokens": "gen_ai.usage.output_tokens",
+  "gen_ai.usage.cache_read.input_tokens": "gen_ai.usage.cache_read.input_tokens",
+  "gen_ai.usage.cache_creation.input_tokens": "gen_ai.usage.cache_creation.input_tokens",
+  "gen_ai.usage.reasoning.output_tokens": "gen_ai.usage.reasoning.output_tokens"
+};
+function attachVercelAI(engine, options) {
+  const recordInputs = engine.captureContent && options.recordInputs === true;
+  const recordOutputs = engine.captureContent && options.recordOutputs === true;
+  let closed = false;
+  let shutdownPromise;
+  const active = /* @__PURE__ */ new Map();
+  const calls = /* @__PURE__ */ new Map();
+  const invocation = new AsyncLocalStorage();
+  let toolCount = 0;
+  function attributes(name, values) {
+    const result = {};
+    const model = name === "chat";
+    for (const [key, value] of Object.entries(values).slice(0, 128)) {
+      if (value === void 0) continue;
+      const tokenKey = tokenAliases[key];
+      if (tokenKey) {
+        if (model && typeof value === "number" && Number.isSafeInteger(value) && value >= 0)
+          result[tokenKey] = value;
+        continue;
+      }
+      if (numberKeys.has(key)) {
+        if (typeof value === "number" && Number.isFinite(value))
+          result[key] = value;
+        continue;
+      }
+      const content = recordInputs && inputKeys.has(key) || recordOutputs && outputKeys.has(key);
+      if (!textKeys.has(key) && !content) continue;
+      const clean = (item) => typeof item === "string" ? redactSecrets(item).slice(0, 4096) : void 0;
+      const cleaned = Array.isArray(value) ? value.slice(0, 16).filter((v) => typeof v === "string").map((v) => redactSecrets(v).slice(0, 4096)) : clean(value);
+      if (cleaned !== void 0) result[aliases[key] ?? key] = cleaned;
+    }
+    return result;
+  }
+  function startSpan(_requestedName, spanOptions = {}, parent) {
+    if (closed) return trace.wrapSpanContext(INVALID_SPAN_CONTEXT);
+    const operation = spanOptions.attributes?.["gen_ai.operation.name"];
+    const name = typeof operation === "string" && operations.has(operation) ? operation : "ai.operation";
+    const model = name === "chat";
+    const span = engine.startSpan(name, {
+      ...spanOptions.kind !== void 0 ? { kind: spanOptions.kind } : {},
+      ...spanOptions.startTime !== void 0 ? { startTime: spanOptions.startTime } : {},
+      // An empty SDK context must not replace the engine's local async parent.
+      ...parent && trace.getSpanContext(parent) ? { parent } : {},
+      attributes: {
+        "vercel.span.type": model ? "model_request" : name === "execute_tool" ? "tool" : name === "agent_step" ? "step" : "turn",
+        "gen_ai.operation.name": name,
+        ...attributes(name, spanOptions.attributes ?? {})
+      }
+    });
+    let ended = false;
+    const wrapped = {
+      spanContext: () => span.spanContext(),
+      isRecording: () => !closed && !ended && span.isRecording(),
+      setAttribute(key, value) {
+        return wrapped.setAttributes({ [key]: value });
+      },
+      setAttributes(values) {
+        if (!closed && !ended) {
+          span.setAttributes(attributes(name, values));
+          if (values["ai.response.finishReason"] === "error" || Array.isArray(values["gen_ai.response.finish_reasons"]) && values["gen_ai.response.finish_reasons"].includes("error")) {
+            span.setStatus({ code: SpanStatusCode.ERROR });
+            span.setAttribute("error.type", "provider_error");
+          }
+        }
+        return wrapped;
+      },
+      addEvent() {
+        return wrapped;
+      },
+      addLink() {
+        return wrapped;
+      },
+      addLinks() {
+        return wrapped;
+      },
+      setStatus(status) {
+        if (!closed && !ended) {
+          span.setStatus({ code: status.code });
+          if (status.code === SpanStatusCode.ERROR)
+            span.setAttribute("error.type", "provider_error");
+        }
+        return wrapped;
+      },
+      updateName() {
+        return wrapped;
+      },
+      recordException() {
+        if (!closed && !ended)
+          span.addEvent("exception", { "exception.type": "provider_error" });
+      },
+      end(time) {
+        if (ended) return;
+        ended = true;
+        active.delete(wrapped);
+        span.end(time);
+      }
+    };
+    if (span.isRecording()) active.set(wrapped, span);
+    const current = invocation.getStore();
+    const call = current ? calls.get(current.callId) : void 0;
+    if (call) {
+      if (model) call.model = wrapped;
+      if (name === "execute_tool" && current?.toolCallId) {
+        if (!call.tools.has(current.toolCallId)) toolCount++;
+        call.tools.set(current.toolCallId, wrapped);
+      }
+    }
+    return wrapped;
+  }
+  const tracer = {
+    startSpan,
+    startActiveSpan(name, ...args) {
+      const callback = args[args.length - 1];
+      const settings = args.length > 1 ? args[0] : {};
+      const parent = args.length === 3 ? args[1] : void 0;
+      const started = startSpan(name, settings, parent);
+      return engine.withSpan(started, () => callback(started));
+    }
+  };
+  const native = options.integration(tracer);
+  const wrappedIntegration = new Proxy(native, {
+    get(target, property, receiver) {
+      const method = Reflect.get(target, property, receiver);
+      if (typeof method !== "function") return method;
+      return (...args) => {
+        let event = args[0];
+        const callId = event?.callId;
+        if (!event || !callId) return Reflect.apply(method, target, args);
+        if (closed) {
+          return event?.execute?.();
+        }
+        if (event.error !== void 0 || event.toolOutput?.error !== void 0) {
+          const failure = new Error("Provider operation failed");
+          failure.name = "ProviderError";
+          event = {
+            ...event,
+            ...event.error !== void 0 ? { error: failure } : {},
+            ...event.toolOutput?.error !== void 0 ? { toolOutput: { ...event.toolOutput, error: failure } } : {}
+          };
+          args = [event, ...args.slice(1)];
+        }
+        if (property === "onStart") {
+          if (calls.size >= engine.maxActiveSpans) return;
+          calls.set(callId, { tools: /* @__PURE__ */ new Map() });
+        }
+        const call = calls.get(callId);
+        if (!call) return event?.execute?.();
+        if (property === "onLanguageModelCallEnd" && call.model && event.usage) {
+          call.model.setAttributes({
+            "gen_ai.usage.cache_read.input_tokens": event.usage.inputTokenDetails?.cacheReadTokens,
+            "gen_ai.usage.cache_creation.input_tokens": event.usage.inputTokenDetails?.cacheWriteTokens,
+            "gen_ai.usage.reasoning.output_tokens": event.usage.outputTokenDetails?.reasoningTokens
+          });
+        }
+        const toolCallId = event.toolCallId ?? event.toolCall?.toolCallId;
+        if (property === "onToolExecutionStart" && toolCount >= engine.maxActiveSpans)
+          return;
+        if (property === "executeLanguageModelCall" || property === "executeTool") {
+          const parent = property === "executeTool" ? toolCallId ? call.tools.get(toolCallId) : void 0 : call.model;
+          const execute = event.execute;
+          const invoke = () => Reflect.apply(method, target, [
+            {
+              ...event,
+              ...parent && execute ? { execute: () => engine.withSpan(parent, execute) } : {}
+            },
+            ...args.slice(1)
+          ]);
+          return parent ? engine.withSpan(parent, invoke) : invoke();
+        }
+        const result = invocation.run(
+          { callId, ...toolCallId ? { toolCallId } : {} },
+          () => Reflect.apply(method, target, args)
+        );
+        const terminal = property === "onEnd" || property === "onAbort" || property === "onError";
+        if ((property === "onStepEnd" || terminal) && call.model) {
+          const span = call.model;
+          active.get(span)?.setAttribute("observability.incomplete", true);
+          if (event.finishReason === "error" || property === "onAbort" || property === "onError")
+            span.setStatus({ code: SpanStatusCode.ERROR });
+          span.end(
+            typeof event.timestamp === "number" ? new Date(event.timestamp) : void 0
+          );
+          delete call.model;
+        }
+        if (property === "onToolExecutionEnd" && toolCallId) {
+          if (call.tools.delete(toolCallId)) toolCount--;
+        }
+        if (property === "onLanguageModelCallEnd") delete call.model;
+        if (terminal) {
+          for (const span of call.tools.values()) {
+            active.get(span)?.setAttribute("observability.incomplete", true);
+            span.end();
+          }
+          toolCount -= call.tools.size;
+          calls.delete(callId);
+        }
+        return result;
+      };
+    }
+  });
+  const telemetry = {
+    isEnabled: true,
+    recordInputs,
+    recordOutputs,
+    integrations: [wrappedIntegration]
+  };
+  return {
+    telemetry,
+    flush: () => engine.flush(),
+    getDiagnostics: () => engine.getDiagnostics(),
+    shutdown() {
+      shutdownPromise ??= (async () => {
+        closed = true;
+        telemetry.isEnabled = false;
+        for (const span of active.values())
+          span.setAttribute("observability.incomplete", true);
+        if (native.onError) {
+          for (const callId of calls.keys()) {
+            try {
+              Reflect.apply(native.onError, native, [
+                { callId, error: new Error("Observation ended") }
+              ]);
+            } catch {
+            }
+          }
+        }
+        for (const [wrapped, span] of active) {
+          span.setAttribute("observability.incomplete", true);
+          wrapped.end();
+        }
+        calls.clear();
+        toolCount = 0;
+        invocation.disable();
+        if (options.shutdownEngine) await engine.shutdown();
+        else await engine.flush();
+      })();
+      return shutdownPromise;
+    }
+  };
+}
+
+// src/vercel.ts
+function observeVercelAI(options) {
+  if (typeof options?.integration !== "function")
+    throw new Error(
+      "A native Vercel telemetry integration factory is required"
+    );
+  if (options.engine) return attachVercelAI(options.engine, options);
+  if (options.shutdownEngine === false)
+    throw new Error(
+      "shutdownEngine: false requires an externally owned engine"
+    );
+  const engine = createObservability(options);
+  try {
+    return attachVercelAI(engine, {
+      ...options,
+      shutdownEngine: true
+    });
+  } catch (error) {
+    void engine.shutdown().catch(() => {
+    });
+    throw error;
+  }
+}
+export {
+  observeVercelAI
+};
+//# sourceMappingURL=vercel.js.map

package/dist/vercel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/vercel.ts","../src/vercel.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport {\n  trace,\n  INVALID_SPAN_CONTEXT,\n  SpanStatusCode,\n  type Attributes,\n  type AttributeValue,\n  type Context,\n  type Span,\n  type SpanOptions,\n  type Tracer,\n} from \"@opentelemetry/api\";\nimport type { LanguageModelUsage, TelemetryOptions, Telemetry } from \"ai\";\nimport { redactSecrets, type Observability } from \"../engine.js\";\n\nexport type VercelTelemetrySettings = TelemetryOptions;\n\nexport interface VercelAdapterOptions {\n  /** Supply the SDK's native integration: tracer => new OpenTelemetry({ tracer }). */\n  integration: (tracer: Tracer) => Telemetry;\n  /** Also requires captureContent on the engine. Defaults to false. */\n  recordInputs?: boolean;\n  /** Also requires captureContent on the engine. Defaults to false. */\n  recordOutputs?: boolean;\n  /** Explicitly transfers engine shutdown ownership. Defaults to false. */\n  shutdownEngine?: boolean;\n}\n\nconst operations = new Set([\n  \"invoke_agent\",\n  \"agent_step\",\n  \"chat\",\n  \"execute_tool\",\n]);\nconst textKeys = new Set([\n  \"ai.model.provider\",\n  \"ai.model.id\",\n  \"ai.response.id\",\n  \"ai.response.model\",\n  \"ai.response.finishReason\",\n  \"ai.toolCall.name\",\n  \"ai.toolCall.id\",\n  \"gen_ai.system\",\n  \"gen_ai.provider.name\",\n  \"gen_ai.tool.name\",\n  \"gen_ai.tool.call.id\",\n  \"gen_ai.tool.type\",\n  \"gen_ai.request.model\",\n  \"gen_ai.response.model\",\n  \"gen_ai.response.id\",\n  \"gen_ai.response.finish_reasons\",\n]);\nconst numberKeys = new Set([\n  \"gen_ai.request.frequency_penalty\",\n  \"gen_ai.request.max_tokens\",\n  \"gen_ai.request.presence_penalty\",\n  \"gen_ai.request.temperature\",\n  \"gen_ai.request.top_k\",\n  \"gen_ai.request.top_p\",\n  \"ai.response.msToFirstChunk\",\n  \"ai.response.msToFinish\",\n  \"ai.response.avgOutputTokensPerSecond\",\n  \"gen_ai.client.operation.duration\",\n  \"gen_ai.client.operation.time_to_first_chunk\",\n  \"gen_ai.client.operation.time_per_output_chunk\",\n  \"gen_ai.execute_tool.duration\",\n]);\nconst inputKeys = new Set([\n  \"ai.prompt\",\n  \"ai.prompt.messages\",\n  \"ai.toolCall.args\",\n  \"gen_ai.input.messages\",\n  \"gen_ai.system_instructions\",\n  \"gen_ai.tool.call.arguments\",\n]);\nconst outputKeys = new Set([\n  \"ai.response.text\",\n  \"ai.response.reasoning\",\n  \"ai.response.toolCalls\",\n  \"ai.toolCall.result\",\n  \"gen_ai.output.messages\",\n  \"gen_ai.tool.call.result\",\n]);\nconst aliases: Record<string, string> = {\n  \"ai.model.provider\": \"gen_ai.provider.name\",\n  \"gen_ai.system\": \"gen_ai.provider.name\",\n  \"ai.model.id\": \"gen_ai.request.model\",\n  \"ai.response.id\": \"gen_ai.response.id\",\n  \"ai.response.model\": \"gen_ai.response.model\",\n  \"ai.toolCall.name\": \"gen_ai.tool.name\",\n  \"ai.toolCall.id\": \"gen_ai.tool.call.id\",\n  \"ai.prompt\": \"gen_ai.input.messages\",\n  \"ai.prompt.messages\": \"gen_ai.input.messages\",\n  \"ai.toolCall.args\": \"gen_ai.tool.arguments\",\n  \"ai.response.text\": \"gen_ai.output.messages\",\n  \"ai.response.reasoning\": \"gen_ai.output.reasoning\",\n  \"ai.response.toolCalls\": \"gen_ai.output.tool_calls\",\n  \"ai.toolCall.result\": \"gen_ai.tool.result\",\n  \"gen_ai.tool.call.arguments\": \"gen_ai.tool.arguments\",\n  \"gen_ai.tool.call.result\": \"gen_ai.tool.result\",\n};\nconst tokenAliases: Record<string, string> = {\n  \"ai.usage.promptTokens\": \"gen_ai.usage.input_tokens\",\n  \"ai.usage.inputTokens\": \"gen_ai.usage.input_tokens\",\n  \"ai.usage.completionTokens\": \"gen_ai.usage.output_tokens\",\n  \"ai.usage.outputTokens\": \"gen_ai.usage.output_tokens\",\n  \"ai.usage.reasoningTokens\": \"gen_ai.usage.reasoning.output_tokens\",\n  \"ai.usage.outputTokenDetails.reasoningTokens\":\n    \"gen_ai.usage.reasoning.output_tokens\",\n  \"ai.usage.cachedInputTokens\": \"gen_ai.usage.cache_read.input_tokens\",\n  \"ai.usage.inputTokenDetails.cacheReadTokens\":\n    \"gen_ai.usage.cache_read.input_tokens\",\n  \"ai.usage.inputTokenDetails.cacheWriteTokens\":\n    \"gen_ai.usage.cache_creation.input_tokens\",\n  \"gen_ai.usage.input_tokens\": \"gen_ai.usage.input_tokens\",\n  \"gen_ai.usage.output_tokens\": \"gen_ai.usage.output_tokens\",\n  \"gen_ai.usage.cache_read.input_tokens\":\n    \"gen_ai.usage.cache_read.input_tokens\",\n  \"gen_ai.usage.cache_creation.input_tokens\":\n    \"gen_ai.usage.cache_creation.input_tokens\",\n  \"gen_ai.usage.reasoning.output_tokens\":\n    \"gen_ai.usage.reasoning.output_tokens\",\n};\n\n/**\n * Native SDK instrumentation calls this tracer, not a global provider. Every\n * mutation is filtered before reaching the private engine, including errors\n * and attributes that the SDK's recording flags do not protect.\n */\nexport function attachVercelAI(\n  engine: Observability,\n  options: VercelAdapterOptions,\n) {\n  const recordInputs = engine.captureContent && options.recordInputs === true;\n  const recordOutputs = engine.captureContent && options.recordOutputs === true;\n  let closed = false;\n  let shutdownPromise: Promise<void> | undefined;\n  const active = new Map<Span, Span>();\n  const calls = new Map<string, { model?: Span; tools: Map<string, Span> }>();\n  const invocation = new AsyncLocalStorage<{\n    callId: string;\n    toolCallId?: string;\n  }>();\n  let toolCount = 0;\n\n  function attributes(name: string, values: Attributes): Attributes {\n    const result: Attributes = {};\n    const model = name === \"chat\";\n    for (const [key, value] of Object.entries(values).slice(0, 128)) {\n      if (value === undefined) continue;\n      const tokenKey = tokenAliases[key];\n      if (tokenKey) {\n        if (\n          model &&\n          typeof value === \"number\" &&\n          Number.isSafeInteger(value) &&\n          value >= 0\n        )\n          result[tokenKey] = value;\n        continue;\n      }\n      if (numberKeys.has(key)) {\n        if (typeof value === \"number\" && Number.isFinite(value))\n          result[key] = value;\n        continue;\n      }\n      const content =\n        (recordInputs && inputKeys.has(key)) ||\n        (recordOutputs && outputKeys.has(key));\n      if (!textKeys.has(key) && !content) continue;\n      const clean = (item: AttributeValue): AttributeValue | undefined =>\n        typeof item === \"string\"\n          ? redactSecrets(item).slice(0, 4096)\n          : undefined;\n      const cleaned = Array.isArray(value)\n        ? value\n            .slice(0, 16)\n            .filter((v): v is string => typeof v === \"string\")\n            .map((v) => redactSecrets(v).slice(0, 4096))\n        : clean(value);\n      if (cleaned !== undefined) result[aliases[key] ?? key] = cleaned;\n    }\n    return result;\n  }\n\n  function startSpan(\n    _requestedName: string,\n    spanOptions: SpanOptions = {},\n    parent?: Context,\n  ): Span {\n    if (closed) return trace.wrapSpanContext(INVALID_SPAN_CONTEXT);\n    const operation = spanOptions.attributes?.[\"gen_ai.operation.name\"];\n    const name =\n      typeof operation === \"string\" && operations.has(operation)\n        ? operation\n        : \"ai.operation\";\n    const model = name === \"chat\";\n    const span = engine.startSpan(name, {\n      ...(spanOptions.kind !== undefined ? { kind: spanOptions.kind } : {}),\n      ...(spanOptions.startTime !== undefined\n        ? { startTime: spanOptions.startTime }\n        : {}),\n      // An empty SDK context must not replace the engine's local async parent.\n      ...(parent && trace.getSpanContext(parent) ? { parent } : {}),\n      attributes: {\n        \"vercel.span.type\": model\n          ? \"model_request\"\n          : name === \"execute_tool\"\n            ? \"tool\"\n            : name === \"agent_step\"\n              ? \"step\"\n              : \"turn\",\n        \"gen_ai.operation.name\": name,\n        ...attributes(name, spanOptions.attributes ?? {}),\n      },\n    });\n    let ended = false;\n    const wrapped: Span = {\n      spanContext: () => span.spanContext(),\n      isRecording: () => !closed && !ended && span.isRecording(),\n      setAttribute(key, value) {\n        return wrapped.setAttributes({ [key]: value });\n      },\n      setAttributes(values) {\n        if (!closed && !ended) {\n          span.setAttributes(attributes(name, values));\n          if (\n            values[\"ai.response.finishReason\"] === \"error\" ||\n            (Array.isArray(values[\"gen_ai.response.finish_reasons\"]) &&\n              values[\"gen_ai.response.finish_reasons\"].includes(\"error\"))\n          ) {\n            span.setStatus({ code: SpanStatusCode.ERROR });\n            span.setAttribute(\"error.type\", \"provider_error\");\n          }\n        }\n        return wrapped;\n      },\n      addEvent() {\n        // Native events may contain arbitrary exception or provider content.\n        return wrapped;\n      },\n      addLink() {\n        return wrapped;\n      },\n      addLinks() {\n        return wrapped;\n      },\n      setStatus(status) {\n        if (!closed && !ended) {\n          span.setStatus({ code: status.code });\n          if (status.code === SpanStatusCode.ERROR)\n            span.setAttribute(\"error.type\", \"provider_error\");\n        }\n        return wrapped;\n      },\n      updateName() {\n        return wrapped;\n      },\n      recordException() {\n        if (!closed && !ended)\n          span.addEvent(\"exception\", { \"exception.type\": \"provider_error\" });\n      },\n      end(time) {\n        if (ended) return;\n        ended = true;\n        active.delete(wrapped);\n        span.end(time);\n      },\n    };\n    if (span.isRecording()) active.set(wrapped, span);\n    const current = invocation.getStore();\n    const call = current ? calls.get(current.callId) : undefined;\n    if (call) {\n      if (model) call.model = wrapped;\n      if (name === \"execute_tool\" && current?.toolCallId) {\n        if (!call.tools.has(current.toolCallId)) toolCount++;\n        call.tools.set(current.toolCallId, wrapped);\n      }\n    }\n    return wrapped;\n  }\n\n  const tracer: Tracer = {\n    startSpan,\n    startActiveSpan<F extends (span: Span) => unknown>(\n      name: string,\n      ...args: [F] | [SpanOptions, F] | [SpanOptions, Context, F]\n    ): ReturnType<F> {\n      const callback = args[args.length - 1] as F;\n      const settings = args.length > 1 ? (args[0] as SpanOptions) : {};\n      const parent = args.length === 3 ? (args[1] as Context) : undefined;\n      const started = startSpan(name, settings, parent);\n      return engine.withSpan(started, () => callback(started)) as ReturnType<F>;\n    },\n  };\n\n  const native = options.integration(tracer);\n  const wrappedIntegration = new Proxy(native, {\n    get(target, property, receiver) {\n      const method: unknown = Reflect.get(target, property, receiver);\n      if (typeof method !== \"function\") return method;\n      return (...args: unknown[]) => {\n        let event = args[0] as\n          | {\n              callId?: string;\n              toolCallId?: string;\n              toolCall?: { toolCallId?: string };\n              execute?: () => PromiseLike<unknown>;\n              error?: unknown;\n              toolOutput?: { type: string; error?: unknown };\n              finishReason?: string;\n              usage?: LanguageModelUsage;\n              timestamp?: number;\n            }\n          | undefined;\n        const callId = event?.callId;\n        if (!event || !callId) return Reflect.apply(method, target, args);\n        if (closed) {\n          return event?.execute?.();\n        }\n        if (\n          event.error !== undefined ||\n          event.toolOutput?.error !== undefined\n        ) {\n          const failure = new Error(\"Provider operation failed\");\n          failure.name = \"ProviderError\";\n          event = {\n            ...event,\n            ...(event.error !== undefined ? { error: failure } : {}),\n            ...(event.toolOutput?.error !== undefined\n              ? { toolOutput: { ...event.toolOutput, error: failure } }\n              : {}),\n          };\n          args = [event, ...args.slice(1)];\n        }\n        if (property === \"onStart\") {\n          if (calls.size >= engine.maxActiveSpans) return;\n          calls.set(callId, { tools: new Map() });\n        }\n        const call = calls.get(callId);\n        if (!call) return event?.execute?.();\n        if (\n          property === \"onLanguageModelCallEnd\" &&\n          call.model &&\n          event.usage\n        ) {\n          // Native OTel ends this span inside the hook; reasoning attributes\n          // otherwise depend on its optional supplemental-usage setting.\n          call.model.setAttributes({\n            \"gen_ai.usage.cache_read.input_tokens\":\n              event.usage.inputTokenDetails?.cacheReadTokens,\n            \"gen_ai.usage.cache_creation.input_tokens\":\n              event.usage.inputTokenDetails?.cacheWriteTokens,\n            \"gen_ai.usage.reasoning.output_tokens\":\n              event.usage.outputTokenDetails?.reasoningTokens,\n          });\n        }\n        const toolCallId = event.toolCallId ?? event.toolCall?.toolCallId;\n        if (\n          property === \"onToolExecutionStart\" &&\n          toolCount >= engine.maxActiveSpans\n        )\n          return;\n        if (\n          property === \"executeLanguageModelCall\" ||\n          property === \"executeTool\"\n        ) {\n          const parent =\n            property === \"executeTool\"\n              ? toolCallId\n                ? call.tools.get(toolCallId)\n                : undefined\n              : call.model;\n          const execute = event.execute;\n          const invoke = () =>\n            Reflect.apply(method, target, [\n              {\n                ...event,\n                ...(parent && execute\n                  ? { execute: () => engine.withSpan(parent, execute) }\n                  : {}),\n              },\n              ...args.slice(1),\n            ]);\n          return parent ? engine.withSpan(parent, invoke) : invoke();\n        }\n        const result = invocation.run(\n          { callId, ...(toolCallId ? { toolCallId } : {}) },\n          () => Reflect.apply(method, target, args),\n        );\n        const terminal =\n          property === \"onEnd\" ||\n          property === \"onAbort\" ||\n          property === \"onError\";\n        // Error-only streams may end a step without a model-call end event.\n        // Finish the existing native span; do not infer usage from its parent.\n        if ((property === \"onStepEnd\" || terminal) && call.model) {\n          const span = call.model;\n          active.get(span)?.setAttribute(\"observability.incomplete\", true);\n          if (\n            event.finishReason === \"error\" ||\n            property === \"onAbort\" ||\n            property === \"onError\"\n          )\n            span.setStatus({ code: SpanStatusCode.ERROR });\n          span.end(\n            typeof event.timestamp === \"number\"\n              ? new Date(event.timestamp)\n              : undefined,\n          );\n          delete call.model;\n        }\n        if (property === \"onToolExecutionEnd\" && toolCallId) {\n          if (call.tools.delete(toolCallId)) toolCount--;\n        }\n        if (property === \"onLanguageModelCallEnd\") delete call.model;\n        if (terminal) {\n          for (const span of call.tools.values()) {\n            active.get(span)?.setAttribute(\"observability.incomplete\", true);\n            span.end();\n          }\n          toolCount -= call.tools.size;\n          calls.delete(callId);\n        }\n        return result;\n      };\n    },\n  });\n  const telemetry: VercelTelemetrySettings = {\n    isEnabled: true,\n    recordInputs,\n    recordOutputs,\n    integrations: [wrappedIntegration],\n  };\n  return {\n    telemetry,\n    flush: () => engine.flush(),\n    getDiagnostics: () => engine.getDiagnostics(),\n    shutdown() {\n      shutdownPromise ??= (async () => {\n        closed = true;\n        telemetry.isEnabled = false;\n        for (const span of active.values())\n          span.setAttribute(\"observability.incomplete\", true);\n        if (native.onError) {\n          for (const callId of calls.keys()) {\n            try {\n              Reflect.apply(native.onError, native, [\n                { callId, error: new Error(\"Observation ended\") },\n              ]);\n            } catch {}\n          }\n        }\n        for (const [wrapped, span] of active) {\n          span.setAttribute(\"observability.incomplete\", true);\n          wrapped.end();\n        }\n        calls.clear();\n        toolCount = 0;\n        invocation.disable();\n        if (options.shutdownEngine) await engine.shutdown();\n        else await engine.flush();\n      })();\n      return shutdownPromise;\n    },\n  };\n}\n","import {\n  attachVercelAI,\n  type VercelAdapterOptions,\n} from \"./adapters/vercel.js\";\nimport {\n  createObservability,\n  type EventhouseObservabilityOptions,\n} from \"./index.js\";\nimport type { Observability } from \"./engine.js\";\n\nexport type {\n  VercelAdapterOptions,\n  VercelTelemetrySettings,\n} from \"./adapters/vercel.js\";\n\nexport type VercelObservabilityOptions = VercelAdapterOptions &\n  (\n    | (EventhouseObservabilityOptions & { engine?: never })\n    | { engine: Observability }\n  );\n\nexport function observeVercelAI(options: VercelObservabilityOptions) {\n  if (typeof options?.integration !== \"function\")\n    throw new Error(\n      \"A native Vercel telemetry integration factory is required\",\n    );\n  if (options.engine) return attachVercelAI(options.engine, options);\n  if (options.shutdownEngine === false)\n    throw new Error(\n      \"shutdownEngine: false requires an externally owned engine\",\n    );\n  const engine = createObservability(options);\n  try {\n    return attachVercelAI(engine, {\n      ...options,\n      shutdownEngine: true,\n    });\n  } catch (error) {\n    void engine.shutdown().catch(() => {});\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}

package/docs/architecture.md

@@ -1,14 +1,21 @@
 # Architecture
 
 ```text
-Existing Copilot session -> independent event adapter -> private OTel TracerProvider
+Copilot events / OpenAI requests / Vercel native telemetry
+  -> independent SDK adapters -> private OTel TracerProvider
   -> privacy filtering -> OpenTelemetry BatchSpanProcessor -> SpanExporter
     -> Event Hubs producer / Fabric Eventstream Custom endpoint SOURCE
       -> Eventhouse / KQL / native Real-Time Dashboards
-    -> optional existing OTLP/HTTP destination
+    -> application-supplied standard exporter (for example, official OTLP/HTTP)
 ```
 
-There is one root npm package, not a package-per-module workspace. `src/engine.ts` configures the official OpenTelemetry SDK. `src/adapters/copilot.ts` consumes its small `Observability` interface. `src/exporters/eventstream.ts` implements the standard OTel `SpanExporter` contract; the OTLP path uses the official `OTLPTraceExporter` directly. `src/index.ts` and `src/copilot.ts` are the public entry points.
+There is one root npm package, not a package-per-module workspace. `src/engine.ts` configures the official OpenTelemetry SDK. SDK adapters consume its small `Observability` interface. `src/exporters/eventstream.ts` implements the standard OTel `SpanExporter` contract. Fabric is the only built-in transport; other transports are supplied through `exporter`, with their dependencies and settings owned by the application. The root runtime does not load an OTLP exporter. The root exports `createObservability`, `EventstreamExporter`, and public configuration, observability, exporter, diagnostic, and redactor types. `createEngine`, `serializeSpan`, and `redactSecrets` remain internal module exports for implementation and tests, not supported root imports. `/copilot`, `/openai`, and `/vercel` provide independent integrations. SDK dependencies are optional peers and are not loaded by the root runtime.
+
+Instrument each model call through one adapter. If Vercel already records a
+provider call, also wrapping that provider's OpenAI client would produce another
+model span and double-count token usage in the supplied analytics. Applications
+can share an engine across independent adapters, with one explicit owner of its
+shutdown lifecycle.
 
 ## OpenTelemetry coexistence
 
@@ -16,6 +23,15 @@ The engine creates a **private OpenTelemetry 3 TracerProvider**. It never regist
 
 This design intentionally does not attach a processor to an existing provider: current providers do not offer safe mutable processor registration. Existing application spans continue to use their existing exporters. To export other spans here, configure a processor/transport at your application's own provider initialization; the SDK does not steal or duplicate that provider's lifecycle.
 
+The public `EventstreamExporter` supports this application-owned path: construct
+the official SDK 3 `BatchSpanProcessor({ exporter })` and pass the processor in
+`new TracerProvider({ spanProcessors: [...] })`. See the
+[provider example](extending.md#export-spans-from-an-application-owned-provider).
+The application owns that provider's resource, sampling, privacy policy, global
+registration, and shutdown. Direct exporter use does not apply the private
+engine's sanitizer or diagnostics. Use separate exporter instances for separate
+provider lifecycles.
+
 ## Reliability and lifecycle
 
 Event callbacks create/end spans without waiting on I/O. The standard `BatchSpanProcessor` owns batching, its bounded queue, scheduling, and flush lifecycle. A thin privacy/diagnostic wrapper defers actual exporter calls to a microtask so network work does not run inside event callbacks. `maxConcurrentExports` (default `4`) limits underlying exporter calls, including calls whose callback deadline has expired. Native batches wait for a concurrency slot within their callback deadline and the existing `maxQueueSize` admission budget; there is no second span queue. This bounds native `forceFlush` fan-out without dropping a healthy admitted backlog. Waiting spans still count toward queue depth, so new admissions are dropped if the budget fills. Unfinished spans have a separate configurable bound. Per-span attribute/event/link counts and value sizes are limited.

package/docs/copilot-adapter.md

@@ -7,7 +7,7 @@ import { observeCopilot } from "@saguiitay/eventhouse-ai-observability/copilot";
 
 const observer = observeCopilot(session, {
   serviceName: "my-agent",
-  // Configure Fabric or an OTLP destination using options/environment.
+  // Configure Fabric using options/environment, or supply a custom exporter.
   captureContent: false,
 });
 try {

package/docs/extending.md

@@ -30,4 +30,48 @@ Subscribe without changing framework behavior, use exact framework timestamps, a
 
 Supply a standard OpenTelemetry `SpanExporter` via `createObservability({ exporter })`; it receives sanitized `ReadableSpan[]` values and reports success/failure through the standard result callback. Batching and flush scheduling belong to OTel's `BatchSpanProcessor`. Use the callback exactly once, implement `shutdown`, bound I/O/retries, and never log raw errors with credentials.
 
-Vercel AI SDK, OpenAI Agents SDK, LangChain/LangGraph, and Semantic Kernel adapters are intentionally not implemented.
+## Export spans from an application-owned provider
+
+If your application already initializes an OpenTelemetry provider, pass the
+public `EventstreamExporter` to the official SDK 3 `BatchSpanProcessor` when
+constructing that provider:
+
+```typescript
+import { EventstreamExporter } from "@saguiitay/eventhouse-ai-observability";
+import { BatchSpanProcessor, TracerProvider } from "@opentelemetry/sdk-trace";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+
+const exporter = new EventstreamExporter({
+  connectionString: process.env.FABRIC_EVENTSTREAM_CONNECTION_STRING!,
+  // entityName: "my-eventstream", // Required if the string lacks EntityPath.
+});
+const provider = new TracerProvider({
+  resource: resourceFromAttributes({ "service.name": "my-application" }),
+  spanProcessors: [new BatchSpanProcessor({ exporter })],
+});
+
+provider.getTracer("my-application").startSpan("application-work").end();
+await provider.shutdown();
+```
+
+SDK 3 takes an options object (`{ exporter }`) in `BatchSpanProcessor` and
+processors in the provider constructor; do not call
+`addSpanProcessor`. Add this processor alongside your application's other
+processors at initialization. Keep any global provider, context-manager, and
+propagator setup under application control. The application owns flushing and
+shutdown; do not share this exporter instance with a separate observability
+engine.
+
+Direct export bypasses the engine's privacy filtering, redactor, diagnostics,
+and resource/sampling configuration. Apply your application's privacy policy
+before spans reach the exporter. `EventstreamExporter` serializes spans and
+handles transport limits; it is not a sanitizer.
+
+The root API provides `createObservability`, `EventstreamExporter`, and public
+configuration, exporter, observability, diagnostic, and redactor types.
+`createEngine`, `serializeSpan`, and `redactSecrets` are internal helpers, not
+public imports. Use `createObservability({ exporter })` for custom transports
+and the `redact` option for application-specific attribute filtering. The
+adapter subpaths remain `/copilot`, `/openai`, and `/vercel`.
+
+The existing [Copilot](copilot-adapter.md), [OpenAI](openai-adapter.md), and [Vercel AI](vercel-adapter.md) integrations use different instrumentation surfaces while sharing the engine and transports. Add framework-specific entry points rather than introducing separate copies of batching, privacy, or Fabric export.

package/docs/fabric-setup.md

@@ -1,5 +1,29 @@
 # Fabric setup
 
+## Obtain the setup assets
+
+Starting with the prepared **0.2.0** package, install the SDK first and extract
+`fabric-setup.zip` from its installed package root. See the
+[PowerShell install/extract commands](../README.md#fabric-setup-bundle-and-ingestion-check).
+The source repository is private: GitHub Releases and Actions artifacts are
+collaborator-only alternatives, not required public downloads.
+
+**0.2.0 is not yet published.** npmjs 0.1.2 and GitHub Packages 0.1.1 are
+published and verified but do not include the ZIP. Use the manual setup below
+with those versions, or install a locally packed 0.2.0 tarball for evaluation.
+
+The extracted root contains `README.md`, `manifest.json`, and `fabric\`.
+Follow its README and preserve that structure. The manifest records the matching
+package version, schema version, and SHA-256 file hashes. It contains only this
+personal project's authored generic public-API setup definitions and synthetic
+samples, not Microsoft service internals, confidential source/configuration,
+tenant data, or credentials. Fresh generation does not reuse local bindings;
+source provenance must also be reviewed.
+
+Repository collaborators can still run `pnpm bundle:fabric` in the source checkout.
+The commands below use paths relative to the extracted bundle or checkout.
+Generating and packaging assets is offline; deployment requires your credentials.
+
 ## Prerequisites
 
 - Fabric-capacity or trial workspace; Contributor or higher for creation.