raytrace-cli 0.11.1__py3-none-win_amd64.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 (165) hide show
  1. raytrace/__init__.py +1 -0
  2. raytrace/__main__.py +33 -0
  3. raytrace/app/LICENSE +21 -0
  4. raytrace/app/README.md +599 -0
  5. raytrace/app/bin/raytrace.mjs +297 -0
  6. raytrace/app/dist/dashboard/assets/dm-sans-latin-400-normal-BwCSEQnW.woff +0 -0
  7. raytrace/app/dist/dashboard/assets/dm-sans-latin-400-normal-CW0RaeGs.woff2 +0 -0
  8. raytrace/app/dist/dashboard/assets/dm-sans-latin-500-normal-B9HHJjqV.woff2 +0 -0
  9. raytrace/app/dist/dashboard/assets/dm-sans-latin-500-normal-Dr3UlScf.woff +0 -0
  10. raytrace/app/dist/dashboard/assets/dm-sans-latin-600-normal-Aqo67rzb.woff2 +0 -0
  11. raytrace/app/dist/dashboard/assets/dm-sans-latin-600-normal-BmdmIIQ2.woff +0 -0
  12. raytrace/app/dist/dashboard/assets/dm-sans-latin-700-normal-CUSSCpQX.woff +0 -0
  13. raytrace/app/dist/dashboard/assets/dm-sans-latin-700-normal-DvUfVpUG.woff2 +0 -0
  14. raytrace/app/dist/dashboard/assets/dm-sans-latin-ext-400-normal-BjWJ59Pq.woff +0 -0
  15. raytrace/app/dist/dashboard/assets/dm-sans-latin-ext-400-normal-BtiwyxMk.woff2 +0 -0
  16. raytrace/app/dist/dashboard/assets/dm-sans-latin-ext-500-normal-BJfUCQsA.woff2 +0 -0
  17. raytrace/app/dist/dashboard/assets/dm-sans-latin-ext-500-normal-DR84L5F-.woff +0 -0
  18. raytrace/app/dist/dashboard/assets/dm-sans-latin-ext-600-normal-4vooXBpG.woff2 +0 -0
  19. raytrace/app/dist/dashboard/assets/dm-sans-latin-ext-600-normal-DRtaDpgU.woff +0 -0
  20. raytrace/app/dist/dashboard/assets/dm-sans-latin-ext-700-normal-BLI3TTWz.woff +0 -0
  21. raytrace/app/dist/dashboard/assets/dm-sans-latin-ext-700-normal-CJIcxD6K.woff2 +0 -0
  22. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-400-normal-BSMlKf0J.woff2 +0 -0
  23. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-400-normal-CEL4l2ZJ.woff +0 -0
  24. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-500-normal-Ael50iVv.woff +0 -0
  25. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-500-normal-Bq9vWWag.woff2 +0 -0
  26. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-600-normal-CTOM6hUh.woff2 +0 -0
  27. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-600-normal-fLZuRloM.woff +0 -0
  28. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-ext-400-normal-DMdlQ8Kv.woff +0 -0
  29. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-ext-400-normal-xuaO2J-f.woff2 +0 -0
  30. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-ext-500-normal-BIfNGwUT.woff +0 -0
  31. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-ext-500-normal-BqneJy0T.woff2 +0 -0
  32. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-ext-600-normal-9HEixskS.woff +0 -0
  33. raytrace/app/dist/dashboard/assets/ibm-plex-mono-cyrillic-ext-600-normal-V-xxqcpd.woff2 +0 -0
  34. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-400-normal-CvHOgSBP.woff +0 -0
  35. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-400-normal-DMJ8VG8y.woff2 +0 -0
  36. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-500-normal-CB9ihrfo.woff +0 -0
  37. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-500-normal-DSY6xOcd.woff2 +0 -0
  38. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-600-normal-BgSNZQsw.woff2 +0 -0
  39. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-600-normal-DWFSQ4vo.woff +0 -0
  40. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-ext-400-normal-BmRBH3aV.woff2 +0 -0
  41. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-ext-400-normal-D3D2R8hC.woff +0 -0
  42. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-ext-500-normal-CAhNIIs5.woff2 +0 -0
  43. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-ext-500-normal-CZ70TYgx.woff +0 -0
  44. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-ext-600-normal-D38SheWl.woff2 +0 -0
  45. raytrace/app/dist/dashboard/assets/ibm-plex-mono-latin-ext-600-normal-DmB0ttJJ.woff +0 -0
  46. raytrace/app/dist/dashboard/assets/ibm-plex-mono-vietnamese-400-normal-BulugwFq.woff2 +0 -0
  47. raytrace/app/dist/dashboard/assets/ibm-plex-mono-vietnamese-400-normal-DDuiU_S-.woff +0 -0
  48. raytrace/app/dist/dashboard/assets/ibm-plex-mono-vietnamese-500-normal-C8zxqsMH.woff +0 -0
  49. raytrace/app/dist/dashboard/assets/ibm-plex-mono-vietnamese-500-normal-DZ4AoWbu.woff2 +0 -0
  50. raytrace/app/dist/dashboard/assets/ibm-plex-mono-vietnamese-600-normal-D2EvbN8M.woff2 +0 -0
  51. raytrace/app/dist/dashboard/assets/ibm-plex-mono-vietnamese-600-normal-iLQfcSjf.woff +0 -0
  52. raytrace/app/dist/dashboard/assets/index-DepcI8Fi.js +38 -0
  53. raytrace/app/dist/dashboard/assets/index-H97VLD5l.css +1 -0
  54. raytrace/app/dist/dashboard/favicon.svg +6 -0
  55. raytrace/app/dist/dashboard/index.html +15 -0
  56. raytrace/app/package.json +48 -0
  57. raytrace/app/proxy/agent-intent-schema.test.mjs +142 -0
  58. raytrace/app/proxy/call-assessment.mjs +385 -0
  59. raytrace/app/proxy/call-assessment.test.mjs +167 -0
  60. raytrace/app/proxy/call-category.mjs +461 -0
  61. raytrace/app/proxy/capture-health.mjs +30 -0
  62. raytrace/app/proxy/capture-health.test.mjs +44 -0
  63. raytrace/app/proxy/capture.mjs +38 -0
  64. raytrace/app/proxy/capture.test.mjs +49 -0
  65. raytrace/app/proxy/claude-code-adapter.mjs +301 -0
  66. raytrace/app/proxy/claude-code-hook.mjs +22 -0
  67. raytrace/app/proxy/codex-config.mjs +36 -0
  68. raytrace/app/proxy/codex.mjs +14 -0
  69. raytrace/app/proxy/evidence-schema.test.mjs +240 -0
  70. raytrace/app/proxy/evidence-store.mjs +993 -0
  71. raytrace/app/proxy/evidence-store.test.mjs +301 -0
  72. raytrace/app/proxy/exec-narrative.mjs +625 -0
  73. raytrace/app/proxy/exec-narrative.test.mjs +262 -0
  74. raytrace/app/proxy/execution-correlation.mjs +185 -0
  75. raytrace/app/proxy/execution-correlation.test.mjs +146 -0
  76. raytrace/app/proxy/execution-runner.mjs +89 -0
  77. raytrace/app/proxy/execution-runner.test.mjs +38 -0
  78. raytrace/app/proxy/experiment-engine.mjs +195 -0
  79. raytrace/app/proxy/experiment-engine.test.mjs +93 -0
  80. raytrace/app/proxy/explanations.mjs +36 -0
  81. raytrace/app/proxy/explanations.test.mjs +20 -0
  82. raytrace/app/proxy/failure-signature.mjs +56 -0
  83. raytrace/app/proxy/gvisor-forwarder.mjs +493 -0
  84. raytrace/app/proxy/gvisor-forwarder.test.mjs +433 -0
  85. raytrace/app/proxy/init-evidence-db.mjs +227 -0
  86. raytrace/app/proxy/local-sandboxes.mjs +94 -0
  87. raytrace/app/proxy/local-token.mjs +30 -0
  88. raytrace/app/proxy/playground-recovery.test.mjs +130 -0
  89. raytrace/app/proxy/playground.mjs +439 -0
  90. raytrace/app/proxy/prompt-context.mjs +278 -0
  91. raytrace/app/proxy/prompt-traces.mjs +40 -0
  92. raytrace/app/proxy/prompt-traces.test.mjs +32 -0
  93. raytrace/app/proxy/providers.mjs +65 -0
  94. raytrace/app/proxy/providers.test.mjs +76 -0
  95. raytrace/app/proxy/proxy.integration.test.mjs +135 -0
  96. raytrace/app/proxy/raytace-proxy.mjs +941 -0
  97. raytrace/app/proxy/request-metrics.mjs +13 -0
  98. raytrace/app/proxy/request-metrics.test.mjs +19 -0
  99. raytrace/app/proxy/request-policy.mjs +45 -0
  100. raytrace/app/proxy/request-policy.test.mjs +47 -0
  101. raytrace/app/proxy/run-recap.mjs +139 -0
  102. raytrace/app/proxy/runtime-attribution.mjs +110 -0
  103. raytrace/app/proxy/sandbox-bridge.mjs +49 -0
  104. raytrace/app/proxy/schema/EVIDENCE_DATABASE.md +276 -0
  105. raytrace/app/proxy/schema/agent_intent.sql +101 -0
  106. raytrace/app/proxy/schema/auxiliary.sql +90 -0
  107. raytrace/app/proxy/schema/capture_health.sql +14 -0
  108. raytrace/app/proxy/schema/classification.sql +89 -0
  109. raytrace/app/proxy/schema/file_context.sql +53 -0
  110. raytrace/app/proxy/schema/runtime_evidence.sql +201 -0
  111. raytrace/app/proxy/schema/search.sql +66 -0
  112. raytrace/app/proxy/schema/shared_storage.sql +21 -0
  113. raytrace/app/proxy/search.mjs +418 -0
  114. raytrace/app/proxy/search.test.mjs +161 -0
  115. raytrace/app/proxy/smoke.test.mjs +93 -0
  116. raytrace/app/proxy/step-attribution.mjs +380 -0
  117. raytrace/app/proxy/step-lab.mjs +78 -0
  118. raytrace/app/proxy/step-lab.test.mjs +38 -0
  119. raytrace/app/proxy/summaries.mjs +151 -0
  120. raytrace/app/proxy/summaries.test.mjs +69 -0
  121. raytrace/app/proxy/tool-metadata.mjs +111 -0
  122. raytrace/app/proxy/tool-metadata.test.mjs +38 -0
  123. raytrace/app/proxy/trace-view.mjs +324 -0
  124. raytrace/app/proxy/trace-view.test.mjs +92 -0
  125. raytrace/app/proxy/typesafe.mjs +63 -0
  126. raytrace/app/proxy/typesafe.test.mjs +39 -0
  127. raytrace/app/src/agents.mjs +7 -0
  128. raytrace/app/src/api.mjs +57 -0
  129. raytrace/app/src/auth.mjs +205 -0
  130. raytrace/app/src/beta.mjs +96 -0
  131. raytrace/app/src/claude-code.mjs +93 -0
  132. raytrace/app/src/commands.mjs +285 -0
  133. raytrace/app/src/config.mjs +49 -0
  134. raytrace/app/src/export.mjs +200 -0
  135. raytrace/app/src/lima.mjs +176 -0
  136. raytrace/app/src/local-sandbox.mjs +358 -0
  137. raytrace/app/src/mcp.mjs +688 -0
  138. raytrace/app/src/paths.mjs +33 -0
  139. raytrace/app/src/prompt.mjs +42 -0
  140. raytrace/app/src/proxy-process.mjs +143 -0
  141. raytrace/app/src/sandbox.mjs +306 -0
  142. raytrace/app/src/share.mjs +86 -0
  143. raytrace/app/src/terminal.mjs +68 -0
  144. raytrace/app/src/upload.mjs +198 -0
  145. raytrace/app/worker/sandbox/Dockerfile +8 -0
  146. raytrace/app/worker/sandbox/SYSCALL_CATALOG.md +197 -0
  147. raytrace/app/worker/sandbox/claude-hook.mjs +364 -0
  148. raytrace/app/worker/sandbox/collector.py +405 -0
  149. raytrace/app/worker/sandbox/dns_forwarder.py +255 -0
  150. raytrace/app/worker/sandbox/engine.py +940 -0
  151. raytrace/app/worker/sandbox/file_scan.py +491 -0
  152. raytrace/app/worker/sandbox/lima.yaml +29 -0
  153. raytrace/app/worker/sandbox/network.py +90 -0
  154. raytrace/app/worker/sandbox/projects.py +702 -0
  155. raytrace/app/worker/sandbox/setup.py +159 -0
  156. raytrace/app/worker/sandbox/syscall_catalog.sql +985 -0
  157. raytrace/app/worker/sandbox/transcript-delivery.test.mjs +153 -0
  158. raytrace/app/worker/sandbox/viewer.py +195 -0
  159. raytrace/node/LICENSE +2946 -0
  160. raytrace/node/node.exe +4 -0
  161. raytrace_cli-0.11.1.dist-info/LICENSE +21 -0
  162. raytrace_cli-0.11.1.dist-info/METADATA +42 -0
  163. raytrace_cli-0.11.1.dist-info/RECORD +165 -0
  164. raytrace_cli-0.11.1.dist-info/WHEEL +4 -0
  165. raytrace_cli-0.11.1.dist-info/entry_points.txt +2 -0
@@ -0,0 +1,297 @@
1
+ #!/usr/bin/env node
2
+ // The `raytrace` command. Each subcommand lives in src/commands.mjs.
3
+ import { readFileSync } from 'node:fs';
4
+ import { parseArgs } from 'node:util';
5
+
6
+ const HELP = `RayTrace: see what your coding agent did.
7
+
8
+ Usage: raytrace <command>
9
+
10
+ Get started in the cloud (preview):
11
+ 1. raytrace auth login sign in, or create your account, in the browser
12
+ 2. raytrace sandbox create from a Git repository: upload it to a new sandbox
13
+ 3. raytrace connect <sandbox-id> --claude
14
+ a terminal in it, with Claude Code running (or --codex)
15
+
16
+ Cloud sandboxes:
17
+ raytrace auth login|status|logout your RayTrace sign-in
18
+ raytrace sandbox create [--name <name>] upload this Git repository to a new sandbox
19
+ (up to 200 MiB, 25 MiB a file, 20,000 files)
20
+ raytrace connect [id] [--claude|--codex] a terminal in it; with one sandbox the id is
21
+ optional (same as: raytrace sandbox shell [id]);
22
+ --claude or --codex starts that agent in it at
23
+ once, without approval prompts
24
+ raytrace --code <code> beta invite: redeem a code RayTrace gave you for one
25
+ $10-credit sandbox (signed in first; also: raytrace code <code>)
26
+ raytrace sandbox list
27
+ raytrace sandbox start|stop [id]
28
+ raytrace sandbox destroy [id] [--yes] [--keep-traces]
29
+ delete it; traces go too unless --keep-traces (paid plans)
30
+
31
+ Use from your editor's agent (VS Code, Cursor, Claude Code, any MCP client):
32
+ raytrace mcp MCP server on stdio: create, open, list, start, stop
33
+ and destroy local and cloud sandboxes, and run
34
+ commands in cloud ones. Add it to your editor as:
35
+ npx -y @raytrace-cli/cli@latest mcp
36
+ (Claude Code: claude mcp add --scope user raytrace
37
+ -- npx -y @raytrace-cli/cli@latest mcp)
38
+
39
+ Local sandboxes (your project stays on this machine):
40
+ raytrace sandbox create --local [--name <name>] [--yes]
41
+ a copy of this Git repository in a gVisor sandbox
42
+ in a Linux VM here; the name defaults to the folder's.
43
+ Offers to download Lima if missing (--yes: no prompt)
44
+ raytrace connect <name> [--claude|--codex]
45
+ a terminal in it, optionally with that agent running
46
+ raytrace sandbox list --local
47
+ raytrace sandbox start|stop <name>
48
+ raytrace sandbox destroy <name> [--delete-logs | --keep-logs]
49
+ asks whether to delete its captured logs too;
50
+ kept logs move to ~/.raytrace/archive
51
+ Recorded commands, files and connections: raytrace open, then Sandbox evidence.
52
+ macOS and Linux; Windows is experimental. raytrace doctor shows what is missing.
53
+
54
+ Upload local evidences to RayTrace cloud (needs sign-in):
55
+ raytrace upload logs [--sandbox <name>] [--dry-run] [--yes]
56
+ gzip and upload a local sandbox's evidences;
57
+ they appear at https://app.raytracer.si
58
+ raytrace upload status your plan's evidences storage
59
+
60
+ Export recorded traces:
61
+ raytrace export <trace-id> view trace details in terminal as Markdown
62
+ raytrace export <trace-id> --format json export trace structured as JSON
63
+ raytrace export <trace-id> --output <file>
64
+ save export to file with owner-only permissions
65
+
66
+ Share recorded traces (time-limited cloud link):
67
+ raytrace share <trace-id> [--fork] create a share link for peers
68
+ raytrace share --list list your active share links
69
+ raytrace share --revoke <share-id> revoke an active share link
70
+
71
+ AI features in the dashboard (summaries, recaps, Chain of thought), on your own key:
72
+ raytrace key which keys are set
73
+ raytrace key openrouter add your OpenRouter key (asked for, not echoed)
74
+ raytrace key typesafe optional: Jev ranking and command severity
75
+ raytrace key <name> --remove
76
+
77
+ Your sign-in stays on this machine; raytrace auth logout removes it.`;
78
+
79
+ // node:sqlite, which the recorder stores everything in, needs 22.13.
80
+ const [major, minor] = process.versions.node.split('.').map(Number);
81
+ if (major < 22 || (major === 22 && minor < 13)) {
82
+ console.error(`RayTrace needs Node.js 22.13 or newer; this is ${process.version}.`);
83
+ process.exit(1);
84
+ }
85
+
86
+ const [command, ...rest] = process.argv.slice(2);
87
+
88
+ // The hook runs on every Claude Code tool call: dispatch it before anything else.
89
+ if (command === 'hook') {
90
+ const { hook } = await import('../src/commands.mjs');
91
+ await hook(rest[0]);
92
+ process.exit(0);
93
+ }
94
+
95
+ if (command === '--version' || command === '-v') {
96
+ console.log(JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version);
97
+ process.exit(0);
98
+ }
99
+ // `raytrace mcp`: stdout belongs to the MCP protocol, so nothing else may run first.
100
+ if (command === 'mcp') {
101
+ if (rest.length) { console.error('Usage: raytrace mcp'); process.exit(2); }
102
+ const { serve } = await import('../src/mcp.mjs');
103
+ await serve();
104
+ process.exit(0);
105
+ }
106
+
107
+ if (!command || command === 'help' || command === '--help' || command === '-h') { console.log(HELP); process.exit(0); }
108
+
109
+ // `raytrace --code <code>` (also `raytrace code <code>`): redeem a beta code.
110
+ if (command === '--code' || command.startsWith('--code=') || command === 'code') {
111
+ const beta = await import('../src/beta.mjs');
112
+ const code = command.startsWith('--code=') ? command.slice('--code='.length) : rest[0];
113
+ const extra = command.startsWith('--code=') ? rest.length : rest.length - 1;
114
+ if (!code || extra !== 0) { console.error('Usage: raytrace --code <code>'); process.exit(2); }
115
+ try { await beta.redeemBetaCode(code); process.exit(0); }
116
+ catch (error) { console.error(`raytrace --code: ${error.message}`); process.exit(1); }
117
+ }
118
+
119
+ const commands = await import('../src/commands.mjs');
120
+
121
+ // `codex` passes everything after it straight to Codex.
122
+ if (command === 'codex') { await commands.codex(rest); process.exit(); }
123
+
124
+ if (command === 'auth') {
125
+ const auth = await import('../src/auth.mjs');
126
+ const sub = rest[0];
127
+ const action = { login: auth.loginCommand, status: auth.status, logout: auth.logout }[sub];
128
+ if (!action) { console.error(`Usage: raytrace auth login | status | logout`); process.exit(2); }
129
+ try { await action(); process.exit(0); }
130
+ catch (error) { console.error(`raytrace auth ${sub}: ${error.message}`); process.exit(1); }
131
+ }
132
+
133
+ // `raytrace connect <id>`: the sandbox's terminal, by the id the dashboard shows.
134
+ if (command === 'connect') {
135
+ const agents = ['claude', 'codex'].filter((agent) => rest.includes(`--${agent}`));
136
+ const flags = { local: rest.includes('--local'), agent: agents[0] };
137
+ const args = rest.filter((arg) => !['--local', '--claude', '--codex'].includes(arg));
138
+ if (args.length > 1 || args[0]?.startsWith('-') || agents.length > 1) { console.error('Usage: raytrace connect [sandbox-id or local name] [--local] [--claude | --codex]'); process.exit(2); }
139
+ const sandbox = await import('../src/sandbox.mjs');
140
+ try { await sandbox.shell(args[0], flags); process.exit(0); }
141
+ catch (error) { console.error(`raytrace connect: ${error.message}`); process.exit(1); }
142
+ }
143
+
144
+ // `raytrace key [openrouter|typesafe] [--remove]`: the keys the dashboard's AI features use.
145
+ if (command === 'key') {
146
+ const args = rest.filter((arg) => arg !== '--remove');
147
+ if (args.length > 1 || args[0]?.startsWith('-')) { console.error('Usage: raytrace key [openrouter|typesafe] [--remove]'); process.exit(2); }
148
+ const { keyCommand } = await import('../src/commands.mjs');
149
+ try { await keyCommand(args[0], { remove: rest.includes('--remove') }); process.exit(0); }
150
+ catch (error) { console.error(`raytrace key: ${error.message}`); process.exit(1); }
151
+ }
152
+
153
+ if (command === 'sandbox') {
154
+ const sandbox = await import('../src/sandbox.mjs');
155
+ let parsed;
156
+ try {
157
+ parsed = parseArgs({ args: rest, strict: true, allowPositionals: true, options: {
158
+ yes: { type: 'boolean', short: 'y' },
159
+ name: { type: 'string' },
160
+ local: { type: 'boolean' },
161
+ 'delete-logs': { type: 'boolean' },
162
+ 'keep-logs': { type: 'boolean' },
163
+ 'keep-traces': { type: 'boolean' },
164
+ } });
165
+ } catch (error) { console.error(`${error.message}\n\nRun \`raytrace help\` for usage.`); process.exit(2); }
166
+ const [sub, id] = parsed.positionals;
167
+ const action = {
168
+ create: () => sandbox.create(parsed.values),
169
+ list: () => sandbox.list(parsed.values),
170
+ shell: () => sandbox.shell(id, parsed.values),
171
+ start: () => sandbox.start(id, parsed.values),
172
+ stop: () => sandbox.stop(id, parsed.values),
173
+ destroy: () => sandbox.destroy(id, parsed.values),
174
+ }[sub];
175
+ if (!action) { console.error(`Unknown sandbox command: ${sub ?? '(none)'}\n\n${HELP}`); process.exit(2); }
176
+ try { await action(); process.exit(0); }
177
+ catch (error) { console.error(`raytrace sandbox ${sub}: ${error.message}`); process.exit(1); }
178
+ }
179
+
180
+ if (command === 'upload') {
181
+ let parsed;
182
+ try {
183
+ parsed = parseArgs({ args: rest, strict: true, allowPositionals: true, options: {
184
+ yes: { type: 'boolean', short: 'y' },
185
+ sandbox: { type: 'string' },
186
+ 'dry-run': { type: 'boolean' },
187
+ } });
188
+ } catch (error) { console.error(`${error.message}\n\nUsage: raytrace upload logs [--sandbox <name>] [--dry-run] [--yes] | raytrace upload status`); process.exit(2); }
189
+ const [sub, ...extra] = parsed.positionals;
190
+ if (extra.length || (sub !== 'logs' && sub !== 'status')) {
191
+ console.error('Usage: raytrace upload logs [--sandbox <name>] [--dry-run] [--yes] | raytrace upload status');
192
+ process.exit(2);
193
+ }
194
+ const upload = await import('../src/upload.mjs');
195
+ try {
196
+ if (sub === 'status') await upload.uploadStatus();
197
+ else await upload.uploadLogs({ sandbox: parsed.values.sandbox, yes: parsed.values.yes, dryRun: parsed.values['dry-run'] });
198
+ process.exit(0);
199
+ } catch (error) { console.error(`raytrace upload ${sub}: ${error.message}`); process.exit(1); }
200
+ }
201
+
202
+ if (command === 'export') {
203
+ let parsed;
204
+ try {
205
+ parsed = parseArgs({ args: rest, strict: true, allowPositionals: true, options: {
206
+ format: { type: 'string' },
207
+ output: { type: 'string' },
208
+ } });
209
+ } catch (error) {
210
+ console.error(`${error.message}\n\nUsage: raytrace export <trace-id> [--format json|markdown] [--output <file>]`);
211
+ process.exit(2);
212
+ }
213
+ const [traceId, ...extra] = parsed.positionals;
214
+ if (!traceId || extra.length > 0) {
215
+ console.error('Usage: raytrace export <trace-id> [--format json|markdown] [--output <file>]');
216
+ process.exit(2);
217
+ }
218
+ const format = parsed.values.format ?? 'markdown';
219
+ if (format !== 'markdown' && format !== 'json') {
220
+ console.error(`Invalid format: ${format}. Expected 'markdown' or 'json'.`);
221
+ process.exit(2);
222
+ }
223
+ const { exportCommand } = await import('../src/export.mjs');
224
+ try {
225
+ await exportCommand(traceId, { format, output: parsed.values.output });
226
+ process.exit(0);
227
+ } catch (error) {
228
+ console.error(`raytrace export: ${error.message}`);
229
+ process.exit(1);
230
+ }
231
+ }
232
+
233
+ if (command === 'share') {
234
+ let parsed;
235
+ try {
236
+ parsed = parseArgs({ args: rest, strict: true, allowPositionals: true, options: {
237
+ list: { type: 'boolean', short: 'l' },
238
+ revoke: { type: 'string' },
239
+ sandbox: { type: 'string' },
240
+ fork: { type: 'boolean' },
241
+ } });
242
+ } catch (error) {
243
+ console.error(`${error.message}\n\nUsage: raytrace share <trace-id> [--sandbox <id>] [--fork] | raytrace share --list | raytrace share --revoke <id>`);
244
+ process.exit(2);
245
+ }
246
+ const [sub, ...extra] = parsed.positionals;
247
+ const share = await import('../src/share.mjs');
248
+ try {
249
+ if (parsed.values.list || sub === 'list') {
250
+ await share.listShares();
251
+ process.exit(0);
252
+ }
253
+ if (parsed.values.revoke || sub === 'revoke') {
254
+ const shareId = parsed.values.revoke || extra[0];
255
+ if (!shareId) {
256
+ console.error('Usage: raytrace share --revoke <id> (or raytrace share revoke <id>)');
257
+ process.exit(2);
258
+ }
259
+ await share.revokeShare(shareId);
260
+ process.exit(0);
261
+ }
262
+ if (!sub || extra.length > 0) {
263
+ console.error('Usage: raytrace share <trace-id> [--sandbox <id>] [--fork] | raytrace share --list | raytrace share --revoke <id>');
264
+ process.exit(2);
265
+ }
266
+ await share.sharePrompt(sub, { sandboxId: parsed.values.sandbox, allowFork: parsed.values.fork });
267
+ process.exit(0);
268
+ } catch (error) {
269
+ console.error(`raytrace share: ${error.message}`);
270
+ process.exit(1);
271
+ }
272
+ }
273
+
274
+ let flags;
275
+ try {
276
+ ({ values: flags } = parseArgs({ args: rest, strict: true, options: {
277
+ yes: { type: 'boolean', short: 'y' },
278
+ 'no-claude-code': { type: 'boolean' },
279
+ 'no-start': { type: 'boolean' },
280
+ 'openrouter-key': { type: 'string' },
281
+ purge: { type: 'boolean' },
282
+ } }));
283
+ } catch (error) { console.error(`${error.message}\n\nRun \`raytrace help\` for usage.`); process.exit(2); }
284
+
285
+ const run = {
286
+ setup: () => commands.setup(flags),
287
+ start: () => commands.startCommand(),
288
+ stop: () => commands.stopCommand(),
289
+ status: () => commands.statusCommand(),
290
+ open: () => commands.openCommand(),
291
+ doctor: () => commands.doctor(),
292
+ uninstall: () => commands.uninstall(flags),
293
+ }[command];
294
+
295
+ if (!run) { console.error(`Unknown command: ${command}\n\n${HELP}`); process.exit(2); }
296
+ try { await run(); }
297
+ catch (error) { console.error(`raytrace ${command}: ${error.message}`); process.exitCode = 1; }