@cursor/bdk 0.2.25 → 0.2.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cursor/bdk",
-  "version": "0.2.25",
+  "version": "0.2.27",
   "description": "Build, test, and deploy BDK bots and agents as code on Cursor's agent harness.",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
@@ -41,6 +41,7 @@
     "package.json",
     "LICENSE.md",
     "README.md",
+    "CHANGELOG.md",
     "AGENTS.md"
   ],
   "exports": {
@@ -57,6 +58,20 @@
       "import": "./dist/executors.js",
       "default": "./dist/executors.js"
     },
+    "./internal/continuation": {
+      "anysphere-source": "./src/internal/continuation.ts",
+      "bun": "./dist/internal/continuation.js",
+      "types": "./dist/internal/continuation.d.ts",
+      "import": "./dist/internal/continuation.js",
+      "default": "./dist/internal/continuation.js"
+    },
+    "./internal/discovery": {
+      "anysphere-source": "./src/internal/discovery.ts",
+      "bun": "./dist/internal/discovery.js",
+      "types": "./dist/internal/discovery.d.ts",
+      "import": "./dist/internal/discovery.js",
+      "default": "./dist/internal/discovery.js"
+    },
     "./internal/cursor-hosted": {
       "anysphere-source": "./src/storage-backends/cursor-hosted.ts",
       "bun": "./dist/storage-backends/cursor-hosted.js",
@@ -92,6 +107,13 @@
       "import": "./dist/otel.js",
       "default": "./dist/otel.js"
     },
+    "./internal/otel-env": {
+      "anysphere-source": "./src/internal/otel-env.ts",
+      "bun": "./dist/internal/otel-env.js",
+      "types": "./dist/internal/otel-env.d.ts",
+      "import": "./dist/internal/otel-env.js",
+      "default": "./dist/internal/otel-env.js"
+    },
     "./internal/storage": {
       "anysphere-source": "./src/internal/storage.ts",
       "bun": "./dist/internal/storage.js",
@@ -307,7 +329,7 @@
   },
   "dependencies": {
     "@bazel/runfiles": "6.5.0",
-    "@cursor/sdk": "1.0.37",
+    "@cursor/sdk": "1.0.38",
     "@modelcontextprotocol/sdk": "1.30.0",
     "@octokit/auth-app": "^7.2.0",
     "@octokit/rest": "^21.1.1",
@@ -337,15 +359,24 @@
     "proper-lockfile": "^4.1.2",
     "slackify-markdown": "^5.0.0",
     "tsx": "4.23.15",
+    "zod": "^3.25.0 || ^4.0.0",
     "zod-to-json-schema": "^3.25.2"
   },
   "peerDependencies": {
     "zod": "^3.25.0 || ^4.0.0"
   },
   "devDependencies": {
+    "@anysphere/agent-exec": "1.0.0",
+    "@anysphere/agent-store-sync": "1.0.0",
+    "@anysphere/context": "1.0.0",
+    "@anysphere/proto": "1.0.0",
+    "@anysphere/ui": "1.0.0",
     "@braintree/sanitize-url": "7.1.2",
+    "@microsoft/api-extractor": "7.59.4",
     "@stylexswc/rs-compiler": "^0.18.0",
     "@tanstack/react-virtual": "3.13.23",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
     "@types/js-yaml": "4.0.9",
     "@types/ms": "^2.1.0",
     "@types/node": "22.14.1",
@@ -373,12 +404,7 @@
     "vitest": "5.0.3",
     "yaml": "^2.4.2",
     "zod": "4.6.5",
-    "zustand": "^5.0.9",
-    "@anysphere/agent-exec": "1.0.0",
-    "@anysphere/agent-store-sync": "1.0.0",
-    "@anysphere/proto": "1.0.0",
-    "@anysphere/context": "1.0.0",
-    "@anysphere/ui": "1.0.0"
+    "zustand": "^5.0.9"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json && node scripts/bundle-publish-shims.mjs && node scripts/copy-extension-assets.mjs && pnpm run build:playground && pnpm run docs:build",
@@ -387,6 +413,7 @@
     "build:playground": "vite build --config playground/vite.config.ts",
     "build:playground:central": "vite build --mode central --config playground/vite.config.ts",
     "dev:playground": "vite --config playground/vite.config.ts",
+    "api:report": "node scripts/api-report.mjs",
     "check": "oxlint src && tsc --noEmit && tsc --noEmit -p playground/tsconfig.json",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",

package/schemas/grokbot-answers.schema.json

@@ -159,6 +159,9 @@
     },
     "connectors": {
       "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
       "additionalProperties": {
         "type": "object",
         "properties": {
@@ -200,8 +203,14 @@
     },
     "fillIns": {
       "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
       "additionalProperties": {
         "type": "object",
+        "propertyNames": {
+          "type": "string"
+        },
         "additionalProperties": {
           "type": "string",
           "minLength": 1,
@@ -273,6 +282,7 @@
         },
         "at": {
           "type": "string",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})$",
           "format": "date-time",
           "title": "Deploy at",
           "description": "Deploy at (ISO 8601 with a timezone)?",
@@ -309,6 +319,7 @@
         },
         "cutoverAt": {
           "type": "string",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})$",
           "format": "date-time",
           "title": "Slack cutover at",
           "description": "Switch Slack traffic at (ISO 8601 with a timezone)?",

package/skills/framework-map/SKILL.md

@@ -54,12 +54,13 @@ Path is identity. Full list: README "Folder structure".
 | `bot/channels/*.ts` | Slack / GitHub / custom HTTP |
 | `bot/hooks/*.ts` | Observe-only |
 | `bot/artifacts.ts` | Durable tagged outputs (`defineArtifacts`) |
-| `bot/otel.ts` | Factory-only OpenTelemetry (`defineOtel`) |
 | `bot/schedules/*` | Cron. Never auto-fire under `--dev` |
 | `bot/sandbox/workspace/` | Session seed files (local only) |
 | `bot/lib/` | Import-only. Never discovered |
 | `evals/**/*.eval.ts` | Case id is the path under `evals/` |
 
+OpenTelemetry export uses `OTEL_*` environment variables. See the guide section "Migrating from serve({ otel })".
+
 Discovery rejects `bot/result.ts`. To act on a turn's decision, record it with
 an authored tool and act on it from a `turn.completed` hook.
 

package/skills/otel/SKILL.md

@@ -1,68 +1,48 @@
 ---
 name: bdk-otel
 description: >-
-  Wire OpenTelemetry export (OTLP env, serve({ otel }), traces/metrics/logs,
-  ctx.host.otel). Use when adding collector export or custom metrics.
+  Wire OpenTelemetry export with OTEL_* environment variables.
+  Use when adding a collector, headers, or metrics temporality.
 ---
 
 # BDK OpenTelemetry
 
-Push traces and metrics from the serve process to an OTLP
-collector. Logs are off until you opt in.
+Customers configure export with standard `OTEL_*` environment variables
+and secrets. There is no instrumentation file and no `defineOtel`.
+`ctx.host.otel` is deprecated. Use `metrics.getMeter` and
+`trace.getTracer`. A span during a turn gets `cursor.conversation.id`
+from the active context. A metric does not. Call
+`currentConversationId` from `@cursor/bdk/otel` and set it yourself.
 
 Guide: `docs/guides/opentelemetry.md`.
 
-## Enable
-
-Public surface (use one of these):
+```bash
+export OTEL_EXPORTER_OTLP_ENDPOINT=https://otel.example.com
+export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer $OTEL_TOKEN"
+export OTEL_SERVICE_NAME=incident-agent
+```
 
-1. `OTEL_EXPORTER_OTLP_ENDPOINT` (optional
-   `OTEL_SERVICE_NAME`, `OTEL_EXPORTER_OTLP_HEADERS`,
-   `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf|http/json`)
-2. `serve(dir, { otel: { … } })`. `otel: false` disables env and
-   authored config.
+BDK installs trace, metric, and log providers before `bot/agent.ts`.
+A module-scope `trace.getTracer()`, `metrics.getMeter()`, or
+`logs.getLogger()` binds to those providers. Exporters attach when
+secrets load. With no `OTEL_EXPORTER_OTLP_*` endpoint, export stays
+off. Outbound fetch does not gain a `traceparent` header, and the
+session collector stays disabled.
 
 Metrics use delta temporality by default. For Grafana Cloud, set
 `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=cumulative`.
 
-`bot/otel.ts` is factory-only. Import `defineOtel` from
-`@cursor/bdk/internal/otel` only in a Cursor factory agent.
-A customer agent uses the environment variables above.
+Do not pass `otel` to `serve`. Do not add `bot/otel.ts`.
+Read the guide section "Migrating from serve({ otel })".
 
 Hosted agents:
 
-- Set `OTEL_EXPORTER_OTLP_ENDPOINT` and
-  `OTEL_EXPORTER_OTLP_HEADERS` with `bdk secrets set`. Add the
-  collector host to `hosting.egressDomains`.
+- Put the same variables in `bdk secrets set`, and add the collector
+  host to `hosting.egressDomains`.
 - Header values are URL-encoded (`Authorization=Basic%20...`).
-- A new header from `bdk secrets set` applies on the next export.
-  You do not redeploy for a token change.
-- BDK logs an error when an exporter host is not in
-  `hosting.egressDomains`.
-- Spans and metrics from before the first request are not exported.
-- If the OpenTelemetry config fails, BDK logs the error and the
-  request still completes.
-
-| Signal | Default |
-| --- | --- |
-| Traces | on (`agent_sdk.http`; `agent_sdk.turn` → tool / subagent) |
-| Metrics | on (`cursor.token.usage`, `cursor.tool.calls`, `cursor.cost.usage`) |
-| Logs | off (`logs: true` or `OTEL_LOGS_EXPORTER=otlp`) |
-
-Prompt text and tool payloads stay off the wire unless you set
-`OTEL_LOG_USER_PROMPTS` / `OTEL_LOG_TOOL_CONTENT`. A failed tool's
-span status and its `action.result` log include a short failure
-reason. BDK keeps its own exporters when the process already has a
-provider.
-
-## Custom metrics
-
-```ts
-ctx.host.otel.setAttributes({ "abc.ticket_id": "INC-123" });
-ctx.host.otel.increment("abc.ticket.resolved");
-ctx.host.otel.record("abc.approval.duration_ms", 1420);
-```
+- A new header or URL from `bdk secrets set` applies on the next export.
 
-Prefix names with team or agent. No custom spans. Join on
-`agent_sdk.session_id` / `cursor.conversation.id` and
-`agent_sdk.agent`.
+Not supported yet: custom span processors, samplers, views, your own
+SDK, and library auto-instrumentation. A span that ends before the
+exporters attach is still exported. `OTEL_TRACES_SAMPLER` and
+`OTEL_METRIC_EXPORT_INTERVAL` are read when the provider is built.

package/templates/code-wiki/evals/wiki.eval.ts

@@ -87,9 +87,9 @@ export default defineEval({
       async test(t) {
         await t.send(merged("Document factory delete in servicetests"), {
           workspaceFiles: {
-            "pr/files.txt": "backend/server/src/factory/README.md\n",
+            "pr/files.txt": "docs/factory/README.md\n",
             "pr/diff.patch": [
-              "diff --git a/backend/server/src/factory/README.md b/backend/server/src/factory/README.md",
+              "diff --git a/docs/factory/README.md b/docs/factory/README.md",
               "+Drive environment delete from markdown servicetests.",
             ].join("\n"),
             "wiki/pages.txt": "wiki/_index.md\n",