@brizz/sdk 0.1.14 → 0.1.15

package/README.md

@@ -313,6 +313,26 @@ await startSession('session-456', async (session) => {
 });
 ```
 
+### Accessing the Active Session
+
+Use `getActiveSession()` to retrieve the current session from anywhere within a `startSession` scope — no need to pass the session object through your call stack:
+
+```typescript
+import { startSession, getActiveSession } from '@brizz/sdk';
+
+function deepHelper() {
+  const session = getActiveSession();
+  session?.updateProperties({ step: 'helper' });
+}
+
+await startSession('session-123', async () => {
+  deepHelper(); // accesses session without it being passed as a parameter
+});
+
+// Outside a session, returns undefined
+getActiveSession(); // undefined
+```
+
 ### Function Wrapper Pattern
 
 For simpler cases where you just need to tag traces with a session ID:

package/dist/index.cjs

@@ -39,6 +39,7 @@ __export(src_exports, {
   callWithSessionId: () => callWithSessionId,
   detectRuntime: () => detectRuntime,
   emitEvent: () => emitEvent,
+  getActiveSession: () => getActiveSession,
   getLogLevel: () => getLogLevel,
   getMetricsExporter: () => getMetricsExporter,
   getMetricsReader: () => getMetricsReader,
@@ -493,7 +494,7 @@ var import_sdk_logs2 = require("@opentelemetry/sdk-logs");
 
 // src/internal/version.ts
 function getSDKVersion() {
-  return "0.1.14";
+  return "0.1.15";
 }
 
 // src/internal/log/processors/log-processor.ts
@@ -1130,6 +1131,7 @@ var BRIZZ = "brizz";
 var PROPERTIES = "properties";
 var SESSION_ID = "session.id";
 var PROPERTIES_CONTEXT_KEY = (0, import_api2.createContextKey)(PROPERTIES);
+var SESSION_OBJECT_CONTEXT_KEY = (0, import_api2.createContextKey)("brizz.session.object");
 var SESSION_INPUT = "brizz.session.input";
 var SESSION_OUTPUT = "brizz.session.output";
 var SESSION_SPAN_NAME = "brizz.start_session";
@@ -1762,7 +1764,7 @@ var Session = class {
    * Use when you need to track specific input data that differs from what's sent to the LLM.
    * Multiple calls accumulate in an array.
    *
-   * @param text - Text to append to session input
+   * @param text - Text to append to session input, or null to append null
    */
   setInput(text) {
     this.inputs.push(text);
@@ -1773,7 +1775,7 @@ var Session = class {
    * Use when you need to track specific output data that differs from what's received from the LLM.
    * Multiple calls accumulate in an array.
    *
-   * @param text - Text to append to session output
+   * @param text - Text to append to session output, or null to append null
    */
   setOutput(text) {
     this.outputs.push(text);
@@ -1791,6 +1793,9 @@ var Session = class {
     }
   }
 };
+function getActiveSession() {
+  return import_api5.context.active().getValue(SESSION_OBJECT_CONTEXT_KEY);
+}
 function startSession(sessionId, callback, extraProperties) {
   const tracer = import_api5.trace.getTracer("@brizz/sdk");
   return tracer.startActiveSpan(SESSION_SPAN_NAME, (span) => {
@@ -1808,27 +1813,30 @@ function startSession(sessionId, callback, extraProperties) {
       }
     }
     return callWithProperties(contextProperties, () => {
-      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_api5.SpanStatusCode.ERROR });
-            span.end();
-            throw error;
-          });
+      const sessionCtx = import_api5.context.active().setValue(SESSION_OBJECT_CONTEXT_KEY, session);
+      return import_api5.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_api5.SpanStatusCode.ERROR });
+              span.end();
+              throw error;
+            });
+          }
+          span.end();
+          return result;
+        } catch (error) {
+          span.recordException(error);
+          span.setStatus({ code: import_api5.SpanStatusCode.ERROR });
+          span.end();
+          throw error;
         }
-        span.end();
-        return result;
-      } catch (error) {
-        span.recordException(error);
-        span.setStatus({ code: import_api5.SpanStatusCode.ERROR });
-        span.end();
-        throw error;
-      }
+      });
     });
   });
 }
@@ -2088,6 +2096,7 @@ var init_exports = {};
   callWithSessionId,
   detectRuntime,
   emitEvent,
+  getActiveSession,
   getLogLevel,
   getMetricsExporter,
   getMetricsReader,