@brizz/sdk 0.1.42 → 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.
Files changed (33) hide show
  1. package/README.md +44 -0
  2. package/dist/{chunk-QUV5HYJ2.cjs → chunk-3IGBYXLR.cjs} +4 -4
  3. package/dist/{chunk-FORVS4QW.cjs → chunk-5WBPX342.cjs} +7 -1
  4. package/dist/chunk-A3HH5OUL.cjs +240 -0
  5. package/dist/chunk-AELIATPI.js +240 -0
  6. package/dist/{chunk-Y7NMZAQT.js → chunk-AOT5NJDV.js} +6 -0
  7. package/dist/{chunk-7FQQHF5U.js → chunk-APOYOP7D.js} +1 -1
  8. package/dist/index.cjs +270 -128
  9. package/dist/index.js +154 -12
  10. package/dist/{interrupt-ERCX5RXR.js → interrupt-A6O7N72X.js} +2 -2
  11. package/dist/interrupt-IKOUBQGN.cjs +12 -0
  12. package/dist/{mcp-GVGTOWHP.cjs → mcp-5FSUXYHM.cjs} +97 -100
  13. package/dist/{mcp-5BFXKN63.js → mcp-7EJXVCPI.js} +83 -86
  14. package/dist/types/cjs/index.d.ts +2 -2
  15. package/dist/types/cjs/internal/instrumentation/mcp/client-session.d.ts +24 -0
  16. package/dist/types/cjs/internal/instrumentation/mcp/session.d.ts +3 -1
  17. package/dist/types/cjs/internal/sdk.d.ts +2 -0
  18. package/dist/types/cjs/internal/semantic-conventions.d.ts +3 -0
  19. package/dist/types/cjs/internal/trace/agent.d.ts +18 -0
  20. package/dist/types/cjs/internal/trace/index.d.ts +2 -0
  21. package/dist/types/cjs/internal/trace/session.d.ts +2 -1
  22. package/dist/types/esm/index.d.ts +2 -2
  23. package/dist/types/esm/internal/instrumentation/mcp/client-session.d.ts +24 -0
  24. package/dist/types/esm/internal/instrumentation/mcp/session.d.ts +3 -1
  25. package/dist/types/esm/internal/sdk.d.ts +2 -0
  26. package/dist/types/esm/internal/semantic-conventions.d.ts +3 -0
  27. package/dist/types/esm/internal/trace/agent.d.ts +18 -0
  28. package/dist/types/esm/internal/trace/index.d.ts +2 -0
  29. package/dist/types/esm/internal/trace/session.d.ts +2 -1
  30. package/package.json +10 -10
  31. package/dist/chunk-K3NPYISB.cjs +0 -8
  32. package/dist/chunk-KVOGOKOB.js +0 -8
  33. package/dist/interrupt-3NXOTY4N.cjs +0 -12
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;
@@ -0,0 +1,240 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } 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
+
3
+ var _chunkWC573FCIcjs = require('./chunk-WC573FCI.cjs');
4
+
5
+
6
+
7
+
8
+ var _chunk5WBPX342cjs = require('./chunk-5WBPX342.cjs');
9
+
10
+ // src/internal/instrumentation/mcp/session.ts
11
+ var _api = require('@opentelemetry/api');
12
+ var INTENT_PROPERTY = "internal.intent";
13
+ var FALLBACK_SESSION_ID = /* @__PURE__ */ Symbol("brizz.mcp.fallback-session-id");
14
+ var FALLBACK_SESSION_ID_BYTES = 16;
15
+ function generateSessionId() {
16
+ let id = "";
17
+ for (let i = 0; i < FALLBACK_SESSION_ID_BYTES; i++) {
18
+ id += Math.floor(Math.random() * 256).toString(16).padStart(2, "0");
19
+ }
20
+ return id;
21
+ }
22
+ function isSessionCarrier(value) {
23
+ return typeof value === "object" && value !== null;
24
+ }
25
+ function resolveTransportSessionId(protocol) {
26
+ if (!isSessionCarrier(protocol)) {
27
+ return void 0;
28
+ }
29
+ return _nullishCoalesce(protocol.sessionId, () => ( _optionalChain([protocol, 'access', _ => _._transport, 'optionalAccess', _2 => _2.sessionId])));
30
+ }
31
+ function resolveSessionId(protocol, baseContext) {
32
+ if (!isSessionCarrier(protocol)) {
33
+ return void 0;
34
+ }
35
+ const fromTransport = resolveTransportSessionId(protocol);
36
+ if (fromTransport) {
37
+ return fromTransport;
38
+ }
39
+ try {
40
+ const bound = baseContext.getValue(_chunk5WBPX342cjs.PROPERTIES_CONTEXT_KEY);
41
+ if (_optionalChain([bound, 'optionalAccess', _3 => _3[_chunk5WBPX342cjs.SESSION_ID]])) {
42
+ return void 0;
43
+ }
44
+ } catch (e) {
45
+ }
46
+ protocol[FALLBACK_SESSION_ID] ??= generateSessionId();
47
+ return protocol[FALLBACK_SESSION_ID];
48
+ }
49
+ function stampAndPropagateSession(span, sessionId, baseContext = _api.context.active(), intent) {
50
+ if (!sessionId && !intent) {
51
+ return { context: baseContext, sessionId: null };
52
+ }
53
+ const properties = {};
54
+ if (sessionId) {
55
+ properties[_chunk5WBPX342cjs.SESSION_ID] = sessionId;
56
+ }
57
+ if (intent) {
58
+ properties[INTENT_PROPERTY] = intent;
59
+ }
60
+ if (span.isRecording()) {
61
+ for (const [key, value] of Object.entries(properties)) {
62
+ try {
63
+ span.setAttribute(`${_chunk5WBPX342cjs.BRIZZ}.${key}`, value);
64
+ } catch (error) {
65
+ _chunkWC573FCIcjs.logger.warn(`Brizz MCP: failed to stamp ${key} on span: ${String(error)}`);
66
+ }
67
+ }
68
+ }
69
+ try {
70
+ const prev = baseContext.getValue(_chunk5WBPX342cjs.PROPERTIES_CONTEXT_KEY);
71
+ const merged = prev ? { ...prev, ...properties } : properties;
72
+ return {
73
+ context: baseContext.setValue(_chunk5WBPX342cjs.PROPERTIES_CONTEXT_KEY, merged),
74
+ sessionId: _nullishCoalesce(sessionId, () => ( null))
75
+ };
76
+ } catch (error) {
77
+ _chunkWC573FCIcjs.logger.warn(`Brizz MCP: failed to attach session context: ${String(error)}`);
78
+ return { context: baseContext, sessionId: _nullishCoalesce(sessionId, () => ( null)) };
79
+ }
80
+ }
81
+
82
+ // src/internal/instrumentation/mcp/client-session.ts
83
+ var DEFAULT_SESSION_PARAM = "brizz_mcp_session_id";
84
+ var DEFAULT_SESSION_TOOL_NAME = "brizz_start_session";
85
+ var INTENT_PARAM = "brizz_intent";
86
+ var INTENT_PARAM_DESCRIPTION = "Short natural-language description of what the user is ultimately trying to accomplish with this call. Repeat the same intent across the calls that serve one goal; change it when the goal changes.";
87
+ var enabled = false;
88
+ var intentEnabled = true;
89
+ var sessionParamName = DEFAULT_SESSION_PARAM;
90
+ var sessionToolName = DEFAULT_SESSION_TOOL_NAME;
91
+ var nameTakenByServer = false;
92
+ function configure(config) {
93
+ if (typeof config === "boolean" || config === void 0) {
94
+ enabled = config === true;
95
+ intentEnabled = true;
96
+ sessionParamName = DEFAULT_SESSION_PARAM;
97
+ sessionToolName = DEFAULT_SESSION_TOOL_NAME;
98
+ nameTakenByServer = false;
99
+ return;
100
+ }
101
+ enabled = config.enabled === true;
102
+ intentEnabled = config.intent !== false;
103
+ sessionParamName = _optionalChain([config, 'access', _4 => _4.sessionParamName, 'optionalAccess', _5 => _5.trim, 'call', _6 => _6()]) || DEFAULT_SESSION_PARAM;
104
+ sessionToolName = _optionalChain([config, 'access', _7 => _7.sessionToolName, 'optionalAccess', _8 => _8.trim, 'call', _9 => _9()]) || DEFAULT_SESSION_TOOL_NAME;
105
+ nameTakenByServer = false;
106
+ }
107
+ function isEnabled() {
108
+ return enabled;
109
+ }
110
+ function sessionParamDescription() {
111
+ return `Conversation-continuity token for this MCP server. Call \`${sessionToolName}\` once at the start of the conversation to obtain it, then send that same value on EVERY later call. If you already have one from earlier in this conversation, reuse it \u2014 do not call \`${sessionToolName}\` again, and never make up your own value.`;
112
+ }
113
+ function sessionToolDescription() {
114
+ return "Obtain the session id required by every other tool on this server. Call this ONCE, before your first other tool call, and reuse the value it returns for the whole conversation. If you have already called it in this conversation, do not call it again \u2014 reuse the value you were given.";
115
+ }
116
+ function sessionToolEntry() {
117
+ return {
118
+ name: sessionToolName,
119
+ description: sessionToolDescription(),
120
+ inputSchema: { type: "object", properties: {}, required: [] }
121
+ };
122
+ }
123
+ function isSessionToolCall(request) {
124
+ if (!enabled || nameTakenByServer || !request || typeof request !== "object") {
125
+ return false;
126
+ }
127
+ const params = request.params;
128
+ return _optionalChain([params, 'optionalAccess', _10 => _10.name]) === sessionToolName;
129
+ }
130
+ function sessionToolResult() {
131
+ const id = generateSessionId();
132
+ return { id, result: { content: [{ type: "text", text: id }] } };
133
+ }
134
+ function patchSchema(schema) {
135
+ const base = schema && typeof schema === "object" ? { ...schema } : {};
136
+ base["type"] = _nullishCoalesce(base["type"], () => ( "object"));
137
+ const properties = base["properties"] && typeof base["properties"] === "object" ? { ...base["properties"] } : {};
138
+ properties[sessionParamName] = { type: "string", description: sessionParamDescription() };
139
+ if (intentEnabled) {
140
+ properties[INTENT_PARAM] = { type: "string", description: INTENT_PARAM_DESCRIPTION };
141
+ }
142
+ base["properties"] = properties;
143
+ const required = Array.isArray(base["required"]) ? [...base["required"]] : [];
144
+ if (!required.includes(sessionParamName)) {
145
+ required.push(sessionParamName);
146
+ }
147
+ if (base["additionalProperties"] === false && intentEnabled && !required.includes(INTENT_PARAM)) {
148
+ required.push(INTENT_PARAM);
149
+ }
150
+ base["required"] = required;
151
+ return base;
152
+ }
153
+ function preamble() {
154
+ const intentHint = intentEnabled ? ` Optionally pass \`${INTENT_PARAM}\` describing the user's goal.` : "";
155
+ return `[Session tracking] This server requires \`${sessionParamName}\` on every call \u2014 call \`${sessionToolName}\` once to get it, then reuse that value.${intentHint}
156
+
157
+ `;
158
+ }
159
+ function patchListToolsResult(result) {
160
+ if (!result || typeof result !== "object") {
161
+ return result;
162
+ }
163
+ const tools = result.tools;
164
+ if (!Array.isArray(tools)) {
165
+ return result;
166
+ }
167
+ if (tools.some((t) => _optionalChain([t, 'optionalAccess', _11 => _11.name]) === sessionToolName)) {
168
+ if (!nameTakenByServer) {
169
+ nameTakenByServer = true;
170
+ _chunkWC573FCIcjs.logger.error(
171
+ `Brizz MCP: this server already publishes a tool named "${sessionToolName}", so Brizz cannot issue session ids through it. Session tracking is off. Set sessionToolName to a free name.`
172
+ );
173
+ }
174
+ return result;
175
+ }
176
+ const patched = tools.map((tool) => {
177
+ if (!tool || typeof tool !== "object") {
178
+ return tool;
179
+ }
180
+ try {
181
+ const entry = tool;
182
+ return {
183
+ ...entry,
184
+ inputSchema: patchSchema(entry["inputSchema"]),
185
+ description: preamble() + String(_nullishCoalesce(entry["description"], () => ( "")))
186
+ };
187
+ } catch (error) {
188
+ _chunkWC573FCIcjs.logger.warn(`Brizz MCP: could not patch tool schema, advertising it unchanged: ${String(error)}`);
189
+ return tool;
190
+ }
191
+ });
192
+ return {
193
+ ...result,
194
+ tools: [...patched, sessionToolEntry()]
195
+ };
196
+ }
197
+ function popTrackingArguments(request) {
198
+ if (!request || typeof request !== "object") {
199
+ return {};
200
+ }
201
+ const params = request.params;
202
+ if (!params || typeof params !== "object") {
203
+ return {};
204
+ }
205
+ const args = params.arguments;
206
+ if (!args || typeof args !== "object") {
207
+ return {};
208
+ }
209
+ const bag = args;
210
+ const sessionId = bag[sessionParamName];
211
+ const intent = bag[INTENT_PARAM];
212
+ delete bag[sessionParamName];
213
+ delete bag[INTENT_PARAM];
214
+ const tracking = {};
215
+ if (typeof sessionId === "string" && sessionId) {
216
+ tracking.sessionId = sessionId;
217
+ }
218
+ if (intentEnabled && typeof intent === "string" && intent) {
219
+ tracking.intent = intent;
220
+ }
221
+ return tracking;
222
+ }
223
+
224
+ // src/internal/version.ts
225
+ function getSDKVersion() {
226
+ return "0.1.44";
227
+ }
228
+
229
+
230
+
231
+
232
+
233
+
234
+
235
+
236
+
237
+
238
+
239
+
240
+ exports.resolveTransportSessionId = resolveTransportSessionId; exports.resolveSessionId = resolveSessionId; exports.stampAndPropagateSession = stampAndPropagateSession; exports.configure = configure; exports.isEnabled = isEnabled; exports.isSessionToolCall = isSessionToolCall; exports.sessionToolResult = sessionToolResult; exports.patchListToolsResult = patchListToolsResult; exports.popTrackingArguments = popTrackingArguments; exports.getSDKVersion = getSDKVersion;
@@ -0,0 +1,240 @@
1
+ import {
2
+ logger
3
+ } from "./chunk-Y4HNUX3Q.js";
4
+ import {
5
+ BRIZZ,
6
+ PROPERTIES_CONTEXT_KEY,
7
+ SESSION_ID
8
+ } from "./chunk-AOT5NJDV.js";
9
+
10
+ // src/internal/instrumentation/mcp/session.ts
11
+ import { context } from "@opentelemetry/api";
12
+ var INTENT_PROPERTY = "internal.intent";
13
+ var FALLBACK_SESSION_ID = /* @__PURE__ */ Symbol("brizz.mcp.fallback-session-id");
14
+ var FALLBACK_SESSION_ID_BYTES = 16;
15
+ function generateSessionId() {
16
+ let id = "";
17
+ for (let i = 0; i < FALLBACK_SESSION_ID_BYTES; i++) {
18
+ id += Math.floor(Math.random() * 256).toString(16).padStart(2, "0");
19
+ }
20
+ return id;
21
+ }
22
+ function isSessionCarrier(value) {
23
+ return typeof value === "object" && value !== null;
24
+ }
25
+ function resolveTransportSessionId(protocol) {
26
+ if (!isSessionCarrier(protocol)) {
27
+ return void 0;
28
+ }
29
+ return protocol.sessionId ?? protocol._transport?.sessionId;
30
+ }
31
+ function resolveSessionId(protocol, baseContext) {
32
+ if (!isSessionCarrier(protocol)) {
33
+ return void 0;
34
+ }
35
+ const fromTransport = resolveTransportSessionId(protocol);
36
+ if (fromTransport) {
37
+ return fromTransport;
38
+ }
39
+ try {
40
+ const bound = baseContext.getValue(PROPERTIES_CONTEXT_KEY);
41
+ if (bound?.[SESSION_ID]) {
42
+ return void 0;
43
+ }
44
+ } catch {
45
+ }
46
+ protocol[FALLBACK_SESSION_ID] ??= generateSessionId();
47
+ return protocol[FALLBACK_SESSION_ID];
48
+ }
49
+ function stampAndPropagateSession(span, sessionId, baseContext = context.active(), intent) {
50
+ if (!sessionId && !intent) {
51
+ return { context: baseContext, sessionId: null };
52
+ }
53
+ const properties = {};
54
+ if (sessionId) {
55
+ properties[SESSION_ID] = sessionId;
56
+ }
57
+ if (intent) {
58
+ properties[INTENT_PROPERTY] = intent;
59
+ }
60
+ if (span.isRecording()) {
61
+ for (const [key, value] of Object.entries(properties)) {
62
+ try {
63
+ span.setAttribute(`${BRIZZ}.${key}`, value);
64
+ } catch (error) {
65
+ logger.warn(`Brizz MCP: failed to stamp ${key} on span: ${String(error)}`);
66
+ }
67
+ }
68
+ }
69
+ try {
70
+ const prev = baseContext.getValue(PROPERTIES_CONTEXT_KEY);
71
+ const merged = prev ? { ...prev, ...properties } : properties;
72
+ return {
73
+ context: baseContext.setValue(PROPERTIES_CONTEXT_KEY, merged),
74
+ sessionId: sessionId ?? null
75
+ };
76
+ } catch (error) {
77
+ logger.warn(`Brizz MCP: failed to attach session context: ${String(error)}`);
78
+ return { context: baseContext, sessionId: sessionId ?? null };
79
+ }
80
+ }
81
+
82
+ // src/internal/instrumentation/mcp/client-session.ts
83
+ var DEFAULT_SESSION_PARAM = "brizz_mcp_session_id";
84
+ var DEFAULT_SESSION_TOOL_NAME = "brizz_start_session";
85
+ var INTENT_PARAM = "brizz_intent";
86
+ var INTENT_PARAM_DESCRIPTION = "Short natural-language description of what the user is ultimately trying to accomplish with this call. Repeat the same intent across the calls that serve one goal; change it when the goal changes.";
87
+ var enabled = false;
88
+ var intentEnabled = true;
89
+ var sessionParamName = DEFAULT_SESSION_PARAM;
90
+ var sessionToolName = DEFAULT_SESSION_TOOL_NAME;
91
+ var nameTakenByServer = false;
92
+ function configure(config) {
93
+ if (typeof config === "boolean" || config === void 0) {
94
+ enabled = config === true;
95
+ intentEnabled = true;
96
+ sessionParamName = DEFAULT_SESSION_PARAM;
97
+ sessionToolName = DEFAULT_SESSION_TOOL_NAME;
98
+ nameTakenByServer = false;
99
+ return;
100
+ }
101
+ enabled = config.enabled === true;
102
+ intentEnabled = config.intent !== false;
103
+ sessionParamName = config.sessionParamName?.trim() || DEFAULT_SESSION_PARAM;
104
+ sessionToolName = config.sessionToolName?.trim() || DEFAULT_SESSION_TOOL_NAME;
105
+ nameTakenByServer = false;
106
+ }
107
+ function isEnabled() {
108
+ return enabled;
109
+ }
110
+ function sessionParamDescription() {
111
+ return `Conversation-continuity token for this MCP server. Call \`${sessionToolName}\` once at the start of the conversation to obtain it, then send that same value on EVERY later call. If you already have one from earlier in this conversation, reuse it \u2014 do not call \`${sessionToolName}\` again, and never make up your own value.`;
112
+ }
113
+ function sessionToolDescription() {
114
+ return "Obtain the session id required by every other tool on this server. Call this ONCE, before your first other tool call, and reuse the value it returns for the whole conversation. If you have already called it in this conversation, do not call it again \u2014 reuse the value you were given.";
115
+ }
116
+ function sessionToolEntry() {
117
+ return {
118
+ name: sessionToolName,
119
+ description: sessionToolDescription(),
120
+ inputSchema: { type: "object", properties: {}, required: [] }
121
+ };
122
+ }
123
+ function isSessionToolCall(request) {
124
+ if (!enabled || nameTakenByServer || !request || typeof request !== "object") {
125
+ return false;
126
+ }
127
+ const params = request.params;
128
+ return params?.name === sessionToolName;
129
+ }
130
+ function sessionToolResult() {
131
+ const id = generateSessionId();
132
+ return { id, result: { content: [{ type: "text", text: id }] } };
133
+ }
134
+ function patchSchema(schema) {
135
+ const base = schema && typeof schema === "object" ? { ...schema } : {};
136
+ base["type"] = base["type"] ?? "object";
137
+ const properties = base["properties"] && typeof base["properties"] === "object" ? { ...base["properties"] } : {};
138
+ properties[sessionParamName] = { type: "string", description: sessionParamDescription() };
139
+ if (intentEnabled) {
140
+ properties[INTENT_PARAM] = { type: "string", description: INTENT_PARAM_DESCRIPTION };
141
+ }
142
+ base["properties"] = properties;
143
+ const required = Array.isArray(base["required"]) ? [...base["required"]] : [];
144
+ if (!required.includes(sessionParamName)) {
145
+ required.push(sessionParamName);
146
+ }
147
+ if (base["additionalProperties"] === false && intentEnabled && !required.includes(INTENT_PARAM)) {
148
+ required.push(INTENT_PARAM);
149
+ }
150
+ base["required"] = required;
151
+ return base;
152
+ }
153
+ function preamble() {
154
+ const intentHint = intentEnabled ? ` Optionally pass \`${INTENT_PARAM}\` describing the user's goal.` : "";
155
+ return `[Session tracking] This server requires \`${sessionParamName}\` on every call \u2014 call \`${sessionToolName}\` once to get it, then reuse that value.${intentHint}
156
+
157
+ `;
158
+ }
159
+ function patchListToolsResult(result) {
160
+ if (!result || typeof result !== "object") {
161
+ return result;
162
+ }
163
+ const tools = result.tools;
164
+ if (!Array.isArray(tools)) {
165
+ return result;
166
+ }
167
+ if (tools.some((t) => t?.name === sessionToolName)) {
168
+ if (!nameTakenByServer) {
169
+ nameTakenByServer = true;
170
+ logger.error(
171
+ `Brizz MCP: this server already publishes a tool named "${sessionToolName}", so Brizz cannot issue session ids through it. Session tracking is off. Set sessionToolName to a free name.`
172
+ );
173
+ }
174
+ return result;
175
+ }
176
+ const patched = tools.map((tool) => {
177
+ if (!tool || typeof tool !== "object") {
178
+ return tool;
179
+ }
180
+ try {
181
+ const entry = tool;
182
+ return {
183
+ ...entry,
184
+ inputSchema: patchSchema(entry["inputSchema"]),
185
+ description: preamble() + String(entry["description"] ?? "")
186
+ };
187
+ } catch (error) {
188
+ logger.warn(`Brizz MCP: could not patch tool schema, advertising it unchanged: ${String(error)}`);
189
+ return tool;
190
+ }
191
+ });
192
+ return {
193
+ ...result,
194
+ tools: [...patched, sessionToolEntry()]
195
+ };
196
+ }
197
+ function popTrackingArguments(request) {
198
+ if (!request || typeof request !== "object") {
199
+ return {};
200
+ }
201
+ const params = request.params;
202
+ if (!params || typeof params !== "object") {
203
+ return {};
204
+ }
205
+ const args = params.arguments;
206
+ if (!args || typeof args !== "object") {
207
+ return {};
208
+ }
209
+ const bag = args;
210
+ const sessionId = bag[sessionParamName];
211
+ const intent = bag[INTENT_PARAM];
212
+ delete bag[sessionParamName];
213
+ delete bag[INTENT_PARAM];
214
+ const tracking = {};
215
+ if (typeof sessionId === "string" && sessionId) {
216
+ tracking.sessionId = sessionId;
217
+ }
218
+ if (intentEnabled && typeof intent === "string" && intent) {
219
+ tracking.intent = intent;
220
+ }
221
+ return tracking;
222
+ }
223
+
224
+ // src/internal/version.ts
225
+ function getSDKVersion() {
226
+ return "0.1.44";
227
+ }
228
+
229
+ export {
230
+ resolveTransportSessionId,
231
+ resolveSessionId,
232
+ stampAndPropagateSession,
233
+ configure,
234
+ isEnabled,
235
+ isSessionToolCall,
236
+ sessionToolResult,
237
+ patchListToolsResult,
238
+ popTrackingArguments,
239
+ getSDKVersion
240
+ };
@@ -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";