@cursor/bdk 0.2.25 → 0.2.27

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

@@ -1,9 +1,12 @@
 /**
- * Process-level OTel SDK (OTLP HTTP exporters for traces / metrics / logs).
+ * Shared OpenTelemetry types and the helpers the bake-time providers use.
+ * Export itself lives in `customer.ts`.
  */
 import { type Histogram, type Meter, type Tracer } from "@opentelemetry/api";
-import { type Logger as OtelLogger } from "@opentelemetry/api-logs";
-import { type ResolvedOtelConfig } from "./config.js";
+import type { Logger as OtelLogger } from "@opentelemetry/api-logs";
+import { AggregationTemporalityPreference } from "@opentelemetry/exporter-metrics-otlp-http";
+import type { AggregationTemporality, InstrumentType } from "@opentelemetry/sdk-metrics";
+import type { MetricsTemporality, ResolvedOtelConfig, ResolvedOtelMetrics } from "./config.js";
 /**
  * Hosted v2 pods may be frozen or destroyed as soon as the HTTP reply
  * lands. Bound the exporter wait so a slow collector cannot hold the
@@ -13,7 +16,6 @@ export declare const OTEL_FORCE_FLUSH_TIMEOUT_MS = 1000;
 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;
@@ -29,17 +31,11 @@ export interface OtelRuntimeHandle {
      */
     reload(): void;
 }
-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>;
+export declare function installOtelDiagLogger(log: (line: string) => void): void;
+export declare function warnEgress(config: ResolvedOtelConfig, egressDomains: readonly string[] | undefined, log: (line: string) => void): void;
+export declare function metricTemporalityPreference(metricsConfig: ResolvedOtelMetrics, log: (line: string) => void): AggregationTemporalityPreference;
+export declare function metricTemporalitySelector(temporality: MetricsTemporality): (instrumentType: InstrumentType) => AggregationTemporality;
+/** True when a non-noop TracerProvider already owns the process. */
+export declare function hasRealTracerProvider(): boolean;
 //# sourceMappingURL=runtime.d.ts.map

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,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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,MAAM,EAIZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACL,gCAAgC,EAIjC,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE/F;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD,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,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,MAAM,IAAI,IAAI,CAAC;CAChB;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;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAWvE;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,kBAAkB,EAC1B,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAC5C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,IAAI,CAeN;AAED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,mBAAmB,EAClC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,gCAAgC,CAOlC;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,kBAAkB,GAC9B,CAAC,cAAc,EAAE,cAAc,KAAK,sBAAsB,CAa5D;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,IAAI,OAAO,CAM/C"}

package/dist/internal/otel/runtime.js

@@ -1,104 +1,16 @@
 /**
- * Process-level OTel SDK (OTLP HTTP exporters for traces / metrics / logs).
+ * Shared OpenTelemetry types and the helpers the bake-time providers use.
+ * Export itself lives in `customer.ts`.
  */
-import { DiagLogLevel, diag, metrics, ProxyTracerProvider, trace, } from "@opentelemetry/api";
-import { logs } from "@opentelemetry/api-logs";
-import { OTLPLogExporter as OTLPLogExporterHttp } from "@opentelemetry/exporter-logs-otlp-http";
-import { OTLPLogExporter as OTLPLogExporterProto } from "@opentelemetry/exporter-logs-otlp-proto";
-import { AggregationTemporalityPreference, OTLPMetricExporter as OTLPMetricExporterHttp, } from "@opentelemetry/exporter-metrics-otlp-http";
-import { OTLPMetricExporter as OTLPMetricExporterProto } from "@opentelemetry/exporter-metrics-otlp-proto";
-import { OTLPTraceExporter as OTLPTraceExporterHttp } from "@opentelemetry/exporter-trace-otlp-http";
-import { OTLPTraceExporter as OTLPTraceExporterProto } from "@opentelemetry/exporter-trace-otlp-proto";
-import { resourceFromAttributes } from "@opentelemetry/resources";
-import { BatchLogRecordProcessor, LoggerProvider, } from "@opentelemetry/sdk-logs";
-import { MeterProvider, PeriodicExportingMetricReader, } from "@opentelemetry/sdk-metrics";
-import { BatchSpanProcessor, NodeTracerProvider, ParentBasedSampler, TraceIdRatioBasedSampler, } from "@opentelemetry/sdk-trace-node";
-import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from "@opentelemetry/semantic-conventions";
-import { installOutboundFetchInstrumentation, } from "../../otel.js";
+import { DiagLogLevel, diag, trace, } from "@opentelemetry/api";
+import { AggregationTemporalityPreference, CumulativeTemporalitySelector, DeltaTemporalitySelector, LowMemoryTemporalitySelector, } from "@opentelemetry/exporter-metrics-otlp-http";
 import { egressAllowsHost } from "../hosting.js";
-import { disabledOtelConfig, exportersForSignal, stableJson, } from "./config.js";
-import { ensureW3cPropagator } from "./propagation.js";
-const INSTRUMENTATION = "agent_sdk";
 /**
  * Hosted v2 pods may be frozen or destroyed as soon as the HTTP reply
  * lands. Bound the exporter wait so a slow collector cannot hold the
  * delivery (OTLP BatchSpanProcessor defaults to 30s).
  */
 export const OTEL_FORCE_FLUSH_TIMEOUT_MS = 1_000;
-/**
- * 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 function createOtelRuntime(resolve, log, options = {}) {
-    let built;
-    let latest = disabledOtelConfig();
-    let started = false;
-    let warnedKey;
-    const runtime = {
-        config: disabledOtelConfig(),
-        tracer: noopTracer(),
-        meter: undefined,
-        logger: undefined,
-        httpDuration: undefined,
-        forceFlush: () => raceOtelForceFlush(Promise.allSettled(all(built?.providers).map((p) => p.forceFlush())), log),
-        shutdown: async () => {
-            await Promise.allSettled(all(built?.providers).map((p) => p.shutdown()));
-        },
-    };
-    // Exporters read headers from the latest config on each export. The rest
-    // of `runtime.config` stays as it was when the providers were built.
-    const read = () => latest;
-    const apply = (config) => {
-        if (config.enabled && !started) {
-            started = true;
-            startSdk(log);
-        }
-        if (config.traces !== false) {
-            installOutboundFetchInstrumentation();
-        }
-        const key = settingsKey(config);
-        if (built !== undefined) {
-            // A new URL, protocol, or signal list does not match the exporters
-            // already built. Leave `latest` so those exporters still find their headers.
-            if (key === built.key) {
-                latest = config;
-            }
-            else if (key !== warnedKey) {
-                warnedKey = key;
-                log("[bdk:otel] only exporter headers change after the first export; redeploy to apply the new OTel settings");
-            }
-            return;
-        }
-        latest = config;
-        runtime.config = config;
-        if (config.exporters.length > 0) {
-            built = { key, providers: buildProviders(config, read, log) };
-            warnEgress(config, options.egressDomains, log);
-            log(`[bdk] otel enabled service=${config.serviceName} exporters=${config.exporters.length} traces=${config.traces !== false} metrics=${config.metrics !== false} logs=${config.logs !== false}`);
-        }
-        bindInstruments(runtime, config, built?.providers);
-    };
-    return {
-        runtime,
-        // The authored factory runs inside hosted delivery; telemetry must not
-        // fail the request.
-        reload: () => {
-            try {
-                apply(resolve());
-            }
-            catch (error) {
-                log(`[bdk:otel] error: OTel config failed: ${error instanceof Error ? error.message : String(error)}`);
-            }
-        },
-    };
-}
-export async function forceFlushOtelRuntime(runtime) {
-    await runtime?.forceFlush();
-}
-export async function shutdownOtelRuntime(runtime) {
-    await runtime?.shutdown();
-}
 export async function raceOtelForceFlush(work, log, timeoutMs = OTEL_FORCE_FLUSH_TIMEOUT_MS) {
     let timer;
     const timeout = new Promise((resolve) => {
@@ -115,12 +27,7 @@ export async function raceOtelForceFlush(work, log, timeoutMs = OTEL_FORCE_FLUSH
         log(`[bdk:otel] forceFlush exceeded ${timeoutMs}ms; continuing`);
     }
 }
-function all(providers) {
-    return providers === undefined
-        ? []
-        : [providers.traces, providers.metrics, providers.logs].filter((provider) => provider !== undefined);
-}
-function startSdk(log) {
+export function installOtelDiagLogger(log) {
     diag.setLogger({
         verbose: (message) => log(`[bdk:otel] ${message}`),
         debug: (message) => log(`[bdk:otel] ${message}`),
@@ -128,12 +35,8 @@ function startSdk(log) {
         warn: (message) => log(`[bdk:otel] warn: ${message}`),
         error: (message) => log(`[bdk:otel] error: ${message}`),
     }, DiagLogLevel.ERROR);
-    ensureW3cPropagator();
-    if (process.env.OTEL_EXPORTER_OTLP_PROTOCOL?.trim().toLowerCase() === "grpc") {
-        log("[bdk:otel] OTEL_EXPORTER_OTLP_PROTOCOL=grpc is unsupported; using http/protobuf");
-    }
 }
-function warnEgress(config, egressDomains, log) {
+export function warnEgress(config, egressDomains, log) {
     if (egressDomains === undefined) {
         return;
     }
@@ -147,150 +50,43 @@ function warnEgress(config, egressDomains, log) {
         }
     }
 }
-function bindInstruments(runtime, config, providers) {
-    runtime.tracer =
-        config.traces === false
-            ? noopTracer()
-            : (providers?.traces?.getTracer(INSTRUMENTATION) ?? trace.getTracer(INSTRUMENTATION));
-    const meter = config.metrics === false
-        ? undefined
-        : (providers?.metrics?.getMeter(INSTRUMENTATION) ?? metrics.getMeter(INSTRUMENTATION));
-    runtime.meter = meter;
-    runtime.logger =
-        config.logs === false
-            ? undefined
-            : (providers?.logs?.getLogger(INSTRUMENTATION) ?? logs.getLogger(INSTRUMENTATION));
-    runtime.httpDuration =
-        meter === undefined
-            ? undefined
-            : meter.createHistogram("agent_sdk.http.duration", {
-                description: "HTTP request duration",
-                unit: "ms",
-            });
+export function metricTemporalityPreference(metricsConfig, log) {
+    if (metricsConfig.unrecognizedTemporality !== undefined) {
+        log(`[bdk:otel] warn: OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE='${metricsConfig.unrecognizedTemporality}' is not cumulative, delta, or lowmemory; using delta`);
+    }
+    return aggregationTemporalityPreference(metricsConfig.temporality);
 }
-function aggregationTemporalityPreference(temporality) {
+export function metricTemporalitySelector(temporality) {
     switch (temporality) {
         case "cumulative":
-            return AggregationTemporalityPreference.CUMULATIVE;
-        case "delta":
-            return AggregationTemporalityPreference.DELTA;
+            return CumulativeTemporalitySelector;
         case "lowmemory":
-            return AggregationTemporalityPreference.LOWMEMORY;
+            return LowMemoryTemporalitySelector;
+        case "delta":
+            return DeltaTemporalitySelector;
         default: {
             const exhaustive = temporality;
             return exhaustive;
         }
     }
 }
-function metricTemporalityPreference(metrics, log) {
-    if (metrics.unrecognizedTemporality !== undefined) {
-        log(`[bdk:otel] warn: OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE='${metrics.unrecognizedTemporality}' is not cumulative, delta, or lowmemory; using delta`);
-    }
-    return aggregationTemporalityPreference(metrics.temporality);
-}
-function buildProviders(config, read, log) {
-    const resource = buildResource(config);
-    const exportersFor = (signal, on, create) => on
-        ? exportersForSignal(config.exporters, signal).map((exporter) => create(isProtobuf(exporter), {
-            url: signalUrl(exporter.url, signal),
-            headers: headersAt(read, config.exporters.indexOf(exporter)),
-        }))
-        : [];
-    const spanExporters = exportersFor("traces", config.traces !== false, (protobuf, options) => protobuf ? new OTLPTraceExporterProto(options) : new OTLPTraceExporterHttp(options));
-    const temporalityPreference = config.metrics === false
-        ? AggregationTemporalityPreference.DELTA
-        : metricTemporalityPreference(config.metrics, log);
-    const metricExporters = exportersFor("metrics", config.metrics !== false, (protobuf, options) => {
-        const opts = { ...options, temporalityPreference };
-        return protobuf ? new OTLPMetricExporterProto(opts) : new OTLPMetricExporterHttp(opts);
-    });
-    const logExporters = exportersFor("logs", config.logs !== false, (protobuf, options) => protobuf ? new OTLPLogExporterProto(options) : new OTLPLogExporterHttp(options));
-    return {
-        traces: spanExporters.length === 0 ? undefined : traceProvider(config, resource, spanExporters, log),
-        metrics: metricExporters.length === 0
-            ? undefined
-            : meterProvider(config, resource, metricExporters, log),
-        logs: logExporters.length === 0 ? undefined : loggerProvider(resource, logExporters, log),
-    };
-}
-function traceProvider(config, resource, exporters, log) {
-    const sampleRatio = config.traces === false ? undefined : config.traces.sampleRatio;
-    const provider = new NodeTracerProvider({
-        resource,
-        spanProcessors: exporters.map((exporter) => new BatchSpanProcessor(exporter)),
-        sampler: new ParentBasedSampler({ root: new TraceIdRatioBasedSampler(sampleRatio ?? 1) }),
-    });
-    if (hasRealTracerProvider()) {
-        log("[bdk:otel] TracerProvider already registered; BDK traces export on a local provider");
-    }
-    else {
-        provider.register();
-    }
-    return provider;
-}
-function meterProvider(config, resource, exporters, log) {
-    const exportIntervalMillis = (config.metrics === false ? undefined : config.metrics.exportIntervalMillis) ?? 10_000;
-    const provider = new MeterProvider({
-        resource,
-        readers: exporters.map((exporter) => new PeriodicExportingMetricReader({ exporter, exportIntervalMillis })),
-    });
-    if (!metrics.setGlobalMeterProvider(provider)) {
-        log("[bdk:otel] MeterProvider already registered; BDK metrics export on a local provider");
-    }
-    return provider;
-}
-function loggerProvider(resource, exporters, log) {
-    const provider = new LoggerProvider({
-        resource,
-        processors: exporters.map((exporter) => new BatchLogRecordProcessor(exporter)),
-    });
-    if (logs.setGlobalLoggerProvider(provider) !== provider) {
-        log("[bdk:otel] LoggerProvider already registered; BDK logs export on a local provider");
-    }
-    return provider;
-}
-/** Every setting the providers are built from: the config without the headers. */
-function settingsKey(config) {
-    return stableJson({ ...config, exporters: config.exporters.map(exporterIdentity) });
-}
-function exporterIdentity(exporter) {
-    return [
-        exporter.url,
-        exporter.protocol ?? "http/protobuf",
-        [...(exporter.signals ?? [])].sort().join("+"),
-    ].join("|");
-}
-function headersAt(read, index) {
-    return async () => read().exporters[index]?.headers ?? {};
-}
-function noopTracer() {
-    return new ProxyTracerProvider().getTracer(INSTRUMENTATION);
-}
-function buildResource(config) {
-    // Align with Cursor enterprise wire resource attrs where they overlap so
-    // Agent SDK traces join org metrics/logs in the same collector.
-    const resourceAttrs = {
-        [ATTR_SERVICE_NAME]: config.serviceName,
-        "telemetry.sdk.language": "nodejs",
-        "cursor.surface": "unspecified",
-        "cursor.entrypoint": "sdk_ts",
-        "agent_sdk.framework": "@cursor/bdk",
-        ...config.resourceAttributes,
-    };
-    if (config.serviceVersion !== undefined) {
-        resourceAttrs[ATTR_SERVICE_VERSION] = config.serviceVersion;
-    }
-    return resourceFromAttributes(resourceAttrs);
-}
-function signalUrl(base, signal) {
-    return `${base.replace(/\/$/, "")}/v1/${signal}`;
-}
 /** True when a non-noop TracerProvider already owns the process. */
-function hasRealTracerProvider() {
+export function hasRealTracerProvider() {
     const provider = trace.getTracerProvider();
     const delegate = provider.getDelegate?.();
     return delegate !== undefined && delegate.constructor.name !== "NoopTracerProvider";
 }
-function isProtobuf(exporter) {
-    return exporter.protocol !== "http/json";
+function aggregationTemporalityPreference(temporality) {
+    switch (temporality) {
+        case "cumulative":
+            return AggregationTemporalityPreference.CUMULATIVE;
+        case "delta":
+            return AggregationTemporalityPreference.DELTA;
+        case "lowmemory":
+            return AggregationTemporalityPreference.LOWMEMORY;
+        default: {
+            const exhaustive = temporality;
+            return exhaustive;
+        }
+    }
 }

package/dist/internal/otel-env.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Internal mapper hook. Factory agents import this specifier so they share
+ * the module instance the running server loaded.
+ */
+export { contributeOtelEnv, writeDatadogTraceEnv } from "./otel/customer.js";
+//# sourceMappingURL=otel-env.d.ts.map

package/dist/internal/otel-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-env.d.ts","sourceRoot":"","sources":["../../src/internal/otel-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/internal/otel-env.js

@@ -0,0 +1,5 @@
+/**
+ * Internal mapper hook. Factory agents import this specifier so they share
+ * the module instance the running server loaded.
+ */
+export { contributeOtelEnv, writeDatadogTraceEnv } from "./otel/customer.js";

package/dist/internal/reminder-runner.d.ts

@@ -8,8 +8,12 @@ import type { PlatformTimers } from "./platform-timers.js";
 import { type ReminderControlPlane, type ReminderExecutionOutcome, type ReminderFireDescriptor } from "./reminder-control-plane-protocol.js";
 import { type SessionEngine } from "./session-engine.js";
 export { ReminderValidationError } from "./reminder-schedule.js";
-/** Max UTF-8 byte length of `JSON.stringify(args)` on named-handler create. */
+/**
+ * Max UTF-8 byte length of `JSON.stringify(args)` on named-handler create.
+ * @deprecated Deprecated on the package root.
+ */
 export declare const REMINDER_ARGS_MAX_BYTES: number;
+/** @deprecated Deprecated on the package root. */
 export declare class UnknownReminderError extends Error {
     readonly availableReminderIds: string[];
     constructor(reminderId: string, availableReminderIds: string[]);
@@ -71,6 +75,7 @@ export declare const REMINDER_FIRE_OUTCOME_METRIC = "agent_sdk.reminder.fire_out
 /**
  * Server wiring for {@link ReminderRunnerOptions.rejectAnonymousHandlers}:
  * architecture v2 always rejects anonymous run/until (local or hosted).
+ * @deprecated Deprecated on the package root.
  */
 export declare function rejectAnonymousReminderHandlers(options: {
     noControlPlane?: boolean;
@@ -163,9 +168,9 @@ export declare class ReminderRunner {
     private runFire;
     /**
      * One structured line and one `agent_sdk.reminder.fire_outcome` count per
-     * fire. Emitted through the host OTel meter, the same path hosted v2
-     * exports turn/tool metrics on, so a fire that ends in `stop` is visible
-     * beside the control plane's `timed_work.fire` count.
+     * fire. The counter is created on each record; the SDK reuses the
+     * instrument. A fire that ends in `stop` stays visible beside the control
+     * plane's `timed_work.fire` count.
      */
     private recordFireOutcome;
     private recordFromDescriptor;

package/dist/internal/reminder-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reminder-runner.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-runner.ts"],"names":[],"mappings":"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"}

package/dist/internal/reminder-runner.js

@@ -4,6 +4,7 @@
  * until as function XOR prompt.
  */
 import { randomBytes } from "node:crypto";
+import { metrics } from "@opentelemetry/api";
 import { channelContinuationIdentity, httpContinuationIdentity } from "./continuation-channel.js";
 import { continuationSource, isOneShotContinuationKey } from "./continuation-identity.js";
 import { NAME_PATTERN } from "./discovery/names.js";
@@ -13,8 +14,12 @@ import { defaultBusyPolicy, MAX_TIMER_MS, nextCronFireMs, ReminderValidationErro
 import { APP_AUTH } from "./schedule-runner.js";
 import { HTTP_CHANNEL_ID, SessionAuthError, SessionBusyError, } from "./session-engine.js";
 export { ReminderValidationError } from "./reminder-schedule.js";
-/** Max UTF-8 byte length of `JSON.stringify(args)` on named-handler create. */
+/**
+ * Max UTF-8 byte length of `JSON.stringify(args)` on named-handler create.
+ * @deprecated Deprecated on the package root.
+ */
 export const REMINDER_ARGS_MAX_BYTES = 32 * 1024;
+/** @deprecated Deprecated on the package root. */
 export class UnknownReminderError extends Error {
     constructor(reminderId, availableReminderIds) {
         super(`Unknown reminder "${reminderId}"`);
@@ -32,6 +37,7 @@ export const REMINDER_FIRE_OUTCOME_METRIC = "agent_sdk.reminder.fire_outcome";
 /**
  * Server wiring for {@link ReminderRunnerOptions.rejectAnonymousHandlers}:
  * architecture v2 always rejects anonymous run/until (local or hosted).
+ * @deprecated Deprecated on the package root.
  */
 export function rejectAnonymousReminderHandlers(options) {
     return options.architecture === "v2";
@@ -685,9 +691,9 @@ export class ReminderRunner {
     }
     /**
      * One structured line and one `agent_sdk.reminder.fire_outcome` count per
-     * fire. Emitted through the host OTel meter, the same path hosted v2
-     * exports turn/tool metrics on, so a fire that ends in `stop` is visible
-     * beside the control plane's `timed_work.fire` count.
+     * fire. The counter is created on each record; the SDK reuses the
+     * instrument. A fire that ends in `stop` stays visible beside the control
+     * plane's `timed_work.fire` count.
      */
     recordFireOutcome(record, fire) {
         this.logger(`[bdk] reminder fire_outcome kind=${fire.kind} reason=${fire.reason}` +
@@ -695,16 +701,12 @@ export class ReminderRunner {
             ` channelId=${record.channelId} fireCount=${record.fireCount}` +
             (fire.turnStatus === undefined ? "" : ` turn=${fire.turnStatus}`) +
             (fire.detail === undefined ? "" : ` detail=${JSON.stringify(fire.detail)}`));
-        // Test doubles may omit `host.otel`; the metric is best-effort.
-        const otel = this.engine.host.otel;
-        if (otel === undefined) {
-            return;
-        }
         try {
-            otel.increment(REMINDER_FIRE_OUTCOME_METRIC, {
+            metrics.getMeter("bdk").createCounter(REMINDER_FIRE_OUTCOME_METRIC).add(1, {
                 kind: fire.kind,
                 reason: fire.reason,
                 purpose: record.purpose,
+                "agent_sdk.agent": this.engine.project.name,
             });
         }
         catch (error) {

package/dist/internal/reminder-schedule.d.ts

@@ -2,6 +2,7 @@
  * Schedule resolution for reminders (`every` / `cron` / `delay` / `at`).
  */
 import type { ReminderCreateInput, ReminderScheduleKind } from "../types.js";
+/** @deprecated Deprecated on the package root. */
 export declare class ReminderValidationError extends Error {
     constructor(message: string);
 }

package/dist/internal/reminder-schedule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reminder-schedule.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-schedule.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAI7E,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,4EAA4E;AAC5E,eAAO,MAAM,YAAY,aAAgB,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EACnE,KAAK,GAAE,MAAmB,GACzB,gBAAgB,CAuDlB;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ1E;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,YAAY,GAAG,iBAAiB,CAE9F"}
+{"version":3,"file":"reminder-schedule.d.ts","sourceRoot":"","sources":["../../src/internal/reminder-schedule.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAI7E,kDAAkD;AAClD,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,4EAA4E;AAC5E,eAAO,MAAM,YAAY,aAAgB,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EACnE,KAAK,GAAE,MAAmB,GACzB,gBAAgB,CAuDlB;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ1E;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,YAAY,GAAG,iBAAiB,CAE9F"}

package/dist/internal/reminder-schedule.js

@@ -3,6 +3,7 @@
  */
 import { parseCron } from "./cron.js";
 import { parseDuration } from "./duration.js";
+/** @deprecated Deprecated on the package root. */
 export class ReminderValidationError extends Error {
     constructor(message) {
         super(message);

package/dist/internal/sdk-runner.d.ts

@@ -126,6 +126,7 @@ export declare class CursorSdkRunner implements AgentRunner {
     private runTurnWithTransportRetry;
     private logModelFallback;
     private runTurnAttempt;
+    private runTurnOnAgent;
     steer(request: {
         sessionId: string;
         text: string;
@@ -152,6 +153,11 @@ export declare class CursorSdkRunner implements AgentRunner {
     private trackPersist;
     dispose(): Promise<void>;
     private getAgent;
+    /**
+     * Swept on each new turn rather than on a timer, so a process with no
+     * traffic (including a hibernated hosted one) never wakes to sweep.
+     */
+    private evictIdleAgents;
     /**
      * Drop a cached handle and close it best-effort to release its transport
      * and executor lease. Identity-checked so a turn that lost a race with a
@@ -173,6 +179,8 @@ export declare class CursorSdkRunner implements AgentRunner {
     private buildLocalOptions;
     private openAgent;
     private openLocalAgent;
+    private resumeLocalAgent;
+    private openStoredLocalAgent;
     private openCloudAgent;
     private resolveStore;
     /**

package/dist/internal/sdk-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"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"}