@brizz/sdk 0.1.27 → 0.1.28

package/README.md

@@ -21,6 +21,7 @@ libraries including OpenAI, Anthropic, Vercel AI SDK, and more.
 - [Custom Events & Logging](#custom-events--logging)
 - [Environment Variables](#environment-variables)
 - [Disable Span Export](#disable-span-export)
+- [Dropping Spans](#dropping-spans)
 - [Advanced Configuration](#advanced-configuration)
 - [Testing & Development](#testing--development)
 - [Package.json Examples](#packagejson-examples)
@@ -290,6 +291,7 @@ const result = await startSession(
 - `session.setOutput(text, context?)` - (Optional) Manually track output text; optional context bag
   attaches per-turn metadata rendered in the dashboard's Context panel
 - `session.setTitle(text)` - Set a session title (typically used with `mode: 'title'`)
+- `session.addExternalLink(url, options?)` - (Optional) Attach an external link (e.g. a Datadog trace or dashboard) to the session; it appears on the session detail panel. Also available as the top-level `addExternalLink(url, options?)`.
 
 **Per-turn context example:**
 
@@ -495,7 +497,7 @@ Brizz.initialize({
 Emit custom events and structured logs:
 
 ```typescript
-import { emitEvent, logger } from '@brizz/sdk';
+import { emitEvent, emitEventWithSessionId, logger } from '@brizz/sdk';
 
 // Emit custom events
 emitEvent('user.signup', {
@@ -510,6 +512,11 @@ emitEvent('ai.request.completed', {
   latency: 1200,
 });
 
+// Emit with a known session ID, outside any session scope
+emitEventWithSessionId('session-123', 'user.feedback.submitted', {
+  rating: 5,
+});
+
 // Structured logging
 logger.info('Processing user request', { userId: '123', requestId: 'req-456' });
 logger.error('AI request failed', { error: err.message, model: 'gpt-4' });
@@ -546,6 +553,37 @@ Brizz.initialize({ apiKey: 'your-api-key', disableSpanExporter: true });
 
 Or via env var: `BRIZZ_DISABLE_SPAN_EXPORTER=true`.
 
+## Dropping Spans
+
+Filter spans before export with `beforeSendSpan`. Return `false` to drop a span, `true` to keep it. Useful for stripping noisy paths (health checks, internal tooling) or excluding telemetry for specific end-users.
+
+```typescript
+Brizz.initialize({
+  apiKey: 'your-api-key',
+  beforeSendSpan: (span) => {
+    // OpenInference (LangChain JS, LangGraph JS) packs per-call
+    // `config.metadata` into a JSON-stringified `metadata` attribute.
+    const raw = span.attributes['metadata'];
+    if (typeof raw !== 'string') return true;
+    try {
+      return JSON.parse(raw).customer_id !== 'cust_42';
+    } catch {
+      return true;
+    }
+  },
+});
+```
+
+Tag the call so the filter has something to match on:
+
+```typescript
+await llm.invoke([new HumanMessage('Hello')], {
+  metadata: { customer_id: 'cust_42' },
+});
+```
+
+Both sync and async filters are supported. Exceptions are caught and the span passes through.
+
 ## Advanced Configuration
 
 ```typescript

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, INTERRUPT_TOOLS;
+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,10 +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";
   }
 });
 
@@ -791,7 +798,7 @@ var init_protocol = __esm({
 
 // src/internal/version.ts
 function getSDKVersion() {
-  return "0.1.27";
+  return "0.1.28";
 }
 var init_version = __esm({
   "src/internal/version.ts"() {
@@ -1076,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,
@@ -1094,6 +1104,7 @@ __export(src_exports, {
   setLogLevel: () => setLogLevel,
   startSession: () => startSession,
   startSessionTitle: () => startSessionTitle,
+  withMute: () => withMute,
   withProperties: () => withProperties,
   withSessionId: () => withSessionId
 });
@@ -1531,10 +1542,282 @@ var import_exporter_logs_otlp_http = require("@opentelemetry/exporter-logs-otlp-
 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_api9 = require("@opentelemetry/api");
+var import_api10 = require("@opentelemetry/api");
 var import_sdk_logs = require("@opentelemetry/sdk-logs");
 init_logger();
 
@@ -1966,7 +2249,7 @@ var BrizzSimpleLogRecordProcessor = class extends import_sdk_logs.SimpleLogRecor
     if (maskingConfig) {
       maskLog(logRecord, maskingConfig);
     }
-    const associationProperties = import_api9.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);
@@ -1986,7 +2269,7 @@ var BrizzBatchLogRecordProcessor = class extends import_sdk_logs.BatchLogRecordP
     if (maskingConfig) {
       maskLog(logRecord, maskingConfig);
     }
-    const associationProperties = import_api9.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);
@@ -2015,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);
       }
     }
@@ -2204,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();
@@ -2386,12 +2679,12 @@ var BrizzSpanExporter = class {
 };
 
 // src/internal/trace/processors/span-processor.ts
-var import_api10 = 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_api10.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);
@@ -2576,214 +2869,6 @@ function getSpanProcessor() {
   return TracingModule.getInstance().getSpanProcessor();
 }
 
-// src/internal/trace/session.ts
-var import_api11 = require("@opentelemetry/api");
-init_semantic_conventions2();
-function setCurrentSpanCustomProperties(properties) {
-  const current = import_api11.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_api11.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_api11.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_api11.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_api11.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_api11.context.active().setValue(SESSION_OBJECT_CONTEXT_KEY, session);
-      return import_api11.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_api11.SpanStatusCode.ERROR });
-              span.end();
-              throw error;
-            });
-          }
-          span.end();
-          return result;
-        } catch (error) {
-          span.recordException(error);
-          span.setStatus({ code: import_api11.SpanStatusCode.ERROR });
-          span.end();
-          throw error;
-        }
-      });
-    });
-  });
-}
-function startSessionTitle(callback, options) {
-  const resolvedSessionId = options?.sessionId ?? getActiveSession()?.sessionId;
-  const tracer = import_api11.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_api11.SpanStatusCode.ERROR });
-            span.end();
-            throw error;
-          });
-        }
-        span.end();
-        return result;
-      } catch (error) {
-        span.recordException(error);
-        span.setStatus({ code: import_api11.SpanStatusCode.ERROR });
-        span.end();
-        throw error;
-      }
-    });
-  });
-}
-
 // src/internal/sdk.ts
 init_version();
 var _Brizz = class __Brizz {
@@ -3043,10 +3128,13 @@ var init_exports = {};
   Session,
   SessionTitle,
   SeverityNumber,
+  addExternalLink,
+  callWithMute,
   callWithProperties,
   callWithSessionId,
   detectRuntime,
   emitEvent,
+  emitEventWithSessionId,
   getActiveSession,
   getLogLevel,
   getMetricsExporter,
@@ -3061,6 +3149,7 @@ var init_exports = {};
   setLogLevel,
   startSession,
   startSessionTitle,
+  withMute,
   withProperties,
   withSessionId
 });