@cursor/bdk 0.2.23 → 0.2.25

package/dist/internal/otel/config.js

@@ -31,7 +31,7 @@ export function pickAuthoredOtel(mounts) {
 export function resolveOtelConfig(input) {
     const env = input.env ?? process.env;
     if (input.serve === false) {
-        return disabled();
+        return disabledOtelConfig();
     }
     const authored = input.authored === undefined ? {} : resolveOtelDefinition(input.authored);
     const serve = input.serve === undefined ? {} : input.serve;
@@ -53,13 +53,13 @@ export function resolveOtelConfig(input) {
         : envExporters;
     const optedIn = input.authored !== undefined || input.serve !== undefined || envExporters.length > 0;
     if (!optedIn) {
-        return disabled();
+        return disabledOtelConfig();
     }
     const traces = resolveSignal(merged.traces);
-    const metrics = exporters.length === 0 ? false : resolveSignal(merged.metrics);
+    const metrics = exporters.length === 0 ? false : resolveMetrics(merged.metrics, env);
     const logs = exporters.length === 0 ? false : resolveLogs(merged.logs, env);
     if (exporters.length === 0 && traces === false) {
-        return disabled();
+        return disabledOtelConfig();
     }
     return {
         enabled: traces !== false || metrics !== false || logs !== false,
@@ -72,6 +72,7 @@ export function resolveOtelConfig(input) {
         logs,
     };
 }
+/** Values are URL-encoded per the OTel spec (`Authorization=Basic%20...`). */
 export function parseOtelHeaders(raw) {
     if (raw === undefined || raw.length === 0) {
         return {};
@@ -85,11 +86,20 @@ export function parseOtelHeaders(raw) {
         const key = part.slice(0, idx).trim();
         const value = part.slice(idx + 1).trim();
         if (key.length > 0) {
-            out[key] = value;
+            out[key] = decodeHeaderValue(value);
         }
     }
     return out;
 }
+/** A value with a stray `%` is sent as written. */
+function decodeHeaderValue(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
 /** Collapse `…/v1/{traces,metrics,logs}` to the collector base. */
 export function stripSignalPath(url) {
     return url.replace(/\/v1\/(traces|metrics|logs)\/?$/i, "");
@@ -98,7 +108,7 @@ export function stripSignalPath(url) {
 export function exportersForSignal(exporters, signal) {
     return exporters.filter((exporter) => exporter.signals === undefined || exporter.signals.includes(signal));
 }
-function disabled() {
+export function disabledOtelConfig() {
     return {
         enabled: false,
         serviceName: "cursor",
@@ -160,6 +170,32 @@ function protocolFromEnv(raw) {
     // Default protobuf — matches Cursor enterprise OTLP/HTTP. grpc unsupported.
     return "http/protobuf";
 }
+function metricsTemporalityFromEnv(raw) {
+    const value = raw?.trim().toLowerCase();
+    if (value === undefined || value.length === 0) {
+        return { temporality: "delta", unrecognized: undefined };
+    }
+    switch (value) {
+        case "cumulative":
+        case "delta":
+        case "lowmemory":
+            return { temporality: value, unrecognized: undefined };
+        default:
+            return { temporality: "delta", unrecognized: raw };
+    }
+}
+function resolveMetrics(value, env) {
+    const signal = resolveSignal(value);
+    if (signal === false) {
+        return false;
+    }
+    const parsed = metricsTemporalityFromEnv(env.OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE);
+    return {
+        ...signal,
+        temporality: parsed.temporality,
+        unrecognizedTemporality: parsed.unrecognized,
+    };
+}
 function resolveSignal(value) {
     if (value === false) {
         return false;
@@ -198,19 +234,20 @@ function logsExporterOptIn(env) {
 }
 function stableConfigKey(def) {
     const { __agentServe: _brand, ...rest } = def;
-    return stable(rest);
+    return stableJson(rest);
 }
-function stable(value) {
+/** Canonical JSON with sorted keys, so object key order does not change the result. */
+export function stableJson(value) {
     if (value === null || typeof value !== "object") {
         return JSON.stringify(value);
     }
     if (Array.isArray(value)) {
-        return `[${value.map(stable).join(",")}]`;
+        return `[${value.map(stableJson).join(",")}]`;
     }
     const obj = value;
     return `{${Object.keys(obj)
         .sort()
-        .map((key) => `${JSON.stringify(key)}:${stable(obj[key])}`)
+        .map((key) => `${JSON.stringify(key)}:${stableJson(obj[key])}`)
         .join(",")}}`;
 }
 function nonEmpty(value) {

package/dist/internal/otel/http.d.ts

@@ -9,5 +9,5 @@ export declare function endActiveHttpSpan(statusCode: number, error?: unknown):
  * Instrument one inbound Node request: SERVER span, W3C extract, auto-end
  * on response finish/close, run `fn` under the span context.
  */
-export declare function instrumentHttp<T>(runtime: OtelRuntime | undefined, req: IncomingMessage, res: ServerResponse, fn: () => Promise<T>): Promise<T>;
+export declare function instrumentHttp<T>(runtime: OtelRuntime, req: IncomingMessage, res: ServerResponse, fn: () => Promise<T>): Promise<T>;
 //# sourceMappingURL=http.d.ts.map

package/dist/internal/otel/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAUjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAG3E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAcZ"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAUjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAG3E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAcZ"}

package/dist/internal/otel/http.js

@@ -29,7 +29,7 @@ export function instrumentHttp(runtime, req, res, fn) {
     return context.with(handle.context.setValue(HTTP_SPAN_HANDLE_KEY, handle), fn);
 }
 function startHttpSpan(runtime, req) {
-    if (runtime === undefined || runtime.config.traces === false) {
+    if (runtime.config.traces === false) {
         return undefined;
     }
     ensureW3cPropagator();

package/dist/internal/otel/runtime.d.ts

@@ -10,32 +10,35 @@ import { type ResolvedOtelConfig } from "./config.js";
  * delivery (OTLP BatchSpanProcessor defaults to 30s).
  */
 export declare const OTEL_FORCE_FLUSH_TIMEOUT_MS = 1000;
-/**
- * First hosted OTLP POST may include a cold TLS handshake to Datadog.
- * Bound separately from {@link OTEL_FORCE_FLUSH_TIMEOUT_MS} so the
- * queued turn/tool batch is not abandoned after 1s.
- */
-export declare const OTEL_DEFERRED_EXPORT_TIMEOUT_MS = 5000;
-/** Drop oldest finished spans when no collector has drained the buffer. */
-export declare const OTEL_IN_MEMORY_SPAN_LIMIT = 2048;
 export interface OtelRuntime {
     config: ResolvedOtelConfig;
     tracer: Tracer;
+    /** Absent until the first config with an exporter. Then it stays. */
     meter: Meter | undefined;
     logger: OtelLogger | undefined;
     httpDuration: Histogram | undefined;
     forceFlush: () => Promise<void>;
     shutdown: () => Promise<void>;
 }
-export interface CreateOtelRuntimeOptions {
+export interface OtelRuntimeHandle {
+    runtime: OtelRuntime;
     /**
-     * Re-resolve exporters at flush (hosted v2 binds deployment secrets
-     * after bake). When bake had no OTLP exporters, finished spans sit
-     * in memory until this returns destinations.
+     * Resolve the config again. Local `serve` calls this at start. A hosted v2
+     * guest calls it after each secret load, because secrets arrive with the
+     * first request.
      */
-    resolveExport?: () => ResolvedOtelConfig;
+    reload(): void;
 }
-export declare function createOtelRuntime(config: ResolvedOtelConfig, log: (line: string) => void, options?: CreateOtelRuntimeOptions): OtelRuntime | undefined;
+export interface CreateOtelRuntimeOptions {
+    /** Hosted egress allowlist. An exporter host outside it logs an error. */
+    egressDomains?: readonly string[];
+}
+/**
+ * BDK builds the providers from the first config that has an exporter. After
+ * that, only the headers change: exporters read them on each export. A change
+ * to any other setting logs a warning to redeploy.
+ */
+export declare function createOtelRuntime(resolve: () => ResolvedOtelConfig, log: (line: string) => void, options?: CreateOtelRuntimeOptions): OtelRuntimeHandle;
 export declare function forceFlushOtelRuntime(runtime: OtelRuntime | undefined): Promise<void>;
 export declare function shutdownOtelRuntime(runtime: OtelRuntime | undefined): Promise<void>;
 export declare function raceOtelForceFlush(work: Promise<unknown>, log: (line: string) => void, timeoutMs?: number): Promise<void>;

package/dist/internal/otel/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,MAAM,EAKZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,MAAM,IAAI,UAAU,EAAQ,MAAM,yBAAyB,CAAC;AAiC1E,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAK1E;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AAErD,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,kBAAkB,CAAC;CAC1C;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC3B,OAAO,CAAC,EAAE,wBAAwB,GACjC,WAAW,GAAG,SAAS,CA8BzB;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3F;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EACtB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC3B,SAAS,GAAE,MAAoC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAef"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,MAAM,EAMZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,MAAM,IAAI,UAAU,EAAQ,MAAM,yBAAyB,CAAC;AAmC1E,OAAO,EAIL,KAAK,kBAAkB,EAGxB,MAAM,aAAa,CAAC;AAKrB;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,kBAAkB,EACjC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC3B,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAsEnB;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3F;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EACtB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC3B,SAAS,GAAE,MAAoC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAef"}