@brizz/sdk 0.1.41 → 0.1.43
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 +25 -0
- package/dist/chunk-5SWAZUC5.js +240 -0
- package/dist/{chunk-EC3MYSRM.js → chunk-7FQQHF5U.js} +1 -1
- package/dist/{chunk-77UGZGMP.cjs → chunk-FORVS4QW.cjs} +5 -1
- package/dist/{chunk-EVRCHF74.cjs → chunk-QUV5HYJ2.cjs} +4 -4
- package/dist/chunk-WTQTF57J.cjs +240 -0
- package/dist/{chunk-WII4R5RE.js → chunk-Y7NMZAQT.js} +4 -0
- package/dist/index.cjs +360 -229
- package/dist/index.js +215 -84
- package/dist/interrupt-3NXOTY4N.cjs +12 -0
- package/dist/{interrupt-YJVZK4VC.js → interrupt-ERCX5RXR.js} +2 -2
- package/dist/{mcp-TI3IDGUJ.js → mcp-6R6KZ5U3.js} +83 -86
- package/dist/{mcp-DU7AUWUH.cjs → mcp-UJD6KF7G.cjs} +97 -100
- package/dist/types/cjs/index.d.ts +1 -1
- package/dist/types/cjs/internal/instrumentation/mcp/client-session.d.ts +24 -0
- package/dist/types/cjs/internal/instrumentation/mcp/session.d.ts +3 -1
- package/dist/types/cjs/internal/log/logging.d.ts +5 -5
- package/dist/types/cjs/internal/sdk.d.ts +2 -0
- package/dist/types/cjs/internal/semantic-conventions.d.ts +2 -0
- package/dist/types/cjs/internal/trace/exporters/span-exporter.d.ts +11 -2
- package/dist/types/cjs/internal/trace/index.d.ts +1 -1
- package/dist/types/cjs/internal/trace/session.d.ts +4 -0
- package/dist/types/esm/index.d.ts +1 -1
- package/dist/types/esm/internal/instrumentation/mcp/client-session.d.ts +24 -0
- package/dist/types/esm/internal/instrumentation/mcp/session.d.ts +3 -1
- package/dist/types/esm/internal/log/logging.d.ts +5 -5
- package/dist/types/esm/internal/sdk.d.ts +2 -0
- package/dist/types/esm/internal/semantic-conventions.d.ts +2 -0
- package/dist/types/esm/internal/trace/exporters/span-exporter.d.ts +11 -2
- package/dist/types/esm/internal/trace/index.d.ts +1 -1
- package/dist/types/esm/internal/trace/session.d.ts +4 -0
- package/package.json +13 -13
- package/dist/chunk-3QYP2SDN.cjs +0 -8
- package/dist/chunk-QRHMDRW6.js +0 -8
- 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:
|
|
@@ -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-Y7NMZAQT.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.43";
|
|
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
|
+
};
|
|
@@ -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
|
-
|
|
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}); 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
|
|
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(
|
|
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(
|
|
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(
|
|
107
|
+
span.setAttribute(_chunkFORVS4QWcjs.INTERRUPT_TOOLS, JSON.stringify(names));
|
|
108
108
|
}
|
|
109
109
|
}
|
|
110
110
|
onEnd() {
|
|
@@ -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 _chunkFORVS4QWcjs = require('./chunk-FORVS4QW.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(_chunkFORVS4QWcjs.PROPERTIES_CONTEXT_KEY);
|
|
41
|
+
if (_optionalChain([bound, 'optionalAccess', _3 => _3[_chunkFORVS4QWcjs.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[_chunkFORVS4QWcjs.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(`${_chunkFORVS4QWcjs.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(_chunkFORVS4QWcjs.PROPERTIES_CONTEXT_KEY);
|
|
71
|
+
const merged = prev ? { ...prev, ...properties } : properties;
|
|
72
|
+
return {
|
|
73
|
+
context: baseContext.setValue(_chunkFORVS4QWcjs.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.43";
|
|
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;
|
|
@@ -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,
|