@eigenpal/cli 0.6.3 → 0.6.4

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @eigenpal/cli
 
+## 0.6.4
+
+### Patch Changes
+
+- c3486a5: Fix agent git cutover QA findings: dashboard runs now navigate to the created run, inbound email aliases preserve mixed-case organization qualifiers, sandbox source materializes under `/workspace/agent`, run artifact downloads use direct paths like `/files/eigenpal.lock`, wait-for-completion responses include source provenance, and CLI wait/watch commands exit nonzero for failed or cancelled runs.
+
 ## 0.6.2
 
 ### Patch Changes

package/dist/cli.js

@@ -186320,7 +186320,7 @@ import { fileURLToPath as fileURLToPath6 } from "url";
 // package.json
 var package_default = {
   name: "@eigenpal/cli",
-  version: "0.6.3",
+  version: "0.6.4",
   description: "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
   keywords: [
     "eigenpal",
@@ -188821,7 +188821,7 @@ function registerRunCommands(agent) {
   listRunsCmd.action(action(listRunsTarget));
   addJsonFlag(withBaseUrl(runs.command("get <run-id>"))).description("Get one agent run.").option("--include <parts>", "Comma-separated extra parts: feedback,expected,files,trace,issues", "feedback").action(action(getRun));
   addJsonFlag(withBaseUrl(runs.command("rerun <run-id>"))).description("Create a new run from a previous run's stored input snapshot.").option("--wait", "Poll until the rerun reaches a terminal status").option("--interval <seconds>", "Polling interval in seconds", intArg, 2).option("--max-wait <seconds>", "Maximum wait before exiting 2", intArg, 1800).action(action(rerunRun));
-  withBaseUrl(runs.command("pull <run-id>")).description("Download run feedback, expected artifacts, files, and metadata.").option("--out <dir>", "Output directory").option("--include <parts>", "Comma-separated parts: feedback,expected,files,output,input,metadata,issues,trace,all", "feedback,expected").option("--json", "Output a JSON summary of written artifacts").action(action(pullRun));
+  withBaseUrl(runs.command("pull <run-id>")).description("Download run feedback, expected artifacts, files, and metadata.").option("--out <dir>", "Output directory").option("--include <parts>", "Comma-separated parts: feedback,expected,files,output,input,metadata,issues,trace,lockfile,all", "feedback,expected").option("--json", "Output a JSON summary of written artifacts").action(action(pullRun));
   addJsonFlag(withBaseUrl(runs.command("compare <reference-run-id> <run-id>"))).description("Compare one run against another run. PDF/DOCX text comparison uses pdftotext/python3 and reports byte fallbacks.").option("--baseline", "Compare actual outputs from both runs instead of expected artifacts").option("--out <dir>", "Write comparison artifacts to this directory").option("--normalize-dates", "Normalize YYYYMMDD and YYYY-MM-DD tokens in filenames/text").option("--fail-on-diff", "Exit 1 when comparison status is fail").action(action(compareRun));
   const artifacts = runs.command("artifacts").description("Inspect run artifact inventory.").action(() => {
     process.stderr.write("`eigenpal agents runs artifacts` requires a subcommand. Run `eigenpal agents runs artifacts --help`.\n");
@@ -189145,10 +189145,14 @@ async function runExecution(agentId, opts) {
     });
   }
   const runId = String(payload.runId ?? "");
+  let waitedForTerminalRun = false;
   if (opts.wait && runId) {
     payload = await pollRun(client, runId, opts.interval ?? 2, opts.maxWait ?? 1800);
+    waitedForTerminalRun = true;
   }
   renderRunPayload(payload, opts);
+  if (waitedForTerminalRun)
+    setExitCodeForFailedTerminalRun(payload);
 }
 async function runExample(agentId, opts) {
   const client = buildClient(opts);
@@ -189159,7 +189163,9 @@ async function runExample(agentId, opts) {
   const runId = started.runs?.[0]?.runId;
   if (opts.wait && runId) {
     const payload2 = await pollRun(client, runId, opts.interval, opts.maxWait);
-    return renderRunPayload(payload2, opts);
+    renderRunPayload(payload2, opts);
+    setExitCodeForFailedTerminalRun(payload2);
+    return;
   }
   const payload = {
     runId,
@@ -189184,7 +189190,9 @@ async function rerunRun(executionId, opts) {
   const rerunId = String(payload.runId ?? "");
   if (opts.wait && rerunId) {
     payload = await pollRun(client, rerunId, opts.interval, opts.maxWait);
-    return renderRunPayload(payload, opts);
+    renderRunPayload(payload, opts);
+    setExitCodeForFailedTerminalRun(payload);
+    return;
   }
   if (opts.json)
     return printJson(payload);
@@ -189260,6 +189268,13 @@ async function pullRun(executionId, opts) {
     else
       skipped.push("trace.jsonl");
   }
+  if (include.has("files") || include.has("lockfile")) {
+    const file2 = await writeDiagnosticFile(client, executionId, out, "lockfile", "eigenpal.lock", run.lockfileFiles);
+    if (file2)
+      written.push(file2);
+    else
+      skipped.push("eigenpal.lock");
+  }
   const summary = {
     runId: executionId,
     out,
@@ -189278,7 +189293,7 @@ async function pullRun(executionId, opts) {
 async function listRunArtifacts(executionId, opts) {
   const client = buildClient(opts);
   const payload = await client.get(`/api/v1/agents/runs/${encodeURIComponent(executionId)}`, {
-    include: "expected,files,input,output,issues,trace,metadata"
+    include: "expected,files,input,output,issues,trace,lockfile,metadata"
   });
   const run = payload.run;
   if (!run)
@@ -189289,6 +189304,7 @@ async function listRunArtifacts(executionId, opts) {
   console.log(table(artifacts, [
     { key: "kind", header: "KIND" },
     { key: "name", header: "NAME" },
+    { key: "path", header: "PATH" },
     { key: "present", header: "PRESENT" }
   ]));
 }
@@ -189482,6 +189498,7 @@ async function watchRunCommand(executionId, opts) {
   const client = buildClient(opts);
   const payload = await pollRun(client, executionId, opts.interval, opts.maxWait);
   renderRunPayload(payload, opts);
+  setExitCodeForFailedTerminalRun(payload);
 }
 async function cancelRun(executionId, opts) {
   if (!(opts.yes || process.stdin.isTTY))
@@ -189913,12 +189930,12 @@ async function writeDiagnosticFile(client, executionId, out, kind, filename, fil
   const exists = rows.some((file2) => String(file2.name ?? "") === filename);
   if (!exists)
     return null;
-  const response = await client.getStream(`/api/v1/agents/runs/${encodeURIComponent(executionId)}/files/${kind}/${filename}`);
+  const response = await client.getStream(`/api/v1/agents/runs/${encodeURIComponent(executionId)}/files/${encodeRunArtifactPath(kind === "issues" || kind === "trace" || kind === "lockfile" ? filename : `${kind}/${filename}`)}`);
   await fs.writeFile(path2.join(out, filename), Buffer.from(await response.arrayBuffer()));
   return filename;
 }
 async function downloadTraceText(client, executionId) {
-  const response = await client.getStream(`/api/v1/agents/runs/${encodeURIComponent(executionId)}/files/trace/trace.jsonl`);
+  const response = await client.getStream(`/api/v1/agents/runs/${encodeURIComponent(executionId)}/files/trace.jsonl`);
   return Buffer.from(await response.arrayBuffer()).toString("utf-8");
 }
 function diffJson(expected, actual, basePath = "$") {
@@ -189965,27 +189982,36 @@ function fileNames(files) {
 }
 function runArtifactInventory(run) {
   const rows = [
-    { kind: "metadata", name: "run.json", present: "yes" }
+    { kind: "metadata", name: "run.json", path: "run.json", present: "yes" }
   ];
-  if (run.inputJson != null)
-    rows.push({ kind: "input", name: "input.json", present: "yes" });
-  if (run.metadata != null)
-    rows.push({ kind: "metadata", name: "metadata.json", present: "yes" });
-  if (run.expected != null)
-    rows.push({ kind: "expected", name: "expected.json", present: "yes" });
-  for (const name of fileNames(run.inputFiles))
-    rows.push({ kind: "input", name, present: "yes" });
+  if (run.inputJson != null) {
+    rows.push({ kind: "input", name: "input.json", path: "input.json", present: "yes" });
+  }
+  if (run.metadata != null) {
+    rows.push({ kind: "metadata", name: "metadata.json", path: "metadata.json", present: "yes" });
+  }
+  if (run.expected != null) {
+    rows.push({ kind: "expected", name: "expected.json", path: "expected.json", present: "yes" });
+  }
+  for (const name of fileNames(run.inputFiles)) {
+    rows.push({ kind: "input", name, path: `input/${name}`, present: "yes" });
+  }
   for (const name of fileNames(run.resultFiles).filter((name2) => name2 !== "issues.md" && name2 !== "trace.jsonl")) {
-    rows.push({ kind: "output", name, present: "yes" });
+    rows.push({ kind: "output", name, path: `output/${name}`, present: "yes" });
   }
   for (const name of fileNames(run.expectedFiles)) {
-    rows.push({ kind: "expected", name, present: "yes" });
+    rows.push({ kind: "expected", name, path: `expected/${name}`, present: "yes" });
+  }
+  for (const name of fileNames(run.issueFiles)) {
+    rows.push({ kind: "issues", name, path: name, present: "yes" });
+  }
+  for (const name of fileNames(run.traceFiles)) {
+    rows.push({ kind: "trace", name, path: name, present: "yes" });
   }
-  for (const name of fileNames(run.issueFiles))
-    rows.push({ kind: "issues", name, present: "yes" });
-  for (const name of fileNames(run.traceFiles))
-    rows.push({ kind: "trace", name, present: "yes" });
-  return rows.sort((a, b2) => `${a.kind}/${a.name}`.localeCompare(`${b2.kind}/${b2.name}`));
+  for (const name of fileNames(run.lockfileFiles)) {
+    rows.push({ kind: "lockfile", name, path: name, present: "yes" });
+  }
+  return rows.sort((a, b2) => a.path.localeCompare(b2.path));
 }
 async function buildAgentFileDiff(agentId, remotePath, localPath, opts) {
   const client = buildClient(opts);
@@ -190120,6 +190146,9 @@ function runFileUrl(side, name) {
   const filename = encodeURIComponent(name);
   return side.kind === "expected" ? `/api/v1/agents/runs/${runId}/expected/${filename}` : `/api/v1/agents/runs/${runId}/files/output/${filename}`;
 }
+function encodeRunArtifactPath(artifactPath) {
+  return artifactPath.split("/").map(encodeURIComponent).join("/");
+}
 async function downloadStreamToFile(client, url2, target) {
   await fs.mkdir(path2.dirname(target), { recursive: true });
   const response = await client.getStream(url2);
@@ -190240,6 +190269,12 @@ function renderRunPayload(payload, opts) {
     return printJson(payload);
   success2(`Run ${run.id} is ${run.status}`);
 }
+function setExitCodeForFailedTerminalRun(payload) {
+  const status = payload.run?.status;
+  if (status === "failed" || status === "cancelled") {
+    process.exitCode = 1;
+  }
+}
 function renderGeneric(payload, opts, message) {
   if (opts.json)
     return printJson(payload);

package/dist/skill/reference/cli/agents.md

@@ -809,12 +809,12 @@ Download run feedback, expected artifacts, files, and metadata.
 
 ### Options
 
-| Flag                | Required | Default               | Description                                                                           |
-| ------------------- | -------- | --------------------- | ------------------------------------------------------------------------------------- |
-| `--base-url <url>`  | no       |                       | Server base URL                                                                       |
-| `--out <dir>`       | no       |                       | Output directory                                                                      |
-| `--include <parts>` | no       | `"feedback,expected"` | Comma-separated parts: feedback,expected,files,output,input,metadata,issues,trace,all |
-| `--json`            | no       |                       | Output a JSON summary of written artifacts                                            |
+| Flag                | Required | Default               | Description                                                                                    |
+| ------------------- | -------- | --------------------- | ---------------------------------------------------------------------------------------------- |
+| `--base-url <url>`  | no       |                       | Server base URL                                                                                |
+| `--out <dir>`       | no       |                       | Output directory                                                                               |
+| `--include <parts>` | no       | `"feedback,expected"` | Comma-separated parts: feedback,expected,files,output,input,metadata,issues,trace,lockfile,all |
+| `--json`            | no       |                       | Output a JSON summary of written artifacts                                                     |
 
 ### `eigenpal agents|agent runs compare|diff [options] <reference-run-id> <run-id>`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eigenpal/cli",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
   "keywords": [
     "eigenpal",