@brizz/sdk 0.1.43 → 0.1.44

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.
package/README.md CHANGED
@@ -16,6 +16,7 @@ OpenAI, Anthropic, Vercel AI SDK, and more.
16
16
  - [Supported Libraries](#supported-libraries)
17
17
  - [PII Masking](#pii-masking)
18
18
  - [Session Tracking](#session-tracking)
19
+ - [Subagents](#subagents)
19
20
  - [Mute Messages](#mute-messages)
20
21
  - [Multiple Services in One Process](#multiple-services-in-one-process)
21
22
  - [Custom Events & Logging](#custom-events--logging)
@@ -587,6 +588,49 @@ const sessionedProcess = withSessionId(
587
588
  **Note:** The arrow function approach (Option 1) is recommended as it's more explicit, avoids lint
588
589
  warnings, and is less prone to `this` binding issues.
589
590
 
591
+ ## Subagents
592
+
593
+ Mark work as a subagent so it shows as its own lane in the conversation instead of mixing into the session's main transcript. Nesting composes, and two runs of the same agent stay two lanes.
594
+
595
+ Three forms, same first argument — a name, `{ name, id, parentId }`, or `{ token }`:
596
+
597
+ ```typescript
598
+ import { setAgent, startAgent, withAgent } from '@brizz/sdk';
599
+
600
+ // startAgent — scoped: runs the callback now, returns its return value
601
+ await startAgent('research', () => researchAgent.generate({ prompt: task }));
602
+
603
+ // withAgent — wraps a function; every call is its own run, so its own lane
604
+ const research = withAgent('research', runResearch);
605
+ await research(topicA);
606
+ await research(topicB);
607
+
608
+ // setAgent — imperative, no scope: marks everything created after it, and
609
+ // returns the handle. The natural form at the top of a job or route handler.
610
+ export async function handleJob(job) {
611
+ setAgent({ token: job.brizzAgent });
612
+ await boardCreator.generate({ prompt: job.goal });
613
+ }
614
+
615
+ const { token } = setAgent('board-creator'); // grab the token to send onward
616
+ ```
617
+
618
+ `setAgent` mirrors `setUser` / `setSessionId` — there is no auto-reset, so use `startAgent` when you want the scope to close.
619
+
620
+ Handing a subagent to code running elsewhere — a queue message, an RPC argument, a database row — is the token: send it with the work and re-enter the agent from it on the other side. It carries the session and trace context, so the detached run joins the same conversation.
621
+
622
+ ```typescript
623
+ await startAgent('board-creator', ({ token }) => sendToWorker({ goal, brizzAgent: token }));
624
+ ```
625
+
626
+ Already tracking your own agent ids? Pass them instead of a bare name:
627
+
628
+ ```typescript
629
+ await startAgent({ name: 'research', id: runId, parentId: callerRunId }, () => run());
630
+ ```
631
+
632
+ `id` is your id for this run (unique per run, or two runs share a lane) and `parentId` overrides the enclosing agent. Anything omitted is filled in — a fresh `id` per run, the enclosing agent as the parent. Don't give `withAgent` an `id`: it would put every call to the wrapped function in one lane.
633
+
590
634
  ## Mute Messages
591
635
 
592
636
  Keep internal or unrelated LLM calls — summarization, title generation, classification, guardrail checks — out of the captured conversation. The call still runs and its telemetry (latency, tokens, cost) is recorded; only the content is left out — the prompt, the reply, and the tool calls.
@@ -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 _chunkFORVS4QWcjs = require('./chunk-FORVS4QW.cjs');
3
+ var _chunk5WBPX342cjs = require('./chunk-5WBPX342.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(_chunkFORVS4QWcjs.INTERRUPT_TOOLS, value);
81
+ span.setAttribute(_chunk5WBPX342cjs.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(_chunkFORVS4QWcjs.INTERRUPT_TOOLS, stashed);
97
+ span.setAttribute(_chunk5WBPX342cjs.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(_chunkFORVS4QWcjs.INTERRUPT_TOOLS, JSON.stringify(names));
107
+ span.setAttribute(_chunk5WBPX342cjs.INTERRUPT_TOOLS, JSON.stringify(names));
108
108
  }
109
109
  }
110
110
  onEnd() {
@@ -28,6 +28,9 @@ var SERVICE_NAME_ATTRIBUTE = `${BRIZZ}.${SERVICE_NAME}`;
28
28
  var SESSION_TITLE_SPAN_NAME = "brizz.session_title";
29
29
  var SESSION_TITLE_GENERATION = "session.title_generation";
30
30
  var SESSION_TITLE = "brizz.session.title";
31
+ var AGENT_ID = "internal.agent.id";
32
+ var AGENT_PARENT_ID = "internal.agent.parent_id";
33
+ var AGENT_NAME = "internal.agent.name";
31
34
  var INTERRUPT_TOOLS = "brizz.internal.interrupt";
32
35
  var INTERNAL_EVENT_PREFIX = "brizz.internal.";
33
36
  var EXTERNAL_LINK_EVENT_NAME = "brizz.internal.external_link";
@@ -120,4 +123,7 @@ var METRIC_POLARITY_NEGATIVE = "negative";
120
123
 
121
124
 
122
125
 
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;
126
+
127
+
128
+
129
+ 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.AGENT_ID = AGENT_ID; exports.AGENT_PARENT_ID = AGENT_PARENT_ID; exports.AGENT_NAME = AGENT_NAME; 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;
@@ -5,7 +5,7 @@ var _chunkWC573FCIcjs = require('./chunk-WC573FCI.cjs');
5
5
 
6
6
 
7
7
 
8
- var _chunkFORVS4QWcjs = require('./chunk-FORVS4QW.cjs');
8
+ var _chunk5WBPX342cjs = require('./chunk-5WBPX342.cjs');
9
9
 
10
10
  // src/internal/instrumentation/mcp/session.ts
11
11
  var _api = require('@opentelemetry/api');
@@ -37,8 +37,8 @@ function resolveSessionId(protocol, baseContext) {
37
37
  return fromTransport;
38
38
  }
39
39
  try {
40
- const bound = baseContext.getValue(_chunkFORVS4QWcjs.PROPERTIES_CONTEXT_KEY);
41
- if (_optionalChain([bound, 'optionalAccess', _3 => _3[_chunkFORVS4QWcjs.SESSION_ID]])) {
40
+ const bound = baseContext.getValue(_chunk5WBPX342cjs.PROPERTIES_CONTEXT_KEY);
41
+ if (_optionalChain([bound, 'optionalAccess', _3 => _3[_chunk5WBPX342cjs.SESSION_ID]])) {
42
42
  return void 0;
43
43
  }
44
44
  } catch (e) {
@@ -52,7 +52,7 @@ function stampAndPropagateSession(span, sessionId, baseContext = _api.context.ac
52
52
  }
53
53
  const properties = {};
54
54
  if (sessionId) {
55
- properties[_chunkFORVS4QWcjs.SESSION_ID] = sessionId;
55
+ properties[_chunk5WBPX342cjs.SESSION_ID] = sessionId;
56
56
  }
57
57
  if (intent) {
58
58
  properties[INTENT_PROPERTY] = intent;
@@ -60,17 +60,17 @@ function stampAndPropagateSession(span, sessionId, baseContext = _api.context.ac
60
60
  if (span.isRecording()) {
61
61
  for (const [key, value] of Object.entries(properties)) {
62
62
  try {
63
- span.setAttribute(`${_chunkFORVS4QWcjs.BRIZZ}.${key}`, value);
63
+ span.setAttribute(`${_chunk5WBPX342cjs.BRIZZ}.${key}`, value);
64
64
  } catch (error) {
65
65
  _chunkWC573FCIcjs.logger.warn(`Brizz MCP: failed to stamp ${key} on span: ${String(error)}`);
66
66
  }
67
67
  }
68
68
  }
69
69
  try {
70
- const prev = baseContext.getValue(_chunkFORVS4QWcjs.PROPERTIES_CONTEXT_KEY);
70
+ const prev = baseContext.getValue(_chunk5WBPX342cjs.PROPERTIES_CONTEXT_KEY);
71
71
  const merged = prev ? { ...prev, ...properties } : properties;
72
72
  return {
73
- context: baseContext.setValue(_chunkFORVS4QWcjs.PROPERTIES_CONTEXT_KEY, merged),
73
+ context: baseContext.setValue(_chunk5WBPX342cjs.PROPERTIES_CONTEXT_KEY, merged),
74
74
  sessionId: _nullishCoalesce(sessionId, () => ( null))
75
75
  };
76
76
  } catch (error) {
@@ -223,7 +223,7 @@ function popTrackingArguments(request) {
223
223
 
224
224
  // src/internal/version.ts
225
225
  function getSDKVersion() {
226
- return "0.1.43";
226
+ return "0.1.44";
227
227
  }
228
228
 
229
229
 
@@ -5,7 +5,7 @@ import {
5
5
  BRIZZ,
6
6
  PROPERTIES_CONTEXT_KEY,
7
7
  SESSION_ID
8
- } from "./chunk-Y7NMZAQT.js";
8
+ } from "./chunk-AOT5NJDV.js";
9
9
 
10
10
  // src/internal/instrumentation/mcp/session.ts
11
11
  import { context } from "@opentelemetry/api";
@@ -223,7 +223,7 @@ function popTrackingArguments(request) {
223
223
 
224
224
  // src/internal/version.ts
225
225
  function getSDKVersion() {
226
- return "0.1.43";
226
+ return "0.1.44";
227
227
  }
228
228
 
229
229
  export {
@@ -28,6 +28,9 @@ var SERVICE_NAME_ATTRIBUTE = `${BRIZZ}.${SERVICE_NAME}`;
28
28
  var SESSION_TITLE_SPAN_NAME = "brizz.session_title";
29
29
  var SESSION_TITLE_GENERATION = "session.title_generation";
30
30
  var SESSION_TITLE = "brizz.session.title";
31
+ var AGENT_ID = "internal.agent.id";
32
+ var AGENT_PARENT_ID = "internal.agent.parent_id";
33
+ var AGENT_NAME = "internal.agent.name";
31
34
  var INTERRUPT_TOOLS = "brizz.internal.interrupt";
32
35
  var INTERNAL_EVENT_PREFIX = "brizz.internal.";
33
36
  var EXTERNAL_LINK_EVENT_NAME = "brizz.internal.external_link";
@@ -94,6 +97,9 @@ export {
94
97
  SESSION_TITLE_SPAN_NAME,
95
98
  SESSION_TITLE_GENERATION,
96
99
  SESSION_TITLE,
100
+ AGENT_ID,
101
+ AGENT_PARENT_ID,
102
+ AGENT_NAME,
97
103
  INTERRUPT_TOOLS,
98
104
  INTERNAL_EVENT_PREFIX,
99
105
  EXTERNAL_LINK_EVENT_NAME,
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  INTERRUPT_TOOLS
3
- } from "./chunk-Y7NMZAQT.js";
3
+ } from "./chunk-AOT5NJDV.js";
4
4
 
5
5
  // src/internal/instrumentation/vercel-ai/interrupt.ts
6
6
  import { trace } from "@opentelemetry/api";