@brizz/sdk 0.1.26 → 0.1.28

package/dist/index.js

@@ -290,7 +290,7 @@ var init_schemas = __esm({
 
 // src/internal/semantic-conventions.ts
 import { createContextKey } from "@opentelemetry/api";
-var BRIZZ, PROPERTIES, SESSION_ID, PROPERTIES_CONTEXT_KEY, SESSION_OBJECT_CONTEXT_KEY, SESSION_INPUT, SESSION_OUTPUT, SESSION_INPUT_CONTEXT, SESSION_OUTPUT_CONTEXT, SESSION_SPAN_NAME, SESSION_TITLE_SPAN_NAME, SESSION_TITLE_GENERATION, SESSION_TITLE;
+var BRIZZ, PROPERTIES, SESSION_ID, PROPERTIES_CONTEXT_KEY, SESSION_OBJECT_CONTEXT_KEY, SESSION_INPUT, SESSION_OUTPUT, SESSION_INPUT_CONTEXT, SESSION_OUTPUT_CONTEXT, SESSION_SPAN_NAME, MUTE_INPUT, MUTE_OUTPUT, SESSION_TITLE_SPAN_NAME, SESSION_TITLE_GENERATION, SESSION_TITLE, INTERRUPT_TOOLS, INTERNAL_EVENT_PREFIX, EXTERNAL_LINK_EVENT_NAME, EXTERNAL_LINK_URL, EXTERNAL_LINK_TITLE, EXTERNAL_LINK_TYPE;
 var init_semantic_conventions2 = __esm({
   "src/internal/semantic-conventions.ts"() {
     "use strict";
@@ -304,9 +304,17 @@ var init_semantic_conventions2 = __esm({
     SESSION_INPUT_CONTEXT = "brizz.session.input.context";
     SESSION_OUTPUT_CONTEXT = "brizz.session.output.context";
     SESSION_SPAN_NAME = "brizz.start_session";
+    MUTE_INPUT = "mute.input";
+    MUTE_OUTPUT = "mute.output";
     SESSION_TITLE_SPAN_NAME = "brizz.session_title";
     SESSION_TITLE_GENERATION = "session.title_generation";
     SESSION_TITLE = "brizz.session.title";
+    INTERRUPT_TOOLS = "brizz.internal.interrupt";
+    INTERNAL_EVENT_PREFIX = "brizz.internal.";
+    EXTERNAL_LINK_EVENT_NAME = "brizz.internal.external_link";
+    EXTERNAL_LINK_URL = "brizz.internal.external_link.url";
+    EXTERNAL_LINK_TITLE = "brizz.internal.external_link.title";
+    EXTERNAL_LINK_TYPE = "brizz.internal.external_link.type";
   }
 });
 
@@ -772,7 +780,7 @@ var init_protocol = __esm({
 
 // src/internal/version.ts
 function getSDKVersion() {
-  return "0.1.26";
+  return "0.1.28";
 }
 var init_version = __esm({
   "src/internal/version.ts"() {
@@ -954,6 +962,100 @@ var init_mcp = __esm({
   }
 });
 
+// src/internal/instrumentation/vercel-ai/interrupt.ts
+var interrupt_exports = {};
+__export(interrupt_exports, {
+  InterruptPropagator: () => InterruptPropagator,
+  _resetInterruptState: () => _resetInterruptState,
+  createInterruptIntegration: () => createInterruptIntegration
+});
+import { trace as trace3 } from "@opentelemetry/api";
+function isInnerLLMSpan(span) {
+  if (INNER_OPERATION_IDS.has(span.name)) {
+    return true;
+  }
+  const opId = span.attributes["ai.operationId"];
+  return typeof opId === "string" && INNER_OPERATION_IDS.has(opId);
+}
+function setPending(parentSpanId, value) {
+  pendingByParentSpanId.set(parentSpanId, value);
+  while (pendingByParentSpanId.size > MAX_PENDING_ENTRIES) {
+    const oldest = pendingByParentSpanId.keys().next().value;
+    if (oldest === void 0) {
+      break;
+    }
+    pendingByParentSpanId.delete(oldest);
+  }
+}
+function extractInterruptTools(tools) {
+  if (!tools || typeof tools !== "object") {
+    return [];
+  }
+  return Object.entries(tools).filter(
+    ([, t]) => !!t && typeof t === "object" && t.needsApproval
+  ).map(([name]) => name);
+}
+function createInterruptIntegration() {
+  const onStepStart = (event) => {
+    const names = extractInterruptTools(event.tools);
+    if (names.length === 0) {
+      return;
+    }
+    const value = JSON.stringify(names);
+    const span = trace3.getActiveSpan();
+    if (!span) {
+      return;
+    }
+    span.setAttribute(INTERRUPT_TOOLS, value);
+    setPending(span.spanContext().spanId, value);
+  };
+  return {
+    onStepStart
+  };
+}
+function _resetInterruptState() {
+  if (process.env["NODE_ENV"] !== "test") {
+    return;
+  }
+  pendingByParentSpanId.clear();
+}
+var INNER_OPERATION_IDS, MAX_PENDING_ENTRIES, pendingByParentSpanId, InterruptPropagator;
+var init_interrupt = __esm({
+  "src/internal/instrumentation/vercel-ai/interrupt.ts"() {
+    "use strict";
+    init_semantic_conventions2();
+    INNER_OPERATION_IDS = /* @__PURE__ */ new Set([
+      "ai.generateText.doGenerate",
+      "ai.streamText.doStream"
+    ]);
+    MAX_PENDING_ENTRIES = 1024;
+    pendingByParentSpanId = /* @__PURE__ */ new Map();
+    InterruptPropagator = class {
+      onStart(span, _parentContext) {
+        if (!isInnerLLMSpan(span)) {
+          return;
+        }
+        const parentSpanId = span.parentSpanContext?.spanId;
+        if (!parentSpanId) {
+          return;
+        }
+        const value = pendingByParentSpanId.get(parentSpanId);
+        if (!value) {
+          return;
+        }
+        span.setAttribute(INTERRUPT_TOOLS, value);
+        pendingByParentSpanId.delete(parentSpanId);
+      }
+      onEnd() {
+      }
+      async shutdown() {
+      }
+      async forceFlush() {
+      }
+    };
+  }
+});
+
 // src/internal/instrumentation/auto-init.ts
 init_logger();
 import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
@@ -1034,6 +1136,26 @@ function loadMCPInstrumentation() {
     }
   })();
 }
+function loadVercelAIInterruptIntegration() {
+  void (async () => {
+    try {
+      const ai = await import("ai");
+      if (typeof ai.registerTelemetryIntegration !== "function") {
+        logger.debug(
+          "AI SDK present but lacks registerTelemetryIntegration (needs ai@>=6); skipping interrupt bridge"
+        );
+        return;
+      }
+      const { createInterruptIntegration: createInterruptIntegration2 } = await Promise.resolve().then(() => (init_interrupt(), interrupt_exports));
+      ai.registerTelemetryIntegration(createInterruptIntegration2());
+      logger.debug("Auto-loaded Vercel AI interrupt bridge");
+    } catch (error) {
+      logger.debug(
+        `Vercel AI interrupt bridge not loaded (install ai@>=6 if you want HITL attribution): ${String(error)}`
+      );
+    }
+  })();
+}
 function autoInitializeInstrumentations() {
   if (autoInstrumentationsLoaded) {
     return;
@@ -1042,6 +1164,7 @@ function autoInitializeInstrumentations() {
     const nodeInstrumentations = loadNodeAutoInstrumentations();
     const genAIInstrumentations = loadGenAIInstrumentations();
     loadMCPInstrumentation();
+    loadVercelAIInterruptIntegration();
     autoInstrumentationsLoaded = true;
     logger.info(
       `Auto-initialization complete: ${nodeInstrumentations.length} node + ${genAIInstrumentations.length} GenAI instrumentations`
@@ -1356,6 +1479,9 @@ var InstrumentationRegistry = class _InstrumentationRegistry {
   }
 };
 
+// src/internal/sdk.ts
+init_interrupt();
+
 // src/internal/log/logging.ts
 import { SeverityNumber } from "@opentelemetry/api-logs";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
@@ -1364,11 +1490,283 @@ import {
   LoggerProvider
 } from "@opentelemetry/sdk-logs";
 init_logger();
+
+// src/internal/trace/session.ts
+import { context as context3, trace as trace4, SpanStatusCode as SpanStatusCode3 } from "@opentelemetry/api";
+init_logger();
+init_semantic_conventions2();
+function setCurrentSpanCustomProperties(properties) {
+  const current = trace4.getActiveSpan();
+  if (!current || !current.isRecording()) {
+    return;
+  }
+  for (const [key, value] of Object.entries(properties)) {
+    try {
+      current.setAttribute(`${BRIZZ}.${key}`, value);
+    } catch {
+    }
+  }
+}
+function callWithProperties(properties, fn, thisArg, ...args) {
+  const base = context3.active();
+  const prev = base.getValue(PROPERTIES_CONTEXT_KEY);
+  const merged = prev ? { ...prev, ...properties } : properties;
+  const next = base.setValue(PROPERTIES_CONTEXT_KEY, merged);
+  return context3.with(next, fn, thisArg, ...args);
+}
+function withProperties(properties, fn, thisArg) {
+  return function wrapped(...args) {
+    return callWithProperties(
+      properties,
+      fn,
+      thisArg !== void 0 ? thisArg : this,
+      ...args
+    );
+  };
+}
+function muteProperties(options) {
+  const { input = true, output = true } = options;
+  const properties = {};
+  if (input) {
+    properties[MUTE_INPUT] = "true";
+  }
+  if (output) {
+    properties[MUTE_OUTPUT] = "true";
+  }
+  return properties;
+}
+function callWithMute(options, fn, thisArg, ...args) {
+  return callWithProperties(muteProperties(options), fn, thisArg, ...args);
+}
+function withMute(options, fn, thisArg) {
+  return withProperties(muteProperties(options), fn, thisArg);
+}
+function withSessionId(sessionId, fn, thisArg, extraProperties) {
+  const properties = { [SESSION_ID]: sessionId, ...extraProperties };
+  return withProperties(properties, fn, thisArg);
+}
+function callWithSessionId(sessionId, fn, thisArg, ...args) {
+  return callWithProperties({ [SESSION_ID]: sessionId }, fn, thisArg, ...args);
+}
+var Session = class {
+  sessionId;
+  span;
+  inputs = [];
+  outputs = [];
+  inputContexts = [];
+  outputContexts = [];
+  constructor(sessionId, span) {
+    this.sessionId = sessionId;
+    this.span = span;
+  }
+  /**
+   * Append a user turn to session input tracking.
+   *
+   * Each call appends one element to `brizz.session.input` (the text) AND one
+   * element to `brizz.session.input.context` (the per-turn context bag). The
+   * two arrays stay index-aligned — the ingestion pipeline zips them together
+   * so the i-th context bag lands on the i-th user_display conversation item's
+   * `span_attributes` map.
+   *
+   * @param text - Text to append (null becomes a null/"hide marker")
+   * @param context - Optional per-turn context bag to attach to this turn
+   */
+  setInput(text, context6) {
+    this.inputs.push(text);
+    this.inputContexts.push(context6 ?? {});
+    this.span.setAttribute(SESSION_INPUT, JSON.stringify(this.inputs));
+    this.span.setAttribute(SESSION_INPUT_CONTEXT, JSON.stringify(this.inputContexts));
+  }
+  /**
+   * Append an assistant turn to session output tracking.
+   *
+   * Symmetric to {@link setInput} — appends one text element and one
+   * context-bag element to the index-aligned `brizz.session.output` /
+   * `brizz.session.output.context` arrays.
+   *
+   * @param text - Text to append (null becomes a null/"hide marker")
+   * @param context - Optional per-turn context bag to attach to this turn
+   */
+  setOutput(text, context6) {
+    this.outputs.push(text);
+    this.outputContexts.push(context6 ?? {});
+    this.span.setAttribute(SESSION_OUTPUT, JSON.stringify(this.outputs));
+    this.span.setAttribute(SESSION_OUTPUT_CONTEXT, JSON.stringify(this.outputContexts));
+  }
+  /**
+   * Set the session title on the span.
+   *
+   * @param title - The generated title string
+   */
+  setTitle(title) {
+    this.span.setAttribute(SESSION_TITLE, title);
+  }
+  /**
+   * Update custom properties on the session span.
+   * Properties are prefixed with 'brizz.'.
+   *
+   * @param properties - Key-value properties to set on the session
+   */
+  updateProperties(properties) {
+    for (const [key, value] of Object.entries(properties)) {
+      this.span.setAttribute(`${BRIZZ}.${key}`, value);
+    }
+  }
+  /**
+   * Attach an external link (URL) to this session.
+   *
+   * The link surfaces on the session's detail panel in Brizz — use it to
+   * correlate a session with an external record such as a Datadog trace,
+   * Sentry issue, or internal dashboard. Re-sending the same URL is idempotent;
+   * distinct URLs add separate links.
+   *
+   * @param url - The link target
+   * @param options - Optional `title` (defaults to the URL host) and `linkType`
+   *   (free-form category, defaults to `'generic'`)
+   */
+  addExternalLink(url, options) {
+    emitExternalLink(this.sessionId, url, options?.title, options?.linkType);
+  }
+};
+var SessionTitle = class {
+  span;
+  constructor(span) {
+    this.span = span;
+  }
+  /**
+   * Set the generated title on the wrapper span.
+   *
+   * @param title - The generated title string
+   */
+  setTitle(title) {
+    this.span.setAttribute(SESSION_TITLE, title);
+  }
+};
+function getActiveSession() {
+  return context3.active().getValue(SESSION_OBJECT_CONTEXT_KEY);
+}
+function resolveSessionIdFromContext() {
+  const active = getActiveSession();
+  if (active) {
+    return active.sessionId;
+  }
+  const props = context3.active().getValue(PROPERTIES_CONTEXT_KEY);
+  return props?.[SESSION_ID];
+}
+function emitExternalLink(sessionId, url, title, linkType) {
+  try {
+    emitEventWithSessionId(sessionId, EXTERNAL_LINK_EVENT_NAME, {
+      [EXTERNAL_LINK_URL]: url,
+      [EXTERNAL_LINK_TITLE]: title ?? "",
+      [EXTERNAL_LINK_TYPE]: linkType ?? "generic"
+    });
+  } catch (error) {
+    logger.warn("addExternalLink: failed to emit external link", error);
+  }
+}
+function addExternalLink(url, options) {
+  const sessionId = options?.sessionId ?? resolveSessionIdFromContext();
+  if (!sessionId) {
+    logger.warn(
+      "addExternalLink called without a resolvable session id; link dropped. Pass options.sessionId or call inside a startSession/callWithSessionId scope."
+    );
+    return;
+  }
+  emitExternalLink(sessionId, url, options?.title, options?.linkType);
+}
+function startSession(sessionId, callback, extraProperties, options) {
+  const isTitle = options?.mode === "title";
+  const spanName = isTitle ? SESSION_TITLE_SPAN_NAME : SESSION_SPAN_NAME;
+  const tracer = trace4.getTracer("@brizz/sdk");
+  return tracer.startActiveSpan(spanName, (span) => {
+    span.setAttribute(`${BRIZZ}.${SESSION_ID}`, sessionId);
+    if (extraProperties) {
+      for (const [key, value] of Object.entries(extraProperties)) {
+        span.setAttribute(`${BRIZZ}.${key}`, value);
+      }
+    }
+    const session = new Session(sessionId, span);
+    const contextProperties = { [SESSION_ID]: sessionId };
+    if (isTitle) {
+      contextProperties[SESSION_TITLE_GENERATION] = "true";
+    }
+    if (extraProperties) {
+      for (const [key, value] of Object.entries(extraProperties)) {
+        contextProperties[key] = String(value);
+      }
+    }
+    return callWithProperties(contextProperties, () => {
+      const sessionCtx = context3.active().setValue(SESSION_OBJECT_CONTEXT_KEY, session);
+      return context3.with(sessionCtx, () => {
+        try {
+          const result = callback(session);
+          if (result && typeof result.then === "function") {
+            return result.then((value) => {
+              span.end();
+              return value;
+            }).catch((error) => {
+              span.recordException(error);
+              span.setStatus({ code: SpanStatusCode3.ERROR });
+              span.end();
+              throw error;
+            });
+          }
+          span.end();
+          return result;
+        } catch (error) {
+          span.recordException(error);
+          span.setStatus({ code: SpanStatusCode3.ERROR });
+          span.end();
+          throw error;
+        }
+      });
+    });
+  });
+}
+function startSessionTitle(callback, options) {
+  const resolvedSessionId = options?.sessionId ?? getActiveSession()?.sessionId;
+  const tracer = trace4.getTracer("@brizz/sdk");
+  return tracer.startActiveSpan(SESSION_TITLE_SPAN_NAME, (span) => {
+    if (resolvedSessionId) {
+      span.setAttribute(`${BRIZZ}.${SESSION_ID}`, resolvedSessionId);
+    }
+    const sessionTitle = new SessionTitle(span);
+    const properties = { [SESSION_TITLE_GENERATION]: "true" };
+    if (resolvedSessionId) {
+      properties[SESSION_ID] = resolvedSessionId;
+    }
+    return callWithProperties(properties, () => {
+      try {
+        const result = callback(sessionTitle);
+        if (result && typeof result.then === "function") {
+          return result.then((value) => {
+            span.end();
+            return value;
+          }).catch((error) => {
+            span.recordException(error);
+            span.setStatus({ code: SpanStatusCode3.ERROR });
+            span.end();
+            throw error;
+          });
+        }
+        span.end();
+        return result;
+      } catch (error) {
+        span.recordException(error);
+        span.setStatus({ code: SpanStatusCode3.ERROR });
+        span.end();
+        throw error;
+      }
+    });
+  });
+}
+
+// src/internal/log/logging.ts
 init_version();
 
 // src/internal/log/processors/log-processor.ts
 init_logger();
-import { context as context3 } from "@opentelemetry/api";
+import { context as context4 } from "@opentelemetry/api";
 import { BatchLogRecordProcessor, SimpleLogRecordProcessor } from "@opentelemetry/sdk-logs";
 
 // src/internal/masking/patterns.ts
@@ -1799,7 +2197,7 @@ var BrizzSimpleLogRecordProcessor = class extends SimpleLogRecordProcessor {
     if (maskingConfig) {
       maskLog(logRecord, maskingConfig);
     }
-    const associationProperties = context3.active().getValue(PROPERTIES_CONTEXT_KEY);
+    const associationProperties = context4.active().getValue(PROPERTIES_CONTEXT_KEY);
     if (associationProperties) {
       for (const [key, value] of Object.entries(associationProperties)) {
         logRecord.setAttribute(`${BRIZZ}.${key}`, value);
@@ -1819,7 +2217,7 @@ var BrizzBatchLogRecordProcessor = class extends BatchLogRecordProcessor {
     if (maskingConfig) {
       maskLog(logRecord, maskingConfig);
     }
-    const associationProperties = context3.active().getValue(PROPERTIES_CONTEXT_KEY);
+    const associationProperties = context4.active().getValue(PROPERTIES_CONTEXT_KEY);
     if (associationProperties) {
       for (const [key, value] of Object.entries(associationProperties)) {
         logRecord.setAttribute(`${BRIZZ}.${key}`, value);
@@ -1848,6 +2246,11 @@ function maskLog(logRecord, config) {
         for (const [key, value] of Object.entries(maskedAttributes)) {
           newAttributes[key] = value;
         }
+        for (const [key, value] of Object.entries(logRecord.attributes)) {
+          if (key.startsWith(INTERNAL_EVENT_PREFIX)) {
+            newAttributes[key] = value;
+          }
+        }
         logRecord.setAttributes(newAttributes);
       }
     }
@@ -2037,6 +2440,11 @@ var LoggingModule = class _LoggingModule {
 function emitEvent(name, attributes, body, severityNumber = SeverityNumber.INFO) {
   return LoggingModule.getInstance().emitEvent(name, attributes, body, severityNumber);
 }
+function emitEventWithSessionId(sessionId, name, attributes, body, severityNumber = SeverityNumber.INFO) {
+  return callWithSessionId(sessionId, () => {
+    LoggingModule.getInstance().emitEvent(name, attributes, body, severityNumber);
+  });
+}
 
 // src/internal/sdk.ts
 init_logger();
@@ -2220,14 +2628,14 @@ var BrizzSpanExporter = class {
 
 // src/internal/trace/processors/span-processor.ts
 init_logger();
-import { context as context4 } from "@opentelemetry/api";
+import { context as context5 } from "@opentelemetry/api";
 import {
   BatchSpanProcessor,
   SimpleSpanProcessor
 } from "@opentelemetry/sdk-trace-base";
 init_semantic_conventions2();
 function applyContextAttributes(span) {
-  const sessionProperties = context4.active().getValue(PROPERTIES_CONTEXT_KEY);
+  const sessionProperties = context5.active().getValue(PROPERTIES_CONTEXT_KEY);
   if (sessionProperties) {
     for (const [key, value] of Object.entries(sessionProperties)) {
       span.setAttribute(`${BRIZZ}.${key}`, value);
@@ -2412,214 +2820,6 @@ function getSpanProcessor() {
   return TracingModule.getInstance().getSpanProcessor();
 }
 
-// src/internal/trace/session.ts
-init_semantic_conventions2();
-import { context as context5, trace as trace3, SpanStatusCode as SpanStatusCode3 } from "@opentelemetry/api";
-function setCurrentSpanCustomProperties(properties) {
-  const current = trace3.getActiveSpan();
-  if (!current || !current.isRecording()) {
-    return;
-  }
-  for (const [key, value] of Object.entries(properties)) {
-    try {
-      current.setAttribute(`${BRIZZ}.${key}`, value);
-    } catch {
-    }
-  }
-}
-function callWithProperties(properties, fn, thisArg, ...args) {
-  const base = context5.active();
-  const prev = base.getValue(PROPERTIES_CONTEXT_KEY);
-  const merged = prev ? { ...prev, ...properties } : properties;
-  const next = base.setValue(PROPERTIES_CONTEXT_KEY, merged);
-  return context5.with(next, fn, thisArg, ...args);
-}
-function withProperties(properties, fn, thisArg) {
-  return function wrapped(...args) {
-    return callWithProperties(
-      properties,
-      fn,
-      thisArg !== void 0 ? thisArg : this,
-      ...args
-    );
-  };
-}
-function withSessionId(sessionId, fn, thisArg, extraProperties) {
-  const properties = { [SESSION_ID]: sessionId, ...extraProperties };
-  return withProperties(properties, fn, thisArg);
-}
-function callWithSessionId(sessionId, fn, thisArg, ...args) {
-  return callWithProperties({ [SESSION_ID]: sessionId }, fn, thisArg, ...args);
-}
-var Session = class {
-  sessionId;
-  span;
-  inputs = [];
-  outputs = [];
-  inputContexts = [];
-  outputContexts = [];
-  constructor(sessionId, span) {
-    this.sessionId = sessionId;
-    this.span = span;
-  }
-  /**
-   * Append a user turn to session input tracking.
-   *
-   * Each call appends one element to `brizz.session.input` (the text) AND one
-   * element to `brizz.session.input.context` (the per-turn context bag). The
-   * two arrays stay index-aligned — the ingestion pipeline zips them together
-   * so the i-th context bag lands on the i-th user_display conversation item's
-   * `span_attributes` map.
-   *
-   * @param text - Text to append (null becomes a null/"hide marker")
-   * @param context - Optional per-turn context bag to attach to this turn
-   */
-  setInput(text, context6) {
-    this.inputs.push(text);
-    this.inputContexts.push(context6 ?? {});
-    this.span.setAttribute(SESSION_INPUT, JSON.stringify(this.inputs));
-    this.span.setAttribute(SESSION_INPUT_CONTEXT, JSON.stringify(this.inputContexts));
-  }
-  /**
-   * Append an assistant turn to session output tracking.
-   *
-   * Symmetric to {@link setInput} — appends one text element and one
-   * context-bag element to the index-aligned `brizz.session.output` /
-   * `brizz.session.output.context` arrays.
-   *
-   * @param text - Text to append (null becomes a null/"hide marker")
-   * @param context - Optional per-turn context bag to attach to this turn
-   */
-  setOutput(text, context6) {
-    this.outputs.push(text);
-    this.outputContexts.push(context6 ?? {});
-    this.span.setAttribute(SESSION_OUTPUT, JSON.stringify(this.outputs));
-    this.span.setAttribute(SESSION_OUTPUT_CONTEXT, JSON.stringify(this.outputContexts));
-  }
-  /**
-   * Set the session title on the span.
-   *
-   * @param title - The generated title string
-   */
-  setTitle(title) {
-    this.span.setAttribute(SESSION_TITLE, title);
-  }
-  /**
-   * Update custom properties on the session span.
-   * Properties are prefixed with 'brizz.'.
-   *
-   * @param properties - Key-value properties to set on the session
-   */
-  updateProperties(properties) {
-    for (const [key, value] of Object.entries(properties)) {
-      this.span.setAttribute(`${BRIZZ}.${key}`, value);
-    }
-  }
-};
-var SessionTitle = class {
-  span;
-  constructor(span) {
-    this.span = span;
-  }
-  /**
-   * Set the generated title on the wrapper span.
-   *
-   * @param title - The generated title string
-   */
-  setTitle(title) {
-    this.span.setAttribute(SESSION_TITLE, title);
-  }
-};
-function getActiveSession() {
-  return context5.active().getValue(SESSION_OBJECT_CONTEXT_KEY);
-}
-function startSession(sessionId, callback, extraProperties, options) {
-  const isTitle = options?.mode === "title";
-  const spanName = isTitle ? SESSION_TITLE_SPAN_NAME : SESSION_SPAN_NAME;
-  const tracer = trace3.getTracer("@brizz/sdk");
-  return tracer.startActiveSpan(spanName, (span) => {
-    span.setAttribute(`${BRIZZ}.${SESSION_ID}`, sessionId);
-    if (extraProperties) {
-      for (const [key, value] of Object.entries(extraProperties)) {
-        span.setAttribute(`${BRIZZ}.${key}`, value);
-      }
-    }
-    const session = new Session(sessionId, span);
-    const contextProperties = { [SESSION_ID]: sessionId };
-    if (isTitle) {
-      contextProperties[SESSION_TITLE_GENERATION] = "true";
-    }
-    if (extraProperties) {
-      for (const [key, value] of Object.entries(extraProperties)) {
-        contextProperties[key] = String(value);
-      }
-    }
-    return callWithProperties(contextProperties, () => {
-      const sessionCtx = context5.active().setValue(SESSION_OBJECT_CONTEXT_KEY, session);
-      return context5.with(sessionCtx, () => {
-        try {
-          const result = callback(session);
-          if (result && typeof result.then === "function") {
-            return result.then((value) => {
-              span.end();
-              return value;
-            }).catch((error) => {
-              span.recordException(error);
-              span.setStatus({ code: SpanStatusCode3.ERROR });
-              span.end();
-              throw error;
-            });
-          }
-          span.end();
-          return result;
-        } catch (error) {
-          span.recordException(error);
-          span.setStatus({ code: SpanStatusCode3.ERROR });
-          span.end();
-          throw error;
-        }
-      });
-    });
-  });
-}
-function startSessionTitle(callback, options) {
-  const resolvedSessionId = options?.sessionId ?? getActiveSession()?.sessionId;
-  const tracer = trace3.getTracer("@brizz/sdk");
-  return tracer.startActiveSpan(SESSION_TITLE_SPAN_NAME, (span) => {
-    if (resolvedSessionId) {
-      span.setAttribute(`${BRIZZ}.${SESSION_ID}`, resolvedSessionId);
-    }
-    const sessionTitle = new SessionTitle(span);
-    const properties = { [SESSION_TITLE_GENERATION]: "true" };
-    if (resolvedSessionId) {
-      properties[SESSION_ID] = resolvedSessionId;
-    }
-    return callWithProperties(properties, () => {
-      try {
-        const result = callback(sessionTitle);
-        if (result && typeof result.then === "function") {
-          return result.then((value) => {
-            span.end();
-            return value;
-          }).catch((error) => {
-            span.recordException(error);
-            span.setStatus({ code: SpanStatusCode3.ERROR });
-            span.end();
-            throw error;
-          });
-        }
-        span.end();
-        return result;
-      } catch (error) {
-        span.recordException(error);
-        span.setStatus({ code: SpanStatusCode3.ERROR });
-        span.end();
-        throw error;
-      }
-    });
-  });
-}
-
 // src/internal/sdk.ts
 init_version();
 var _Brizz = class __Brizz {
@@ -2704,7 +2904,7 @@ var _Brizz = class __Brizz {
       resourceAttributes["service.version"] = resolvedConfig.appVersion;
     }
     this._sdk = new NodeSDK({
-      spanProcessors: resolvedConfig.disableSpanExporter ? [] : [getSpanProcessor()],
+      spanProcessors: resolvedConfig.disableSpanExporter ? [] : [new InterruptPropagator(), getSpanProcessor()],
       metricReader: getMetricsReader(),
       resource: resourceFromAttributes3(resourceAttributes),
       instrumentations: manualInstrumentations
@@ -2878,10 +3078,13 @@ export {
   Session,
   SessionTitle,
   SeverityNumber2 as SeverityNumber,
+  addExternalLink,
+  callWithMute,
   callWithProperties,
   callWithSessionId,
   detectRuntime,
   emitEvent,
+  emitEventWithSessionId,
   getActiveSession,
   getLogLevel,
   getMetricsExporter,
@@ -2896,6 +3099,7 @@ export {
   setLogLevel,
   startSession,
   startSessionTitle,
+  withMute,
   withProperties,
   withSessionId
 };