Repository navigation
Commit 27d3d4c
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
- configuration
- integrations
- feature-flags
- migration/v7-to-v8
- tracing/instrumentation
- user-feedback/configuration
- guides/pi-durable
- product/agents
- includes/pi-durable
- src
- components
- icons
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
99 | 99 | | |
100 | 100 | | |
101 | 101 | | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
102 | 108 | | |
103 | 109 | | |
104 | 110 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
| 10 | + | |
10 | 11 | | |
11 | 12 | | |
12 | 13 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| 9 | + | |
9 | 10 | | |
10 | 11 | | |
11 | 12 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| 9 | + | |
9 | 10 | | |
10 | 11 | | |
11 | 12 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| 9 | + | |
9 | 10 | | |
10 | 11 | | |
11 | 12 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| 9 | + | |
9 | 10 | | |
10 | 11 | | |
11 | 12 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| 9 | + | |
9 | 10 | | |
10 | 11 | | |
11 | 12 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| 9 | + | |
9 | 10 | | |
10 | 11 | | |
11 | 12 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| 9 | + | |
9 | 10 | | |
10 | 11 | | |
11 | 12 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| 9 | + | |
9 | 10 | | |
10 | 11 | | |
11 | 12 | | |
| |||
0 commit comments