Skip to content

Commit 27d3d4c

Browse files
docs(javascript): Add Pi Durable guide (#19873)
<!-- Keep the urgency section so automation can prioritize this PR. You may delete other sections you don't need. --> ## DESCRIBE YOUR PR Adds a dedicated `javascript.pi-durable` platform guide for the Pi Durable integration added in getsentry/sentry-javascript#24993 (see also the [Pi Durable announcement](https://earendil.com/posts/pi-durable/)). It follows the same structure as the Flue, Eve, and Mastra guides. - `docs/platforms/javascript/guides/pi-durable/index.mdx`: Node.js setup (preload `instrument.mjs` with `--import`, or use the bundler plugin) - `docs/platforms/javascript/guides/pi-durable/cloudflare.mdx`: Cloudflare setup (`sentryCloudflareVitePlugin()` + `instrument.server.ts`, with an Agents SDK `PiHarness` example) - `includes/pi-durable/`: shared sections covering experimental status, captured telemetry (`gen_ai.invoke_agent` / `gen_ai.chat` / `gen_ai.execute_tool`), conversation IDs across restarts, crash recovery, captured errors, which provider integrations get skipped, current gaps, verification, and next steps - Adds `javascript.pi-durable` to common-page platform lists wherever Mastra appears (install-method pages stay visible, since a Pi Durable app controls its own startup) - Adds a Pi icon (`src/icons/pi-durable.svg`), plus entries on the Agent Tracing index and the Agents getting-started page Bun and Deno are left out for now because their setup couldn't be verified. Only Node and Cloudflare are documented. ## IS YOUR CHANGE URGENT? - [ ] Urgent deadline (GA date, etc.): YYYY-MM-DD - [ ] Other deadline: YYYY-MM-DD - [x] No deadline: Not urgent, can wait up to 1 week+ ## SLA - Teamwork makes the dream work, so please add a reviewer to your PRs. - Please give the docs team up to 1 week to review your PR unless you've supplied a deadline. ## PRE-MERGE CHECKLIST - [ ] Checked Vercel preview for correctness, including links - [ ] PR was reviewed and approved by any necessary SMEs (subject matter experts) - [ ] PR was reviewed and approved by a member of the [Sentry docs team](https://github.com/orgs/getsentry/teams/docs) <!-- junior-request-attribution:start --> via **Andrei Borza**. <!-- junior-request-attribution:end --> <!-- junior-session-footer:start --> <!-- junior-conversation-id:slack%3AC0BKK9QLCUA%3A1791533598.406349 --> -- [View Junior Session](https://junior-prod.sentry.dev/conversations/slack%3AC0BKK9QLCUA%3A1791533598.406349) [[Sentry]](https://sentry.sentry.io/explore/conversations/slack%3AC0BKK9QLCUA%3A1791533598.406349/?project=4510944073809921) <!-- junior-session-footer:end --> --------- Co-authored-by: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com> Co-authored-by: Andrei Borza <andrei.borza@sentry.io>
1 parent 6a952f1 commit 27d3d4c

30 files changed

Lines changed: 450 additions & 2 deletions

File tree

‎docs/platforms/javascript/common/agent-tracing/index.mdx‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,12 @@ As of SDK version `11.0.0`, Sentry auto-instruments the most popular AI SDKs and
9999
title: "Flue",
100100
icon: "flue",
101101
},
102+
{
103+
to: "/agent-tracing/pi-durable/",
104+
href: "/platforms/javascript/guides/pi-durable/",
105+
title: "Pi Durable",
106+
icon: "pi-durable",
107+
},
102108
]}
103109
/>
104110

‎docs/platforms/javascript/common/configuration/event-loop-block.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ supported:
77
- javascript.eve
88
- javascript.flue
99
- javascript.mastra
10+
- javascript.pi-durable
1011
- javascript.aws-lambda
1112
- javascript.azure-functions
1213
- javascript.express

‎docs/platforms/javascript/common/configuration/integrations/anthropic.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ supportedCategories:
66
- serverless
77
notSupported:
88
- javascript.mastra
9+
- javascript.pi-durable
910
---
1011

1112
<Alert>

‎docs/platforms/javascript/common/configuration/integrations/firebase.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ supported:
66
- javascript.eve
77
- javascript.flue
88
- javascript.mastra
9+
- javascript.pi-durable
910
- javascript.firebase
1011
- javascript.gcp-functions
1112
- javascript.astro

‎docs/platforms/javascript/common/configuration/integrations/google-genai.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ supportedCategories:
66
- serverless
77
notSupported:
88
- javascript.mastra
9+
- javascript.pi-durable
910
---
1011

1112
<Alert>

‎docs/platforms/javascript/common/configuration/integrations/groq.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ supportedCategories:
66
- serverless
77
notSupported:
88
- javascript.mastra
9+
- javascript.pi-durable
910
---
1011

1112
<Alert>

‎docs/platforms/javascript/common/configuration/integrations/langchain.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ supportedCategories:
66
- serverless
77
notSupported:
88
- javascript.mastra
9+
- javascript.pi-durable
910
---
1011

1112
<Alert>

‎docs/platforms/javascript/common/configuration/integrations/langgraph.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ supportedCategories:
66
- serverless
77
notSupported:
88
- javascript.mastra
9+
- javascript.pi-durable
910
---
1011

1112
<Alert>

‎docs/platforms/javascript/common/configuration/integrations/mistral.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ supportedCategories:
66
- serverless
77
notSupported:
88
- javascript.mastra
9+
- javascript.pi-durable
910
---
1011

1112
<Alert>

‎docs/platforms/javascript/common/configuration/integrations/nest.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ supported:
66
- javascript.eve
77
- javascript.flue
88
- javascript.mastra
9+
- javascript.pi-durable
910
- javascript.nestjs
1011
---
1112

0 commit comments

Comments
 (0)