@cursor/bdk 0.2.25 → 0.2.27

package/dist/internal/update-check.d.ts

@@ -12,7 +12,7 @@
  * installed (global npm/pnpm/yarn/bun, or a project dependency), and runs the
  * matching install command.
  */
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 /**
  * Semver-style ordering: negative when `a < b`, 0 when equal, positive when
  * `a > b`. Unparseable versions compare equal (never warn on garbage).
@@ -30,7 +30,7 @@ export declare function fetchLatestPublishedVersion(options?: {
 declare const cacheSchema: z.ZodObject<{
     checkedAt: z.ZodNumber;
     latestVersion: z.ZodOptional<z.ZodString>;
-}, "strip">;
+}>;
 export type UpdateCheckCache = z.infer<typeof cacheSchema>;
 export declare function updateCheckCachePath(configDir?: string): string;
 export declare function readUpdateCheckCache(configDir?: string): Promise<UpdateCheckCache | undefined>;

package/dist/internal/update-check.d.ts.map

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

package/dist/internal/update-check.js

@@ -15,7 +15,7 @@
 import { spawn } from "node:child_process";
 import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
 import { dirname, join, sep } from "node:path";
-import { z } from "zod/v3";
+import * as z from "zod/v4";
 import { configDirPath } from "./cursor/credentials.js";
 import { describeError } from "./describe-error.js";
 import { CLI_COMMAND_NAME, isCompiledDistribution, PACKAGE_NAME, packageRootDir, packageVersion, } from "./distribution.js";
@@ -295,8 +295,8 @@ async function declaresDependency(dir, packageName) {
         return false;
     }
     const manifestSchema = z.object({
-        dependencies: z.record(z.string()).optional(),
-        devDependencies: z.record(z.string()).optional(),
+        dependencies: z.record(z.string(), z.string()).optional(),
+        devDependencies: z.record(z.string(), z.string()).optional(),
     });
     try {
         const parsed = manifestSchema.safeParse(JSON.parse(raw));

package/dist/internal/workspace.d.ts

@@ -8,6 +8,7 @@
  * deliver them as the harness system prompt ({@link buildAgentsMdContent}),
  * and cloud / grokbot harnesses never read the session workspace.
  */
+import { type FileSystem } from "../filesystem.js";
 import type { DiscoveredSkill, DiscoveredTool, ResolvedAgent } from "../types.js";
 export interface MaterializeWorkspaceOptions {
     agent: ResolvedAgent;
@@ -102,7 +103,16 @@ export declare function buildServerToolsCatalog(tools: DiscoveredTool[], options
 export declare function buildAgentsMdContent(agent: ResolvedAgent, options: {
     includeScripts: boolean;
     serverToolsMcpName?: string;
+    skillsIndex?: boolean;
 }): string;
+/** Where an authored `fs` sees {@link skillsFileSystem}. */
+export declare const SKILLS_MOUNT_PATH = "/agent/skills";
+export declare const FS_AND_ROOT_CONFLICT = "Set `fs` or `root`, not both; `root` is a deprecated alias of `fs`.";
+/**
+ * The discovered skills as a read-only tree: `/<name>/SKILL.md`, the same
+ * bytes {@link materializeSkill} writes, plus each skill's sibling files.
+ */
+export declare function skillsFileSystem(skills: readonly DiscoveredSkill[]): Promise<FileSystem>;
 /**
  * True when `dir` sits strictly inside a git repository (a `.git` exists in
  * an ancestor directory but not in `dir` itself). The Cursor harness resolves

package/dist/internal/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/internal/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMlF,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,CAOR;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAapB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA8B,GAC/D,MAAM,CA8CR;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACjC,MAAM,CA6BR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcrE;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B9F;AAyFD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACtF,OAAO,CAAC,IAAI,CAAC,CAYf"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/internal/workspace.ts"],"names":[],"mappings":"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"}

package/dist/internal/workspace.js

@@ -9,11 +9,12 @@
  * and cloud / grokbot harnesses never read the session workspace.
  */
 import { execFile } from "node:child_process";
-import { chmod, copyFile, lstat, mkdir, readlink, rm, stat, symlink, writeFile, } from "node:fs/promises";
+import { chmod, copyFile, lstat, mkdir, readFile, readlink, rm, stat, symlink, writeFile, } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join, parse, relative, resolve, sep } from "node:path";
 import { promisify } from "node:util";
 import { agentStoreKeys, DEPLOYMENT_STORE_MOUNT_PATH } from "../files.js";
+import { readOnlyFs, tempFs } from "../filesystem.js";
 import { MEMORY_DIR_NAME } from "./memory-dir.js";
 import { parseFrontmatter, serializeFrontmatter } from "./frontmatter.js";
 import { buildIdentitySection } from "./prompt-context.js";
@@ -209,10 +210,55 @@ export function buildAgentsMdContent(agent, options) {
         buildAgentToolsCatalog(agent.tools, {
             includeScripts: options.includeScripts,
         }),
+        options.skillsIndex === true ? buildSkillsIndex(agent.skills) : "",
     ]
         .filter((part) => part !== "")
         .join("\n\n");
 }
+/** Where an authored `fs` sees {@link skillsFileSystem}. */
+export const SKILLS_MOUNT_PATH = "/agent/skills";
+export const FS_AND_ROOT_CONFLICT = "Set `fs` or `root`, not both; `root` is a deprecated alias of `fs`.";
+/**
+ * Index of the discovered skills under {@link SKILLS_MOUNT_PATH}. An `fs`
+ * agent has no `.cursor/skills/` for the harness to discover, so the
+ * instructions name each SKILL.md instead.
+ */
+function buildSkillsIndex(skills) {
+    if (skills.length === 0) {
+        return "";
+    }
+    return [
+        "## Skills",
+        "",
+        `Skills are on-demand procedures under \`${SKILLS_MOUNT_PATH}\`. When a task matches a skill's description, read its \`SKILL.md\` before acting on that part of the task and follow it.`,
+        "",
+        ...skills.map((skill) => `- \`${skill.name}\` (\`${SKILLS_MOUNT_PATH}/${skill.name}/SKILL.md\`): ${skill.description.trim()}`),
+    ].join("\n");
+}
+function skillFilePath(skillName, relativePath) {
+    const parts = relativePath.split("/");
+    if (relativePath.includes("\0") ||
+        relativePath.startsWith("/") ||
+        parts.some((part) => part === "" || part === "..")) {
+        throw new Error(`Skill "${skillName}" file "${relativePath}" escapes its directory.`);
+    }
+    return `/${skillName}/${relativePath}`;
+}
+/**
+ * The discovered skills as a read-only tree: `/<name>/SKILL.md`, the same
+ * bytes {@link materializeSkill} writes, plus each skill's sibling files.
+ */
+export async function skillsFileSystem(skills) {
+    const files = {};
+    for (const skill of skills) {
+        files[`/${skill.name}/SKILL.md`] = buildSkillMd(skill);
+        for (const [relativePath, source] of Object.entries(skill.files)) {
+            files[skillFilePath(skill.name, relativePath)] =
+                "contents" in source ? source.contents : await readFile(source.sourcePath);
+        }
+    }
+    return readOnlyFs(tempFs(files));
+}
 /**
  * True when `dir` sits strictly inside a git repository (a `.git` exists in
  * an ancestor directory but not in `dir` itself). The Cursor harness resolves

package/dist/internal/zod3-datetime.d.ts

@@ -0,0 +1,12 @@
+import * as z from "zod/v4";
+/**
+ * The datetime check of zod 3's `z.string().datetime()`. zod 4 refuses times
+ * without seconds and, with `offset`, `+HHMM` offsets; models and people still
+ * type both. Use it for values a person or a model writes; a value that only
+ * `toISOString()` writes can keep `z.iso.datetime()`.
+ */
+export declare function zod3Datetime(options?: {
+    offset?: boolean;
+    message?: string;
+}): z.ZodString;
+//# sourceMappingURL=zod3-datetime.d.ts.map

package/dist/internal/zod3-datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod3-datetime.d.ts","sourceRoot":"","sources":["../../src/internal/zod3-datetime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAM5B;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,CAAC,CAAC,SAAS,CAM9F"}

package/dist/internal/zod3-datetime.js

@@ -0,0 +1,17 @@
+import * as z from "zod/v4";
+const DATE = z.regexes.date.source.slice(1, -1);
+const TIME = String.raw `(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?`;
+const OFFSET = String.raw `[+-]\d{2}:?\d{2}`;
+/**
+ * The datetime check of zod 3's `z.string().datetime()`. zod 4 refuses times
+ * without seconds and, with `offset`, `+HHMM` offsets; models and people still
+ * type both. Use it for values a person or a model writes; a value that only
+ * `toISOString()` writes can keep `z.iso.datetime()`.
+ */
+export function zod3Datetime(options = {}) {
+    const zone = options.offset === true ? `(?:Z|${OFFSET})` : "Z";
+    return z
+        .string()
+        .regex(new RegExp(`^${DATE}T${TIME}${zone}$`), options.message ?? "Invalid datetime")
+        .meta({ format: "date-time" });
+}

package/dist/otel-public.d.ts

@@ -1,7 +1,6 @@
 /**
- * Public `@cursor/bdk/otel` surface: types and W3C `traceparent`
- * helpers. `defineOtel` is `@cursor/bdk/internal/otel`.
+ * Public `@cursor/bdk/otel` surface.
  */
-export type { OtelConfig, OtelConfigFactory, OtelDefinition, OtelExporterConfig, OtelLogOptions, OtelMetricOptions, OtelSignal, OtelTraceOptions, } from "./otel.js";
 export { activeTraceparent, BACKEND_TRACEPARENT_HEADER, formatTraceparent, injectActiveTraceContext, installOutboundFetchInstrumentation, instrumentedFetch, TRACEPARENT_HEADER, } from "./otel.js";
+export { currentConversationId } from "./internal/otel/conversation-span-processor.js";
 //# sourceMappingURL=otel-public.d.ts.map

package/dist/otel-public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otel-public.d.ts","sourceRoot":"","sources":["../src/otel-public.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,wBAAwB,EACxB,mCAAmC,EACnC,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"otel-public.d.ts","sourceRoot":"","sources":["../src/otel-public.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,wBAAwB,EACxB,mCAAmC,EACnC,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC"}

package/dist/otel-public.js

@@ -1,5 +1,5 @@
 /**
- * Public `@cursor/bdk/otel` surface: types and W3C `traceparent`
- * helpers. `defineOtel` is `@cursor/bdk/internal/otel`.
+ * Public `@cursor/bdk/otel` surface.
  */
 export { activeTraceparent, BACKEND_TRACEPARENT_HEADER, formatTraceparent, injectActiveTraceContext, installOutboundFetchInstrumentation, instrumentedFetch, TRACEPARENT_HEADER, } from "./otel.js";
+export { currentConversationId } from "./internal/otel/conversation-span-processor.js";

package/dist/otel.d.ts

@@ -1,106 +1,7 @@
 /**
- * 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.
- */
-export type OtelSignal = "traces" | "metrics" | "logs";
-/** One OTLP destination. Multiple entries fan out. */
-export interface OtelExporterConfig {
-    /**
-     * OTLP base URL (`https://otel.example.com`) or signal path
-     * (`…/v1/traces`). Signal paths are stripped to the base; the runtime
-     * re-appends `/v1/{signal}`.
-     */
-    url: string;
-    /** Extra HTTP headers (merged with `OTEL_EXPORTER_OTLP_HEADERS`). */
-    headers?: Record<string, string>;
-    /**
-     * Wire format. Default `http/protobuf` (matches Cursor enterprise OTLP).
-     * Use `http/json` for collectors that only accept JSON.
-     */
-    protocol?: "http/json" | "http/protobuf";
-    /**
-     * Restrict this destination to these signals. Default: all enabled
-     * signals. Set by env when per-signal `OTEL_EXPORTER_OTLP_*_ENDPOINT`
-     * vars differ.
-     */
-    signals?: OtelSignal[];
-}
-export interface OtelTraceOptions {
-    /** Sample ratio in `[0, 1]`. Default `1`. */
-    sampleRatio?: number;
-}
-export interface OtelMetricOptions {
-    /** Export interval in ms. Default `10000`. */
-    exportIntervalMillis?: number;
-}
-export interface OtelLogOptions {
-    /**
-     * Include user prompt text on log records / span events.
-     * Default false; also toggled by `OTEL_LOG_USER_PROMPTS=1`.
-     */
-    userPrompts?: boolean;
-    /**
-     * Include tool argument / result payloads and failure text (truncated).
-     * Default false; also `OTEL_LOG_TOOL_CONTENT=1`.
-     */
-    toolContent?: boolean;
-}
-/**
- * Authored / programmatic OTel config. Empty config still enables when
- * standard `OTEL_EXPORTER_OTLP_*` env vars are set.
- */
-export interface OtelConfig {
-    /**
-     * Resource `service.name`. Default: `OTEL_SERVICE_NAME` or `"cursor"`
-     * (same as enterprise export) so Agent SDK signals join org streams.
-     */
-    serviceName?: string;
-    /** Resource `service.version`. */
-    serviceVersion?: string;
-    /** Extra resource attributes on every signal. */
-    resourceAttributes?: Record<string, string>;
-    /**
-     * OTLP destinations. Default: from `OTEL_EXPORTER_OTLP_ENDPOINT` /
-     * per-signal `*_TRACES_ENDPOINT` etc. Empty with no env = disabled.
-     */
-    exporters?: OtelExporterConfig[];
-    /** Traces on/off or options. Default on. */
-    traces?: boolean | OtelTraceOptions;
-    /** Metrics on/off or options. Default on. */
-    metrics?: boolean | OtelMetricOptions;
-    /** Logs on/off or options. Default off (opt-in content). */
-    logs?: boolean | OtelLogOptions;
-}
-export type OtelDefinition = OtelConfig & {
-    readonly __agentServe: "otel";
-};
-/** Re-read authored config on each hosted request, after secrets load. */
-export type OtelConfigFactory = () => OtelConfig;
-/**
- * Hidden factory on {@link OtelDefinition}. Not enumerable so
- * `pickAuthoredOtel` compares the bake-time snapshot, not the thunk.
- */
-export declare const OTEL_CONFIG_RESOLVE: symbol;
-/**
- * Author OpenTelemetry export under `agent/otel.ts`.
- * Import from `@cursor/bdk/internal/otel`, not `@cursor/bdk`.
+ * W3C `traceparent` helpers for outbound calls.
+ * Set `OTEL_*` variables. There is no instrumentation file.
  */
-export declare function defineOtel(config?: OtelConfig | OtelConfigFactory): OtelDefinition;
-/** Invoke a `defineOtel(() => …)` factory, or return the static snapshot. */
-export declare function resolveOtelDefinition(def: OtelConfig): OtelConfig;
 export declare const TRACEPARENT_HEADER = "traceparent";
 /** Cursor backend prefers this; `remoteSpanContextFromRequest` falls back to W3C. */
 export declare const BACKEND_TRACEPARENT_HEADER = "backend-traceparent";
@@ -125,6 +26,6 @@ export declare function injectActiveTraceContext(headers: {
 /** W3C `traceparent` for the active span, or undefined if none. */
 export declare function activeTraceparent(): string | undefined;
 export declare function instrumentedFetch(base?: typeof fetch): typeof fetch;
-/** Idempotent. Safe to call from `createOtelRuntime` on every serve. */
+/** Idempotent. Safe to call on every serve. */
 export declare function installOutboundFetchInstrumentation(): void;
 //# sourceMappingURL=otel.d.ts.map

package/dist/otel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvD,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACpC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;IACtC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,MAAM,UAAU,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAwD,CAAC;AAE3F;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,UAAU,GAAG,iBAAsB,GAAG,cAAc,CAUtF;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CAUjE;AAuDD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAEhE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,GAAG,SAAS,CAOrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC,GAAG,IAAI,CAWP;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAItD;AAqBD,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,OAAO,KAAa,GAAG,OAAO,KAAK,CAQ1E;AAID,wEAAwE;AACxE,wBAAgB,mCAAmC,IAAI,IAAI,CAO1D"}
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAEhE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,GAAG,SAAS,CAOrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC,GAAG,IAAI,CAWP;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAItD;AAoBD,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,OAAO,KAAa,GAAG,OAAO,KAAK,CAS1E;AAiED,+CAA+C;AAC/C,wBAAgB,mCAAmC,IAAI,IAAI,CAO1D"}

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) {