@prismatic-io/lux 0.0.1 → 0.0.2-preview.11

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 (256) hide show
  1. package/lib/answerers/persona/index.d.ts +2 -1
  2. package/lib/answerers/persona/index.d.ts.map +1 -1
  3. package/lib/answerers/persona/index.js +20 -5
  4. package/lib/answerers/persona/index.js.map +1 -1
  5. package/lib/answerers/terminal/index.js +1 -1
  6. package/lib/answerers/terminal/index.js.map +1 -1
  7. package/lib/assertions/authoring.d.ts +14 -0
  8. package/lib/assertions/authoring.d.ts.map +1 -0
  9. package/lib/assertions/authoring.js +3 -0
  10. package/lib/assertions/authoring.js.map +1 -0
  11. package/lib/assertions/core/helpers.d.ts +2 -7
  12. package/lib/assertions/core/helpers.d.ts.map +1 -1
  13. package/lib/assertions/core/helpers.js +2 -6
  14. package/lib/assertions/core/helpers.js.map +1 -1
  15. package/lib/assertions/core/index.d.ts.map +1 -1
  16. package/lib/assertions/core/index.js +2 -1
  17. package/lib/assertions/core/index.js.map +1 -1
  18. package/lib/assertions/core/resource-checks.d.ts +19 -0
  19. package/lib/assertions/core/resource-checks.d.ts.map +1 -1
  20. package/lib/assertions/core/resource-checks.js +32 -0
  21. package/lib/assertions/core/resource-checks.js.map +1 -1
  22. package/lib/authoring.d.ts +1 -0
  23. package/lib/authoring.d.ts.map +1 -1
  24. package/lib/authoring.js +1 -0
  25. package/lib/authoring.js.map +1 -1
  26. package/lib/cli/program.d.ts.map +1 -1
  27. package/lib/cli/program.js +12 -67
  28. package/lib/cli/program.js.map +1 -1
  29. package/lib/cli/render/reporter.d.ts.map +1 -1
  30. package/lib/cli/render/reporter.js +16 -3
  31. package/lib/cli/render/reporter.js.map +1 -1
  32. package/lib/cli/run-options.d.ts +1 -0
  33. package/lib/cli/run-options.d.ts.map +1 -1
  34. package/lib/cli/run-options.js.map +1 -1
  35. package/lib/cli/view.d.ts +13 -0
  36. package/lib/cli/view.d.ts.map +1 -0
  37. package/lib/cli/view.js +126 -0
  38. package/lib/cli/view.js.map +1 -0
  39. package/lib/core/action-events.d.ts +29 -0
  40. package/lib/core/action-events.d.ts.map +1 -0
  41. package/lib/core/action-events.js +51 -0
  42. package/lib/core/action-events.js.map +1 -0
  43. package/lib/core/agent-activity.d.ts +49 -0
  44. package/lib/core/agent-activity.d.ts.map +1 -0
  45. package/lib/core/agent-activity.js +206 -0
  46. package/lib/core/agent-activity.js.map +1 -0
  47. package/lib/core/agent-events.d.ts +26 -0
  48. package/lib/core/agent-events.d.ts.map +1 -0
  49. package/lib/core/agent-events.js +13 -0
  50. package/lib/core/agent-events.js.map +1 -0
  51. package/lib/core/artifact-evidence.d.ts +8 -0
  52. package/lib/core/artifact-evidence.d.ts.map +1 -1
  53. package/lib/core/artifact-evidence.js +36 -4
  54. package/lib/core/artifact-evidence.js.map +1 -1
  55. package/lib/core/assertion.d.ts +19 -9
  56. package/lib/core/assertion.d.ts.map +1 -1
  57. package/lib/core/assertion.js +26 -0
  58. package/lib/core/assertion.js.map +1 -1
  59. package/lib/core/case-authoring-state.d.ts +12 -0
  60. package/lib/core/case-authoring-state.d.ts.map +1 -0
  61. package/lib/core/case-authoring-state.js +43 -0
  62. package/lib/core/case-authoring-state.js.map +1 -0
  63. package/lib/core/case.d.ts +29 -1
  64. package/lib/core/case.d.ts.map +1 -1
  65. package/lib/core/case.js +14 -6
  66. package/lib/core/case.js.map +1 -1
  67. package/lib/core/driver-metrics.d.ts +98 -0
  68. package/lib/core/driver-metrics.d.ts.map +1 -0
  69. package/lib/core/driver-metrics.js +36 -0
  70. package/lib/core/driver-metrics.js.map +1 -0
  71. package/lib/core/driver.d.ts +3 -0
  72. package/lib/core/driver.d.ts.map +1 -1
  73. package/lib/core/driver.js.map +1 -1
  74. package/lib/core/events.d.ts +36 -0
  75. package/lib/core/events.d.ts.map +1 -1
  76. package/lib/core/events.js +12 -2
  77. package/lib/core/events.js.map +1 -1
  78. package/lib/core/experiment.d.ts +19 -0
  79. package/lib/core/experiment.d.ts.map +1 -1
  80. package/lib/core/experiment.js +2 -0
  81. package/lib/core/experiment.js.map +1 -1
  82. package/lib/core/index.d.ts +4 -0
  83. package/lib/core/index.d.ts.map +1 -1
  84. package/lib/core/index.js +4 -0
  85. package/lib/core/index.js.map +1 -1
  86. package/lib/core/lifecycle-fixtures.d.ts +3 -1
  87. package/lib/core/lifecycle-fixtures.d.ts.map +1 -1
  88. package/lib/core/lifecycle-fixtures.js +4 -2
  89. package/lib/core/lifecycle-fixtures.js.map +1 -1
  90. package/lib/core/lifecycle-hooks.d.ts +9 -0
  91. package/lib/core/lifecycle-hooks.d.ts.map +1 -1
  92. package/lib/core/lifecycle-hooks.js +8 -2
  93. package/lib/core/lifecycle-hooks.js.map +1 -1
  94. package/lib/core/run.d.ts +150 -0
  95. package/lib/core/run.d.ts.map +1 -1
  96. package/lib/core/run.js +9 -0
  97. package/lib/core/run.js.map +1 -1
  98. package/lib/core/wire.d.ts +12 -0
  99. package/lib/core/wire.d.ts.map +1 -1
  100. package/lib/core/wire.js +5 -1
  101. package/lib/core/wire.js.map +1 -1
  102. package/lib/drivers/claude-code/parse-events.d.ts.map +1 -1
  103. package/lib/drivers/claude-code/parse-events.js +73 -8
  104. package/lib/drivers/claude-code/parse-events.js.map +1 -1
  105. package/lib/drivers/codex/app-events.d.ts +9 -2
  106. package/lib/drivers/codex/app-events.d.ts.map +1 -1
  107. package/lib/drivers/codex/app-events.js +93 -12
  108. package/lib/drivers/codex/app-events.js.map +1 -1
  109. package/lib/drivers/codex/index.d.ts.map +1 -1
  110. package/lib/drivers/codex/index.js +10 -14
  111. package/lib/drivers/codex/index.js.map +1 -1
  112. package/lib/drivers/subprocess/index.d.ts.map +1 -1
  113. package/lib/drivers/subprocess/index.js +6 -0
  114. package/lib/drivers/subprocess/index.js.map +1 -1
  115. package/lib/index.d.ts +10 -6
  116. package/lib/index.d.ts.map +1 -1
  117. package/lib/index.js +10 -6
  118. package/lib/index.js.map +1 -1
  119. package/lib/orchestrator/annotation-store.d.ts.map +1 -1
  120. package/lib/orchestrator/annotation-store.js +6 -2
  121. package/lib/orchestrator/annotation-store.js.map +1 -1
  122. package/lib/orchestrator/case-extensions.d.ts +6 -0
  123. package/lib/orchestrator/case-extensions.d.ts.map +1 -0
  124. package/lib/orchestrator/case-extensions.js +28 -0
  125. package/lib/orchestrator/case-extensions.js.map +1 -0
  126. package/lib/orchestrator/compare.d.ts +13 -1
  127. package/lib/orchestrator/compare.d.ts.map +1 -1
  128. package/lib/orchestrator/compare.js +12 -0
  129. package/lib/orchestrator/compare.js.map +1 -1
  130. package/lib/orchestrator/config.d.ts.map +1 -1
  131. package/lib/orchestrator/config.js +0 -2
  132. package/lib/orchestrator/config.js.map +1 -1
  133. package/lib/orchestrator/doctor.d.ts.map +1 -1
  134. package/lib/orchestrator/doctor.js +5 -3
  135. package/lib/orchestrator/doctor.js.map +1 -1
  136. package/lib/orchestrator/experiment-contracts.d.ts +19 -0
  137. package/lib/orchestrator/experiment-contracts.d.ts.map +1 -1
  138. package/lib/orchestrator/experiment-evaluation.d.ts.map +1 -1
  139. package/lib/orchestrator/experiment-evaluation.js +17 -0
  140. package/lib/orchestrator/experiment-evaluation.js.map +1 -1
  141. package/lib/orchestrator/experiment-report.d.ts +19 -0
  142. package/lib/orchestrator/experiment-report.d.ts.map +1 -1
  143. package/lib/orchestrator/experiment-runs.d.ts +38 -0
  144. package/lib/orchestrator/experiment-runs.d.ts.map +1 -1
  145. package/lib/orchestrator/grader-experiment.d.ts +12 -0
  146. package/lib/orchestrator/grader-experiment.d.ts.map +1 -1
  147. package/lib/orchestrator/grading.d.ts +2 -1
  148. package/lib/orchestrator/grading.d.ts.map +1 -1
  149. package/lib/orchestrator/grading.js +16 -4
  150. package/lib/orchestrator/grading.js.map +1 -1
  151. package/lib/orchestrator/index.d.ts +1 -1
  152. package/lib/orchestrator/index.d.ts.map +1 -1
  153. package/lib/orchestrator/index.js +1 -1
  154. package/lib/orchestrator/index.js.map +1 -1
  155. package/lib/orchestrator/list-runs.d.ts +7 -1
  156. package/lib/orchestrator/list-runs.d.ts.map +1 -1
  157. package/lib/orchestrator/list-runs.js +50 -6
  158. package/lib/orchestrator/list-runs.js.map +1 -1
  159. package/lib/orchestrator/loader.d.ts.map +1 -1
  160. package/lib/orchestrator/loader.js +2 -0
  161. package/lib/orchestrator/loader.js.map +1 -1
  162. package/lib/orchestrator/orchestrator.d.ts +3 -0
  163. package/lib/orchestrator/orchestrator.d.ts.map +1 -1
  164. package/lib/orchestrator/orchestrator.js +42 -14
  165. package/lib/orchestrator/orchestrator.js.map +1 -1
  166. package/lib/orchestrator/owned-lock.d.ts.map +1 -1
  167. package/lib/orchestrator/owned-lock.js +52 -38
  168. package/lib/orchestrator/owned-lock.js.map +1 -1
  169. package/lib/orchestrator/regrade.d.ts +6 -0
  170. package/lib/orchestrator/regrade.d.ts.map +1 -1
  171. package/lib/orchestrator/regrade.js +8 -4
  172. package/lib/orchestrator/regrade.js.map +1 -1
  173. package/lib/orchestrator/run-execution.d.ts +2 -1
  174. package/lib/orchestrator/run-execution.d.ts.map +1 -1
  175. package/lib/orchestrator/run-execution.js +20 -5
  176. package/lib/orchestrator/run-execution.js.map +1 -1
  177. package/lib/orchestrator/suite-compare.d.ts +34 -0
  178. package/lib/orchestrator/suite-compare.d.ts.map +1 -1
  179. package/lib/orchestrator/suite-summary.d.ts +68 -0
  180. package/lib/orchestrator/suite-summary.d.ts.map +1 -1
  181. package/lib/orchestrator/suite-summary.js +45 -7
  182. package/lib/orchestrator/suite-summary.js.map +1 -1
  183. package/lib/previewer/artifacts.d.ts +25 -0
  184. package/lib/previewer/artifacts.d.ts.map +1 -0
  185. package/lib/previewer/artifacts.js +180 -0
  186. package/lib/previewer/artifacts.js.map +1 -0
  187. package/lib/previewer/server.d.ts +105 -0
  188. package/lib/previewer/server.d.ts.map +1 -0
  189. package/lib/previewer/server.js +542 -0
  190. package/lib/previewer/server.js.map +1 -0
  191. package/package.json +2 -2
  192. package/skills/lux/SKILL.md +7 -3
  193. package/skills/lux/references/cli.md +25 -2
  194. package/skills/lux/references/eval-authoring.md +158 -4
  195. package/skills/lux-answerer/SKILL.md +1 -1
  196. package/src/answerers/persona/index.ts +21 -4
  197. package/src/answerers/terminal/index.ts +1 -1
  198. package/src/assertions/authoring.ts +81 -0
  199. package/src/assertions/core/helpers.ts +3 -6
  200. package/src/assertions/core/index.ts +2 -0
  201. package/src/assertions/core/resource-checks.ts +35 -0
  202. package/src/authoring.ts +1 -0
  203. package/src/cli/program.ts +14 -93
  204. package/src/cli/render/reporter.ts +18 -3
  205. package/src/cli/run-options.ts +1 -0
  206. package/src/cli/view.ts +168 -0
  207. package/src/core/action-events.ts +59 -0
  208. package/src/core/agent-activity.ts +236 -0
  209. package/src/core/agent-events.ts +17 -0
  210. package/src/core/artifact-evidence.ts +47 -4
  211. package/src/core/assertion.ts +41 -22
  212. package/src/core/case-authoring-state.ts +65 -0
  213. package/src/core/case.ts +57 -6
  214. package/src/core/driver-metrics.ts +51 -0
  215. package/src/core/driver.ts +3 -0
  216. package/src/core/events.ts +14 -2
  217. package/src/core/experiment.ts +2 -0
  218. package/src/core/index.ts +4 -0
  219. package/src/core/lifecycle-fixtures.ts +7 -2
  220. package/src/core/lifecycle-hooks.ts +16 -2
  221. package/src/core/run.ts +9 -0
  222. package/src/core/wire.ts +5 -1
  223. package/src/drivers/claude-code/parse-events.ts +98 -12
  224. package/src/drivers/codex/app-events.ts +116 -16
  225. package/src/drivers/codex/index.ts +16 -14
  226. package/src/drivers/subprocess/index.ts +6 -0
  227. package/src/index.ts +50 -6
  228. package/src/orchestrator/annotation-store.ts +5 -1
  229. package/src/orchestrator/case-extensions.ts +44 -0
  230. package/src/orchestrator/compare.ts +18 -0
  231. package/src/orchestrator/config.ts +0 -2
  232. package/src/orchestrator/doctor.ts +5 -3
  233. package/src/orchestrator/experiment-evaluation.ts +23 -0
  234. package/src/orchestrator/grading.ts +21 -2
  235. package/src/orchestrator/index.ts +1 -0
  236. package/src/orchestrator/list-runs.ts +66 -5
  237. package/src/orchestrator/loader.ts +2 -0
  238. package/src/orchestrator/orchestrator.ts +86 -40
  239. package/src/orchestrator/owned-lock.ts +54 -34
  240. package/src/orchestrator/regrade.ts +8 -7
  241. package/src/orchestrator/run-execution.ts +24 -3
  242. package/src/orchestrator/suite-summary.ts +101 -8
  243. package/src/previewer/artifacts.ts +221 -0
  244. package/src/previewer/server.ts +765 -0
  245. package/viewer/app.css +2075 -0
  246. package/viewer/app.js +606 -0
  247. package/viewer/artifact-view.js +48 -0
  248. package/viewer/charts.js +86 -0
  249. package/viewer/detail.js +1214 -0
  250. package/viewer/format.js +129 -0
  251. package/viewer/index.html +151 -0
  252. package/lib/answerers/scripted/index.d.ts +0 -8
  253. package/lib/answerers/scripted/index.d.ts.map +0 -1
  254. package/lib/answerers/scripted/index.js +0 -163
  255. package/lib/answerers/scripted/index.js.map +0 -1
  256. package/src/answerers/scripted/index.ts +0 -186
@@ -0,0 +1,542 @@
1
+ import { existsSync } from "node:fs";
2
+ import { readFile } from "node:fs/promises";
3
+ import { createServer } from "node:http";
4
+ import { basename, relative, resolve, sep } from "node:path";
5
+ import { fileURLToPath } from "node:url";
6
+ import { exec } from "../core/index.js";
7
+ import { compareRuns, compareSuiteRuns, listExperimentRuns, listRuns, listSuiteRuns, loadExperimentCandidates, loadRunArtifacts, loadRunDetail, loadSuiteSummary, loadVerifiedExperimentDecisionSnapshot, } from "../orchestrator/index.js";
8
+ import { compareArtifactPreviews, loadArtifactPreview } from "./artifacts.js";
9
+ const LOOPBACK_HOST = "127.0.0.1";
10
+ const ASSET_ROOT = fileURLToPath(new URL("../../viewer/", import.meta.url));
11
+ const opaqueId = (runsRoot, path) => Buffer.from(relative(resolve(runsRoot), resolve(path))).toString("base64url");
12
+ const displayPath = (runsRoot, path) => {
13
+ const value = relative(resolve(runsRoot), resolve(path));
14
+ return value.split(sep).join("/");
15
+ };
16
+ const runStatus = (run) => {
17
+ if (run.exitReason && run.exitReason !== "done")
18
+ return "error";
19
+ if (run.casePassed === true)
20
+ return "passed";
21
+ if (run.casePassed === false)
22
+ return "failed";
23
+ return "ungraded";
24
+ };
25
+ const normalizeStatus = (status) => {
26
+ if (status === "passed" || status === "failed" || status === "running" || status === "aborted") {
27
+ return status;
28
+ }
29
+ return "ungraded";
30
+ };
31
+ const buildSnapshot = async (runsRoot, options) => {
32
+ const absoluteRunsRoot = resolve(runsRoot);
33
+ const [listedRuns, listedSuites, listedExperiments] = await Promise.all([
34
+ listRuns(absoluteRunsRoot),
35
+ listSuiteRuns(absoluteRunsRoot),
36
+ listExperimentRuns(absoluteRunsRoot),
37
+ ]);
38
+ const runs = listedRuns
39
+ .filter((run) => !options.caseFilter || run.caseSlug === options.caseFilter)
40
+ .map((run) => ({
41
+ id: opaqueId(absoluteRunsRoot, run.runDir),
42
+ kind: "run",
43
+ status: runStatus(run),
44
+ caseId: run.caseSlug,
45
+ driver: run.driverName,
46
+ agentId: run.driverAgentId,
47
+ startedAt: run.startedAt,
48
+ durationMs: run.durationMs,
49
+ timeToFirstActionMs: run.timeToFirstActionMs,
50
+ timeToFirstMutationMs: run.timeToFirstMutationMs,
51
+ timeToFirstDurableMutationMs: run.timeToFirstDurableMutationMs,
52
+ driverMetrics: run.driverMetrics,
53
+ subagentCount: run.subagentCount,
54
+ score: run.caseScore,
55
+ assertions: { passed: run.assertionPassed, total: run.assertionTotal },
56
+ path: displayPath(absoluteRunsRoot, run.runDir),
57
+ }));
58
+ const runIdsByPath = new Map(listedRuns.map((run) => [resolve(run.runDir), opaqueId(absoluteRunsRoot, run.runDir)]));
59
+ const suites = listedSuites.map((suite) => ({
60
+ id: opaqueId(absoluteRunsRoot, suite.suiteDir),
61
+ kind: "suite",
62
+ status: normalizeStatus(suite.status),
63
+ suiteId: suite.suiteId,
64
+ startedAt: suite.startedAt,
65
+ endedAt: suite.endedAt,
66
+ concurrency: suite.concurrency,
67
+ ...(suite.profileId ? { profileId: suite.profileId } : {}),
68
+ items: suite.items.map((item) => ({
69
+ caseId: item.caseId,
70
+ canonicalCaseId: item.canonicalCaseId,
71
+ status: item.status,
72
+ exitReason: item.exitReason,
73
+ casePassed: item.casePassed,
74
+ runId: item.runDir
75
+ ? (runIdsByPath.get(resolve(suite.suiteDir, item.runDir)) ?? null)
76
+ : null,
77
+ ...(item.errorMessage ? { errorMessage: item.errorMessage } : {}),
78
+ })),
79
+ path: displayPath(absoluteRunsRoot, suite.suiteDir),
80
+ }));
81
+ const experiments = listedExperiments.map((experiment) => ({
82
+ id: opaqueId(absoluteRunsRoot, experiment.experimentDir),
83
+ kind: "experiment",
84
+ status: normalizeStatus(experiment.status),
85
+ experimentId: experiment.experimentId,
86
+ campaignId: experiment.campaignId,
87
+ mode: experiment.mode,
88
+ startedAt: experiment.startedAt,
89
+ endedAt: experiment.endedAt,
90
+ activeTimeMs: experiment.activeTimeMs,
91
+ candidateCount: experiment.candidates.length,
92
+ championCandidateId: experiment.championCandidateId ?? null,
93
+ budget: {
94
+ metricCalls: experiment.budgetUsage.metricCalls,
95
+ judgeCalls: experiment.budgetUsage.judgeCalls,
96
+ proposalCalls: experiment.budgetUsage.proposalCalls,
97
+ costUsd: experiment.budgetUsage.costUsd,
98
+ },
99
+ evaluations: experiment.evaluations.map((evaluation) => ({
100
+ candidateId: evaluation.candidateId,
101
+ profileId: evaluation.profileId,
102
+ split: evaluation.split,
103
+ passRate: evaluation.passRate,
104
+ metrics: evaluation.metrics,
105
+ metricDefinitions: evaluation.metricDefinitions ?? {},
106
+ failedCases: evaluation.failedCases,
107
+ })),
108
+ path: displayPath(absoluteRunsRoot, experiment.experimentDir),
109
+ }));
110
+ const initialPath = options.initialPath ? resolve(options.initialPath) : null;
111
+ const initialKind = options.initialKind;
112
+ const candidates = [
113
+ ...runs,
114
+ ...suites,
115
+ ...experiments,
116
+ ];
117
+ let initialEntry;
118
+ if (initialPath) {
119
+ initialEntry = candidates.find((entry) => (!initialKind || entry.kind === initialKind) &&
120
+ resolve(absoluteRunsRoot, entry.path) === initialPath);
121
+ }
122
+ else if (initialKind) {
123
+ initialEntry = candidates.find((entry) => entry.kind === initialKind);
124
+ }
125
+ return {
126
+ generatedAt: new Date().toISOString(),
127
+ runsRoot: absoluteRunsRoot,
128
+ initial: initialEntry ? { kind: initialEntry.kind, id: initialEntry.id } : null,
129
+ runs,
130
+ suites,
131
+ experiments,
132
+ };
133
+ };
134
+ const securityHeaders = {
135
+ "Content-Security-Policy": "default-src 'self'; base-uri 'none'; connect-src 'self'; form-action 'none'; frame-ancestors 'none'; img-src 'self' data:; object-src 'none'; script-src 'self'; style-src 'self'",
136
+ "Cross-Origin-Opener-Policy": "same-origin",
137
+ "Cross-Origin-Resource-Policy": "same-origin",
138
+ "Permissions-Policy": "camera=(), geolocation=(), microphone=()",
139
+ "Referrer-Policy": "no-referrer",
140
+ "X-Content-Type-Options": "nosniff",
141
+ "X-Frame-Options": "DENY",
142
+ };
143
+ const send = (request, response, status, contentType, body, cacheControl = "no-store") => {
144
+ const bytes = Buffer.isBuffer(body) ? body : Buffer.from(body);
145
+ response.writeHead(status, {
146
+ ...securityHeaders,
147
+ "Cache-Control": cacheControl,
148
+ "Content-Length": bytes.length,
149
+ "Content-Type": contentType,
150
+ });
151
+ response.end(request.method === "HEAD" ? undefined : bytes);
152
+ };
153
+ const sendJson = (request, response, status, value) => {
154
+ send(request, response, status, "application/json; charset=utf-8", JSON.stringify(value));
155
+ };
156
+ const findRunById = async (runsRoot, id) => {
157
+ const runs = await listRuns(runsRoot);
158
+ return runs.find((run) => opaqueId(runsRoot, run.runDir) === id) ?? null;
159
+ };
160
+ const findRunsById = async (runsRoot, ids) => {
161
+ const runs = await listRuns(runsRoot);
162
+ const found = ids.map((id) => runs.find((run) => opaqueId(runsRoot, run.runDir) === id) ?? null);
163
+ return found.every((run) => run !== null) ? found : null;
164
+ };
165
+ const findSuiteById = async (runsRoot, id) => {
166
+ const suites = await listSuiteRuns(runsRoot);
167
+ return suites.find((suite) => opaqueId(runsRoot, suite.suiteDir) === id) ?? null;
168
+ };
169
+ const findSuitesById = async (runsRoot, ids) => {
170
+ const suites = await listSuiteRuns(runsRoot);
171
+ const found = ids.map((id) => suites.find((suite) => opaqueId(runsRoot, suite.suiteDir) === id) ?? null);
172
+ return found.every((suite) => suite !== null)
173
+ ? found
174
+ : null;
175
+ };
176
+ const findExperimentById = async (runsRoot, id) => {
177
+ const experiments = await listExperimentRuns(runsRoot);
178
+ return (experiments.find((experiment) => opaqueId(runsRoot, experiment.experimentDir) === id) ?? null);
179
+ };
180
+ const artifactPreview = async (run, path) => {
181
+ const [detail, indexed] = await Promise.all([
182
+ loadRunDetail(run.runDir, { maxArtifacts: 2_000 }),
183
+ loadRunArtifacts(run.runDir),
184
+ ]);
185
+ return loadArtifactPreview(run.runDir, indexed, detail.artifacts, path);
186
+ };
187
+ const publicRunDetail = async (runsRoot, runDir) => ({
188
+ ...(await loadRunDetail(runDir, { maxArtifacts: 2_000 })),
189
+ runDir: displayPath(runsRoot, runDir),
190
+ });
191
+ const requiredPair = (url) => {
192
+ const before = url.searchParams.get("before");
193
+ const after = url.searchParams.get("after");
194
+ return before && after && before !== after ? [before, after] : null;
195
+ };
196
+ const isLoopbackHost = (host) => host === LOOPBACK_HOST || host?.startsWith(`${LOOPBACK_HOST}:`) === true;
197
+ const handleRunComparison = async ({ request, response, url, runsRoot, }) => {
198
+ const pair = requiredPair(url);
199
+ if (!pair) {
200
+ sendJson(request, response, 400, { error: "two distinct run ids are required" });
201
+ return;
202
+ }
203
+ const runs = await findRunsById(runsRoot, pair);
204
+ if (!runs) {
205
+ sendJson(request, response, 404, { error: "run not found" });
206
+ return;
207
+ }
208
+ const [before, after] = runs;
209
+ if (!before || !after)
210
+ throw new Error("run pair resolution failed");
211
+ const [comparison, beforeDetail, afterDetail] = await Promise.all([
212
+ compareRuns({ pathA: before.runDir, pathB: after.runDir }),
213
+ publicRunDetail(runsRoot, before.runDir),
214
+ publicRunDetail(runsRoot, after.runDir),
215
+ ]);
216
+ sendJson(request, response, 200, {
217
+ kind: "run",
218
+ comparison: {
219
+ ...comparison,
220
+ pathA: displayPath(runsRoot, before.runDir),
221
+ pathB: displayPath(runsRoot, after.runDir),
222
+ },
223
+ before: beforeDetail,
224
+ after: afterDetail,
225
+ });
226
+ };
227
+ const handleSuiteComparison = async ({ request, response, url, runsRoot, }) => {
228
+ const pair = requiredPair(url);
229
+ if (!pair) {
230
+ sendJson(request, response, 400, { error: "two distinct suite ids are required" });
231
+ return;
232
+ }
233
+ const suites = await findSuitesById(runsRoot, pair);
234
+ if (!suites) {
235
+ sendJson(request, response, 404, { error: "suite not found" });
236
+ return;
237
+ }
238
+ const [before, after] = suites;
239
+ if (!before || !after)
240
+ throw new Error("suite pair resolution failed");
241
+ const [comparison, beforeSummary, afterSummary] = await Promise.all([
242
+ compareSuiteRuns(before.suiteDir, after.suiteDir),
243
+ loadSuiteSummary(before.suiteDir),
244
+ loadSuiteSummary(after.suiteDir),
245
+ ]);
246
+ sendJson(request, response, 200, {
247
+ kind: "suite",
248
+ comparison: {
249
+ ...comparison,
250
+ pathA: displayPath(runsRoot, before.suiteDir),
251
+ pathB: displayPath(runsRoot, after.suiteDir),
252
+ },
253
+ before: beforeSummary,
254
+ after: afterSummary,
255
+ });
256
+ };
257
+ const handleArtifactComparison = async ({ request, response, url, runsRoot, }) => {
258
+ const pair = requiredPair(url);
259
+ const path = url.searchParams.get("path");
260
+ if (!pair || !path) {
261
+ sendJson(request, response, 400, {
262
+ error: "two distinct run ids and an artifact path are required",
263
+ });
264
+ return;
265
+ }
266
+ const runs = await findRunsById(runsRoot, pair);
267
+ if (!runs) {
268
+ sendJson(request, response, 404, { error: "run not found" });
269
+ return;
270
+ }
271
+ const [before, after] = runs;
272
+ if (!before || !after)
273
+ throw new Error("artifact run pair resolution failed");
274
+ const [beforePreview, afterPreview] = await Promise.all([
275
+ artifactPreview(before, path),
276
+ artifactPreview(after, path),
277
+ ]);
278
+ sendJson(request, response, 200, compareArtifactPreviews(path, beforePreview, afterPreview));
279
+ };
280
+ const handleComparisonRoute = async (context) => {
281
+ if (context.url.pathname === "/api/compare/runs") {
282
+ await handleRunComparison(context);
283
+ return true;
284
+ }
285
+ if (context.url.pathname === "/api/compare/suites") {
286
+ await handleSuiteComparison(context);
287
+ return true;
288
+ }
289
+ if (context.url.pathname === "/api/compare/artifacts") {
290
+ await handleArtifactComparison(context);
291
+ return true;
292
+ }
293
+ return false;
294
+ };
295
+ const handleArtifactRoute = async ({ request, response, url, runsRoot, }) => {
296
+ if (url.pathname !== "/api/artifact")
297
+ return false;
298
+ const runId = url.searchParams.get("run");
299
+ const path = url.searchParams.get("path");
300
+ if (!runId || !path) {
301
+ sendJson(request, response, 400, { error: "a run id and artifact path are required" });
302
+ return true;
303
+ }
304
+ const run = await findRunById(runsRoot, runId);
305
+ if (!run) {
306
+ sendJson(request, response, 404, { error: "run not found" });
307
+ return true;
308
+ }
309
+ const preview = await artifactPreview(run, path);
310
+ sendJson(request, response, preview.exists ? 200 : 404, preview);
311
+ return true;
312
+ };
313
+ const experimentDetail = async (runsRoot, experiment) => {
314
+ const [candidateResult, decisionResult] = await Promise.allSettled([
315
+ loadExperimentCandidates(experiment.experimentDir),
316
+ loadVerifiedExperimentDecisionSnapshot(experiment.experimentDir),
317
+ ]);
318
+ const integrityErrors = [candidateResult, decisionResult].flatMap((result) => result.status === "rejected"
319
+ ? [result.reason instanceof Error ? result.reason.message : String(result.reason)]
320
+ : []);
321
+ return {
322
+ experiment: {
323
+ experimentId: experiment.experimentId,
324
+ campaignId: experiment.campaignId,
325
+ mode: experiment.mode,
326
+ evaluationKind: experiment.evaluationKind,
327
+ status: experiment.status,
328
+ startedAt: experiment.startedAt,
329
+ endedAt: experiment.endedAt,
330
+ activeTimeMs: experiment.activeTimeMs,
331
+ championCandidateId: experiment.championCandidateId ?? null,
332
+ errorMessage: experiment.errorMessage ?? null,
333
+ selection: experiment.selection ?? null,
334
+ budgetUsage: experiment.budgetUsage,
335
+ evaluations: experiment.evaluations.map((evaluation) => ({
336
+ candidateId: evaluation.candidateId,
337
+ profileId: evaluation.profileId,
338
+ split: evaluation.split,
339
+ repetitions: evaluation.repetitions,
340
+ passRate: evaluation.passRate,
341
+ casePassRates: evaluation.casePassRates,
342
+ metrics: evaluation.metrics,
343
+ metricDefinitions: evaluation.metricDefinitions ?? {},
344
+ costUsd: evaluation.costUsd ?? null,
345
+ failedCases: evaluation.failedCases,
346
+ })),
347
+ },
348
+ candidates: candidateResult.status === "fulfilled"
349
+ ? candidateResult.value.map((candidate) => ({
350
+ id: candidate.id,
351
+ parentIds: candidate.parentIds,
352
+ createdAt: candidate.createdAt,
353
+ proposer: candidate.proposer,
354
+ sourceBytes: candidate.sourceBytes,
355
+ rationale: candidate.rationale ?? null,
356
+ components: Object.keys(candidate.components).sort(),
357
+ }))
358
+ : [],
359
+ decision: decisionResult.status === "fulfilled"
360
+ ? {
361
+ ...decisionResult.value.report,
362
+ experimentDir: displayPath(runsRoot, experiment.experimentDir),
363
+ }
364
+ : null,
365
+ integrity: {
366
+ verified: integrityErrors.length === 0,
367
+ errors: integrityErrors,
368
+ },
369
+ };
370
+ };
371
+ const handleDetailRoute = async ({ request, response, url, runsRoot, }) => {
372
+ if (url.pathname.startsWith("/api/suites/")) {
373
+ const suite = await findSuiteById(runsRoot, url.pathname.slice("/api/suites/".length));
374
+ if (!suite)
375
+ sendJson(request, response, 404, { error: "suite not found" });
376
+ else
377
+ sendJson(request, response, 200, {
378
+ suite: {
379
+ ...suite,
380
+ suiteDir: displayPath(runsRoot, suite.suiteDir),
381
+ },
382
+ summary: await loadSuiteSummary(suite.suiteDir),
383
+ });
384
+ return true;
385
+ }
386
+ if (url.pathname.startsWith("/api/experiments/")) {
387
+ const experiment = await findExperimentById(runsRoot, url.pathname.slice("/api/experiments/".length));
388
+ if (!experiment)
389
+ sendJson(request, response, 404, { error: "experiment not found" });
390
+ else
391
+ sendJson(request, response, 200, await experimentDetail(runsRoot, experiment));
392
+ return true;
393
+ }
394
+ if (url.pathname.startsWith("/api/runs/")) {
395
+ const run = await findRunById(runsRoot, url.pathname.slice("/api/runs/".length));
396
+ if (!run)
397
+ sendJson(request, response, 404, { error: "run not found" });
398
+ else
399
+ sendJson(request, response, 200, await publicRunDetail(runsRoot, run.runDir));
400
+ return true;
401
+ }
402
+ return false;
403
+ };
404
+ const requestHandler = (assets, runsRoot, options) => async (request, response) => {
405
+ if (!isLoopbackHost(request.headers.host)) {
406
+ sendJson(request, response, 421, { error: "untrusted host" });
407
+ return;
408
+ }
409
+ if (request.method !== "GET" && request.method !== "HEAD") {
410
+ sendJson(request, response, 405, { error: "method not allowed" });
411
+ return;
412
+ }
413
+ const url = new URL(request.url ?? "/", `http://${LOOPBACK_HOST}`);
414
+ if (url.pathname === "/" || url.pathname === "/index.html") {
415
+ send(request, response, 200, "text/html; charset=utf-8", assets.html);
416
+ return;
417
+ }
418
+ const asset = assets.files.get(url.pathname);
419
+ if (asset) {
420
+ send(request, response, 200, asset.contentType, asset.body, "no-cache");
421
+ return;
422
+ }
423
+ if (url.pathname === "/api/snapshot") {
424
+ sendJson(request, response, 200, await buildSnapshot(runsRoot, options));
425
+ return;
426
+ }
427
+ const context = { request, response, url, runsRoot };
428
+ if (await handleComparisonRoute(context))
429
+ return;
430
+ if (await handleArtifactRoute(context))
431
+ return;
432
+ if (await handleDetailRoute(context))
433
+ return;
434
+ if (url.pathname === "/health") {
435
+ sendJson(request, response, 200, { ok: true });
436
+ return;
437
+ }
438
+ sendJson(request, response, 404, { error: "not found" });
439
+ };
440
+ const loadAssets = async () => {
441
+ const htmlPath = resolve(ASSET_ROOT, "index.html");
442
+ const definitions = [
443
+ ["/assets/app.css", "app.css", "text/css; charset=utf-8"],
444
+ ["/assets/app.js", "app.js", "text/javascript; charset=utf-8"],
445
+ ["/assets/artifact-view.js", "artifact-view.js", "text/javascript; charset=utf-8"],
446
+ ["/assets/charts.js", "charts.js", "text/javascript; charset=utf-8"],
447
+ ["/assets/detail.js", "detail.js", "text/javascript; charset=utf-8"],
448
+ ["/assets/format.js", "format.js", "text/javascript; charset=utf-8"],
449
+ ];
450
+ const paths = [htmlPath, ...definitions.map((definition) => resolve(ASSET_ROOT, definition[1]))];
451
+ for (const path of paths) {
452
+ if (!existsSync(path))
453
+ throw new Error(`Lux preview asset is missing: ${basename(path)}`);
454
+ }
455
+ const [html, ...bodies] = await Promise.all(paths.map((path) => readFile(path)));
456
+ if (!html)
457
+ throw new Error("Lux preview index is empty");
458
+ const files = new Map(definitions.map(([url, , contentType], index) => {
459
+ const body = bodies[index];
460
+ if (!body)
461
+ throw new Error(`Lux preview asset is empty: ${url}`);
462
+ return [url, { body, contentType }];
463
+ }));
464
+ return { html, files };
465
+ };
466
+ const listen = (server, port) => new Promise((resolveListen, reject) => {
467
+ const onError = (error) => {
468
+ server.off("listening", onListening);
469
+ reject(error);
470
+ };
471
+ const onListening = () => {
472
+ server.off("error", onError);
473
+ resolveListen();
474
+ };
475
+ server.once("error", onError);
476
+ server.once("listening", onListening);
477
+ server.listen(port, LOOPBACK_HOST);
478
+ });
479
+ export const startPreviewServer = async (options) => {
480
+ const runsRoot = resolve(options.runsRoot);
481
+ const assets = await loadAssets();
482
+ const server = createServer((request, response) => {
483
+ void requestHandler(assets, runsRoot, options)(request, response).catch((error) => {
484
+ const message = error instanceof Error ? error.message : String(error);
485
+ if (!response.headersSent)
486
+ sendJson(request, response, 500, { error: message });
487
+ else
488
+ response.destroy();
489
+ });
490
+ });
491
+ await listen(server, options.port ?? 0);
492
+ const address = server.address();
493
+ if (!address || typeof address === "string") {
494
+ server.close();
495
+ throw new Error("Lux preview server did not receive a TCP address");
496
+ }
497
+ let closePromise = null;
498
+ const close = () => {
499
+ closePromise ??= new Promise((resolveClose, reject) => {
500
+ server.close((error) => {
501
+ options.signal?.removeEventListener("abort", onAbort);
502
+ if (error)
503
+ reject(error);
504
+ else
505
+ resolveClose();
506
+ });
507
+ });
508
+ return closePromise;
509
+ };
510
+ const onAbort = () => {
511
+ void close();
512
+ };
513
+ if (options.signal?.aborted)
514
+ onAbort();
515
+ else
516
+ options.signal?.addEventListener("abort", onAbort, { once: true });
517
+ const closed = new Promise((resolveClosed) => {
518
+ server.once("close", resolveClosed);
519
+ });
520
+ return {
521
+ url: `http://${LOOPBACK_HOST}:${address.port}`,
522
+ closed,
523
+ close,
524
+ };
525
+ };
526
+ export const openPreviewUrl = async (url) => {
527
+ let launcher = { command: "xdg-open", args: [url] };
528
+ if (process.platform === "darwin") {
529
+ launcher = { command: "open", args: [url] };
530
+ }
531
+ else if (process.platform === "win32") {
532
+ launcher = { command: "cmd.exe", args: ["/d", "/s", "/c", "start", "", url] };
533
+ }
534
+ const result = await exec(launcher.command, launcher.args, {
535
+ timeoutMs: 5_000,
536
+ maxBuffer: 2_000,
537
+ });
538
+ if (result.exitCode !== 0 || result.timedOut) {
539
+ throw new Error(result.stderr.trim() || `browser launcher exited ${result.exitCode ?? "early"}`);
540
+ }
541
+ };
542
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/previewer/server.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@prismatic-io/lux",
3
- "version": "0.0.1",
3
+ "version": "0.0.2-preview.11",
4
4
  "description": "Coding-agent evaluation and improvement with deterministic assertions, optional LLM judges, and first-class human-in-the-loop runs.",
5
5
  "license": "MIT",
6
6
  "homepage": "https://github.com/prismatic-io/lux",
@@ -57,6 +57,7 @@
57
57
  "lib",
58
58
  "skills",
59
59
  "src",
60
+ "viewer",
60
61
  "!**/*.test.ts",
61
62
  "!**/test-helpers.ts",
62
63
  "!src/**/fixtures/**"
@@ -73,7 +74,6 @@
73
74
  "@modelcontextprotocol/sdk": "^1.30.0",
74
75
  "@vscode/windows-process-tree": "0.8.0",
75
76
  "commander": "^15.0.0",
76
- "js-yaml": "^5.2.2",
77
77
  "oxc-parser": "^0.142.0",
78
78
  "tempy": "^3.2.0",
79
79
  "tinyexec": "1.2.4",
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: lux
3
- description: Author, validate, run, inspect, compare, and improve coding-agent evaluations with the Lux CLI. Use when creating Lux cases or campaigns, choosing assertions/personas/drivers, diagnosing eval failures, comparing runs, or running Lux experiments.
3
+ description: Author, validate, run, inspect, compare, and improve coding-agent evaluations with the Lux CLI. Use when creating or reviewing Lux cases, custom assertions, lifecycle fixtures, driver or harness configuration, campaigns, grader annotations, diagnosing eval failures, comparing runs, or running and promoting Lux experiments.
4
4
  ---
5
5
 
6
6
  # Lux
@@ -16,7 +16,7 @@ only for qualities that artifacts and commands cannot establish.
16
16
  2. If Lux is not initialized, run `npm exec -- lux init` for ordinary evals or
17
17
  `npm exec -- lux init --experiment` for an improvement campaign.
18
18
  3. Read [references/eval-authoring.md](references/eval-authoring.md) before
19
- authoring or reviewing a case.
19
+ authoring or reviewing a case, assertion plugin, or lifecycle fixture.
20
20
  4. Read [references/cli.md](references/cli.md) before running, diagnosing,
21
21
  comparing, or promoting results.
22
22
  5. Run `npm exec -- lux doctor` before model calls. Treat its errors as
@@ -40,6 +40,7 @@ only for qualities that artifacts and commands cannot establish.
40
40
 
41
41
  ```bash
42
42
  npm exec -- lux doctor
43
+ npm exec -- lux run <case-or-filter> --list
43
44
  npm exec -- lux run <case-or-filter> --loop 3
44
45
  npm exec -- lux view <run-or-suite>
45
46
  ```
@@ -50,7 +51,8 @@ before changing the case. Separate subject failure from harness failure:
50
51
  - Subject failure: the agent misunderstood, asked poorly, used the wrong tools,
51
52
  or left incorrect artifacts.
52
53
  - Harness failure: the prompt was underspecified, the persona lacked a needed
53
- fact, an assertion measured a proxy, or the judge criterion was ambiguous.
54
+ fact, a fixture or driver failed, an assertion measured a proxy, or the
55
+ judge criterion was ambiguous.
54
56
 
55
57
  Do not weaken a valid assertion merely to make a run pass.
56
58
 
@@ -78,6 +80,8 @@ Never edit a materialized candidate or managed experiment record by hand.
78
80
  behavior.
79
81
  - Do not use only `run-succeeded` for a case that claims to verify a concrete
80
82
  result.
83
+ - Do not invoke bare `lux`; it displays help. Use the explicit `lux run` verb
84
+ and narrow by case, path, or tag before any model call.
81
85
  - Do not let train examples leak into validation or test splits.
82
86
  - Do not combine evidence across changed models, harnesses, cases, or subjects;
83
87
  Lux identity checks exist to prevent that.