@brizz/sdk 0.1.18 → 0.1.20

package/README.md

@@ -287,10 +287,23 @@ const result = await startSession(
 
 **Session Methods:**
 - `session.updateProperties({ key: value })` - Add custom properties to the session span
-- `session.setInput(text)` - (Optional) Manually track input text
-- `session.setOutput(text)` - (Optional) Manually track output text
+- `session.setInput(text, context?)` - (Optional) Manually track input text; optional context bag attaches per-turn metadata rendered in the dashboard's Context panel
+- `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'`)
 
+**Per-turn context example:**
+
+```typescript
+await startSession('session-123', async (session) => {
+  session.setInput('Why is my bill high?', { selected_invoice: 'INV-9182' });
+  const response = await openai.chat.completions.create({ ... });
+  session.setOutput(response.choices[0].message.content, {
+    message_id: 'msg-42',
+    sources: ['doc-abc'],
+  });
+});
+```
+
 **When to use manual input/output tracking:**
 
 In most cases, Brizz automatically captures inputs and outputs from your LLM calls. Use `setInput`/`setOutput` for special scenarios:

package/dist/index.cjs

@@ -505,7 +505,7 @@ var import_sdk_logs2 = require("@opentelemetry/sdk-logs");
 
 // src/internal/version.ts
 function getSDKVersion() {
-  return "0.1.18";
+  return "0.1.20";
 }
 
 // src/internal/log/processors/log-processor.ts
@@ -1145,6 +1145,8 @@ 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_INPUT_CONTEXT = "brizz.session.input.context";
+var SESSION_OUTPUT_CONTEXT = "brizz.session.output.context";
 var SESSION_SPAN_NAME = "brizz.start_session";
 var SESSION_TITLE_SPAN_NAME = "brizz.session_title";
 var SESSION_TITLE_GENERATION = "session.title_generation";
@@ -1584,6 +1586,14 @@ var BrizzSpanExporter = class {
 // src/internal/trace/processors/span-processor.ts
 var import_api4 = require("@opentelemetry/api");
 var import_sdk_trace_base = require("@opentelemetry/sdk-trace-base");
+function applyContextAttributes(span) {
+  const sessionProperties = import_api4.context.active().getValue(PROPERTIES_CONTEXT_KEY);
+  if (sessionProperties) {
+    for (const [key, value] of Object.entries(sessionProperties)) {
+      span.setAttribute(`${BRIZZ}.${key}`, value);
+    }
+  }
+}
 var DEFAULT_MASKING_RULES = [
   {
     mode: "partial",
@@ -1618,12 +1628,7 @@ var BrizzSimpleSpanProcessor = class extends import_sdk_trace_base.SimpleSpanPro
     if (maskingConfig) {
       maskSpan(span, maskingConfig);
     }
-    const associationProperties = import_api4.context.active().getValue(PROPERTIES_CONTEXT_KEY);
-    if (associationProperties) {
-      for (const [key, value] of Object.entries(associationProperties)) {
-        span.setAttribute(`${BRIZZ}.${key}`, value);
-      }
-    }
+    applyContextAttributes(span);
     super.onStart(span, parentContext);
   }
 };
@@ -1638,12 +1643,7 @@ var BrizzBatchSpanProcessor = class extends import_sdk_trace_base.BatchSpanProce
     if (maskingConfig) {
       maskSpan(span, maskingConfig);
     }
-    const associationProperties = import_api4.context.active().getValue(PROPERTIES_CONTEXT_KEY);
-    if (associationProperties) {
-      for (const [key, value] of Object.entries(associationProperties)) {
-        span.setAttribute(`${BRIZZ}.${key}`, value);
-      }
-    }
+    applyContextAttributes(span);
     super.onStart(span, parentContext);
   }
 };
@@ -1817,31 +1817,45 @@ var Session = class {
   span;
   inputs = [];
   outputs = [];
+  inputContexts = [];
+  outputContexts = [];
   constructor(sessionId, span) {
     this.sessionId = sessionId;
     this.span = span;
   }
   /**
-   * (Optional) Append text to session input tracking.
-   * Use when you need to track specific input data that differs from what's sent to the LLM.
-   * Multiple calls accumulate in an array.
+   * 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 to session input, or null to append null
+   * @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) {
+  setInput(text, context4) {
     this.inputs.push(text);
+    this.inputContexts.push(context4 ?? {});
     this.span.setAttribute(SESSION_INPUT, JSON.stringify(this.inputs));
+    this.span.setAttribute(SESSION_INPUT_CONTEXT, JSON.stringify(this.inputContexts));
   }
   /**
-   * (Optional) Append text to session output tracking.
-   * Use when you need to track specific output data that differs from what's received from the LLM.
-   * Multiple calls accumulate in an array.
+   * 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 to session output, or null to append null
+   * @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) {
+  setOutput(text, context4) {
     this.outputs.push(text);
+    this.outputContexts.push(context4 ?? {});
     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.