@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
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/tracing/index.ts","../../src/tracing/init.ts","../../src/tracing/observe.ts","../../src/tracing/instrument.ts","../../src/tracing/claude.ts"],"sourcesContent":["/**\n * Tracing module for GatewaySDK TypeScript SDK.\n *\n * Provides a simple init() function that configures OpenTelemetry with\n * Gateway, mirroring the Python SDK's tracing.init() experience.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * // Initialize with environment variables\n * tracing.init();\n *\n * // Or with explicit configuration\n * tracing.init({\n * host: \"https://app.gateway.dev\",\n * publicKey: \"pk-lf-...\",\n * secretKey: \"sk-lf-...\",\n * });\n *\n * // Ensure cleanup on shutdown\n * process.on(\"SIGTERM\", () => tracing.shutdown());\n * ```\n */\n\nexport type { TracingConfig, TracingState } from \"./types\";\n\nexport {\n init,\n shutdown,\n flush,\n isInitialized,\n isGatewayConfigured,\n} from \"./init\";\n\nexport { observe } from \"./observe\";\nexport type { ObserveOptions, ObservationKind } from \"./observe\";\n\nexport { observeOpenAI, observeAnthropic } from \"./instrument\";\n\nexport { observeClaude } from \"./claude\";\nexport type { ObserveClaudeOptions } from \"./claude\";\n","/**\n * Initialization and lifecycle management for GatewaySDK tracing.\n *\n * This module provides the core init(), shutdown(), and flush() functions\n * for managing the OpenTelemetry TracerProvider lifecycle.\n *\n * Mirrors the Python SDK's tracing.init() for a consistent developer experience.\n */\n\nimport type { TracingConfig, TracingState } from \"./types\";\n\n// Environment variable names (support both GATEWAY_* and GATEWAY_* prefixes)\nconst ENV_VARS = {\n HOST: [\"GATEWAY_HOST\", \"GATEWAY_HOST\"],\n PUBLIC_KEY: [\"GATEWAY_PUBLIC_KEY\", \"GATEWAY_PUBLIC_KEY\"],\n SECRET_KEY: [\"GATEWAY_SECRET_KEY\", \"GATEWAY_SECRET_KEY\"],\n ENDPOINT: [\"GATEWAY_OTLP_ENDPOINT\", \"GATEWAY_OTLP_ENDPOINT\"],\n} as const;\n\nconst DEFAULT_OTLP_PATH = \"/api/public/otel/v1/traces\";\n\n// Module-level state\nconst state: TracingState & { debug?: boolean } = {\n initialized: false,\n provider: null,\n};\n\nfunction getEnv(keys: readonly string[]): string | undefined {\n for (const key of keys) {\n const value = process.env[key];\n if (value) return value;\n }\n return undefined;\n}\n\nfunction log(message: string, ...args: unknown[]): void {\n if (state.debug) {\n console.log(`[gatewaysdk.tracing] ${message}`, ...args);\n }\n}\n\nfunction warn(message: string, ...args: unknown[]): void {\n console.warn(`[gatewaysdk.tracing] ${message}`, ...args);\n}\n\n/**\n * Initialize GatewaySDK tracing with automatic OpenTelemetry configuration.\n *\n * This function configures OpenTelemetry with a connection to Gateway\n * and sets up the ExperimentSpanProcessor for automatic experiment tagging.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * // Using environment variables (GATEWAY_HOST, GATEWAY_PUBLIC_KEY, GATEWAY_SECRET_KEY)\n * tracing.init();\n *\n * // Or with explicit configuration\n * tracing.init({\n * host: \"https://app.gateway.dev\",\n * publicKey: \"pk-lf-...\",\n * secretKey: \"sk-lf-...\",\n * serviceName: \"my-agent\",\n * environment: \"production\",\n * });\n * ```\n */\nexport function init(config: TracingConfig = {}): void {\n if (state.initialized) {\n log(\"Tracing already initialized. Call shutdown() first to reinitialize.\");\n return;\n }\n\n // Store debug flag in state for log() function\n state.debug = config.debug ?? false;\n\n // Resolve configuration from params or environment\n const host = config.host ?? getEnv(ENV_VARS.HOST);\n const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);\n const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);\n const endpoint =\n config.endpoint ??\n getEnv(ENV_VARS.ENDPOINT) ??\n (host ? `${host.replace(/\\/$/, \"\")}${DEFAULT_OTLP_PATH}` : undefined);\n\n // Validate required configuration\n const missing: string[] = [];\n if (!host) missing.push(\"host (or GATEWAY_HOST env var)\");\n if (!publicKey) missing.push(\"publicKey (or GATEWAY_PUBLIC_KEY env var)\");\n if (!secretKey) missing.push(\"secretKey (or GATEWAY_SECRET_KEY env var)\");\n\n if (missing.length > 0) {\n throw new Error(\n `Missing required Gateway configuration: ${missing.join(\", \")}. ` +\n \"Provide these values via init() parameters or environment variables.\",\n );\n }\n\n // Dynamically import OpenTelemetry modules (they're peer dependencies)\n // Using 'any' to avoid version conflicts between OTel packages\n /* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\n let NodeTracerProvider: any;\n let BatchSpanProcessor: any;\n let OTLPTraceExporter: any;\n let createResource: (attrs: Record<string, string>) => any;\n let ATTR_SERVICE_NAME: string;\n\n try {\n const traceNode = require(\"@opentelemetry/sdk-trace-node\");\n const traceBase = require(\"@opentelemetry/sdk-trace-base\");\n const otlpHttp = require(\"@opentelemetry/exporter-trace-otlp-http\");\n const resources = require(\"@opentelemetry/resources\");\n\n NodeTracerProvider = traceNode.NodeTracerProvider;\n BatchSpanProcessor = traceBase.BatchSpanProcessor;\n OTLPTraceExporter = otlpHttp.OTLPTraceExporter;\n\n // Handle both old (Resource class) and new (resourceFromAttributes function) APIs\n if (resources.Resource) {\n createResource = (attrs) => new resources.Resource(attrs);\n } else if (resources.resourceFromAttributes) {\n createResource = resources.resourceFromAttributes;\n } else {\n createResource = () => resources.defaultResource();\n }\n\n // Try semantic conventions, fall back to string literal\n try {\n const semconv = require(\"@opentelemetry/semantic-conventions\");\n ATTR_SERVICE_NAME =\n semconv.ATTR_SERVICE_NAME ?? semconv.SEMRESATTRS_SERVICE_NAME ?? \"service.name\";\n } catch {\n ATTR_SERVICE_NAME = \"service.name\";\n }\n } catch {\n throw new Error(\n \"OpenTelemetry packages not found. Install them with:\\n\" +\n \"npm install @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base \" +\n \"@opentelemetry/exporter-trace-otlp-http @opentelemetry/resources\",\n );\n }\n\n // Build resource attributes\n const resourceAttrs: Record<string, string> = {\n [ATTR_SERVICE_NAME]: config.serviceName ?? \"gatewaysdk-tracing\",\n };\n if (config.environment) {\n resourceAttrs[\"gateway.environment\"] = config.environment;\n }\n if (config.version) {\n resourceAttrs[\"gateway.version\"] = config.version;\n }\n\n // Security check: block insecure HTTP (except localhost/127.0.0.1)\n let isLocalhost = false;\n if (endpoint) {\n try {\n const parsed = new URL(endpoint);\n isLocalhost =\n parsed.hostname === \"localhost\" || parsed.hostname === \"127.0.0.1\";\n } catch {\n isLocalhost = false;\n }\n }\n if (endpoint && !endpoint.startsWith(\"https://\") && !isLocalhost) {\n throw new Error(\n `Refusing to send credentials over insecure HTTP to ${endpoint}. ` +\n \"Use HTTPS or localhost for development.\",\n );\n }\n\n // Construct Basic Auth header\n const credentials = `${publicKey}:${secretKey}`;\n const encoded = Buffer.from(credentials).toString(\"base64\");\n const authHeader = `Basic ${encoded}`;\n\n // Create OTLP exporter\n const exporter = new OTLPTraceExporter({\n url: endpoint,\n headers: {\n Authorization: authHeader,\n },\n });\n\n log(\"Configured Gateway exporter: endpoint=%s\", endpoint);\n\n // Build span processors — custom processors go first (before the BatchSpanProcessor)\n const spanProcessors: any[] = [];\n\n if (config.customSpanProcessors) {\n for (const sp of config.customSpanProcessors) {\n spanProcessors.push(sp);\n log(\n \"Added custom span processor: %s\",\n (sp as { constructor?: { name?: string } }).constructor?.name ??\n \"unknown\",\n );\n }\n }\n\n // Add BatchSpanProcessor with exporter\n const batchConfig: Record<string, number> = {};\n if (config.batch?.maxQueueSize) {\n batchConfig.maxQueueSize = config.batch.maxQueueSize;\n }\n if (config.batch?.scheduledDelayMillis) {\n batchConfig.scheduledDelayMillis = config.batch.scheduledDelayMillis;\n }\n if (config.batch?.maxExportBatchSize) {\n batchConfig.maxExportBatchSize = config.batch.maxExportBatchSize;\n }\n\n spanProcessors.push(new BatchSpanProcessor(exporter, batchConfig));\n\n // Create provider — detect v1 vs v2 API via runtime feature check.\n // v1 has addSpanProcessor(); v2 removed it and requires spanProcessors in constructor.\n let provider: any = new NodeTracerProvider({\n resource: createResource(resourceAttrs),\n });\n\n if (typeof provider.addSpanProcessor === \"function\") {\n // v1 API: register each processor individually\n for (const sp of spanProcessors) {\n provider.addSpanProcessor(sp);\n }\n } else {\n // v2 API: must pass spanProcessors in constructor — recreate\n provider = new NodeTracerProvider({\n resource: createResource(resourceAttrs),\n spanProcessors,\n });\n }\n\n provider.register();\n\n state.provider = provider;\n state.initialized = true;\n /* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\n\n log(\n \"GatewaySDK tracing initialized successfully (service=%s)\",\n config.serviceName ?? \"gatewaysdk-tracing\",\n );\n}\n\n/**\n * Force flush all pending spans without shutting down.\n *\n * Useful for ensuring spans are exported at specific points\n * (e.g., after completing a batch of work) without ending the tracing session.\n *\n * @returns Promise that resolves when flush completes\n */\nexport async function flush(): Promise<void> {\n if (!state.provider) {\n log(\"No provider to flush\");\n return;\n }\n\n try {\n await (state.provider as { forceFlush: () => Promise<void> }).forceFlush();\n log(\"Flush completed successfully\");\n } catch (e) {\n warn(\"Error during flush:\", e);\n }\n}\n\n/**\n * Force flush all pending spans and shutdown the tracer provider.\n *\n * This function should be called before process exit to ensure all spans\n * are exported. It is safe to call multiple times.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * tracing.init();\n *\n * // On shutdown\n * process.on(\"SIGTERM\", async () => {\n * await tracing.shutdown();\n * process.exit(0);\n * });\n * ```\n */\nexport async function shutdown(): Promise<void> {\n if (!state.initialized || !state.provider) {\n log(\"Tracing not initialized, nothing to shutdown\");\n return;\n }\n\n try {\n await (state.provider as { shutdown: () => Promise<void> }).shutdown();\n log(\"Shutdown complete\");\n } catch (e) {\n warn(\"Error during shutdown:\", e);\n }\n\n state.provider = null;\n state.initialized = false;\n}\n\n/**\n * Check if tracing has been initialized.\n */\nexport function isInitialized(): boolean {\n return state.initialized;\n}\n\n/**\n * Check if Gateway is configured via environment variables.\n */\nexport function isGatewayConfigured(): boolean {\n const host = getEnv(ENV_VARS.HOST);\n const publicKey = getEnv(ENV_VARS.PUBLIC_KEY);\n const secretKey = getEnv(ENV_VARS.SECRET_KEY);\n return !!(host && publicKey && secretKey);\n}\n","/**\n * observe() — group a unit of work (an agent run, a tool call) into a single\n * span so nested LLM/tool spans attach to it and the whole thing is one trace.\n *\n * Mirrors Langfuse's `observe()` / `startActiveObservation()`. This is what an\n * app uses to define a trace boundary when it drives a raw client loop (which\n * has no framework root span of its own): the callback runs inside the span's\n * OpenTelemetry context, so any auto-instrumented calls (see observeOpenAI) and\n * any nested observe() calls become children of it.\n *\n * The span carries OpenInference attributes (openinference.span.kind, input.value,\n * output.value), and Gateway maps a root span's input.value/output.value to the\n * trace-level input/output — so the trace shows the user input and final output.\n */\nimport { trace, context, SpanStatusCode } from \"@opentelemetry/api\";\n\nexport type ObservationKind = \"AGENT\" | \"CHAIN\" | \"TOOL\" | \"LLM\" | \"RETRIEVER\";\n\nexport interface ObserveOptions {\n /** Recorded as input.value on the span (JSON-stringified if not a string). */\n input?: unknown;\n /** OpenInference span kind. Defaults to \"AGENT\" for the outer run. */\n kind?: ObservationKind;\n /**\n * When true (default), the callback's return value is recorded as\n * output.value. Set false if the return value is large/uninteresting.\n */\n captureOutput?: boolean;\n}\n\nfunction asAttr(value: unknown): string {\n return typeof value === \"string\" ? value : JSON.stringify(value);\n}\n\n/**\n * Run `fn` inside a span named `name`. Anything traced inside (auto-instrumented\n * client calls, nested observe() calls) nests under it, forming one trace.\n *\n * @example\n * ```ts\n * const result = await observe(\"my-agent.run\", async () => {\n * // client.chat.completions.create(...) here becomes a child GENERATION\n * return finalText;\n * }, { input: prompt });\n * ```\n */\nexport async function observe<T>(\n name: string,\n fn: () => Promise<T>,\n options: ObserveOptions = {},\n): Promise<T> {\n const tracer = trace.getTracer(\"@withgateway/sdk\");\n const span = tracer.startSpan(name, {\n attributes: {\n \"openinference.span.kind\": options.kind ?? \"AGENT\",\n ...(options.input !== undefined\n ? { \"input.value\": asAttr(options.input) }\n : {}),\n },\n });\n\n try {\n const result = await context.with(\n trace.setSpan(context.active(), span),\n fn,\n );\n if (options.captureOutput !== false && result !== undefined) {\n span.setAttribute(\"output.value\", asAttr(result));\n }\n span.setStatus({ code: SpanStatusCode.OK });\n return result;\n } catch (error) {\n span.setStatus({\n code: SpanStatusCode.ERROR,\n message: error instanceof Error ? error.message : String(error),\n });\n throw error;\n } finally {\n span.end();\n }\n}\n","/**\n * Client wrappers that turn an SDK's calls into spans on the Gateway provider.\n *\n * Node ESM can't retroactively patch a module the app already imported, so — as\n * Langfuse does with `observeOpenAI` — the app hands us the client and we\n * instrument it explicitly. One SDK call, no OpenTelemetry in the app.\n *\n * The OpenInference instrumentations are bundled optional deps of this package;\n * we load them with require() (the ESM build injects a real createRequire).\n */\n/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\n\nfunction warn(message: string, ...args: unknown[]): void {\n console.warn(`[gatewaysdk.tracing] ${message}`, ...args);\n}\n\n/**\n * Instrument an OpenAI client so its requests become GENERATION spans on the\n * Gateway provider. Returns the same client (its class prototype is patched, so\n * this and every other instance of that client are traced).\n *\n * @example\n * ```ts\n * import OpenAI from \"openai\";\n * import { init, observeOpenAI } from \"@withgateway/sdk/tracing\";\n * init();\n * const client = observeOpenAI(new OpenAI());\n * ```\n */\nexport function observeOpenAI<T extends object>(client: T): T {\n try {\n const {\n OpenAIInstrumentation,\n } = require(\"@arizeai/openinference-instrumentation-openai\");\n // OpenInference patches `module.OpenAI.Chat.Completions.prototype`, so it\n // needs an object shaped like the openai module. Reconstruct it from the\n // instance's class (client.constructor === the OpenAI class).\n const OpenAIClass = (client as { constructor: unknown }).constructor;\n new OpenAIInstrumentation().manuallyInstrument({ OpenAI: OpenAIClass });\n } catch (error) {\n warn(\n \"observeOpenAI: could not load @arizeai/openinference-instrumentation-openai — OpenAI calls will not be traced.\",\n error,\n );\n }\n return client;\n}\n\n/**\n * Instrument an Anthropic client so its requests become GENERATION spans.\n *\n * @example\n * ```ts\n * import Anthropic from \"@anthropic-ai/sdk\";\n * import { init, observeAnthropic } from \"@withgateway/sdk/tracing\";\n * init();\n * const client = observeAnthropic(new Anthropic());\n * ```\n */\nexport function observeAnthropic<T extends object>(client: T): T {\n try {\n const {\n AnthropicInstrumentation,\n } = require(\"@arizeai/openinference-instrumentation-anthropic\");\n // The instrumentor patches `module.Messages.prototype.create`, so it wants\n // an object whose `Messages` is the Anthropic client's Messages class (a\n // static on the class). `client.messages` resolves `create` through that\n // prototype, so patching it traces this client and every other instance.\n const AnthropicClass = (client as { constructor: { Messages?: unknown } })\n .constructor;\n new AnthropicInstrumentation().manuallyInstrument({\n Messages: AnthropicClass.Messages,\n });\n } catch (error) {\n warn(\n \"observeAnthropic: could not load @arizeai/openinference-instrumentation-anthropic — Anthropic calls will not be traced.\",\n error,\n );\n }\n return client;\n}\n","/**\n * observeClaude() — trace a Claude Agent SDK run.\n *\n * The Claude Agent SDK runs the agent in a separate `claude` CLI subprocess, so\n * there's nothing in-process to patch. What the app has is the message stream it\n * iterates. Wrap that stream with observeClaude() and it yields the same\n * messages unchanged while emitting spans on the Gateway provider:\n *\n * AGENT (root)\n * ├─ GENERATION per assistant turn (with per-turn token usage)\n * └─ TOOL per tool call (input from tool_use, output from the\n * matching tool_result, matched by id)\n *\n * The TS equivalent of the Python SDK's claude-agent-sdk instrumentor.\n *\n * @example\n * ```ts\n * const stream = query({ prompt, options });\n * for await (const message of observeClaude(stream, { name, input: prompt })) {\n * // ...consume messages as usual\n * }\n * ```\n */\nimport {\n trace,\n context,\n SpanStatusCode,\n type Span,\n type Context,\n} from \"@opentelemetry/api\";\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nexport interface ObserveClaudeOptions {\n /** Root span name (becomes the trace name). */\n name: string;\n /** Recorded as input.value on the root span → trace-level input. */\n input?: string;\n /** Model label for the generation spans. */\n model?: string;\n}\n\n/** Strip the `mcp__<server>__` prefix so tool names read cleanly. */\nfunction cleanToolName(name: string): string {\n return name.replace(/^mcp__[^_]+__/, \"\");\n}\n\nfunction toolResultText(content: unknown): string {\n if (typeof content === \"string\") return content;\n if (Array.isArray(content))\n return content\n .map((b) =>\n b && typeof b === \"object\" && \"text\" in b\n ? String((b as { text: unknown }).text)\n : JSON.stringify(b),\n )\n .join(\"\");\n return JSON.stringify(content ?? \"\");\n}\n\nexport async function* observeClaude(\n stream: AsyncIterable<any>,\n options: ObserveClaudeOptions,\n): AsyncGenerator<any> {\n const tracer = trace.getTracer(\"@withgateway/sdk\");\n const root: Span = tracer.startSpan(options.name, {\n attributes: {\n \"openinference.span.kind\": \"AGENT\",\n ...(options.input !== undefined ? { \"input.value\": options.input } : {}),\n },\n });\n const rootCtx: Context = trace.setSpan(context.active(), root);\n const openTools = new Map<string, Span>();\n const model = options.model ?? \"claude\";\n let finalText = \"\";\n\n try {\n for await (const message of stream) {\n if (message?.type === \"assistant\") {\n let turnText = \"\";\n const toolUses: Array<{ id: string; name: string; input: unknown }> = [];\n for (const block of message.message?.content ?? []) {\n if (block?.type === \"text\") {\n finalText += block.text;\n turnText += block.text;\n }\n if (block?.type === \"tool_use\") {\n toolUses.push({ id: block.id, name: block.name, input: block.input });\n }\n }\n const gen = tracer.startSpan(\n \"assistant\",\n {\n attributes: {\n \"openinference.span.kind\": \"LLM\",\n \"llm.model_name\": model,\n \"llm.provider\": \"anthropic\",\n \"output.value\":\n turnText ||\n toolUses.map((t) => `→ ${cleanToolName(t.name)}`).join(\", \"),\n },\n },\n rootCtx,\n );\n const usage = message.message?.usage;\n if (usage?.input_tokens != null)\n gen.setAttribute(\"llm.token_count.prompt\", usage.input_tokens);\n if (usage?.output_tokens != null)\n gen.setAttribute(\"llm.token_count.completion\", usage.output_tokens);\n gen.end();\n\n for (const t of toolUses) {\n const span = tracer.startSpan(\n `tool.${cleanToolName(t.name)}`,\n {\n attributes: {\n \"openinference.span.kind\": \"TOOL\",\n \"tool.name\": cleanToolName(t.name),\n \"input.value\": JSON.stringify(t.input),\n },\n },\n rootCtx,\n );\n openTools.set(t.id, span);\n }\n }\n\n // tool_result (in a `user` message) closes the matching TOOL span.\n if (message?.type === \"user\") {\n const content = message.message?.content;\n if (Array.isArray(content)) {\n for (const block of content) {\n if (block?.type === \"tool_result\") {\n const span = openTools.get(block.tool_use_id);\n if (span) {\n span.setAttribute(\"output.value\", toolResultText(block.content));\n span.setStatus({ code: SpanStatusCode.OK });\n span.end();\n openTools.delete(block.tool_use_id);\n }\n }\n }\n }\n }\n\n yield message;\n }\n } finally {\n for (const span of openTools.values()) span.end();\n openTools.clear();\n root.setAttribute(\"output.value\", finalText);\n root.setStatus({ code: SpanStatusCode.OK });\n root.end();\n }\n}\n"],"mappings":"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","names":["warn","import_api"]}
1
+ {"version":3,"sources":["../../src/tracing/index.ts","../../src/tracing/identity.ts","../../src/users/index.ts","../../src/tracing/init.ts","../../src/tracing/observe.ts","../../src/tracing/instrument.ts","../../src/tracing/claude.ts"],"sourcesContent":["/**\n * Tracing module for GatewaySDK TypeScript SDK.\n *\n * Provides a simple init() function that configures OpenTelemetry with\n * Gateway, mirroring the Python SDK's tracing.init() experience.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * // Initialize with environment variables\n * tracing.init();\n *\n * // Or with explicit configuration\n * tracing.init({\n * host: \"https://app.gateway.dev\",\n * publicKey: \"pk-lf-...\",\n * secretKey: \"sk-lf-...\",\n * });\n *\n * // Ensure cleanup on shutdown\n * process.on(\"SIGTERM\", () => tracing.shutdown());\n * ```\n */\n\nexport type { TracingConfig, TracingState } from \"./types\";\n\nexport {\n init,\n initIsolated,\n shutdown,\n flush,\n isInitialized,\n isGatewayConfigured,\n} from \"./init\";\nexport type { TracingHandle } from \"./init\";\n\nexport {\n identify,\n resolveUserId,\n resetAmbientUser,\n IdentitySpanProcessor,\n USER_ID_ATTRIBUTE,\n} from \"./identity\";\nexport type { IdentifyOptions } from \"./identity\";\n\nexport { observe } from \"./observe\";\nexport type { ObserveOptions, ObservationKind } from \"./observe\";\n\nexport { observeOpenAI, observeAnthropic } from \"./instrument\";\n\nexport { observeClaude } from \"./claude\";\nexport type { ObserveClaudeOptions } from \"./claude\";\n","/**\n * End-user identity for GatewaySDK tracing.\n *\n * Mirrors the Python SDK's `gatewaysdk.tracing.identity` user half:\n *\n * - The ambient user is set via `identify()` and stored in an\n * AsyncLocalStorage (the TS analogue of Python's ContextVar), so\n * concurrent requests serving different users never bleed into each other.\n * - `IdentitySpanProcessor` (registered by `tracing.init()`) stamps the\n * ambient user on every span at start, so everything traced after\n * `identify()` is attributed automatically — the same seam as Python's\n * `TracingContextSpanProcessor` and this SDK's `ExperimentSpanProcessor`.\n * - `identify()` also stamps the currently open span directly, because\n * ingestion treats `gateway.user.id` on ANY span as a trace-level update —\n * the in-flight trace is attributed immediately.\n */\n\nimport { AsyncLocalStorage } from \"async_hooks\";\nimport { isSpanContextValid, trace } from \"@opentelemetry/api\";\nimport type { Context } from \"@opentelemetry/api\";\nimport type {\n ReadableSpan,\n Span,\n SpanProcessor,\n} from \"@opentelemetry/sdk-trace-base\";\nimport { UsersClient } from \"../users/index\";\n\nexport const USER_ID_ATTRIBUTE = \"gateway.user.id\";\n\n// Per-async-context user identity set via identify() — AsyncLocalStorage so\n// concurrent requests serving different users never bleed into each other.\nconst currentUserStorage = new AsyncLocalStorage<string>();\n\n/**\n * The active end-user id: identify() context > GATEWAY_USER_ID env.\n *\n * Per-request user attribution (e.g. from auth middleware) can also override\n * per span by setting the `gateway.user.id` attribute directly — explicit\n * set wins over the ambient default stamped at span start.\n */\nexport function resolveUserId(): string | undefined {\n const contextual = currentUserStorage.getStore();\n if (contextual) return contextual;\n const envUser = process.env.GATEWAY_USER_ID?.trim();\n return envUser ? envUser : undefined;\n}\n\nexport interface IdentifyOptions {\n /** Profile attributes to merge into the user's stored profile. */\n attributes?: Record<string, string | number | boolean>;\n displayName?: string;\n email?: string;\n}\n\n/**\n * Attribute everything that follows (and the current trace) to a user.\n *\n * - Sets the user for all spans started in this async context, and stamps\n * the currently open span so the in-flight trace is attributed immediately.\n * - When `attributes`/`displayName`/`email` are given, the user's platform\n * profile is updated in the background (attributes merge with what's\n * stored — ideal for incremental ROI facts like plan or account_value).\n * Requires GATEWAY_HOST/GATEWAY_PUBLIC_KEY/GATEWAY_SECRET_KEY for the\n * profile update; tracing attribution works without them. Failures are\n * swallowed (debug-logged) and never produce unhandled rejections.\n *\n * @example\n * ```typescript\n * import { identify } from \"@withgateway/sdk\";\n *\n * identify(\"user-123\", {\n * attributes: { plan: \"enterprise\", account_value: \"48000\" },\n * });\n * ```\n */\nexport function identify(userId: string, options: IdentifyOptions = {}): void {\n const cleaned = userId.trim();\n if (!cleaned) return;\n\n currentUserStorage.enterWith(cleaned);\n\n // Stamp the open span so the in-flight trace is upserted with the user —\n // ingestion treats user.id on ANY span as a trace-level update.\n try {\n const span = trace.getActiveSpan();\n if (span && isSpanContextValid(span.spanContext())) {\n span.setAttribute(USER_ID_ATTRIBUTE, cleaned);\n }\n } catch (error) {\n debugLog(\"identify(): no active span to stamp\", error);\n }\n\n if (options.attributes || options.displayName || options.email) {\n void pushProfile(cleaned, options);\n }\n}\n\nasync function pushProfile(\n userId: string,\n options: IdentifyOptions,\n): Promise<void> {\n try {\n const attributes: Record<string, string> = {};\n for (const [key, value] of Object.entries(options.attributes ?? {})) {\n attributes[key] = String(value);\n }\n await UsersClient.fromEnv().update(userId, {\n ...(options.displayName !== undefined\n ? { displayName: options.displayName }\n : {}),\n ...(options.email !== undefined ? { email: options.email } : {}),\n attributes,\n });\n } catch (error) {\n debugLog(\"identify(): profile update failed\", error);\n }\n}\n\n/** Testing hook: clear the ambient user for the current async context. */\nexport function resetAmbientUser(): void {\n currentUserStorage.enterWith(undefined as unknown as string);\n}\n\n/**\n * Stamps the ambient end-user identity (identify() context or\n * GATEWAY_USER_ID env) on every span at start. Registered automatically by\n * `tracing.init()`. Explicit `setAttribute` calls after span start win over\n * this ambient default.\n */\nexport class IdentitySpanProcessor implements SpanProcessor {\n onStart(span: Span, _parentContext: Context): void {\n const userId = resolveUserId();\n if (userId) {\n span.setAttribute(USER_ID_ATTRIBUTE, userId);\n }\n }\n\n onEnd(_span: ReadableSpan): void {}\n\n async shutdown(): Promise<void> {}\n\n async forceFlush(): Promise<void> {}\n}\n\nfunction debugLog(message: string, ...args: unknown[]): void {\n if (process.env.GATEWAY_DEBUG) {\n console.debug(`[gatewaysdk.tracing] ${message}`, ...args);\n }\n}\n","/**\n * End-user profiles — attribute usage and ROI to the real people behind\n * your agent's traffic.\n *\n * Profiles pair with the platform's per-user usage metrics (traces, tokens,\n * lifetime cost) on the Users page. Attributes merge by default, so pushing\n * an incremental ROI fact is one call:\n *\n * ```typescript\n * import { UsersClient } from \"@withgateway/sdk/users\";\n *\n * const users = UsersClient.fromEnv();\n * await users.update(\"user-123\", {\n * displayName: \"Acme Corp — Jane D.\",\n * attributes: { plan: \"enterprise\", account_value: \"48000\" },\n * });\n * ```\n *\n * Tip: `identify(\"user-123\", { attributes: {...} })` does this in the\n * background AND attributes the current trace/session to the user.\n *\n * Mirrors the Python SDK's `gatewaysdk.users` module.\n */\n\ntype UserProfile = {\n userId: string;\n displayName: string | null;\n email: string | null;\n attributes: Record<string, string>;\n notes: string | null;\n};\n\ntype UserProfileUpdate = {\n displayName?: string;\n email?: string;\n attributes?: Record<string, string>;\n notes?: string;\n /**\n * Attributes merge with the stored set by default. Set `merge: false`\n * to replace the stored attributes wholesale.\n */\n merge?: boolean;\n};\n\ntype UsersClientConfig = {\n host: string;\n publicKey: string;\n secretKey: string;\n timeoutSeconds?: number;\n debug?: boolean;\n};\n\ntype UsersClientFromEnvConfig = Partial<UsersClientConfig>;\n\n/** Raised when the Gateway user-profiles API cannot complete a request. */\nexport class UserProfileError extends Error {\n constructor(message: string, options?: { cause?: unknown }) {\n super(message);\n this.name = \"UserProfileError\";\n this.cause = options?.cause;\n }\n}\n\n/** Client for Gateway's end-user profile endpoints (Basic project keys). */\nexport class UsersClient {\n private readonly host: string;\n private readonly publicKey: string;\n private readonly secretKey: string;\n private readonly timeoutSeconds: number;\n private readonly debug: boolean;\n\n constructor(config: UsersClientConfig) {\n this.host = config.host.replace(/\\/$/, \"\");\n this.publicKey = config.publicKey;\n this.secretKey = config.secretKey;\n this.timeoutSeconds = config.timeoutSeconds ?? 15;\n this.debug = config.debug ?? false;\n }\n\n /** Create a client from GATEWAY_HOST / GATEWAY_PUBLIC_KEY / GATEWAY_SECRET_KEY. */\n static fromEnv(config: UsersClientFromEnvConfig = {}) {\n const host = config.host ?? process.env.GATEWAY_HOST;\n const publicKey = config.publicKey ?? process.env.GATEWAY_PUBLIC_KEY;\n const secretKey = config.secretKey ?? process.env.GATEWAY_SECRET_KEY;\n\n const missing = [\n [\"host\", host],\n [\"publicKey\", publicKey],\n [\"secretKey\", secretKey],\n ]\n .filter(([, value]) => !value)\n .map(([name]) => name);\n\n if (missing.length > 0) {\n throw new UserProfileError(\n `Missing Gateway user-profile configuration: ${missing.join(\", \")}`,\n );\n }\n\n return new UsersClient({\n ...config,\n host: host!,\n publicKey: publicKey!,\n secretKey: secretKey!,\n });\n }\n\n /** Fetch a user's stored profile. */\n async get(userId: string): Promise<UserProfile> {\n return parseProfile(\n await this.requestJson(\n \"GET\",\n `/api/public/user-profiles/${encodeURIComponent(userId)}`,\n ),\n );\n }\n\n /**\n * Upsert a user's profile. `attributes` merge with the stored set unless\n * `merge: false` (which replaces it).\n */\n async update(\n userId: string,\n update: UserProfileUpdate = {},\n ): Promise<UserProfile> {\n const body: Record<string, unknown> = {\n userId,\n attributes: update.attributes ?? {},\n mergeAttributes: update.merge ?? true,\n ...(update.displayName !== undefined\n ? { displayName: update.displayName }\n : {}),\n ...(update.email !== undefined ? { email: update.email } : {}),\n ...(update.notes !== undefined ? { notes: update.notes } : {}),\n };\n return parseProfile(\n await this.requestJson(\"POST\", \"/api/public/user-profiles\", body),\n );\n }\n\n private async requestJson(\n method: \"GET\" | \"POST\",\n path: string,\n payload?: Record<string, unknown>,\n ): Promise<Record<string, unknown>> {\n let response: Response;\n try {\n response = await fetch(`${this.host}${path}`, {\n method,\n headers: {\n Authorization: this.authHeader(),\n \"Content-Type\": \"application/json\",\n },\n ...(payload ? { body: JSON.stringify(payload) } : {}),\n signal: AbortSignal.timeout(this.timeoutSeconds * 1000),\n });\n } catch (error) {\n throw new UserProfileError(\n `${method} ${path} failed: ${error instanceof Error ? error.message : String(error)}`,\n { cause: error },\n );\n }\n\n const text = await response.text();\n if (!response.ok) {\n throw new UserProfileError(\n `${method} ${path} failed (${response.status}): ${text.slice(0, 500)}`,\n );\n }\n\n this.log(\"%s %s -> %s\", method, path, response.status);\n return safeJson(text);\n }\n\n private authHeader() {\n return `Basic ${Buffer.from(`${this.publicKey}:${this.secretKey}`).toString(\n \"base64\",\n )}`;\n }\n\n private log(message: string, ...args: unknown[]) {\n if (this.debug) {\n console.log(`[gateway.users] ${message}`, ...args);\n }\n }\n}\n\nfunction parseProfile(payload: Record<string, unknown>): UserProfile {\n return {\n userId: String(payload.userId ?? \"\"),\n displayName:\n typeof payload.displayName === \"string\" ? payload.displayName : null,\n email: typeof payload.email === \"string\" ? payload.email : null,\n attributes: parseAttributes(payload.attributes),\n notes: typeof payload.notes === \"string\" ? payload.notes : null,\n };\n}\n\nfunction parseAttributes(value: unknown): Record<string, string> {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) return {};\n const attributes: Record<string, string> = {};\n for (const [key, entry] of Object.entries(value as Record<string, unknown>)) {\n attributes[key] = String(entry);\n }\n return attributes;\n}\n\nfunction safeJson(value: string): Record<string, unknown> {\n try {\n const parsed = JSON.parse(value);\n return parsed && typeof parsed === \"object\" && !Array.isArray(parsed)\n ? (parsed as Record<string, unknown>)\n : {};\n } catch {\n return {};\n }\n}\n\nexport const users = {\n fromEnv: UsersClient.fromEnv,\n};\n\nexport type {\n UserProfile,\n UserProfileUpdate,\n UsersClientConfig,\n UsersClientFromEnvConfig,\n};\n","/**\n * Initialization and lifecycle management for GatewaySDK tracing.\n *\n * This module provides the core init(), shutdown(), and flush() functions\n * for managing the OpenTelemetry TracerProvider lifecycle, plus\n * initIsolated() for creating additional self-contained providers (e.g. one\n * process exporting different agents to different Gateway projects).\n *\n * Mirrors the Python SDK's tracing.init() for a consistent developer experience.\n */\n\nimport type { Tracer } from \"@opentelemetry/api\";\nimport type { TracingConfig, TracingState } from \"./types\";\nimport { IdentitySpanProcessor } from \"./identity\";\n\n// Environment variable names (support both GATEWAY_* and GATEWAY_* prefixes)\nconst ENV_VARS = {\n HOST: [\"GATEWAY_HOST\", \"GATEWAY_HOST\"],\n PUBLIC_KEY: [\"GATEWAY_PUBLIC_KEY\", \"GATEWAY_PUBLIC_KEY\"],\n SECRET_KEY: [\"GATEWAY_SECRET_KEY\", \"GATEWAY_SECRET_KEY\"],\n ENDPOINT: [\"GATEWAY_OTLP_ENDPOINT\", \"GATEWAY_OTLP_ENDPOINT\"],\n} as const;\n\nconst DEFAULT_OTLP_PATH = \"/api/public/otel/v1/traces\";\n\n// Module-level state\nconst state: TracingState & { debug?: boolean } = {\n initialized: false,\n provider: null,\n};\n\nfunction getEnv(keys: readonly string[]): string | undefined {\n for (const key of keys) {\n const value = process.env[key];\n if (value) return value;\n }\n return undefined;\n}\n\nfunction log(message: string, ...args: unknown[]): void {\n if (state.debug) {\n console.log(`[gatewaysdk.tracing] ${message}`, ...args);\n }\n}\n\nfunction warn(message: string, ...args: unknown[]): void {\n console.warn(`[gatewaysdk.tracing] ${message}`, ...args);\n}\n\ntype LogFn = (message: string, ...args: unknown[]) => void;\n\n/**\n * Handle to an isolated tracing provider created by initIsolated().\n * Spans started from `tracer` export to that provider's Gateway project;\n * the global tracer (from init()) is untouched.\n */\nexport interface TracingHandle {\n tracer: Tracer;\n /** Force-flush pending spans for this provider only. */\n flush(): Promise<void>;\n /** Flush and shut down this provider only. */\n shutdown(): Promise<void>;\n}\n\n/**\n * Build a fully-configured NodeTracerProvider from config + env. Shared by\n * init() (which registers it globally) and initIsolated() (which does not).\n */\n/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\nfunction buildProvider(config: TracingConfig, logFn: LogFn): any {\n // Resolve configuration from params or environment\n const host = config.host ?? getEnv(ENV_VARS.HOST);\n const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);\n const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);\n const endpoint =\n config.endpoint ??\n getEnv(ENV_VARS.ENDPOINT) ??\n (host ? `${host.replace(/\\/$/, \"\")}${DEFAULT_OTLP_PATH}` : undefined);\n\n // Validate required configuration\n const missing: string[] = [];\n if (!host) missing.push(\"host (or GATEWAY_HOST env var)\");\n if (!publicKey) missing.push(\"publicKey (or GATEWAY_PUBLIC_KEY env var)\");\n if (!secretKey) missing.push(\"secretKey (or GATEWAY_SECRET_KEY env var)\");\n\n if (missing.length > 0) {\n throw new Error(\n `Missing required Gateway configuration: ${missing.join(\", \")}. ` +\n \"Provide these values via init() parameters or environment variables.\",\n );\n }\n\n // Dynamically import OpenTelemetry modules (they're peer dependencies)\n // Using 'any' to avoid version conflicts between OTel packages\n let NodeTracerProvider: any;\n let BatchSpanProcessor: any;\n let OTLPTraceExporter: any;\n let createResource: (attrs: Record<string, string>) => any;\n let ATTR_SERVICE_NAME: string;\n\n try {\n const traceNode = require(\"@opentelemetry/sdk-trace-node\");\n const traceBase = require(\"@opentelemetry/sdk-trace-base\");\n const otlpHttp = require(\"@opentelemetry/exporter-trace-otlp-http\");\n const resources = require(\"@opentelemetry/resources\");\n\n NodeTracerProvider = traceNode.NodeTracerProvider;\n BatchSpanProcessor = traceBase.BatchSpanProcessor;\n OTLPTraceExporter = otlpHttp.OTLPTraceExporter;\n\n // Handle both old (Resource class) and new (resourceFromAttributes function) APIs\n if (resources.Resource) {\n createResource = (attrs) => new resources.Resource(attrs);\n } else if (resources.resourceFromAttributes) {\n createResource = resources.resourceFromAttributes;\n } else {\n createResource = () => resources.defaultResource();\n }\n\n // Try semantic conventions, fall back to string literal\n try {\n const semconv = require(\"@opentelemetry/semantic-conventions\");\n ATTR_SERVICE_NAME =\n semconv.ATTR_SERVICE_NAME ?? semconv.SEMRESATTRS_SERVICE_NAME ?? \"service.name\";\n } catch {\n ATTR_SERVICE_NAME = \"service.name\";\n }\n } catch {\n throw new Error(\n \"OpenTelemetry packages not found. Install them with:\\n\" +\n \"npm install @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base \" +\n \"@opentelemetry/exporter-trace-otlp-http @opentelemetry/resources\",\n );\n }\n\n // Build resource attributes\n const resourceAttrs: Record<string, string> = {\n [ATTR_SERVICE_NAME]: config.serviceName ?? \"gatewaysdk-tracing\",\n };\n if (config.environment) {\n resourceAttrs[\"gateway.environment\"] = config.environment;\n }\n if (config.version) {\n resourceAttrs[\"gateway.version\"] = config.version;\n }\n\n // Security check: block insecure HTTP (except localhost/127.0.0.1)\n let isLocalhost = false;\n if (endpoint) {\n try {\n const parsed = new URL(endpoint);\n isLocalhost =\n parsed.hostname === \"localhost\" || parsed.hostname === \"127.0.0.1\";\n } catch {\n isLocalhost = false;\n }\n }\n if (endpoint && !endpoint.startsWith(\"https://\") && !isLocalhost) {\n throw new Error(\n `Refusing to send credentials over insecure HTTP to ${endpoint}. ` +\n \"Use HTTPS or localhost for development.\",\n );\n }\n\n // Construct Basic Auth header\n const credentials = `${publicKey}:${secretKey}`;\n const encoded = Buffer.from(credentials).toString(\"base64\");\n const authHeader = `Basic ${encoded}`;\n\n // Create OTLP exporter\n const exporter = new OTLPTraceExporter({\n url: endpoint,\n headers: {\n Authorization: authHeader,\n },\n });\n\n logFn(\"Configured Gateway exporter: endpoint=%s\", endpoint);\n\n // Build span processors — custom processors go first (before the BatchSpanProcessor)\n const spanProcessors: any[] = [];\n\n if (config.customSpanProcessors) {\n for (const sp of config.customSpanProcessors) {\n spanProcessors.push(sp);\n logFn(\n \"Added custom span processor: %s\",\n (sp as { constructor?: { name?: string } }).constructor?.name ??\n \"unknown\",\n );\n }\n }\n\n // Stamp the ambient end-user identity (identify() / GATEWAY_USER_ID) on\n // every span at start — mirrors the Python SDK's TracingContextSpanProcessor.\n spanProcessors.push(new IdentitySpanProcessor());\n\n // Add BatchSpanProcessor with exporter\n const batchConfig: Record<string, number> = {};\n if (config.batch?.maxQueueSize) {\n batchConfig.maxQueueSize = config.batch.maxQueueSize;\n }\n if (config.batch?.scheduledDelayMillis) {\n batchConfig.scheduledDelayMillis = config.batch.scheduledDelayMillis;\n }\n if (config.batch?.maxExportBatchSize) {\n batchConfig.maxExportBatchSize = config.batch.maxExportBatchSize;\n }\n\n spanProcessors.push(new BatchSpanProcessor(exporter, batchConfig));\n\n // Create provider — detect v1 vs v2 API via runtime feature check.\n // v1 has addSpanProcessor(); v2 removed it and requires spanProcessors in constructor.\n let provider: any = new NodeTracerProvider({\n resource: createResource(resourceAttrs),\n });\n\n if (typeof provider.addSpanProcessor === \"function\") {\n // v1 API: register each processor individually\n for (const sp of spanProcessors) {\n provider.addSpanProcessor(sp);\n }\n } else {\n // v2 API: must pass spanProcessors in constructor — recreate\n provider = new NodeTracerProvider({\n resource: createResource(resourceAttrs),\n spanProcessors,\n });\n }\n\n return provider;\n}\n/* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\n\n/**\n * Initialize GatewaySDK tracing with automatic OpenTelemetry configuration.\n *\n * This function configures OpenTelemetry with a connection to Gateway\n * and sets up the ExperimentSpanProcessor for automatic experiment tagging.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * // Using environment variables (GATEWAY_HOST, GATEWAY_PUBLIC_KEY, GATEWAY_SECRET_KEY)\n * tracing.init();\n *\n * // Or with explicit configuration\n * tracing.init({\n * host: \"https://app.gateway.dev\",\n * publicKey: \"pk-lf-...\",\n * secretKey: \"sk-lf-...\",\n * serviceName: \"my-agent\",\n * environment: \"production\",\n * });\n * ```\n */\nexport function init(config: TracingConfig = {}): void {\n if (state.initialized) {\n log(\"Tracing already initialized. Call shutdown() first to reinitialize.\");\n return;\n }\n\n // Store debug flag in state for log() function\n state.debug = config.debug ?? false;\n\n const provider = buildProvider(config, log);\n provider.register();\n\n state.provider = provider;\n state.initialized = true;\n\n log(\n \"GatewaySDK tracing initialized successfully (service=%s)\",\n config.serviceName ?? \"gatewaysdk-tracing\",\n );\n}\n\n/**\n * Create an ISOLATED tracing provider that is NOT registered globally.\n *\n * Use this when one process must export different work to different Gateway\n * projects (e.g. a server hosting several agents, each with its own project\n * keys), or when the process already has its own global OpenTelemetry\n * provider that must not be replaced.\n *\n * Spans only reach the isolated provider when started from its `tracer` —\n * pass it explicitly to observe()/observeClaude() via their `tracer` option,\n * or to a framework's telemetry hook (e.g. the Vercel AI SDK's\n * `experimental_telemetry.tracer`). Context propagation still works across\n * providers, so nesting behaves exactly as with init().\n *\n * Can be called any number of times; each handle has its own exporter,\n * batch queue, and lifecycle.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * const support = tracing.initIsolated({\n * host: \"https://app.gateway.dev\",\n * publicKey: \"pk-lf-support...\",\n * secretKey: \"sk-lf-support...\",\n * serviceName: \"support-agent\",\n * });\n *\n * await tracing.observe(\"support.run\", run, { tracer: support.tracer });\n * await support.flush();\n * ```\n */\nexport function initIsolated(config: TracingConfig = {}): TracingHandle {\n const debugLog: LogFn = config.debug\n ? (message, ...args) =>\n console.log(`[gatewaysdk.tracing:isolated] ${message}`, ...args)\n : () => {};\n\n const provider = buildProvider(config, debugLog);\n const tracer = provider.getTracer(\"@withgateway/sdk\") as Tracer;\n\n debugLog(\n \"Isolated tracing provider created (service=%s)\",\n config.serviceName ?? \"gatewaysdk-tracing\",\n );\n\n return {\n tracer,\n async flush() {\n try {\n await (provider as { forceFlush: () => Promise<void> }).forceFlush();\n } catch (e) {\n warn(\"Error during isolated flush:\", e);\n }\n },\n async shutdown() {\n try {\n await (provider as { shutdown: () => Promise<void> }).shutdown();\n } catch (e) {\n warn(\"Error during isolated shutdown:\", e);\n }\n },\n };\n}\n\n/**\n * Force flush all pending spans without shutting down.\n *\n * Useful for ensuring spans are exported at specific points\n * (e.g., after completing a batch of work) without ending the tracing session.\n *\n * @returns Promise that resolves when flush completes\n */\nexport async function flush(): Promise<void> {\n if (!state.provider) {\n log(\"No provider to flush\");\n return;\n }\n\n try {\n await (state.provider as { forceFlush: () => Promise<void> }).forceFlush();\n log(\"Flush completed successfully\");\n } catch (e) {\n warn(\"Error during flush:\", e);\n }\n}\n\n/**\n * Force flush all pending spans and shutdown the tracer provider.\n *\n * This function should be called before process exit to ensure all spans\n * are exported. It is safe to call multiple times.\n *\n * @example\n * ```typescript\n * import { tracing } from \"@withgateway/sdk\";\n *\n * tracing.init();\n *\n * // On shutdown\n * process.on(\"SIGTERM\", async () => {\n * await tracing.shutdown();\n * process.exit(0);\n * });\n * ```\n */\nexport async function shutdown(): Promise<void> {\n if (!state.initialized || !state.provider) {\n log(\"Tracing not initialized, nothing to shutdown\");\n return;\n }\n\n try {\n await (state.provider as { shutdown: () => Promise<void> }).shutdown();\n log(\"Shutdown complete\");\n } catch (e) {\n warn(\"Error during shutdown:\", e);\n }\n\n state.provider = null;\n state.initialized = false;\n}\n\n/**\n * Check if tracing has been initialized.\n */\nexport function isInitialized(): boolean {\n return state.initialized;\n}\n\n/**\n * Check if Gateway is configured via environment variables.\n */\nexport function isGatewayConfigured(): boolean {\n const host = getEnv(ENV_VARS.HOST);\n const publicKey = getEnv(ENV_VARS.PUBLIC_KEY);\n const secretKey = getEnv(ENV_VARS.SECRET_KEY);\n return !!(host && publicKey && secretKey);\n}\n","/**\n * observe() — group a unit of work (an agent run, a tool call) into a single\n * span so nested LLM/tool spans attach to it and the whole thing is one trace.\n *\n * Mirrors Langfuse's `observe()` / `startActiveObservation()`. This is what an\n * app uses to define a trace boundary when it drives a raw client loop (which\n * has no framework root span of its own): the callback runs inside the span's\n * OpenTelemetry context, so any auto-instrumented calls (see observeOpenAI) and\n * any nested observe() calls become children of it.\n *\n * The span carries OpenInference attributes (openinference.span.kind, input.value,\n * output.value), and Gateway maps a root span's input.value/output.value to the\n * trace-level input/output — so the trace shows the user input and final output.\n */\nimport { trace, context, SpanStatusCode } from \"@opentelemetry/api\";\nimport type { Tracer } from \"@opentelemetry/api\";\n\nexport type ObservationKind = \"AGENT\" | \"CHAIN\" | \"TOOL\" | \"LLM\" | \"RETRIEVER\";\n\nexport interface ObserveOptions {\n /** Recorded as input.value on the span (JSON-stringified if not a string). */\n input?: unknown;\n /** OpenInference span kind. Defaults to \"AGENT\" for the outer run. */\n kind?: ObservationKind;\n /**\n * When true (default), the callback's return value is recorded as\n * output.value. Set false if the return value is large/uninteresting.\n */\n captureOutput?: boolean;\n /**\n * Tracer to start the span from. Defaults to the GLOBAL tracer (set up by\n * tracing.init()). Pass an initIsolated() handle's tracer to route this\n * observation to that handle's Gateway project instead.\n */\n tracer?: Tracer;\n /**\n * Extra attributes for the span — e.g. gateway.session.id /\n * gateway.user.id to group runs into a session and attribute them to a user.\n */\n attributes?: Record<string, string>;\n}\n\nfunction asAttr(value: unknown): string {\n return typeof value === \"string\" ? value : JSON.stringify(value);\n}\n\n/**\n * Run `fn` inside a span named `name`. Anything traced inside (auto-instrumented\n * client calls, nested observe() calls) nests under it, forming one trace.\n *\n * @example\n * ```ts\n * const result = await observe(\"my-agent.run\", async () => {\n * // client.chat.completions.create(...) here becomes a child GENERATION\n * return finalText;\n * }, { input: prompt });\n * ```\n */\nexport async function observe<T>(\n name: string,\n fn: () => Promise<T>,\n options: ObserveOptions = {},\n): Promise<T> {\n const tracer = options.tracer ?? trace.getTracer(\"@withgateway/sdk\");\n const span = tracer.startSpan(name, {\n attributes: {\n \"openinference.span.kind\": options.kind ?? \"AGENT\",\n ...(options.input !== undefined\n ? { \"input.value\": asAttr(options.input) }\n : {}),\n ...(options.attributes ?? {}),\n },\n });\n\n try {\n const result = await context.with(\n trace.setSpan(context.active(), span),\n fn,\n );\n if (options.captureOutput !== false && result !== undefined) {\n span.setAttribute(\"output.value\", asAttr(result));\n }\n span.setStatus({ code: SpanStatusCode.OK });\n return result;\n } catch (error) {\n span.setStatus({\n code: SpanStatusCode.ERROR,\n message: error instanceof Error ? error.message : String(error),\n });\n throw error;\n } finally {\n span.end();\n }\n}\n","/**\n * Client wrappers that turn an SDK's calls into spans on the Gateway provider.\n *\n * Node ESM can't retroactively patch a module the app already imported, so — as\n * Langfuse does with `observeOpenAI` — the app hands us the client and we\n * instrument it explicitly. One SDK call, no OpenTelemetry in the app.\n *\n * The OpenInference instrumentations are bundled optional deps of this package;\n * we load them with require() (the ESM build injects a real createRequire).\n */\n/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports */\n\nfunction warn(message: string, ...args: unknown[]): void {\n console.warn(`[gatewaysdk.tracing] ${message}`, ...args);\n}\n\n/**\n * Instrument an OpenAI client so its requests become GENERATION spans on the\n * Gateway provider. Returns the same client (its class prototype is patched, so\n * this and every other instance of that client are traced).\n *\n * @example\n * ```ts\n * import OpenAI from \"openai\";\n * import { init, observeOpenAI } from \"@withgateway/sdk/tracing\";\n * init();\n * const client = observeOpenAI(new OpenAI());\n * ```\n */\nexport function observeOpenAI<T extends object>(client: T): T {\n try {\n const {\n OpenAIInstrumentation,\n } = require(\"@arizeai/openinference-instrumentation-openai\");\n // OpenInference patches `module.OpenAI.Chat.Completions.prototype`, so it\n // needs an object shaped like the openai module. Reconstruct it from the\n // instance's class (client.constructor === the OpenAI class).\n const OpenAIClass = (client as { constructor: unknown }).constructor;\n new OpenAIInstrumentation().manuallyInstrument({ OpenAI: OpenAIClass });\n } catch (error) {\n warn(\n \"observeOpenAI: could not load @arizeai/openinference-instrumentation-openai — OpenAI calls will not be traced.\",\n error,\n );\n }\n return client;\n}\n\n/**\n * Instrument an Anthropic client so its requests become GENERATION spans.\n *\n * @example\n * ```ts\n * import Anthropic from \"@anthropic-ai/sdk\";\n * import { init, observeAnthropic } from \"@withgateway/sdk/tracing\";\n * init();\n * const client = observeAnthropic(new Anthropic());\n * ```\n */\nexport function observeAnthropic<T extends object>(client: T): T {\n try {\n const {\n AnthropicInstrumentation,\n } = require(\"@arizeai/openinference-instrumentation-anthropic\");\n // The instrumentor patches `module.Messages.prototype.create`, so it wants\n // an object whose `Messages` is the Anthropic client's Messages class (a\n // static on the class). `client.messages` resolves `create` through that\n // prototype, so patching it traces this client and every other instance.\n const AnthropicClass = (client as { constructor: { Messages?: unknown } })\n .constructor;\n new AnthropicInstrumentation().manuallyInstrument({\n Messages: AnthropicClass.Messages,\n });\n } catch (error) {\n warn(\n \"observeAnthropic: could not load @arizeai/openinference-instrumentation-anthropic — Anthropic calls will not be traced.\",\n error,\n );\n }\n return client;\n}\n","/**\n * observeClaude() — trace a Claude Agent SDK run.\n *\n * The Claude Agent SDK runs the agent in a separate `claude` CLI subprocess, so\n * there's nothing in-process to patch. What the app has is the message stream it\n * iterates. Wrap that stream with observeClaude() and it yields the same\n * messages unchanged while emitting spans on the Gateway provider:\n *\n * AGENT (root)\n * ├─ GENERATION per assistant turn (with per-turn token usage)\n * └─ TOOL per tool call (input from tool_use, output from the\n * matching tool_result, matched by id)\n *\n * The TS equivalent of the Python SDK's claude-agent-sdk instrumentor.\n *\n * @example\n * ```ts\n * const stream = query({ prompt, options });\n * for await (const message of observeClaude(stream, { name, input: prompt })) {\n * // ...consume messages as usual\n * }\n * ```\n */\nimport {\n trace,\n context,\n SpanStatusCode,\n type Span,\n type Context,\n type Tracer,\n} from \"@opentelemetry/api\";\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nexport interface ObserveClaudeOptions {\n /** Root span name (becomes the trace name). */\n name: string;\n /** Recorded as input.value on the root span → trace-level input. */\n input?: string;\n /** Model label for the generation spans. */\n model?: string;\n /**\n * Tracer to start spans from. Defaults to the GLOBAL tracer (set up by\n * tracing.init()). Pass an initIsolated() handle's tracer to route this\n * run to that handle's Gateway project instead.\n */\n tracer?: Tracer;\n /**\n * Extra attributes for the ROOT span — e.g. gateway.session.id /\n * gateway.user.id to group runs into a session and attribute them to a user.\n */\n attributes?: Record<string, string>;\n}\n\n/** Strip the `mcp__<server>__` prefix so tool names read cleanly. */\nfunction cleanToolName(name: string): string {\n return name.replace(/^mcp__[^_]+__/, \"\");\n}\n\nfunction toolResultText(content: unknown): string {\n if (typeof content === \"string\") return content;\n if (Array.isArray(content))\n return content\n .map((b) =>\n b && typeof b === \"object\" && \"text\" in b\n ? String((b as { text: unknown }).text)\n : JSON.stringify(b),\n )\n .join(\"\");\n return JSON.stringify(content ?? \"\");\n}\n\nexport async function* observeClaude(\n stream: AsyncIterable<any>,\n options: ObserveClaudeOptions,\n): AsyncGenerator<any> {\n const tracer = options.tracer ?? trace.getTracer(\"@withgateway/sdk\");\n const root: Span = tracer.startSpan(options.name, {\n attributes: {\n \"openinference.span.kind\": \"AGENT\",\n ...(options.input !== undefined ? { \"input.value\": options.input } : {}),\n ...(options.attributes ?? {}),\n },\n });\n const rootCtx: Context = trace.setSpan(context.active(), root);\n const openTools = new Map<string, Span>();\n const model = options.model ?? \"claude\";\n let finalText = \"\";\n\n try {\n for await (const message of stream) {\n if (message?.type === \"assistant\") {\n let turnText = \"\";\n const toolUses: Array<{ id: string; name: string; input: unknown }> = [];\n for (const block of message.message?.content ?? []) {\n if (block?.type === \"text\") {\n finalText += block.text;\n turnText += block.text;\n }\n if (block?.type === \"tool_use\") {\n toolUses.push({ id: block.id, name: block.name, input: block.input });\n }\n }\n const gen = tracer.startSpan(\n \"assistant\",\n {\n attributes: {\n \"openinference.span.kind\": \"LLM\",\n \"llm.model_name\": model,\n \"llm.provider\": \"anthropic\",\n \"output.value\":\n turnText ||\n toolUses.map((t) => `→ ${cleanToolName(t.name)}`).join(\", \"),\n },\n },\n rootCtx,\n );\n const usage = message.message?.usage;\n if (usage?.input_tokens != null)\n gen.setAttribute(\"llm.token_count.prompt\", usage.input_tokens);\n if (usage?.output_tokens != null)\n gen.setAttribute(\"llm.token_count.completion\", usage.output_tokens);\n gen.end();\n\n for (const t of toolUses) {\n const span = tracer.startSpan(\n `tool.${cleanToolName(t.name)}`,\n {\n attributes: {\n \"openinference.span.kind\": \"TOOL\",\n \"tool.name\": cleanToolName(t.name),\n \"input.value\": JSON.stringify(t.input),\n },\n },\n rootCtx,\n );\n openTools.set(t.id, span);\n }\n }\n\n // tool_result (in a `user` message) closes the matching TOOL span.\n if (message?.type === \"user\") {\n const content = message.message?.content;\n if (Array.isArray(content)) {\n for (const block of content) {\n if (block?.type === \"tool_result\") {\n const span = openTools.get(block.tool_use_id);\n if (span) {\n span.setAttribute(\"output.value\", toolResultText(block.content));\n span.setStatus({ code: SpanStatusCode.OK });\n span.end();\n openTools.delete(block.tool_use_id);\n }\n }\n }\n }\n }\n\n yield message;\n }\n } finally {\n for (const span of openTools.values()) span.end();\n openTools.clear();\n root.setAttribute(\"output.value\", finalText);\n root.setStatus({ code: SpanStatusCode.OK });\n root.end();\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACiBA,yBAAkC;AAClC,iBAA0C;;;ACqCnC,IAAM,mBAAN,cAA+B,MAAM;AAAA,EAC1C,YAAY,SAAiB,SAA+B;AAC1D,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,QAAQ,SAAS;AAAA,EACxB;AACF;AAGO,IAAM,cAAN,MAAM,aAAY;AAAA,EACN;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,QAA2B;AACrC,SAAK,OAAO,OAAO,KAAK,QAAQ,OAAO,EAAE;AACzC,SAAK,YAAY,OAAO;AACxB,SAAK,YAAY,OAAO;AACxB,SAAK,iBAAiB,OAAO,kBAAkB;AAC/C,SAAK,QAAQ,OAAO,SAAS;AAAA,EAC/B;AAAA;AAAA,EAGA,OAAO,QAAQ,SAAmC,CAAC,GAAG;AACpD,UAAM,OAAO,OAAO,QAAQ,QAAQ,IAAI;AACxC,UAAM,YAAY,OAAO,aAAa,QAAQ,IAAI;AAClD,UAAM,YAAY,OAAO,aAAa,QAAQ,IAAI;AAElD,UAAM,UAAU;AAAA,MACd,CAAC,QAAQ,IAAI;AAAA,MACb,CAAC,aAAa,SAAS;AAAA,MACvB,CAAC,aAAa,SAAS;AAAA,IACzB,EACG,OAAO,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,EAC5B,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI;AAEvB,QAAI,QAAQ,SAAS,GAAG;AACtB,YAAM,IAAI;AAAA,QACR,+CAA+C,QAAQ,KAAK,IAAI,CAAC;AAAA,MACnE;AAAA,IACF;AAEA,WAAO,IAAI,aAAY;AAAA,MACrB,GAAG;AAAA,MACH;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,IAAI,QAAsC;AAC9C,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,QACT;AAAA,QACA,6BAA6B,mBAAmB,MAAM,CAAC;AAAA,MACzD;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OACJ,QACA,SAA4B,CAAC,GACP;AACtB,UAAM,OAAgC;AAAA,MACpC;AAAA,MACA,YAAY,OAAO,cAAc,CAAC;AAAA,MAClC,iBAAiB,OAAO,SAAS;AAAA,MACjC,GAAI,OAAO,gBAAgB,SACvB,EAAE,aAAa,OAAO,YAAY,IAClC,CAAC;AAAA,MACL,GAAI,OAAO,UAAU,SAAY,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,MAC5D,GAAI,OAAO,UAAU,SAAY,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,IAC9D;AACA,WAAO;AAAA,MACL,MAAM,KAAK,YAAY,QAAQ,6BAA6B,IAAI;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,MAAc,YACZ,QACA,MACA,SACkC;AAClC,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,MAAM,GAAG,KAAK,IAAI,GAAG,IAAI,IAAI;AAAA,QAC5C;AAAA,QACA,SAAS;AAAA,UACP,eAAe,KAAK,WAAW;AAAA,UAC/B,gBAAgB;AAAA,QAClB;AAAA,QACA,GAAI,UAAU,EAAE,MAAM,KAAK,UAAU,OAAO,EAAE,IAAI,CAAC;AAAA,QACnD,QAAQ,YAAY,QAAQ,KAAK,iBAAiB,GAAI;AAAA,MACxD,CAAC;AAAA,IACH,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,GAAG,MAAM,IAAI,IAAI,YAAY,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QACnF,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAEA,UAAM,OAAO,MAAM,SAAS,KAAK;AACjC,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI;AAAA,QACR,GAAG,MAAM,IAAI,IAAI,YAAY,SAAS,MAAM,MAAM,KAAK,MAAM,GAAG,GAAG,CAAC;AAAA,MACtE;AAAA,IACF;AAEA,SAAK,IAAI,eAAe,QAAQ,MAAM,SAAS,MAAM;AACrD,WAAO,SAAS,IAAI;AAAA,EACtB;AAAA,EAEQ,aAAa;AACnB,WAAO,SAAS,OAAO,KAAK,GAAG,KAAK,SAAS,IAAI,KAAK,SAAS,EAAE,EAAE;AAAA,MACjE;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEQ,IAAI,YAAoB,MAAiB;AAC/C,QAAI,KAAK,OAAO;AACd,cAAQ,IAAI,mBAAmB,OAAO,IAAI,GAAG,IAAI;AAAA,IACnD;AAAA,EACF;AACF;AAEA,SAAS,aAAa,SAA+C;AACnE,SAAO;AAAA,IACL,QAAQ,OAAO,QAAQ,UAAU,EAAE;AAAA,IACnC,aACE,OAAO,QAAQ,gBAAgB,WAAW,QAAQ,cAAc;AAAA,IAClE,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ;AAAA,IAC3D,YAAY,gBAAgB,QAAQ,UAAU;AAAA,IAC9C,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ;AAAA,EAC7D;AACF;AAEA,SAAS,gBAAgB,OAAwC;AAC/D,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACzE,QAAM,aAAqC,CAAC;AAC5C,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAgC,GAAG;AAC3E,eAAW,GAAG,IAAI,OAAO,KAAK;AAAA,EAChC;AACA,SAAO;AACT;AAEA,SAAS,SAAS,OAAwC;AACxD,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,WAAO,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,MAAM,IAC/D,SACD,CAAC;AAAA,EACP,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEO,IAAM,QAAQ;AAAA,EACnB,SAAS,YAAY;AACvB;;;ADjMO,IAAM,oBAAoB;AAIjC,IAAM,qBAAqB,IAAI,qCAA0B;AASlD,SAAS,gBAAoC;AAClD,QAAM,aAAa,mBAAmB,SAAS;AAC/C,MAAI,WAAY,QAAO;AACvB,QAAM,UAAU,QAAQ,IAAI,iBAAiB,KAAK;AAClD,SAAO,UAAU,UAAU;AAC7B;AA8BO,SAAS,SAAS,QAAgB,UAA2B,CAAC,GAAS;AAC5E,QAAM,UAAU,OAAO,KAAK;AAC5B,MAAI,CAAC,QAAS;AAEd,qBAAmB,UAAU,OAAO;AAIpC,MAAI;AACF,UAAM,OAAO,iBAAM,cAAc;AACjC,QAAI,YAAQ,+BAAmB,KAAK,YAAY,CAAC,GAAG;AAClD,WAAK,aAAa,mBAAmB,OAAO;AAAA,IAC9C;AAAA,EACF,SAAS,OAAO;AACd,aAAS,uCAAuC,KAAK;AAAA,EACvD;AAEA,MAAI,QAAQ,cAAc,QAAQ,eAAe,QAAQ,OAAO;AAC9D,SAAK,YAAY,SAAS,OAAO;AAAA,EACnC;AACF;AAEA,eAAe,YACb,QACA,SACe;AACf,MAAI;AACF,UAAM,aAAqC,CAAC;AAC5C,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,cAAc,CAAC,CAAC,GAAG;AACnE,iBAAW,GAAG,IAAI,OAAO,KAAK;AAAA,IAChC;AACA,UAAM,YAAY,QAAQ,EAAE,OAAO,QAAQ;AAAA,MACzC,GAAI,QAAQ,gBAAgB,SACxB,EAAE,aAAa,QAAQ,YAAY,IACnC,CAAC;AAAA,MACL,GAAI,QAAQ,UAAU,SAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,MAC9D;AAAA,IACF,CAAC;AAAA,EACH,SAAS,OAAO;AACd,aAAS,qCAAqC,KAAK;AAAA,EACrD;AACF;AAGO,SAAS,mBAAyB;AACvC,qBAAmB,UAAU,MAA8B;AAC7D;AAQO,IAAM,wBAAN,MAAqD;AAAA,EAC1D,QAAQ,MAAY,gBAA+B;AACjD,UAAM,SAAS,cAAc;AAC7B,QAAI,QAAQ;AACV,WAAK,aAAa,mBAAmB,MAAM;AAAA,IAC7C;AAAA,EACF;AAAA,EAEA,MAAM,OAA2B;AAAA,EAAC;AAAA,EAElC,MAAM,WAA0B;AAAA,EAAC;AAAA,EAEjC,MAAM,aAA4B;AAAA,EAAC;AACrC;AAEA,SAAS,SAAS,YAAoB,MAAuB;AAC3D,MAAI,QAAQ,IAAI,eAAe;AAC7B,YAAQ,MAAM,wBAAwB,OAAO,IAAI,GAAG,IAAI;AAAA,EAC1D;AACF;;;AEpIA,IAAM,WAAW;AAAA,EACf,MAAM,CAAC,gBAAgB,cAAc;AAAA,EACrC,YAAY,CAAC,sBAAsB,oBAAoB;AAAA,EACvD,YAAY,CAAC,sBAAsB,oBAAoB;AAAA,EACvD,UAAU,CAAC,yBAAyB,uBAAuB;AAC7D;AAEA,IAAM,oBAAoB;AAG1B,IAAM,QAA4C;AAAA,EAChD,aAAa;AAAA,EACb,UAAU;AACZ;AAEA,SAAS,OAAO,MAA6C;AAC3D,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,QAAI,MAAO,QAAO;AAAA,EACpB;AACA,SAAO;AACT;AAEA,SAAS,IAAI,YAAoB,MAAuB;AACtD,MAAI,MAAM,OAAO;AACf,YAAQ,IAAI,wBAAwB,OAAO,IAAI,GAAG,IAAI;AAAA,EACxD;AACF;AAEA,SAAS,KAAK,YAAoB,MAAuB;AACvD,UAAQ,KAAK,wBAAwB,OAAO,IAAI,GAAG,IAAI;AACzD;AAsBA,SAAS,cAAc,QAAuB,OAAmB;AAE/D,QAAM,OAAO,OAAO,QAAQ,OAAO,SAAS,IAAI;AAChD,QAAM,YAAY,OAAO,aAAa,OAAO,SAAS,UAAU;AAChE,QAAM,YAAY,OAAO,aAAa,OAAO,SAAS,UAAU;AAChE,QAAM,WACJ,OAAO,YACP,OAAO,SAAS,QAAQ,MACvB,OAAO,GAAG,KAAK,QAAQ,OAAO,EAAE,CAAC,GAAG,iBAAiB,KAAK;AAG7D,QAAM,UAAoB,CAAC;AAC3B,MAAI,CAAC,KAAM,SAAQ,KAAK,gCAAgC;AACxD,MAAI,CAAC,UAAW,SAAQ,KAAK,2CAA2C;AACxE,MAAI,CAAC,UAAW,SAAQ,KAAK,2CAA2C;AAExE,MAAI,QAAQ,SAAS,GAAG;AACtB,UAAM,IAAI;AAAA,MACR,2CAA2C,QAAQ,KAAK,IAAI,CAAC;AAAA,IAE/D;AAAA,EACF;AAIA,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,MAAI;AAEJ,MAAI;AACF,UAAM,YAAY,QAAQ,+BAA+B;AACzD,UAAM,YAAY,QAAQ,+BAA+B;AACzD,UAAM,WAAW,QAAQ,yCAAyC;AAClE,UAAM,YAAY,QAAQ,0BAA0B;AAEpD,yBAAqB,UAAU;AAC/B,yBAAqB,UAAU;AAC/B,wBAAoB,SAAS;AAG7B,QAAI,UAAU,UAAU;AACtB,uBAAiB,CAAC,UAAU,IAAI,UAAU,SAAS,KAAK;AAAA,IAC1D,WAAW,UAAU,wBAAwB;AAC3C,uBAAiB,UAAU;AAAA,IAC7B,OAAO;AACL,uBAAiB,MAAM,UAAU,gBAAgB;AAAA,IACnD;AAGA,QAAI;AACF,YAAM,UAAU,QAAQ,qCAAqC;AAC7D,0BACE,QAAQ,qBAAqB,QAAQ,4BAA4B;AAAA,IACrE,QAAQ;AACN,0BAAoB;AAAA,IACtB;AAAA,EACF,QAAQ;AACN,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AAGA,QAAM,gBAAwC;AAAA,IAC5C,CAAC,iBAAiB,GAAG,OAAO,eAAe;AAAA,EAC7C;AACA,MAAI,OAAO,aAAa;AACtB,kBAAc,qBAAqB,IAAI,OAAO;AAAA,EAChD;AACA,MAAI,OAAO,SAAS;AAClB,kBAAc,iBAAiB,IAAI,OAAO;AAAA,EAC5C;AAGA,MAAI,cAAc;AAClB,MAAI,UAAU;AACZ,QAAI;AACF,YAAM,SAAS,IAAI,IAAI,QAAQ;AAC/B,oBACE,OAAO,aAAa,eAAe,OAAO,aAAa;AAAA,IAC3D,QAAQ;AACN,oBAAc;AAAA,IAChB;AAAA,EACF;AACA,MAAI,YAAY,CAAC,SAAS,WAAW,UAAU,KAAK,CAAC,aAAa;AAChE,UAAM,IAAI;AAAA,MACR,sDAAsD,QAAQ;AAAA,IAEhE;AAAA,EACF;AAGA,QAAM,cAAc,GAAG,SAAS,IAAI,SAAS;AAC7C,QAAM,UAAU,OAAO,KAAK,WAAW,EAAE,SAAS,QAAQ;AAC1D,QAAM,aAAa,SAAS,OAAO;AAGnC,QAAM,WAAW,IAAI,kBAAkB;AAAA,IACrC,KAAK;AAAA,IACL,SAAS;AAAA,MACP,eAAe;AAAA,IACjB;AAAA,EACF,CAAC;AAED,QAAM,4CAA4C,QAAQ;AAG1D,QAAM,iBAAwB,CAAC;AAE/B,MAAI,OAAO,sBAAsB;AAC/B,eAAW,MAAM,OAAO,sBAAsB;AAC5C,qBAAe,KAAK,EAAE;AACtB;AAAA,QACE;AAAA,QACC,GAA2C,aAAa,QACvD;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AAIA,iBAAe,KAAK,IAAI,sBAAsB,CAAC;AAG/C,QAAM,cAAsC,CAAC;AAC7C,MAAI,OAAO,OAAO,cAAc;AAC9B,gBAAY,eAAe,OAAO,MAAM;AAAA,EAC1C;AACA,MAAI,OAAO,OAAO,sBAAsB;AACtC,gBAAY,uBAAuB,OAAO,MAAM;AAAA,EAClD;AACA,MAAI,OAAO,OAAO,oBAAoB;AACpC,gBAAY,qBAAqB,OAAO,MAAM;AAAA,EAChD;AAEA,iBAAe,KAAK,IAAI,mBAAmB,UAAU,WAAW,CAAC;AAIjE,MAAI,WAAgB,IAAI,mBAAmB;AAAA,IACzC,UAAU,eAAe,aAAa;AAAA,EACxC,CAAC;AAED,MAAI,OAAO,SAAS,qBAAqB,YAAY;AAEnD,eAAW,MAAM,gBAAgB;AAC/B,eAAS,iBAAiB,EAAE;AAAA,IAC9B;AAAA,EACF,OAAO;AAEL,eAAW,IAAI,mBAAmB;AAAA,MAChC,UAAU,eAAe,aAAa;AAAA,MACtC;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AA0BO,SAAS,KAAK,SAAwB,CAAC,GAAS;AACrD,MAAI,MAAM,aAAa;AACrB,QAAI,qEAAqE;AACzE;AAAA,EACF;AAGA,QAAM,QAAQ,OAAO,SAAS;AAE9B,QAAM,WAAW,cAAc,QAAQ,GAAG;AAC1C,WAAS,SAAS;AAElB,QAAM,WAAW;AACjB,QAAM,cAAc;AAEpB;AAAA,IACE;AAAA,IACA,OAAO,eAAe;AAAA,EACxB;AACF;AAkCO,SAAS,aAAa,SAAwB,CAAC,GAAkB;AACtE,QAAMA,YAAkB,OAAO,QAC3B,CAAC,YAAY,SACX,QAAQ,IAAI,iCAAiC,OAAO,IAAI,GAAG,IAAI,IACjE,MAAM;AAAA,EAAC;AAEX,QAAM,WAAW,cAAc,QAAQA,SAAQ;AAC/C,QAAM,SAAS,SAAS,UAAU,kBAAkB;AAEpD,EAAAA;AAAA,IACE;AAAA,IACA,OAAO,eAAe;AAAA,EACxB;AAEA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,QAAQ;AACZ,UAAI;AACF,cAAO,SAAiD,WAAW;AAAA,MACrE,SAAS,GAAG;AACV,aAAK,gCAAgC,CAAC;AAAA,MACxC;AAAA,IACF;AAAA,IACA,MAAM,WAAW;AACf,UAAI;AACF,cAAO,SAA+C,SAAS;AAAA,MACjE,SAAS,GAAG;AACV,aAAK,mCAAmC,CAAC;AAAA,MAC3C;AAAA,IACF;AAAA,EACF;AACF;AAUA,eAAsB,QAAuB;AAC3C,MAAI,CAAC,MAAM,UAAU;AACnB,QAAI,sBAAsB;AAC1B;AAAA,EACF;AAEA,MAAI;AACF,UAAO,MAAM,SAAiD,WAAW;AACzE,QAAI,8BAA8B;AAAA,EACpC,SAAS,GAAG;AACV,SAAK,uBAAuB,CAAC;AAAA,EAC/B;AACF;AAqBA,eAAsB,WAA0B;AAC9C,MAAI,CAAC,MAAM,eAAe,CAAC,MAAM,UAAU;AACzC,QAAI,8CAA8C;AAClD;AAAA,EACF;AAEA,MAAI;AACF,UAAO,MAAM,SAA+C,SAAS;AACrE,QAAI,mBAAmB;AAAA,EACzB,SAAS,GAAG;AACV,SAAK,0BAA0B,CAAC;AAAA,EAClC;AAEA,QAAM,WAAW;AACjB,QAAM,cAAc;AACtB;AAKO,SAAS,gBAAyB;AACvC,SAAO,MAAM;AACf;AAKO,SAAS,sBAA+B;AAC7C,QAAM,OAAO,OAAO,SAAS,IAAI;AACjC,QAAM,YAAY,OAAO,SAAS,UAAU;AAC5C,QAAM,YAAY,OAAO,SAAS,UAAU;AAC5C,SAAO,CAAC,EAAE,QAAQ,aAAa;AACjC;;;AClZA,IAAAC,cAA+C;AA4B/C,SAAS,OAAO,OAAwB;AACtC,SAAO,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,KAAK;AACjE;AAcA,eAAsB,QACpB,MACA,IACA,UAA0B,CAAC,GACf;AACZ,QAAM,SAAS,QAAQ,UAAU,kBAAM,UAAU,kBAAkB;AACnE,QAAM,OAAO,OAAO,UAAU,MAAM;AAAA,IAClC,YAAY;AAAA,MACV,2BAA2B,QAAQ,QAAQ;AAAA,MAC3C,GAAI,QAAQ,UAAU,SAClB,EAAE,eAAe,OAAO,QAAQ,KAAK,EAAE,IACvC,CAAC;AAAA,MACL,GAAI,QAAQ,cAAc,CAAC;AAAA,IAC7B;AAAA,EACF,CAAC;AAED,MAAI;AACF,UAAM,SAAS,MAAM,oBAAQ;AAAA,MAC3B,kBAAM,QAAQ,oBAAQ,OAAO,GAAG,IAAI;AAAA,MACpC;AAAA,IACF;AACA,QAAI,QAAQ,kBAAkB,SAAS,WAAW,QAAW;AAC3D,WAAK,aAAa,gBAAgB,OAAO,MAAM,CAAC;AAAA,IAClD;AACA,SAAK,UAAU,EAAE,MAAM,2BAAe,GAAG,CAAC;AAC1C,WAAO;AAAA,EACT,SAAS,OAAO;AACd,SAAK,UAAU;AAAA,MACb,MAAM,2BAAe;AAAA,MACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,IAChE,CAAC;AACD,UAAM;AAAA,EACR,UAAE;AACA,SAAK,IAAI;AAAA,EACX;AACF;;;ACjFA,SAASC,MAAK,YAAoB,MAAuB;AACvD,UAAQ,KAAK,wBAAwB,OAAO,IAAI,GAAG,IAAI;AACzD;AAeO,SAAS,cAAgC,QAAc;AAC5D,MAAI;AACF,UAAM;AAAA,MACJ;AAAA,IACF,IAAI,QAAQ,+CAA+C;AAI3D,UAAM,cAAe,OAAoC;AACzD,QAAI,sBAAsB,EAAE,mBAAmB,EAAE,QAAQ,YAAY,CAAC;AAAA,EACxE,SAAS,OAAO;AACd,IAAAA;AAAA,MACE;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAaO,SAAS,iBAAmC,QAAc;AAC/D,MAAI;AACF,UAAM;AAAA,MACJ;AAAA,IACF,IAAI,QAAQ,kDAAkD;AAK9D,UAAM,iBAAkB,OACrB;AACH,QAAI,yBAAyB,EAAE,mBAAmB;AAAA,MAChD,UAAU,eAAe;AAAA,IAC3B,CAAC;AAAA,EACH,SAAS,OAAO;AACd,IAAAA;AAAA,MACE;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ACzDA,IAAAC,cAOO;AAyBP,SAAS,cAAc,MAAsB;AAC3C,SAAO,KAAK,QAAQ,iBAAiB,EAAE;AACzC;AAEA,SAAS,eAAe,SAA0B;AAChD,MAAI,OAAO,YAAY,SAAU,QAAO;AACxC,MAAI,MAAM,QAAQ,OAAO;AACvB,WAAO,QACJ;AAAA,MAAI,CAAC,MACJ,KAAK,OAAO,MAAM,YAAY,UAAU,IACpC,OAAQ,EAAwB,IAAI,IACpC,KAAK,UAAU,CAAC;AAAA,IACtB,EACC,KAAK,EAAE;AACZ,SAAO,KAAK,UAAU,WAAW,EAAE;AACrC;AAEA,gBAAuB,cACrB,QACA,SACqB;AACrB,QAAM,SAAS,QAAQ,UAAU,kBAAM,UAAU,kBAAkB;AACnE,QAAM,OAAa,OAAO,UAAU,QAAQ,MAAM;AAAA,IAChD,YAAY;AAAA,MACV,2BAA2B;AAAA,MAC3B,GAAI,QAAQ,UAAU,SAAY,EAAE,eAAe,QAAQ,MAAM,IAAI,CAAC;AAAA,MACtE,GAAI,QAAQ,cAAc,CAAC;AAAA,IAC7B;AAAA,EACF,CAAC;AACD,QAAM,UAAmB,kBAAM,QAAQ,oBAAQ,OAAO,GAAG,IAAI;AAC7D,QAAM,YAAY,oBAAI,IAAkB;AACxC,QAAM,QAAQ,QAAQ,SAAS;AAC/B,MAAI,YAAY;AAEhB,MAAI;AACF,qBAAiB,WAAW,QAAQ;AAClC,UAAI,SAAS,SAAS,aAAa;AACjC,YAAI,WAAW;AACf,cAAM,WAAgE,CAAC;AACvE,mBAAW,SAAS,QAAQ,SAAS,WAAW,CAAC,GAAG;AAClD,cAAI,OAAO,SAAS,QAAQ;AAC1B,yBAAa,MAAM;AACnB,wBAAY,MAAM;AAAA,UACpB;AACA,cAAI,OAAO,SAAS,YAAY;AAC9B,qBAAS,KAAK,EAAE,IAAI,MAAM,IAAI,MAAM,MAAM,MAAM,OAAO,MAAM,MAAM,CAAC;AAAA,UACtE;AAAA,QACF;AACA,cAAM,MAAM,OAAO;AAAA,UACjB;AAAA,UACA;AAAA,YACE,YAAY;AAAA,cACV,2BAA2B;AAAA,cAC3B,kBAAkB;AAAA,cAClB,gBAAgB;AAAA,cAChB,gBACE,YACA,SAAS,IAAI,CAAC,MAAM,UAAK,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,IAAI;AAAA,YAC/D;AAAA,UACF;AAAA,UACA;AAAA,QACF;AACA,cAAM,QAAQ,QAAQ,SAAS;AAC/B,YAAI,OAAO,gBAAgB;AACzB,cAAI,aAAa,0BAA0B,MAAM,YAAY;AAC/D,YAAI,OAAO,iBAAiB;AAC1B,cAAI,aAAa,8BAA8B,MAAM,aAAa;AACpE,YAAI,IAAI;AAER,mBAAW,KAAK,UAAU;AACxB,gBAAM,OAAO,OAAO;AAAA,YAClB,QAAQ,cAAc,EAAE,IAAI,CAAC;AAAA,YAC7B;AAAA,cACE,YAAY;AAAA,gBACV,2BAA2B;AAAA,gBAC3B,aAAa,cAAc,EAAE,IAAI;AAAA,gBACjC,eAAe,KAAK,UAAU,EAAE,KAAK;AAAA,cACvC;AAAA,YACF;AAAA,YACA;AAAA,UACF;AACA,oBAAU,IAAI,EAAE,IAAI,IAAI;AAAA,QAC1B;AAAA,MACF;AAGA,UAAI,SAAS,SAAS,QAAQ;AAC5B,cAAM,UAAU,QAAQ,SAAS;AACjC,YAAI,MAAM,QAAQ,OAAO,GAAG;AAC1B,qBAAW,SAAS,SAAS;AAC3B,gBAAI,OAAO,SAAS,eAAe;AACjC,oBAAM,OAAO,UAAU,IAAI,MAAM,WAAW;AAC5C,kBAAI,MAAM;AACR,qBAAK,aAAa,gBAAgB,eAAe,MAAM,OAAO,CAAC;AAC/D,qBAAK,UAAU,EAAE,MAAM,2BAAe,GAAG,CAAC;AAC1C,qBAAK,IAAI;AACT,0BAAU,OAAO,MAAM,WAAW;AAAA,cACpC;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,YAAM;AAAA,IACR;AAAA,EACF,UAAE;AACA,eAAW,QAAQ,UAAU,OAAO,EAAG,MAAK,IAAI;AAChD,cAAU,MAAM;AAChB,SAAK,aAAa,gBAAgB,SAAS;AAC3C,SAAK,UAAU,EAAE,MAAM,2BAAe,GAAG,CAAC;AAC1C,SAAK,IAAI;AAAA,EACX;AACF;","names":["debugLog","import_api","warn","import_api"]}
@@ -7,6 +7,209 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
7
7
  throw Error('Dynamic require of "' + x + '" is not supported');
8
8
  });
9
9
 
10
+ // src/tracing/identity.ts
11
+ import { AsyncLocalStorage } from "async_hooks";
12
+ import { isSpanContextValid, trace } from "@opentelemetry/api";
13
+
14
+ // src/users/index.ts
15
+ var UserProfileError = class extends Error {
16
+ constructor(message, options) {
17
+ super(message);
18
+ this.name = "UserProfileError";
19
+ this.cause = options?.cause;
20
+ }
21
+ };
22
+ var UsersClient = class _UsersClient {
23
+ host;
24
+ publicKey;
25
+ secretKey;
26
+ timeoutSeconds;
27
+ debug;
28
+ constructor(config) {
29
+ this.host = config.host.replace(/\/$/, "");
30
+ this.publicKey = config.publicKey;
31
+ this.secretKey = config.secretKey;
32
+ this.timeoutSeconds = config.timeoutSeconds ?? 15;
33
+ this.debug = config.debug ?? false;
34
+ }
35
+ /** Create a client from GATEWAY_HOST / GATEWAY_PUBLIC_KEY / GATEWAY_SECRET_KEY. */
36
+ static fromEnv(config = {}) {
37
+ const host = config.host ?? process.env.GATEWAY_HOST;
38
+ const publicKey = config.publicKey ?? process.env.GATEWAY_PUBLIC_KEY;
39
+ const secretKey = config.secretKey ?? process.env.GATEWAY_SECRET_KEY;
40
+ const missing = [
41
+ ["host", host],
42
+ ["publicKey", publicKey],
43
+ ["secretKey", secretKey]
44
+ ].filter(([, value]) => !value).map(([name]) => name);
45
+ if (missing.length > 0) {
46
+ throw new UserProfileError(
47
+ `Missing Gateway user-profile configuration: ${missing.join(", ")}`
48
+ );
49
+ }
50
+ return new _UsersClient({
51
+ ...config,
52
+ host,
53
+ publicKey,
54
+ secretKey
55
+ });
56
+ }
57
+ /** Fetch a user's stored profile. */
58
+ async get(userId) {
59
+ return parseProfile(
60
+ await this.requestJson(
61
+ "GET",
62
+ `/api/public/user-profiles/${encodeURIComponent(userId)}`
63
+ )
64
+ );
65
+ }
66
+ /**
67
+ * Upsert a user's profile. `attributes` merge with the stored set unless
68
+ * `merge: false` (which replaces it).
69
+ */
70
+ async update(userId, update = {}) {
71
+ const body = {
72
+ userId,
73
+ attributes: update.attributes ?? {},
74
+ mergeAttributes: update.merge ?? true,
75
+ ...update.displayName !== void 0 ? { displayName: update.displayName } : {},
76
+ ...update.email !== void 0 ? { email: update.email } : {},
77
+ ...update.notes !== void 0 ? { notes: update.notes } : {}
78
+ };
79
+ return parseProfile(
80
+ await this.requestJson("POST", "/api/public/user-profiles", body)
81
+ );
82
+ }
83
+ async requestJson(method, path, payload) {
84
+ let response;
85
+ try {
86
+ response = await fetch(`${this.host}${path}`, {
87
+ method,
88
+ headers: {
89
+ Authorization: this.authHeader(),
90
+ "Content-Type": "application/json"
91
+ },
92
+ ...payload ? { body: JSON.stringify(payload) } : {},
93
+ signal: AbortSignal.timeout(this.timeoutSeconds * 1e3)
94
+ });
95
+ } catch (error) {
96
+ throw new UserProfileError(
97
+ `${method} ${path} failed: ${error instanceof Error ? error.message : String(error)}`,
98
+ { cause: error }
99
+ );
100
+ }
101
+ const text = await response.text();
102
+ if (!response.ok) {
103
+ throw new UserProfileError(
104
+ `${method} ${path} failed (${response.status}): ${text.slice(0, 500)}`
105
+ );
106
+ }
107
+ this.log("%s %s -> %s", method, path, response.status);
108
+ return safeJson(text);
109
+ }
110
+ authHeader() {
111
+ return `Basic ${Buffer.from(`${this.publicKey}:${this.secretKey}`).toString(
112
+ "base64"
113
+ )}`;
114
+ }
115
+ log(message, ...args) {
116
+ if (this.debug) {
117
+ console.log(`[gateway.users] ${message}`, ...args);
118
+ }
119
+ }
120
+ };
121
+ function parseProfile(payload) {
122
+ return {
123
+ userId: String(payload.userId ?? ""),
124
+ displayName: typeof payload.displayName === "string" ? payload.displayName : null,
125
+ email: typeof payload.email === "string" ? payload.email : null,
126
+ attributes: parseAttributes(payload.attributes),
127
+ notes: typeof payload.notes === "string" ? payload.notes : null
128
+ };
129
+ }
130
+ function parseAttributes(value) {
131
+ if (!value || typeof value !== "object" || Array.isArray(value)) return {};
132
+ const attributes = {};
133
+ for (const [key, entry] of Object.entries(value)) {
134
+ attributes[key] = String(entry);
135
+ }
136
+ return attributes;
137
+ }
138
+ function safeJson(value) {
139
+ try {
140
+ const parsed = JSON.parse(value);
141
+ return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
142
+ } catch {
143
+ return {};
144
+ }
145
+ }
146
+ var users = {
147
+ fromEnv: UsersClient.fromEnv
148
+ };
149
+
150
+ // src/tracing/identity.ts
151
+ var USER_ID_ATTRIBUTE = "gateway.user.id";
152
+ var currentUserStorage = new AsyncLocalStorage();
153
+ function resolveUserId() {
154
+ const contextual = currentUserStorage.getStore();
155
+ if (contextual) return contextual;
156
+ const envUser = process.env.GATEWAY_USER_ID?.trim();
157
+ return envUser ? envUser : void 0;
158
+ }
159
+ function identify(userId, options = {}) {
160
+ const cleaned = userId.trim();
161
+ if (!cleaned) return;
162
+ currentUserStorage.enterWith(cleaned);
163
+ try {
164
+ const span = trace.getActiveSpan();
165
+ if (span && isSpanContextValid(span.spanContext())) {
166
+ span.setAttribute(USER_ID_ATTRIBUTE, cleaned);
167
+ }
168
+ } catch (error) {
169
+ debugLog("identify(): no active span to stamp", error);
170
+ }
171
+ if (options.attributes || options.displayName || options.email) {
172
+ void pushProfile(cleaned, options);
173
+ }
174
+ }
175
+ async function pushProfile(userId, options) {
176
+ try {
177
+ const attributes = {};
178
+ for (const [key, value] of Object.entries(options.attributes ?? {})) {
179
+ attributes[key] = String(value);
180
+ }
181
+ await UsersClient.fromEnv().update(userId, {
182
+ ...options.displayName !== void 0 ? { displayName: options.displayName } : {},
183
+ ...options.email !== void 0 ? { email: options.email } : {},
184
+ attributes
185
+ });
186
+ } catch (error) {
187
+ debugLog("identify(): profile update failed", error);
188
+ }
189
+ }
190
+ function resetAmbientUser() {
191
+ currentUserStorage.enterWith(void 0);
192
+ }
193
+ var IdentitySpanProcessor = class {
194
+ onStart(span, _parentContext) {
195
+ const userId = resolveUserId();
196
+ if (userId) {
197
+ span.setAttribute(USER_ID_ATTRIBUTE, userId);
198
+ }
199
+ }
200
+ onEnd(_span) {
201
+ }
202
+ async shutdown() {
203
+ }
204
+ async forceFlush() {
205
+ }
206
+ };
207
+ function debugLog(message, ...args) {
208
+ if (process.env.GATEWAY_DEBUG) {
209
+ console.debug(`[gatewaysdk.tracing] ${message}`, ...args);
210
+ }
211
+ }
212
+
10
213
  // src/tracing/init.ts
11
214
  var ENV_VARS = {
12
215
  HOST: ["GATEWAY_HOST", "GATEWAY_HOST"],
@@ -34,12 +237,7 @@ function log(message, ...args) {
34
237
  function warn(message, ...args) {
35
238
  console.warn(`[gatewaysdk.tracing] ${message}`, ...args);
36
239
  }
37
- function init(config = {}) {
38
- if (state.initialized) {
39
- log("Tracing already initialized. Call shutdown() first to reinitialize.");
40
- return;
41
- }
42
- state.debug = config.debug ?? false;
240
+ function buildProvider(config, logFn) {
43
241
  const host = config.host ?? getEnv(ENV_VARS.HOST);
44
242
  const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);
45
243
  const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);
@@ -116,17 +314,18 @@ function init(config = {}) {
116
314
  Authorization: authHeader
117
315
  }
118
316
  });
119
- log("Configured Gateway exporter: endpoint=%s", endpoint);
317
+ logFn("Configured Gateway exporter: endpoint=%s", endpoint);
120
318
  const spanProcessors = [];
121
319
  if (config.customSpanProcessors) {
122
320
  for (const sp of config.customSpanProcessors) {
123
321
  spanProcessors.push(sp);
124
- log(
322
+ logFn(
125
323
  "Added custom span processor: %s",
126
324
  sp.constructor?.name ?? "unknown"
127
325
  );
128
326
  }
129
327
  }
328
+ spanProcessors.push(new IdentitySpanProcessor());
130
329
  const batchConfig = {};
131
330
  if (config.batch?.maxQueueSize) {
132
331
  batchConfig.maxQueueSize = config.batch.maxQueueSize;
@@ -151,6 +350,15 @@ function init(config = {}) {
151
350
  spanProcessors
152
351
  });
153
352
  }
353
+ return provider;
354
+ }
355
+ function init(config = {}) {
356
+ if (state.initialized) {
357
+ log("Tracing already initialized. Call shutdown() first to reinitialize.");
358
+ return;
359
+ }
360
+ state.debug = config.debug ?? false;
361
+ const provider = buildProvider(config, log);
154
362
  provider.register();
155
363
  state.provider = provider;
156
364
  state.initialized = true;
@@ -159,6 +367,33 @@ function init(config = {}) {
159
367
  config.serviceName ?? "gatewaysdk-tracing"
160
368
  );
161
369
  }
370
+ function initIsolated(config = {}) {
371
+ const debugLog2 = config.debug ? (message, ...args) => console.log(`[gatewaysdk.tracing:isolated] ${message}`, ...args) : () => {
372
+ };
373
+ const provider = buildProvider(config, debugLog2);
374
+ const tracer = provider.getTracer("@withgateway/sdk");
375
+ debugLog2(
376
+ "Isolated tracing provider created (service=%s)",
377
+ config.serviceName ?? "gatewaysdk-tracing"
378
+ );
379
+ return {
380
+ tracer,
381
+ async flush() {
382
+ try {
383
+ await provider.forceFlush();
384
+ } catch (e) {
385
+ warn("Error during isolated flush:", e);
386
+ }
387
+ },
388
+ async shutdown() {
389
+ try {
390
+ await provider.shutdown();
391
+ } catch (e) {
392
+ warn("Error during isolated shutdown:", e);
393
+ }
394
+ }
395
+ };
396
+ }
162
397
  async function flush() {
163
398
  if (!state.provider) {
164
399
  log("No provider to flush");
@@ -196,21 +431,22 @@ function isGatewayConfigured() {
196
431
  }
197
432
 
198
433
  // src/tracing/observe.ts
199
- import { trace, context, SpanStatusCode } from "@opentelemetry/api";
434
+ import { trace as trace2, context, SpanStatusCode } from "@opentelemetry/api";
200
435
  function asAttr(value) {
201
436
  return typeof value === "string" ? value : JSON.stringify(value);
202
437
  }
203
438
  async function observe(name, fn, options = {}) {
204
- const tracer = trace.getTracer("@withgateway/sdk");
439
+ const tracer = options.tracer ?? trace2.getTracer("@withgateway/sdk");
205
440
  const span = tracer.startSpan(name, {
206
441
  attributes: {
207
442
  "openinference.span.kind": options.kind ?? "AGENT",
208
- ...options.input !== void 0 ? { "input.value": asAttr(options.input) } : {}
443
+ ...options.input !== void 0 ? { "input.value": asAttr(options.input) } : {},
444
+ ...options.attributes ?? {}
209
445
  }
210
446
  });
211
447
  try {
212
448
  const result = await context.with(
213
- trace.setSpan(context.active(), span),
449
+ trace2.setSpan(context.active(), span),
214
450
  fn
215
451
  );
216
452
  if (options.captureOutput !== false && result !== void 0) {
@@ -268,7 +504,7 @@ function observeAnthropic(client) {
268
504
 
269
505
  // src/tracing/claude.ts
270
506
  import {
271
- trace as trace2,
507
+ trace as trace3,
272
508
  context as context2,
273
509
  SpanStatusCode as SpanStatusCode2
274
510
  } from "@opentelemetry/api";
@@ -284,14 +520,15 @@ function toolResultText(content) {
284
520
  return JSON.stringify(content ?? "");
285
521
  }
286
522
  async function* observeClaude(stream, options) {
287
- const tracer = trace2.getTracer("@withgateway/sdk");
523
+ const tracer = options.tracer ?? trace3.getTracer("@withgateway/sdk");
288
524
  const root = tracer.startSpan(options.name, {
289
525
  attributes: {
290
526
  "openinference.span.kind": "AGENT",
291
- ...options.input !== void 0 ? { "input.value": options.input } : {}
527
+ ...options.input !== void 0 ? { "input.value": options.input } : {},
528
+ ...options.attributes ?? {}
292
529
  }
293
530
  });
294
- const rootCtx = trace2.setSpan(context2.active(), root);
531
+ const rootCtx = trace3.setSpan(context2.active(), root);
295
532
  const openTools = /* @__PURE__ */ new Map();
296
533
  const model = options.model ?? "claude";
297
534
  let finalText = "";
@@ -369,14 +606,20 @@ async function* observeClaude(stream, options) {
369
606
  }
370
607
  }
371
608
  export {
609
+ IdentitySpanProcessor,
610
+ USER_ID_ATTRIBUTE,
372
611
  flush,
612
+ identify,
373
613
  init,
614
+ initIsolated,
374
615
  isGatewayConfigured,
375
616
  isInitialized,
376
617
  observe,
377
618
  observeAnthropic,
378
619
  observeClaude,
379
620
  observeOpenAI,
621
+ resetAmbientUser,
622
+ resolveUserId,
380
623
  shutdown
381
624
  };
382
625
  //# sourceMappingURL=index.mjs.map