@cursor/bdk 0.2.24 → 0.2.26

package/dist/otel.js

@@ -1,101 +1,9 @@
 /**
- * OpenTelemetry for Agent SDK — author `agent/otel.ts`, pass `serve({ otel })`,
- * or set `OTEL_EXPORTER_OTLP_ENDPOINT` (standard OTel env).
- *
- * ```ts
- * import { defineOtel } from "@cursor/bdk/internal/otel";
- *
- * export default defineOtel({
- *   serviceName: "cursor",
- *   exporters: [{ url: "https://otel.example.com", protocol: "http/protobuf" }],
- * });
- *
- * export default defineOtel(() => resolveMyOtelConfig());
- * ```
- *
- * Internal only: Cursor factory agents. Not a public Agent SDK export.
+ * W3C `traceparent` helpers for outbound calls.
+ * Set `OTEL_*` variables. There is no instrumentation file.
  */
 import { AsyncLocalStorage } from "node:async_hooks";
 import { context, trace } from "@opentelemetry/api";
-import { brandDefinition } from "./internal/brand.js";
-/**
- * Hidden factory on {@link OtelDefinition}. Not enumerable so
- * `pickAuthoredOtel` compares the bake-time snapshot, not the thunk.
- */
-export const OTEL_CONFIG_RESOLVE = Symbol.for("anysphere.july.otel.configResolve");
-/**
- * Author OpenTelemetry export under `agent/otel.ts`.
- * Import from `@cursor/bdk/internal/otel`, not `@cursor/bdk`.
- */
-export function defineOtel(config = {}) {
-    const resolve = typeof config === "function" ? config : () => config;
-    const snapshot = resolve();
-    validateOtelConfig(snapshot);
-    const def = brandDefinition("otel", snapshot);
-    Object.defineProperty(def, OTEL_CONFIG_RESOLVE, {
-        value: resolve,
-        enumerable: false,
-    });
-    return def;
-}
-/** Invoke a `defineOtel(() => …)` factory, or return the static snapshot. */
-export function resolveOtelDefinition(def) {
-    const resolve = def[OTEL_CONFIG_RESOLVE];
-    if (resolve === undefined) {
-        return def;
-    }
-    const next = resolve();
-    validateOtelConfig(next);
-    return next;
-}
-function validateOtelConfig(config) {
-    if (config.exporters !== undefined) {
-        for (const exporter of config.exporters) {
-            if (typeof exporter.url !== "string" || exporter.url.length === 0) {
-                throw new Error("defineOtel: exporters[].url must be a non-empty string");
-            }
-            if (exporter.protocol !== undefined &&
-                exporter.protocol !== "http/json" &&
-                exporter.protocol !== "http/protobuf") {
-                throw new Error('defineOtel: exporters[].protocol must be "http/json" or "http/protobuf"');
-            }
-            assertSignals(exporter.signals);
-        }
-    }
-    if (config.resourceAttributes !== undefined) {
-        for (const [key, value] of Object.entries(config.resourceAttributes)) {
-            if (typeof value !== "string") {
-                throw new Error(`defineOtel: resourceAttributes.${key} must be a string`);
-            }
-        }
-    }
-    assertSampleRatio(config.traces);
-}
-function assertSignals(signals) {
-    if (signals === undefined) {
-        return;
-    }
-    if (signals.length === 0) {
-        throw new Error("defineOtel: exporters[].signals must be non-empty");
-    }
-    for (const signal of signals) {
-        if (signal !== "traces" && signal !== "metrics" && signal !== "logs") {
-            throw new Error('defineOtel: exporters[].signals must be "traces" | "metrics" | "logs"');
-        }
-    }
-}
-function assertSampleRatio(traces) {
-    if (traces === undefined || typeof traces === "boolean") {
-        return;
-    }
-    const ratio = traces.sampleRatio;
-    if (ratio === undefined) {
-        return;
-    }
-    if (!Number.isFinite(ratio) || ratio < 0 || ratio > 1) {
-        throw new Error("defineOtel: traces.sampleRatio must be in [0, 1]");
-    }
-}
 export const TRACEPARENT_HEADER = "traceparent";
 /** Cursor backend prefers this; `remoteSpanContextFromRequest` falls back to W3C. */
 export const BACKEND_TRACEPARENT_HEADER = "backend-traceparent";
@@ -134,7 +42,7 @@ export function activeTraceparent() {
 }
 /**
  * Copy the active span onto every outbound `fetch`. Agents should not
- * wrap their own Connect / MCP clients for this — `createOtelRuntime`
+ * wrap their own Connect / MCP clients for this. The serve runtime
  * installs it on `globalThis.fetch` when traces are on.
  */
 function headersForFetch(input, init) {
@@ -145,20 +53,76 @@ function headersForFetch(input, init) {
         : input instanceof Request
             ? input.headers
             : undefined);
-    injectActiveTraceContext(headers);
     return headers;
 }
 export function instrumentedFetch(base = fetch) {
     return (input, init) => {
         const headers = headersForFetch(input, init);
+        applyOutboundTraceHeaders(headers, requestHost(input));
         if (input instanceof Request && init === undefined) {
             return base(new Request(input, { headers }));
         }
         return base(input, { ...init, headers });
     };
 }
+function requestHost(input) {
+    const raw = typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
+    try {
+        return new URL(raw).hostname;
+    }
+    catch {
+        return undefined;
+    }
+}
+function applyOutboundTraceHeaders(headers, host) {
+    if (host === undefined) {
+        return;
+    }
+    const span = trace.getSpan(context.active()) ?? getContextTracerSpan();
+    if (span === undefined) {
+        return;
+    }
+    const traceparent = formatTraceparent(span.spanContext());
+    if (traceparent === undefined) {
+        return;
+    }
+    if (isCursorHost(host) || isCollectorHost(host)) {
+        headers.set(TRACEPARENT_HEADER, traceparent);
+    }
+    if (isCursorHost(host)) {
+        headers.set(BACKEND_TRACEPARENT_HEADER, traceparent);
+    }
+}
+function isCursorHost(host) {
+    return (host === "cursor.com" ||
+        host === "cursor.sh" ||
+        host.endsWith(".cursor.com") ||
+        host.endsWith(".cursor.sh"));
+}
+function isCollectorHost(host) {
+    for (const key of [
+        "OTEL_EXPORTER_OTLP_ENDPOINT",
+        "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT",
+        "OTEL_EXPORTER_OTLP_METRICS_ENDPOINT",
+        "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT",
+    ]) {
+        const raw = process.env[key];
+        if (raw === undefined || raw.length === 0) {
+            continue;
+        }
+        try {
+            if (new URL(raw).hostname === host) {
+                return true;
+            }
+        }
+        catch {
+            // Ignore a value that is not a URL.
+        }
+    }
+    return false;
+}
 const OUTBOUND_FETCH_INSTALLED = Symbol.for("anysphere.july.otel.outboundFetch");
-/** Idempotent. Safe to call from `createOtelRuntime` on every serve. */
+/** Idempotent. Safe to call on every serve. */
 export function installOutboundFetchInstrumentation() {
     const slots = globalThis;
     if (slots[OUTBOUND_FETCH_INSTALLED] === true) {