From 5869a682529ddae79bb3e3bd8a212b03946b7507 Mon Sep 17 00:00:00 2001
From: Nicolas Hrubec <nico.hrubec@sentry.io>
Date: Thu, 10 Sep 2026 16:08:05 +0200
Subject: [PATCH] docs(agent-tracing): remove the streamGenAiSpans option

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../javascript/common/agent-tracing/flue.mdx  |  2 --
 .../javascript/common/agent-tracing/index.mdx | 32 -------------------
 .../common/configuration/options.mdx          | 10 ------
 3 files changed, 44 deletions(-)

diff --git a/docs/platforms/javascript/common/agent-tracing/flue.mdx b/docs/platforms/javascript/common/agent-tracing/flue.mdx
index 15b32971244b7..c701adbb2fffe 100644
--- a/docs/platforms/javascript/common/agent-tracing/flue.mdx
+++ b/docs/platforms/javascript/common/agent-tracing/flue.mdx
@@ -108,7 +108,6 @@ Sentry.init({
   enabled: Boolean(process.env.SENTRY_DSN),
   tracesSampleRate,
   traceLifecycle: "stream",
-  streamGenAiSpans: true,
   enableLogs: true,
   // Flue already emits one `chat` span per model call, so Sentry's
   // AI provider integrations are removed to avoid double counting.
@@ -165,7 +164,6 @@ export const cloudflare = extend({
         release: env.SENTRY_RELEASE,
         tracesSampleRate: clampRate(env.SENTRY_TRACES_SAMPLE_RATE, 0),
         traceLifecycle: "stream",
-        streamGenAiSpans: true,
         enableLogs: true,
         integrations: (defaults) =>
           defaults.filter((i) => !SENTRY_AI_PROVIDER_INTEGRATIONS.has(i.name)),
diff --git a/docs/platforms/javascript/common/agent-tracing/index.mdx b/docs/platforms/javascript/common/agent-tracing/index.mdx
index 79825ac2ce7f1..2a46a086d5474 100644
--- a/docs/platforms/javascript/common/agent-tracing/index.mdx
+++ b/docs/platforms/javascript/common/agent-tracing/index.mdx
@@ -215,38 +215,6 @@ On the default CF entrypoint, control Vercel AI I/O with `experimental_telemetry
 
 From SDK `10.61.0`, `gen_ai` spans are sent as standalone envelope items (avoids large-payload drops; required for <Link to="/product/agents/conversations/">Conversations</Link>).
 
-Self-hosted Sentry users should set `streamGenAiSpans: false` if standalone `gen_ai` spans may not be ingested.
-
-<PlatformSection notSupported={["javascript.cloudflare"]}>
-
-```javascript
-Sentry.init({
-  dsn: "___PUBLIC_DSN___",
-  streamGenAiSpans: false,
-});
-```
-
-</PlatformSection>
-
-<PlatformSection supported={["javascript.cloudflare"]}>
-
-```javascript
-export default Sentry.withSentry(
-  (env) => ({
-    dsn: "___PUBLIC_DSN___",
-    tracesSampleRate: 1.0,
-    streamGenAiSpans: false,
-  }),
-  {
-    async fetch(request, env, ctx) {
-      /* ... */
-    },
-  }
-);
-```
-
-</PlatformSection>
-
 ## Manual Instrumentation
 
 You can also instrument agent spans yourself. See <PlatformLink to="/agent-tracing/manual-instrumentation/">manual instrumentation</PlatformLink>.
diff --git a/docs/platforms/javascript/common/configuration/options.mdx b/docs/platforms/javascript/common/configuration/options.mdx
index 6a57dbed97038..1b53cbf261ec9 100644
--- a/docs/platforms/javascript/common/configuration/options.mdx
+++ b/docs/platforms/javascript/common/configuration/options.mdx
@@ -742,16 +742,6 @@ See <PlatformLink to="/tracing/distributed-tracing/dealing-with-cors-issues/">De
 
 </SdkOption>
 
-<SdkOption name="streamGenAiSpans" type='boolean' defaultValue='true' defaultNote='since version 10.61.0' availableSince='10.53.0'>
-
-When enabled, `gen_ai` spans are sent as standalone envelope items instead of being bundled in the transaction payload. This prevents AI spans with large inputs and outputs from being dropped due to transaction payload size limits.
-
-This is enabled by default starting with SDK version `10.61.0` (before that, it defaulted to `false`). Set it to `false` to send `gen_ai` spans as part of the transaction instead.
-
-Self-hosted Sentry users should set this option to `false`, as standalone `gen_ai` spans may not be ingested by their Sentry instance.
-
-</SdkOption>
-
 <SdkOption name="traceLifecycle" type="'static' | 'stream'" defaultValue="'static'" availableSince='10.53.1'>
 
 Controls how spans are sent to Sentry: