@withgateway/sdk 0.1.4 → 0.1.5

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 (41) hide show
  1. package/dist/index-DnowA8MG.d.mts +447 -0
  2. package/dist/index-DnowA8MG.d.ts +447 -0
  3. package/dist/index.d.mts +6 -1
  4. package/dist/index.d.ts +6 -1
  5. package/dist/index.js +1544 -23
  6. package/dist/index.js.map +1 -1
  7. package/dist/index.mjs +1504 -17
  8. package/dist/index.mjs.map +1 -1
  9. package/dist/personas/index.d.mts +102 -0
  10. package/dist/personas/index.d.ts +102 -0
  11. package/dist/personas/index.js +205 -0
  12. package/dist/personas/index.js.map +1 -0
  13. package/dist/personas/index.mjs +180 -0
  14. package/dist/personas/index.mjs.map +1 -0
  15. package/dist/replay/index.d.mts +351 -0
  16. package/dist/replay/index.d.ts +351 -0
  17. package/dist/replay/index.js +1094 -0
  18. package/dist/replay/index.js.map +1 -0
  19. package/dist/replay/index.mjs +1057 -0
  20. package/dist/replay/index.mjs.map +1 -0
  21. package/dist/sessions/index.d.mts +143 -0
  22. package/dist/sessions/index.d.ts +143 -0
  23. package/dist/sessions/index.js +320 -0
  24. package/dist/sessions/index.js.map +1 -0
  25. package/dist/sessions/index.mjs +288 -0
  26. package/dist/sessions/index.mjs.map +1 -0
  27. package/dist/tracing/index.d.mts +3 -1
  28. package/dist/tracing/index.d.ts +3 -1
  29. package/dist/tracing/index.js +270 -21
  30. package/dist/tracing/index.js.map +1 -1
  31. package/dist/tracing/index.mjs +259 -16
  32. package/dist/tracing/index.mjs.map +1 -1
  33. package/dist/users/index.d.mts +81 -0
  34. package/dist/users/index.d.ts +81 -0
  35. package/dist/users/index.js +168 -0
  36. package/dist/users/index.js.map +1 -0
  37. package/dist/users/index.mjs +144 -0
  38. package/dist/users/index.mjs.map +1 -0
  39. package/package.json +21 -1
  40. package/dist/index-yJgb8wh6.d.mts +0 -273
  41. package/dist/index-yJgb8wh6.d.ts +0 -273
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/sessions/index.ts"],"sourcesContent":["/**\n * Load Gateway sessions for replay and test-fixture generation.\n *\n * The premier workflow: pull a real production session from the platform and\n * turn it into a regression test in your repo.\n *\n * ```typescript\n * import { loadSession } from \"@withgateway/sdk/sessions\";\n *\n * const session = await loadSession(\"session-id\"); // env-configured Gateway\n * for (const turn of session.turns()) { // (input, output) per trace\n * const result = await myAgent(turn.input);\n * assert.deepEqual(result, turn.output); // or fuzzier assertions\n * }\n *\n * session.toFixture(\"tests/fixtures/checkout_regression.json\");\n * ```\n *\n * Auth/config mirror the tracing exporter: GATEWAY_HOST, GATEWAY_PUBLIC_KEY,\n * GATEWAY_SECRET_KEY (or pass host/publicKey/secretKey explicitly). Data comes\n * from `GET /api/public/sessions/{id}?includeIO=true` — one call, full\n * untruncated input/output for every trace and observation.\n *\n * Mirrors the Python SDK's `gatewaysdk.sessions` module.\n */\n\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nexport const ENV_GATEWAY_HOST = \"GATEWAY_HOST\";\nexport const ENV_GATEWAY_PUBLIC_KEY = \"GATEWAY_PUBLIC_KEY\";\nexport const ENV_GATEWAY_SECRET_KEY = \"GATEWAY_SECRET_KEY\";\n\nexport const DEFAULT_TIMEOUT_SECONDS = 30;\n\n/** Raised when a session cannot be loaded from Gateway. */\nexport class SessionLoadError extends Error {\n constructor(message: string, options?: { cause?: unknown }) {\n super(message);\n this.name = \"SessionLoadError\";\n this.cause = options?.cause;\n }\n}\n\n/** One observation (LLM generation, tool call, span) with full IO. */\nexport type SessionObservation = {\n id: string;\n type: string | null;\n name: string | null;\n level: string | null;\n statusMessage: string | null;\n model: string | null;\n input: unknown;\n output: unknown;\n metadata: unknown;\n parentObservationId: string | null;\n startTime: string | null;\n endTime: string | null;\n};\n\nexport function sessionObservationFromApi(\n raw: Record<string, unknown>,\n): SessionObservation {\n return {\n id: String(raw.id ?? \"\"),\n type: asStringOrNull(raw.type),\n name: asStringOrNull(raw.name),\n level: asStringOrNull(raw.level),\n statusMessage: asStringOrNull(raw.statusMessage),\n model: asStringOrNull(raw.model),\n input: raw.input,\n output: raw.output,\n metadata: raw.metadata ?? null,\n parentObservationId: asStringOrNull(raw.parentObservationId),\n startTime: raw.startTime ? String(raw.startTime) : null,\n endTime: raw.endTime ? String(raw.endTime) : null,\n };\n}\n\ntype SessionTraceFields = {\n id: string;\n name: string | null;\n timestamp: string | null;\n input: unknown;\n output: unknown;\n metadata?: unknown;\n tags?: string[];\n observations?: SessionObservation[];\n};\n\n/** One trace (agent turn) in the session, with full IO + observations. */\nexport class SessionTrace {\n readonly id: string;\n readonly name: string | null;\n readonly timestamp: string | null;\n readonly input: unknown;\n readonly output: unknown;\n readonly metadata: unknown;\n readonly tags: string[];\n readonly observations: SessionObservation[];\n\n constructor(fields: SessionTraceFields) {\n this.id = fields.id;\n this.name = fields.name;\n this.timestamp = fields.timestamp;\n this.input = fields.input;\n this.output = fields.output;\n this.metadata = fields.metadata ?? null;\n this.tags = fields.tags ?? [];\n this.observations = fields.observations ?? [];\n }\n\n get toolCalls(): SessionObservation[] {\n return this.observations.filter(\n (o) => (o.type ?? \"\").toUpperCase() === \"TOOL\",\n );\n }\n\n get generations(): SessionObservation[] {\n return this.observations.filter(\n (o) => (o.type ?? \"\").toUpperCase() === \"GENERATION\",\n );\n }\n\n /**\n * The user message that started this turn.\n *\n * Handles the common recorded shapes: a plain string input, an OpenAI\n * message list (last role=user entry wins — earlier ones are carried\n * history), or an object with a content/input field.\n */\n userMessage(): string | null {\n const value = this.input;\n if (typeof value === \"string\") {\n return value;\n }\n if (Array.isArray(value)) {\n for (let i = value.length - 1; i >= 0; i--) {\n const entry = value[i];\n if (isPlainObject(entry) && entry.role === \"user\") {\n const content = entry.content;\n if (typeof content === \"string\") {\n return content;\n }\n if (Array.isArray(content)) {\n // content-part lists\n const parts = content\n .filter(isPlainObject)\n .map((part) => (typeof part.text === \"string\" ? part.text : \"\"));\n return parts.join(\"\") || null;\n }\n }\n }\n return null;\n }\n if (isPlainObject(value)) {\n for (const key of [\"content\", \"input\", \"text\", \"message\"]) {\n if (typeof value[key] === \"string\") {\n return value[key] as string;\n }\n }\n }\n return null;\n }\n\n static fromApi(raw: Record<string, unknown>): SessionTrace {\n return new SessionTrace({\n id: String(raw.id ?? \"\"),\n name: asStringOrNull(raw.name),\n timestamp: raw.timestamp ? String(raw.timestamp) : null,\n input: raw.input,\n output: raw.output,\n metadata: raw.metadata ?? null,\n tags: Array.isArray(raw.tags) ? raw.tags.map(String) : [],\n observations: (Array.isArray(raw.observations) ? raw.observations : [])\n .filter(isPlainObject)\n .map(sessionObservationFromApi),\n });\n }\n}\n\ntype SessionRecordingFields = {\n sessionId: string;\n projectId: string | null;\n environment: string | null;\n traces?: SessionTrace[];\n};\n\ntype SelectFilter = {\n type?: string;\n name?: string;\n level?: string;\n};\n\n/** A fully-loaded session: every trace, every observation, full IO. */\nexport class SessionRecording {\n readonly sessionId: string;\n readonly projectId: string | null;\n readonly environment: string | null;\n readonly traces: SessionTrace[];\n\n constructor(fields: SessionRecordingFields) {\n this.sessionId = fields.sessionId;\n this.projectId = fields.projectId;\n this.environment = fields.environment;\n this.traces = fields.traces ?? [];\n }\n\n /** Traces in chronological order — one per agent turn. */\n turns(): SessionTrace[] {\n return [...this.traces].sort((a, b) => {\n const left = a.timestamp ?? \"\";\n const right = b.timestamp ?? \"\";\n return left < right ? -1 : left > right ? 1 : 0;\n });\n }\n\n /** The nth chronological turn (negative indices allowed). */\n turn(index: number): SessionTrace {\n const ordered = this.turns();\n const found = ordered.at(index);\n if (!found) {\n throw new RangeError(\n `Turn index ${index} out of range (session has ${ordered.length} turns)`,\n );\n }\n return found;\n }\n\n /**\n * The user message of each turn, in order — feed these back to an agent\n * to re-drive the recorded conversation.\n */\n userMessages(): Array<string | null> {\n return this.turns().map((trace) => trace.userMessage());\n }\n\n /** Output of the last chronological turn (null when empty). */\n finalOutput(): unknown {\n const ordered = this.turns();\n return ordered.length > 0 ? ordered[ordered.length - 1].output : null;\n }\n\n /** Every TOOL observation across the session, chronological. */\n toolCalls(): SessionObservation[] {\n return this.select({ type: \"TOOL\" });\n }\n\n /** Every GENERATION observation across the session, chronological. */\n generations(): SessionObservation[] {\n return this.select({ type: \"GENERATION\" });\n }\n\n /** Filter observations across all turns (chronological order). */\n select(filter: SelectFilter = {}): SessionObservation[] {\n const selected: SessionObservation[] = [];\n for (const trace of this.turns()) {\n for (const observation of trace.observations) {\n if (\n filter.type &&\n (observation.type ?? \"\").toUpperCase() !== filter.type.toUpperCase()\n ) {\n continue;\n }\n if (filter.name && observation.name !== filter.name) {\n continue;\n }\n if (\n filter.level &&\n (observation.level ?? \"\").toUpperCase() !== filter.level.toUpperCase()\n ) {\n continue;\n }\n selected.push(observation);\n }\n }\n return selected;\n }\n\n toJSON(): Record<string, unknown> {\n return {\n sessionId: this.sessionId,\n projectId: this.projectId,\n environment: this.environment,\n traces: this.turns().map((trace) => ({\n id: trace.id,\n name: trace.name,\n timestamp: trace.timestamp,\n input: trace.input,\n output: trace.output,\n metadata: trace.metadata,\n tags: trace.tags,\n observations: trace.observations.map((o) => ({ ...o })),\n })),\n };\n }\n\n /** Dump the full session as a JSON fixture (for regression tests). */\n toFixture(path: string): string {\n mkdirSync(dirname(path), { recursive: true });\n writeFileSync(path, JSON.stringify(this.toJSON(), null, 2), \"utf-8\");\n return path;\n }\n\n static fromApi(raw: Record<string, unknown>): SessionRecording {\n return new SessionRecording({\n sessionId: String(raw.id ?? \"\"),\n projectId: asStringOrNull(raw.projectId),\n environment: asStringOrNull(raw.environment),\n traces: (Array.isArray(raw.traces) ? raw.traces : [])\n .filter(isPlainObject)\n .map(SessionTrace.fromApi),\n });\n }\n}\n\nexport type LoadSessionOptions = {\n host?: string;\n publicKey?: string;\n secretKey?: string;\n timeoutSeconds?: number;\n};\n\n/**\n * Load a full session (all traces + observations, untruncated IO).\n *\n * Credentials default to the same environment variables the tracing\n * exporter uses: GATEWAY_HOST, GATEWAY_PUBLIC_KEY, GATEWAY_SECRET_KEY.\n */\nexport async function loadSession(\n sessionId: string,\n options: LoadSessionOptions = {},\n): Promise<SessionRecording> {\n const host = (options.host ?? process.env[ENV_GATEWAY_HOST] ?? \"\").replace(\n /\\/+$/,\n \"\",\n );\n const publicKey =\n options.publicKey ?? process.env[ENV_GATEWAY_PUBLIC_KEY] ?? \"\";\n const secretKey =\n options.secretKey ?? process.env[ENV_GATEWAY_SECRET_KEY] ?? \"\";\n const timeoutSeconds = options.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;\n if (!host || !publicKey || !secretKey) {\n throw new SessionLoadError(\n \"Gateway is not configured — set GATEWAY_HOST, GATEWAY_PUBLIC_KEY \" +\n \"and GATEWAY_SECRET_KEY (or pass host/publicKey/secretKey).\",\n );\n }\n\n const url = `${host}/api/public/sessions/${encodeURIComponent(sessionId)}?includeIO=true`;\n let response: Response;\n try {\n response = await fetch(url, {\n method: \"GET\",\n headers: { Authorization: basicAuthHeader(publicKey, secretKey) },\n signal: AbortSignal.timeout(timeoutSeconds * 1000),\n });\n } catch (error) {\n throw new SessionLoadError(\n `Failed to load session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`,\n { cause: error },\n );\n }\n if (response.status === 404) {\n throw new SessionLoadError(`Session not found: ${sessionId}`);\n }\n const text = await response.text();\n if (!response.ok) {\n throw new SessionLoadError(\n `Failed to load session ${sessionId}: HTTP ${response.status} — ${text.slice(0, 300)}`,\n );\n }\n let payload: unknown;\n try {\n payload = JSON.parse(text);\n } catch (error) {\n throw new SessionLoadError(\n `Failed to load session ${sessionId}: response is not valid JSON`,\n { cause: error },\n );\n }\n return SessionRecording.fromApi(\n isPlainObject(payload) ? payload : {},\n );\n}\n\nexport function basicAuthHeader(publicKey: string, secretKey: string): string {\n return `Basic ${Buffer.from(`${publicKey}:${secretKey}`).toString(\"base64\")}`;\n}\n\nfunction asStringOrNull(value: unknown): string | null {\n return typeof value === \"string\" ? value : null;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport const sessions = {\n load: loadSession,\n};\n"],"mappings":"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","names":[]}
@@ -1 +1,3 @@
1
- export { O as ObservationKind, a as ObserveClaudeOptions, b as ObserveOptions, T as TracingConfig, c as TracingState, f as flush, i as init, d as isGatewayConfigured, e as isInitialized, o as observe, g as observeAnthropic, h as observeClaude, j as observeOpenAI, s as shutdown } from '../index-yJgb8wh6.mjs';
1
+ export { I as IdentifyOptions, a as IdentitySpanProcessor, O as ObservationKind, b as ObserveClaudeOptions, c as ObserveOptions, T as TracingConfig, d as TracingHandle, e as TracingState, U as USER_ID_ATTRIBUTE, f as flush, i as identify, g as init, h as initIsolated, j as isGatewayConfigured, k as isInitialized, o as observe, l as observeAnthropic, m as observeClaude, n as observeOpenAI, p as resetAmbientUser, r as resolveUserId, s as shutdown } from '../index-DnowA8MG.mjs';
2
+ import '@opentelemetry/api';
3
+ import '@opentelemetry/sdk-trace-base';
@@ -1 +1,3 @@
1
- export { O as ObservationKind, a as ObserveClaudeOptions, b as ObserveOptions, T as TracingConfig, c as TracingState, f as flush, i as init, d as isGatewayConfigured, e as isInitialized, o as observe, g as observeAnthropic, h as observeClaude, j as observeOpenAI, s as shutdown } from '../index-yJgb8wh6.js';
1
+ export { I as IdentifyOptions, a as IdentitySpanProcessor, O as ObservationKind, b as ObserveClaudeOptions, c as ObserveOptions, T as TracingConfig, d as TracingHandle, e as TracingState, U as USER_ID_ATTRIBUTE, f as flush, i as identify, g as init, h as initIsolated, j as isGatewayConfigured, k as isInitialized, o as observe, l as observeAnthropic, m as observeClaude, n as observeOpenAI, p as resetAmbientUser, r as resolveUserId, s as shutdown } from '../index-DnowA8MG.js';
2
+ import '@opentelemetry/api';
3
+ import '@opentelemetry/sdk-trace-base';
@@ -20,18 +20,227 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
20
20
  // src/tracing/index.ts
21
21
  var tracing_exports = {};
22
22
  __export(tracing_exports, {
23
+ IdentitySpanProcessor: () => IdentitySpanProcessor,
24
+ USER_ID_ATTRIBUTE: () => USER_ID_ATTRIBUTE,
23
25
  flush: () => flush,
26
+ identify: () => identify,
24
27
  init: () => init,
28
+ initIsolated: () => initIsolated,
25
29
  isGatewayConfigured: () => isGatewayConfigured,
26
30
  isInitialized: () => isInitialized,
27
31
  observe: () => observe,
28
32
  observeAnthropic: () => observeAnthropic,
29
33
  observeClaude: () => observeClaude,
30
34
  observeOpenAI: () => observeOpenAI,
35
+ resetAmbientUser: () => resetAmbientUser,
36
+ resolveUserId: () => resolveUserId,
31
37
  shutdown: () => shutdown
32
38
  });
33
39
  module.exports = __toCommonJS(tracing_exports);
34
40
 
41
+ // src/tracing/identity.ts
42
+ var import_async_hooks = require("async_hooks");
43
+ var import_api = require("@opentelemetry/api");
44
+
45
+ // src/users/index.ts
46
+ var UserProfileError = class extends Error {
47
+ constructor(message, options) {
48
+ super(message);
49
+ this.name = "UserProfileError";
50
+ this.cause = options?.cause;
51
+ }
52
+ };
53
+ var UsersClient = class _UsersClient {
54
+ host;
55
+ publicKey;
56
+ secretKey;
57
+ timeoutSeconds;
58
+ debug;
59
+ constructor(config) {
60
+ this.host = config.host.replace(/\/$/, "");
61
+ this.publicKey = config.publicKey;
62
+ this.secretKey = config.secretKey;
63
+ this.timeoutSeconds = config.timeoutSeconds ?? 15;
64
+ this.debug = config.debug ?? false;
65
+ }
66
+ /** Create a client from GATEWAY_HOST / GATEWAY_PUBLIC_KEY / GATEWAY_SECRET_KEY. */
67
+ static fromEnv(config = {}) {
68
+ const host = config.host ?? process.env.GATEWAY_HOST;
69
+ const publicKey = config.publicKey ?? process.env.GATEWAY_PUBLIC_KEY;
70
+ const secretKey = config.secretKey ?? process.env.GATEWAY_SECRET_KEY;
71
+ const missing = [
72
+ ["host", host],
73
+ ["publicKey", publicKey],
74
+ ["secretKey", secretKey]
75
+ ].filter(([, value]) => !value).map(([name]) => name);
76
+ if (missing.length > 0) {
77
+ throw new UserProfileError(
78
+ `Missing Gateway user-profile configuration: ${missing.join(", ")}`
79
+ );
80
+ }
81
+ return new _UsersClient({
82
+ ...config,
83
+ host,
84
+ publicKey,
85
+ secretKey
86
+ });
87
+ }
88
+ /** Fetch a user's stored profile. */
89
+ async get(userId) {
90
+ return parseProfile(
91
+ await this.requestJson(
92
+ "GET",
93
+ `/api/public/user-profiles/${encodeURIComponent(userId)}`
94
+ )
95
+ );
96
+ }
97
+ /**
98
+ * Upsert a user's profile. `attributes` merge with the stored set unless
99
+ * `merge: false` (which replaces it).
100
+ */
101
+ async update(userId, update = {}) {
102
+ const body = {
103
+ userId,
104
+ attributes: update.attributes ?? {},
105
+ mergeAttributes: update.merge ?? true,
106
+ ...update.displayName !== void 0 ? { displayName: update.displayName } : {},
107
+ ...update.email !== void 0 ? { email: update.email } : {},
108
+ ...update.notes !== void 0 ? { notes: update.notes } : {}
109
+ };
110
+ return parseProfile(
111
+ await this.requestJson("POST", "/api/public/user-profiles", body)
112
+ );
113
+ }
114
+ async requestJson(method, path, payload) {
115
+ let response;
116
+ try {
117
+ response = await fetch(`${this.host}${path}`, {
118
+ method,
119
+ headers: {
120
+ Authorization: this.authHeader(),
121
+ "Content-Type": "application/json"
122
+ },
123
+ ...payload ? { body: JSON.stringify(payload) } : {},
124
+ signal: AbortSignal.timeout(this.timeoutSeconds * 1e3)
125
+ });
126
+ } catch (error) {
127
+ throw new UserProfileError(
128
+ `${method} ${path} failed: ${error instanceof Error ? error.message : String(error)}`,
129
+ { cause: error }
130
+ );
131
+ }
132
+ const text = await response.text();
133
+ if (!response.ok) {
134
+ throw new UserProfileError(
135
+ `${method} ${path} failed (${response.status}): ${text.slice(0, 500)}`
136
+ );
137
+ }
138
+ this.log("%s %s -> %s", method, path, response.status);
139
+ return safeJson(text);
140
+ }
141
+ authHeader() {
142
+ return `Basic ${Buffer.from(`${this.publicKey}:${this.secretKey}`).toString(
143
+ "base64"
144
+ )}`;
145
+ }
146
+ log(message, ...args) {
147
+ if (this.debug) {
148
+ console.log(`[gateway.users] ${message}`, ...args);
149
+ }
150
+ }
151
+ };
152
+ function parseProfile(payload) {
153
+ return {
154
+ userId: String(payload.userId ?? ""),
155
+ displayName: typeof payload.displayName === "string" ? payload.displayName : null,
156
+ email: typeof payload.email === "string" ? payload.email : null,
157
+ attributes: parseAttributes(payload.attributes),
158
+ notes: typeof payload.notes === "string" ? payload.notes : null
159
+ };
160
+ }
161
+ function parseAttributes(value) {
162
+ if (!value || typeof value !== "object" || Array.isArray(value)) return {};
163
+ const attributes = {};
164
+ for (const [key, entry] of Object.entries(value)) {
165
+ attributes[key] = String(entry);
166
+ }
167
+ return attributes;
168
+ }
169
+ function safeJson(value) {
170
+ try {
171
+ const parsed = JSON.parse(value);
172
+ return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
173
+ } catch {
174
+ return {};
175
+ }
176
+ }
177
+ var users = {
178
+ fromEnv: UsersClient.fromEnv
179
+ };
180
+
181
+ // src/tracing/identity.ts
182
+ var USER_ID_ATTRIBUTE = "gateway.user.id";
183
+ var currentUserStorage = new import_async_hooks.AsyncLocalStorage();
184
+ function resolveUserId() {
185
+ const contextual = currentUserStorage.getStore();
186
+ if (contextual) return contextual;
187
+ const envUser = process.env.GATEWAY_USER_ID?.trim();
188
+ return envUser ? envUser : void 0;
189
+ }
190
+ function identify(userId, options = {}) {
191
+ const cleaned = userId.trim();
192
+ if (!cleaned) return;
193
+ currentUserStorage.enterWith(cleaned);
194
+ try {
195
+ const span = import_api.trace.getActiveSpan();
196
+ if (span && (0, import_api.isSpanContextValid)(span.spanContext())) {
197
+ span.setAttribute(USER_ID_ATTRIBUTE, cleaned);
198
+ }
199
+ } catch (error) {
200
+ debugLog("identify(): no active span to stamp", error);
201
+ }
202
+ if (options.attributes || options.displayName || options.email) {
203
+ void pushProfile(cleaned, options);
204
+ }
205
+ }
206
+ async function pushProfile(userId, options) {
207
+ try {
208
+ const attributes = {};
209
+ for (const [key, value] of Object.entries(options.attributes ?? {})) {
210
+ attributes[key] = String(value);
211
+ }
212
+ await UsersClient.fromEnv().update(userId, {
213
+ ...options.displayName !== void 0 ? { displayName: options.displayName } : {},
214
+ ...options.email !== void 0 ? { email: options.email } : {},
215
+ attributes
216
+ });
217
+ } catch (error) {
218
+ debugLog("identify(): profile update failed", error);
219
+ }
220
+ }
221
+ function resetAmbientUser() {
222
+ currentUserStorage.enterWith(void 0);
223
+ }
224
+ var IdentitySpanProcessor = class {
225
+ onStart(span, _parentContext) {
226
+ const userId = resolveUserId();
227
+ if (userId) {
228
+ span.setAttribute(USER_ID_ATTRIBUTE, userId);
229
+ }
230
+ }
231
+ onEnd(_span) {
232
+ }
233
+ async shutdown() {
234
+ }
235
+ async forceFlush() {
236
+ }
237
+ };
238
+ function debugLog(message, ...args) {
239
+ if (process.env.GATEWAY_DEBUG) {
240
+ console.debug(`[gatewaysdk.tracing] ${message}`, ...args);
241
+ }
242
+ }
243
+
35
244
  // src/tracing/init.ts
36
245
  var ENV_VARS = {
37
246
  HOST: ["GATEWAY_HOST", "GATEWAY_HOST"],
@@ -59,12 +268,7 @@ function log(message, ...args) {
59
268
  function warn(message, ...args) {
60
269
  console.warn(`[gatewaysdk.tracing] ${message}`, ...args);
61
270
  }
62
- function init(config = {}) {
63
- if (state.initialized) {
64
- log("Tracing already initialized. Call shutdown() first to reinitialize.");
65
- return;
66
- }
67
- state.debug = config.debug ?? false;
271
+ function buildProvider(config, logFn) {
68
272
  const host = config.host ?? getEnv(ENV_VARS.HOST);
69
273
  const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);
70
274
  const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);
@@ -141,17 +345,18 @@ function init(config = {}) {
141
345
  Authorization: authHeader
142
346
  }
143
347
  });
144
- log("Configured Gateway exporter: endpoint=%s", endpoint);
348
+ logFn("Configured Gateway exporter: endpoint=%s", endpoint);
145
349
  const spanProcessors = [];
146
350
  if (config.customSpanProcessors) {
147
351
  for (const sp of config.customSpanProcessors) {
148
352
  spanProcessors.push(sp);
149
- log(
353
+ logFn(
150
354
  "Added custom span processor: %s",
151
355
  sp.constructor?.name ?? "unknown"
152
356
  );
153
357
  }
154
358
  }
359
+ spanProcessors.push(new IdentitySpanProcessor());
155
360
  const batchConfig = {};
156
361
  if (config.batch?.maxQueueSize) {
157
362
  batchConfig.maxQueueSize = config.batch.maxQueueSize;
@@ -176,6 +381,15 @@ function init(config = {}) {
176
381
  spanProcessors
177
382
  });
178
383
  }
384
+ return provider;
385
+ }
386
+ function init(config = {}) {
387
+ if (state.initialized) {
388
+ log("Tracing already initialized. Call shutdown() first to reinitialize.");
389
+ return;
390
+ }
391
+ state.debug = config.debug ?? false;
392
+ const provider = buildProvider(config, log);
179
393
  provider.register();
180
394
  state.provider = provider;
181
395
  state.initialized = true;
@@ -184,6 +398,33 @@ function init(config = {}) {
184
398
  config.serviceName ?? "gatewaysdk-tracing"
185
399
  );
186
400
  }
401
+ function initIsolated(config = {}) {
402
+ const debugLog2 = config.debug ? (message, ...args) => console.log(`[gatewaysdk.tracing:isolated] ${message}`, ...args) : () => {
403
+ };
404
+ const provider = buildProvider(config, debugLog2);
405
+ const tracer = provider.getTracer("@withgateway/sdk");
406
+ debugLog2(
407
+ "Isolated tracing provider created (service=%s)",
408
+ config.serviceName ?? "gatewaysdk-tracing"
409
+ );
410
+ return {
411
+ tracer,
412
+ async flush() {
413
+ try {
414
+ await provider.forceFlush();
415
+ } catch (e) {
416
+ warn("Error during isolated flush:", e);
417
+ }
418
+ },
419
+ async shutdown() {
420
+ try {
421
+ await provider.shutdown();
422
+ } catch (e) {
423
+ warn("Error during isolated shutdown:", e);
424
+ }
425
+ }
426
+ };
427
+ }
187
428
  async function flush() {
188
429
  if (!state.provider) {
189
430
  log("No provider to flush");
@@ -221,31 +462,32 @@ function isGatewayConfigured() {
221
462
  }
222
463
 
223
464
  // src/tracing/observe.ts
224
- var import_api = require("@opentelemetry/api");
465
+ var import_api2 = require("@opentelemetry/api");
225
466
  function asAttr(value) {
226
467
  return typeof value === "string" ? value : JSON.stringify(value);
227
468
  }
228
469
  async function observe(name, fn, options = {}) {
229
- const tracer = import_api.trace.getTracer("@withgateway/sdk");
470
+ const tracer = options.tracer ?? import_api2.trace.getTracer("@withgateway/sdk");
230
471
  const span = tracer.startSpan(name, {
231
472
  attributes: {
232
473
  "openinference.span.kind": options.kind ?? "AGENT",
233
- ...options.input !== void 0 ? { "input.value": asAttr(options.input) } : {}
474
+ ...options.input !== void 0 ? { "input.value": asAttr(options.input) } : {},
475
+ ...options.attributes ?? {}
234
476
  }
235
477
  });
236
478
  try {
237
- const result = await import_api.context.with(
238
- import_api.trace.setSpan(import_api.context.active(), span),
479
+ const result = await import_api2.context.with(
480
+ import_api2.trace.setSpan(import_api2.context.active(), span),
239
481
  fn
240
482
  );
241
483
  if (options.captureOutput !== false && result !== void 0) {
242
484
  span.setAttribute("output.value", asAttr(result));
243
485
  }
244
- span.setStatus({ code: import_api.SpanStatusCode.OK });
486
+ span.setStatus({ code: import_api2.SpanStatusCode.OK });
245
487
  return result;
246
488
  } catch (error) {
247
489
  span.setStatus({
248
- code: import_api.SpanStatusCode.ERROR,
490
+ code: import_api2.SpanStatusCode.ERROR,
249
491
  message: error instanceof Error ? error.message : String(error)
250
492
  });
251
493
  throw error;
@@ -292,7 +534,7 @@ function observeAnthropic(client) {
292
534
  }
293
535
 
294
536
  // src/tracing/claude.ts
295
- var import_api2 = require("@opentelemetry/api");
537
+ var import_api3 = require("@opentelemetry/api");
296
538
  function cleanToolName(name) {
297
539
  return name.replace(/^mcp__[^_]+__/, "");
298
540
  }
@@ -305,14 +547,15 @@ function toolResultText(content) {
305
547
  return JSON.stringify(content ?? "");
306
548
  }
307
549
  async function* observeClaude(stream, options) {
308
- const tracer = import_api2.trace.getTracer("@withgateway/sdk");
550
+ const tracer = options.tracer ?? import_api3.trace.getTracer("@withgateway/sdk");
309
551
  const root = tracer.startSpan(options.name, {
310
552
  attributes: {
311
553
  "openinference.span.kind": "AGENT",
312
- ...options.input !== void 0 ? { "input.value": options.input } : {}
554
+ ...options.input !== void 0 ? { "input.value": options.input } : {},
555
+ ...options.attributes ?? {}
313
556
  }
314
557
  });
315
- const rootCtx = import_api2.trace.setSpan(import_api2.context.active(), root);
558
+ const rootCtx = import_api3.trace.setSpan(import_api3.context.active(), root);
316
559
  const openTools = /* @__PURE__ */ new Map();
317
560
  const model = options.model ?? "claude";
318
561
  let finalText = "";
@@ -371,7 +614,7 @@ async function* observeClaude(stream, options) {
371
614
  const span = openTools.get(block.tool_use_id);
372
615
  if (span) {
373
616
  span.setAttribute("output.value", toolResultText(block.content));
374
- span.setStatus({ code: import_api2.SpanStatusCode.OK });
617
+ span.setStatus({ code: import_api3.SpanStatusCode.OK });
375
618
  span.end();
376
619
  openTools.delete(block.tool_use_id);
377
620
  }
@@ -385,20 +628,26 @@ async function* observeClaude(stream, options) {
385
628
  for (const span of openTools.values()) span.end();
386
629
  openTools.clear();
387
630
  root.setAttribute("output.value", finalText);
388
- root.setStatus({ code: import_api2.SpanStatusCode.OK });
631
+ root.setStatus({ code: import_api3.SpanStatusCode.OK });
389
632
  root.end();
390
633
  }
391
634
  }
392
635
  // Annotate the CommonJS export names for ESM import in node:
393
636
  0 && (module.exports = {
637
+ IdentitySpanProcessor,
638
+ USER_ID_ATTRIBUTE,
394
639
  flush,
640
+ identify,
395
641
  init,
642
+ initIsolated,
396
643
  isGatewayConfigured,
397
644
  isInitialized,
398
645
  observe,
399
646
  observeAnthropic,
400
647
  observeClaude,
401
648
  observeOpenAI,
649
+ resetAmbientUser,
650
+ resolveUserId,
402
651
  shutdown
403
652
  });
404
653
  //# sourceMappingURL=index.js.map