@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.
- package/README.md +44 -0
- package/dist/{chunk-QUV5HYJ2.cjs → chunk-3IGBYXLR.cjs} +4 -4
- package/dist/{chunk-FORVS4QW.cjs → chunk-5WBPX342.cjs} +7 -1
- package/dist/chunk-A3HH5OUL.cjs +240 -0
- package/dist/chunk-AELIATPI.js +240 -0
- package/dist/{chunk-Y7NMZAQT.js → chunk-AOT5NJDV.js} +6 -0
- package/dist/{chunk-7FQQHF5U.js → chunk-APOYOP7D.js} +1 -1
- package/dist/index.cjs +270 -128
- package/dist/index.js +154 -12
- package/dist/{interrupt-ERCX5RXR.js → interrupt-A6O7N72X.js} +2 -2
- package/dist/interrupt-IKOUBQGN.cjs +12 -0
- package/dist/{mcp-GVGTOWHP.cjs → mcp-5FSUXYHM.cjs} +97 -100
- package/dist/{mcp-5BFXKN63.js → mcp-7EJXVCPI.js} +83 -86
- package/dist/types/cjs/index.d.ts +2 -2
- 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/sdk.d.ts +2 -0
- package/dist/types/cjs/internal/semantic-conventions.d.ts +3 -0
- package/dist/types/cjs/internal/trace/agent.d.ts +18 -0
- package/dist/types/cjs/internal/trace/index.d.ts +2 -0
- package/dist/types/cjs/internal/trace/session.d.ts +2 -1
- package/dist/types/esm/index.d.ts +2 -2
- 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/sdk.d.ts +2 -0
- package/dist/types/esm/internal/semantic-conventions.d.ts +3 -0
- package/dist/types/esm/internal/trace/agent.d.ts +18 -0
- package/dist/types/esm/internal/trace/index.d.ts +2 -0
- package/dist/types/esm/internal/trace/session.d.ts +2 -1
- package/package.json +10 -10
- package/dist/chunk-K3NPYISB.cjs +0 -8
- package/dist/chunk-KVOGOKOB.js +0 -8
- 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
|
|
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(
|
|
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(
|
|
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(
|
|
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
|
-
|
|
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,
|