@morsehq-dev/sdk 0.4.1-rc.1 → 0.5.0-rc.1

package/dist/{chunk-LTKGLXAE.js → chunk-UEKQIRRA.js}

@@ -134,66 +134,6 @@ var init_env = __esm({
   }
 });
 
-// src/_internal/spans.ts
-function generateTraceId() {
-  return randomHex(32);
-}
-function generateSpanId() {
-  return randomHex(32);
-}
-function randomHex(chars) {
-  const bytes = new Uint8Array(Math.ceil(chars / 2));
-  const cryptoObj = globalThis.crypto;
-  if (cryptoObj?.getRandomValues) {
-    cryptoObj.getRandomValues(bytes);
-  } else {
-    for (let i = 0; i < bytes.length; i++) {
-      bytes[i] = Math.floor(Math.random() * 256);
-    }
-  }
-  let hex = "";
-  for (const b of bytes) {
-    hex += b.toString(16).padStart(2, "0");
-  }
-  return hex.slice(0, chars);
-}
-function nowIso() {
-  return (/* @__PURE__ */ new Date()).toISOString();
-}
-function spanToWire(span) {
-  const out = {};
-  for (const [k, v] of Object.entries(span)) {
-    if (v !== void 0 && v !== null) {
-      out[k] = v;
-    }
-  }
-  return out;
-}
-function buildTraceEntry(fields, spans) {
-  return {
-    trace: fields,
-    spans: spans.map(spanToWire)
-  };
-}
-var SpanType;
-var init_spans = __esm({
-  "src/_internal/spans.ts"() {
-    SpanType = {
-      AGENT: "agent",
-      LLM: "llm",
-      TOOL: "tool",
-      HTTP: "http",
-      DB: "db",
-      CUSTOM: "custom",
-      MEMORY: "memory",
-      // MHQ-482: matches Python's `SpanType.RETRIEVER` (apps/sdk/python/src/morse_ai/spans.py).
-      // @beta — retriever span type is subject to change before SDK v1.0 (see
-      // the plain-LangChain adapter's on_retriever_* callbacks in src/langchain/).
-      RETRIEVER: "retriever"
-    };
-  }
-});
-
 // src/_internal/redaction.ts
 function buildRedactionConfig(options) {
   const opts = options ?? {};
@@ -381,6 +321,390 @@ var init_redaction = __esm({
     MAX_DEPTH = 10;
   }
 });
+
+// src/_internal/diagnostics.ts
+function setRedactionConfig(config) {
+  activeRedactionConfig = config;
+}
+function setLevel(raw) {
+  if (!raw) return;
+  const value = String(raw).trim().toLowerCase();
+  if (!VALID_LEVELS.has(value)) return;
+  level = value;
+}
+function transmissionAllowed() {
+  if (isTelemetryDisabled() || isDisabled()) return false;
+  return level !== LEVEL_OFF;
+}
+function checkBucket(buckets, key, limit, windowMs) {
+  const now = Date.now();
+  const bucket = buckets.get(key) ?? [];
+  const cutoff = now - windowMs;
+  while (bucket.length > 0 && bucket[0] < cutoff) bucket.shift();
+  if (bucket.length >= limit) {
+    buckets.set(key, bucket);
+    return false;
+  }
+  bucket.push(now);
+  buckets.set(key, bucket);
+  return true;
+}
+function checkRateLimit(fingerprint) {
+  const limit = level === LEVEL_DEBUG ? RATE_LIMIT_PER_WINDOW_DEBUG : RATE_LIMIT_PER_WINDOW;
+  return checkBucket(rateBuckets, fingerprint, limit, RATE_WINDOW_MS);
+}
+function isMorseFrame(line) {
+  return MORSE_PATH_MARKERS.some((marker) => line.includes(marker));
+}
+function parseFrame(line) {
+  const withParens = /^\s*at\s+(.+?)\s+\((.+?):(\d+):(\d+)\)\s*$/.exec(line);
+  if (withParens) {
+    return {
+      fn: withParens[1],
+      file: withParens[2],
+      lineNo: Number(withParens[3])
+    };
+  }
+  const bare = /^\s*at\s+(.+?):(\d+):(\d+)\s*$/.exec(line);
+  if (bare) return { file: bare[1], lineNo: Number(bare[2]) };
+  return {};
+}
+function buildScopedStack(error) {
+  const frames = [];
+  try {
+    const stack = error instanceof Error ? error.stack ?? "" : "";
+    if (!stack) return frames;
+    let elided = 0;
+    for (const raw of stack.split("\n")) {
+      if (!raw.trim().startsWith("at ")) continue;
+      if (isMorseFrame(raw)) {
+        if (elided > 0) {
+          frames.push({ elided });
+          elided = 0;
+        }
+        const { file, lineNo, fn } = parseFrame(raw);
+        const frame = {};
+        if (file) frame.file = file.split(/[\\/]/).slice(-3).join("/");
+        if (typeof lineNo === "number" && !Number.isNaN(lineNo)) frame.line = lineNo;
+        if (fn) frame.function = fn.slice(0, 255);
+        frames.push(frame);
+      } else {
+        elided += 1;
+      }
+    }
+    if (elided > 0) frames.push({ elided });
+  } catch {
+  }
+  return frames.length > MAX_STACK_ENTRIES ? frames.slice(-MAX_STACK_ENTRIES) : frames;
+}
+function redactedMessage(error) {
+  let raw;
+  try {
+    raw = error instanceof Error ? error.message : String(error);
+  } catch {
+    return "";
+  }
+  try {
+    if (activeRedactionConfig) {
+      const out = redactValue(raw, activeRedactionConfig);
+      raw = typeof out === "string" ? out : String(out);
+    }
+  } catch {
+    return "<redaction unavailable>";
+  }
+  return raw.slice(0, MAX_MESSAGE_CHARS);
+}
+function scrubExtra(extra) {
+  const out = {};
+  if (!extra) return out;
+  for (const [key, value] of Object.entries(extra)) {
+    if (ALLOWED_EXTRA_KEYS.has(key) && value != null) {
+      out[key] = String(value).slice(0, 255);
+    }
+  }
+  return out;
+}
+function recordDrop(reason, category, quantity = 1) {
+  try {
+    if (quantity <= 0) return;
+    const key = `${reason}:${category}`;
+    const existing = counters.get(key);
+    if (existing) existing.quantity += quantity;
+    else counters.set(key, { reason, category, quantity });
+    if (checkBucket(localLogBuckets, `drop:${key}`, LOCAL_LOG_LIMIT_PER_WINDOW, LOCAL_LOG_WINDOW_MS)) {
+      console.warn(`morse: dropped ${quantity} ${category} (${reason}) \u2014 telemetry is being lost`);
+    }
+  } catch {
+  }
+}
+function drainCounters() {
+  if (counters.size === 0) return [];
+  const drained = [...counters.values()];
+  counters.clear();
+  return drained;
+}
+function report(error, options) {
+  if (reporting) return;
+  reporting = true;
+  try {
+    const errClass = error instanceof Error ? error.name : "Error";
+    const errMessage = error instanceof Error ? error.message : String(error);
+    if (checkBucket(
+      localLogBuckets,
+      options.fingerprint,
+      LOCAL_LOG_LIMIT_PER_WINDOW,
+      LOCAL_LOG_WINDOW_MS
+    )) {
+      const line = `morse internal error [${options.fingerprint}]: ${errClass}: ${errMessage}`;
+      if (isDebug()) console.error(line, error);
+      else console.warn(line);
+    }
+    if (!transmissionAllowed()) return;
+    if (!checkRateLimit(options.fingerprint)) return;
+    enqueue({
+      kind: "error",
+      fingerprint: options.fingerprint.slice(0, 255),
+      error_type: errClass.slice(0, 255),
+      message: redactedMessage(error),
+      stack: buildScopedStack(error),
+      sdk_language: "typescript",
+      sdk_version: sdkVersion(),
+      runtime_version: runtimeVersion(),
+      platform: platformLabel(),
+      extra: scrubExtra(options.extra)
+    });
+  } catch {
+  } finally {
+    reporting = false;
+  }
+}
+function sdkVersion() {
+  return SDK_VERSION;
+}
+function runtimeVersion() {
+  try {
+    const proc = globalThis.process;
+    return proc?.version ? String(proc.version) : "";
+  } catch {
+    return "";
+  }
+}
+function platformLabel() {
+  try {
+    const proc = globalThis.process;
+    if (proc?.platform) return `${proc.platform}-${proc.arch ?? ""}`.slice(0, 128);
+    return "browser";
+  } catch {
+    return "";
+  }
+}
+function enqueue(event) {
+  pending.push(event);
+  while (pending.length > MAX_PENDING) pending.shift();
+  ensureTimer();
+}
+function ensureTimer() {
+  if (timer !== null) return;
+  try {
+    timer = setInterval(() => {
+      void flushOnce();
+    }, FLUSH_INTERVAL_MS);
+    timer?.unref?.();
+  } catch {
+    timer = null;
+  }
+}
+function breakerBlocks() {
+  return breakerOpenUntil > 0 && Date.now() < breakerOpenUntil;
+}
+function recordResult(ok) {
+  if (ok) {
+    consecutiveFailures = 0;
+    breakerOpenUntil = 0;
+    return;
+  }
+  consecutiveFailures += 1;
+  if (consecutiveFailures >= BREAKER_THRESHOLD) {
+    breakerOpenUntil = Date.now() + BREAKER_COOLDOWN_MS;
+  }
+}
+async function flushOnce() {
+  try {
+    const batch = pending.splice(0, MAX_BATCH_EVENTS);
+    const drained = drainCounters();
+    if (drained.length > 0) {
+      batch.push({
+        kind: "counters",
+        fingerprint: "morse.transport.delivery",
+        counters: drained,
+        sdk_language: "typescript",
+        sdk_version: sdkVersion()
+      });
+    }
+    if (batch.length === 0) return;
+    if (breakerBlocks() || !transmissionAllowed()) return;
+    const target = resolveTarget();
+    if (target === null) return;
+    let response;
+    try {
+      response = await fetch(target.url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${target.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ events: batch })
+      });
+    } catch {
+      recordResult(false);
+      return;
+    }
+    setLevel(response.headers.get("X-Morse-Diagnostics"));
+    recordResult(response.ok);
+  } catch {
+  }
+}
+function resolveTarget() {
+  try {
+    const apiKey = getApiKey();
+    if (!apiKey) return null;
+    const url = deriveDiagnosticsUrl(String(getEndpoint() ?? ""));
+    if (!url) return null;
+    return { apiKey: String(apiKey), url };
+  } catch {
+    return null;
+  }
+}
+function deriveDiagnosticsUrl(tracesEndpoint) {
+  try {
+    const parsed = new URL(tracesEndpoint);
+    return `${parsed.protocol}//${parsed.host}${DIAGNOSTICS_PATH}`;
+  } catch {
+    return null;
+  }
+}
+function _resetForTesting() {
+  rateBuckets.clear();
+  localLogBuckets.clear();
+  counters.clear();
+  pending = [];
+  if (timer !== null) {
+    clearInterval(timer);
+    timer = null;
+  }
+  consecutiveFailures = 0;
+  breakerOpenUntil = 0;
+  reporting = false;
+  level = LEVEL_ERROR;
+  activeRedactionConfig = null;
+}
+var SDK_VERSION, LEVEL_OFF, LEVEL_ERROR, LEVEL_DEBUG, VALID_LEVELS, level, RATE_WINDOW_MS, RATE_LIMIT_PER_WINDOW, RATE_LIMIT_PER_WINDOW_DEBUG, rateBuckets, LOCAL_LOG_WINDOW_MS, LOCAL_LOG_LIMIT_PER_WINDOW, localLogBuckets, MAX_STACK_ENTRIES, MAX_MESSAGE_CHARS, MAX_BATCH_EVENTS, ALLOWED_EXTRA_KEYS, DIAGNOSTICS_PATH, MAX_PENDING, FLUSH_INTERVAL_MS, BREAKER_THRESHOLD, BREAKER_COOLDOWN_MS, REASON_QUEUE_FULL, REASON_RETRY_EXHAUSTED, REASON_QUOTA_REJECTED, REASON_SHUTDOWN_DROP, counters, activeRedactionConfig, pending, timer, consecutiveFailures, breakerOpenUntil, reporting, MORSE_PATH_MARKERS;
+var init_diagnostics = __esm({
+  "src/_internal/diagnostics.ts"() {
+    init_env();
+    init_redaction();
+    SDK_VERSION = "0.5.0-rc.1" ;
+    LEVEL_OFF = "off";
+    LEVEL_ERROR = "error";
+    LEVEL_DEBUG = "debug";
+    VALID_LEVELS = /* @__PURE__ */ new Set([LEVEL_OFF, LEVEL_ERROR, LEVEL_DEBUG]);
+    level = LEVEL_ERROR;
+    RATE_WINDOW_MS = 6e4;
+    RATE_LIMIT_PER_WINDOW = 100;
+    RATE_LIMIT_PER_WINDOW_DEBUG = 1e3;
+    rateBuckets = /* @__PURE__ */ new Map();
+    LOCAL_LOG_WINDOW_MS = 6e4;
+    LOCAL_LOG_LIMIT_PER_WINDOW = 10;
+    localLogBuckets = /* @__PURE__ */ new Map();
+    MAX_STACK_ENTRIES = 64;
+    MAX_MESSAGE_CHARS = 4096;
+    MAX_BATCH_EVENTS = 32;
+    ALLOWED_EXTRA_KEYS = /* @__PURE__ */ new Set([
+      "adapter",
+      "module",
+      "function",
+      "operation",
+      "endpoint_host"
+    ]);
+    DIAGNOSTICS_PATH = "/api/v1/diagnostics/sdk";
+    MAX_PENDING = 100;
+    FLUSH_INTERVAL_MS = 5e3;
+    BREAKER_THRESHOLD = 3;
+    BREAKER_COOLDOWN_MS = 3e5;
+    REASON_QUEUE_FULL = "queue_full";
+    REASON_RETRY_EXHAUSTED = "retry_exhausted";
+    REASON_QUOTA_REJECTED = "quota_rejected";
+    REASON_SHUTDOWN_DROP = "shutdown_drop";
+    counters = /* @__PURE__ */ new Map();
+    activeRedactionConfig = null;
+    pending = [];
+    timer = null;
+    consecutiveFailures = 0;
+    breakerOpenUntil = 0;
+    reporting = false;
+    MORSE_PATH_MARKERS = ["@morsehq/sdk", "morse-sdk", "/morse/", "morse_ai"];
+  }
+});
+
+// src/_internal/spans.ts
+function generateTraceId() {
+  return randomHex(32);
+}
+function generateSpanId() {
+  return randomHex(32);
+}
+function randomHex(chars) {
+  const bytes = new Uint8Array(Math.ceil(chars / 2));
+  const cryptoObj = globalThis.crypto;
+  if (cryptoObj?.getRandomValues) {
+    cryptoObj.getRandomValues(bytes);
+  } else {
+    for (let i = 0; i < bytes.length; i++) {
+      bytes[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  let hex = "";
+  for (const b of bytes) {
+    hex += b.toString(16).padStart(2, "0");
+  }
+  return hex.slice(0, chars);
+}
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function spanToWire(span) {
+  const out = {};
+  for (const [k, v] of Object.entries(span)) {
+    if (v !== void 0 && v !== null) {
+      out[k] = v;
+    }
+  }
+  return out;
+}
+function buildTraceEntry(fields, spans) {
+  return {
+    trace: fields,
+    spans: spans.map(spanToWire)
+  };
+}
+var SpanType;
+var init_spans = __esm({
+  "src/_internal/spans.ts"() {
+    SpanType = {
+      AGENT: "agent",
+      LLM: "llm",
+      TOOL: "tool",
+      HTTP: "http",
+      DB: "db",
+      CUSTOM: "custom",
+      MEMORY: "memory",
+      // MHQ-482: matches Python's `SpanType.RETRIEVER` (apps/sdk/python/src/morse_ai/spans.py).
+      // @beta — retriever span type is subject to change before SDK v1.0 (see
+      // the plain-LangChain adapter's on_retriever_* callbacks in src/langchain/).
+      RETRIEVER: "retriever"
+    };
+  }
+});
 function ensureGlobalContextManager() {
   if (contextManagerRegistered) return;
   contextManagerRegistered = true;
@@ -604,13 +928,21 @@ function emitTraceEntry(entry) {
         });
       }
       otelSpan.end(endTime);
-    } catch {
+    } catch (err) {
+      reportSwallowed(err, "morse.otel_provider.shutdown");
     }
   }
 }
+function reportSwallowed(err, fingerprint) {
+  try {
+    report(err, { fingerprint });
+  } catch {
+  }
+}
 var INSTRUMENTATION_NAME, DEFAULT_MAX_FIELD_BYTES, TRUNCATION_MARKER, contextManagerRegistered, MAX_U64, RedactingSpanExporter, RecordingSpanExporter, ResultCapturingExporter, OtelEngine, engine;
 var init_otel_provider = __esm({
   "src/_internal/otel-provider.ts"() {
+    init_diagnostics();
     init_redaction();
     INSTRUMENTATION_NAME = "morse-typescript";
     DEFAULT_MAX_FIELD_BYTES = 65536;
@@ -763,7 +1095,8 @@ var init_otel_provider = __esm({
         if (provider !== null) {
           try {
             await provider.forceFlush();
-          } catch {
+          } catch (err) {
+            reportSwallowed(err, "morse.otel_provider.force_flush");
           }
         }
       }
@@ -842,8 +1175,9 @@ function setTransport(t) {
 function getTransport() {
   return transport;
 }
-function setRedactionConfig(config) {
+function setRedactionConfig2(config) {
   redactionConfig = config;
+  setRedactionConfig(config);
 }
 function getRedactionConfig() {
   return redactionConfig;
@@ -932,8 +1266,15 @@ function buildTraceDict(state, rootSpan) {
     spans: spans.map((s) => redactSpanDict(s, config))
   };
   const effectiveSource = state.sourceOverride || _source;
+  const resource = {};
   if (effectiveSource) {
-    out.resource = { "morse_ai.source": effectiveSource };
+    resource["morse_ai.source"] = effectiveSource;
+  }
+  if (state.framework) {
+    resource["morse_ai.framework"] = state.framework;
+  }
+  if (Object.keys(resource).length > 0) {
+    out.resource = resource;
   }
   return out;
 }
@@ -1154,7 +1495,7 @@ async function spanAsync(opts, fn) {
     throw err;
   }
 }
-function _resetForTesting() {
+function _resetForTesting2() {
   browserState = null;
   lastTrace = null;
   redactionConfig = buildRedactionConfig();
@@ -1164,6 +1505,7 @@ var init_tracing = __esm({
   "src/_internal/tracing.ts"() {
     init_env();
     init_otel_provider();
+    init_diagnostics();
     init_redaction();
     init_spans();
     als = null;
@@ -1281,6 +1623,6 @@ var init_propagation = __esm({
   }
 });
 
-export { DEFAULT_ENDPOINT, SpanType, W3C_TRACEPARENT_HEADER, _resetForTesting, buildRedactionConfig, buildTraceEntry, extractTraceparent, formatTraceparent, generateSpanId, generateTraceId, getActiveTraceState, getApiKey, getEndpoint, getEngine, getFlushIntervalSeconds, getInternalSource, getLastTrace, getMaxBatchSize, getMaxFieldBytes, getMaxQueueSize, getRedactionConfig, getSampleRate, getTransport, init_env, init_otel_provider, init_propagation, init_redaction, init_spans, init_tracing, injectIntoRequestInit, injectTraceparent, isAutoDetectDisabled, isDbCaptureEnabled, isDebug, isDisabled, isTelemetryDisabled, isValidInternalSource, nowIso, redactValue, runAsync, runSync, sendTrace, setContext, setRedactionConfig, setSource, setTransport, spanAsync, spanSync, startSpan };
-//# sourceMappingURL=chunk-LTKGLXAE.js.map
-//# sourceMappingURL=chunk-LTKGLXAE.js.map
+export { DEFAULT_ENDPOINT, REASON_QUEUE_FULL, REASON_QUOTA_REJECTED, REASON_RETRY_EXHAUSTED, REASON_SHUTDOWN_DROP, SpanType, W3C_TRACEPARENT_HEADER, _resetForTesting, _resetForTesting2, buildRedactionConfig, buildTraceEntry, extractTraceparent, formatTraceparent, generateSpanId, generateTraceId, getActiveTraceState, getApiKey, getEndpoint, getEngine, getFlushIntervalSeconds, getInternalSource, getLastTrace, getMaxBatchSize, getMaxFieldBytes, getMaxQueueSize, getRedactionConfig, getSampleRate, getTransport, init_diagnostics, init_env, init_otel_provider, init_propagation, init_redaction, init_spans, init_tracing, injectIntoRequestInit, injectTraceparent, isAutoDetectDisabled, isDbCaptureEnabled, isDisabled, isValidInternalSource, nowIso, recordDrop, redactValue, report, runAsync, runSync, sendTrace, setContext, setLevel, setRedactionConfig2 as setRedactionConfig, setSource, setTransport, spanAsync, spanSync, startSpan };
+//# sourceMappingURL=chunk-UEKQIRRA.js.map
+//# sourceMappingURL=chunk-UEKQIRRA.js.map