@brizz/sdk 0.1.26 → 0.1.28

package/dist/index.cjs

@@ -305,7 +305,7 @@ var init_schemas = __esm({
 });
 
 // src/internal/semantic-conventions.ts
-var import_api3, 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 import_api3, 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";
@@ -320,9 +320,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";
   }
 });
 
@@ -790,7 +798,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"() {
@@ -972,6 +980,100 @@ var init_mcp = __esm({
   }
 });
 
+// src/internal/instrumentation/vercel-ai/interrupt.ts
+var interrupt_exports = {};
+__export(interrupt_exports, {
+  InterruptPropagator: () => InterruptPropagator,
+  _resetInterruptState: () => _resetInterruptState,
+  createInterruptIntegration: () => createInterruptIntegration
+});
+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 = import_api8.trace.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 import_api8, INNER_OPERATION_IDS, MAX_PENDING_ENTRIES, pendingByParentSpanId, InterruptPropagator;
+var init_interrupt = __esm({
+  "src/internal/instrumentation/vercel-ai/interrupt.ts"() {
+    "use strict";
+    import_api8 = require("@opentelemetry/api");
+    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/index.ts
 var src_exports = {};
 __export(src_exports, {
@@ -981,10 +1083,13 @@ __export(src_exports, {
   Session: () => Session,
   SessionTitle: () => SessionTitle,
   SeverityNumber: () => import_api_logs2.SeverityNumber,
+  addExternalLink: () => addExternalLink,
+  callWithMute: () => callWithMute,
   callWithProperties: () => callWithProperties,
   callWithSessionId: () => callWithSessionId,
   detectRuntime: () => detectRuntime,
   emitEvent: () => emitEvent,
+  emitEventWithSessionId: () => emitEventWithSessionId,
   getActiveSession: () => getActiveSession,
   getLogLevel: () => getLogLevel,
   getMetricsExporter: () => getMetricsExporter,
@@ -999,6 +1104,7 @@ __export(src_exports, {
   setLogLevel: () => setLogLevel,
   startSession: () => startSession,
   startSessionTitle: () => startSessionTitle,
+  withMute: () => withMute,
   withProperties: () => withProperties,
   withSessionId: () => withSessionId
 });
@@ -1084,6 +1190,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;
@@ -1092,6 +1218,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`
@@ -1406,16 +1533,291 @@ var InstrumentationRegistry = class _InstrumentationRegistry {
   }
 };
 
+// src/internal/sdk.ts
+init_interrupt();
+
 // src/internal/log/logging.ts
 var import_api_logs = require("@opentelemetry/api-logs");
 var import_exporter_logs_otlp_http = require("@opentelemetry/exporter-logs-otlp-http");
 var import_resources = require("@opentelemetry/resources");
 var import_sdk_logs2 = require("@opentelemetry/sdk-logs");
 init_logger();
+
+// src/internal/trace/session.ts
+var import_api9 = require("@opentelemetry/api");
+init_logger();
+init_semantic_conventions2();
+function setCurrentSpanCustomProperties(properties) {
+  const current = import_api9.trace.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 = import_api9.context.active();
+  const prev = base.getValue(PROPERTIES_CONTEXT_KEY);
+  const merged = prev ? { ...prev, ...properties } : properties;
+  const next = base.setValue(PROPERTIES_CONTEXT_KEY, merged);
+  return import_api9.context.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 import_api9.context.active().getValue(SESSION_OBJECT_CONTEXT_KEY);
+}
+function resolveSessionIdFromContext() {
+  const active = getActiveSession();
+  if (active) {
+    return active.sessionId;
+  }
+  const props = import_api9.context.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 = import_api9.trace.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 = import_api9.context.active().setValue(SESSION_OBJECT_CONTEXT_KEY, session);
+      return import_api9.context.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: import_api9.SpanStatusCode.ERROR });
+              span.end();
+              throw error;
+            });
+          }
+          span.end();
+          return result;
+        } catch (error) {
+          span.recordException(error);
+          span.setStatus({ code: import_api9.SpanStatusCode.ERROR });
+          span.end();
+          throw error;
+        }
+      });
+    });
+  });
+}
+function startSessionTitle(callback, options) {
+  const resolvedSessionId = options?.sessionId ?? getActiveSession()?.sessionId;
+  const tracer = import_api9.trace.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: import_api9.SpanStatusCode.ERROR });
+            span.end();
+            throw error;
+          });
+        }
+        span.end();
+        return result;
+      } catch (error) {
+        span.recordException(error);
+        span.setStatus({ code: import_api9.SpanStatusCode.ERROR });
+        span.end();
+        throw error;
+      }
+    });
+  });
+}
+
+// src/internal/log/logging.ts
 init_version();
 
 // src/internal/log/processors/log-processor.ts
-var import_api8 = require("@opentelemetry/api");
+var import_api10 = require("@opentelemetry/api");
 var import_sdk_logs = require("@opentelemetry/sdk-logs");
 init_logger();
 
@@ -1847,7 +2249,7 @@ var BrizzSimpleLogRecordProcessor = class extends import_sdk_logs.SimpleLogRecor
     if (maskingConfig) {
       maskLog(logRecord, maskingConfig);
     }
-    const associationProperties = import_api8.context.active().getValue(PROPERTIES_CONTEXT_KEY);
+    const associationProperties = import_api10.context.active().getValue(PROPERTIES_CONTEXT_KEY);
     if (associationProperties) {
       for (const [key, value] of Object.entries(associationProperties)) {
         logRecord.setAttribute(`${BRIZZ}.${key}`, value);
@@ -1867,7 +2269,7 @@ var BrizzBatchLogRecordProcessor = class extends import_sdk_logs.BatchLogRecordP
     if (maskingConfig) {
       maskLog(logRecord, maskingConfig);
     }
-    const associationProperties = import_api8.context.active().getValue(PROPERTIES_CONTEXT_KEY);
+    const associationProperties = import_api10.context.active().getValue(PROPERTIES_CONTEXT_KEY);
     if (associationProperties) {
       for (const [key, value] of Object.entries(associationProperties)) {
         logRecord.setAttribute(`${BRIZZ}.${key}`, value);
@@ -1896,6 +2298,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);
       }
     }
@@ -2085,6 +2492,11 @@ var LoggingModule = class _LoggingModule {
 function emitEvent(name, attributes, body, severityNumber = import_api_logs.SeverityNumber.INFO) {
   return LoggingModule.getInstance().emitEvent(name, attributes, body, severityNumber);
 }
+function emitEventWithSessionId(sessionId, name, attributes, body, severityNumber = import_api_logs.SeverityNumber.INFO) {
+  return callWithSessionId(sessionId, () => {
+    LoggingModule.getInstance().emitEvent(name, attributes, body, severityNumber);
+  });
+}
 
 // src/internal/sdk.ts
 init_logger();
@@ -2267,12 +2679,12 @@ var BrizzSpanExporter = class {
 };
 
 // src/internal/trace/processors/span-processor.ts
-var import_api9 = require("@opentelemetry/api");
+var import_api11 = require("@opentelemetry/api");
 var import_sdk_trace_base = require("@opentelemetry/sdk-trace-base");
 init_logger();
 init_semantic_conventions2();
 function applyContextAttributes(span) {
-  const sessionProperties = import_api9.context.active().getValue(PROPERTIES_CONTEXT_KEY);
+  const sessionProperties = import_api11.context.active().getValue(PROPERTIES_CONTEXT_KEY);
   if (sessionProperties) {
     for (const [key, value] of Object.entries(sessionProperties)) {
       span.setAttribute(`${BRIZZ}.${key}`, value);
@@ -2457,214 +2869,6 @@ function getSpanProcessor() {
   return TracingModule.getInstance().getSpanProcessor();
 }
 
-// src/internal/trace/session.ts
-var import_api10 = require("@opentelemetry/api");
-init_semantic_conventions2();
-function setCurrentSpanCustomProperties(properties) {
-  const current = import_api10.trace.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 = import_api10.context.active();
-  const prev = base.getValue(PROPERTIES_CONTEXT_KEY);
-  const merged = prev ? { ...prev, ...properties } : properties;
-  const next = base.setValue(PROPERTIES_CONTEXT_KEY, merged);
-  return import_api10.context.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 import_api10.context.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 = import_api10.trace.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 = import_api10.context.active().setValue(SESSION_OBJECT_CONTEXT_KEY, session);
-      return import_api10.context.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: import_api10.SpanStatusCode.ERROR });
-              span.end();
-              throw error;
-            });
-          }
-          span.end();
-          return result;
-        } catch (error) {
-          span.recordException(error);
-          span.setStatus({ code: import_api10.SpanStatusCode.ERROR });
-          span.end();
-          throw error;
-        }
-      });
-    });
-  });
-}
-function startSessionTitle(callback, options) {
-  const resolvedSessionId = options?.sessionId ?? getActiveSession()?.sessionId;
-  const tracer = import_api10.trace.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: import_api10.SpanStatusCode.ERROR });
-            span.end();
-            throw error;
-          });
-        }
-        span.end();
-        return result;
-      } catch (error) {
-        span.recordException(error);
-        span.setStatus({ code: import_api10.SpanStatusCode.ERROR });
-        span.end();
-        throw error;
-      }
-    });
-  });
-}
-
 // src/internal/sdk.ts
 init_version();
 var _Brizz = class __Brizz {
@@ -2749,7 +2953,7 @@ var _Brizz = class __Brizz {
       resourceAttributes["service.version"] = resolvedConfig.appVersion;
     }
     this._sdk = new import_sdk_node.NodeSDK({
-      spanProcessors: resolvedConfig.disableSpanExporter ? [] : [getSpanProcessor()],
+      spanProcessors: resolvedConfig.disableSpanExporter ? [] : [new InterruptPropagator(), getSpanProcessor()],
       metricReader: getMetricsReader(),
       resource: (0, import_resources3.resourceFromAttributes)(resourceAttributes),
       instrumentations: manualInstrumentations
@@ -2924,10 +3128,13 @@ var init_exports = {};
   Session,
   SessionTitle,
   SeverityNumber,
+  addExternalLink,
+  callWithMute,
   callWithProperties,
   callWithSessionId,
   detectRuntime,
   emitEvent,
+  emitEventWithSessionId,
   getActiveSession,
   getLogLevel,
   getMetricsExporter,
@@ -2942,6 +3149,7 @@ var init_exports = {};
   setLogLevel,
   startSession,
   startSessionTitle,
+  withMute,
   withProperties,
   withSessionId
 });