@morphllm/morphsdk 0.2.178 → 0.2.180

package/dist/tools/warp_grep/vercel.js

@@ -5,25 +5,25 @@ import {
   execute,
   vercel_default,
   warpGrepJsonSchema
-} from "../../chunk-HWRZZZT4.js";
+} from "../../chunk-OE2LFOYB.js";
 import "../../chunk-Q6QCHAMD.js";
 import {
   formatResult
-} from "../../chunk-PDPQV3DI.js";
+} from "../../chunk-35ZAMQ3A.js";
 import "../../chunk-GVGJIXV2.js";
 import "../../chunk-A4D2CIIT.js";
 import "../../chunk-63VHBANJ.js";
-import "../../chunk-VBPSPP4F.js";
+import "../../chunk-MWUFDBWQ.js";
 import "../../chunk-IA5K2HTC.js";
 import "../../chunk-CCJK3HTG.js";
 import "../../chunk-FBRNUWEB.js";
-import "../../chunk-RAPGIYHS.js";
-import "../../chunk-TGFSIZAJ.js";
-import "../../chunk-2U7YFUMU.js";
+import "../../chunk-TBVIOQ5O.js";
+import "../../chunk-WQC3YOER.js";
+import "../../chunk-4RARO46V.js";
 import "../../chunk-F3NCFNUX.js";
-import "../../chunk-FWVBSH2M.js";
-import "../../chunk-MF4VKKGF.js";
-import "../../chunk-WLXPKUEQ.js";
+import "../../chunk-X4VPV3A7.js";
+import "../../chunk-LDXKXBYN.js";
+import "../../chunk-4TMCQZNB.js";
 import "../../chunk-LKFZBBTD.js";
 import "../../chunk-PZ5AY32C.js";
 export {

package/dist/tracing/core.cjs

@@ -93,7 +93,7 @@ function associationProps(ctx, extra) {
   if (ctx.event) props.event_name = ctx.event;
   return props;
 }
-function createInteractionApi(initial, traceContent) {
+function createInteractionApi(initial, traceContent, onClose) {
   const ctx = {
     ...initial,
     eventId: initial.eventId ?? uuid2()
@@ -101,6 +101,7 @@ function createInteractionApi(initial, traceContent) {
   const properties = { ...initial.properties ?? {} };
   let input = initial.input;
   let workflowSpan = null;
+  let finished = false;
   const withAssoc = (fn) => traceloop.withAssociationProperties(associationProps(ctx, properties), fn);
   const workflowName = () => ctx.event ?? "interaction";
   function ensureWorkflowSpan() {
@@ -120,6 +121,25 @@ function createInteractionApi(initial, traceContent) {
       return import_api.context.with(import_api.trace.setSpan(import_api.context.active(), span), fn);
     });
   }
+  function closeWorkflowSpan(apply) {
+    if (finished) return;
+    withAssoc(() => {
+      const span = ensureWorkflowSpan();
+      apply(span);
+      span.end();
+    });
+    workflowSpan = null;
+    finished = true;
+    onClose?.(ctx.eventId);
+  }
+  function failWorkflowSpan(err) {
+    const e = err instanceof Error ? err : new Error(String(err));
+    closeWorkflowSpan((span) => {
+      span.recordException(e);
+      span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: e.message });
+      if (traceContent) span.setAttribute(ENTITY_OUTPUT, `ERROR: ${e.message}`);
+    });
+  }
   const toolName = (p) => typeof p === "string" ? p : p.name;
   function startToolSpan(params) {
     const name = toolName(params);
@@ -169,8 +189,13 @@ function createInteractionApi(initial, traceContent) {
         properties
       });
     },
-    run(fn) {
-      return Promise.resolve(withWorkflowContext(fn));
+    async run(fn) {
+      try {
+        return await Promise.resolve(withWorkflowContext(fn));
+      } catch (err) {
+        failWorkflowSpan(err);
+        throw err;
+      }
     },
     withSpan(params, fn) {
       const name = typeof params === "string" ? params : params.name;
@@ -192,14 +217,55 @@ function createInteractionApi(initial, traceContent) {
     async finish(opts) {
       const output = typeof opts === "string" ? opts : opts.output;
       if (typeof opts !== "string" && opts.properties) Object.assign(properties, opts.properties);
-      await Promise.resolve(
-        withAssoc(() => {
-          const span = ensureWorkflowSpan();
-          if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);
-          span.end();
-          workflowSpan = null;
-        })
-      );
+      closeWorkflowSpan((span) => {
+        if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);
+      });
+    }
+  };
+}
+function createNoopInteraction(initial) {
+  const ctx = {
+    ...initial,
+    eventId: initial.eventId ?? uuid2()
+  };
+  const properties = { ...initial.properties ?? {} };
+  const noopToolSpan = { setInput() {
+  }, setOutput() {
+  }, setError() {
+  }, end() {
+  } };
+  return {
+    getEventId: () => ctx.eventId,
+    setInput() {
+    },
+    setProperty(key, value) {
+      properties[key] = value;
+    },
+    setProperties(props) {
+      Object.assign(properties, props);
+    },
+    vercelAiSdkMetadata() {
+      return metadata({
+        userId: ctx.userId ?? "unknown",
+        convoId: ctx.convoId,
+        eventName: ctx.event,
+        eventId: ctx.eventId,
+        properties
+      });
+    },
+    async run(fn) {
+      return await fn();
+    },
+    async withSpan(_params, fn) {
+      return await fn();
+    },
+    async withTool(_params, fn) {
+      return await fn();
+    },
+    startToolSpan: () => noopToolSpan,
+    trackTool() {
+    },
+    async finish() {
     }
   };
 }
@@ -257,6 +323,7 @@ var MorphTracing = class {
       appName: config.appName ?? process.env.npm_package_name ?? "morph-app",
       disableBatching: config.disableBatching ?? !isProd,
       traceContent: config.traceContent ?? true,
+      headers: config.headers,
       debug
     };
     if (config.disabled) {
@@ -286,7 +353,7 @@ var MorphTracing = class {
     }
     const exporter = new import_exporter_trace_otlp_http.OTLPTraceExporter({
       url: `${baseUrl}/v1/traces`,
-      headers: { Authorization: `Bearer ${apiKey}`, ...config.headers }
+      headers: { Authorization: `Bearer ${apiKey}`, ...this.cfg.headers }
     });
     traceloop2.initialize({
       baseUrl,
@@ -305,9 +372,18 @@ var MorphTracing = class {
       `initialized \u2192 ${baseUrl}/v1/traces (batching ${this.cfg.disableBatching ? "off" : "on"})`
     );
   }
-  /** Begin a new traced interaction (a single user turn / agent run). */
+  /**
+   * Begin a new traced interaction (a single user turn / agent run). On a
+   * disabled instance this returns an inert no-op interaction — callbacks still
+   * run, but no spans are created or shipped.
+   */
   begin(ctx) {
-    const interaction = createInteractionApi(ctx, this.cfg.traceContent);
+    if (!this.enabled) return createNoopInteraction(ctx);
+    const interaction = createInteractionApi(
+      ctx,
+      this.cfg.traceContent,
+      (eventId) => this.active.delete(eventId)
+    );
     this.active.set(interaction.getEventId(), interaction);
     return interaction;
   }
@@ -320,12 +396,11 @@ var MorphTracing = class {
    * spans/token usage, not a user-facing interaction.
    */
   tracer(globalProperties = {}) {
-    return createInteractionApi(
-      { userId: globalProperties.userId ?? "batch", properties: globalProperties },
-      this.cfg.traceContent
-    );
+    const ctx = { userId: globalProperties.userId ?? "batch", properties: globalProperties };
+    if (!this.enabled) return createNoopInteraction(ctx);
+    return createInteractionApi(ctx, this.cfg.traceContent);
   }
-  /** Build Vercel AI SDK telemetry metadata (see `morphsdk/tracing/otel`). */
+  /** Build Vercel AI SDK telemetry metadata (see `@morphllm/morphsdk/tracing/otel`). */
   metadata(opts) {
     return metadata(opts);
   }
@@ -337,10 +412,15 @@ var MorphTracing = class {
   }
   /** Span processor for `useExternalOtel: true` integrations. */
   createSpanProcessor(options) {
+    const exporter = options?.exporter ?? new import_exporter_trace_otlp_http.OTLPTraceExporter({
+      url: `${this.cfg.baseUrl}/v1/traces`,
+      headers: { Authorization: `Bearer ${this.cfg.apiKey}`, ...this.cfg.headers }
+    });
     return traceloop2.createSpanProcessor({
       apiKey: this.cfg.apiKey,
       baseUrl: this.cfg.baseUrl,
-      ...options
+      ...options,
+      exporter
     });
   }
   /** Flush any batched spans immediately. Safe to call when idle. */

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 { context, SpanStatusCode, trace, 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  let workflowSpan: Span | null = null;\n\n  const withAssoc = <T>(fn: () => Promise<T> | T): Promise<T> | T =>\n    traceloop.withAssociationProperties(associationProps(ctx, properties), fn);\n\n  const workflowName = () => ctx.event ?? 'interaction';\n\n  /** Open the interaction workflow span once; stays active until finish(). */\n  function ensureWorkflowSpan(): Span {\n    if (workflowSpan) return workflowSpan;\n    const span = traceloop.getTraceloopTracer().startSpan(workflowName());\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    workflowSpan = span;\n    return span;\n  }\n\n  /** Run fn with association props and the workflow span as the active parent. */\n  function withWorkflowContext<T>(fn: () => Promise<T> | T): Promise<T> | T {\n    return withAssoc(() => {\n      const span = ensureWorkflowSpan();\n      return context.with(trace.setSpan(context.active(), span), fn);\n    });\n  }\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(withWorkflowContext(fn));\n    },\n    withSpan(params, fn) {\n      const name = typeof params === 'string' ? params : params.name;\n      return Promise.resolve(withWorkflowContext(() => 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(withWorkflowContext(() => 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      // End the workflow span opened by run()/withTool(); create one if finish() is called alone.\n      await Promise.resolve(\n        withAssoc(() => {\n          const span = ensureWorkflowSpan();\n          if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);\n          span.end();\n          workflowSpan = null;\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"]}
+{"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 {\n  createInteractionApi,\n  createNoopInteraction,\n  type Interaction,\n  type Tracer,\n} 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  headers?: Record<string, string>;\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      headers: config.headers,\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}`, ...this.cfg.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  /**\n   * Begin a new traced interaction (a single user turn / agent run). On a\n   * disabled instance this returns an inert no-op interaction — callbacks still\n   * run, but no spans are created or shipped.\n   */\n  begin(ctx: TraceContext & { userId: string; event?: string }): Interaction {\n    if (!this.enabled) return createNoopInteraction(ctx);\n    const interaction = createInteractionApi(ctx, this.cfg.traceContent, (eventId) =>\n      this.active.delete(eventId),\n    );\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    const ctx = { userId: globalProperties.userId ?? 'batch', properties: globalProperties };\n    if (!this.enabled) return createNoopInteraction(ctx);\n    return createInteractionApi(ctx, this.cfg.traceContent);\n  }\n\n  /** Build Vercel AI SDK telemetry metadata (see `@morphllm/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    // Traceloop's default exporter here is OTLP/protobuf, but Morph's ingest\n    // parses OTLP/JSON only — supply the JSON exporter unless the caller\n    // brings their own.\n    const exporter =\n      options?.exporter ??\n      new OTLPTraceExporter({\n        url: `${this.cfg.baseUrl}/v1/traces`,\n        headers: { Authorization: `Bearer ${this.cfg.apiKey}`, ...this.cfg.headers },\n      });\n    return traceloop.createSpanProcessor({\n      apiKey: this.cfg.apiKey,\n      baseUrl: this.cfg.baseUrl,\n      ...options,\n      exporter,\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 { context, SpanStatusCode, trace, 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  onClose?: (eventId: string) => void,\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  let workflowSpan: Span | null = null;\n  let finished = false;\n\n  const withAssoc = <T>(fn: () => Promise<T> | T): Promise<T> | T =>\n    traceloop.withAssociationProperties(associationProps(ctx, properties), fn);\n\n  const workflowName = () => ctx.event ?? 'interaction';\n\n  /** Open the interaction workflow span once; stays active until finish(). */\n  function ensureWorkflowSpan(): Span {\n    if (workflowSpan) return workflowSpan;\n    const span = traceloop.getTraceloopTracer().startSpan(workflowName());\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    workflowSpan = span;\n    return span;\n  }\n\n  /** Run fn with association props and the workflow span as the active parent. */\n  function withWorkflowContext<T>(fn: () => Promise<T> | T): Promise<T> | T {\n    return withAssoc(() => {\n      const span = ensureWorkflowSpan();\n      return context.with(trace.setSpan(context.active(), span), fn);\n    });\n  }\n\n  /** Close the workflow span exactly once, applying final attributes. */\n  function closeWorkflowSpan(apply: (span: Span) => void): void {\n    if (finished) return;\n    withAssoc(() => {\n      const span = ensureWorkflowSpan();\n      apply(span);\n      span.end();\n    });\n    workflowSpan = null;\n    finished = true;\n    onClose?.(ctx.eventId!);\n  }\n\n  /** Record an exception + ERROR status on the workflow span, then close it. */\n  function failWorkflowSpan(err: unknown): void {\n    const e = err instanceof Error ? err : new Error(String(err));\n    closeWorkflowSpan((span) => {\n      span.recordException(e);\n      span.setStatus({ code: SpanStatusCode.ERROR, message: e.message });\n      if (traceContent) span.setAttribute(ENTITY_OUTPUT, `ERROR: ${e.message}`);\n    });\n  }\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    async run(fn) {\n      try {\n        return await Promise.resolve(withWorkflowContext(fn));\n      } catch (err) {\n        // Natively record the failure on the workflow span and ship it, so a\n        // throwing interaction still lands in the trace as an errored span.\n        failWorkflowSpan(err);\n        throw err;\n      }\n    },\n    withSpan(params, fn) {\n      const name = typeof params === 'string' ? params : params.name;\n      return Promise.resolve(withWorkflowContext(() => 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(withWorkflowContext(() => 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      // No-op if run() already closed the span on error; otherwise end it now.\n      // (Creates one if finish() is called alone, i.e. begin() → finish().)\n      closeWorkflowSpan((span) => {\n        if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);\n      });\n    },\n  };\n}\n\n/**\n * Inert Interaction for disabled instances. Preserves control flow — run() /\n * withTool() still execute their callback and rethrow errors — but never touches\n * the tracer. Required because the OTel provider is a process-wide singleton: a\n * disabled instance that created real spans would ship them through whichever\n * enabled instance registered the provider.\n */\nexport function createNoopInteraction(initial: TraceContext & { userId?: string }): Interaction {\n  const ctx: TraceContext & { userId?: string } = {\n    ...initial,\n    eventId: initial.eventId ?? uuid(),\n  };\n  const properties: Record<string, string> = { ...(initial.properties ?? {}) };\n  const noopToolSpan: ToolSpan = { setInput() {}, setOutput() {}, setError() {}, end() {} };\n\n  return {\n    getEventId: () => ctx.eventId,\n    setInput() {},\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    async run(fn) {\n      return await fn();\n    },\n    async withSpan(_params, fn) {\n      return await fn();\n    },\n    async withTool(_params, fn) {\n      return await fn();\n    },\n    startToolSpan: () => noopToolSpan,\n    trackTool() {},\n    async finish() {},\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 \"@morphllm/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.d.ts

@@ -9,6 +9,7 @@ interface ResolvedConfig {
     appName: string;
     disableBatching: boolean;
     traceContent: boolean;
+    headers?: Record<string, string>;
     debug: boolean;
 }
 /**
@@ -21,7 +22,11 @@ declare class MorphTracing {
     private readonly active;
     readonly enabled: boolean;
     constructor(config?: MorphTracingConfig);
-    /** Begin a new traced interaction (a single user turn / agent run). */
+    /**
+     * Begin a new traced interaction (a single user turn / agent run). On a
+     * disabled instance this returns an inert no-op interaction — callbacks still
+     * run, but no spans are created or shipped.
+     */
     begin(ctx: TraceContext & {
         userId: string;
         event?: string;
@@ -33,7 +38,7 @@ declare class MorphTracing {
      * spans/token usage, not a user-facing interaction.
      */
     tracer(globalProperties?: Record<string, string>): Tracer;
-    /** Build Vercel AI SDK telemetry metadata (see `morphsdk/tracing/otel`). */
+    /** Build Vercel AI SDK telemetry metadata (see `@morphllm/morphsdk/tracing/otel`). */
     metadata(opts: MetadataOptions): Record<string, string>;
     /** Attach a feedback/quality signal to an interaction by eventId. */
     trackSignal(signal: SignalEvent | SignalEvent[]): Promise<void>;

package/dist/tracing/core.js

@@ -1,10 +1,10 @@
 import {
   MorphTracing,
   morphTracing
-} from "../chunk-AVJJABHB.js";
+} from "../chunk-STJTJDAV.js";
 import "../chunk-PICGNBUE.js";
-import "../chunk-LX54AI3F.js";
-import "../chunk-CABQ652L.js";
+import "../chunk-IDMKQWQG.js";
+import "../chunk-TLXVGE4R.js";
 import "../chunk-PZ5AY32C.js";
 export {
   MorphTracing,

package/dist/tracing/index.cjs

@@ -103,7 +103,7 @@ function associationProps(ctx, extra) {
   if (ctx.event) props.event_name = ctx.event;
   return props;
 }
-function createInteractionApi(initial, traceContent) {
+function createInteractionApi(initial, traceContent, onClose) {
   const ctx = {
     ...initial,
     eventId: initial.eventId ?? uuid2()
@@ -111,6 +111,7 @@ function createInteractionApi(initial, traceContent) {
   const properties = { ...initial.properties ?? {} };
   let input = initial.input;
   let workflowSpan = null;
+  let finished = false;
   const withAssoc = (fn) => traceloop.withAssociationProperties(associationProps(ctx, properties), fn);
   const workflowName = () => ctx.event ?? "interaction";
   function ensureWorkflowSpan() {
@@ -130,6 +131,25 @@ function createInteractionApi(initial, traceContent) {
       return import_api.context.with(import_api.trace.setSpan(import_api.context.active(), span), fn);
     });
   }
+  function closeWorkflowSpan(apply) {
+    if (finished) return;
+    withAssoc(() => {
+      const span = ensureWorkflowSpan();
+      apply(span);
+      span.end();
+    });
+    workflowSpan = null;
+    finished = true;
+    onClose?.(ctx.eventId);
+  }
+  function failWorkflowSpan(err) {
+    const e = err instanceof Error ? err : new Error(String(err));
+    closeWorkflowSpan((span) => {
+      span.recordException(e);
+      span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: e.message });
+      if (traceContent) span.setAttribute(ENTITY_OUTPUT, `ERROR: ${e.message}`);
+    });
+  }
   const toolName = (p) => typeof p === "string" ? p : p.name;
   function startToolSpan(params) {
     const name = toolName(params);
@@ -179,8 +199,13 @@ function createInteractionApi(initial, traceContent) {
         properties
       });
     },
-    run(fn) {
-      return Promise.resolve(withWorkflowContext(fn));
+    async run(fn) {
+      try {
+        return await Promise.resolve(withWorkflowContext(fn));
+      } catch (err) {
+        failWorkflowSpan(err);
+        throw err;
+      }
     },
     withSpan(params, fn) {
       const name = typeof params === "string" ? params : params.name;
@@ -202,14 +227,55 @@ function createInteractionApi(initial, traceContent) {
     async finish(opts) {
       const output = typeof opts === "string" ? opts : opts.output;
       if (typeof opts !== "string" && opts.properties) Object.assign(properties, opts.properties);
-      await Promise.resolve(
-        withAssoc(() => {
-          const span = ensureWorkflowSpan();
-          if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);
-          span.end();
-          workflowSpan = null;
-        })
-      );
+      closeWorkflowSpan((span) => {
+        if (traceContent) span.setAttribute(ENTITY_OUTPUT, output);
+      });
+    }
+  };
+}
+function createNoopInteraction(initial) {
+  const ctx = {
+    ...initial,
+    eventId: initial.eventId ?? uuid2()
+  };
+  const properties = { ...initial.properties ?? {} };
+  const noopToolSpan = { setInput() {
+  }, setOutput() {
+  }, setError() {
+  }, end() {
+  } };
+  return {
+    getEventId: () => ctx.eventId,
+    setInput() {
+    },
+    setProperty(key, value) {
+      properties[key] = value;
+    },
+    setProperties(props) {
+      Object.assign(properties, props);
+    },
+    vercelAiSdkMetadata() {
+      return metadata({
+        userId: ctx.userId ?? "unknown",
+        convoId: ctx.convoId,
+        eventName: ctx.event,
+        eventId: ctx.eventId,
+        properties
+      });
+    },
+    async run(fn) {
+      return await fn();
+    },
+    async withSpan(_params, fn) {
+      return await fn();
+    },
+    async withTool(_params, fn) {
+      return await fn();
+    },
+    startToolSpan: () => noopToolSpan,
+    trackTool() {
+    },
+    async finish() {
     }
   };
 }
@@ -267,6 +333,7 @@ var MorphTracing = class {
       appName: config.appName ?? process.env.npm_package_name ?? "morph-app",
       disableBatching: config.disableBatching ?? !isProd,
       traceContent: config.traceContent ?? true,
+      headers: config.headers,
       debug
     };
     if (config.disabled) {
@@ -296,7 +363,7 @@ var MorphTracing = class {
     }
     const exporter = new import_exporter_trace_otlp_http.OTLPTraceExporter({
       url: `${baseUrl}/v1/traces`,
-      headers: { Authorization: `Bearer ${apiKey}`, ...config.headers }
+      headers: { Authorization: `Bearer ${apiKey}`, ...this.cfg.headers }
     });
     traceloop2.initialize({
       baseUrl,
@@ -315,9 +382,18 @@ var MorphTracing = class {
       `initialized \u2192 ${baseUrl}/v1/traces (batching ${this.cfg.disableBatching ? "off" : "on"})`
     );
   }
-  /** Begin a new traced interaction (a single user turn / agent run). */
+  /**
+   * Begin a new traced interaction (a single user turn / agent run). On a
+   * disabled instance this returns an inert no-op interaction — callbacks still
+   * run, but no spans are created or shipped.
+   */
   begin(ctx) {
-    const interaction = createInteractionApi(ctx, this.cfg.traceContent);
+    if (!this.enabled) return createNoopInteraction(ctx);
+    const interaction = createInteractionApi(
+      ctx,
+      this.cfg.traceContent,
+      (eventId) => this.active.delete(eventId)
+    );
     this.active.set(interaction.getEventId(), interaction);
     return interaction;
   }
@@ -330,12 +406,11 @@ var MorphTracing = class {
    * spans/token usage, not a user-facing interaction.
    */
   tracer(globalProperties = {}) {
-    return createInteractionApi(
-      { userId: globalProperties.userId ?? "batch", properties: globalProperties },
-      this.cfg.traceContent
-    );
+    const ctx = { userId: globalProperties.userId ?? "batch", properties: globalProperties };
+    if (!this.enabled) return createNoopInteraction(ctx);
+    return createInteractionApi(ctx, this.cfg.traceContent);
   }
-  /** Build Vercel AI SDK telemetry metadata (see `morphsdk/tracing/otel`). */
+  /** Build Vercel AI SDK telemetry metadata (see `@morphllm/morphsdk/tracing/otel`). */
   metadata(opts) {
     return metadata(opts);
   }
@@ -347,10 +422,15 @@ var MorphTracing = class {
   }
   /** Span processor for `useExternalOtel: true` integrations. */
   createSpanProcessor(options) {
+    const exporter = options?.exporter ?? new import_exporter_trace_otlp_http.OTLPTraceExporter({
+      url: `${this.cfg.baseUrl}/v1/traces`,
+      headers: { Authorization: `Bearer ${this.cfg.apiKey}`, ...this.cfg.headers }
+    });
     return traceloop2.createSpanProcessor({
       apiKey: this.cfg.apiKey,
       baseUrl: this.cfg.baseUrl,
-      ...options
+      ...options,
+      exporter
     });
   }
   /** Flush any batched spans immediately. Safe to call when idle. */