@morphllm/morphsdk 0.2.174 → 0.2.175

package/dist/tools/warp_grep/vercel.js

@@ -5,25 +5,25 @@ import {
   execute,
   vercel_default,
   warpGrepJsonSchema
-} from "../../chunk-WKNYYI2G.js";
+} from "../../chunk-CBIXYMY2.js";
 import "../../chunk-Q6QCHAMD.js";
 import {
   formatResult
-} from "../../chunk-QW3ARPU3.js";
+} from "../../chunk-IRBMNRZC.js";
 import "../../chunk-GVGJIXV2.js";
 import "../../chunk-A4D2CIIT.js";
 import "../../chunk-63VHBANJ.js";
-import "../../chunk-DK442LPX.js";
+import "../../chunk-ICA7P5TD.js";
 import "../../chunk-IA5K2HTC.js";
 import "../../chunk-CCJK3HTG.js";
 import "../../chunk-FBRNUWEB.js";
-import "../../chunk-B2GSQO2U.js";
-import "../../chunk-RH2E2PTB.js";
-import "../../chunk-XBUHHKHX.js";
+import "../../chunk-GIQZQM3I.js";
+import "../../chunk-JOBCDCRP.js";
+import "../../chunk-XRYUQSUC.js";
 import "../../chunk-F3NCFNUX.js";
-import "../../chunk-CBPPR3OM.js";
-import "../../chunk-M35HA2EQ.js";
-import "../../chunk-2OHOIGNC.js";
+import "../../chunk-DB4C63ND.js";
+import "../../chunk-2WC7TSEL.js";
+import "../../chunk-OHF5K3HA.js";
 import "../../chunk-LKFZBBTD.js";
 import "../../chunk-PZ5AY32C.js";
 export {

package/dist/tracing/core.cjs

@@ -42,7 +42,7 @@ var import_api = require("@opentelemetry/api");
 var traceloop = __toESM(require("@traceloop/node-server-sdk"), 1);
 
 // tracing/otel.ts
-var MORPH_METADATA_PREFIX = "morph";
+var RESERVED_KEYS = /* @__PURE__ */ new Set(["user_id", "convo_id", "event_id", "event_name"]);
 function uuid() {
   const c = globalThis.crypto;
   if (c?.randomUUID) return c.randomUUID();
@@ -54,11 +54,16 @@ function uuid() {
 }
 function metadata(opts) {
   const result = {
-    [`${MORPH_METADATA_PREFIX}.userId`]: opts.userId,
-    [`${MORPH_METADATA_PREFIX}.eventId`]: opts.eventId ?? uuid()
+    user_id: opts.userId,
+    event_id: opts.eventId ?? uuid()
   };
-  if (opts.convoId) result[`${MORPH_METADATA_PREFIX}.convoId`] = opts.convoId;
-  if (opts.eventName) result[`${MORPH_METADATA_PREFIX}.eventName`] = opts.eventName;
+  if (opts.convoId) result.convo_id = opts.convoId;
+  if (opts.eventName) result.event_name = opts.eventName;
+  if (opts.properties) {
+    for (const [key, value] of Object.entries(opts.properties)) {
+      if (!RESERVED_KEYS.has(key)) result[key] = value;
+    }
+  }
   return result;
 }
 
@@ -141,9 +146,13 @@ function createInteractionApi(initial, traceContent) {
         userId: ctx.userId ?? "unknown",
         convoId: ctx.convoId,
         eventName: ctx.event,
-        eventId: ctx.eventId
+        eventId: ctx.eventId,
+        properties
       });
     },
+    run(fn) {
+      return Promise.resolve(withAssoc(fn));
+    },
     withSpan(params, fn) {
       const name = typeof params === "string" ? params : params.name;
       return Promise.resolve(withAssoc(() => traceloop.withTask({ name }, fn)));

package/dist/tracing/core.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../tracing/core.ts","../../tracing/interaction.ts","../../tracing/otel.ts","../../tracing/signals.ts"],"sourcesContent":["/**\n * Morph Tracing — core initialization.\n *\n * Thin Morph layer over OpenLLMetry / Traceloop. `morphTracing()` initializes\n * Traceloop with a JSON OTLP exporter pointed at Morph's ingest endpoint\n * (`${baseUrl}/v1/traces`, `Authorization: Bearer <apiKey>`) and returns a\n * `MorphTracing` handle for interactions, tools, and signals.\n *\n * We deliberately override Traceloop's default protobuf exporter with the\n * JSON-over-HTTP exporter so the ingest service can parse plain OTLP/JSON.\n */\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport * as traceloop from '@traceloop/node-server-sdk';\n\nimport { createInteractionApi, type Interaction, type Tracer } from './interaction.js';\nimport { metadata as buildMetadata } from './otel.js';\nimport { shipSignal } from './signals.js';\nimport type {\n  MetadataOptions,\n  MorphTracingConfig,\n  SignalEvent,\n  TraceContext,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.morphllm.com';\n\nexport interface ResolvedConfig {\n  apiKey: string;\n  baseUrl: string;\n  signalsEndpoint: string;\n  appName: string;\n  disableBatching: boolean;\n  traceContent: boolean;\n  debug: boolean;\n}\n\nfunction log(debug: boolean, ...args: unknown[]): void {\n  if (debug) console.log('[morph-tracing]', ...args);\n}\n\n/**\n * Handle returned by {@link morphTracing}. Create interactions with `begin()`,\n * get a non-interactive `tracer()`, attach feedback with `trackSignal()`, and\n * flush/shutdown the exporter.\n */\nexport class MorphTracing {\n  private readonly cfg: ResolvedConfig;\n  private readonly active = new Map<string, Interaction>();\n  readonly enabled: boolean;\n\n  constructor(config: MorphTracingConfig = {}) {\n    const debug = config.debug ?? process.env.MORPH_TRACING_DEBUG === '1';\n    const apiKey = config.apiKey ?? process.env.MORPH_API_KEY ?? '';\n    const baseUrlRaw =\n      config.baseUrl ?? process.env.MORPH_TRACES_URL ?? DEFAULT_BASE_URL;\n    const baseUrl = baseUrlRaw.replace(/\\/+$/, '');\n    const isProd = process.env.NODE_ENV === 'production';\n\n    this.cfg = {\n      apiKey,\n      baseUrl,\n      signalsEndpoint: `${baseUrl}/v1/signals`,\n      appName: config.appName ?? process.env.npm_package_name ?? 'morph-app',\n      disableBatching: config.disableBatching ?? !isProd,\n      traceContent: config.traceContent ?? true,\n      debug,\n    };\n\n    if (config.disabled) {\n      log(debug, 'disabled — no tracing initialized');\n      this.enabled = false;\n      return;\n    }\n    if (!apiKey) {\n      console.warn(\n        '[morph-tracing] No API key (set MORPH_API_KEY or pass { apiKey }). Tracing disabled.',\n      );\n      this.enabled = false;\n      return;\n    }\n\n    this.enabled = true;\n    if (config.useExternalOtel) {\n      // Customer drives their own NodeSDK; just register config, no SDK start.\n      traceloop.initialize({\n        baseUrl,\n        apiKey,\n        appName: this.cfg.appName,\n        tracingEnabled: false,\n        traceContent: this.cfg.traceContent,\n        silenceInitializationMessage: true,\n      });\n      log(debug, 'external OTEL mode — add createSpanProcessor() to your NodeSDK');\n      return;\n    }\n\n    const exporter = new OTLPTraceExporter({\n      url: `${baseUrl}/v1/traces`,\n      headers: { Authorization: `Bearer ${apiKey}`, ...config.headers },\n    });\n\n    traceloop.initialize({\n      baseUrl,\n      apiKey,\n      appName: this.cfg.appName,\n      exporter,\n      disableBatch: this.cfg.disableBatching,\n      traceContent: this.cfg.traceContent,\n      instrumentModules: config.instrumentModules as NonNullable<\n        Parameters<typeof traceloop.initialize>[0]\n      >['instrumentModules'],\n      tracingEnabled: true,\n      traceloopSyncEnabled: false,\n      silenceInitializationMessage: !debug,\n    });\n    log(\n      debug,\n      `initialized → ${baseUrl}/v1/traces (batching ${this.cfg.disableBatching ? 'off' : 'on'})`,\n    );\n  }\n\n  /** Begin a new traced interaction (a single user turn / agent run). */\n  begin(ctx: TraceContext & { userId: string; event?: string }): Interaction {\n    const interaction = createInteractionApi(ctx, this.cfg.traceContent);\n    this.active.set(interaction.getEventId()!, interaction);\n    return interaction;\n  }\n\n  /** Look up an in-flight interaction by its eventId. */\n  getActiveInteraction(eventId: string): Interaction | undefined {\n    return this.active.get(eventId);\n  }\n\n  /**\n   * Non-interactive tracer for batch jobs where you only care about\n   * spans/token usage, not a user-facing interaction.\n   */\n  tracer(globalProperties: Record<string, string> = {}): Tracer {\n    return createInteractionApi(\n      { userId: globalProperties.userId ?? 'batch', properties: globalProperties },\n      this.cfg.traceContent,\n    );\n  }\n\n  /** Build Vercel AI SDK telemetry metadata (see `morphsdk/tracing/otel`). */\n  metadata(opts: MetadataOptions): Record<string, string> {\n    return buildMetadata(opts);\n  }\n\n  /** Attach a feedback/quality signal to an interaction by eventId. */\n  async trackSignal(signal: SignalEvent | SignalEvent[]): Promise<void> {\n    if (!this.enabled) return;\n    const signals = Array.isArray(signal) ? signal : [signal];\n    await shipSignal(this.cfg.signalsEndpoint, this.cfg.apiKey, signals, this.cfg.debug);\n  }\n\n  /** Span processor for `useExternalOtel: true` integrations. */\n  createSpanProcessor(\n    options?: Parameters<typeof traceloop.createSpanProcessor>[0],\n  ): ReturnType<typeof traceloop.createSpanProcessor> {\n    return traceloop.createSpanProcessor({\n      apiKey: this.cfg.apiKey,\n      baseUrl: this.cfg.baseUrl,\n      ...options,\n    });\n  }\n\n  /** Flush any batched spans immediately. Safe to call when idle. */\n  async forceFlush(): Promise<void> {\n    if (!this.enabled) return;\n    try {\n      await traceloop.forceFlush();\n    } catch (err) {\n      log(this.cfg.debug, 'forceFlush error (ignored):', err);\n    }\n  }\n\n  /** Flush and stop tracing. */\n  async shutdown(): Promise<void> {\n    await this.forceFlush();\n  }\n}\n\n/** Initialize Morph Tracing and auto-instrument supported AI SDKs. */\nexport function morphTracing(config: MorphTracingConfig = {}): MorphTracing {\n  return new MorphTracing(config);\n}\n","/**\n * Morph Tracing — interactions, tools, and manual spans.\n *\n * An `Interaction` is one user turn / agent run. It threads association\n * properties (user_id / convo_id / event_id) onto every span created inside it —\n * including the auto-instrumented LLM spans — so a whole conversation stitches\n * together in the Morph UI. Built on Traceloop's `withTask` / `withTool` and a\n * manual tracer for already-completed tool spans.\n */\nimport { SpanStatusCode, type Span } from '@opentelemetry/api';\nimport * as traceloop from '@traceloop/node-server-sdk';\n\nimport { metadata as buildMetadata } from './otel.js';\nimport type {\n  FinishOptions,\n  SpanParams,\n  ToolParams,\n  ToolSpan,\n  TrackToolParams,\n  TraceContext,\n} from './types.js';\n\n// Traceloop semantic-convention attribute keys.\nconst ASSOC = 'traceloop.association.properties.';\nconst ENTITY_INPUT = 'traceloop.entity.input';\nconst ENTITY_OUTPUT = 'traceloop.entity.output';\nconst ENTITY_NAME = 'traceloop.entity.name';\nconst SPAN_KIND = 'traceloop.span.kind';\n\nfunction uuid(): string {\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  return 'xxxxxxxxxxxx4xxxyxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    return (ch === 'x' ? r : (r & 0x3) | 0x8).toString(16);\n  });\n}\n\nfunction asString(v: unknown): string {\n  if (v == null) return '';\n  return typeof v === 'string' ? v : JSON.stringify(v);\n}\n\nexport interface Interaction {\n  getEventId(): string | undefined;\n  setInput(input: string): void;\n  setProperty(key: string, value: string): void;\n  setProperties(props: Record<string, string>): void;\n  /** Run `fn` inside a traced task span; LLM calls within inherit attribution. */\n  withSpan<T>(params: SpanParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Run `fn` inside a traced tool span. */\n  withTool<T>(params: ToolParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Start a tool span you end manually. */\n  startToolSpan(params: ToolParams | string): ToolSpan;\n  /** Record an already-completed tool invocation. */\n  trackTool(params: TrackToolParams): void;\n  /** Metadata for the Vercel AI SDK `experimental_telemetry.metadata`. */\n  vercelAiSdkMetadata(): Record<string, string>;\n  /** End the interaction with its final output. */\n  finish(opts: FinishOptions | string): Promise<void>;\n}\n\nexport type Tracer = Pick<Interaction, 'withSpan' | 'withTool' | 'startToolSpan' | 'trackTool'>;\n\n/** Build the association-property bag Traceloop propagates onto child spans. */\nfunction associationProps(\n  ctx: TraceContext & { userId?: string },\n  extra: Record<string, string>,\n): Record<string, string> {\n  const props: Record<string, string> = { ...extra };\n  if (ctx.userId) props.user_id = ctx.userId;\n  if (ctx.convoId) props.convo_id = ctx.convoId;\n  if (ctx.eventId) props.event_id = ctx.eventId;\n  if (ctx.event) props.event_name = ctx.event;\n  return props;\n}\n\nexport function createInteractionApi(\n  initial: TraceContext & { userId?: string },\n  traceContent: boolean,\n): Interaction {\n  const ctx: TraceContext & { userId?: string } = {\n    ...initial,\n    eventId: initial.eventId ?? uuid(),\n  };\n  const properties: Record<string, string> = { ...(initial.properties ?? {}) };\n  let input = initial.input;\n\n  const withAssoc = <T>(fn: () => Promise<T> | T): Promise<T> | T =>\n    traceloop.withAssociationProperties(associationProps(ctx, properties), fn);\n\n  const toolName = (p: ToolParams | string) => (typeof p === 'string' ? p : p.name);\n\n  function startToolSpan(params: ToolParams | string): ToolSpan {\n    const name = toolName(params);\n    const span: Span = traceloop.getTraceloopTracer().startSpan(name);\n    span.setAttribute(SPAN_KIND, 'tool');\n    span.setAttribute(ENTITY_NAME, name);\n    for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n      span.setAttribute(ASSOC + k, v);\n    }\n    if (typeof params !== 'string' && params.properties) {\n      for (const [k, v] of Object.entries(params.properties)) span.setAttribute(k, v);\n    }\n    return {\n      setInput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_INPUT, asString(value));\n      },\n      setOutput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_OUTPUT, asString(value));\n      },\n      setError(error: Error | string) {\n        const e = typeof error === 'string' ? new Error(error) : error;\n        span.recordException(e);\n        span.setStatus({ code: SpanStatusCode.ERROR, message: e.message });\n      },\n      end() {\n        span.end();\n      },\n    };\n  }\n\n  return {\n    getEventId: () => ctx.eventId,\n    setInput(value: string) {\n      input = value;\n    },\n    setProperty(key: string, value: string) {\n      properties[key] = value;\n    },\n    setProperties(props: Record<string, string>) {\n      Object.assign(properties, props);\n    },\n    vercelAiSdkMetadata() {\n      return buildMetadata({\n        userId: ctx.userId ?? 'unknown',\n        convoId: ctx.convoId,\n        eventName: ctx.event,\n        eventId: ctx.eventId,\n      });\n    },\n    withSpan(params, fn) {\n      const name = typeof params === 'string' ? params : params.name;\n      return Promise.resolve(withAssoc(() => traceloop.withTask({ name }, fn)));\n    },\n    withTool(params, fn) {\n      const name = toolName(params);\n      const version = typeof params === 'string' ? undefined : params.version;\n      return Promise.resolve(withAssoc(() => traceloop.withTool({ name, version }, fn)));\n    },\n    startToolSpan,\n    trackTool(params: TrackToolParams) {\n      const span = startToolSpan({ name: params.name, properties: params.properties });\n      if (params.input !== undefined) span.setInput(params.input);\n      if (params.output !== undefined) span.setOutput(params.output);\n      if (params.error) span.setError(params.error);\n      span.end();\n    },\n    async finish(opts) {\n      const output = typeof opts === 'string' ? opts : opts.output;\n      if (typeof opts !== 'string' && opts.properties) Object.assign(properties, opts.properties);\n      // Emit a top-level interaction span carrying input/output + attribution.\n      await Promise.resolve(\n        withAssoc(() =>\n          traceloop.withTask({ name: ctx.event ?? 'interaction' }, () => {\n            const span = traceloop.getTraceloopTracer().startSpan(ctx.event ?? 'interaction');\n            span.setAttribute(SPAN_KIND, 'workflow');\n            for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n              span.setAttribute(ASSOC + k, v);\n            }\n            if (traceContent && input) span.setAttribute(ENTITY_INPUT, input);\n            if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);\n            span.end();\n          }),\n        ),\n      );\n    },\n  };\n}\n","/**\n * Morph Tracing — Vercel AI SDK helper.\n *\n * The Vercel AI SDK emits its own OpenTelemetry spans when you pass\n * `experimental_telemetry`. There is nothing to monkey-patch; instead you tag\n * each call with `metadata()` so Morph can attribute the resulting spans to a\n * user/conversation/event.\n *\n * @example\n * ```ts\n * import { generateText } from \"ai\";\n * import { metadata } from \"morphsdk/tracing/otel\";\n *\n * const res = await generateText({\n *   model: openai(\"gpt-4o\"),\n *   prompt: \"Hello!\",\n *   experimental_telemetry: {\n *     isEnabled: true,\n *     metadata: metadata({ userId: \"user-123\", convoId: \"convo-456\" }),\n *   },\n * });\n * ```\n */\nimport type { MetadataOptions } from './types.js';\n\n/** Prefix under which Morph reads attribution from AI SDK telemetry metadata. */\nexport const MORPH_METADATA_PREFIX = 'morph';\n\nfunction uuid(): string {\n  // Node 18+ and modern runtimes expose globalThis.crypto.randomUUID.\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  // Fallback: RFC4122-ish without crypto.\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    const v = ch === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Build the metadata object for the Vercel AI SDK's\n * `experimental_telemetry.metadata`. The values are propagated to every span the\n * AI SDK creates for that call. Generate a fresh `eventId` per call for grouping.\n */\nexport function metadata(opts: MetadataOptions): Record<string, string> {\n  const result: Record<string, string> = {\n    [`${MORPH_METADATA_PREFIX}.userId`]: opts.userId,\n    [`${MORPH_METADATA_PREFIX}.eventId`]: opts.eventId ?? uuid(),\n  };\n  if (opts.convoId) result[`${MORPH_METADATA_PREFIX}.convoId`] = opts.convoId;\n  if (opts.eventName) result[`${MORPH_METADATA_PREFIX}.eventName`] = opts.eventName;\n  return result;\n}\n\nexport default { metadata };\n","/**\n * Morph Tracing — feedback signals.\n *\n * Signals (👍/👎, free-text feedback, user edits) attach to an interaction by\n * `eventId` and ship directly over HTTP — they are low-volume and need no OTel\n * pipeline. Mirrors the request shape of `tools/fastapply/core.ts`.\n */\nimport type { SignalEvent } from './types.js';\n\nexport async function shipSignal(\n  endpoint: string,\n  apiKey: string,\n  signals: SignalEvent[],\n  debug = false,\n  timeoutMs = 10_000,\n): Promise<void> {\n  if (signals.length === 0) return;\n\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  try {\n    const res = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify({ signals }),\n      signal: controller.signal,\n    });\n    if (!res.ok) {\n      const body = await res.text().catch(() => '');\n      // Signals are best-effort; never throw into the caller's hot path.\n      console.warn(`[morph-tracing] signal POST failed (${res.status}): ${body}`);\n    } else if (debug) {\n      console.log(`[morph-tracing] shipped ${signals.length} signal(s)`);\n    }\n  } catch (err) {\n    console.warn(\n      '[morph-tracing] signal POST error:',\n      err instanceof Error ? err.message : err,\n    );\n  } finally {\n    clearTimeout(timer);\n  }\n}\n"],"mappings":"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","names":["traceloop","uuid"]}
+{"version":3,"sources":["../../tracing/core.ts","../../tracing/interaction.ts","../../tracing/otel.ts","../../tracing/signals.ts"],"sourcesContent":["/**\n * Morph Tracing — core initialization.\n *\n * Thin Morph layer over OpenLLMetry / Traceloop. `morphTracing()` initializes\n * Traceloop with a JSON OTLP exporter pointed at Morph's ingest endpoint\n * (`${baseUrl}/v1/traces`, `Authorization: Bearer <apiKey>`) and returns a\n * `MorphTracing` handle for interactions, tools, and signals.\n *\n * We deliberately override Traceloop's default protobuf exporter with the\n * JSON-over-HTTP exporter so the ingest service can parse plain OTLP/JSON.\n */\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport * as traceloop from '@traceloop/node-server-sdk';\n\nimport { createInteractionApi, type Interaction, type Tracer } from './interaction.js';\nimport { metadata as buildMetadata } from './otel.js';\nimport { shipSignal } from './signals.js';\nimport type {\n  MetadataOptions,\n  MorphTracingConfig,\n  SignalEvent,\n  TraceContext,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.morphllm.com';\n\nexport interface ResolvedConfig {\n  apiKey: string;\n  baseUrl: string;\n  signalsEndpoint: string;\n  appName: string;\n  disableBatching: boolean;\n  traceContent: boolean;\n  debug: boolean;\n}\n\nfunction log(debug: boolean, ...args: unknown[]): void {\n  if (debug) console.log('[morph-tracing]', ...args);\n}\n\n/**\n * Handle returned by {@link morphTracing}. Create interactions with `begin()`,\n * get a non-interactive `tracer()`, attach feedback with `trackSignal()`, and\n * flush/shutdown the exporter.\n */\nexport class MorphTracing {\n  private readonly cfg: ResolvedConfig;\n  private readonly active = new Map<string, Interaction>();\n  readonly enabled: boolean;\n\n  constructor(config: MorphTracingConfig = {}) {\n    const debug = config.debug ?? process.env.MORPH_TRACING_DEBUG === '1';\n    const apiKey = config.apiKey ?? process.env.MORPH_API_KEY ?? '';\n    const baseUrlRaw =\n      config.baseUrl ?? process.env.MORPH_TRACES_URL ?? DEFAULT_BASE_URL;\n    const baseUrl = baseUrlRaw.replace(/\\/+$/, '');\n    const isProd = process.env.NODE_ENV === 'production';\n\n    this.cfg = {\n      apiKey,\n      baseUrl,\n      signalsEndpoint: `${baseUrl}/v1/signals`,\n      appName: config.appName ?? process.env.npm_package_name ?? 'morph-app',\n      disableBatching: config.disableBatching ?? !isProd,\n      traceContent: config.traceContent ?? true,\n      debug,\n    };\n\n    if (config.disabled) {\n      log(debug, 'disabled — no tracing initialized');\n      this.enabled = false;\n      return;\n    }\n    if (!apiKey) {\n      console.warn(\n        '[morph-tracing] No API key (set MORPH_API_KEY or pass { apiKey }). Tracing disabled.',\n      );\n      this.enabled = false;\n      return;\n    }\n\n    this.enabled = true;\n    if (config.useExternalOtel) {\n      // Customer drives their own NodeSDK; just register config, no SDK start.\n      traceloop.initialize({\n        baseUrl,\n        apiKey,\n        appName: this.cfg.appName,\n        tracingEnabled: false,\n        traceContent: this.cfg.traceContent,\n        silenceInitializationMessage: true,\n      });\n      log(debug, 'external OTEL mode — add createSpanProcessor() to your NodeSDK');\n      return;\n    }\n\n    const exporter = new OTLPTraceExporter({\n      url: `${baseUrl}/v1/traces`,\n      headers: { Authorization: `Bearer ${apiKey}`, ...config.headers },\n    });\n\n    traceloop.initialize({\n      baseUrl,\n      apiKey,\n      appName: this.cfg.appName,\n      exporter,\n      disableBatch: this.cfg.disableBatching,\n      traceContent: this.cfg.traceContent,\n      instrumentModules: config.instrumentModules as NonNullable<\n        Parameters<typeof traceloop.initialize>[0]\n      >['instrumentModules'],\n      tracingEnabled: true,\n      traceloopSyncEnabled: false,\n      silenceInitializationMessage: !debug,\n    });\n    log(\n      debug,\n      `initialized → ${baseUrl}/v1/traces (batching ${this.cfg.disableBatching ? 'off' : 'on'})`,\n    );\n  }\n\n  /** Begin a new traced interaction (a single user turn / agent run). */\n  begin(ctx: TraceContext & { userId: string; event?: string }): Interaction {\n    const interaction = createInteractionApi(ctx, this.cfg.traceContent);\n    this.active.set(interaction.getEventId()!, interaction);\n    return interaction;\n  }\n\n  /** Look up an in-flight interaction by its eventId. */\n  getActiveInteraction(eventId: string): Interaction | undefined {\n    return this.active.get(eventId);\n  }\n\n  /**\n   * Non-interactive tracer for batch jobs where you only care about\n   * spans/token usage, not a user-facing interaction.\n   */\n  tracer(globalProperties: Record<string, string> = {}): Tracer {\n    return createInteractionApi(\n      { userId: globalProperties.userId ?? 'batch', properties: globalProperties },\n      this.cfg.traceContent,\n    );\n  }\n\n  /** Build Vercel AI SDK telemetry metadata (see `morphsdk/tracing/otel`). */\n  metadata(opts: MetadataOptions): Record<string, string> {\n    return buildMetadata(opts);\n  }\n\n  /** Attach a feedback/quality signal to an interaction by eventId. */\n  async trackSignal(signal: SignalEvent | SignalEvent[]): Promise<void> {\n    if (!this.enabled) return;\n    const signals = Array.isArray(signal) ? signal : [signal];\n    await shipSignal(this.cfg.signalsEndpoint, this.cfg.apiKey, signals, this.cfg.debug);\n  }\n\n  /** Span processor for `useExternalOtel: true` integrations. */\n  createSpanProcessor(\n    options?: Parameters<typeof traceloop.createSpanProcessor>[0],\n  ): ReturnType<typeof traceloop.createSpanProcessor> {\n    return traceloop.createSpanProcessor({\n      apiKey: this.cfg.apiKey,\n      baseUrl: this.cfg.baseUrl,\n      ...options,\n    });\n  }\n\n  /** Flush any batched spans immediately. Safe to call when idle. */\n  async forceFlush(): Promise<void> {\n    if (!this.enabled) return;\n    try {\n      await traceloop.forceFlush();\n    } catch (err) {\n      log(this.cfg.debug, 'forceFlush error (ignored):', err);\n    }\n  }\n\n  /** Flush and stop tracing. */\n  async shutdown(): Promise<void> {\n    await this.forceFlush();\n  }\n}\n\n/** Initialize Morph Tracing and auto-instrument supported AI SDKs. */\nexport function morphTracing(config: MorphTracingConfig = {}): MorphTracing {\n  return new MorphTracing(config);\n}\n","/**\n * Morph Tracing — interactions, tools, and manual spans.\n *\n * An `Interaction` is one user turn / agent run. It threads association\n * properties (user_id / convo_id / event_id) onto every span created inside it —\n * including the auto-instrumented LLM spans — so a whole conversation stitches\n * together in the Morph UI. Built on Traceloop's `withTask` / `withTool` and a\n * manual tracer for already-completed tool spans.\n */\nimport { SpanStatusCode, type Span } from '@opentelemetry/api';\nimport * as traceloop from '@traceloop/node-server-sdk';\n\nimport { metadata as buildMetadata } from './otel.js';\nimport type {\n  FinishOptions,\n  SpanParams,\n  ToolParams,\n  ToolSpan,\n  TrackToolParams,\n  TraceContext,\n} from './types.js';\n\n// Traceloop semantic-convention attribute keys.\nconst ASSOC = 'traceloop.association.properties.';\nconst ENTITY_INPUT = 'traceloop.entity.input';\nconst ENTITY_OUTPUT = 'traceloop.entity.output';\nconst ENTITY_NAME = 'traceloop.entity.name';\nconst SPAN_KIND = 'traceloop.span.kind';\n\nfunction uuid(): string {\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  return 'xxxxxxxxxxxx4xxxyxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    return (ch === 'x' ? r : (r & 0x3) | 0x8).toString(16);\n  });\n}\n\nfunction asString(v: unknown): string {\n  if (v == null) return '';\n  return typeof v === 'string' ? v : JSON.stringify(v);\n}\n\nexport interface Interaction {\n  getEventId(): string | undefined;\n  setInput(input: string): void;\n  setProperty(key: string, value: string): void;\n  setProperties(props: Record<string, string>): void;\n  /**\n   * Run `fn` with this interaction's association properties active — required so\n   * auto-instrumented OpenAI/Anthropic spans inherit user_id / convo_id / tags.\n   */\n  run<T>(fn: () => Promise<T> | T): Promise<T>;\n  /** Run `fn` inside a traced task span; LLM calls within inherit attribution. */\n  withSpan<T>(params: SpanParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Run `fn` inside a traced tool span. */\n  withTool<T>(params: ToolParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Start a tool span you end manually. */\n  startToolSpan(params: ToolParams | string): ToolSpan;\n  /** Record an already-completed tool invocation. */\n  trackTool(params: TrackToolParams): void;\n  /** Metadata for the Vercel AI SDK `experimental_telemetry.metadata`. */\n  vercelAiSdkMetadata(): Record<string, string>;\n  /** End the interaction with its final output. */\n  finish(opts: FinishOptions | string): Promise<void>;\n}\n\nexport type Tracer = Pick<Interaction, 'withSpan' | 'withTool' | 'startToolSpan' | 'trackTool'>;\n\n/** Build the association-property bag Traceloop propagates onto child spans. */\nfunction associationProps(\n  ctx: TraceContext & { userId?: string },\n  extra: Record<string, string>,\n): Record<string, string> {\n  const props: Record<string, string> = { ...extra };\n  if (ctx.userId) props.user_id = ctx.userId;\n  if (ctx.convoId) props.convo_id = ctx.convoId;\n  if (ctx.eventId) props.event_id = ctx.eventId;\n  if (ctx.event) props.event_name = ctx.event;\n  return props;\n}\n\nexport function createInteractionApi(\n  initial: TraceContext & { userId?: string },\n  traceContent: boolean,\n): Interaction {\n  const ctx: TraceContext & { userId?: string } = {\n    ...initial,\n    eventId: initial.eventId ?? uuid(),\n  };\n  const properties: Record<string, string> = { ...(initial.properties ?? {}) };\n  let input = initial.input;\n\n  const withAssoc = <T>(fn: () => Promise<T> | T): Promise<T> | T =>\n    traceloop.withAssociationProperties(associationProps(ctx, properties), fn);\n\n  const toolName = (p: ToolParams | string) => (typeof p === 'string' ? p : p.name);\n\n  function startToolSpan(params: ToolParams | string): ToolSpan {\n    const name = toolName(params);\n    const span: Span = traceloop.getTraceloopTracer().startSpan(name);\n    span.setAttribute(SPAN_KIND, 'tool');\n    span.setAttribute(ENTITY_NAME, name);\n    for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n      span.setAttribute(ASSOC + k, v);\n    }\n    if (typeof params !== 'string' && params.properties) {\n      for (const [k, v] of Object.entries(params.properties)) span.setAttribute(k, v);\n    }\n    return {\n      setInput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_INPUT, asString(value));\n      },\n      setOutput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_OUTPUT, asString(value));\n      },\n      setError(error: Error | string) {\n        const e = typeof error === 'string' ? new Error(error) : error;\n        span.recordException(e);\n        span.setStatus({ code: SpanStatusCode.ERROR, message: e.message });\n      },\n      end() {\n        span.end();\n      },\n    };\n  }\n\n  return {\n    getEventId: () => ctx.eventId,\n    setInput(value: string) {\n      input = value;\n    },\n    setProperty(key: string, value: string) {\n      properties[key] = value;\n    },\n    setProperties(props: Record<string, string>) {\n      Object.assign(properties, props);\n    },\n    vercelAiSdkMetadata() {\n      return buildMetadata({\n        userId: ctx.userId ?? 'unknown',\n        convoId: ctx.convoId,\n        eventName: ctx.event,\n        eventId: ctx.eventId,\n        properties,\n      });\n    },\n    run(fn) {\n      return Promise.resolve(withAssoc(fn));\n    },\n    withSpan(params, fn) {\n      const name = typeof params === 'string' ? params : params.name;\n      return Promise.resolve(withAssoc(() => traceloop.withTask({ name }, fn)));\n    },\n    withTool(params, fn) {\n      const name = toolName(params);\n      const version = typeof params === 'string' ? undefined : params.version;\n      return Promise.resolve(withAssoc(() => traceloop.withTool({ name, version }, fn)));\n    },\n    startToolSpan,\n    trackTool(params: TrackToolParams) {\n      const span = startToolSpan({ name: params.name, properties: params.properties });\n      if (params.input !== undefined) span.setInput(params.input);\n      if (params.output !== undefined) span.setOutput(params.output);\n      if (params.error) span.setError(params.error);\n      span.end();\n    },\n    async finish(opts) {\n      const output = typeof opts === 'string' ? opts : opts.output;\n      if (typeof opts !== 'string' && opts.properties) Object.assign(properties, opts.properties);\n      // Emit a top-level interaction span carrying input/output + attribution.\n      await Promise.resolve(\n        withAssoc(() =>\n          traceloop.withTask({ name: ctx.event ?? 'interaction' }, () => {\n            const span = traceloop.getTraceloopTracer().startSpan(ctx.event ?? 'interaction');\n            span.setAttribute(SPAN_KIND, 'workflow');\n            for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n              span.setAttribute(ASSOC + k, v);\n            }\n            if (traceContent && input) span.setAttribute(ENTITY_INPUT, input);\n            if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);\n            span.end();\n          }),\n        ),\n      );\n    },\n  };\n}\n","/**\n * Morph Tracing — Vercel AI SDK helper.\n *\n * The Vercel AI SDK emits its own OpenTelemetry spans when you pass\n * `experimental_telemetry`. There is nothing to monkey-patch; instead you tag\n * each call with `metadata()` so Morph can attribute the resulting spans to a\n * user/conversation/event.\n *\n * @example\n * ```ts\n * import { generateText } from \"ai\";\n * import { metadata } from \"morphsdk/tracing/otel\";\n *\n * const res = await generateText({\n *   model: openai(\"gpt-4o\"),\n *   prompt: \"Hello!\",\n *   experimental_telemetry: {\n *     isEnabled: true,\n *     metadata: metadata({ userId: \"user-123\", convoId: \"convo-456\" }),\n *   },\n * });\n * ```\n */\nimport type { MetadataOptions } from './types.js';\n\n/**\n * Reserved metadata keys Morph owns. Custom `properties` can't overwrite these,\n * so attribution (user_id / convo_id / event_id) stays intact.\n *\n * The AI SDK stores metadata as `ai.telemetry.metadata.<key>`; Traceloop's span\n * processor copies them to `traceloop.association.properties.<key>`, which is\n * what ClickHouse views read. Use snake_case names (user_id, convo_id, …).\n */\nconst RESERVED_KEYS = new Set(['user_id', 'convo_id', 'event_id', 'event_name']);\n\nfunction uuid(): string {\n  // Node 18+ and modern runtimes expose globalThis.crypto.randomUUID.\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  // Fallback: RFC4122-ish without crypto.\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    const v = ch === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Build the metadata object for the Vercel AI SDK's\n * `experimental_telemetry.metadata`. The values are propagated to every span the\n * AI SDK creates for that call. Generate a fresh `eventId` per call for grouping.\n */\nexport function metadata(opts: MetadataOptions): Record<string, string> {\n  const result: Record<string, string> = {\n    user_id: opts.userId,\n    event_id: opts.eventId ?? uuid(),\n  };\n  if (opts.convoId) result.convo_id = opts.convoId;\n  if (opts.eventName) result.event_name = opts.eventName;\n  if (opts.properties) {\n    for (const [key, value] of Object.entries(opts.properties)) {\n      if (!RESERVED_KEYS.has(key)) result[key] = value;\n    }\n  }\n  return result;\n}\n\nexport default { metadata };\n","/**\n * Morph Tracing — feedback signals.\n *\n * Signals (👍/👎, free-text feedback, user edits) attach to an interaction by\n * `eventId` and ship directly over HTTP — they are low-volume and need no OTel\n * pipeline. Mirrors the request shape of `tools/fastapply/core.ts`.\n */\nimport type { SignalEvent } from './types.js';\n\nexport async function shipSignal(\n  endpoint: string,\n  apiKey: string,\n  signals: SignalEvent[],\n  debug = false,\n  timeoutMs = 10_000,\n): Promise<void> {\n  if (signals.length === 0) return;\n\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  try {\n    const res = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify({ signals }),\n      signal: controller.signal,\n    });\n    if (!res.ok) {\n      const body = await res.text().catch(() => '');\n      // Signals are best-effort; never throw into the caller's hot path.\n      console.warn(`[morph-tracing] signal POST failed (${res.status}): ${body}`);\n    } else if (debug) {\n      console.log(`[morph-tracing] shipped ${signals.length} signal(s)`);\n    }\n  } catch (err) {\n    console.warn(\n      '[morph-tracing] signal POST error:',\n      err instanceof Error ? err.message : err,\n    );\n  } finally {\n    clearTimeout(timer);\n  }\n}\n"],"mappings":"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","names":["traceloop","uuid"]}

package/dist/tracing/core.js

@@ -1,10 +1,10 @@
 import {
   MorphTracing,
   morphTracing
-} from "../chunk-IDS4XQ4T.js";
+} from "../chunk-KRTQESOL.js";
 import "../chunk-PICGNBUE.js";
-import "../chunk-MQMRIQNU.js";
-import "../chunk-XQ4T5QDT.js";
+import "../chunk-ZCEDWXQV.js";
+import "../chunk-CABQ652L.js";
 import "../chunk-PZ5AY32C.js";
 export {
   MorphTracing,

package/dist/tracing/index.cjs

@@ -48,11 +48,10 @@ var traceloop = __toESM(require("@traceloop/node-server-sdk"), 1);
 // tracing/otel.ts
 var otel_exports = {};
 __export(otel_exports, {
-  MORPH_METADATA_PREFIX: () => MORPH_METADATA_PREFIX,
   default: () => otel_default,
   metadata: () => metadata
 });
-var MORPH_METADATA_PREFIX = "morph";
+var RESERVED_KEYS = /* @__PURE__ */ new Set(["user_id", "convo_id", "event_id", "event_name"]);
 function uuid() {
   const c = globalThis.crypto;
   if (c?.randomUUID) return c.randomUUID();
@@ -64,11 +63,16 @@ function uuid() {
 }
 function metadata(opts) {
   const result = {
-    [`${MORPH_METADATA_PREFIX}.userId`]: opts.userId,
-    [`${MORPH_METADATA_PREFIX}.eventId`]: opts.eventId ?? uuid()
+    user_id: opts.userId,
+    event_id: opts.eventId ?? uuid()
   };
-  if (opts.convoId) result[`${MORPH_METADATA_PREFIX}.convoId`] = opts.convoId;
-  if (opts.eventName) result[`${MORPH_METADATA_PREFIX}.eventName`] = opts.eventName;
+  if (opts.convoId) result.convo_id = opts.convoId;
+  if (opts.eventName) result.event_name = opts.eventName;
+  if (opts.properties) {
+    for (const [key, value] of Object.entries(opts.properties)) {
+      if (!RESERVED_KEYS.has(key)) result[key] = value;
+    }
+  }
   return result;
 }
 var otel_default = { metadata };
@@ -152,9 +156,13 @@ function createInteractionApi(initial, traceContent) {
         userId: ctx.userId ?? "unknown",
         convoId: ctx.convoId,
         eventName: ctx.event,
-        eventId: ctx.eventId
+        eventId: ctx.eventId,
+        properties
       });
     },
+    run(fn) {
+      return Promise.resolve(withAssoc(fn));
+    },
     withSpan(params, fn) {
       const name = typeof params === "string" ? params : params.name;
       return Promise.resolve(withAssoc(() => traceloop.withTask({ name }, fn)));

package/dist/tracing/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../tracing/index.ts","../../tracing/core.ts","../../tracing/interaction.ts","../../tracing/otel.ts","../../tracing/signals.ts"],"sourcesContent":["/**\n * Morph Tracing — instrument the top AI SDKs and ship traces to Morph.\n *\n * @example\n * ```ts\n * import { morphTracing } from \"morphsdk/tracing\";\n *\n * const morph = morphTracing({ apiKey: process.env.MORPH_API_KEY });\n * // OpenAI / Anthropic / Vercel AI SDK calls are now traced automatically.\n *\n * const it = morph.begin({ userId: \"u1\", convoId: \"c1\", event: \"chat\" });\n * it.setInput(\"what's the weather?\");\n * const answer = await it.withTool({ name: \"get_weather\" }, () => getWeather());\n * await it.finish({ output: answer });\n *\n * // Feedback later:\n * await morph.trackSignal({ eventId: it.getEventId()!, name: \"thumbs_up\", sentiment: \"POSITIVE\" });\n * ```\n *\n * For the Vercel AI SDK, also see `morphsdk/tracing/otel`'s `metadata()` helper.\n */\nexport { morphTracing, MorphTracing } from './core.js';\nexport type { Interaction, Tracer } from './interaction.js';\nexport { metadata } from './otel.js';\nexport type {\n  MorphTracingConfig,\n  InstrumentModules,\n  TraceContext,\n  SpanParams,\n  ToolParams,\n  ToolSpan,\n  TrackToolParams,\n  FinishOptions,\n  SignalEvent,\n  MetadataOptions,\n} from './types.js';\n\nexport * as otel from './otel.js';\n","/**\n * Morph Tracing — core initialization.\n *\n * Thin Morph layer over OpenLLMetry / Traceloop. `morphTracing()` initializes\n * Traceloop with a JSON OTLP exporter pointed at Morph's ingest endpoint\n * (`${baseUrl}/v1/traces`, `Authorization: Bearer <apiKey>`) and returns a\n * `MorphTracing` handle for interactions, tools, and signals.\n *\n * We deliberately override Traceloop's default protobuf exporter with the\n * JSON-over-HTTP exporter so the ingest service can parse plain OTLP/JSON.\n */\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport * as traceloop from '@traceloop/node-server-sdk';\n\nimport { createInteractionApi, type Interaction, type Tracer } from './interaction.js';\nimport { metadata as buildMetadata } from './otel.js';\nimport { shipSignal } from './signals.js';\nimport type {\n  MetadataOptions,\n  MorphTracingConfig,\n  SignalEvent,\n  TraceContext,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.morphllm.com';\n\nexport interface ResolvedConfig {\n  apiKey: string;\n  baseUrl: string;\n  signalsEndpoint: string;\n  appName: string;\n  disableBatching: boolean;\n  traceContent: boolean;\n  debug: boolean;\n}\n\nfunction log(debug: boolean, ...args: unknown[]): void {\n  if (debug) console.log('[morph-tracing]', ...args);\n}\n\n/**\n * Handle returned by {@link morphTracing}. Create interactions with `begin()`,\n * get a non-interactive `tracer()`, attach feedback with `trackSignal()`, and\n * flush/shutdown the exporter.\n */\nexport class MorphTracing {\n  private readonly cfg: ResolvedConfig;\n  private readonly active = new Map<string, Interaction>();\n  readonly enabled: boolean;\n\n  constructor(config: MorphTracingConfig = {}) {\n    const debug = config.debug ?? process.env.MORPH_TRACING_DEBUG === '1';\n    const apiKey = config.apiKey ?? process.env.MORPH_API_KEY ?? '';\n    const baseUrlRaw =\n      config.baseUrl ?? process.env.MORPH_TRACES_URL ?? DEFAULT_BASE_URL;\n    const baseUrl = baseUrlRaw.replace(/\\/+$/, '');\n    const isProd = process.env.NODE_ENV === 'production';\n\n    this.cfg = {\n      apiKey,\n      baseUrl,\n      signalsEndpoint: `${baseUrl}/v1/signals`,\n      appName: config.appName ?? process.env.npm_package_name ?? 'morph-app',\n      disableBatching: config.disableBatching ?? !isProd,\n      traceContent: config.traceContent ?? true,\n      debug,\n    };\n\n    if (config.disabled) {\n      log(debug, 'disabled — no tracing initialized');\n      this.enabled = false;\n      return;\n    }\n    if (!apiKey) {\n      console.warn(\n        '[morph-tracing] No API key (set MORPH_API_KEY or pass { apiKey }). Tracing disabled.',\n      );\n      this.enabled = false;\n      return;\n    }\n\n    this.enabled = true;\n    if (config.useExternalOtel) {\n      // Customer drives their own NodeSDK; just register config, no SDK start.\n      traceloop.initialize({\n        baseUrl,\n        apiKey,\n        appName: this.cfg.appName,\n        tracingEnabled: false,\n        traceContent: this.cfg.traceContent,\n        silenceInitializationMessage: true,\n      });\n      log(debug, 'external OTEL mode — add createSpanProcessor() to your NodeSDK');\n      return;\n    }\n\n    const exporter = new OTLPTraceExporter({\n      url: `${baseUrl}/v1/traces`,\n      headers: { Authorization: `Bearer ${apiKey}`, ...config.headers },\n    });\n\n    traceloop.initialize({\n      baseUrl,\n      apiKey,\n      appName: this.cfg.appName,\n      exporter,\n      disableBatch: this.cfg.disableBatching,\n      traceContent: this.cfg.traceContent,\n      instrumentModules: config.instrumentModules as NonNullable<\n        Parameters<typeof traceloop.initialize>[0]\n      >['instrumentModules'],\n      tracingEnabled: true,\n      traceloopSyncEnabled: false,\n      silenceInitializationMessage: !debug,\n    });\n    log(\n      debug,\n      `initialized → ${baseUrl}/v1/traces (batching ${this.cfg.disableBatching ? 'off' : 'on'})`,\n    );\n  }\n\n  /** Begin a new traced interaction (a single user turn / agent run). */\n  begin(ctx: TraceContext & { userId: string; event?: string }): Interaction {\n    const interaction = createInteractionApi(ctx, this.cfg.traceContent);\n    this.active.set(interaction.getEventId()!, interaction);\n    return interaction;\n  }\n\n  /** Look up an in-flight interaction by its eventId. */\n  getActiveInteraction(eventId: string): Interaction | undefined {\n    return this.active.get(eventId);\n  }\n\n  /**\n   * Non-interactive tracer for batch jobs where you only care about\n   * spans/token usage, not a user-facing interaction.\n   */\n  tracer(globalProperties: Record<string, string> = {}): Tracer {\n    return createInteractionApi(\n      { userId: globalProperties.userId ?? 'batch', properties: globalProperties },\n      this.cfg.traceContent,\n    );\n  }\n\n  /** Build Vercel AI SDK telemetry metadata (see `morphsdk/tracing/otel`). */\n  metadata(opts: MetadataOptions): Record<string, string> {\n    return buildMetadata(opts);\n  }\n\n  /** Attach a feedback/quality signal to an interaction by eventId. */\n  async trackSignal(signal: SignalEvent | SignalEvent[]): Promise<void> {\n    if (!this.enabled) return;\n    const signals = Array.isArray(signal) ? signal : [signal];\n    await shipSignal(this.cfg.signalsEndpoint, this.cfg.apiKey, signals, this.cfg.debug);\n  }\n\n  /** Span processor for `useExternalOtel: true` integrations. */\n  createSpanProcessor(\n    options?: Parameters<typeof traceloop.createSpanProcessor>[0],\n  ): ReturnType<typeof traceloop.createSpanProcessor> {\n    return traceloop.createSpanProcessor({\n      apiKey: this.cfg.apiKey,\n      baseUrl: this.cfg.baseUrl,\n      ...options,\n    });\n  }\n\n  /** Flush any batched spans immediately. Safe to call when idle. */\n  async forceFlush(): Promise<void> {\n    if (!this.enabled) return;\n    try {\n      await traceloop.forceFlush();\n    } catch (err) {\n      log(this.cfg.debug, 'forceFlush error (ignored):', err);\n    }\n  }\n\n  /** Flush and stop tracing. */\n  async shutdown(): Promise<void> {\n    await this.forceFlush();\n  }\n}\n\n/** Initialize Morph Tracing and auto-instrument supported AI SDKs. */\nexport function morphTracing(config: MorphTracingConfig = {}): MorphTracing {\n  return new MorphTracing(config);\n}\n","/**\n * Morph Tracing — interactions, tools, and manual spans.\n *\n * An `Interaction` is one user turn / agent run. It threads association\n * properties (user_id / convo_id / event_id) onto every span created inside it —\n * including the auto-instrumented LLM spans — so a whole conversation stitches\n * together in the Morph UI. Built on Traceloop's `withTask` / `withTool` and a\n * manual tracer for already-completed tool spans.\n */\nimport { SpanStatusCode, type Span } from '@opentelemetry/api';\nimport * as traceloop from '@traceloop/node-server-sdk';\n\nimport { metadata as buildMetadata } from './otel.js';\nimport type {\n  FinishOptions,\n  SpanParams,\n  ToolParams,\n  ToolSpan,\n  TrackToolParams,\n  TraceContext,\n} from './types.js';\n\n// Traceloop semantic-convention attribute keys.\nconst ASSOC = 'traceloop.association.properties.';\nconst ENTITY_INPUT = 'traceloop.entity.input';\nconst ENTITY_OUTPUT = 'traceloop.entity.output';\nconst ENTITY_NAME = 'traceloop.entity.name';\nconst SPAN_KIND = 'traceloop.span.kind';\n\nfunction uuid(): string {\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  return 'xxxxxxxxxxxx4xxxyxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    return (ch === 'x' ? r : (r & 0x3) | 0x8).toString(16);\n  });\n}\n\nfunction asString(v: unknown): string {\n  if (v == null) return '';\n  return typeof v === 'string' ? v : JSON.stringify(v);\n}\n\nexport interface Interaction {\n  getEventId(): string | undefined;\n  setInput(input: string): void;\n  setProperty(key: string, value: string): void;\n  setProperties(props: Record<string, string>): void;\n  /** Run `fn` inside a traced task span; LLM calls within inherit attribution. */\n  withSpan<T>(params: SpanParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Run `fn` inside a traced tool span. */\n  withTool<T>(params: ToolParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Start a tool span you end manually. */\n  startToolSpan(params: ToolParams | string): ToolSpan;\n  /** Record an already-completed tool invocation. */\n  trackTool(params: TrackToolParams): void;\n  /** Metadata for the Vercel AI SDK `experimental_telemetry.metadata`. */\n  vercelAiSdkMetadata(): Record<string, string>;\n  /** End the interaction with its final output. */\n  finish(opts: FinishOptions | string): Promise<void>;\n}\n\nexport type Tracer = Pick<Interaction, 'withSpan' | 'withTool' | 'startToolSpan' | 'trackTool'>;\n\n/** Build the association-property bag Traceloop propagates onto child spans. */\nfunction associationProps(\n  ctx: TraceContext & { userId?: string },\n  extra: Record<string, string>,\n): Record<string, string> {\n  const props: Record<string, string> = { ...extra };\n  if (ctx.userId) props.user_id = ctx.userId;\n  if (ctx.convoId) props.convo_id = ctx.convoId;\n  if (ctx.eventId) props.event_id = ctx.eventId;\n  if (ctx.event) props.event_name = ctx.event;\n  return props;\n}\n\nexport function createInteractionApi(\n  initial: TraceContext & { userId?: string },\n  traceContent: boolean,\n): Interaction {\n  const ctx: TraceContext & { userId?: string } = {\n    ...initial,\n    eventId: initial.eventId ?? uuid(),\n  };\n  const properties: Record<string, string> = { ...(initial.properties ?? {}) };\n  let input = initial.input;\n\n  const withAssoc = <T>(fn: () => Promise<T> | T): Promise<T> | T =>\n    traceloop.withAssociationProperties(associationProps(ctx, properties), fn);\n\n  const toolName = (p: ToolParams | string) => (typeof p === 'string' ? p : p.name);\n\n  function startToolSpan(params: ToolParams | string): ToolSpan {\n    const name = toolName(params);\n    const span: Span = traceloop.getTraceloopTracer().startSpan(name);\n    span.setAttribute(SPAN_KIND, 'tool');\n    span.setAttribute(ENTITY_NAME, name);\n    for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n      span.setAttribute(ASSOC + k, v);\n    }\n    if (typeof params !== 'string' && params.properties) {\n      for (const [k, v] of Object.entries(params.properties)) span.setAttribute(k, v);\n    }\n    return {\n      setInput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_INPUT, asString(value));\n      },\n      setOutput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_OUTPUT, asString(value));\n      },\n      setError(error: Error | string) {\n        const e = typeof error === 'string' ? new Error(error) : error;\n        span.recordException(e);\n        span.setStatus({ code: SpanStatusCode.ERROR, message: e.message });\n      },\n      end() {\n        span.end();\n      },\n    };\n  }\n\n  return {\n    getEventId: () => ctx.eventId,\n    setInput(value: string) {\n      input = value;\n    },\n    setProperty(key: string, value: string) {\n      properties[key] = value;\n    },\n    setProperties(props: Record<string, string>) {\n      Object.assign(properties, props);\n    },\n    vercelAiSdkMetadata() {\n      return buildMetadata({\n        userId: ctx.userId ?? 'unknown',\n        convoId: ctx.convoId,\n        eventName: ctx.event,\n        eventId: ctx.eventId,\n      });\n    },\n    withSpan(params, fn) {\n      const name = typeof params === 'string' ? params : params.name;\n      return Promise.resolve(withAssoc(() => traceloop.withTask({ name }, fn)));\n    },\n    withTool(params, fn) {\n      const name = toolName(params);\n      const version = typeof params === 'string' ? undefined : params.version;\n      return Promise.resolve(withAssoc(() => traceloop.withTool({ name, version }, fn)));\n    },\n    startToolSpan,\n    trackTool(params: TrackToolParams) {\n      const span = startToolSpan({ name: params.name, properties: params.properties });\n      if (params.input !== undefined) span.setInput(params.input);\n      if (params.output !== undefined) span.setOutput(params.output);\n      if (params.error) span.setError(params.error);\n      span.end();\n    },\n    async finish(opts) {\n      const output = typeof opts === 'string' ? opts : opts.output;\n      if (typeof opts !== 'string' && opts.properties) Object.assign(properties, opts.properties);\n      // Emit a top-level interaction span carrying input/output + attribution.\n      await Promise.resolve(\n        withAssoc(() =>\n          traceloop.withTask({ name: ctx.event ?? 'interaction' }, () => {\n            const span = traceloop.getTraceloopTracer().startSpan(ctx.event ?? 'interaction');\n            span.setAttribute(SPAN_KIND, 'workflow');\n            for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n              span.setAttribute(ASSOC + k, v);\n            }\n            if (traceContent && input) span.setAttribute(ENTITY_INPUT, input);\n            if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);\n            span.end();\n          }),\n        ),\n      );\n    },\n  };\n}\n","/**\n * Morph Tracing — Vercel AI SDK helper.\n *\n * The Vercel AI SDK emits its own OpenTelemetry spans when you pass\n * `experimental_telemetry`. There is nothing to monkey-patch; instead you tag\n * each call with `metadata()` so Morph can attribute the resulting spans to a\n * user/conversation/event.\n *\n * @example\n * ```ts\n * import { generateText } from \"ai\";\n * import { metadata } from \"morphsdk/tracing/otel\";\n *\n * const res = await generateText({\n *   model: openai(\"gpt-4o\"),\n *   prompt: \"Hello!\",\n *   experimental_telemetry: {\n *     isEnabled: true,\n *     metadata: metadata({ userId: \"user-123\", convoId: \"convo-456\" }),\n *   },\n * });\n * ```\n */\nimport type { MetadataOptions } from './types.js';\n\n/** Prefix under which Morph reads attribution from AI SDK telemetry metadata. */\nexport const MORPH_METADATA_PREFIX = 'morph';\n\nfunction uuid(): string {\n  // Node 18+ and modern runtimes expose globalThis.crypto.randomUUID.\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  // Fallback: RFC4122-ish without crypto.\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    const v = ch === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Build the metadata object for the Vercel AI SDK's\n * `experimental_telemetry.metadata`. The values are propagated to every span the\n * AI SDK creates for that call. Generate a fresh `eventId` per call for grouping.\n */\nexport function metadata(opts: MetadataOptions): Record<string, string> {\n  const result: Record<string, string> = {\n    [`${MORPH_METADATA_PREFIX}.userId`]: opts.userId,\n    [`${MORPH_METADATA_PREFIX}.eventId`]: opts.eventId ?? uuid(),\n  };\n  if (opts.convoId) result[`${MORPH_METADATA_PREFIX}.convoId`] = opts.convoId;\n  if (opts.eventName) result[`${MORPH_METADATA_PREFIX}.eventName`] = opts.eventName;\n  return result;\n}\n\nexport default { metadata };\n","/**\n * Morph Tracing — feedback signals.\n *\n * Signals (👍/👎, free-text feedback, user edits) attach to an interaction by\n * `eventId` and ship directly over HTTP — they are low-volume and need no OTel\n * pipeline. Mirrors the request shape of `tools/fastapply/core.ts`.\n */\nimport type { SignalEvent } from './types.js';\n\nexport async function shipSignal(\n  endpoint: string,\n  apiKey: string,\n  signals: SignalEvent[],\n  debug = false,\n  timeoutMs = 10_000,\n): Promise<void> {\n  if (signals.length === 0) return;\n\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  try {\n    const res = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify({ signals }),\n      signal: controller.signal,\n    });\n    if (!res.ok) {\n      const body = await res.text().catch(() => '');\n      // Signals are best-effort; never throw into the caller's hot path.\n      console.warn(`[morph-tracing] signal POST failed (${res.status}): ${body}`);\n    } else if (debug) {\n      console.log(`[morph-tracing] shipped ${signals.length} signal(s)`);\n    }\n  } catch (err) {\n    console.warn(\n      '[morph-tracing] signal POST error:',\n      err instanceof Error ? err.message : err,\n    );\n  } finally {\n    clearTimeout(timer);\n  }\n}\n"],"mappings":"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","names":["traceloop","uuid"]}
+{"version":3,"sources":["../../tracing/index.ts","../../tracing/core.ts","../../tracing/interaction.ts","../../tracing/otel.ts","../../tracing/signals.ts"],"sourcesContent":["/**\n * Morph Tracing — instrument the top AI SDKs and ship traces to Morph.\n *\n * @example\n * ```ts\n * import { morphTracing } from \"morphsdk/tracing\";\n *\n * const morph = morphTracing({ apiKey: process.env.MORPH_API_KEY });\n * // OpenAI / Anthropic / Vercel AI SDK calls are now traced automatically.\n *\n * const it = morph.begin({ userId: \"u1\", convoId: \"c1\", event: \"chat\" });\n * it.setInput(\"what's the weather?\");\n * const answer = await it.withTool({ name: \"get_weather\" }, () => getWeather());\n * await it.finish({ output: answer });\n *\n * // Feedback later:\n * await morph.trackSignal({ eventId: it.getEventId()!, name: \"thumbs_up\", sentiment: \"POSITIVE\" });\n * ```\n *\n * For the Vercel AI SDK, also see `morphsdk/tracing/otel`'s `metadata()` helper.\n */\nexport { morphTracing, MorphTracing } from './core.js';\nexport type { Interaction, Tracer } from './interaction.js';\nexport { metadata } from './otel.js';\nexport type {\n  MorphTracingConfig,\n  InstrumentModules,\n  TraceContext,\n  SpanParams,\n  ToolParams,\n  ToolSpan,\n  TrackToolParams,\n  FinishOptions,\n  SignalEvent,\n  MetadataOptions,\n} from './types.js';\n\nexport * as otel from './otel.js';\n","/**\n * Morph Tracing — core initialization.\n *\n * Thin Morph layer over OpenLLMetry / Traceloop. `morphTracing()` initializes\n * Traceloop with a JSON OTLP exporter pointed at Morph's ingest endpoint\n * (`${baseUrl}/v1/traces`, `Authorization: Bearer <apiKey>`) and returns a\n * `MorphTracing` handle for interactions, tools, and signals.\n *\n * We deliberately override Traceloop's default protobuf exporter with the\n * JSON-over-HTTP exporter so the ingest service can parse plain OTLP/JSON.\n */\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport * as traceloop from '@traceloop/node-server-sdk';\n\nimport { createInteractionApi, type Interaction, type Tracer } from './interaction.js';\nimport { metadata as buildMetadata } from './otel.js';\nimport { shipSignal } from './signals.js';\nimport type {\n  MetadataOptions,\n  MorphTracingConfig,\n  SignalEvent,\n  TraceContext,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.morphllm.com';\n\nexport interface ResolvedConfig {\n  apiKey: string;\n  baseUrl: string;\n  signalsEndpoint: string;\n  appName: string;\n  disableBatching: boolean;\n  traceContent: boolean;\n  debug: boolean;\n}\n\nfunction log(debug: boolean, ...args: unknown[]): void {\n  if (debug) console.log('[morph-tracing]', ...args);\n}\n\n/**\n * Handle returned by {@link morphTracing}. Create interactions with `begin()`,\n * get a non-interactive `tracer()`, attach feedback with `trackSignal()`, and\n * flush/shutdown the exporter.\n */\nexport class MorphTracing {\n  private readonly cfg: ResolvedConfig;\n  private readonly active = new Map<string, Interaction>();\n  readonly enabled: boolean;\n\n  constructor(config: MorphTracingConfig = {}) {\n    const debug = config.debug ?? process.env.MORPH_TRACING_DEBUG === '1';\n    const apiKey = config.apiKey ?? process.env.MORPH_API_KEY ?? '';\n    const baseUrlRaw =\n      config.baseUrl ?? process.env.MORPH_TRACES_URL ?? DEFAULT_BASE_URL;\n    const baseUrl = baseUrlRaw.replace(/\\/+$/, '');\n    const isProd = process.env.NODE_ENV === 'production';\n\n    this.cfg = {\n      apiKey,\n      baseUrl,\n      signalsEndpoint: `${baseUrl}/v1/signals`,\n      appName: config.appName ?? process.env.npm_package_name ?? 'morph-app',\n      disableBatching: config.disableBatching ?? !isProd,\n      traceContent: config.traceContent ?? true,\n      debug,\n    };\n\n    if (config.disabled) {\n      log(debug, 'disabled — no tracing initialized');\n      this.enabled = false;\n      return;\n    }\n    if (!apiKey) {\n      console.warn(\n        '[morph-tracing] No API key (set MORPH_API_KEY or pass { apiKey }). Tracing disabled.',\n      );\n      this.enabled = false;\n      return;\n    }\n\n    this.enabled = true;\n    if (config.useExternalOtel) {\n      // Customer drives their own NodeSDK; just register config, no SDK start.\n      traceloop.initialize({\n        baseUrl,\n        apiKey,\n        appName: this.cfg.appName,\n        tracingEnabled: false,\n        traceContent: this.cfg.traceContent,\n        silenceInitializationMessage: true,\n      });\n      log(debug, 'external OTEL mode — add createSpanProcessor() to your NodeSDK');\n      return;\n    }\n\n    const exporter = new OTLPTraceExporter({\n      url: `${baseUrl}/v1/traces`,\n      headers: { Authorization: `Bearer ${apiKey}`, ...config.headers },\n    });\n\n    traceloop.initialize({\n      baseUrl,\n      apiKey,\n      appName: this.cfg.appName,\n      exporter,\n      disableBatch: this.cfg.disableBatching,\n      traceContent: this.cfg.traceContent,\n      instrumentModules: config.instrumentModules as NonNullable<\n        Parameters<typeof traceloop.initialize>[0]\n      >['instrumentModules'],\n      tracingEnabled: true,\n      traceloopSyncEnabled: false,\n      silenceInitializationMessage: !debug,\n    });\n    log(\n      debug,\n      `initialized → ${baseUrl}/v1/traces (batching ${this.cfg.disableBatching ? 'off' : 'on'})`,\n    );\n  }\n\n  /** Begin a new traced interaction (a single user turn / agent run). */\n  begin(ctx: TraceContext & { userId: string; event?: string }): Interaction {\n    const interaction = createInteractionApi(ctx, this.cfg.traceContent);\n    this.active.set(interaction.getEventId()!, interaction);\n    return interaction;\n  }\n\n  /** Look up an in-flight interaction by its eventId. */\n  getActiveInteraction(eventId: string): Interaction | undefined {\n    return this.active.get(eventId);\n  }\n\n  /**\n   * Non-interactive tracer for batch jobs where you only care about\n   * spans/token usage, not a user-facing interaction.\n   */\n  tracer(globalProperties: Record<string, string> = {}): Tracer {\n    return createInteractionApi(\n      { userId: globalProperties.userId ?? 'batch', properties: globalProperties },\n      this.cfg.traceContent,\n    );\n  }\n\n  /** Build Vercel AI SDK telemetry metadata (see `morphsdk/tracing/otel`). */\n  metadata(opts: MetadataOptions): Record<string, string> {\n    return buildMetadata(opts);\n  }\n\n  /** Attach a feedback/quality signal to an interaction by eventId. */\n  async trackSignal(signal: SignalEvent | SignalEvent[]): Promise<void> {\n    if (!this.enabled) return;\n    const signals = Array.isArray(signal) ? signal : [signal];\n    await shipSignal(this.cfg.signalsEndpoint, this.cfg.apiKey, signals, this.cfg.debug);\n  }\n\n  /** Span processor for `useExternalOtel: true` integrations. */\n  createSpanProcessor(\n    options?: Parameters<typeof traceloop.createSpanProcessor>[0],\n  ): ReturnType<typeof traceloop.createSpanProcessor> {\n    return traceloop.createSpanProcessor({\n      apiKey: this.cfg.apiKey,\n      baseUrl: this.cfg.baseUrl,\n      ...options,\n    });\n  }\n\n  /** Flush any batched spans immediately. Safe to call when idle. */\n  async forceFlush(): Promise<void> {\n    if (!this.enabled) return;\n    try {\n      await traceloop.forceFlush();\n    } catch (err) {\n      log(this.cfg.debug, 'forceFlush error (ignored):', err);\n    }\n  }\n\n  /** Flush and stop tracing. */\n  async shutdown(): Promise<void> {\n    await this.forceFlush();\n  }\n}\n\n/** Initialize Morph Tracing and auto-instrument supported AI SDKs. */\nexport function morphTracing(config: MorphTracingConfig = {}): MorphTracing {\n  return new MorphTracing(config);\n}\n","/**\n * Morph Tracing — interactions, tools, and manual spans.\n *\n * An `Interaction` is one user turn / agent run. It threads association\n * properties (user_id / convo_id / event_id) onto every span created inside it —\n * including the auto-instrumented LLM spans — so a whole conversation stitches\n * together in the Morph UI. Built on Traceloop's `withTask` / `withTool` and a\n * manual tracer for already-completed tool spans.\n */\nimport { SpanStatusCode, type Span } from '@opentelemetry/api';\nimport * as traceloop from '@traceloop/node-server-sdk';\n\nimport { metadata as buildMetadata } from './otel.js';\nimport type {\n  FinishOptions,\n  SpanParams,\n  ToolParams,\n  ToolSpan,\n  TrackToolParams,\n  TraceContext,\n} from './types.js';\n\n// Traceloop semantic-convention attribute keys.\nconst ASSOC = 'traceloop.association.properties.';\nconst ENTITY_INPUT = 'traceloop.entity.input';\nconst ENTITY_OUTPUT = 'traceloop.entity.output';\nconst ENTITY_NAME = 'traceloop.entity.name';\nconst SPAN_KIND = 'traceloop.span.kind';\n\nfunction uuid(): string {\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  return 'xxxxxxxxxxxx4xxxyxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    return (ch === 'x' ? r : (r & 0x3) | 0x8).toString(16);\n  });\n}\n\nfunction asString(v: unknown): string {\n  if (v == null) return '';\n  return typeof v === 'string' ? v : JSON.stringify(v);\n}\n\nexport interface Interaction {\n  getEventId(): string | undefined;\n  setInput(input: string): void;\n  setProperty(key: string, value: string): void;\n  setProperties(props: Record<string, string>): void;\n  /**\n   * Run `fn` with this interaction's association properties active — required so\n   * auto-instrumented OpenAI/Anthropic spans inherit user_id / convo_id / tags.\n   */\n  run<T>(fn: () => Promise<T> | T): Promise<T>;\n  /** Run `fn` inside a traced task span; LLM calls within inherit attribution. */\n  withSpan<T>(params: SpanParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Run `fn` inside a traced tool span. */\n  withTool<T>(params: ToolParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Start a tool span you end manually. */\n  startToolSpan(params: ToolParams | string): ToolSpan;\n  /** Record an already-completed tool invocation. */\n  trackTool(params: TrackToolParams): void;\n  /** Metadata for the Vercel AI SDK `experimental_telemetry.metadata`. */\n  vercelAiSdkMetadata(): Record<string, string>;\n  /** End the interaction with its final output. */\n  finish(opts: FinishOptions | string): Promise<void>;\n}\n\nexport type Tracer = Pick<Interaction, 'withSpan' | 'withTool' | 'startToolSpan' | 'trackTool'>;\n\n/** Build the association-property bag Traceloop propagates onto child spans. */\nfunction associationProps(\n  ctx: TraceContext & { userId?: string },\n  extra: Record<string, string>,\n): Record<string, string> {\n  const props: Record<string, string> = { ...extra };\n  if (ctx.userId) props.user_id = ctx.userId;\n  if (ctx.convoId) props.convo_id = ctx.convoId;\n  if (ctx.eventId) props.event_id = ctx.eventId;\n  if (ctx.event) props.event_name = ctx.event;\n  return props;\n}\n\nexport function createInteractionApi(\n  initial: TraceContext & { userId?: string },\n  traceContent: boolean,\n): Interaction {\n  const ctx: TraceContext & { userId?: string } = {\n    ...initial,\n    eventId: initial.eventId ?? uuid(),\n  };\n  const properties: Record<string, string> = { ...(initial.properties ?? {}) };\n  let input = initial.input;\n\n  const withAssoc = <T>(fn: () => Promise<T> | T): Promise<T> | T =>\n    traceloop.withAssociationProperties(associationProps(ctx, properties), fn);\n\n  const toolName = (p: ToolParams | string) => (typeof p === 'string' ? p : p.name);\n\n  function startToolSpan(params: ToolParams | string): ToolSpan {\n    const name = toolName(params);\n    const span: Span = traceloop.getTraceloopTracer().startSpan(name);\n    span.setAttribute(SPAN_KIND, 'tool');\n    span.setAttribute(ENTITY_NAME, name);\n    for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n      span.setAttribute(ASSOC + k, v);\n    }\n    if (typeof params !== 'string' && params.properties) {\n      for (const [k, v] of Object.entries(params.properties)) span.setAttribute(k, v);\n    }\n    return {\n      setInput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_INPUT, asString(value));\n      },\n      setOutput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_OUTPUT, asString(value));\n      },\n      setError(error: Error | string) {\n        const e = typeof error === 'string' ? new Error(error) : error;\n        span.recordException(e);\n        span.setStatus({ code: SpanStatusCode.ERROR, message: e.message });\n      },\n      end() {\n        span.end();\n      },\n    };\n  }\n\n  return {\n    getEventId: () => ctx.eventId,\n    setInput(value: string) {\n      input = value;\n    },\n    setProperty(key: string, value: string) {\n      properties[key] = value;\n    },\n    setProperties(props: Record<string, string>) {\n      Object.assign(properties, props);\n    },\n    vercelAiSdkMetadata() {\n      return buildMetadata({\n        userId: ctx.userId ?? 'unknown',\n        convoId: ctx.convoId,\n        eventName: ctx.event,\n        eventId: ctx.eventId,\n        properties,\n      });\n    },\n    run(fn) {\n      return Promise.resolve(withAssoc(fn));\n    },\n    withSpan(params, fn) {\n      const name = typeof params === 'string' ? params : params.name;\n      return Promise.resolve(withAssoc(() => traceloop.withTask({ name }, fn)));\n    },\n    withTool(params, fn) {\n      const name = toolName(params);\n      const version = typeof params === 'string' ? undefined : params.version;\n      return Promise.resolve(withAssoc(() => traceloop.withTool({ name, version }, fn)));\n    },\n    startToolSpan,\n    trackTool(params: TrackToolParams) {\n      const span = startToolSpan({ name: params.name, properties: params.properties });\n      if (params.input !== undefined) span.setInput(params.input);\n      if (params.output !== undefined) span.setOutput(params.output);\n      if (params.error) span.setError(params.error);\n      span.end();\n    },\n    async finish(opts) {\n      const output = typeof opts === 'string' ? opts : opts.output;\n      if (typeof opts !== 'string' && opts.properties) Object.assign(properties, opts.properties);\n      // Emit a top-level interaction span carrying input/output + attribution.\n      await Promise.resolve(\n        withAssoc(() =>\n          traceloop.withTask({ name: ctx.event ?? 'interaction' }, () => {\n            const span = traceloop.getTraceloopTracer().startSpan(ctx.event ?? 'interaction');\n            span.setAttribute(SPAN_KIND, 'workflow');\n            for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n              span.setAttribute(ASSOC + k, v);\n            }\n            if (traceContent && input) span.setAttribute(ENTITY_INPUT, input);\n            if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);\n            span.end();\n          }),\n        ),\n      );\n    },\n  };\n}\n","/**\n * Morph Tracing — Vercel AI SDK helper.\n *\n * The Vercel AI SDK emits its own OpenTelemetry spans when you pass\n * `experimental_telemetry`. There is nothing to monkey-patch; instead you tag\n * each call with `metadata()` so Morph can attribute the resulting spans to a\n * user/conversation/event.\n *\n * @example\n * ```ts\n * import { generateText } from \"ai\";\n * import { metadata } from \"morphsdk/tracing/otel\";\n *\n * const res = await generateText({\n *   model: openai(\"gpt-4o\"),\n *   prompt: \"Hello!\",\n *   experimental_telemetry: {\n *     isEnabled: true,\n *     metadata: metadata({ userId: \"user-123\", convoId: \"convo-456\" }),\n *   },\n * });\n * ```\n */\nimport type { MetadataOptions } from './types.js';\n\n/**\n * Reserved metadata keys Morph owns. Custom `properties` can't overwrite these,\n * so attribution (user_id / convo_id / event_id) stays intact.\n *\n * The AI SDK stores metadata as `ai.telemetry.metadata.<key>`; Traceloop's span\n * processor copies them to `traceloop.association.properties.<key>`, which is\n * what ClickHouse views read. Use snake_case names (user_id, convo_id, …).\n */\nconst RESERVED_KEYS = new Set(['user_id', 'convo_id', 'event_id', 'event_name']);\n\nfunction uuid(): string {\n  // Node 18+ and modern runtimes expose globalThis.crypto.randomUUID.\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  // Fallback: RFC4122-ish without crypto.\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    const v = ch === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Build the metadata object for the Vercel AI SDK's\n * `experimental_telemetry.metadata`. The values are propagated to every span the\n * AI SDK creates for that call. Generate a fresh `eventId` per call for grouping.\n */\nexport function metadata(opts: MetadataOptions): Record<string, string> {\n  const result: Record<string, string> = {\n    user_id: opts.userId,\n    event_id: opts.eventId ?? uuid(),\n  };\n  if (opts.convoId) result.convo_id = opts.convoId;\n  if (opts.eventName) result.event_name = opts.eventName;\n  if (opts.properties) {\n    for (const [key, value] of Object.entries(opts.properties)) {\n      if (!RESERVED_KEYS.has(key)) result[key] = value;\n    }\n  }\n  return result;\n}\n\nexport default { metadata };\n","/**\n * Morph Tracing — feedback signals.\n *\n * Signals (👍/👎, free-text feedback, user edits) attach to an interaction by\n * `eventId` and ship directly over HTTP — they are low-volume and need no OTel\n * pipeline. Mirrors the request shape of `tools/fastapply/core.ts`.\n */\nimport type { SignalEvent } from './types.js';\n\nexport async function shipSignal(\n  endpoint: string,\n  apiKey: string,\n  signals: SignalEvent[],\n  debug = false,\n  timeoutMs = 10_000,\n): Promise<void> {\n  if (signals.length === 0) return;\n\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  try {\n    const res = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify({ signals }),\n      signal: controller.signal,\n    });\n    if (!res.ok) {\n      const body = await res.text().catch(() => '');\n      // Signals are best-effort; never throw into the caller's hot path.\n      console.warn(`[morph-tracing] signal POST failed (${res.status}): ${body}`);\n    } else if (debug) {\n      console.log(`[morph-tracing] shipped ${signals.length} signal(s)`);\n    }\n  } catch (err) {\n    console.warn(\n      '[morph-tracing] signal POST error:',\n      err instanceof Error ? err.message : err,\n    );\n  } finally {\n    clearTimeout(timer);\n  }\n}\n"],"mappings":"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","names":["traceloop","uuid"]}

package/dist/tracing/index.d.ts

@@ -1,5 +1,5 @@
 export { MorphTracing, morphTracing } from './core.js';
 export { Interaction, Tracer } from './interaction.js';
-export { m as metadata, o as otel } from '../otel-Dt36jfxw.js';
+export { m as metadata, o as otel } from '../otel-Dk8kdhmZ.js';
 export { FinishOptions, InstrumentModules, MetadataOptions, MorphTracingConfig, SignalEvent, SpanParams, ToolParams, ToolSpan, TraceContext, TrackToolParams } from './types.js';
 import '@traceloop/node-server-sdk';

package/dist/tracing/index.js

@@ -1,13 +1,13 @@
 import {
   MorphTracing,
   morphTracing
-} from "../chunk-IDS4XQ4T.js";
+} from "../chunk-KRTQESOL.js";
 import "../chunk-PICGNBUE.js";
-import "../chunk-MQMRIQNU.js";
+import "../chunk-ZCEDWXQV.js";
 import {
   metadata,
   otel_exports
-} from "../chunk-XQ4T5QDT.js";
+} from "../chunk-CABQ652L.js";
 import "../chunk-PZ5AY32C.js";
 export {
   MorphTracing,

package/dist/tracing/interaction.cjs

@@ -37,7 +37,7 @@ var import_api = require("@opentelemetry/api");
 var traceloop = __toESM(require("@traceloop/node-server-sdk"), 1);
 
 // tracing/otel.ts
-var MORPH_METADATA_PREFIX = "morph";
+var RESERVED_KEYS = /* @__PURE__ */ new Set(["user_id", "convo_id", "event_id", "event_name"]);
 function uuid() {
   const c = globalThis.crypto;
   if (c?.randomUUID) return c.randomUUID();
@@ -49,11 +49,16 @@ function uuid() {
 }
 function metadata(opts) {
   const result = {
-    [`${MORPH_METADATA_PREFIX}.userId`]: opts.userId,
-    [`${MORPH_METADATA_PREFIX}.eventId`]: opts.eventId ?? uuid()
+    user_id: opts.userId,
+    event_id: opts.eventId ?? uuid()
   };
-  if (opts.convoId) result[`${MORPH_METADATA_PREFIX}.convoId`] = opts.convoId;
-  if (opts.eventName) result[`${MORPH_METADATA_PREFIX}.eventName`] = opts.eventName;
+  if (opts.convoId) result.convo_id = opts.convoId;
+  if (opts.eventName) result.event_name = opts.eventName;
+  if (opts.properties) {
+    for (const [key, value] of Object.entries(opts.properties)) {
+      if (!RESERVED_KEYS.has(key)) result[key] = value;
+    }
+  }
   return result;
 }
 
@@ -136,9 +141,13 @@ function createInteractionApi(initial, traceContent) {
         userId: ctx.userId ?? "unknown",
         convoId: ctx.convoId,
         eventName: ctx.event,
-        eventId: ctx.eventId
+        eventId: ctx.eventId,
+        properties
       });
     },
+    run(fn) {
+      return Promise.resolve(withAssoc(fn));
+    },
     withSpan(params, fn) {
       const name = typeof params === "string" ? params : params.name;
       return Promise.resolve(withAssoc(() => traceloop.withTask({ name }, fn)));

package/dist/tracing/interaction.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../tracing/interaction.ts","../../tracing/otel.ts"],"sourcesContent":["/**\n * Morph Tracing — interactions, tools, and manual spans.\n *\n * An `Interaction` is one user turn / agent run. It threads association\n * properties (user_id / convo_id / event_id) onto every span created inside it —\n * including the auto-instrumented LLM spans — so a whole conversation stitches\n * together in the Morph UI. Built on Traceloop's `withTask` / `withTool` and a\n * manual tracer for already-completed tool spans.\n */\nimport { SpanStatusCode, type Span } from '@opentelemetry/api';\nimport * as traceloop from '@traceloop/node-server-sdk';\n\nimport { metadata as buildMetadata } from './otel.js';\nimport type {\n  FinishOptions,\n  SpanParams,\n  ToolParams,\n  ToolSpan,\n  TrackToolParams,\n  TraceContext,\n} from './types.js';\n\n// Traceloop semantic-convention attribute keys.\nconst ASSOC = 'traceloop.association.properties.';\nconst ENTITY_INPUT = 'traceloop.entity.input';\nconst ENTITY_OUTPUT = 'traceloop.entity.output';\nconst ENTITY_NAME = 'traceloop.entity.name';\nconst SPAN_KIND = 'traceloop.span.kind';\n\nfunction uuid(): string {\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  return 'xxxxxxxxxxxx4xxxyxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    return (ch === 'x' ? r : (r & 0x3) | 0x8).toString(16);\n  });\n}\n\nfunction asString(v: unknown): string {\n  if (v == null) return '';\n  return typeof v === 'string' ? v : JSON.stringify(v);\n}\n\nexport interface Interaction {\n  getEventId(): string | undefined;\n  setInput(input: string): void;\n  setProperty(key: string, value: string): void;\n  setProperties(props: Record<string, string>): void;\n  /** Run `fn` inside a traced task span; LLM calls within inherit attribution. */\n  withSpan<T>(params: SpanParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Run `fn` inside a traced tool span. */\n  withTool<T>(params: ToolParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Start a tool span you end manually. */\n  startToolSpan(params: ToolParams | string): ToolSpan;\n  /** Record an already-completed tool invocation. */\n  trackTool(params: TrackToolParams): void;\n  /** Metadata for the Vercel AI SDK `experimental_telemetry.metadata`. */\n  vercelAiSdkMetadata(): Record<string, string>;\n  /** End the interaction with its final output. */\n  finish(opts: FinishOptions | string): Promise<void>;\n}\n\nexport type Tracer = Pick<Interaction, 'withSpan' | 'withTool' | 'startToolSpan' | 'trackTool'>;\n\n/** Build the association-property bag Traceloop propagates onto child spans. */\nfunction associationProps(\n  ctx: TraceContext & { userId?: string },\n  extra: Record<string, string>,\n): Record<string, string> {\n  const props: Record<string, string> = { ...extra };\n  if (ctx.userId) props.user_id = ctx.userId;\n  if (ctx.convoId) props.convo_id = ctx.convoId;\n  if (ctx.eventId) props.event_id = ctx.eventId;\n  if (ctx.event) props.event_name = ctx.event;\n  return props;\n}\n\nexport function createInteractionApi(\n  initial: TraceContext & { userId?: string },\n  traceContent: boolean,\n): Interaction {\n  const ctx: TraceContext & { userId?: string } = {\n    ...initial,\n    eventId: initial.eventId ?? uuid(),\n  };\n  const properties: Record<string, string> = { ...(initial.properties ?? {}) };\n  let input = initial.input;\n\n  const withAssoc = <T>(fn: () => Promise<T> | T): Promise<T> | T =>\n    traceloop.withAssociationProperties(associationProps(ctx, properties), fn);\n\n  const toolName = (p: ToolParams | string) => (typeof p === 'string' ? p : p.name);\n\n  function startToolSpan(params: ToolParams | string): ToolSpan {\n    const name = toolName(params);\n    const span: Span = traceloop.getTraceloopTracer().startSpan(name);\n    span.setAttribute(SPAN_KIND, 'tool');\n    span.setAttribute(ENTITY_NAME, name);\n    for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n      span.setAttribute(ASSOC + k, v);\n    }\n    if (typeof params !== 'string' && params.properties) {\n      for (const [k, v] of Object.entries(params.properties)) span.setAttribute(k, v);\n    }\n    return {\n      setInput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_INPUT, asString(value));\n      },\n      setOutput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_OUTPUT, asString(value));\n      },\n      setError(error: Error | string) {\n        const e = typeof error === 'string' ? new Error(error) : error;\n        span.recordException(e);\n        span.setStatus({ code: SpanStatusCode.ERROR, message: e.message });\n      },\n      end() {\n        span.end();\n      },\n    };\n  }\n\n  return {\n    getEventId: () => ctx.eventId,\n    setInput(value: string) {\n      input = value;\n    },\n    setProperty(key: string, value: string) {\n      properties[key] = value;\n    },\n    setProperties(props: Record<string, string>) {\n      Object.assign(properties, props);\n    },\n    vercelAiSdkMetadata() {\n      return buildMetadata({\n        userId: ctx.userId ?? 'unknown',\n        convoId: ctx.convoId,\n        eventName: ctx.event,\n        eventId: ctx.eventId,\n      });\n    },\n    withSpan(params, fn) {\n      const name = typeof params === 'string' ? params : params.name;\n      return Promise.resolve(withAssoc(() => traceloop.withTask({ name }, fn)));\n    },\n    withTool(params, fn) {\n      const name = toolName(params);\n      const version = typeof params === 'string' ? undefined : params.version;\n      return Promise.resolve(withAssoc(() => traceloop.withTool({ name, version }, fn)));\n    },\n    startToolSpan,\n    trackTool(params: TrackToolParams) {\n      const span = startToolSpan({ name: params.name, properties: params.properties });\n      if (params.input !== undefined) span.setInput(params.input);\n      if (params.output !== undefined) span.setOutput(params.output);\n      if (params.error) span.setError(params.error);\n      span.end();\n    },\n    async finish(opts) {\n      const output = typeof opts === 'string' ? opts : opts.output;\n      if (typeof opts !== 'string' && opts.properties) Object.assign(properties, opts.properties);\n      // Emit a top-level interaction span carrying input/output + attribution.\n      await Promise.resolve(\n        withAssoc(() =>\n          traceloop.withTask({ name: ctx.event ?? 'interaction' }, () => {\n            const span = traceloop.getTraceloopTracer().startSpan(ctx.event ?? 'interaction');\n            span.setAttribute(SPAN_KIND, 'workflow');\n            for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n              span.setAttribute(ASSOC + k, v);\n            }\n            if (traceContent && input) span.setAttribute(ENTITY_INPUT, input);\n            if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);\n            span.end();\n          }),\n        ),\n      );\n    },\n  };\n}\n","/**\n * Morph Tracing — Vercel AI SDK helper.\n *\n * The Vercel AI SDK emits its own OpenTelemetry spans when you pass\n * `experimental_telemetry`. There is nothing to monkey-patch; instead you tag\n * each call with `metadata()` so Morph can attribute the resulting spans to a\n * user/conversation/event.\n *\n * @example\n * ```ts\n * import { generateText } from \"ai\";\n * import { metadata } from \"morphsdk/tracing/otel\";\n *\n * const res = await generateText({\n *   model: openai(\"gpt-4o\"),\n *   prompt: \"Hello!\",\n *   experimental_telemetry: {\n *     isEnabled: true,\n *     metadata: metadata({ userId: \"user-123\", convoId: \"convo-456\" }),\n *   },\n * });\n * ```\n */\nimport type { MetadataOptions } from './types.js';\n\n/** Prefix under which Morph reads attribution from AI SDK telemetry metadata. */\nexport const MORPH_METADATA_PREFIX = 'morph';\n\nfunction uuid(): string {\n  // Node 18+ and modern runtimes expose globalThis.crypto.randomUUID.\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  // Fallback: RFC4122-ish without crypto.\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    const v = ch === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Build the metadata object for the Vercel AI SDK's\n * `experimental_telemetry.metadata`. The values are propagated to every span the\n * AI SDK creates for that call. Generate a fresh `eventId` per call for grouping.\n */\nexport function metadata(opts: MetadataOptions): Record<string, string> {\n  const result: Record<string, string> = {\n    [`${MORPH_METADATA_PREFIX}.userId`]: opts.userId,\n    [`${MORPH_METADATA_PREFIX}.eventId`]: opts.eventId ?? uuid(),\n  };\n  if (opts.convoId) result[`${MORPH_METADATA_PREFIX}.convoId`] = opts.convoId;\n  if (opts.eventName) result[`${MORPH_METADATA_PREFIX}.eventName`] = opts.eventName;\n  return result;\n}\n\nexport default { metadata };\n"],"mappings":"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","names":["uuid"]}
+{"version":3,"sources":["../../tracing/interaction.ts","../../tracing/otel.ts"],"sourcesContent":["/**\n * Morph Tracing — interactions, tools, and manual spans.\n *\n * An `Interaction` is one user turn / agent run. It threads association\n * properties (user_id / convo_id / event_id) onto every span created inside it —\n * including the auto-instrumented LLM spans — so a whole conversation stitches\n * together in the Morph UI. Built on Traceloop's `withTask` / `withTool` and a\n * manual tracer for already-completed tool spans.\n */\nimport { SpanStatusCode, type Span } from '@opentelemetry/api';\nimport * as traceloop from '@traceloop/node-server-sdk';\n\nimport { metadata as buildMetadata } from './otel.js';\nimport type {\n  FinishOptions,\n  SpanParams,\n  ToolParams,\n  ToolSpan,\n  TrackToolParams,\n  TraceContext,\n} from './types.js';\n\n// Traceloop semantic-convention attribute keys.\nconst ASSOC = 'traceloop.association.properties.';\nconst ENTITY_INPUT = 'traceloop.entity.input';\nconst ENTITY_OUTPUT = 'traceloop.entity.output';\nconst ENTITY_NAME = 'traceloop.entity.name';\nconst SPAN_KIND = 'traceloop.span.kind';\n\nfunction uuid(): string {\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  return 'xxxxxxxxxxxx4xxxyxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    return (ch === 'x' ? r : (r & 0x3) | 0x8).toString(16);\n  });\n}\n\nfunction asString(v: unknown): string {\n  if (v == null) return '';\n  return typeof v === 'string' ? v : JSON.stringify(v);\n}\n\nexport interface Interaction {\n  getEventId(): string | undefined;\n  setInput(input: string): void;\n  setProperty(key: string, value: string): void;\n  setProperties(props: Record<string, string>): void;\n  /**\n   * Run `fn` with this interaction's association properties active — required so\n   * auto-instrumented OpenAI/Anthropic spans inherit user_id / convo_id / tags.\n   */\n  run<T>(fn: () => Promise<T> | T): Promise<T>;\n  /** Run `fn` inside a traced task span; LLM calls within inherit attribution. */\n  withSpan<T>(params: SpanParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Run `fn` inside a traced tool span. */\n  withTool<T>(params: ToolParams | string, fn: () => Promise<T> | T): Promise<T>;\n  /** Start a tool span you end manually. */\n  startToolSpan(params: ToolParams | string): ToolSpan;\n  /** Record an already-completed tool invocation. */\n  trackTool(params: TrackToolParams): void;\n  /** Metadata for the Vercel AI SDK `experimental_telemetry.metadata`. */\n  vercelAiSdkMetadata(): Record<string, string>;\n  /** End the interaction with its final output. */\n  finish(opts: FinishOptions | string): Promise<void>;\n}\n\nexport type Tracer = Pick<Interaction, 'withSpan' | 'withTool' | 'startToolSpan' | 'trackTool'>;\n\n/** Build the association-property bag Traceloop propagates onto child spans. */\nfunction associationProps(\n  ctx: TraceContext & { userId?: string },\n  extra: Record<string, string>,\n): Record<string, string> {\n  const props: Record<string, string> = { ...extra };\n  if (ctx.userId) props.user_id = ctx.userId;\n  if (ctx.convoId) props.convo_id = ctx.convoId;\n  if (ctx.eventId) props.event_id = ctx.eventId;\n  if (ctx.event) props.event_name = ctx.event;\n  return props;\n}\n\nexport function createInteractionApi(\n  initial: TraceContext & { userId?: string },\n  traceContent: boolean,\n): Interaction {\n  const ctx: TraceContext & { userId?: string } = {\n    ...initial,\n    eventId: initial.eventId ?? uuid(),\n  };\n  const properties: Record<string, string> = { ...(initial.properties ?? {}) };\n  let input = initial.input;\n\n  const withAssoc = <T>(fn: () => Promise<T> | T): Promise<T> | T =>\n    traceloop.withAssociationProperties(associationProps(ctx, properties), fn);\n\n  const toolName = (p: ToolParams | string) => (typeof p === 'string' ? p : p.name);\n\n  function startToolSpan(params: ToolParams | string): ToolSpan {\n    const name = toolName(params);\n    const span: Span = traceloop.getTraceloopTracer().startSpan(name);\n    span.setAttribute(SPAN_KIND, 'tool');\n    span.setAttribute(ENTITY_NAME, name);\n    for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n      span.setAttribute(ASSOC + k, v);\n    }\n    if (typeof params !== 'string' && params.properties) {\n      for (const [k, v] of Object.entries(params.properties)) span.setAttribute(k, v);\n    }\n    return {\n      setInput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_INPUT, asString(value));\n      },\n      setOutput(value: unknown) {\n        if (traceContent) span.setAttribute(ENTITY_OUTPUT, asString(value));\n      },\n      setError(error: Error | string) {\n        const e = typeof error === 'string' ? new Error(error) : error;\n        span.recordException(e);\n        span.setStatus({ code: SpanStatusCode.ERROR, message: e.message });\n      },\n      end() {\n        span.end();\n      },\n    };\n  }\n\n  return {\n    getEventId: () => ctx.eventId,\n    setInput(value: string) {\n      input = value;\n    },\n    setProperty(key: string, value: string) {\n      properties[key] = value;\n    },\n    setProperties(props: Record<string, string>) {\n      Object.assign(properties, props);\n    },\n    vercelAiSdkMetadata() {\n      return buildMetadata({\n        userId: ctx.userId ?? 'unknown',\n        convoId: ctx.convoId,\n        eventName: ctx.event,\n        eventId: ctx.eventId,\n        properties,\n      });\n    },\n    run(fn) {\n      return Promise.resolve(withAssoc(fn));\n    },\n    withSpan(params, fn) {\n      const name = typeof params === 'string' ? params : params.name;\n      return Promise.resolve(withAssoc(() => traceloop.withTask({ name }, fn)));\n    },\n    withTool(params, fn) {\n      const name = toolName(params);\n      const version = typeof params === 'string' ? undefined : params.version;\n      return Promise.resolve(withAssoc(() => traceloop.withTool({ name, version }, fn)));\n    },\n    startToolSpan,\n    trackTool(params: TrackToolParams) {\n      const span = startToolSpan({ name: params.name, properties: params.properties });\n      if (params.input !== undefined) span.setInput(params.input);\n      if (params.output !== undefined) span.setOutput(params.output);\n      if (params.error) span.setError(params.error);\n      span.end();\n    },\n    async finish(opts) {\n      const output = typeof opts === 'string' ? opts : opts.output;\n      if (typeof opts !== 'string' && opts.properties) Object.assign(properties, opts.properties);\n      // Emit a top-level interaction span carrying input/output + attribution.\n      await Promise.resolve(\n        withAssoc(() =>\n          traceloop.withTask({ name: ctx.event ?? 'interaction' }, () => {\n            const span = traceloop.getTraceloopTracer().startSpan(ctx.event ?? 'interaction');\n            span.setAttribute(SPAN_KIND, 'workflow');\n            for (const [k, v] of Object.entries(associationProps(ctx, properties))) {\n              span.setAttribute(ASSOC + k, v);\n            }\n            if (traceContent && input) span.setAttribute(ENTITY_INPUT, input);\n            if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);\n            span.end();\n          }),\n        ),\n      );\n    },\n  };\n}\n","/**\n * Morph Tracing — Vercel AI SDK helper.\n *\n * The Vercel AI SDK emits its own OpenTelemetry spans when you pass\n * `experimental_telemetry`. There is nothing to monkey-patch; instead you tag\n * each call with `metadata()` so Morph can attribute the resulting spans to a\n * user/conversation/event.\n *\n * @example\n * ```ts\n * import { generateText } from \"ai\";\n * import { metadata } from \"morphsdk/tracing/otel\";\n *\n * const res = await generateText({\n *   model: openai(\"gpt-4o\"),\n *   prompt: \"Hello!\",\n *   experimental_telemetry: {\n *     isEnabled: true,\n *     metadata: metadata({ userId: \"user-123\", convoId: \"convo-456\" }),\n *   },\n * });\n * ```\n */\nimport type { MetadataOptions } from './types.js';\n\n/**\n * Reserved metadata keys Morph owns. Custom `properties` can't overwrite these,\n * so attribution (user_id / convo_id / event_id) stays intact.\n *\n * The AI SDK stores metadata as `ai.telemetry.metadata.<key>`; Traceloop's span\n * processor copies them to `traceloop.association.properties.<key>`, which is\n * what ClickHouse views read. Use snake_case names (user_id, convo_id, …).\n */\nconst RESERVED_KEYS = new Set(['user_id', 'convo_id', 'event_id', 'event_name']);\n\nfunction uuid(): string {\n  // Node 18+ and modern runtimes expose globalThis.crypto.randomUUID.\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  // Fallback: RFC4122-ish without crypto.\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (ch) => {\n    const r = (Math.random() * 16) | 0;\n    const v = ch === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Build the metadata object for the Vercel AI SDK's\n * `experimental_telemetry.metadata`. The values are propagated to every span the\n * AI SDK creates for that call. Generate a fresh `eventId` per call for grouping.\n */\nexport function metadata(opts: MetadataOptions): Record<string, string> {\n  const result: Record<string, string> = {\n    user_id: opts.userId,\n    event_id: opts.eventId ?? uuid(),\n  };\n  if (opts.convoId) result.convo_id = opts.convoId;\n  if (opts.eventName) result.event_name = opts.eventName;\n  if (opts.properties) {\n    for (const [key, value] of Object.entries(opts.properties)) {\n      if (!RESERVED_KEYS.has(key)) result[key] = value;\n    }\n  }\n  return result;\n}\n\nexport default { metadata };\n"],"mappings":"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","names":["uuid"]}

package/dist/tracing/interaction.d.ts

@@ -5,6 +5,11 @@ interface Interaction {
     setInput(input: string): void;
     setProperty(key: string, value: string): void;
     setProperties(props: Record<string, string>): void;
+    /**
+     * Run `fn` with this interaction's association properties active — required so
+     * auto-instrumented OpenAI/Anthropic spans inherit user_id / convo_id / tags.
+     */
+    run<T>(fn: () => Promise<T> | T): Promise<T>;
     /** Run `fn` inside a traced task span; LLM calls within inherit attribution. */
     withSpan<T>(params: SpanParams | string, fn: () => Promise<T> | T): Promise<T>;
     /** Run `fn` inside a traced tool span. */

package/dist/tracing/interaction.js

@@ -1,7 +1,7 @@
 import {
   createInteractionApi
-} from "../chunk-MQMRIQNU.js";
-import "../chunk-XQ4T5QDT.js";
+} from "../chunk-ZCEDWXQV.js";
+import "../chunk-CABQ652L.js";
 import "../chunk-PZ5AY32C.js";
 export {
   createInteractionApi

package/dist/tracing/otel.cjs

@@ -20,12 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // tracing/otel.ts
 var otel_exports = {};
 __export(otel_exports, {
-  MORPH_METADATA_PREFIX: () => MORPH_METADATA_PREFIX,
   default: () => otel_default,
   metadata: () => metadata
 });
 module.exports = __toCommonJS(otel_exports);
-var MORPH_METADATA_PREFIX = "morph";
+var RESERVED_KEYS = /* @__PURE__ */ new Set(["user_id", "convo_id", "event_id", "event_name"]);
 function uuid() {
   const c = globalThis.crypto;
   if (c?.randomUUID) return c.randomUUID();
@@ -37,17 +36,21 @@ function uuid() {
 }
 function metadata(opts) {
   const result = {
-    [`${MORPH_METADATA_PREFIX}.userId`]: opts.userId,
-    [`${MORPH_METADATA_PREFIX}.eventId`]: opts.eventId ?? uuid()
+    user_id: opts.userId,
+    event_id: opts.eventId ?? uuid()
   };
-  if (opts.convoId) result[`${MORPH_METADATA_PREFIX}.convoId`] = opts.convoId;
-  if (opts.eventName) result[`${MORPH_METADATA_PREFIX}.eventName`] = opts.eventName;
+  if (opts.convoId) result.convo_id = opts.convoId;
+  if (opts.eventName) result.event_name = opts.eventName;
+  if (opts.properties) {
+    for (const [key, value] of Object.entries(opts.properties)) {
+      if (!RESERVED_KEYS.has(key)) result[key] = value;
+    }
+  }
   return result;
 }
 var otel_default = { metadata };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  MORPH_METADATA_PREFIX,
   metadata
 });
 //# sourceMappingURL=otel.cjs.map