@morphllm/morphsdk 0.2.179 → 0.2.180

package/dist/chunk-WGIMYL4A.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../tracing/core.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"],"mappings":"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","names":[]}