Skip to content

docs(coding-agents): Cursor SDK tracing (TH-8263) - #917

Merged
nik13 merged 9 commits into
mainfrom
feat/th-8263-cursor-sdk
Nov 6, 2026
Merged

nik13 merged 9 commits into
mainfrom
feat/th-8263-cursor-sdk

Conversation

@nik13

@nik13 nik13 commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Add a local-runtime Cursor SDK guide using published @traceai/cursor-sdk@0.1.1, @traceai/fi-core@1.1.1 and @cursor/sdk@1.0.38.
  • Document callback-based child spans for streaming and wait-only runs, task snapshots, session grouping and the independent error-privacy gate. Keep the provider non-global and warn about duplicate IDE-hook traces.
  • Replace internal verification notes and obsolete release holds with a complete runnable example, supported-runtime boundaries and actionable troubleshooting.
  • Merge current main, register Cursor SDK in the shared integration catalog and add page-contract checks for CI.
  • Pin the docs browser-check runner to Ubuntu 24.04, supported by the locked Playwright version.

Validation

Package versions resolve on npm; behavior checked against the published instrumentation source. Build, link, catalog, browser and page-contract validation run in GitHub CI; no local tests or builds.

Closes TH-8263.

🤖 Generated with Claude Code

nik13 and others added 6 commits October 14, 2026 19:11
New page integrations/coding-agents/cursor-sdk: trace @cursor/sdk agent
runs with @traceai/cursor-sdk (install, env, register, manuallyInstrument,
run, what is captured, what is not available, plan availability, privacy
default and opt-in, troubleshooting). States the difference from the Cursor
IDE hook integration. Tested with @cursor/sdk 1.0.37, local runtime.

One nav entry under the coding-agents:cursor-sdk marker.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Register the Future AGI provider with setGlobalTracerProvider: false
  and pass it explicitly: @cursor/sdk emits its own internal spans
  (scope context-tracer) on the global provider.
- "Tested with" says what was verified: real 1.0.37 create/resume/prompt
  error paths and a missing-key local run; event mapping by replaying
  the documented events; live signed-in run pending.
- Install-from-source note while @traceai/cursor-sdk ships only with
  traceAI PR #253.
- Privacy section lists what error data is exported by default (class
  and structural fields, fixed status message) and what only on opt-in
  (messages, stack traces, Cursor's run-error text).
- Double-tracing warning when the Future AGI Cursor IDE hooks are
  installed in the repo or ~/.cursor; try/finally snippet that always
  flushes; captured-table fixes (conversation id on the run span only,
  session.id caveats, separate error and cancelled rows); stream-only
  child spans worded as a limitation of this version; plan sentence
  quoted from Cursor's pricing page; wrong-key vs missing-key
  troubleshooting; dashboard/api and Enterprise OTel links.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…to feat/th-8263-cursor-sdk

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Live runs on 2026-10-20 (Plus plan, @cursor/sdk 1.0.38, composer-2.5):
"Tested with" now says what ran live; the code sample passes the model's
params (Plus rejects composer-2.5 without fast=false); the captured table
explains Cursor's cache token accounting (input_tokens now includes cached
tokens, traceAI ed6ff22), RunError without a code, the request id source,
thinking durations and parallel tools; Plan availability lists the Plus
models; troubleshooting covers plan rejection and a relative cwd; the
dashboard link is grok.com/dashboard; agent.getUsage() 403 on Plus; a short
"Live verification (2026-10-20)" section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…kage row at npm and the main-branch source (TH-8263)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Cursor's SDK docs (cursor.com/docs/sdk/typescript, Authentication) send
users to cursor.com/dashboard/api for a user key and
cursor.com/dashboard/team-settings for a service-account key. The page
pointed at grok.com/dashboard, which is only where one xAI-linked
account was redirected.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Base automatically changed from feat/th-8229-cursor-hook-to-otlp to main October 29, 2026 05:37
Merge current main and use the integration catalog instead of the obsolete sidebar. Document the released callback capture and independent error-detail policy with published install pins, a runnable local-runtime example and page-contract checks. Remove internal verification notes and obsolete release holds.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@nik13
nik13 marked this pull request as ready for review November 6, 2026 00:31
nik13 and others added 2 commits November 5, 2026 16:34
Playwright 1.56.1 cannot install Chromium on the Ubuntu 26.04 image now selected by ubuntu-latest. Keep the docs-build job on Ubuntu 24.04 so the integration browser checks run after the build instead of failing during browser installation.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Merge current main into the existing Cursor SDK documentation branch. Keep main's equivalent Ubuntu 24.04 runner and comment so the published-package guide can merge without unrelated workflow changes.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@nik13
nik13 merged commit d176aef into main Nov 6, 2026
8 checks passed
@nik13
nik13 deleted the feat/th-8263-cursor-sdk branch November 6, 2026 07:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant