@brizz/sdk 0.1.40 → 0.1.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/README.md +25 -0
  2. package/dist/{chunk-EC3MYSRM.js → chunk-7FQQHF5U.js} +1 -1
  3. package/dist/{chunk-77UGZGMP.cjs → chunk-FORVS4QW.cjs} +5 -1
  4. package/dist/{chunk-RNU3DOSR.cjs → chunk-K3NPYISB.cjs} +1 -1
  5. package/dist/{chunk-BGLKBQ6N.js → chunk-KVOGOKOB.js} +1 -1
  6. package/dist/{chunk-EVRCHF74.cjs → chunk-QUV5HYJ2.cjs} +4 -4
  7. package/dist/{chunk-WII4R5RE.js → chunk-Y7NMZAQT.js} +4 -0
  8. package/dist/index.cjs +350 -229
  9. package/dist/index.js +205 -84
  10. package/dist/interrupt-3NXOTY4N.cjs +12 -0
  11. package/dist/{interrupt-YJVZK4VC.js → interrupt-ERCX5RXR.js} +2 -2
  12. package/dist/{mcp-HBOMHU67.js → mcp-5BFXKN63.js} +50 -34
  13. package/dist/{mcp-64ZNSCIR.cjs → mcp-GVGTOWHP.cjs} +61 -45
  14. package/dist/types/cjs/index.d.ts +1 -1
  15. package/dist/types/cjs/internal/instrumentation/mcp/session.d.ts +1 -0
  16. package/dist/types/cjs/internal/log/logging.d.ts +5 -5
  17. package/dist/types/cjs/internal/semantic-conventions.d.ts +2 -0
  18. package/dist/types/cjs/internal/trace/exporters/span-exporter.d.ts +11 -2
  19. package/dist/types/cjs/internal/trace/index.d.ts +1 -1
  20. package/dist/types/cjs/internal/trace/session.d.ts +4 -0
  21. package/dist/types/esm/index.d.ts +1 -1
  22. package/dist/types/esm/internal/instrumentation/mcp/session.d.ts +1 -0
  23. package/dist/types/esm/internal/log/logging.d.ts +5 -5
  24. package/dist/types/esm/internal/semantic-conventions.d.ts +2 -0
  25. package/dist/types/esm/internal/trace/exporters/span-exporter.d.ts +11 -2
  26. package/dist/types/esm/internal/trace/index.d.ts +1 -1
  27. package/dist/types/esm/internal/trace/session.d.ts +4 -0
  28. package/package.json +13 -13
  29. package/dist/interrupt-DM3AWSBX.cjs +0 -12
package/README.md CHANGED
@@ -17,6 +17,7 @@ OpenAI, Anthropic, Vercel AI SDK, and more.
17
17
  - [PII Masking](#pii-masking)
18
18
  - [Session Tracking](#session-tracking)
19
19
  - [Mute Messages](#mute-messages)
20
+ - [Multiple Services in One Process](#multiple-services-in-one-process)
20
21
  - [Custom Events & Logging](#custom-events--logging)
21
22
  - [Environment Variables](#environment-variables)
22
23
  - [Disable Span Export](#disable-span-export)
@@ -620,6 +621,30 @@ Brizz.initialize({
620
621
  });
621
622
  ```
622
623
 
624
+ ## Multiple Services in One Process
625
+
626
+ `appName` names the whole process. When one process runs several agents that
627
+ should show up as separate services in Brizz, scope the service name instead:
628
+
629
+ ```typescript
630
+ import { callWithServiceName, withServiceName, setServiceName } from '@brizz/sdk';
631
+
632
+ // Everything traced inside the callback reports as 'checkout-agent',
633
+ // including auto-instrumented LLM calls
634
+ await callWithServiceName('checkout-agent', async () => {
635
+ return openai.chat.completions.create({ ... });
636
+ });
637
+
638
+ // Pre-wrap a handler
639
+ const handleSupport = withServiceName('support-agent', supportHandler);
640
+
641
+ // Imperative form, for when the enclosing span already exists
642
+ // (an MCP or HTTP instrumentation opens its span before your handler runs)
643
+ setServiceName('billing-agent');
644
+ ```
645
+
646
+ Spans and events created outside any of these keep the configured `appName`.
647
+
623
648
  ## Custom Events & Logging
624
649
 
625
650
  Emit custom events and structured logs:
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  INTERRUPT_TOOLS
3
- } from "./chunk-WII4R5RE.js";
3
+ } from "./chunk-Y7NMZAQT.js";
4
4
 
5
5
  // src/internal/instrumentation/vercel-ai/interrupt.ts
6
6
  import { trace } from "@opentelemetry/api";
@@ -23,6 +23,8 @@ var ORGANIZATION_NAME = "organization.name";
23
23
  var ORGANIZATION_PLAN = "organization.plan";
24
24
  var ORGANIZATION_DOMAIN = "organization.domain";
25
25
  var MESSAGE_ID = "message.id";
26
+ var SERVICE_NAME = "service.name";
27
+ var SERVICE_NAME_ATTRIBUTE = `${BRIZZ}.${SERVICE_NAME}`;
26
28
  var SESSION_TITLE_SPAN_NAME = "brizz.session_title";
27
29
  var SESSION_TITLE_GENERATION = "session.title_generation";
28
30
  var SESSION_TITLE = "brizz.session.title";
@@ -116,4 +118,6 @@ var METRIC_POLARITY_NEGATIVE = "negative";
116
118
 
117
119
 
118
120
 
119
- exports.BRIZZ = BRIZZ; exports.SESSION_ID = SESSION_ID; exports.PROPERTIES_CONTEXT_KEY = PROPERTIES_CONTEXT_KEY; exports.SESSION_OBJECT_CONTEXT_KEY = SESSION_OBJECT_CONTEXT_KEY; exports.SESSION_INPUT = SESSION_INPUT; exports.SESSION_OUTPUT = SESSION_OUTPUT; exports.SESSION_INPUT_CONTEXT = SESSION_INPUT_CONTEXT; exports.SESSION_OUTPUT_CONTEXT = SESSION_OUTPUT_CONTEXT; exports.SESSION_SPAN_NAME = SESSION_SPAN_NAME; exports.MUTE_INPUT = MUTE_INPUT; exports.MUTE_OUTPUT = MUTE_OUTPUT; exports.MUTE_TOOLS = MUTE_TOOLS; exports.USER_ID = USER_ID; exports.USER_EMAIL = USER_EMAIL; exports.USER_NAME = USER_NAME; exports.USER_ROLE = USER_ROLE; exports.USER_PLAN = USER_PLAN; exports.ORGANIZATION_ID = ORGANIZATION_ID; exports.ORGANIZATION_NAME = ORGANIZATION_NAME; exports.ORGANIZATION_PLAN = ORGANIZATION_PLAN; exports.ORGANIZATION_DOMAIN = ORGANIZATION_DOMAIN; exports.MESSAGE_ID = MESSAGE_ID; exports.SESSION_TITLE_SPAN_NAME = SESSION_TITLE_SPAN_NAME; exports.SESSION_TITLE_GENERATION = SESSION_TITLE_GENERATION; exports.SESSION_TITLE = SESSION_TITLE; exports.INTERRUPT_TOOLS = INTERRUPT_TOOLS; exports.INTERNAL_EVENT_PREFIX = INTERNAL_EVENT_PREFIX; exports.EXTERNAL_LINK_EVENT_NAME = EXTERNAL_LINK_EVENT_NAME; exports.EXTERNAL_LINK_URL = EXTERNAL_LINK_URL; exports.EXTERNAL_LINK_TITLE = EXTERNAL_LINK_TITLE; exports.EXTERNAL_LINK_TYPE = EXTERNAL_LINK_TYPE; exports.FEEDBACK_EVENT_NAME = FEEDBACK_EVENT_NAME; exports.FEEDBACK_TYPE = FEEDBACK_TYPE; exports.FEEDBACK_SCORE = FEEDBACK_SCORE; exports.FEEDBACK_REASON = FEEDBACK_REASON; exports.FEEDBACK_COMMENT = FEEDBACK_COMMENT; exports.FEEDBACK_SOURCE = FEEDBACK_SOURCE; exports.FEEDBACK_ATTR_PREFIX = FEEDBACK_ATTR_PREFIX; exports.METRIC_EVENT_NAME = METRIC_EVENT_NAME; exports.METRIC_NAME = METRIC_NAME; exports.METRIC_VALUE = METRIC_VALUE; exports.METRIC_UNIT = METRIC_UNIT; exports.METRIC_COMMENT = METRIC_COMMENT; exports.METRIC_POLARITY = METRIC_POLARITY; exports.METRIC_MIN = METRIC_MIN; exports.METRIC_MAX = METRIC_MAX; exports.METRIC_TIMESTAMP = METRIC_TIMESTAMP; exports.METRIC_ATTRIBUTE_PREFIX = METRIC_ATTRIBUTE_PREFIX; exports.RESERVED_METRIC_NAMES = RESERVED_METRIC_NAMES; exports.METRIC_POLARITY_POSITIVE = METRIC_POLARITY_POSITIVE; exports.METRIC_POLARITY_NEGATIVE = METRIC_POLARITY_NEGATIVE;
121
+
122
+
123
+ exports.BRIZZ = BRIZZ; exports.SESSION_ID = SESSION_ID; exports.PROPERTIES_CONTEXT_KEY = PROPERTIES_CONTEXT_KEY; exports.SESSION_OBJECT_CONTEXT_KEY = SESSION_OBJECT_CONTEXT_KEY; exports.SESSION_INPUT = SESSION_INPUT; exports.SESSION_OUTPUT = SESSION_OUTPUT; exports.SESSION_INPUT_CONTEXT = SESSION_INPUT_CONTEXT; exports.SESSION_OUTPUT_CONTEXT = SESSION_OUTPUT_CONTEXT; exports.SESSION_SPAN_NAME = SESSION_SPAN_NAME; exports.MUTE_INPUT = MUTE_INPUT; exports.MUTE_OUTPUT = MUTE_OUTPUT; exports.MUTE_TOOLS = MUTE_TOOLS; exports.USER_ID = USER_ID; exports.USER_EMAIL = USER_EMAIL; exports.USER_NAME = USER_NAME; exports.USER_ROLE = USER_ROLE; exports.USER_PLAN = USER_PLAN; exports.ORGANIZATION_ID = ORGANIZATION_ID; exports.ORGANIZATION_NAME = ORGANIZATION_NAME; exports.ORGANIZATION_PLAN = ORGANIZATION_PLAN; exports.ORGANIZATION_DOMAIN = ORGANIZATION_DOMAIN; exports.MESSAGE_ID = MESSAGE_ID; exports.SERVICE_NAME = SERVICE_NAME; exports.SERVICE_NAME_ATTRIBUTE = SERVICE_NAME_ATTRIBUTE; exports.SESSION_TITLE_SPAN_NAME = SESSION_TITLE_SPAN_NAME; exports.SESSION_TITLE_GENERATION = SESSION_TITLE_GENERATION; exports.SESSION_TITLE = SESSION_TITLE; exports.INTERRUPT_TOOLS = INTERRUPT_TOOLS; exports.INTERNAL_EVENT_PREFIX = INTERNAL_EVENT_PREFIX; exports.EXTERNAL_LINK_EVENT_NAME = EXTERNAL_LINK_EVENT_NAME; exports.EXTERNAL_LINK_URL = EXTERNAL_LINK_URL; exports.EXTERNAL_LINK_TITLE = EXTERNAL_LINK_TITLE; exports.EXTERNAL_LINK_TYPE = EXTERNAL_LINK_TYPE; exports.FEEDBACK_EVENT_NAME = FEEDBACK_EVENT_NAME; exports.FEEDBACK_TYPE = FEEDBACK_TYPE; exports.FEEDBACK_SCORE = FEEDBACK_SCORE; exports.FEEDBACK_REASON = FEEDBACK_REASON; exports.FEEDBACK_COMMENT = FEEDBACK_COMMENT; exports.FEEDBACK_SOURCE = FEEDBACK_SOURCE; exports.FEEDBACK_ATTR_PREFIX = FEEDBACK_ATTR_PREFIX; exports.METRIC_EVENT_NAME = METRIC_EVENT_NAME; exports.METRIC_NAME = METRIC_NAME; exports.METRIC_VALUE = METRIC_VALUE; exports.METRIC_UNIT = METRIC_UNIT; exports.METRIC_COMMENT = METRIC_COMMENT; exports.METRIC_POLARITY = METRIC_POLARITY; exports.METRIC_MIN = METRIC_MIN; exports.METRIC_MAX = METRIC_MAX; exports.METRIC_TIMESTAMP = METRIC_TIMESTAMP; exports.METRIC_ATTRIBUTE_PREFIX = METRIC_ATTRIBUTE_PREFIX; exports.RESERVED_METRIC_NAMES = RESERVED_METRIC_NAMES; exports.METRIC_POLARITY_POSITIVE = METRIC_POLARITY_POSITIVE; exports.METRIC_POLARITY_NEGATIVE = METRIC_POLARITY_NEGATIVE;
@@ -1,6 +1,6 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/internal/version.ts
2
2
  function getSDKVersion() {
3
- return "0.1.40";
3
+ return "0.1.42";
4
4
  }
5
5
 
6
6
 
@@ -1,6 +1,6 @@
1
1
  // src/internal/version.ts
2
2
  function getSDKVersion() {
3
- return "0.1.40";
3
+ return "0.1.42";
4
4
  }
5
5
 
6
6
  export {
@@ -1,6 +1,6 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
2
2
 
3
- var _chunk77UGZGMPcjs = require('./chunk-77UGZGMP.cjs');
3
+ var _chunkFORVS4QWcjs = require('./chunk-FORVS4QW.cjs');
4
4
 
5
5
  // src/internal/instrumentation/vercel-ai/interrupt.ts
6
6
  var _api = require('@opentelemetry/api');
@@ -78,7 +78,7 @@ function createInterruptIntegration() {
78
78
  return;
79
79
  }
80
80
  const value = JSON.stringify(names);
81
- span.setAttribute(_chunk77UGZGMPcjs.INTERRUPT_TOOLS, value);
81
+ span.setAttribute(_chunkFORVS4QWcjs.INTERRUPT_TOOLS, value);
82
82
  setPending(span.spanContext().spanId, value);
83
83
  };
84
84
  return {
@@ -94,7 +94,7 @@ var InterruptPropagator = class {
94
94
  const parentSpanId = _optionalChain([span, 'access', _ => _.parentSpanContext, 'optionalAccess', _2 => _2.spanId]);
95
95
  const stashed = parentSpanId && pendingByParentSpanId.get(parentSpanId);
96
96
  if (stashed) {
97
- span.setAttribute(_chunk77UGZGMPcjs.INTERRUPT_TOOLS, stashed);
97
+ span.setAttribute(_chunkFORVS4QWcjs.INTERRUPT_TOOLS, stashed);
98
98
  pendingByParentSpanId.delete(parentSpanId);
99
99
  return;
100
100
  }
@@ -104,7 +104,7 @@ var InterruptPropagator = class {
104
104
  const scoped = parsePromptToolNames(span.attributes["ai.prompt.tools"]);
105
105
  const names = scoped === null ? [...needsApprovalToolNames] : scoped.filter((n) => needsApprovalToolNames.has(n));
106
106
  if (names.length > 0) {
107
- span.setAttribute(_chunk77UGZGMPcjs.INTERRUPT_TOOLS, JSON.stringify(names));
107
+ span.setAttribute(_chunkFORVS4QWcjs.INTERRUPT_TOOLS, JSON.stringify(names));
108
108
  }
109
109
  }
110
110
  onEnd() {
@@ -23,6 +23,8 @@ var ORGANIZATION_NAME = "organization.name";
23
23
  var ORGANIZATION_PLAN = "organization.plan";
24
24
  var ORGANIZATION_DOMAIN = "organization.domain";
25
25
  var MESSAGE_ID = "message.id";
26
+ var SERVICE_NAME = "service.name";
27
+ var SERVICE_NAME_ATTRIBUTE = `${BRIZZ}.${SERVICE_NAME}`;
26
28
  var SESSION_TITLE_SPAN_NAME = "brizz.session_title";
27
29
  var SESSION_TITLE_GENERATION = "session.title_generation";
28
30
  var SESSION_TITLE = "brizz.session.title";
@@ -87,6 +89,8 @@ export {
87
89
  ORGANIZATION_PLAN,
88
90
  ORGANIZATION_DOMAIN,
89
91
  MESSAGE_ID,
92
+ SERVICE_NAME,
93
+ SERVICE_NAME_ATTRIBUTE,
90
94
  SESSION_TITLE_SPAN_NAME,
91
95
  SESSION_TITLE_GENERATION,
92
96
  SESSION_TITLE,