feat(agent): add telemetry to TypeScript agent SDK

[sarinali]

Summary

Adds PostHog telemetry to the @trycua/agent TypeScript package for parity with the Python SDK. This enables tracking of SDK usage, agent client lifecycle, and request metrics.

Events Added

Event	Trigger	Key Properties
module_init	Package import	module: "agent", version, node_version
agent_client_initialized	new AgentClient()	session_id, connection_type, has_api_key
agent_request_start	responses.create() called	session_id, request_id, model, has_computer_kwargs, has_agent_kwargs
agent_request_end	Successful response	duration_ms, status, num_messages, prompt_tokens, completion_tokens, total_tokens, response_cost
agent_request_error	Request failure	error_type, error_message (truncated)

Error Classification

Errors are automatically classified into types:

• timeout - Request timeout/abort
• http_error - HTTP status errors
• parse_error - JSON parsing errors
• network - Network/connection errors
• peer_error - WebRTC peer errors
• unknown - Other errors

Files Changed

• libs/typescript/agent/src/index.ts - Added module_init event on import
• libs/typescript/agent/src/client.ts - Added telemetry to AgentClient class

Parity with Python SDK

Python Event	TypeScript Equivalent
module_init	module_init ✅
agent_session_start	agent_client_initialized ✅
agent_run_start	agent_request_start ✅
agent_run_end	agent_request_end ✅
agent_usage	Included in agent_request_end ✅

Test plan

• Build passes (pnpm build)
• Telemetry events emit correctly (tested with mock endpoint)
• Verify events appear in PostHog EU

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features

  • Added comprehensive telemetry and session tracking for agent operations.
  • Improved error classification and tracking for better diagnostics.

• API Changes

  • Introduced new responses member for unified request handling.
  • Expanded type definitions exports for enhanced TypeScript support.

[vercel]

@sarinali is attempting to deploy a commit to the Cua Team on Vercel.

A member of the Team first needs to authorize it.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
docs	Ready	Preview, Comment	Jan 19, 2026 7:17am

[r33drichards]

nice spot to inject this! I'll have to re use this for sending data to our otel stack too and can add dashes and alerting there as well

[coderabbitai]

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

📥 Commits

Reviewing files that changed from the base of the PR and between 20abd9b and 80a6d18.

📒 Files selected for processing (2)

• libs/typescript/agent/src/client.ts
• libs/typescript/agent/src/index.ts

 __________________________________________________________
< Keep your friends close, but your code reviewers closer. >
 ----------------------------------------------------------
  \
   \   (\__/)
       (•ㅅ•)
       / 　 づ

_{✏️ Tip: You can disable in-progress messages and the fortune message in your review settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}