Skip to content

docs(coding-agents): Devin application session tracing (TH-8293) - #914

Merged
nik13 merged 5 commits into
mainfrom
feat/th-8293-devin
Nov 6, 2026
Merged

nik13 merged 5 commits into
mainfrom
feat/th-8293-devin

Conversation

@nik13

@nik13 nik13 commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Keep hosted Devin as a support-status page, not a direct Future AGI integration.
  • Link Cognition's native SDK tracing guide and distinguish customer-run cloud-session tracing from hosted export. Preserve content-off guidance, live-only coverage, turn parentage, and cloud token/cost limits.
  • Remove verification diaries and obsolete setup language. Register the page in the shared coding-agent support aids; leave navigation generated from the catalog.
  • Merge current main and replace the standalone Python contract with eight Node page-contract checks included in GitHub CI.
  • Pin the browser-build job to Ubuntu 24.04, which the existing Playwright version supports.

Scope: TH-8293. Devin Desktop (TH-8294) remains a separate setup; this PR adds no connector, credential setting, or trace endpoint.

Validation

GitHub PR Checks cover the page contract, catalog, links, redirects, and site build. No local tests or builds were run.

🤖 Generated with Claude Code

…H-8293)

Decision N-09: docs-only page, no connector. Re-checked docs.devin.ai on
2026-10-14: hosted Devin has no server-side export of session activity.
The page lists every documented surface (automation webhook trigger and
email action, Session Insights, sessions and audit-log APIs, Devin MCP
session tools, the beta Devin SDK and its client-side OpenTelemetry
tracing) and why none is a session trace export Future AGI can receive,
what a customer can do instead, and what would reopen it. No poller,
no Devin credential field, no Cascade hook configuration.

examples/coding-agents/devin/test_page.py checks those boundaries.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@nik13
nik13 force-pushed the feat/th-8293-devin branch from 8ad56a1 to bf28b13 Compare October 15, 2026 02:50
nik13 and others added 2 commits October 15, 2026 08:52
…sink, Desktop claim (TH-8293)

- Devin SDK tracing is now "(untested)": drop the Future AGI endpoint,
  header and project_name bullets (PRD R-01 "No sample endpoint", R-02
  "No Future AGI URL for Devin to call as a trace sink"); link Cognition's
  tracing guide plus the generic Instrument and Verify quickstart.
- Lead the SDK caveats with "content is recorded by default; set
  recordContent: false unless you want that text in your trace backend",
  and note one trace per turn unless a parent span is passed.
- New Privacy section: hosted Devin sends nothing to Future AGI; the SDK
  path is content-on until recordContent: false.
- Devin Desktop page is still a draft PR: stop claiming Future AGI supports
  Cascade; link Cognition's Cascade hooks doc and say a recipe is in progress.
- About: Cognition does not export a session's steps or tool calls to an
  endpoint you configure; surfaces start Devin, send a notification or chat
  reply, or are called with a Devin key. Add the Slack/Teams row.
- "## Next Steps" per STYLE-GUIDE.md; re-check date 2026-10-15.
- test_page.py: 11 tests (no FI trace sink, recordContent first caveat,
  Privacy section, Desktop linked-or-not-claimed, internal links, heading).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…#921 (TH-8293)

The two Devin Desktop mentions said a Future AGI recipe was "in progress
and not published yet", which becomes false once docs#921 adds
/docs/integrations/coding-agents/devin-desktop. They now say tracing Devin
Desktop is a separate setup that this page does not describe, with no
link (the Desktop page is not on this branch, so a link would fail the
link audit here).

test_page.py: the Desktop check no longer requires a link when the Desktop
page exists. It forbids stale "not published" / "in progress" claims and a
support claim in both trees, forbids the link while the Desktop page is
absent, and accepts either the neutral pointer or a link once it exists.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@nik13
nik13 marked this pull request as ready for review October 21, 2026 22:59
Base automatically changed from feat/th-8229-cursor-hook-to-otlp to main October 29, 2026 05:37
nik13 and others added 2 commits November 5, 2026 16:30
Merge current main and register hosted Devin as a support-status aid instead of a legacy sidebar entry. Remove verification diaries while retaining customer-run native OpenTelemetry, content privacy and cloud-session limits. Migrate the old Python page contract into the Node integration suite so CI enforces the public support boundary.

Co-Authored-By: Claude Code <noreply@anthropic.com>
The Devin PR passed its catalog and page-contract checks, but browser installation failed because ubuntu-latest selected Ubuntu 26.04, unsupported by the pinned Playwright 1.56.1. Keep the browser job on its supported OS without changing dependencies or the passing conformance jobs.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@nik13
nik13 merged commit b7f0182 into main Nov 6, 2026
8 checks passed
@nik13
nik13 deleted the feat/th-8293-devin 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