@cursor/bdk 0.2.1

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

@@ -0,0 +1,40 @@
+/**
+ * Merge authored `defineOtel`, `serve({ otel })`, and standard OTel env.
+ */
+import type { OtelConfig, OtelDefinition, OtelExporterConfig, OtelLogOptions, OtelMetricOptions, OtelSignal, OtelTraceOptions } from "../../otel.js";
+export interface ResolvedOtelConfig {
+    enabled: boolean;
+    serviceName: string;
+    serviceVersion: string | undefined;
+    resourceAttributes: Record<string, string>;
+    exporters: OtelExporterConfig[];
+    traces: false | OtelTraceOptions;
+    metrics: false | OtelMetricOptions;
+    logs: false | OtelLogOptions;
+}
+/**
+ * Process-global authored config. OTel SDK is one per serve process — if
+ * several mounts ship `agent/otel.ts`, they must be identical.
+ */
+export declare function pickAuthoredOtel(mounts: ReadonlyArray<{
+    slug: string;
+    name: string;
+    otel?: OtelDefinition;
+}>): OtelDefinition | undefined;
+/**
+ * Resolve effective config.
+ *
+ * Precedence: `serve({ otel: false })` disables; otherwise merge
+ * `serve({ otel })` over `defineOtel` over env defaults.
+ */
+export declare function resolveOtelConfig(input: {
+    authored?: OtelConfig;
+    serve?: OtelConfig | false;
+    env?: NodeJS.ProcessEnv;
+}): ResolvedOtelConfig;
+export declare function parseOtelHeaders(raw: string | undefined): Record<string, string>;
+/** Collapse `…/v1/{traces,metrics,logs}` to the collector base. */
+export declare function stripSignalPath(url: string): string;
+/** Exporters that apply to one signal (honors per-exporter `signals`). */
+export declare function exportersForSignal(exporters: readonly OtelExporterConfig[], signal: OtelSignal): OtelExporterConfig[];
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,MAAM,EAAE,KAAK,GAAG,gBAAgB,CAAC;IACjC,OAAO,EAAE,KAAK,GAAG,iBAAiB,CAAC;IACnC,IAAI,EAAE,KAAK,GAAG,cAAc,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC,GAC3E,cAAc,GAAG,SAAS,CAmB5B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,kBAAkB,CAkDrB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBhF;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,MAAM,EAAE,UAAU,GACjB,kBAAkB,EAAE,CAItB"}

package/dist/internal/otel/config.js

@@ -0,0 +1,231 @@
+/**
+ * Merge authored `defineOtel`, `serve({ otel })`, and standard OTel env.
+ */
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { resolveOtelDefinition } from "../../otel.js";
+/**
+ * Process-global authored config. OTel SDK is one per serve process — if
+ * several mounts ship `agent/otel.ts`, they must be identical.
+ */
+export function pickAuthoredOtel(mounts) {
+    const found = mounts.filter((m) => m.otel !== undefined);
+    if (found.length === 0) {
+        return undefined;
+    }
+    const first = found[0];
+    const key = stableConfigKey(first.otel);
+    for (const other of found.slice(1)) {
+        if (stableConfigKey(other.otel) !== key) {
+            const a = first.slug === "" ? first.name : first.slug;
+            const b = other.slug === "" ? other.name : other.slug;
+            throw new Error(`Conflicting agent/otel.ts on mounts "${a}" and "${b}": OTel is process-global. Use identical defineOtel configs, or configure once via serve({ otel }) / OTEL_EXPORTER_OTLP_*.`);
+        }
+    }
+    return first.otel;
+}
+/**
+ * Resolve effective config.
+ *
+ * Precedence: `serve({ otel: false })` disables; otherwise merge
+ * `serve({ otel })` over `defineOtel` over env defaults.
+ */
+export function resolveOtelConfig(input) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    const env = (_a = input.env) !== null && _a !== void 0 ? _a : process.env;
+    if (input.serve === false) {
+        return disabled();
+    }
+    const authored = input.authored === undefined ? {} : resolveOtelDefinition(input.authored);
+    const serve = input.serve === undefined ? {} : input.serve;
+    const merged = {
+        serviceName: (_b = serve.serviceName) !== null && _b !== void 0 ? _b : authored.serviceName,
+        serviceVersion: (_c = serve.serviceVersion) !== null && _c !== void 0 ? _c : authored.serviceVersion,
+        resourceAttributes: Object.assign(Object.assign({}, authored.resourceAttributes), serve.resourceAttributes),
+        exporters: (_d = serve.exporters) !== null && _d !== void 0 ? _d : authored.exporters,
+        traces: (_e = serve.traces) !== null && _e !== void 0 ? _e : authored.traces,
+        metrics: (_f = serve.metrics) !== null && _f !== void 0 ? _f : authored.metrics,
+        logs: (_g = serve.logs) !== null && _g !== void 0 ? _g : authored.logs,
+    };
+    const envExporters = exportersFromEnv(env);
+    const exporters = merged.exporters !== undefined && merged.exporters.length > 0
+        ? merged.exporters.map(e => withEnvHeaders(e, env))
+        : envExporters;
+    const optedIn = input.authored !== undefined || input.serve !== undefined || envExporters.length > 0;
+    if (!optedIn) {
+        return disabled();
+    }
+    const traces = resolveSignal(merged.traces);
+    const metrics = exporters.length === 0 ? false : resolveSignal(merged.metrics);
+    const logs = exporters.length === 0 ? false : resolveLogs(merged.logs, env);
+    if (exporters.length === 0 && traces === false) {
+        return disabled();
+    }
+    return {
+        enabled: traces !== false || metrics !== false || logs !== false,
+        serviceName: (_j = (_h = merged.serviceName) !== null && _h !== void 0 ? _h : env.OTEL_SERVICE_NAME) !== null && _j !== void 0 ? _j : "cursor",
+        serviceVersion: merged.serviceVersion,
+        resourceAttributes: (_k = merged.resourceAttributes) !== null && _k !== void 0 ? _k : {},
+        exporters,
+        traces,
+        metrics,
+        logs,
+    };
+}
+export function parseOtelHeaders(raw) {
+    if (raw === undefined || raw.length === 0) {
+        return {};
+    }
+    const out = {};
+    for (const part of raw.split(",")) {
+        const idx = part.indexOf("=");
+        if (idx <= 0) {
+            continue;
+        }
+        const key = part.slice(0, idx).trim();
+        const value = part.slice(idx + 1).trim();
+        if (key.length > 0) {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+/** Collapse `…/v1/{traces,metrics,logs}` to the collector base. */
+export function stripSignalPath(url) {
+    return url.replace(/\/v1\/(traces|metrics|logs)\/?$/i, "");
+}
+/** Exporters that apply to one signal (honors per-exporter `signals`). */
+export function exportersForSignal(exporters, signal) {
+    return exporters.filter(exporter => exporter.signals === undefined || exporter.signals.includes(signal));
+}
+function disabled() {
+    return {
+        enabled: false,
+        serviceName: "cursor",
+        serviceVersion: undefined,
+        resourceAttributes: {},
+        exporters: [],
+        traces: false,
+        metrics: false,
+        logs: false,
+    };
+}
+/**
+ * Build exporters from env. A shared `OTEL_EXPORTER_OTLP_ENDPOINT` fans out
+ * to every signal. Distinct `*_TRACES_ENDPOINT` / `*_METRICS_ENDPOINT` /
+ * `*_LOGS_ENDPOINT` values each become their own exporter scoped to that
+ * signal (OTel env spec).
+ */
+function exportersFromEnv(env) {
+    var _a, _b, _c, _d;
+    const base = (_a = env.OTEL_EXPORTER_OTLP_ENDPOINT) === null || _a === void 0 ? void 0 : _a.trim();
+    const traces = (_b = env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT) === null || _b === void 0 ? void 0 : _b.trim();
+    const metrics = (_c = env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT) === null || _c === void 0 ? void 0 : _c.trim();
+    const logs = (_d = env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT) === null || _d === void 0 ? void 0 : _d.trim();
+    const protocol = protocolFromEnv(env.OTEL_EXPORTER_OTLP_PROTOCOL);
+    const headers = parseOtelHeaders(env.OTEL_EXPORTER_OTLP_HEADERS);
+    if (nonEmpty(base)) {
+        return [{ url: stripSignalPath(base), headers, protocol }];
+    }
+    const out = [];
+    pushSignalExporter(out, traces, "traces", headers, protocol);
+    pushSignalExporter(out, metrics, "metrics", headers, protocol);
+    pushSignalExporter(out, logs, "logs", headers, protocol);
+    return out;
+}
+function pushSignalExporter(out, raw, signal, headers, protocol) {
+    if (!nonEmpty(raw)) {
+        return;
+    }
+    out.push({
+        url: stripSignalPath(raw),
+        headers,
+        protocol,
+        signals: [signal],
+    });
+}
+function withEnvHeaders(exporter, env) {
+    var _a;
+    const envHeaders = parseOtelHeaders(env.OTEL_EXPORTER_OTLP_HEADERS);
+    return {
+        url: stripSignalPath(exporter.url),
+        headers: Object.assign(Object.assign({}, envHeaders), exporter.headers),
+        protocol: (_a = exporter.protocol) !== null && _a !== void 0 ? _a : protocolFromEnv(env.OTEL_EXPORTER_OTLP_PROTOCOL),
+        signals: exporter.signals,
+    };
+}
+function protocolFromEnv(raw) {
+    const v = raw === null || raw === void 0 ? void 0 : raw.trim().toLowerCase();
+    if (v === "http/json" || v === "json") {
+        return "http/json";
+    }
+    // Default protobuf — matches Cursor enterprise OTLP/HTTP. grpc unsupported.
+    return "http/protobuf";
+}
+function resolveSignal(value) {
+    if (value === false) {
+        return false;
+    }
+    if (value === true || value === undefined) {
+        return {};
+    }
+    return value;
+}
+function resolveLogs(value, env) {
+    var _a, _b;
+    if (value === false) {
+        return false;
+    }
+    const envPrompts = env.OTEL_LOG_USER_PROMPTS === "1";
+    const envTools = env.OTEL_LOG_TOOL_CONTENT === "1";
+    if (value === true) {
+        return { userPrompts: envPrompts, toolContent: envTools };
+    }
+    if (value === undefined) {
+        // Match OTel: unset / empty / `none` means logs off. Any other
+        // `OTEL_LOGS_EXPORTER` value (e.g. `otlp`) opts logs on.
+        if (!envPrompts && !envTools && !logsExporterOptIn(env)) {
+            return false;
+        }
+        return { userPrompts: envPrompts, toolContent: envTools };
+    }
+    return {
+        userPrompts: (_a = value.userPrompts) !== null && _a !== void 0 ? _a : envPrompts,
+        toolContent: (_b = value.toolContent) !== null && _b !== void 0 ? _b : envTools,
+    };
+}
+/** `OTEL_LOGS_EXPORTER=none` (or unset) must not enable log export. */
+function logsExporterOptIn(env) {
+    var _a;
+    const raw = (_a = env.OTEL_LOGS_EXPORTER) === null || _a === void 0 ? void 0 : _a.trim().toLowerCase();
+    return raw !== undefined && raw.length > 0 && raw !== "none";
+}
+function stableConfigKey(def) {
+    const { __agentServe: _brand } = def, rest = __rest(def, ["__agentServe"]);
+    return stable(rest);
+}
+function stable(value) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(stable).join(",")}]`;
+    }
+    const obj = value;
+    return `{${Object.keys(obj)
+        .sort()
+        .map(key => `${JSON.stringify(key)}:${stable(obj[key])}`)
+        .join(",")}}`;
+}
+function nonEmpty(value) {
+    return value !== undefined && value.trim().length > 0;
+}

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

@@ -0,0 +1,13 @@
+/**
+ * HTTP SERVER spans + W3C `traceparent` extraction for inbound requests.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { OtelRuntime } from "./runtime.js";
+/** End the inbound SERVER span once the Fetch status is known (hosted flush). */
+export declare function endActiveHttpSpan(statusCode: number, error?: unknown): void;
+/**
+ * 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>;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +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"}

package/dist/internal/otel/http.js

@@ -0,0 +1,95 @@
+/**
+ * HTTP SERVER spans + W3C `traceparent` extraction for inbound requests.
+ */
+import { context, propagation, SpanKind, SpanStatusCode, trace, } from "@opentelemetry/api";
+import { ensureW3cPropagator } from "./propagation.js";
+const HTTP_SPAN_HANDLE_KEY = Symbol.for("anysphere.july.otel.httpSpanHandle");
+/** End the inbound SERVER span once the Fetch status is known (hosted flush). */
+export function endActiveHttpSpan(statusCode, error) {
+    const handle = context.active().getValue(HTTP_SPAN_HANDLE_KEY);
+    handle === null || handle === void 0 ? void 0 : handle.end(statusCode, error);
+}
+/**
+ * Instrument one inbound Node request: SERVER span, W3C extract, auto-end
+ * on response finish/close, run `fn` under the span context.
+ */
+export function instrumentHttp(runtime, req, res, fn) {
+    const handle = startHttpSpan(runtime, req);
+    if (handle === undefined) {
+        return fn();
+    }
+    res.once("finish", () => {
+        handle.end(res.statusCode);
+    });
+    res.once("close", () => {
+        if (!res.writableFinished) {
+            handle.end(res.statusCode || 499);
+        }
+    });
+    return context.with(handle.context.setValue(HTTP_SPAN_HANDLE_KEY, handle), fn);
+}
+function startHttpSpan(runtime, req) {
+    var _a, _b, _c, _d;
+    if (runtime === undefined || runtime.config.traces === false) {
+        return undefined;
+    }
+    ensureW3cPropagator();
+    const headers = {};
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (typeof value === "string") {
+            headers[key] = value;
+        }
+        else if (Array.isArray(value) && value[0] !== undefined) {
+            headers[key] = value[0];
+        }
+    }
+    const parent = propagation.extract(context.active(), headers);
+    const method = (_a = req.method) !== null && _a !== void 0 ? _a : "GET";
+    const path = (_c = ((_b = req.url) !== null && _b !== void 0 ? _b : "/").split("?")[0]) !== null && _c !== void 0 ? _c : "/";
+    const started = Date.now();
+    const span = runtime.tracer.startSpan("agent_sdk.http", {
+        kind: SpanKind.SERVER,
+        attributes: {
+            "http.request.method": method,
+            "url.path": path,
+            "network.peer.address": (_d = req.socket.remoteAddress) !== null && _d !== void 0 ? _d : "",
+        },
+    }, parent);
+    const ctx = trace.setSpan(parent, span);
+    let ended = false;
+    return {
+        context: ctx,
+        end(statusCode, error) {
+            var _a;
+            if (ended) {
+                return;
+            }
+            ended = true;
+            span.setAttribute("http.response.status_code", statusCode);
+            if (error !== undefined) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: error instanceof Error ? error.message : String(error),
+                });
+            }
+            else if (statusCode >= 500) {
+                span.setStatus({ code: SpanStatusCode.ERROR });
+            }
+            else {
+                span.setStatus({ code: SpanStatusCode.OK });
+            }
+            span.end();
+            (_a = runtime.httpDuration) === null || _a === void 0 ? void 0 : _a.record(Date.now() - started, {
+                "http.request.method": method,
+                "http.response.status_code": statusCode,
+                "url.path": routeClass(path),
+            });
+        },
+    };
+}
+function routeClass(path) {
+    return path
+        .replace(/\/sessions\/[0-9a-f-]{8,}/gi, "/sessions/:id")
+        .replace(/\/[0-9a-f]{8,}(?:-[0-9a-f]{4,})+/gi, "/:id");
+}

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

@@ -0,0 +1,16 @@
+/**
+ * Client-side MCP instrumentation: W3C / Cursor HTTP inject on Streamable
+ * HTTP + SSE fetches, SEP-414 `_meta.traceparent` on JSON-RPC params, and
+ * CLIENT spans for `tools/list` / `tools/call`.
+ */
+export declare function instrumentedMcpFetch(base?: typeof fetch): typeof fetch;
+/** SEP-414 / OTel MCP carrier for `params._meta`. */
+export declare function mcpTraceMeta(): {
+    traceparent: string;
+} | undefined;
+export declare function runMcpClientSpan<T>(args: {
+    method: string;
+    connection: string;
+    toolName?: string;
+}, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/mcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,OAAO,KAAa,GAAG,OAAO,KAAK,CAE7E;AAED,qDAAqD;AACrD,wBAAgB,YAAY,IAAI;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAMlE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAuBZ"}

package/dist/internal/otel/mcp.js

@@ -0,0 +1,55 @@
+/**
+ * Client-side MCP instrumentation: W3C / Cursor HTTP inject on Streamable
+ * HTTP + SSE fetches, SEP-414 `_meta.traceparent` on JSON-RPC params, and
+ * CLIENT spans for `tools/list` / `tools/call`.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { context, SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+import { activeTraceparent, instrumentedFetch } from "../../otel.js";
+import { attrs } from "./attrs.js";
+const TRACER = "agent_sdk";
+export function instrumentedMcpFetch(base = fetch) {
+    return instrumentedFetch(base);
+}
+/** SEP-414 / OTel MCP carrier for `params._meta`. */
+export function mcpTraceMeta() {
+    const traceparent = activeTraceparent();
+    if (traceparent === undefined) {
+        return undefined;
+    }
+    return { traceparent };
+}
+export function runMcpClientSpan(args, fn) {
+    const span = trace.getTracer(TRACER).startSpan(args.method, {
+        kind: SpanKind.CLIENT,
+        attributes: attrs({
+            "rpc.system": "mcp",
+            "mcp.method.name": args.method,
+            "mcp.tool.name": args.toolName,
+            "agent_sdk.mcp.connection": args.connection,
+        }),
+    });
+    return context.with(trace.setSpan(context.active(), span), () => __awaiter(this, void 0, void 0, function* () {
+        try {
+            return yield fn();
+        }
+        catch (error) {
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    }));
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Process-global W3C `traceparent` propagator. Inbound HTTP extracts;
+ * outbound Factory / Cursor API calls inject.
+ */
+export declare function ensureW3cPropagator(): void;
+//# sourceMappingURL=propagation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"propagation.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/propagation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}

package/dist/internal/otel/propagation.js

@@ -0,0 +1,14 @@
+/**
+ * Process-global W3C `traceparent` propagator. Inbound HTTP extracts;
+ * outbound Factory / Cursor API calls inject.
+ */
+import { propagation } from "@opentelemetry/api";
+import { W3CTraceContextPropagator } from "@opentelemetry/core";
+let installed = false;
+export function ensureW3cPropagator() {
+    if (installed) {
+        return;
+    }
+    propagation.setGlobalPropagator(new W3CTraceContextPropagator());
+    installed = true;
+}

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

@@ -0,0 +1,46 @@
+/**
+ * Process-level OTel SDK (OTLP HTTP exporters for traces / metrics / logs).
+ *
+ * Refuses to install a second global Tracer/Meter/Logger provider when one
+ * already owns the process (CLI, extension host, etc.). Spans still use
+ * `trace.getTracer()` so they nest under an existing parent when present.
+ */
+import type { Histogram, Meter, Tracer } from "@opentelemetry/api";
+import type { Logger as OtelLogger } from "@opentelemetry/api-logs";
+import { type ResolvedOtelConfig } 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
+ * 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;
+    meter: Meter | undefined;
+    logger: OtelLogger | undefined;
+    httpDuration: Histogram | undefined;
+    forceFlush: () => Promise<void>;
+    shutdown: () => Promise<void>;
+}
+export interface CreateOtelRuntimeOptions {
+    /**
+     * 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.
+     */
+    resolveExport?: () => ResolvedOtelConfig;
+}
+export declare function createOtelRuntime(config: ResolvedOtelConfig, log: (line: string) => void, options?: CreateOtelRuntimeOptions): OtelRuntime | undefined;
+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>;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA8BpE,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"}