andreiborza · Oct 9, 2026 · Oct 9, 2026 · Oct 9, 2026 · Oct 9, 2026
diff --git a/docs/platforms/javascript/common/agent-tracing/index.mdx b/docs/platforms/javascript/common/agent-tracing/index.mdx
@@ -99,6 +99,12 @@ As of SDK version `11.0.0`, Sentry auto-instruments the most popular AI SDKs and
       title: "Flue",
       icon: "flue",
     },
+    {
+      to: "/agent-tracing/pi-durable/",
+      href: "/platforms/javascript/guides/pi-durable/",
+      title: "Pi Durable",
+      icon: "pi-durable",
+    },
   ]}
 />
 

diff --git a/docs/platforms/javascript/common/configuration/event-loop-block.mdx b/docs/platforms/javascript/common/configuration/event-loop-block.mdx
@@ -7,6 +7,7 @@ supported:
   - javascript.eve
   - javascript.flue
   - javascript.mastra
+  - javascript.pi-durable
   - javascript.aws-lambda
   - javascript.azure-functions
   - javascript.express

diff --git a/docs/platforms/javascript/common/configuration/integrations/anthropic.mdx b/docs/platforms/javascript/common/configuration/integrations/anthropic.mdx
@@ -6,6 +6,7 @@ supportedCategories:
   - serverless
 notSupported:
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert>

diff --git a/docs/platforms/javascript/common/configuration/integrations/firebase.mdx b/docs/platforms/javascript/common/configuration/integrations/firebase.mdx
@@ -6,6 +6,7 @@ supported:
   - javascript.eve
   - javascript.flue
   - javascript.mastra
+  - javascript.pi-durable
   - javascript.firebase
   - javascript.gcp-functions
   - javascript.astro

diff --git a/docs/platforms/javascript/common/configuration/integrations/google-genai.mdx b/docs/platforms/javascript/common/configuration/integrations/google-genai.mdx
@@ -6,6 +6,7 @@ supportedCategories:
   - serverless
 notSupported:
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert>

diff --git a/docs/platforms/javascript/common/configuration/integrations/groq.mdx b/docs/platforms/javascript/common/configuration/integrations/groq.mdx
@@ -6,6 +6,7 @@ supportedCategories:
   - serverless
 notSupported:
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert>

diff --git a/docs/platforms/javascript/common/configuration/integrations/langchain.mdx b/docs/platforms/javascript/common/configuration/integrations/langchain.mdx
@@ -6,6 +6,7 @@ supportedCategories:
   - serverless
 notSupported:
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert>

diff --git a/docs/platforms/javascript/common/configuration/integrations/langgraph.mdx b/docs/platforms/javascript/common/configuration/integrations/langgraph.mdx
@@ -6,6 +6,7 @@ supportedCategories:
   - serverless
 notSupported:
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert>

diff --git a/docs/platforms/javascript/common/configuration/integrations/mistral.mdx b/docs/platforms/javascript/common/configuration/integrations/mistral.mdx
@@ -6,6 +6,7 @@ supportedCategories:
   - serverless
 notSupported:
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert>

diff --git a/docs/platforms/javascript/common/configuration/integrations/nest.mdx b/docs/platforms/javascript/common/configuration/integrations/nest.mdx
@@ -6,6 +6,7 @@ supported:
   - javascript.eve
   - javascript.flue
   - javascript.mastra
+  - javascript.pi-durable
   - javascript.nestjs
 ---
 

diff --git a/docs/platforms/javascript/common/configuration/integrations/openai.mdx b/docs/platforms/javascript/common/configuration/integrations/openai.mdx
@@ -6,6 +6,7 @@ supportedCategories:
   - serverless
 notSupported:
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert>

diff --git a/docs/platforms/javascript/common/configuration/integrations/together-ai.mdx b/docs/platforms/javascript/common/configuration/integrations/together-ai.mdx
@@ -6,6 +6,7 @@ supportedCategories:
   - serverless
 notSupported:
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert>

diff --git a/docs/platforms/javascript/common/configuration/integrations/typesafe.mdx b/docs/platforms/javascript/common/configuration/integrations/typesafe.mdx
@@ -7,6 +7,7 @@ supportedCategories:
 notSupported:
   - javascript.cloudflare
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert>

diff --git a/docs/platforms/javascript/common/configuration/integrations/vercelai.mdx b/docs/platforms/javascript/common/configuration/integrations/vercelai.mdx
@@ -6,6 +6,7 @@ supportedCategories:
   - serverless
 notSupported:
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert>

diff --git a/docs/platforms/javascript/common/feature-flags/index.mdx b/docs/platforms/javascript/common/feature-flags/index.mdx
@@ -8,6 +8,7 @@ notSupported:
   - javascript.eve
   - javascript.flue
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 ## Prerequisites

diff --git a/docs/platforms/javascript/common/migration/v7-to-v8/v8-opentelemetry.mdx b/docs/platforms/javascript/common/migration/v7-to-v8/v8-opentelemetry.mdx
@@ -8,6 +8,7 @@ supported:
   - javascript.eve
   - javascript.flue
   - javascript.mastra
+  - javascript.pi-durable
   - javascript.aws-lambda
   - javascript.azure-functions
   - javascript.express

diff --git a/docs/platforms/javascript/common/tracing/instrumentation/caches-module.mdx b/docs/platforms/javascript/common/tracing/instrumentation/caches-module.mdx
@@ -30,7 +30,7 @@ If you're using anything other than Sentry's Redis integration, you'll need to m
 
 You'll need to create two spans - one indicating that something is being put into the cache, and a second one indicating that something is being fetched from the cache.
 
-<PlatformSection supported={["javascript.node", "javascript.eve", "javascript.flue", "javascript.mastra", "javascript.deno", "javascript.bun"]}>
+<PlatformSection supported={["javascript.node", "javascript.eve", "javascript.flue", "javascript.mastra", "javascript.pi-durable", "javascript.deno", "javascript.bun"]}>
 
 Make sure that there's an active span before you create your cache spans. If you're using a web framework like Express, a span will be created for you automatically. See <PlatformLink to="/tracing/">Tracing</PlatformLink> for more information.
 

diff --git a/docs/platforms/javascript/common/user-feedback/configuration/index.mdx b/docs/platforms/javascript/common/user-feedback/configuration/index.mdx
@@ -7,6 +7,7 @@ notSupported:
   - javascript.eve
   - javascript.flue
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <PlatformCategorySection notSupported={["server-only", "mobile"]}>

diff --git a/docs/platforms/javascript/common/user-feedback/configuration/index__v7.x.mdx b/docs/platforms/javascript/common/user-feedback/configuration/index__v7.x.mdx
@@ -10,6 +10,7 @@ notSupported:
   - javascript.eve
   - javascript.flue
   - javascript.mastra
+  - javascript.pi-durable
 ---
 
 <Alert level="warning" title="Deprecation Warning">
@@ -18,7 +19,7 @@ In version 7 of our JavaScript SDK, User Feedback was released as a Beta integra
 
 </Alert>
 
-<PlatformSection notSupported={["javascript.node", "javascript.eve", "javascript.flue", "javascript.mastra", "javascript.aws-lambda", "javascript.azure-functions", "javascript.express", "javascript.fastify", "javascript.gcp-functions", "javascript.koa"]}>
+<PlatformSection notSupported={["javascript.node", "javascript.eve", "javascript.flue", "javascript.mastra", "javascript.pi-durable", "javascript.aws-lambda", "javascript.azure-functions", "javascript.express", "javascript.fastify", "javascript.gcp-functions", "javascript.koa"]}>
 
 ## User Feedback Widget
 

diff --git a/docs/platforms/javascript/guides/pi-durable/cloudflare.mdx b/docs/platforms/javascript/guides/pi-durable/cloudflare.mdx
@@ -0,0 +1,168 @@
+---
+title: Cloudflare Quick Start
+sidebar_order: 0.5
+description: Learn how to send Pi Durable agent runs, model requests, tool calls, and errors to Sentry from Cloudflare Durable Objects.
+---
+
+[Pi Durable](https://earendil.com/posts/pi-durable/) is Earendil's durable agent harness, built on the same foundations as the Pi coding agent. This guide sets up the Sentry SDK in a Worker that runs Pi Durable in a Durable Object, for example through the Agents SDK `PiHarness`, so agent runs, model requests, tool calls, and errors flow into [Sentry Agent Tracing](/product/agents/).
+
+<Include name="pi-durable/experimental-alert" />
+
+Running Pi Durable on Node.js? Follow the [Pi Durable Quick Start](../) instead.
+
+## Prerequisites
+
+Before you begin, you need:
+
+- A Sentry [account](https://sentry.io/signup/) and [project](/product/projects/). The project's DSN tells the SDK where to send data.
+- A Worker using `@earendil-works/pi-durable` version `1.0.0` or later, built with Vite and `@cloudflare/vite-plugin`. To host Pi Durable with `PiHarness`, you need the Agents SDK (`agents`) version `0.26.0` or later.
+- `@sentry/cloudflare` version `11.6.0` or later.
+
+<StepConnector selector="h2" showNumbers={true}>
+
+## Install
+
+Choose the features you want to configure, and this guide will show you how:
+
+<OnboardingOptionButtons
+  options={["error-monitoring", "performance"]}
+  defaults={["performance"]}
+/>
+
+Install the Sentry Cloudflare SDK:
+
+```bash {tabTitle:npm}
+npm install @sentry/cloudflare@^11.6.0
+```
+
+```bash {tabTitle:yarn}
+yarn add @sentry/cloudflare@^11.6.0
+```
+
+```bash {tabTitle:pnpm}
+pnpm add @sentry/cloudflare@^11.6.0
+```
+
+## Configure
+
+Add the Sentry Vite plugin to your Vite config:
+
+```typescript {filename:vite.config.mts}
+import { cloudflare } from "@cloudflare/vite-plugin";
+import { sentryCloudflareVitePlugin } from "@sentry/cloudflare/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [cloudflare(), sentryCloudflareVitePlugin()],
+});
+```
+
+The plugin instruments `Harness.open()` at build time, so every Harness your Worker opens is traced. It also wraps your Worker entry, your Durable Object classes, and your Agents SDK classes with Sentry, so `Sentry.init()` runs in the Durable Object that hosts Pi Durable without any changes to your code.
+
+Create an `instrument.server.ts` file next to your Worker entry (the file named in Wrangler's `main`). The plugin picks it up by convention and uses its default export as the Sentry options:
+
+```typescript {filename:src/instrument.server.ts}
+import { defineCloudflareOptions } from "@sentry/cloudflare";
+
+export default defineCloudflareOptions((env: Env) => ({
+  dsn: "___PUBLIC_DSN___",
+  // ___PRODUCT_OPTION_START___ performance
+
+  // Set tracesSampleRate to 1.0 to capture 100%
+  // of spans for tracing.
+  // We recommend adjusting this value in production.
+  tracesSampleRate: 1.0,
+  // ___PRODUCT_OPTION_END___ performance
+}));
+```
+
+Enable Node.js compatibility in your Wrangler config so the SDK can run on Workers:
+
+```toml {filename:wrangler.toml}
+main = "src/index.ts"
+compatibility_flags = ["nodejs_compat"]
+```
+
+Your Pi Durable code doesn't change. For example, an Agents SDK class that hosts Pi Durable with `PiHarness` is traced as is:
+
+```typescript {filename:src/assistant.ts}
+import { createModels } from "@earendil-works/pi-ai/models";
+import { openaiProvider } from "@earendil-works/pi-ai/providers/openai";
+import { createRegistry, Harness } from "@earendil-works/pi-durable";
+import { Agent } from "agents";
+import { PiHarness } from "agents/harness/pi";
+
+export class Assistant extends Agent<Env> {
+  registry = createRegistry();
+
+  harness = new PiHarness({
+    harness: ({ storage, context }) => {
+      // pi-ai reads provider keys from `process.env` by default, so hand over the Worker's secret.
+      const models = createModels({
+        authContext: {
+          env: async (name) =>
+            name === "OPENAI_API_KEY" ? this.env.OPENAI_API_KEY : undefined,
+          fileExists: async () => false,
+        },
+      });
+      models.setProvider(openaiProvider());
+      return Harness.open(
+        storage,
+        { models, registry: this.registry },
+        context
+      );
+    },
+    defaults: { model: { provider: "openai", id: "gpt-6.1-sol" } },
+  });
+
+  constructor(ctx: DurableObjectState, env: Env) {
+    super(ctx, env);
+    this.lifecycle.use(this.harness);
+  }
+}
+```
+
+<Include name="pi-durable/captured-summary" />
+
+### Control the Data You Send to Sentry (Optional)
+
+By default, the SDK sends the inputs and outputs of your model requests and tool calls, such as prompts, responses, and tool arguments.
+This will give you rich debugging context. Review the data your agent handles before you deploy to production.
+
+The SDK always filters sensitive values whose keys match a built-in denylist, such as `auth` or `password`, and sends `[Filtered]` instead.
+
+To send less data, turn off the categories you don't need in the `dataCollection` option:
+
+```typescript {filename:src/instrument.server.ts} {5-7}
+import { defineCloudflareOptions } from "@sentry/cloudflare";
+
+export default defineCloudflareOptions((env: Env) => ({
+  dsn: "___PUBLIC_DSN___",
+  dataCollection: {
+    genAI: { inputs: false, outputs: false },
+  },
+}));
+```
+
+For the full list of categories and their defaults, see the [`dataCollection` options](../configuration/options/#dataCollection).
+
+<Include name="pi-durable/link-conversations" />
+
+<Include name="pi-durable/verify" />
+
+</StepConnector>
+
+## Troubleshooting
+
+- **No AI spans at all.** Confirm `sentryCloudflareVitePlugin()` is in your Vite config and that you build and run the Worker through Vite. A Worker you deploy with `wrangler` directly, without the plugin, doesn't get the build-time instrumentation of `Harness.open()`.
+- **Every restart of the Durable Object starts a new conversation in Sentry.** This is expected for now. See [Link Conversations](#link-conversations).
+
+<Include name="pi-durable/next-steps" />
+
+<Include name="pi-durable/what-gets-captured" />
+
+## Supported Versions
+
+- `@sentry/cloudflare`: `>=11.6.0`
+- `@earendil-works/pi-durable`: `>=1.0.0 <2.0.0`
+- `agents`: `>=0.26.0`, when you host Pi Durable with `PiHarness`