@brizz/sdk 0.1.43 → 0.1.45
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-Y7NMZAQT.js → chunk-AOT5NJDV.js} +6 -0
- package/dist/{chunk-7FQQHF5U.js → chunk-APOYOP7D.js} +1 -1
- package/dist/{chunk-5SWAZUC5.js → chunk-BAQTZKGI.js} +2 -2
- package/dist/{chunk-WTQTF57J.cjs → chunk-CBEDIRVK.cjs} +8 -8
- package/dist/index.cjs +395 -171
- package/dist/index.js +252 -28
- package/dist/{interrupt-ERCX5RXR.js → interrupt-A6O7N72X.js} +2 -2
- package/dist/interrupt-IKOUBQGN.cjs +12 -0
- package/dist/{mcp-UJD6KF7G.cjs → mcp-CCFYA5CI.cjs} +12 -12
- package/dist/{mcp-6R6KZ5U3.js → mcp-FTYCIWL4.js} +2 -2
- package/dist/types/cjs/index.d.ts +2 -2
- package/dist/types/cjs/internal/instrumentation/langchain.d.ts +4 -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/langchain.d.ts +4 -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 +33 -31
- 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;
|
|
@@ -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,
|
|
@@ -5,7 +5,7 @@ import {
|
|
|
5
5
|
BRIZZ,
|
|
6
6
|
PROPERTIES_CONTEXT_KEY,
|
|
7
7
|
SESSION_ID
|
|
8
|
-
} from "./chunk-
|
|
8
|
+
} from "./chunk-AOT5NJDV.js";
|
|
9
9
|
|
|
10
10
|
// src/internal/instrumentation/mcp/session.ts
|
|
11
11
|
import { context } from "@opentelemetry/api";
|
|
@@ -223,7 +223,7 @@ function popTrackingArguments(request) {
|
|
|
223
223
|
|
|
224
224
|
// src/internal/version.ts
|
|
225
225
|
function getSDKVersion() {
|
|
226
|
-
return "0.1.
|
|
226
|
+
return "0.1.45";
|
|
227
227
|
}
|
|
228
228
|
|
|
229
229
|
export {
|
|
@@ -5,7 +5,7 @@ var _chunkWC573FCIcjs = require('./chunk-WC573FCI.cjs');
|
|
|
5
5
|
|
|
6
6
|
|
|
7
7
|
|
|
8
|
-
var
|
|
8
|
+
var _chunk5WBPX342cjs = require('./chunk-5WBPX342.cjs');
|
|
9
9
|
|
|
10
10
|
// src/internal/instrumentation/mcp/session.ts
|
|
11
11
|
var _api = require('@opentelemetry/api');
|
|
@@ -37,8 +37,8 @@ function resolveSessionId(protocol, baseContext) {
|
|
|
37
37
|
return fromTransport;
|
|
38
38
|
}
|
|
39
39
|
try {
|
|
40
|
-
const bound = baseContext.getValue(
|
|
41
|
-
if (_optionalChain([bound, 'optionalAccess', _3 => _3[
|
|
40
|
+
const bound = baseContext.getValue(_chunk5WBPX342cjs.PROPERTIES_CONTEXT_KEY);
|
|
41
|
+
if (_optionalChain([bound, 'optionalAccess', _3 => _3[_chunk5WBPX342cjs.SESSION_ID]])) {
|
|
42
42
|
return void 0;
|
|
43
43
|
}
|
|
44
44
|
} catch (e) {
|
|
@@ -52,7 +52,7 @@ function stampAndPropagateSession(span, sessionId, baseContext = _api.context.ac
|
|
|
52
52
|
}
|
|
53
53
|
const properties = {};
|
|
54
54
|
if (sessionId) {
|
|
55
|
-
properties[
|
|
55
|
+
properties[_chunk5WBPX342cjs.SESSION_ID] = sessionId;
|
|
56
56
|
}
|
|
57
57
|
if (intent) {
|
|
58
58
|
properties[INTENT_PROPERTY] = intent;
|
|
@@ -60,17 +60,17 @@ function stampAndPropagateSession(span, sessionId, baseContext = _api.context.ac
|
|
|
60
60
|
if (span.isRecording()) {
|
|
61
61
|
for (const [key, value] of Object.entries(properties)) {
|
|
62
62
|
try {
|
|
63
|
-
span.setAttribute(`${
|
|
63
|
+
span.setAttribute(`${_chunk5WBPX342cjs.BRIZZ}.${key}`, value);
|
|
64
64
|
} catch (error) {
|
|
65
65
|
_chunkWC573FCIcjs.logger.warn(`Brizz MCP: failed to stamp ${key} on span: ${String(error)}`);
|
|
66
66
|
}
|
|
67
67
|
}
|
|
68
68
|
}
|
|
69
69
|
try {
|
|
70
|
-
const prev = baseContext.getValue(
|
|
70
|
+
const prev = baseContext.getValue(_chunk5WBPX342cjs.PROPERTIES_CONTEXT_KEY);
|
|
71
71
|
const merged = prev ? { ...prev, ...properties } : properties;
|
|
72
72
|
return {
|
|
73
|
-
context: baseContext.setValue(
|
|
73
|
+
context: baseContext.setValue(_chunk5WBPX342cjs.PROPERTIES_CONTEXT_KEY, merged),
|
|
74
74
|
sessionId: _nullishCoalesce(sessionId, () => ( null))
|
|
75
75
|
};
|
|
76
76
|
} catch (error) {
|
|
@@ -223,7 +223,7 @@ function popTrackingArguments(request) {
|
|
|
223
223
|
|
|
224
224
|
// src/internal/version.ts
|
|
225
225
|
function getSDKVersion() {
|
|
226
|
-
return "0.1.
|
|
226
|
+
return "0.1.45";
|
|
227
227
|
}
|
|
228
228
|
|
|
229
229
|
|