feat(sdk): report a development session when an integration is created

apps/website/content/AGENTS.md.template

@@ -25,8 +25,10 @@ See https://threadplane.ai/privacy.
 
 
 Supported runtime/browser collection is automatic only in Angular development mode.
-Production builds, SSR, imports, unused construction, and automated browsers
-reporting `navigator.webdriver` are inert. It sends closed
+Production builds, SSR, imports, and automated browsers reporting
+`navigator.webdriver` are inert. Creating an agent (or a render element) in a
+development-mode browser reports one session start per integration per session;
+milestones are reported only when the runtime is actually used. It sends closed
 progress milestones with package/version and random browser-origin/session IDs, never
 conversation content or private URLs. Adapter `telemetry: false` disables it; a custom
 sink replaces the automatic destination, including nested chat JSON rendering. Use

apps/website/content/CLAUDE.md.template

@@ -25,8 +25,10 @@ See https://threadplane.ai/privacy.
 
 
 Supported runtime/browser collection is automatic only in Angular development mode.
-Production builds, SSR, imports, unused construction, and automated browsers
-reporting `navigator.webdriver` are inert. It sends closed
+Production builds, SSR, imports, and automated browsers reporting
+`navigator.webdriver` are inert. Creating an agent (or a render element) in a
+development-mode browser reports one session start per integration per session;
+milestones are reported only when the runtime is actually used. It sends closed
 progress milestones with package/version and random browser-origin/session IDs, never
 conversation content or private URLs. Adapter `telemetry: false` disables it; a custom
 sink replaces the automatic destination, including nested chat JSON rendering. Use

apps/website/public/AGENTS.md

@@ -25,8 +25,10 @@ See https://threadplane.ai/privacy.
 
 
 Supported runtime/browser collection is automatic only in Angular development mode.
-Production builds, SSR, imports, unused construction, and automated browsers
-reporting `navigator.webdriver` are inert. It sends closed
+Production builds, SSR, imports, and automated browsers reporting
+`navigator.webdriver` are inert. Creating an agent (or a render element) in a
+development-mode browser reports one session start per integration per session;
+milestones are reported only when the runtime is actually used. It sends closed
 progress milestones with package/version and random browser-origin/session IDs, never
 conversation content or private URLs. Adapter `telemetry: false` disables it; a custom
 sink replaces the automatic destination, including nested chat JSON rendering. Use

apps/website/public/CLAUDE.md

@@ -25,8 +25,10 @@ See https://threadplane.ai/privacy.
 
 
 Supported runtime/browser collection is automatic only in Angular development mode.
-Production builds, SSR, imports, unused construction, and automated browsers
-reporting `navigator.webdriver` are inert. It sends closed
+Production builds, SSR, imports, and automated browsers reporting
+`navigator.webdriver` are inert. Creating an agent (or a render element) in a
+development-mode browser reports one session start per integration per session;
+milestones are reported only when the runtime is actually used. It sends closed
 progress milestones with package/version and random browser-origin/session IDs, never
 conversation content or private URLs. Adapter `telemetry: false` disables it; a custom
 sink replaces the automatic destination, including nested chat JSON rendering. Use

libs/ag-ui/README.md

@@ -235,9 +235,11 @@ MIT. See [LICENSE](../../LICENSE).
 ## Development browser collection
 
 Supported LangGraph/AG-UI runtime use and real JSON-render component mounts automatically
-report development progress to Threadplane. Angular development mode and browser APIs
-are required. Production builds, SSR, imports, unused adapter construction, and
-automated browsers reporting `navigator.webdriver` are inert.
+report development progress to Threadplane. Angular development mode and browser APIs are
+required. Production builds, SSR, imports, and automated browsers reporting
+`navigator.webdriver` are inert. Creating an agent (or a render element) in a
+development-mode browser reports one session start per integration per session; milestones
+are reported only when the runtime is actually used.
 Reports contain package/version, integration, closed milestones, timestamps, a random
 browser-origin ID, and a session with a 30-minute inactivity boundary. They exclude
 prompts, messages, application state, private URLs, thread/run IDs, and credentials.

libs/ag-ui/src/lib/to-agent.spec.ts

@@ -40,14 +40,16 @@ describe('automatic development evidence', () => {
       expect(isDevelopmentRuntimeEnabled(agent)).toBe(telemetry === undefined);
     }
   });
-  it('requires a current RUN_FINISHED success, and ignores construction and empty close', async () => {
+  it('reports a session on construction and requires a current RUN_FINISHED success', async () => {
     developmentEvidence.events = []; developmentEvidence.touches = 0;
     const stub = new StubAgent();
     const agent = toAgent(stub as unknown as AbstractAgent);
-    expect(developmentEvidence.touches).toBe(0);
-    await agent.submit({});
     expect(developmentEvidence.touches).toBe(1);
     expect(developmentEvidence.events).toEqual([]);
+    await agent.submit({});
+    // construction plus exactly one beginRun per submit
+    expect(developmentEvidence.touches).toBe(2);
+    expect(developmentEvidence.events).toEqual([]);
     stub.runAgent.mockImplementationOnce(async () => {
       stub.emit({ type: 'UNKNOWN' } as BaseEvent);
       expect(developmentEvidence.events).toEqual([]);

libs/ag-ui/src/lib/to-agent.ts

@@ -265,6 +265,8 @@ function createAgentAdapter(
     installationToken: (typeof ngDevMode === 'undefined' || ngDevMode) && isDevMode() ? installationToken : null,
     enabled: () => options.telemetry === undefined,
   });
+  // One session observation per boot; guards and dedupe live inside touch().
+  developmentRuntime.touch();
   interface AdapterRun extends ReducerDeliveryRun {
     startedAt: number;
     telemetrySettled: boolean;

libs/chat/README.md

@@ -380,9 +380,11 @@ MIT. See [LICENSE.md](./LICENSE.md).
 ## Development browser collection
 
 Supported LangGraph/AG-UI runtime use and real JSON-render component mounts automatically
-report development progress to Threadplane. Angular development mode and browser APIs
-are required. Production builds, SSR, imports, unused adapter construction, and
-automated browsers reporting `navigator.webdriver` are inert.
+report development progress to Threadplane. Angular development mode and browser APIs are
+required. Production builds, SSR, imports, and automated browsers reporting
+`navigator.webdriver` are inert. Creating an agent (or a render element) in a
+development-mode browser reports one session start per integration per session; milestones
+are reported only when the runtime is actually used.
 Reports contain package/version, integration, closed milestones, timestamps, a random
 browser-origin ID, and a session with a 30-minute inactivity boundary. They exclude
 prompts, messages, application state, private URLs, thread/run IDs, and credentials.

libs/langgraph/README.md

@@ -252,9 +252,11 @@ MIT. See [LICENSE](../../LICENSE).
 ## Development browser collection
 
 Supported LangGraph/AG-UI runtime use and real JSON-render component mounts automatically
-report development progress to Threadplane. Angular development mode and browser APIs
-are required. Production builds, SSR, imports, unused adapter construction, and
-automated browsers reporting `navigator.webdriver` are inert.
+report development progress to Threadplane. Angular development mode and browser APIs are
+required. Production builds, SSR, imports, and automated browsers reporting
+`navigator.webdriver` are inert. Creating an agent (or a render element) in a
+development-mode browser reports one session start per integration per session; milestones
+are reported only when the runtime is actually used.
 Reports contain package/version, integration, closed milestones, timestamps, a random
 browser-origin ID, and a session with a 30-minute inactivity boundary. They exclude
 prompts, messages, application state, private URLs, thread/run IDs, and credentials.

libs/langgraph/src/lib/internals/stream-manager.bridge.spec.ts

@@ -32,13 +32,20 @@ describe('automatic development evidence', () => {
     return { transport, subjects, destroy$, bridge };
   }
 
+  it('reports a session on construction before any request', () => {
+    const { destroy$ } = setup();
+    expect(developmentEvidence.touches).toBe(1);
+    expect(developmentEvidence.events).toEqual([]);
+    destroy$.next();
+    expect(developmentEvidence.disposed).toBe(1);
+  });
+
   it('requires root terminal evidence and disposes with the bridge', async () => {
     const { transport, bridge, destroy$ } = setup();
-    expect(developmentEvidence.touches).toBe(0);
     const run = bridge.submit({});
     transport.emit([{ type: 'values', data: { done: true } }]); transport.close();
     await run;
-    expect(developmentEvidence.touches).toBeGreaterThan(0);
+    expect(developmentEvidence.touches).toBeGreaterThan(1);
     expect(developmentEvidence.events).toContain('transport.connected');
     expect(developmentEvidence.events).toContain('runtime.first_stream_completed');
     destroy$.next();

libs/langgraph/src/lib/internals/stream-manager.bridge.ts

@@ -150,6 +150,9 @@ export function createStreamManagerBridge<T, ResolvedBag extends BagTemplate = B
     installationToken: (typeof ngDevMode === 'undefined' || ngDevMode) && isDevMode() ? installationToken : null,
     enabled: () => options.telemetry === undefined,
   });
+  // One session observation per boot. touch() carries every guard and the
+  // per-session dedupe, so this is inert in production, automation and SSR.
+  developmentRuntime.touch();
   // Intercept onThreadId so currentThreadId tracks a thread the DEFAULT
   // transport auto-creates. Without this, each submit() would create a new
   // thread because currentThreadId stays null. This wrapper only reaches the

libs/render/README.md

@@ -129,9 +129,11 @@ MIT. See [LICENSE](../../LICENSE).
 ## Development browser collection
 
 Supported LangGraph/AG-UI runtime use and real JSON-render component mounts automatically
-report development progress to Threadplane. Angular development mode and browser APIs
-are required. Production builds, SSR, imports, unused adapter construction, and
-automated browsers reporting `navigator.webdriver` are inert.
+report development progress to Threadplane. Angular development mode and browser APIs are
+required. Production builds, SSR, imports, and automated browsers reporting
+`navigator.webdriver` are inert. Creating an agent (or a render element) in a
+development-mode browser reports one session start per integration per session; milestones
+are reported only when the runtime is actually used.
 Reports contain package/version, integration, closed milestones, timestamps, a random
 browser-origin ID, and a session with a 30-minute inactivity boundary. They exclude
 prompts, messages, application state, private URLs, thread/run IDs, and credentials.

libs/render/src/lib/development-mount.spec.ts

@@ -20,11 +20,15 @@ class FallbackComponent {}
 
 describe('development generative UI mount evidence', () => {
   let mounted: ReturnType<typeof vi.fn>;
+  let touched: ReturnType<typeof vi.fn>;
   beforeEach(() => {
     mounted = vi.fn();
+    touched = vi.fn();
     vi.spyOn(telemetry, 'createDevelopmentRuntime').mockImplementation(
       (options) => ({
-        touch: vi.fn(),
+        touch: () => {
+          if (options.enabled?.() !== false) touched();
+        },
         dispose: vi.fn(),
         milestone: (kind) => {
           if (options.enabled?.() !== false) mounted(kind);
@@ -95,6 +99,7 @@ describe('development generative UI mount evidence', () => {
     fx.componentRef.setInput('telemetry', false);
     fx.detectChanges();
     expect(mounted).not.toHaveBeenCalled();
+    expect(touched).not.toHaveBeenCalled();
   });
   it('honors provideRender telemetry false', () => {
     TestBed.configureTestingModule({
@@ -103,5 +108,20 @@ describe('development generative UI mount evidence', () => {
     const fx = fixture(spec());
     fx.detectChanges();
     expect(mounted).not.toHaveBeenCalled();
+    expect(touched).not.toHaveBeenCalled();
+  });
+  it('reports a session when the element is constructed, even when nothing mounts', () => {
+    const fx = fixture(spec({ type: 'Unknown' }));
+    fx.detectChanges();
+    expect(touched).toHaveBeenCalledTimes(1);
+    expect(mounted).not.toHaveBeenCalled();
+    fx.detectChanges();
+    expect(touched).toHaveBeenCalledTimes(1);
+    expect(mounted).not.toHaveBeenCalled();
+  });
+  it('does not report a session when the collection policy is disabled', () => {
+    const fx = fixture(spec(), false);
+    fx.detectChanges();
+    expect(touched).not.toHaveBeenCalled();
   });
 });

libs/render/src/lib/render-element.component.ts

@@ -162,6 +162,8 @@ export class RenderElementComponent implements OnInit {
   private destroyed = false;
 
   constructor() {
+    // One session observation per boot; guards and dedupe live inside touch().
+    this.development.touch();
     this.destroyRef.onDestroy(() => this.development.dispose());
     afterEveryRender(() => {
       // Evidence is the mounted outlet itself: an element that is hidden,

libs/telemetry/README.md

@@ -42,12 +42,14 @@ retains its own inert install and explicit helper behavior.
 
 ## Automatic development runtime collection
 
-LangGraph and AG-UI adapters and the supported JSON renderer use this package's
-lazy development collector when they are actually used. Angular's `isDevMode()`
-must be true and browser APIs must be available before identity/storage/network
-work. Production builds, SSR, imports, unused runtime construction, and automated
-browsers reporting `navigator.webdriver` are inert.
-A development build served on a remote hostname is still development software.
+LangGraph and AG-UI adapters and the supported JSON renderer use this package's lazy
+development collector when they are constructed and used. Angular's `isDevMode()` must
+be true and browser APIs must be available before identity/storage/network work.
+Production builds, SSR, imports, and automated browsers reporting `navigator.webdriver`
+are inert. Creating an agent (or a render element) in a development-mode browser reports
+one session start per integration per session; milestones are reported only when the
+runtime is actually used. A development build served on a remote hostname is still
+development software.
 
 Events contain random event IDs, a browser-origin UUID, an inactivity session UUID,
 package/version, integration, timestamps, closed progress milestones, and an optional

libs/telemetry/scripts/verify-angular-install-bridge.mjs

@@ -253,6 +253,7 @@ async function exerciseBundle(
     TransformStream,
     DOMException,
     queueMicrotask,
+    structuredClone,
     crypto: globalThis.crypto,
     console: {
       info: () => undefined,

libs/telemetry/src/browser/development/runtime.ts

@@ -76,7 +76,7 @@ function browserAllowed(): boolean {
     typeof fetch === 'function'
   );
 }
-/** Inert until a supported integration is actually used; never initialize this at module import. */
+/** Inert until an integration calls touch() or reports a milestone; never initialize this at module import. */
 export function createDevelopmentRuntime(
   options: DevelopmentRuntimeOptions
 ): DevelopmentRuntime {