@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.
Files changed (35) hide show
  1. package/README.md +25 -0
  2. package/dist/chunk-5SWAZUC5.js +240 -0
  3. package/dist/{chunk-EC3MYSRM.js → chunk-7FQQHF5U.js} +1 -1
  4. package/dist/{chunk-77UGZGMP.cjs → chunk-FORVS4QW.cjs} +5 -1
  5. package/dist/{chunk-EVRCHF74.cjs → chunk-QUV5HYJ2.cjs} +4 -4
  6. package/dist/chunk-WTQTF57J.cjs +240 -0
  7. package/dist/{chunk-WII4R5RE.js → chunk-Y7NMZAQT.js} +4 -0
  8. package/dist/index.cjs +360 -229
  9. package/dist/index.js +215 -84
  10. package/dist/interrupt-3NXOTY4N.cjs +12 -0
  11. package/dist/{interrupt-YJVZK4VC.js → interrupt-ERCX5RXR.js} +2 -2
  12. package/dist/{mcp-TI3IDGUJ.js → mcp-6R6KZ5U3.js} +83 -86
  13. package/dist/{mcp-DU7AUWUH.cjs → mcp-UJD6KF7G.cjs} +97 -100
  14. package/dist/types/cjs/index.d.ts +1 -1
  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/log/logging.d.ts +5 -5
  18. package/dist/types/cjs/internal/sdk.d.ts +2 -0
  19. package/dist/types/cjs/internal/semantic-conventions.d.ts +2 -0
  20. package/dist/types/cjs/internal/trace/exporters/span-exporter.d.ts +11 -2
  21. package/dist/types/cjs/internal/trace/index.d.ts +1 -1
  22. package/dist/types/cjs/internal/trace/session.d.ts +4 -0
  23. package/dist/types/esm/index.d.ts +1 -1
  24. package/dist/types/esm/internal/instrumentation/mcp/client-session.d.ts +24 -0
  25. package/dist/types/esm/internal/instrumentation/mcp/session.d.ts +3 -1
  26. package/dist/types/esm/internal/log/logging.d.ts +5 -5
  27. package/dist/types/esm/internal/sdk.d.ts +2 -0
  28. package/dist/types/esm/internal/semantic-conventions.d.ts +2 -0
  29. package/dist/types/esm/internal/trace/exporters/span-exporter.d.ts +11 -2
  30. package/dist/types/esm/internal/trace/index.d.ts +1 -1
  31. package/dist/types/esm/internal/trace/session.d.ts +4 -0
  32. package/package.json +13 -13
  33. package/dist/chunk-3QYP2SDN.cjs +0 -8
  34. package/dist/chunk-QRHMDRW6.js +0 -8
  35. package/dist/interrupt-DM3AWSBX.cjs +0 -12
@@ -0,0 +1,24 @@
1
+ export declare const DEFAULT_SESSION_PARAM = "brizz_mcp_session_id";
2
+ export declare const DEFAULT_SESSION_TOOL_NAME = "brizz_start_session";
3
+ export declare const INTENT_PARAM = "brizz_intent";
4
+ export interface IMCPSessionTrackingConfig {
5
+ enabled?: boolean;
6
+ intent?: boolean;
7
+ sessionParamName?: string;
8
+ sessionToolName?: string;
9
+ }
10
+ export declare function configure(config: IMCPSessionTrackingConfig | boolean | undefined): void;
11
+ export declare function isEnabled(): boolean;
12
+ export declare function sessionParam(): string;
13
+ export declare function sessionToolNameValue(): string;
14
+ export interface ITrackingArguments {
15
+ sessionId?: string;
16
+ intent?: string;
17
+ }
18
+ export declare function isSessionToolCall(request: unknown): boolean;
19
+ export declare function sessionToolResult(): {
20
+ id: string;
21
+ result: unknown;
22
+ };
23
+ export declare function patchListToolsResult(result: unknown): unknown;
24
+ export declare function popTrackingArguments(request: unknown): ITrackingArguments;
@@ -1,8 +1,10 @@
1
1
  import type { Context, Span } from '@opentelemetry/api';
2
+ export declare const INTENT_PROPERTY = "internal.intent";
2
3
  export interface ISessionAttachResult {
3
4
  context: Context;
4
5
  sessionId: string | null;
5
6
  }
7
+ export declare function generateSessionId(): string;
6
8
  export declare function resolveTransportSessionId(protocol: unknown): string | undefined;
7
9
  export declare function resolveSessionId(protocol: unknown, baseContext: Context): string | undefined;
8
- export declare function stampAndPropagateSession(span: Span, sessionId: string | null | undefined, baseContext?: Context): ISessionAttachResult;
10
+ export declare function stampAndPropagateSession(span: Span, sessionId: string | null | undefined, baseContext?: Context, intent?: string): ISessionAttachResult;
@@ -5,12 +5,12 @@ import type { IResolvedBrizzConfig } from '../config.js';
5
5
  export declare class LoggingModule {
6
6
  private static instance;
7
7
  static getInstance(): LoggingModule;
8
- private logExporter;
9
- private logProcessor;
8
+ private config;
10
9
  private loggerProvider;
11
- private initLogExporter;
12
- private initLogProcessor;
13
- private initLoggerProvider;
10
+ private readonly scopedProviders;
11
+ private createLogExporter;
12
+ private createLoggerProvider;
13
+ private activeLoggerProvider;
14
14
  setup(config: IResolvedBrizzConfig): void;
15
15
  emitEvent(name: string, attributes?: Record<string, string | number | boolean>, body?: LogBody, severityNumber?: SeverityNumber): void;
16
16
  isInitialized(): boolean;
@@ -3,6 +3,7 @@ import type { LogRecordExporter } from '@opentelemetry/sdk-logs';
3
3
  import type { MetricReader } from '@opentelemetry/sdk-metrics';
4
4
  import type { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
5
5
  import { type IInstrumentModules } from './instrumentation/index.js';
6
+ import { type IMCPSessionTrackingConfig } from './instrumentation/mcp/client-session.js';
6
7
  import type { LogLevel } from './logger.js';
7
8
  import { type IMaskingConfig } from './masking/index.js';
8
9
  export interface IBrizzInitializeOptions {
@@ -13,6 +14,7 @@ export interface IBrizzInitializeOptions {
13
14
  dsn?: string;
14
15
  headers?: Record<string, string>;
15
16
  disableBatch?: boolean;
17
+ mcpSessionTracking?: IMCPSessionTrackingConfig | boolean;
16
18
  environment?: string;
17
19
  masking?: boolean | IMaskingConfig;
18
20
  logLevel?: LogLevel | string;
@@ -21,6 +21,8 @@ export declare const ORGANIZATION_NAME = "organization.name";
21
21
  export declare const ORGANIZATION_PLAN = "organization.plan";
22
22
  export declare const ORGANIZATION_DOMAIN = "organization.domain";
23
23
  export declare const MESSAGE_ID = "message.id";
24
+ export declare const SERVICE_NAME = "service.name";
25
+ export declare const SERVICE_NAME_ATTRIBUTE = "brizz.service.name";
24
26
  export declare const SESSION_TITLE_SPAN_NAME = "brizz.session_title";
25
27
  export declare const SESSION_TITLE_GENERATION = "session.title_generation";
26
28
  export declare const SESSION_TITLE = "brizz.session.title";
@@ -1,12 +1,21 @@
1
1
  import type { ExportResult } from '@opentelemetry/core';
2
2
  import type { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
3
3
  import type { IResolvedBrizzConfig } from '../../config.js';
4
+ export type SpanExporterFactory = (serviceName: string) => SpanExporter;
4
5
  export declare class BrizzSpanExporter implements SpanExporter {
5
6
  private readonly _delegate;
6
- private readonly _brizzResource;
7
+ private readonly _delegateFactory?;
8
+ private readonly _defaultServiceName;
9
+ private readonly _resourceAttrs;
10
+ private readonly _resources;
11
+ private readonly _delegates;
7
12
  private readonly _beforeSendSpan?;
8
- constructor(delegate: SpanExporter, config: IResolvedBrizzConfig);
13
+ constructor(delegate: SpanExporter, config: IResolvedBrizzConfig, factory?: SpanExporterFactory);
14
+ private _serviceNameOf;
15
+ private _resourceFor;
16
+ private _delegateFor;
9
17
  export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
18
+ private _exportGroups;
10
19
  shutdown(): Promise<void>;
11
20
  forceFlush(): Promise<void>;
12
21
  }
@@ -1,4 +1,4 @@
1
1
  export { TracingModule, getSpanExporter, getSpanProcessor } from './tracing.js';
2
2
  export { BrizzBatchSpanProcessor, BrizzSimpleSpanProcessor } from './processors/span-processor.js';
3
- export { withSessionId, callWithSessionId, withProperties, callWithProperties, withMute, callWithMute, setCurrentSpanCustomProperties, setUser, setOrganization, setMessageId, setSessionId, withUser, callWithUser, withOrganization, callWithOrganization, withMessageId, callWithMessageId, Session, SessionTitle, startSession, startSessionTitle, getActiveSession, addExternalLink, recordFeedback, recordMetric, } from './session.js';
3
+ export { withSessionId, callWithSessionId, withProperties, callWithProperties, withMute, callWithMute, setCurrentSpanCustomProperties, setUser, setOrganization, setMessageId, setSessionId, setServiceName, withServiceName, callWithServiceName, withUser, callWithUser, withOrganization, callWithOrganization, withMessageId, callWithMessageId, Session, SessionTitle, startSession, startSessionTitle, getActiveSession, addExternalLink, recordFeedback, recordMetric, } from './session.js';
4
4
  export type { IMuteOptions } from './session.js';
@@ -23,6 +23,10 @@ export declare function setOrganization(org: {
23
23
  }): void;
24
24
  export declare function setMessageId(id: string): void;
25
25
  export declare function setSessionId(id: string): void;
26
+ export declare function setServiceName(name: string): void;
27
+ export declare function callWithServiceName<A extends unknown[], F extends (...args: A) => ReturnType<F>>(name: string, fn: F, thisArg?: ThisParameterType<F>, ...args: A): ReturnType<F>;
28
+ export declare function withServiceName<F extends (this: any, ...args: any[]) => any>(name: string, fn: F, thisArg?: ThisParameterType<F>): F;
29
+ export declare function resolveServiceNameFromContext(): string | undefined;
26
30
  export declare function callWithUser<A extends unknown[], F extends (...args: A) => ReturnType<F>>(user: {
27
31
  id: string;
28
32
  email?: string;
@@ -2,7 +2,7 @@ import './internal/instrumentation/auto-init.js';
2
2
  export { Brizz, type IBrizzInitializeOptions } from './internal/sdk.js';
3
3
  export { type IInstrumentModules, type IMCPManualModules, } from './internal/instrumentation/index.js';
4
4
  export { emitEvent, emitEventWithSessionId } from './internal/log/index.js';
5
- export { getSpanExporter, getSpanProcessor, withSessionId, callWithSessionId, withProperties, callWithProperties, withMute, callWithMute, setCurrentSpanCustomProperties, setUser, setOrganization, setMessageId, setSessionId, withUser, callWithUser, withOrganization, callWithOrganization, withMessageId, callWithMessageId, Session, SessionTitle, startSession, startSessionTitle, getActiveSession, addExternalLink, recordFeedback, recordMetric, } from './internal/trace/index.js';
5
+ export { getSpanExporter, getSpanProcessor, withSessionId, callWithSessionId, withProperties, callWithProperties, withMute, callWithMute, setCurrentSpanCustomProperties, setUser, setOrganization, setMessageId, setSessionId, setServiceName, withServiceName, callWithServiceName, withUser, callWithUser, withOrganization, callWithOrganization, withMessageId, callWithMessageId, Session, SessionTitle, startSession, startSessionTitle, getActiveSession, addExternalLink, recordFeedback, recordMetric, } from './internal/trace/index.js';
6
6
  export type { IMuteOptions } from './internal/trace/index.js';
7
7
  export { getMetricsExporter, getMetricsReader } from './internal/metric/index.js';
8
8
  export type { IMaskingConfig, ISpanMaskingConfig, ILogMaskingConfig, IEventMaskingConfig, IEventMaskingRule, MaskingMode, IAttributesMaskingRule, } from './internal/masking/index.js';
@@ -0,0 +1,24 @@
1
+ export declare const DEFAULT_SESSION_PARAM = "brizz_mcp_session_id";
2
+ export declare const DEFAULT_SESSION_TOOL_NAME = "brizz_start_session";
3
+ export declare const INTENT_PARAM = "brizz_intent";
4
+ export interface IMCPSessionTrackingConfig {
5
+ enabled?: boolean;
6
+ intent?: boolean;
7
+ sessionParamName?: string;
8
+ sessionToolName?: string;
9
+ }
10
+ export declare function configure(config: IMCPSessionTrackingConfig | boolean | undefined): void;
11
+ export declare function isEnabled(): boolean;
12
+ export declare function sessionParam(): string;
13
+ export declare function sessionToolNameValue(): string;
14
+ export interface ITrackingArguments {
15
+ sessionId?: string;
16
+ intent?: string;
17
+ }
18
+ export declare function isSessionToolCall(request: unknown): boolean;
19
+ export declare function sessionToolResult(): {
20
+ id: string;
21
+ result: unknown;
22
+ };
23
+ export declare function patchListToolsResult(result: unknown): unknown;
24
+ export declare function popTrackingArguments(request: unknown): ITrackingArguments;
@@ -1,8 +1,10 @@
1
1
  import type { Context, Span } from '@opentelemetry/api';
2
+ export declare const INTENT_PROPERTY = "internal.intent";
2
3
  export interface ISessionAttachResult {
3
4
  context: Context;
4
5
  sessionId: string | null;
5
6
  }
7
+ export declare function generateSessionId(): string;
6
8
  export declare function resolveTransportSessionId(protocol: unknown): string | undefined;
7
9
  export declare function resolveSessionId(protocol: unknown, baseContext: Context): string | undefined;
8
- export declare function stampAndPropagateSession(span: Span, sessionId: string | null | undefined, baseContext?: Context): ISessionAttachResult;
10
+ export declare function stampAndPropagateSession(span: Span, sessionId: string | null | undefined, baseContext?: Context, intent?: string): ISessionAttachResult;
@@ -5,12 +5,12 @@ import type { IResolvedBrizzConfig } from '../config.js';
5
5
  export declare class LoggingModule {
6
6
  private static instance;
7
7
  static getInstance(): LoggingModule;
8
- private logExporter;
9
- private logProcessor;
8
+ private config;
10
9
  private loggerProvider;
11
- private initLogExporter;
12
- private initLogProcessor;
13
- private initLoggerProvider;
10
+ private readonly scopedProviders;
11
+ private createLogExporter;
12
+ private createLoggerProvider;
13
+ private activeLoggerProvider;
14
14
  setup(config: IResolvedBrizzConfig): void;
15
15
  emitEvent(name: string, attributes?: Record<string, string | number | boolean>, body?: LogBody, severityNumber?: SeverityNumber): void;
16
16
  isInitialized(): boolean;
@@ -3,6 +3,7 @@ import type { LogRecordExporter } from '@opentelemetry/sdk-logs';
3
3
  import type { MetricReader } from '@opentelemetry/sdk-metrics';
4
4
  import type { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
5
5
  import { type IInstrumentModules } from './instrumentation/index.js';
6
+ import { type IMCPSessionTrackingConfig } from './instrumentation/mcp/client-session.js';
6
7
  import type { LogLevel } from './logger.js';
7
8
  import { type IMaskingConfig } from './masking/index.js';
8
9
  export interface IBrizzInitializeOptions {
@@ -13,6 +14,7 @@ export interface IBrizzInitializeOptions {
13
14
  dsn?: string;
14
15
  headers?: Record<string, string>;
15
16
  disableBatch?: boolean;
17
+ mcpSessionTracking?: IMCPSessionTrackingConfig | boolean;
16
18
  environment?: string;
17
19
  masking?: boolean | IMaskingConfig;
18
20
  logLevel?: LogLevel | string;
@@ -21,6 +21,8 @@ export declare const ORGANIZATION_NAME = "organization.name";
21
21
  export declare const ORGANIZATION_PLAN = "organization.plan";
22
22
  export declare const ORGANIZATION_DOMAIN = "organization.domain";
23
23
  export declare const MESSAGE_ID = "message.id";
24
+ export declare const SERVICE_NAME = "service.name";
25
+ export declare const SERVICE_NAME_ATTRIBUTE = "brizz.service.name";
24
26
  export declare const SESSION_TITLE_SPAN_NAME = "brizz.session_title";
25
27
  export declare const SESSION_TITLE_GENERATION = "session.title_generation";
26
28
  export declare const SESSION_TITLE = "brizz.session.title";
@@ -1,12 +1,21 @@
1
1
  import type { ExportResult } from '@opentelemetry/core';
2
2
  import type { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
3
3
  import type { IResolvedBrizzConfig } from '../../config.js';
4
+ export type SpanExporterFactory = (serviceName: string) => SpanExporter;
4
5
  export declare class BrizzSpanExporter implements SpanExporter {
5
6
  private readonly _delegate;
6
- private readonly _brizzResource;
7
+ private readonly _delegateFactory?;
8
+ private readonly _defaultServiceName;
9
+ private readonly _resourceAttrs;
10
+ private readonly _resources;
11
+ private readonly _delegates;
7
12
  private readonly _beforeSendSpan?;
8
- constructor(delegate: SpanExporter, config: IResolvedBrizzConfig);
13
+ constructor(delegate: SpanExporter, config: IResolvedBrizzConfig, factory?: SpanExporterFactory);
14
+ private _serviceNameOf;
15
+ private _resourceFor;
16
+ private _delegateFor;
9
17
  export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
18
+ private _exportGroups;
10
19
  shutdown(): Promise<void>;
11
20
  forceFlush(): Promise<void>;
12
21
  }
@@ -1,4 +1,4 @@
1
1
  export { TracingModule, getSpanExporter, getSpanProcessor } from './tracing.js';
2
2
  export { BrizzBatchSpanProcessor, BrizzSimpleSpanProcessor } from './processors/span-processor.js';
3
- export { withSessionId, callWithSessionId, withProperties, callWithProperties, withMute, callWithMute, setCurrentSpanCustomProperties, setUser, setOrganization, setMessageId, setSessionId, withUser, callWithUser, withOrganization, callWithOrganization, withMessageId, callWithMessageId, Session, SessionTitle, startSession, startSessionTitle, getActiveSession, addExternalLink, recordFeedback, recordMetric, } from './session.js';
3
+ export { withSessionId, callWithSessionId, withProperties, callWithProperties, withMute, callWithMute, setCurrentSpanCustomProperties, setUser, setOrganization, setMessageId, setSessionId, setServiceName, withServiceName, callWithServiceName, withUser, callWithUser, withOrganization, callWithOrganization, withMessageId, callWithMessageId, Session, SessionTitle, startSession, startSessionTitle, getActiveSession, addExternalLink, recordFeedback, recordMetric, } from './session.js';
4
4
  export type { IMuteOptions } from './session.js';
@@ -23,6 +23,10 @@ export declare function setOrganization(org: {
23
23
  }): void;
24
24
  export declare function setMessageId(id: string): void;
25
25
  export declare function setSessionId(id: string): void;
26
+ export declare function setServiceName(name: string): void;
27
+ export declare function callWithServiceName<A extends unknown[], F extends (...args: A) => ReturnType<F>>(name: string, fn: F, thisArg?: ThisParameterType<F>, ...args: A): ReturnType<F>;
28
+ export declare function withServiceName<F extends (this: any, ...args: any[]) => any>(name: string, fn: F, thisArg?: ThisParameterType<F>): F;
29
+ export declare function resolveServiceNameFromContext(): string | undefined;
26
30
  export declare function callWithUser<A extends unknown[], F extends (...args: A) => ReturnType<F>>(user: {
27
31
  id: string;
28
32
  email?: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@brizz/sdk",
3
- "version": "0.1.41",
3
+ "version": "0.1.43",
4
4
  "type": "module",
5
5
  "description": "OpenTelemetry-based observability SDK for AI applications",
6
6
  "keywords": [
@@ -101,28 +101,28 @@
101
101
  "registry": "https://registry.npmjs.org/"
102
102
  },
103
103
  "devDependencies": {
104
- "@ai-sdk/anthropic": "^4.0.27",
105
- "@ai-sdk/openai": "^4.0.27",
106
- "@ai-sdk/otel": "^1.0.48",
104
+ "@ai-sdk/anthropic": "^4.0.39",
105
+ "@ai-sdk/openai": "^4.0.42",
106
+ "@ai-sdk/otel": "^1.0.66",
107
107
  "@arethetypeswrong/cli": "^0.18.5",
108
- "@arizeai/openinference-instrumentation-mcp": "^0.2.21",
108
+ "@arizeai/openinference-instrumentation-mcp": "^0.2.24",
109
109
  "@babel/core": "^8.0.1",
110
110
  "@babel/preset-env": "^8.0.2",
111
111
  "@babel/preset-typescript": "^8.0.1",
112
- "@changesets/changelog-github": "^0.7.0",
113
- "@changesets/cli": "^2.31.1",
114
- "@google/genai": "^2.15.0",
112
+ "@changesets/changelog-github": "^1.0.0",
113
+ "@changesets/cli": "^3.0.0",
114
+ "@google/genai": "^2.17.1",
115
115
  "@modelcontextprotocol/sdk": "^1.30.0",
116
116
  "@traceloop/instrumentation-google-generativeai": "^0.27.0",
117
117
  "@traceloop/instrumentation-vertexai": "^0.27.0",
118
118
  "@types/jest": "^30.0.0",
119
- "@types/node": "^26.1.2",
120
- "ai": "^7.0.48",
119
+ "@types/node": "^26.2.0",
120
+ "ai": "^7.0.66",
121
121
  "babel-jest": "^30.4.1",
122
122
  "jest": "^30.4.2",
123
123
  "jest-environment-jsdom": "^30.4.1",
124
- "openai": "^7.3.0",
125
- "oxlint": "^1.76.0",
124
+ "openai": "^7.4.0",
125
+ "oxlint": "^1.78.0",
126
126
  "prettier": "^3.9.6",
127
127
  "tsup": "^8.5.1",
128
128
  "typescript": "^7.0.2",
@@ -166,7 +166,7 @@
166
166
  }
167
167
  },
168
168
  "dependencies": {
169
- "@arizeai/openinference-instrumentation-langchain": "^4.0.15",
169
+ "@arizeai/openinference-instrumentation-langchain": "^4.0.18",
170
170
  "@arizeai/openinference-instrumentation-openai": "^2.3.1",
171
171
  "@opentelemetry/api": "^1.9.0",
172
172
  "@opentelemetry/api-logs": "^0.221.0",
@@ -1,8 +0,0 @@
1
- "use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/internal/version.ts
2
- function getSDKVersion() {
3
- return "0.1.41";
4
- }
5
-
6
-
7
-
8
- exports.getSDKVersion = getSDKVersion;
@@ -1,8 +0,0 @@
1
- // src/internal/version.ts
2
- function getSDKVersion() {
3
- return "0.1.41";
4
- }
5
-
6
- export {
7
- getSDKVersion
8
- };
@@ -1,12 +0,0 @@
1
- "use strict";Object.defineProperty(exports, "__esModule", {value: true});
2
-
3
-
4
-
5
- var _chunkEVRCHF74cjs = require('./chunk-EVRCHF74.cjs');
6
- require('./chunk-77UGZGMP.cjs');
7
- require('./chunk-OBGZSXTJ.cjs');
8
-
9
-
10
-
11
-
12
- exports.InterruptPropagator = _chunkEVRCHF74cjs.InterruptPropagator; exports._resetInterruptState = _chunkEVRCHF74cjs._resetInterruptState; exports.createInterruptIntegration = _chunkEVRCHF74cjs.createInterruptIntegration;