feat(sdk): add SDK aliases and separate AI usage metrics by marandaneto · Pull Request #93911 · PostHog/posthog

marandaneto · 2026-09-03T06:32:33Z

Problem

SDK maintainers cannot distinguish several SDKs, aliases, and language-specific PostHog AI integrations in usage reports.

Feature flag analytics also classified newer package-specific SDK identifiers as unknown.

Changes

Usage reports now expose separate KMP and Node MCP event counts.
OpenCode events now have a separate sub-SDK count and no longer inflate the general Node count.
Python and .NET PostHog AI events now use language-specific metrics instead of the Node PostHog AI metric.
posthog-rails contributes to the existing Ruby metric.
posthog-aspnetcore contributes to the existing .NET metric.
The sub-SDK query groups by $lib and $ai_lib, then subtracts each sub-SDK from its correct parent SDK.
Both the Celery and Temporal report paths expose the new metrics.
Feature flag analytics now recognize KMP, Unity, Node MCP, Python MCP, Edge, Convex, Rails, and ASP.NET Core request identities.
The Rust and Python feature flag registries now contain the same identifiers, including posthog-server.

How did you test this code?

Extended usage classification and sub-SDK coverage for every new metric and alias.
Ran TestQueryUsageReportSQL and the Temporal usage-report query registry tests.
Ran the targeted feature flag Rust parser, library, runtime, and client-label tests.
Ran Rust formatting and Clippy for the feature flags crate.
Ran Ruff lint, Ruff formatting, hogli ci:preflight --fix, and the repository-wide mypy check.
A static parity check matched all 24 Python SDK names against Rust Library::as_str() values.
Database-backed coverage could not run because the local Postgres hostname was unavailable.
Updated the affected query snapshots mechanically.

Automatic notifications

Publish to changelog?

Docs update

None. This adds internal usage-report and feature flag analytics classification.

🤖 Agent context

Autonomy: Human-driven (agent-assisted)

Pi implemented and validated the change under human direction. No customer or private source material was used.

trunk-io · 2026-09-03T06:32:36Z

❌ This pull request could not start testing because there was a merge conflict. See more details here.

To merge this pull request, check the box to the left or comment /trunk merge below.

After your PR is submitted to the merge queue, this comment will be automatically updated with its status. If the PR fails, failure details will also be posted here

github-actions · 2026-09-03T06:34:43Z

🤖 CI report

⚠️

Trunk lane — backend Python lane

This PR is assigned to the backend Python lane. It runs backend Python tests and may merge in parallel with PRs in other lanes.

✅ Complexity (TypeScript) — clean

Cyclomatic complexity above the limit in changed typescript files (10 for production files, 15 for test files). Warn only: worth simplifying when you next touch these functions.

⚠️

Bundle size — 🔺 +19 B (+0.0%)

Uncompressed size of every built .js bundle, compared against the base branch.

Total: 68.38 MiB · 🔺 +19 B (+0.0%)

No file changed by more than 1000 B.

_{Posted automatically by build-bundle-size-report · uncompressed bytes from dist-report}

✅ Eager graph — within budget

How much code each root ships on the eager path — downloaded and parsed before the surface is interactive. Measured from the esbuild output chunks (post-tree-shake, static imports only); lazy import() / React.lazy chunks are not counted.

Root	Eager (shipped)	Δ vs base	Budget
entry (logged-out pages, app bootstrap) `src/index.tsx`	1.45 MiB · 22 files	no change	`███░░░░░░░` 32.3% of 4.51 MiB
authenticated shell (every logged-in page) `src/scenes/AuthenticatedShell.tsx`	8.88 MiB · 3,265 files	no change	`█████████░` 91.4% of 9.71 MiB

🟢 node_modules/monaco-editor/ stays out of src/index.tsx
🟢 src/lib/components/ActivityLog/describers stays out of src/index.tsx
🟢 [object Object] stays out of src/index.tsx
🟢 [object Object] stays out of src/index.tsx
🟢 node_modules/monaco-editor/ stays out of src/scenes/AuthenticatedShell.tsx
🟢 src/lib/components/ActivityLog/describers stays out of src/scenes/AuthenticatedShell.tsx
🟢 [object Object] stays out of src/scenes/AuthenticatedShell.tsx
🟢 [object Object] stays out of src/scenes/AuthenticatedShell.tsx

Largest files eagerly shipped from src/index.tsx

Size	File
126.8 KiB	`../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.production.min.js`
24.6 KiB	`../node_modules/.pnpm/buffer@6.0.3/node_modules/buffer/index.js`
6.3 KiB	`../node_modules/.pnpm/react@18.3.1/node_modules/react/cjs/react.production.min.js`
4.5 KiB	`../node_modules/.pnpm/@jspm+core@2.1.0/node_modules/@jspm/core/nodelibs/browser/process.js`
3.9 KiB	`../node_modules/.pnpm/scheduler@0.23.2/node_modules/scheduler/cjs/scheduler.production.min.js`
1.4 KiB	`../node_modules/.pnpm/base64-js@1.5.1/node_modules/base64-js/index.js`
1.3 KiB	`src/RootErrorBoundary.tsx`
912 B	`../node_modules/.pnpm/ieee754@1.2.1/node_modules/ieee754/index.js`
789 B	`src/scenes/ChunkLoadErrorBoundary.tsx`
762 B	`src/index.tsx`

Largest files eagerly shipped from src/scenes/AuthenticatedShell.tsx

Size	File
307.0 KiB	`../node_modules/.pnpm/posthog-js@1.422.5_@types+react@18.3.27_react@18.3.1/node_modules/posthog-js/dist/rrweb.js`
267.7 KiB	`../node_modules/.pnpm/@posthog+icons@0.38.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js`
263.5 KiB	`../node_modules/.pnpm/posthog-js@1.422.5_@types+react@18.3.27_react@18.3.1/node_modules/posthog-js/dist/module.js`
255.1 KiB	`src/taxonomy/core-filter-definitions-by-group.json`
154.2 KiB	`../node_modules/.pnpm/re2js@0.4.1/node_modules/re2js/build/index.esm.js`
126.8 KiB	`../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.production.min.js`
104.5 KiB	`src/lib/api.ts`
95.8 KiB	`../packages/quill/packages/quill/dist/index.js`
93.3 KiB	`../node_modules/.pnpm/prosemirror-view@1.40.1/node_modules/prosemirror-view/dist/index.js`
90.6 KiB	`../node_modules/.pnpm/@tiptap+core@3.20.6_@tiptap+pm@3.20.6/node_modules/@tiptap/core/dist/index.js`

_{Posted automatically by check-eager-graph · sizes are eager output bytes (shipped, post-tree-shake) from the esbuild metafile · part of #32479}

✅ Toolbar bundle — eager 2.27 MiB within budget

What the toolbar ships to customer pages, measured from the esbuild output (minified, post-tree-shake). The eager set is the entry plus everything statically imported from it — fetched before any feature runs; deferred chunks load lazily. The eager guardrail is 5.72 MiB. Each output file must also stay below 10 MB, where CloudFront stops compressing it. The module boundary is enforced separately by check-toolbar-graph.

Metric	Size	Δ vs base	Budget
Eager (shipped) entry + static imports	2.27 MiB · 18 files	no change	`████░░░░░░` 39.6% of 5.72 MiB
Deferred (lazy)	2.11 MiB · 45 files	no change	n/a — loads on demand
Loader `dist/toolbar.js`	1.1 KiB	no change	`█░░░░░░░░░` 5.8% of 19.5 KiB

Largest eagerly-shipped chunks

Size	File
754.1 KiB	`dist/toolbar/toolbar-app-YBL7L6MV.css`
590.5 KiB	`dist/toolbar/chunk-chunk-CQHMOG33.js`
484.7 KiB	`dist/toolbar/chunk-chunk-RFL5H2T4.js`
135.6 KiB	`dist/toolbar/chunk-chunk-XEL6EY25.js`
131.8 KiB	`dist/toolbar/chunk-chunk-FDH2IBXT.js`
71.3 KiB	`dist/toolbar/toolbar-app-BFD7RWNC.js`
69.0 KiB	`dist/toolbar/chunk-chunk-TSAL54PB.js`
35.6 KiB	`dist/toolbar/chunk-chunk-SGFE3VEH.js`
21.0 KiB	`dist/toolbar/chunk-chunk-7WCJ3CHT.js`
6.8 KiB	`dist/toolbar/chunk-chunk-DV7IWQNF.js`

_{Posted automatically by check-toolbar-size · sizes are toolbar output bytes (shipped, post-tree-shake) from the esbuild metafile}

✅ Dist folder size — 🔺 +205 B (+0.0%)

Total size of the built frontend/dist folder (all assets), compared against the base branch.

Total: 1459.57 MiB · 🔺 +205 B (+0.0%)

⚠️

Playwright — 1 failed

🎭 Playwright report · View test results →

❌ 1 failed test:

edits and deletes a check from Data Ops (chromium)

These issues are not necessarily caused by your changes.
Annoyed by this section? Help fix flakies and failures and it will go green!

greptile-apps · 2026-09-03T06:36:26Z

_{Reviews (1): Last reviewed commit: "feat(sdk): add KMP usage reporting" | Re-trigger Greptile}

trunk-io · 2026-09-03T06:51:19Z

_{View Full Report ↗︎ ⋅ Docs}

marandaneto · 2026-09-03T07:14:17Z

needs PostHog/posthog-python#917 but not a blocker, metrics will be zeroed until merged and thats fine

pawel-cebula

Usage report side looks good - haven't reviewed the flags part.

github-actions · 2026-09-03T12:20:07Z

🦔 Hogbox preview · ❌ build failed

The preview didn't come up for commit ba1e5aa. See the build log for the failing step. It'll retry on the next push.

_{Previews are optional and never block merging. A failure here is often a hogland or tailnet hiccup rather than anything in your PR, so the check stays green and this comment is the status.}

marandaneto · 2026-09-03T13:12:54Z

+        jest.useFakeTimers()
+        try {
+            jest.setSystemTime(new Date('2026-08-28T12:00:00Z'))
+            logic.actions.loadScoutRunsSuccess([
+                makeRun({ skill_name: 'signals-scout-busy', emitted_report_ids: ['r-1'] }),
+            ])
+        } finally {
+            jest.useRealTimers()
+        }


not related but its flaky in this pr

dustinbyrne

seems likely that SDK health (formerly SDK doctor) would need updating as well

feat(sdk): add KMP usage reporting

52012c5

marandaneto self-assigned this Sep 3, 2026

marandaneto marked this pull request as ready for review September 3, 2026 06:33

marandaneto requested review from a team September 3, 2026 06:33

feat(sdk): track Node MCP usage separately

5772a32

marandaneto changed the title ~~feat(sdk): add KMP usage reporting~~ feat(sdk): add KMP and Node MCP usage reporting Sep 3, 2026

feat(sdk): add OpenCode usage reporting

c7d0d5c

marandaneto changed the title ~~feat(sdk): add KMP and Node MCP usage reporting~~ feat(sdk): add KMP, Node MCP, and OpenCode usage reporting Sep 3, 2026

marandaneto added 2 commits September 3, 2026 09:09

feat(sdk): separate Python AI usage reporting

e105ea1

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

ed45279

marandaneto mentioned this pull request Sep 3, 2026

feat: identify MCP and AI analytics events by library PostHog/posthog-python#917

Open

5 tasks

marandaneto changed the title ~~feat(sdk): add KMP, Node MCP, and OpenCode usage reporting~~ feat(sdk): add KMP, Node MCP, OpenCode, and Python AI reporting Sep 3, 2026

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

af6a172

marandaneto mentioned this pull request Sep 3, 2026

fix(rails): attribute events and requests to posthog-rails PostHog/posthog-ruby#265

Open

5 tasks

ioannisj approved these changes Sep 3, 2026

View reviewed changes

feat(sdk): expand .NET and Ruby usage reporting

aed6e8e

marandaneto changed the title ~~feat(sdk): add KMP, Node MCP, OpenCode, and Python AI reporting~~ feat(sdk): add SDK aliases and separate AI usage metrics Sep 3, 2026

marandaneto added 6 commits September 3, 2026 11:11

fix(sdk): align MCP usage test with deduplication

bbac022

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

6029932

fix(flags): classify all SDK library identifiers

2e76adb

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

c9837bd

fix(flags): limit SDK classification to request identities

bd7dc1f

fix(flags): retain Rails request classification

d4508e9

pawel-cebula approved these changes Sep 3, 2026

View reviewed changes

marandaneto added 3 commits September 3, 2026 14:07

fix(flags): restore Python MCP request classification

cbe20b2

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

86eda53

fix(insights): satisfy strict axis ID indexing

b6d54c7

github-actions Bot had a problem deploying to preview-pr-93911 September 3, 2026 12:20 Failure

marandaneto requested a review from a team September 3, 2026 12:23

posthog-project-board-bot Bot added this to Feature Flags Sep 3, 2026

posthog-project-board-bot Bot moved this to In Review in Feature Flags Sep 3, 2026

github-project-automation Bot moved this from In Review to Approved in Feature Flags Sep 3, 2026

fix(signals): freeze scout roster test time

ba1e5aa

github-actions Bot had a problem deploying to preview-pr-93911 September 3, 2026 12:39 Failure

marandaneto commented Sep 3, 2026

View reviewed changes

turnipdabeets approved these changes Sep 3, 2026

View reviewed changes

dustinbyrne reviewed Sep 3, 2026

View reviewed changes

Navigation Menu

Uh oh!

feat(sdk): add SDK aliases and separate AI usage metrics - #93911

feat(sdk): add SDK aliases and separate AI usage metrics#93911
marandaneto wants to merge 17 commits into
masterfrom
sdk/kmp-usage-report

marandaneto commented Sep 3, 2026 •

edited

Loading

Uh oh!

trunk-io Bot commented Sep 3, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Sep 3, 2026 •

edited

Loading

Uh oh!

greptile-apps Bot commented Sep 3, 2026

Uh oh!

trunk-io Bot commented Sep 3, 2026 •

edited

Loading

Uh oh!

marandaneto commented Sep 3, 2026

Uh oh!

pawel-cebula left a comment

Uh oh!

github-actions Bot commented Sep 3, 2026 •

edited

Loading

Uh oh!

marandaneto Sep 3, 2026

Uh oh!

dustinbyrne left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

marandaneto commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Problem

Changes

How did you test this code?

Automatic notifications

Docs update

🤖 Agent context

Uh oh!

trunk-io Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🤖 CI report

Uh oh!

greptile-apps Bot commented Sep 3, 2026

Uh oh!

trunk-io Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

marandaneto commented Sep 3, 2026

Uh oh!

pawel-cebula left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦔 Hogbox preview · ❌ build failed

Uh oh!

marandaneto Sep 3, 2026

Choose a reason for hiding this comment

Uh oh!

dustinbyrne left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

marandaneto commented Sep 3, 2026 •

edited

Loading

trunk-io Bot commented Sep 3, 2026 •

edited

Loading

github-actions Bot commented Sep 3, 2026 •

edited

Loading

trunk-io Bot commented Sep 3, 2026 •

edited

Loading

github-actions Bot commented Sep 3, 2026 •

edited

Loading