agent-usage-tracker 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (113) hide show
  1. agent_usage_tracker/__init__.py +8 -0
  2. agent_usage_tracker/backup.py +225 -0
  3. agent_usage_tracker/cli.py +479 -0
  4. agent_usage_tracker/collectors/__init__.py +115 -0
  5. agent_usage_tracker/collectors/_util.py +310 -0
  6. agent_usage_tracker/collectors/activity_common.py +294 -0
  7. agent_usage_tracker/collectors/activitywatch.py +394 -0
  8. agent_usage_tracker/collectors/claude_code.py +484 -0
  9. agent_usage_tracker/collectors/claude_code_activity.py +317 -0
  10. agent_usage_tracker/collectors/codex.py +612 -0
  11. agent_usage_tracker/collectors/commits.py +154 -0
  12. agent_usage_tracker/collectors/cursor.py +193 -0
  13. agent_usage_tracker/collectors/cursor_api.py +247 -0
  14. agent_usage_tracker/collectors/cursor_cli.py +592 -0
  15. agent_usage_tracker/collectors/cursor_sdk.py +95 -0
  16. agent_usage_tracker/collectors/generic_sdk.py +100 -0
  17. agent_usage_tracker/collectors/pi.py +397 -0
  18. agent_usage_tracker/collectors/session_digest.py +379 -0
  19. agent_usage_tracker/collectors/t3.py +490 -0
  20. agent_usage_tracker/config.py +392 -0
  21. agent_usage_tracker/coverage.py +615 -0
  22. agent_usage_tracker/coverage_catalog.json +588 -0
  23. agent_usage_tracker/cursor_run.py +62 -0
  24. agent_usage_tracker/diagnostics.py +74 -0
  25. agent_usage_tracker/episode_store.py +78 -0
  26. agent_usage_tracker/event.py +132 -0
  27. agent_usage_tracker/git_day_cache.py +128 -0
  28. agent_usage_tracker/git_days.py +499 -0
  29. agent_usage_tracker/git_safe.py +58 -0
  30. agent_usage_tracker/harness_inventory.py +208 -0
  31. agent_usage_tracker/history_steers.py +88 -0
  32. agent_usage_tracker/improve/__init__.py +1 -0
  33. agent_usage_tracker/improve/case_view.py +112 -0
  34. agent_usage_tracker/improve/cli.py +138 -0
  35. agent_usage_tracker/improve/desktop.py +347 -0
  36. agent_usage_tracker/improve/evidence.py +322 -0
  37. agent_usage_tracker/improve/judge.py +671 -0
  38. agent_usage_tracker/improve/proposals.py +72 -0
  39. agent_usage_tracker/improve/rubric.py +360 -0
  40. agent_usage_tracker/improve/rubrics/avoidable_recovery.md +20 -0
  41. agent_usage_tracker/improve/rubrics/code_quality.md +22 -0
  42. agent_usage_tracker/improve/rubrics/completion_supported.md +20 -0
  43. agent_usage_tracker/improve/rubrics/redundant_tests.md +21 -0
  44. agent_usage_tracker/improve/rubrics/verbosity.md +21 -0
  45. agent_usage_tracker/improve/runtime.py +117 -0
  46. agent_usage_tracker/improve/schedule.py +291 -0
  47. agent_usage_tracker/improve/search_check.py +563 -0
  48. agent_usage_tracker/improve/store.py +244 -0
  49. agent_usage_tracker/improve/studies.py +285 -0
  50. agent_usage_tracker/improve/study_cli.py +46 -0
  51. agent_usage_tracker/improve/study_decision.py +121 -0
  52. agent_usage_tracker/improve/study_followup.py +174 -0
  53. agent_usage_tracker/improve/t3.py +269 -0
  54. agent_usage_tracker/improve/trial.py +318 -0
  55. agent_usage_tracker/improve/validation.py +148 -0
  56. agent_usage_tracker/inspector.py +350 -0
  57. agent_usage_tracker/label/__init__.py +22 -0
  58. agent_usage_tracker/label/backends.py +742 -0
  59. agent_usage_tracker/label/bakeoff.py +661 -0
  60. agent_usage_tracker/label/baseline.py +173 -0
  61. agent_usage_tracker/label/clef.py +258 -0
  62. agent_usage_tracker/label/context.py +382 -0
  63. agent_usage_tracker/label/core.py +355 -0
  64. agent_usage_tracker/label/covered_run.py +92 -0
  65. agent_usage_tracker/label/evalset.py +154 -0
  66. agent_usage_tracker/label/gold.py +209 -0
  67. agent_usage_tracker/label/local.py +326 -0
  68. agent_usage_tracker/label/local_parallel.py +232 -0
  69. agent_usage_tracker/label/merge.py +57 -0
  70. agent_usage_tracker/label/outcome_coverage.py +57 -0
  71. agent_usage_tracker/label/replay.py +194 -0
  72. agent_usage_tracker/label/run.py +339 -0
  73. agent_usage_tracker/label/tasks.py +579 -0
  74. agent_usage_tracker/label/teach.py +145 -0
  75. agent_usage_tracker/local_page.py +128 -0
  76. agent_usage_tracker/manual_time.py +69 -0
  77. agent_usage_tracker/net.py +23 -0
  78. agent_usage_tracker/observation_cli.py +65 -0
  79. agent_usage_tracker/observation_report.py +116 -0
  80. agent_usage_tracker/observation_server.py +110 -0
  81. agent_usage_tracker/observations.py +365 -0
  82. agent_usage_tracker/outcome_git.py +383 -0
  83. agent_usage_tracker/outcomes.py +464 -0
  84. agent_usage_tracker/pricing.py +248 -0
  85. agent_usage_tracker/push.py +530 -0
  86. agent_usage_tracker/redact.py +45 -0
  87. agent_usage_tracker/repo_keys.py +165 -0
  88. agent_usage_tracker/review.py +252 -0
  89. agent_usage_tracker/scan.py +472 -0
  90. agent_usage_tracker/scheduled.py +164 -0
  91. agent_usage_tracker/sdk.py +79 -0
  92. agent_usage_tracker/sink.py +82 -0
  93. agent_usage_tracker/sink_stack/README.md +71 -0
  94. agent_usage_tracker/sink_stack/apply.sh +63 -0
  95. agent_usage_tracker/sink_stack/compose.yaml +94 -0
  96. agent_usage_tracker/sink_stack/env.example +20 -0
  97. agent_usage_tracker/sink_stack/grafana/dashboards/agents-effort.json +634 -0
  98. agent_usage_tracker/sink_stack/grafana/dashboards/agents-usage.json +1279 -0
  99. agent_usage_tracker/sink_stack/grafana/provisioning/dashboards/aut.yaml +9 -0
  100. agent_usage_tracker/sink_stack/grafana/provisioning/datasources/agents.yaml +16 -0
  101. agent_usage_tracker/sink_stack/sql/01_schema.sql +1186 -0
  102. agent_usage_tracker/sink_stack/sql/02_price.sql +60 -0
  103. agent_usage_tracker/sink_stack/sql/03_effort.sql +1180 -0
  104. agent_usage_tracker/sink_stack/sql/04_grants.sql +149 -0
  105. agent_usage_tracker/sink_stack/sql/refresh.sql +66 -0
  106. agent_usage_tracker/sources.py +180 -0
  107. agent_usage_tracker/state.py +191 -0
  108. agent_usage_tracker/telemetry.py +165 -0
  109. agent_usage_tracker-0.1.0.dist-info/METADATA +366 -0
  110. agent_usage_tracker-0.1.0.dist-info/RECORD +113 -0
  111. agent_usage_tracker-0.1.0.dist-info/WHEEL +4 -0
  112. agent_usage_tracker-0.1.0.dist-info/entry_points.txt +3 -0
  113. agent_usage_tracker-0.1.0.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,588 @@
1
+ {
2
+ "version": 1,
3
+ "scope": "Documented integration routes, not installed or qualified parser coverage.",
4
+ "harnesses": [
5
+ {
6
+ "id": "super-engineering",
7
+ "name": "super.engineering",
8
+ "research_date": "2026-11-14",
9
+ "engine": "Includes Claude Code, Codex, Cursor, OpenCode, Pi, Grok and other providers; surfaces/capabilities vary.",
10
+ "evidence_route": "Terminal is native CLI. Chat UI uses provider adapters; Claude noninteractive Chat UI follows a CLI path. Exact other Chat UI SDK/ACP/app-server wires remain unverified.",
11
+ "route_status": "documented",
12
+ "primary_urls": [
13
+ "https://super.engineering/docs/providers-and-models/",
14
+ "https://super.engineering/docs/remote-workspaces/",
15
+ "https://super.engineering/docs/settings-privacy-local-data",
16
+ "https://super.engineering/docs/session-history-and-restore"
17
+ ],
18
+ "runtime_verified": false,
19
+ "parser_coverage": "not_qualified_by_catalog"
20
+ },
21
+ {
22
+ "id": "zeron",
23
+ "name": "Zeron",
24
+ "research_date": "2026-11-14",
25
+ "engine": "Claude Code, Codex, Cursor, OpenCode, Pi and ACP-native providers including Devin, Grok, Hermes and Antigravity.",
26
+ "evidence_route": "Claude stream-json subprocess; Codex app-server JSON-RPC stdio; Cursor pinned SDK shim; OpenCode HTTP/SSE; Pi JSONL RPC; ACP only ACP-native drivers.",
27
+ "route_status": "documented",
28
+ "primary_urls": [
29
+ "https://raw.githubusercontent.com/zeronsh/zeron/main/crates/harness/src/lib.rs",
30
+ "https://raw.githubusercontent.com/zeronsh/zeron/main/crates/harness/src/claude/mod.rs",
31
+ "https://raw.githubusercontent.com/zeronsh/zeron/main/crates/harness/src/codex/mod.rs",
32
+ "https://github.com/zeronsh/zeron",
33
+ "https://raw.githubusercontent.com/zeronsh/zeron/main/ARCHITECTURE.md"
34
+ ],
35
+ "runtime_verified": false,
36
+ "parser_coverage": "not_qualified_by_catalog"
37
+ },
38
+ {
39
+ "id": "paseo",
40
+ "name": "Paseo",
41
+ "research_date": "2026-11-14",
42
+ "engine": "Native adapters for Claude Code, Codex, OpenCode, Pi and others, plus a version-pinned ACP catalog.",
43
+ "evidence_route": "Claude Agent SDK uses installed claude CLI; Codex uses codex app-server; generic ACP providers use stdio initialize/capability negotiation.",
44
+ "route_status": "documented",
45
+ "primary_urls": [
46
+ "https://paseo.sh/docs/providers",
47
+ "https://paseo.sh/docs/supported-providers",
48
+ "https://paseo.sh/docs/claude-code",
49
+ "https://paseo.sh/docs/codex",
50
+ "https://paseo.sh/docs/custom-providers",
51
+ "https://github.com/getpaseo/paseo",
52
+ "https://paseo.sh/docs/configuration",
53
+ "https://paseo.sh/docs/sdk/events",
54
+ "https://paseo.sh/docs/sdk/reference",
55
+ "https://paseo.sh/docs/plugins/hooks"
56
+ ],
57
+ "runtime_verified": false,
58
+ "parser_coverage": "not_qualified_by_catalog"
59
+ },
60
+ {
61
+ "id": "diri",
62
+ "name": "Diri",
63
+ "research_date": "2026-11-14",
64
+ "engine": "Existing Claude Code, Codex, Cursor, Gemini, OpenCode and other agent CLIs; generic agents retain terminal surfaces.",
65
+ "evidence_route": "PTY/holder-based native CLI launches. Claude manifest declares hooks authority and minted --session-id; Codex manifest declares screen authority plus notify/MCP injection.",
66
+ "route_status": "documented",
67
+ "primary_urls": [
68
+ "https://github.com/cristicretu/diri",
69
+ "https://raw.githubusercontent.com/cristicretu/diri/main/diri/crates/diri-engine/manifests/claude-code.json",
70
+ "https://raw.githubusercontent.com/cristicretu/diri/main/diri/crates/diri-engine/manifests/codex.json",
71
+ "https://raw.githubusercontent.com/cristicretu/diri/main/docs/AGENT-MANIFESTS.md",
72
+ "https://raw.githubusercontent.com/cristicretu/diri/main/AGENTS.md",
73
+ "https://raw.githubusercontent.com/cristicretu/diri/main/PRIVACY.md"
74
+ ],
75
+ "runtime_verified": false,
76
+ "parser_coverage": "not_qualified_by_catalog"
77
+ },
78
+ {
79
+ "id": "t3-code",
80
+ "name": "T3 Code",
81
+ "aliases": [
82
+ "T3 Code Beta",
83
+ "T3CodeBeta"
84
+ ],
85
+ "research_date": "2026-11-14",
86
+ "engine": "Claude Code, Codex, Cursor, OpenCode, Pi, Muse and ACP Registry/flavored providers.",
87
+ "evidence_route": "Claude Agent SDK; Codex App Server; native adapters for other non-ACP protocols, including Pi RPC; shared ACP Registry/flavored adapters for ACP providers.",
88
+ "route_status": "documented",
89
+ "primary_urls": [
90
+ "https://raw.githubusercontent.com/pingdotgg/t3code/main/docs/internals/adding-a-provider.md",
91
+ "https://github.com/pingdotgg/t3code/blob/main/docs/user/faq.md",
92
+ "https://raw.githubusercontent.com/pingdotgg/t3code/main/docs/internals/providers.md",
93
+ "https://raw.githubusercontent.com/pingdotgg/t3code/main/docs/user/background-service.md",
94
+ "https://raw.githubusercontent.com/pingdotgg/t3code/main/docs/user/providers-claude.md",
95
+ "https://raw.githubusercontent.com/pingdotgg/t3code/main/docs/user/providers-codex.md",
96
+ "https://raw.githubusercontent.com/pingdotgg/t3code/main/docs/internals/overview.md"
97
+ ],
98
+ "runtime_verified": false,
99
+ "parser_coverage": "not_qualified_by_catalog",
100
+ "detect": {
101
+ "paths": [
102
+ "~/.t3/userdata"
103
+ ]
104
+ },
105
+ "read_by": [
106
+ "t3"
107
+ ]
108
+ },
109
+ {
110
+ "id": "emdash",
111
+ "name": "Emdash",
112
+ "research_date": "2026-11-14",
113
+ "engine": "Installed coding-agent CLIs, including Claude Code, Codex, OpenCode and Amp; provider registry defines prompt, hooks, ACP and other capabilities.",
114
+ "evidence_route": "Two paths: legacy/TUI through PTY and TUI-agent runtimes; structured chat through ACP provider plugins and a Host ACP runtime. Explicit hooks/plugins drive TUI status.",
115
+ "route_status": "documented",
116
+ "primary_urls": [
117
+ "https://github.com/generalaction/emdash",
118
+ "https://emdash.sh/docs",
119
+ "https://emdash.sh/docs/providers",
120
+ "https://github.com/generalaction/emdash/blob/main/AGENTS.md",
121
+ "https://github.com/generalaction/emdash/blob/main/CONTEXT.md",
122
+ "https://github.com/generalaction/emdash/blob/main/agents/integrations/providers.md",
123
+ "https://ademark.dev/"
124
+ ],
125
+ "runtime_verified": false,
126
+ "parser_coverage": "not_qualified_by_catalog"
127
+ },
128
+ {
129
+ "id": "monocode",
130
+ "name": "MonoCode",
131
+ "research_date": "2026-11-14",
132
+ "engine": "Locally installed/authenticated agent providers including Claude Code, Codex, Cursor, OpenCode, Pi and others. CLI discovery happens at startup.",
133
+ "evidence_route": "Desktop sessions plus an experimental remote host service. /operator enables a local app CLI in an active agent turn; sessions.list and sessions.start expose app-session references.",
134
+ "route_status": "documented",
135
+ "primary_urls": [
136
+ "https://github.com/hardbeat920/monocode",
137
+ "https://usemono.dev",
138
+ "https://github.com/hardbeat920/monocode/blob/main/docs/providers.md",
139
+ "https://github.com/hardbeat920/monocode/blob/main/docs/agent-access.md",
140
+ "https://github.com/hardbeat920/monocode/blob/main/docs/remote-access.md",
141
+ "https://ademark.dev/"
142
+ ],
143
+ "runtime_verified": false,
144
+ "parser_coverage": "not_qualified_by_catalog"
145
+ },
146
+ {
147
+ "id": "synara",
148
+ "name": "Synara",
149
+ "research_date": "2026-11-14",
150
+ "engine": "Provider-native runtimes include Codex CLI/app-server, Claude Code, Cursor, OpenCode, Pi and others. Provider owns models, account, tools, permissions and limits.",
151
+ "evidence_route": "Durable projects/threads around provider sessions; internal thread-scoped Agent Gateway plus a separate user-paired External MCP stdio bridge to a loopback endpoint.",
152
+ "route_status": "documented",
153
+ "primary_urls": [
154
+ "https://github.com/Emanuele-web04/synara",
155
+ "https://www.trysynara.com",
156
+ "https://www.trysynara.com/docs",
157
+ "https://github.com/Emanuele-web04/synara/blob/main/docs/external-mcp.md",
158
+ "https://github.com/Emanuele-web04/synara/blob/main/docs/remote-connections-v2.md",
159
+ "https://ademark.dev/"
160
+ ],
161
+ "runtime_verified": false,
162
+ "parser_coverage": "not_qualified_by_catalog"
163
+ },
164
+ {
165
+ "id": "bb",
166
+ "name": "bb",
167
+ "research_date": "2026-11-14",
168
+ "engine": "Provider processes on host daemons; configured providers include Claude Code, Codex, Pi and ACP agents. Custom ACP provider commands run on the thread's host.",
169
+ "evidence_route": "Central SQLite source of truth; HTTP and WebSocket server contract; separate host-daemon RPC/events contract; first-class CLI and SDK methods.",
170
+ "route_status": "documented",
171
+ "primary_urls": [
172
+ "https://github.com/get-bb/bb",
173
+ "https://getbb.app",
174
+ "https://github.com/get-bb/bb/blob/main/docs/system-overview.md",
175
+ "https://github.com/get-bb/bb/blob/main/docs/configuration.md",
176
+ "https://ademark.dev/"
177
+ ],
178
+ "runtime_verified": false,
179
+ "parser_coverage": "not_qualified_by_catalog"
180
+ },
181
+ {
182
+ "id": "orca",
183
+ "name": "Orca",
184
+ "research_date": "2026-11-14",
185
+ "engine": "CLI-agent host for Claude Code, Codex, OpenCode, Pi and other installed agent CLIs. The any-CLI statement describes execution compatibility, not telemetry completeness.",
186
+ "evidence_route": "Worktree/terminal coordination plus an Orca CLI for a running editor, JSON status, SSH execution, notifications and orchestration. Usage tracking is provider-specific.",
187
+ "route_status": "documented",
188
+ "primary_urls": [
189
+ "https://github.com/stablyai/orca",
190
+ "https://www.onorca.dev",
191
+ "https://www.onorca.dev/docs/cli/overview",
192
+ "https://www.onorca.dev/docs/ssh",
193
+ "https://www.onorca.dev/docs/agents/usage-tracking",
194
+ "https://ademark.dev/"
195
+ ],
196
+ "runtime_verified": false,
197
+ "parser_coverage": "not_qualified_by_catalog"
198
+ },
199
+ {
200
+ "id": "traycer",
201
+ "name": "Traycer",
202
+ "research_date": "2026-11-14",
203
+ "engine": "Managed Claude Code/Codex/OpenCode CLIs and additional provider-specific integrations; Cursor chat uses an API key and needs no CLI; Traycer Inference is separate.",
204
+ "evidence_route": "traycer agent list --json; traycer agent transcript --agent-id; traycer agent inbox --after; traycer monitor CLI --json produces NDJSON progress/result envelopes; host status/log/doctor and data status discover the effective data folder. Default ~/.traycer/cli/config.json, ~/.traycer/host/, ~/.traycer/host/host.log, ~/.traycer/worktrees/; data folder may be relocated.",
205
+ "route_status": "documented",
206
+ "primary_urls": [
207
+ "https://docs.traycer.ai/agents-and-models/coding-agents.md",
208
+ "https://docs.traycer.ai/settings/providers.md",
209
+ "https://docs.traycer.ai/cli/commands.md",
210
+ "https://docs.traycer.ai/concepts/terminal-agents-vs-terminals.md"
211
+ ],
212
+ "runtime_verified": false,
213
+ "parser_coverage": "not_qualified_by_catalog"
214
+ },
215
+ {
216
+ "id": "claude-desktop",
217
+ "name": "Claude desktop",
218
+ "aliases": [
219
+ "Claude"
220
+ ],
221
+ "research_date": "2026-11-14",
222
+ "engine": "One app has distinct Chat, Cowork and Code surfaces. The Code tab uses the Claude Code engine, while Chat export and Cowork policy/telemetry are distinct.",
223
+ "evidence_route": "Code-tab OTEL service.name=claude-code-desktop; terminal service.name=claude-code; session.id and prompt.id correlation. Code settings, hooks and skills share documented Claude configuration; CLAUDE_CONFIG_DIR may relocate it. Account Chat history export from Settings > Privacy on web/Desktop, delivered by email. CLI JSONL default ~/.claude/projects/<project>/<session-id>.jsonl is documented for CLI; schema is internal and may change.",
224
+ "route_status": "documented",
225
+ "primary_urls": [
226
+ "https://code.claude.com/docs/en/desktop",
227
+ "https://code.claude.com/docs/en/monitoring-usage",
228
+ "https://support.claude.com/en/articles/9450526-how-can-i-export-my-claude-data",
229
+ "https://code.claude.com/docs/en/sessions"
230
+ ],
231
+ "runtime_verified": false,
232
+ "parser_coverage": "not_qualified_by_catalog",
233
+ "detect": {
234
+ "paths": [
235
+ "~/Library/Application Support/Claude/claude-code-sessions",
236
+ "~/Library/Application Support/Claude/local-agent-mode-sessions"
237
+ ]
238
+ }
239
+ },
240
+ {
241
+ "id": "capy",
242
+ "name": "Capy",
243
+ "research_date": "2026-11-14",
244
+ "engine": "Capy's own agent plus a separate Claude Code mode on the Claude Agent SDK; Captain and subagents coordinate work. Public control/evidence API uses REST and SSE.",
245
+ "evidence_route": "GET /api/v1/threads and /threads/{threadId}/messages; subagent message endpoints; paged after/before cursors. Thread/subagent SSE replays after Last-Event-ID; transcript event cursors never expire and pagination is stable across compaction. GET /api/v1/usage returns token totals plus member/model breakdowns; capy dock --verbose prints dock logs.",
246
+ "route_status": "documented",
247
+ "primary_urls": [
248
+ "https://docs.capy.ai/models-and-pricing.md",
249
+ "https://docs.capy.ai/desktop.md",
250
+ "https://docs.capy.ai/admin/security.md",
251
+ "https://docs.capy.ai/api-reference/streaming.md",
252
+ "https://docs.capy.ai/api-reference/messages/list-thread-messages.md",
253
+ "https://docs.capy.ai/api-reference/authentication.md",
254
+ "https://docs.capy.ai/api-reference/usage/get-usage-report.md"
255
+ ],
256
+ "runtime_verified": false,
257
+ "parser_coverage": "not_qualified_by_catalog"
258
+ },
259
+ {
260
+ "id": "cloudroom",
261
+ "name": "Cloudroom",
262
+ "research_date": "2026-11-14",
263
+ "engine": "Native harness processes: Codex app-server over stdio; Claude Code stream JSON without SDK bridge; Pi RPC; OpenCode ACP. Other adapters have their own native boundaries.",
264
+ "evidence_route": "GET /v1/sessions, per-session requests, events?after=N, and SSE stream with Last-Event-ID. CLOUDROOM_STATE_DIR local journal; setup example /var/lib/cloudroom/history. Self-host CLOUDROOM_LOCAL_HISTORY=1; managed history also goes to API-backed gzip object storage. CLOUDROOM_CODEX_HOME and account homes are explicit; native history remains adapter-owned. Private diagnostics.jsonl under state directory is bounded operational telemetry, distinct from full conversation history.",
265
+ "route_status": "documented",
266
+ "primary_urls": [
267
+ "https://raw.githubusercontent.com/davidondrej/cloudroom/main/core/docs/harnesses.md",
268
+ "https://raw.githubusercontent.com/davidondrej/cloudroom/main/core/src/runtime/codex.rs",
269
+ "https://raw.githubusercontent.com/davidondrej/cloudroom/main/core/docs/api.md",
270
+ "https://raw.githubusercontent.com/davidondrej/cloudroom/main/core/docs/setup.md",
271
+ "https://raw.githubusercontent.com/davidondrej/cloudroom/main/core/docs/observability.md"
272
+ ],
273
+ "runtime_verified": false,
274
+ "parser_coverage": "not_qualified_by_catalog"
275
+ },
276
+ {
277
+ "id": "superset",
278
+ "name": "Superset",
279
+ "aliases": [
280
+ "Paradev"
281
+ ],
282
+ "research_date": "2026-11-14",
283
+ "engine": "Terminal CLI agent orchestration; the app does not proxy model calls. Chat uses the installed CLI over ACP and can resume the same session in terminal.",
284
+ "evidence_route": "superset agents read returns saved Claude Code/Codex transcripts; other agent transcript reads fail rather than silently fall back to terminal output. Lifecycle hooks/command wrappers under ~/.paradev/bin and superset-hooks are active only inside marked Paradev terminals. SUPERSET_HOME_DIR (default ~/.paradev) relocates config.json and the host tree; documented host state includes manifest.json and host.db. Usage reads local native session logs and official account usage endpoints; it does not aggregate remote hosts. Profiles use CLAUDE_CONFIG_DIR/CODEX_HOME.",
285
+ "route_status": "documented",
286
+ "primary_urls": [
287
+ "https://github.com/paradevai/paradev",
288
+ "https://docs.paradev.com/llms.mdx/chat",
289
+ "https://docs.paradev.com/llms.mdx/agent-status",
290
+ "https://docs.paradev.com/llms.mdx/agent-sessions",
291
+ "https://docs.paradev.com/llms.mdx/cli/host-server",
292
+ "https://docs.paradev.com/llms.mdx/usage"
293
+ ],
294
+ "runtime_verified": false,
295
+ "parser_coverage": "not_qualified_by_catalog"
296
+ },
297
+ {
298
+ "id": "codex-app",
299
+ "name": "Codex app",
300
+ "aliases": [
301
+ "Codex"
302
+ ],
303
+ "research_date": "2026-11-14",
304
+ "engine": "Codex app-server structured thread, turn and item API; native CODEX_HOME state.",
305
+ "evidence_route": "app_server SQLite state can use sqlite_home/CODEX_SQLITE_HOME separately from CODEX_HOME.",
306
+ "route_status": "documented",
307
+ "primary_urls": [
308
+ "https://developers.openai.com/codex/app-server"
309
+ ],
310
+ "runtime_verified": false,
311
+ "parser_coverage": "not_qualified_by_catalog",
312
+ "detect": {
313
+ "paths": [
314
+ "~/Library/Application Support/Codex"
315
+ ]
316
+ },
317
+ "read_by": [
318
+ "codex"
319
+ ]
320
+ },
321
+ {
322
+ "id": "conductor",
323
+ "name": "Conductor",
324
+ "research_date": "2026-11-14",
325
+ "engine": "Managed Claude Code, Codex and OpenCode executables; Cursor API is a separate route.",
326
+ "evidence_route": "Managed executables and Cursor API.",
327
+ "route_status": "documented",
328
+ "primary_urls": [
329
+ "https://www.conductor.build/docs/reference/harnesses"
330
+ ],
331
+ "runtime_verified": false,
332
+ "parser_coverage": "not_qualified_by_catalog"
333
+ },
334
+ {
335
+ "id": "opencode",
336
+ "name": "OpenCode",
337
+ "research_date": "2026-11-14",
338
+ "engine": "OpenCode server owns configured provider/model execution; TUI and desktop are clients. SDK is a typed HTTP/OpenAPI client, not a separate model engine.",
339
+ "evidence_route": "Server HTTP/OpenAPI API, SDK session list/status/children methods, and event.subscribe SSE. Native SQLite metadata is another versioned evidence surface.",
340
+ "route_status": "documented",
341
+ "primary_urls": [
342
+ "https://opencode.ai/docs/sdk/",
343
+ "https://opencode.ai/docs/server/",
344
+ "https://opencode.ai/docs/cli/",
345
+ "https://opencode.ai/docs/troubleshooting/"
346
+ ],
347
+ "runtime_verified": false,
348
+ "parser_coverage": "not_qualified_by_catalog",
349
+ "detect": {
350
+ "commands": [
351
+ "opencode"
352
+ ]
353
+ }
354
+ },
355
+ {
356
+ "id": "gemini-cli",
357
+ "name": "Gemini CLI",
358
+ "research_date": "2026-11-14",
359
+ "engine": "Native CLI with configured model/auth and tool runtime; documented telemetry describes Gemini API activity and execution events.",
360
+ "evidence_route": "Opt-in OpenTelemetry logs/metrics/traces, local OTLP target or telemetry outfile; separate ACP mode provides structured client interactions.",
361
+ "route_status": "documented",
362
+ "primary_urls": [
363
+ "https://geminicli.com/docs/cli/telemetry",
364
+ "https://geminicli.com/docs/cli/acp-mode",
365
+ "https://github.com/google-gemini/gemini-cli"
366
+ ],
367
+ "runtime_verified": false,
368
+ "parser_coverage": "not_qualified_by_catalog",
369
+ "detect": {
370
+ "commands": [
371
+ "gemini"
372
+ ]
373
+ }
374
+ },
375
+ {
376
+ "id": "pi",
377
+ "name": "Pi",
378
+ "research_date": "2026-11-14",
379
+ "engine": "Pi is a configurable agent harness/model runtime, available as CLI or an in-process Node/Bun SDK. Provider/model selection belongs to that runtime.",
380
+ "evidence_route": "File-backed JSONL session tree; SDK session.subscribe; JSON event stream; language-independent RPC subprocess over JSONL stdin/stdout.",
381
+ "route_status": "documented",
382
+ "primary_urls": [
383
+ "https://github.com/badlogic/pi-mono",
384
+ "https://github.com/earendil-works/pi/blob/main/packages/coding-agent/README.md",
385
+ "https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/sdk.md",
386
+ "https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/rpc.md",
387
+ "https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/session-format.md"
388
+ ],
389
+ "runtime_verified": false,
390
+ "parser_coverage": "not_qualified_by_catalog",
391
+ "detect": {
392
+ "paths": [
393
+ "~/.pi/agent/sessions"
394
+ ],
395
+ "commands": [
396
+ "pi"
397
+ ]
398
+ },
399
+ "read_by": [
400
+ "pi"
401
+ ]
402
+ },
403
+ {
404
+ "id": "cline",
405
+ "name": "Cline",
406
+ "research_date": "2026-11-14",
407
+ "engine": "@cline/core supplies Node sessions/storage/hub/automation/telemetry over @cline/agents and @cline/llms. The browser-compatible agent loop is a lower layer.",
408
+ "evidence_route": "SDK subscribe/event interfaces and optional OTLP logs/metrics. Event reference includes task lifecycle, model/provider, token, tool and hook events.",
409
+ "route_status": "documented",
410
+ "primary_urls": [
411
+ "https://docs.cline.bot/sdk/overview",
412
+ "https://docs.cline.bot/sdk/architecture/overview",
413
+ "https://docs.cline.bot/enterprise-solutions/monitoring/telemetry",
414
+ "https://docs.cline.bot/enterprise-solutions/monitoring/opentelemetry",
415
+ "https://docs.cline.bot/enterprise-solutions/monitoring/opentelemetry-events",
416
+ "https://github.com/cline/cline"
417
+ ],
418
+ "runtime_verified": false,
419
+ "parser_coverage": "not_qualified_by_catalog"
420
+ },
421
+ {
422
+ "id": "rex",
423
+ "name": "Rex",
424
+ "aliases": [
425
+ "Rex Beta",
426
+ "RexBeta"
427
+ ],
428
+ "research_date": "2026-11-14",
429
+ "engine": "External Claude Code, Codex, Pi/OpenCode and other terminal programs",
430
+ "evidence_route": "Native engine records plus explicit REX_SESSION/REX_BLOCK context and OSC7501 status; status is not a transcript",
431
+ "route_status": "documented",
432
+ "primary_urls": [
433
+ "https://www.superlogical.com/rex/docs/automate/agent-skill",
434
+ "https://www.superlogical.com/rex/docs/build/program-status"
435
+ ],
436
+ "runtime_verified": false,
437
+ "parser_coverage": "not_qualified_by_catalog",
438
+ "detect": {
439
+ "paths": [
440
+ "~/Library/Application Support/rex/servers"
441
+ ]
442
+ },
443
+ "wraps": [
444
+ "claude_code",
445
+ "codex"
446
+ ]
447
+ },
448
+ {
449
+ "id": "zed",
450
+ "name": "Zed",
451
+ "research_date": "2026-11-14",
452
+ "engine": "Zed Agent, external ACP agents and Terminal Threads are distinct modes.",
453
+ "evidence_route": "External agents use ACP and session history import; Terminal Threads run CLI agents. Built-in Zed Agent requires separate evidence mapping.",
454
+ "route_status": "documented",
455
+ "primary_urls": [
456
+ "https://zed.dev/docs/ai/external-agents",
457
+ "https://zed.dev/docs/ai/agents"
458
+ ],
459
+ "runtime_verified": false,
460
+ "parser_coverage": "not_qualified_by_catalog",
461
+ "detect": {
462
+ "paths": [
463
+ "~/Library/Application Support/Zed/threads"
464
+ ],
465
+ "commands": [
466
+ "zed"
467
+ ]
468
+ }
469
+ },
470
+ {
471
+ "id": "vs-code-copilot",
472
+ "name": "VS Code Copilot",
473
+ "research_date": "2026-11-14",
474
+ "engine": "VSCode/Copilot agent harnesses and agent-host sessions",
475
+ "evidence_route": "Native OTel and explicit Agent DebugLog OTLP JSON session export; session.id is window-scoped",
476
+ "route_status": "documented",
477
+ "primary_urls": [
478
+ "https://code.visualstudio.com/docs/agents/guides/monitoring-agents",
479
+ "https://code.visualstudio.com/docs/agents/agent-troubleshooting/chat-debug-view"
480
+ ],
481
+ "runtime_verified": false,
482
+ "parser_coverage": "not_qualified_by_catalog"
483
+ },
484
+ {
485
+ "id": "warp",
486
+ "name": "Warp",
487
+ "research_date": "2026-11-14",
488
+ "engine": "Warp local agents and managed cloud runs",
489
+ "evidence_route": "Documented local conversation history and cloud-run session UI. A stable external transcript export/API contract is unverified.",
490
+ "route_status": "documented_with_unverified_export",
491
+ "primary_urls": [
492
+ "https://docs.warp.dev/agents/local-agents/interacting-with-agents",
493
+ "https://docs.warp.dev/platform/managing-cloud-agents"
494
+ ],
495
+ "runtime_verified": false,
496
+ "parser_coverage": "not_qualified_by_catalog"
497
+ },
498
+ {
499
+ "id": "herdr",
500
+ "name": "Herdr",
501
+ "engine": "Agent pane manager that runs native agent CLIs such as Claude Code and Codex.",
502
+ "evidence_route": "Native engine records underneath; its own agent-detection status and server log are local metadata only.",
503
+ "research_date": "2026-11-20",
504
+ "route_status": "observed_locally",
505
+ "primary_urls": [],
506
+ "runtime_verified": false,
507
+ "parser_coverage": "not_qualified_by_catalog",
508
+ "detect": {
509
+ "paths": [
510
+ "~/.local/state/herdr",
511
+ "~/.config/herdr"
512
+ ],
513
+ "commands": [
514
+ "herdr"
515
+ ]
516
+ },
517
+ "wraps": [
518
+ "claude_code",
519
+ "codex"
520
+ ]
521
+ },
522
+ {
523
+ "id": "supacode",
524
+ "name": "Supacode",
525
+ "engine": "Worktree and terminal wrapper that runs native agent CLIs such as Claude Code and Codex.",
526
+ "evidence_route": "Native engine records underneath; local agents, repos and routes configuration. Its config is rewritten at launch, so recent activity there is weak evidence.",
527
+ "research_date": "2026-11-20",
528
+ "route_status": "observed_locally",
529
+ "primary_urls": [],
530
+ "runtime_verified": false,
531
+ "parser_coverage": "not_qualified_by_catalog",
532
+ "detect": {
533
+ "paths": [
534
+ "~/.config/supacode"
535
+ ],
536
+ "commands": [
537
+ "supacode"
538
+ ]
539
+ },
540
+ "wraps": [
541
+ "claude_code",
542
+ "codex"
543
+ ]
544
+ },
545
+ {
546
+ "id": "claude-squad",
547
+ "name": "claude-squad",
548
+ "engine": "tmux wrapper over native agent CLIs such as Claude Code.",
549
+ "evidence_route": "Native engine records underneath; no data directory was observed locally.",
550
+ "research_date": "2026-11-20",
551
+ "route_status": "observed_locally",
552
+ "primary_urls": [],
553
+ "runtime_verified": false,
554
+ "parser_coverage": "not_qualified_by_catalog",
555
+ "detect": {
556
+ "paths": [
557
+ "~/.claude-squad",
558
+ "~/.config/claude-squad"
559
+ ],
560
+ "commands": [
561
+ "claude-squad"
562
+ ]
563
+ },
564
+ "wraps": [
565
+ "claude_code"
566
+ ]
567
+ },
568
+ {
569
+ "id": "hermes",
570
+ "name": "Hermes agent",
571
+ "engine": "General agent with its own model calls and a messaging gateway.",
572
+ "evidence_route": "Own session store and state database in a format AUT does not read; gateway logs are not session activity.",
573
+ "research_date": "2026-11-20",
574
+ "route_status": "observed_locally",
575
+ "primary_urls": [],
576
+ "runtime_verified": false,
577
+ "parser_coverage": "not_qualified_by_catalog",
578
+ "detect": {
579
+ "paths": [
580
+ "~/.hermes/sessions"
581
+ ],
582
+ "commands": [
583
+ "hermes"
584
+ ]
585
+ }
586
+ }
587
+ ]
588
+ }
@@ -0,0 +1,62 @@
1
+ """Keep scripted Cursor requests out of human activity by registering before sending."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ import os
7
+ import re
8
+ import subprocess
9
+ from pathlib import Path
10
+ from typing import TextIO
11
+
12
+ from .config import AutError
13
+ from .state import _locked, atomic_write_text, state_path
14
+
15
+ _UUID = re.compile(r"[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}")
16
+
17
+
18
+ def registry_path() -> Path:
19
+ return state_path().with_name("cursor-automated.json")
20
+
21
+
22
+ def automated_sessions() -> set[str]:
23
+ """Read trusted local registrations. Missing is empty; unreadable or corrupt is an error."""
24
+ path = registry_path()
25
+ try:
26
+ if os.name != "nt" and path.stat().st_mode & 0o077:
27
+ raise AutError("aut: restrict cursor-automated.json to its owner (mode 0600)")
28
+ value = json.loads(path.read_text(encoding="utf-8"))
29
+ except FileNotFoundError:
30
+ return set()
31
+ except (OSError, ValueError) as exc:
32
+ raise AutError("aut: Cursor origin registry is unreadable; it was not reset") from exc
33
+ if (not isinstance(value, dict) or set(value) != {"version", "sessions"}
34
+ or type(value["version"]) is not int or value["version"] != 1
35
+ or not isinstance(value["sessions"], list)
36
+ or any(not isinstance(s, str) or not _UUID.fullmatch(s) for s in value["sessions"])):
37
+ raise AutError("aut: Cursor origin registry is invalid; it was not reset")
38
+ return set(value["sessions"])
39
+
40
+
41
+ def run(model: str, workspace: str, prompt: TextIO) -> None:
42
+ """Create an empty native chat, persist its origin, then send the first request."""
43
+ if not model.strip() or not workspace.strip():
44
+ raise AutError("aut cursor-run: model and workspace must be explicit nonempty values")
45
+ try:
46
+ created = subprocess.run(["cursor-agent", "--workspace", workspace, "create-chat"],
47
+ stdin=subprocess.DEVNULL, capture_output=True, text=True, timeout=60)
48
+ sid = created.stdout.strip()
49
+ if created.returncode or not _UUID.fullmatch(sid):
50
+ raise AutError("aut cursor-run: could not create an empty chat; no prompt was sent")
51
+ path = registry_path()
52
+ with _locked(path):
53
+ registered = automated_sessions()
54
+ registered.add(sid)
55
+ atomic_write_text(path, json.dumps({"version": 1, "sessions": sorted(registered)}))
56
+ result = subprocess.run(["cursor-agent", "--resume", sid, "--print", "--mode", "ask",
57
+ "--trust", "--model", model, "--output-format", "json",
58
+ "--workspace", workspace], input=prompt.read(), text=True)
59
+ if result.returncode:
60
+ raise AutError("aut cursor-run: Cursor failed; its automated origin is retained")
61
+ except (OSError, subprocess.SubprocessError) as exc:
62
+ raise AutError("aut cursor-run: could not finish; any registered origin is retained") from exc