Add browser telemetry guide by ehfeng · Pull Request #384 · kernel/docs

ehfeng · 2026-05-28T16:37:22Z

Summary

Adds browsers/telemetry.mdx — a full guide for the SSE-based browser telemetry stream covering enabling capture, consuming events, per-category configuration (console, network, page, interaction), reconnection via Last-Event-ID, updating config on running sessions, and the event envelope schema
Adds telemetry to the sidebar nav under Working with your browser > Basics
Updates introduction/observe.mdx with a browser telemetry section and quick-start example

Test plan

mintlify dev renders the new page correctly
All internal links resolve (telemetry from observe, observe from telemetry)
Code examples in TypeScript and Python are syntactically correct
Event type tables render properly

🤖 Generated with Claude Code

Note

Low Risk
Documentation-only changes with no runtime, auth, or API implementation impact.

Overview
Adds browser telemetry documentation: a new browsers/telemetry.mdx guide for SSE streaming (enable/disable and per-category config at create and on running sessions, consuming the stream, Last-Event-ID / --seq resume, CLI telemetry stream, envelope schema, and event-type reference for console, network, page, interaction, and monitor).

Wires it into the site via docs.json (Basics nav), a Browser telemetry section and updated “Picking the right tool” bullet in introduction/observe.mdx, and CLI reference updates in reference/cli/browsers.mdx (--telemetry on create/update, kernel browsers update, and telemetry stream flags).

^{Reviewed by Cursor Bugbot for commit 32464f4. Bugbot is set up for automated code reviews on this repo. Configure here.}

Documents the SSE-based browser telemetry stream — enabling capture, consuming events, per-category configuration, reconnection, and the full event type reference across console, network, page, interaction, and monitor categories. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

firetiger-agent · 2026-05-28T16:37:41Z

Firetiger deploy monitoring skipped

This PR didn't match the auto-monitor filter configured on your GitHub connection:

Any PR that changes the kernel API. Monitor changes to API endpoints (packages/api/cmd/api/) and Temporal workflows (packages/api/lib/temporal) in the kernel repo

Reason: PR only adds documentation (MDX files) with no changes to API endpoints or Temporal workflows.

To monitor this PR anyway, reply with @firetiger monitor this.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7ca465dd5e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-05-28T16:40:20Z

+<CodeGroup>
+```typescript Typescript/Javascript
+const response = await fetch(
+  `https://api.onkernel.com/v1/browsers/${kernelBrowser.session_id}/telemetry`,


Use the unversioned browser endpoint

When a user copies this SSE URL, it points at https://api.onkernel.com/v1/browsers/..., but the Kernel API reference and existing raw HTTP examples in this repo use the unversioned https://api.onkernel.com/browsers/... path (PATCH /browsers/{id}, GET /browsers/{id}, and the project-scoping curl example). This same /v1 prefix is repeated in the Python, observe, and reconnect examples, so users following the guide will likely hit a 404 instead of opening the telemetry stream unless the URL is changed to the documented base path.

Useful? React with 👍 / 👎.

mintlify · 2026-05-28T16:48:37Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Kernel	🟢 Ready	View Preview	May 28, 2026, 4:49 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

- Add CLI examples (create, update, telemetry stream) to all code blocks - Document computed event heuristics (network_idle 500ms, layout_settled 1s) - Add interaction rate-limiting (20/s) and sensitive input suppression - Improve monitor event descriptions (screenshot triggers, reconnect details) - Add event context fields table for cross-tab/navigation correlation - Add telemetry commands to CLI reference (create --telemetry, update, stream) - Restructure event envelope as a table with source.kind descriptions Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

cursor

Stale comment

Risk assessment: Very Low

Evidence from the current diff: this PR only adds and updates documentation content (browsers/telemetry.mdx, introduction/observe.mdx, reference/cli/browsers.mdx) plus one Mintlify navigation entry in docs.json. The synchronize update adds CLI examples/reference details and telemetry guide clarifications, but still does not modify production code, infrastructure, auth/permissions, data schemas, prompts used by models, or shared runtime logic.

I found no CODEOWNERS file requiring owner review. The PR is already approved, so I’m not submitting another approval; the risk level has not increased, so the existing approval can remain.

_{Sent by Cursor Automation: Assign PR reviewers}

cursor

Stale comment

Risk assessment: Very Low

Evidence from the current diff: this PR adds browsers/telemetry.mdx, updates introduction/observe.mdx and reference/cli/browsers.mdx, and adds one Mintlify navigation entry in docs.json. These are documentation and docs-navigation changes only, with no production code, infrastructure, auth/permissions, data schema, shared runtime logic, or model prompt/instruction changes.

I found no CODEOWNERS file requiring owner review. The PR is already approved, so I’m not submitting another approval. The risk has not increased, so the existing approval can remain.

_{Sent by Cursor Automation: Assign PR reviewers}

- Rename "Event categories" to "Event types" - Rename "Event envelope" to "Event body" - Add event.data field tables for all 22 event types - Expand shared context fields (add target_type, loader_id) - Replace em dashes with hyphens throughout Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

cursor

Stale comment

Risk assessment: Very Low

Evidence from the current diff: this PR adds browsers/telemetry.mdx, updates introduction/observe.mdx and reference/cli/browsers.mdx, and adds one Mintlify navigation entry in docs.json. These are documentation and docs-navigation changes only, with no production code, infrastructure, auth/permissions, data schema, shared runtime logic, or model prompt/instruction changes.

I found no CODEOWNERS file requiring owner review. The PR is already approved, so I’m not submitting another approval. The synchronized changes do not increase risk, so the existing approval can remain.

_{Sent by Cursor Automation: Assign PR reviewers}

cursor

Stale comment

Risk assessment: Very Low

Evidence from the current diff: this PR adds browsers/telemetry.mdx, updates introduction/observe.mdx and reference/cli/browsers.mdx, and adds one Mintlify navigation entry in docs.json. These are documentation and docs-navigation changes only, with no production code, infrastructure, auth/permissions, data schema, shared runtime logic, or model prompt/instruction changes.

I found no CODEOWNERS file requiring owner review. The PR is already approved, so I’m not submitting another approval. The synchronized changes do not increase risk, so the existing approval can remain.

_{Sent by Cursor Automation: Assign PR reviewers}

dprevoznik

Left some comments!

- Replace raw HTTP reconnect example with TS/Python/CLI examples - Clarify interaction events are browser-native DOM events, not computer controls API calls - Reorder sections: Reconnecting > Updating telemetry > Event body > Event types Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

cursor

Stale comment

Risk assessment: Very Low

Evidence from the current diff: this PR only adds and updates Mintlify documentation content (browsers/telemetry.mdx, introduction/observe.mdx, reference/cli/browsers.mdx) plus one docs navigation entry in docs.json. It doesn’t modify production code, infrastructure, auth/permissions, data schemas, shared runtime logic, or model prompt/instruction files.

I found no CODEOWNERS file requiring owner review. The PR already has an approval, so I’m not submitting another approval. The synchronized changes don’t increase risk, so I’m not dismissing the existing approval.

_{Sent by Cursor Automation: Assign PR reviewers}

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

cursor

Risk assessment: Very Low

Evidence from the current diff: this PR only adds and updates Mintlify documentation content (browsers/telemetry.mdx, introduction/observe.mdx, reference/cli/browsers.mdx) plus one docs navigation entry in docs.json. It doesn't modify production code, infrastructure, auth/permissions, data schemas, shared runtime logic, or model prompt/instruction files.

I found no CODEOWNERS file in the PR head, so I don't see a codeowner review requirement from the repo contents. The PR already has a Cursor approval, so I'm not submitting another approval. The synchronized changes don't increase risk, so I'm not dismissing the existing approval.

_{Sent by Cursor Automation: Assign PR reviewers}

chatgpt-codex-connector Bot reviewed May 28, 2026

View reviewed changes

mintlify Bot deployed to staging May 28, 2026 16:49 View deployment

cursor Bot approved these changes May 28, 2026 •

edited

Loading

View reviewed changes

mintlify Bot deployed to staging May 28, 2026 17:24 View deployment

cursor Bot reviewed May 28, 2026

View reviewed changes

ehfeng closed this May 28, 2026

archandatta reopened this May 28, 2026

cursor Bot reviewed May 28, 2026

View reviewed changes

mintlify Bot deployed to staging May 29, 2026 11:59 View deployment

archandatta self-requested a review May 29, 2026 12:00

cursor Bot reviewed May 29, 2026

View reviewed changes

Merge branch 'main' into docs/browser-telemetry-guide

604b21b

mintlify Bot deployed to staging May 29, 2026 12:03 View deployment

cursor Bot reviewed May 29, 2026

View reviewed changes

archandatta requested a review from dprevoznik May 29, 2026 12:06

dprevoznik reviewed May 29, 2026

View reviewed changes

Comment thread browsers/telemetry.mdx Outdated

dprevoznik reviewed May 29, 2026

View reviewed changes

Comment thread browsers/telemetry.mdx Outdated

dprevoznik reviewed May 29, 2026

View reviewed changes

Comment thread browsers/telemetry.mdx Outdated

dprevoznik requested changes May 29, 2026

View reviewed changes

mintlify Bot deployed to staging May 29, 2026 14:22 View deployment

dprevoznik reviewed May 29, 2026

View reviewed changes

Comment thread introduction/observe.mdx

cursor Bot reviewed May 29, 2026

View reviewed changes

Move browser telemetry above invocation logs on observe page

32464f4

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

mintlify Bot deployed to staging May 29, 2026 14:32 View deployment

cursor Bot reviewed May 29, 2026

View reviewed changes

archandatta requested a review from dprevoznik May 29, 2026 17:07

Conversation

ehfeng commented May 28, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

firetiger-agent Bot commented May 28, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot May 28, 2026

Choose a reason for hiding this comment

Uh oh!

mintlify Bot commented May 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dprevoznik left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

ehfeng commented May 28, 2026 •

edited by cursor Bot

Loading

mintlify Bot commented May 28, 2026 •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading