@eigenpal/cli 0.6.17 → 0.7.1

package/dist/skill/SKILL.md

@@ -167,7 +167,7 @@ eigenpal agents save -m "Improve <agent> behavior"
 SOURCE_REF="$(eigenpal git -- rev-parse HEAD)"
 eigenpal run agents.<slug>@"$SOURCE_REF" --input-json '{"text":"hello"}' --wait
 eigenpal run agents.<slug>@"$SOURCE_REF" --example example-name --wait
-eigenpal runs get <run-id> --json | jq '.run | {status,schemaValid,error,requestedSourceRef,resolvedGitRef,resolvedGitTag,resolvedCommitSha,cost}'
+eigenpal runs get <run-id> --json | jq '{status, schemaValid, error, requestedSourceRef, resolvedGitRef, resolvedGitTag, resolvedCommitSha, cost}'
 eigenpal runs artifacts list <run-id>
 eigenpal runs trace <run-id> --out ./review/<run-id>/trace.jsonl
 
@@ -177,7 +177,7 @@ eigenpal agents sync agents.<slug>
 
 # 7. Verify the released package.
 eigenpal run agents.<slug> --example example-name --wait --json
-eigenpal runs get <released-run-id> --json | jq '.run | {status,schemaValid,error,resolvedGitTag,resolvedCommitSha,cost}'
+eigenpal runs get <released-run-id> --json | jq '{status, schemaValid, error, resolvedGitTag, resolvedCommitSha, cost}'
 ```
 
 File inputs must use schema field names when there is more than one file input:
@@ -270,7 +270,7 @@ eigenpal runs artifacts list <agent-execution-id>
 eigenpal runs artifacts fetch <agent-execution-id> --include all --out ./review/<agent-execution-id>
 eigenpal runs trace <agent-execution-id> --out ./review/<agent-execution-id>/trace.jsonl
 eigenpal runs rerun <agent-execution-id> --wait
-eigenpal runs rerun <agent-execution-id> --source-ref original --wait
+eigenpal runs rerun <agent-execution-id> --version original --wait
 eigenpal runs compare <source-agent-execution-id> <new-agent-execution-id> \
   --baseline \
   --normalize-dates
@@ -284,10 +284,10 @@ take an agent execution id. Artifact fetches and comparisons write review
 artifacts under `.eigenpal/artifacts/...` by default. Unqualified run-list
 targets show all source refs; add `@<ref>` only when you want a specific
 release, branch, tag, semver range, or commit. `runs list --json` returns
-`{ runs, total, limit, offset }`; `runs get --json` returns `{ run }`.
+`{ runs, total, limit, offset }`; `runs get --json` returns the flattened run object at the top level.
 
 `runs rerun <run-id>` reuses the previous input snapshot with `latest` source
-by default. Use `--source-ref original` only when you need to reproduce the
+by default. Use `--version original` only when you need to reproduce the
 previous resolved version exactly.
 
 Use source refs such as `latest`, `main`, exact versions/tags (`1.2.3`),
@@ -359,12 +359,14 @@ eigenpal workflow dataset example delete <workflow-id> <example-id> --yes
 ```bash
 eigenpal run workflows.<workflow-id> --example <example-name>
 eigenpal runs watch <execution-id>
-eigenpal runs get <execution-id> --include input,output,error --json
+eigenpal runs get <execution-id> --expand input,execution --json
 eigenpal runs list <workflow-id> --type workflow --status failed --limit 10
 eigenpal runs compare <execution-id-a> <execution-id-b>
 eigenpal runs cancel <execution-id> --yes
 ```
 
+`runs get --json` returns the CLI's flattened run view at the top level (`id`, `finished`, `output`, `files`, `error`, plus legacy aliases like `stepExecutions`). Prefer `--expand input,execution` for server-backed sections; `--include` only adds local workflow step projection fields on top of the default expand set.
+
 ### Run And Compare Experiments
 
 ```bash
@@ -405,7 +407,7 @@ and `agents sync`. Live file commands are read/compare tools.
 
 ```bash
 eigenpal runs list <agent-id-or-slug> --type agent --status failed --limit 10
-eigenpal runs get <agent-execution-id> --include feedback,expected,files,trace,issues --json | jq '.run'
+eigenpal runs get <agent-execution-id> --expand input,execution --json | jq '{id, output, files, error, feedback: .feedback, expected: .expected}'
 eigenpal runs artifacts list <agent-execution-id>
 eigenpal runs artifacts fetch <agent-execution-id> --include all --out ./review/<agent-execution-id>
 ```
@@ -447,7 +449,7 @@ used when comparing future runs.
 
 ```bash
 eigenpal runs rerun <agent-execution-id> --wait
-eigenpal runs rerun <agent-execution-id> --source-ref original --wait
+eigenpal runs rerun <agent-execution-id> --version original --wait
 eigenpal runs compare <source-agent-execution-id> <new-agent-execution-id>
 eigenpal runs compare <source-agent-execution-id> <new-agent-execution-id> \
   --baseline \
@@ -458,7 +460,7 @@ eigenpal runs compare <source-agent-execution-id> <new-agent-execution-id> \
 By default, compare a new output against the reference execution's expected
 artifacts. Use `--baseline` to compare actual outputs from both executions.
 By default, rerun uses the previous inputs with latest source. Use
-`--source-ref original` for provenance reproduction.
+`--version original` for provenance reproduction.
 
 ## Output And Exit Codes
 
@@ -468,7 +470,7 @@ script or agent needs to inspect the result with `jq`.
 ```bash
 eigenpal runs list <workflow-id> --type workflow --json | jq '.runs[0].id'
 eigenpal runs list <agent-id-or-slug> --type agent --json | jq '.runs[0].id'
-eigenpal runs get <agent-execution-id> --json | jq '.run.id'
+eigenpal runs get <agent-execution-id> --json | jq '.id'
 ```
 
 General exit-code convention:
@@ -521,7 +523,6 @@ eigenpal
 │   ├── clear-local
 │   ├── dataset
 │   ├── evaluators
-│   ├── execution
 │   ├── experiment
 │   ├── versions
 │   ├── step-type

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

@@ -73,10 +73,10 @@ runs
 
 ### Artifacts
 
-| Command                                                         | Description                                                  |
-| --------------------------------------------------------------- | ------------------------------------------------------------ |
-| `eigenpal runs artifacts\|artifact list\|ls [options] <run-id>` | List available agent run artifacts without downloading them. |
-| `eigenpal runs artifacts\|artifact fetch [options] <run-id>`    | Download agent run artifacts by canonical artifact path.     |
+| Command                                                         | Description                                            |
+| --------------------------------------------------------------- | ------------------------------------------------------ |
+| `eigenpal runs artifacts\|artifact list\|ls [options] <run-id>` | List available run artifacts without downloading them. |
+| `eigenpal runs artifacts\|artifact fetch [options] <run-id>`    | Download run artifacts by canonical artifact path.     |
 
 ### Feedback
 
@@ -145,12 +145,13 @@ Get one run.
 
 ### Options
 
-| Flag                | Required | Default      | Description                                                                                                                    |
-| ------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------ |
-| `--base-url <url>`  | no       |              | Server base URL                                                                                                                |
-| `--json`            | no       |              | Output the raw server response as JSON                                                                                         |
-| `--step <name>`     | no       |              | For workflow runs, show only this step (or comma-separated list)                                                               |
-| `--include <parts>` | no       | `"feedback"` | Comma-separated extra parts or workflow step fields: feedback,expected,files,trace,issues,input,output,error,duration,inputRef |
+| Flag                  | Required | Default      | Description                                                                                                                                                                                 |
+| --------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--base-url <url>`    | no       |              | Server base URL                                                                                                                                                                             |
+| `--json`              | no       |              | Output the raw server response as JSON                                                                                                                                                      |
+| `--step <name>`       | no       |              | For workflow runs, show only this step (or comma-separated list)                                                                                                                            |
+| `--expand <sections>` | no       |              | Comma-separated server expand sections for GET /api/v1/runs/:id: input, usage, execution, debug. Use execution for status/schemaValid; completed runs include top-level output/files/error. |
+| `--include <parts>`   | no       | `"feedback"` | Comma-separated local workflow step projection fields (error, duration, inputRef, …). Legacy expand names are mapped when possible; use --expand for server sections.                       |
 
 ### `eigenpal runs compare|diff [options] <reference-run-id> <run-id>`
 
@@ -187,14 +188,15 @@ Create a new run from a previous run's stored input snapshot.
 
 ### Options
 
-| Flag                   | Required | Default | Description                                                                                           |
-| ---------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------- |
-| `--base-url <url>`     | no       |         | Server base URL                                                                                       |
-| `--json`               | no       |         | Output the raw server response as JSON                                                                |
-| `--source-ref <ref>`   | no       |         | Source ref for the new run: latest (default) or original. Workflow runs support only latest/original. |
-| `--wait`               | no       |         | Poll until the rerun reaches a terminal status                                                        |
-| `--interval <seconds>` | no       | `2`     | Polling interval in seconds                                                                           |
-| `--max-wait <seconds>` | no       | `1800`  | Maximum wait before exiting 2                                                                         |
+| Flag                   | Required | Default | Description                                                                                                       |
+| ---------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------- |
+| `--base-url <url>`     | no       |         | Server base URL                                                                                                   |
+| `--json`               | no       |         | Output the raw server response as JSON                                                                            |
+| `--version <version>`  | no       |         | Version/source ref for the new run: latest (default), original, or an explicit ref (same grammar as eigenpal run) |
+| `--source-ref <ref>`   | no       |         | Alias for --version                                                                                               |
+| `--wait`               | no       |         | Poll until the rerun reaches a terminal status                                                                    |
+| `--interval <seconds>` | no       | `2`     | Polling interval in seconds                                                                                       |
+| `--max-wait <seconds>` | no       | `1800`  | Maximum wait before exiting 2                                                                                     |
 
 ### `eigenpal runs trace [options] <run-id>`
 
@@ -252,7 +254,7 @@ Cancel a run.
 
 ### `eigenpal runs artifacts|artifact list|ls [options] <run-id>`
 
-List available agent run artifacts without downloading them.
+List available run artifacts without downloading them.
 
 ### Arguments
 
@@ -269,7 +271,7 @@ List available agent run artifacts without downloading them.
 
 ### `eigenpal runs artifacts|artifact fetch [options] <run-id>`
 
-Download agent run artifacts by canonical artifact path.
+Download run artifacts by canonical artifact path.
 
 ### Arguments
 

package/dist/skill/reference/dataset-format.md

@@ -270,7 +270,7 @@ Pretty mode prints labelled `Inputs` / `Expected` / `Metadata` sections;
 
 ```bash
 # 1. Look at what the workflow actually returned for the example
-eigenpal runs get exec_… --json | jq '.run.output.data' > /tmp/correct.json
+eigenpal runs get exec_… --json | jq '.output.data' > /tmp/correct.json
 
 # 2. Patch the example's expected output in place. PATCH semantics:
 #    every flag you omit is left alone.

package/dist/skill/reference/debugging.md

@@ -35,12 +35,15 @@ eigenpal runs get exec_…
 eigenpal runs get <exec-id>
 ```
 
-The payload includes:
-
-- `status` — `pending` | `running` | `completed` | `failed` | `cancelled` | `skipped`
-- `output` — the workflow's final return value (or partial when failed)
-- `triggerInput` — the input the workflow was called with
-- `stepExecutions` — one entry per step with:
+The grouped run payload includes:
+
+- `id`, `type`, `finished` — run identity and whether it reached a terminal status
+- `timing` — created/started/completed timestamps and duration
+- `execution.status` — `pending` | `running` | `completed` | `failed` | `cancelled` | `skipped`
+- `output` — the workflow's final return value when `finished` and completed (or partial when failed)
+- `error` — terminal failure message when the run failed or was cancelled
+- `input` — the input the workflow was called with (included on detail fetches)
+- `execution.steps` — one entry per step when you pass `--expand execution` (the CLI also mirrors this as `stepExecutions`):
   - `stepName` — handle from `workflow.yaml`
   - `status` — same set as the top-level. `skipped` means the step's
     `if:` evaluated false, OR a `control.foreach` was passed an empty
@@ -61,21 +64,21 @@ The payload includes:
 Quick triage with `jq`:
 
 ```bash
-eigenpal runs get <exec-id> --json \
-  | jq '.run.stepExecutions[] | { step: .stepName, status, error }'
+eigenpal runs get <exec-id> --expand execution --json \
+  | jq '.stepExecutions[] | { step: .stepName, status, error }'
 ```
 
 Narrow to a single step:
 
 ```bash
-eigenpal runs get <exec-id> --include input,output,error --json \
-  | jq '.run.stepExecutions[] | select(.stepName == "extract")'
+eigenpal runs get <exec-id> --expand execution --include input,output,error --json \
+  | jq '.stepExecutions[] | select(.stepName == "extract")'
 ```
 
 Drill into one field:
 
 ```bash
-eigenpal runs get <exec-id> --json | jq '.run.stepExecutions[2].output.totalAmount'
+eigenpal runs get <exec-id> --expand execution --json | jq '.stepExecutions[2].output.totalAmount'
 ```
 
 ## 3. Common failure modes
@@ -256,15 +259,15 @@ steps were faked. Re-import the dataset (`workflow dataset push
 ## 9. Watching a long batch
 
 ```bash
-# Kicks off, prints { batchId, executionIds }
+# Kicks off, prints { batchId, total }
 eigenpal workflow experiment run <workflow-id>
 
 # --watch polls until every execution is terminal, prints a per-example
 # failure summary, and exits non-zero if any failed/cancelled.
-eigenpal workflow experiment status <workflow-id> --batch-id <id> --watch
+eigenpal workflow experiment status <workflow-id> <batch-id> --watch
 
 # Without --watch: one-shot snapshot, no polling. Prefer --watch in CI / agents.
-eigenpal workflow experiment status <workflow-id> --batch-id <id>
+eigenpal workflow experiment status <workflow-id> <batch-id>
 ```
 
 The terminal `--watch` output looks like:
@@ -289,8 +292,8 @@ returned before erroring) follow the suggested command:
 
 ```bash
 eigenpal runs get exec_…                                  # full payload
-eigenpal runs get exec_… --include input,output,error --json | jq '.run.stepExecutions[] | select(.stepName == "<name>")'
-eigenpal runs get exec_… --json | jq -r '.run.stepExecutions[0].error'
+eigenpal runs get exec_… --expand execution --json | jq '.stepExecutions[] | select(.stepName == "<name>")'
+eigenpal runs get exec_… --expand execution --json | jq -r '.stepExecutions[] | select(.error != null) | .error' | head -1
 ```
 
 For per-execution live view, `eigenpal runs watch <exec-id>` does

package/dist/skill/reference/evaluators.md

@@ -210,17 +210,17 @@ Reports field-level issues:
 eigenpal workflow evaluators push <workflow-id> --file evaluators.yaml
 
 # Kick off a server-side batch eval over the whole pushed dataset.
-# Returns { batchId, executionIds }.
+# Returns { batchId, total }.
 eigenpal workflow experiment run <workflow-id>
 
 # Or restrict to a single example:
 eigenpal workflow experiment run <workflow-id> --example-id evx_…
 
 # Watch progress.
-eigenpal workflow experiment status <workflow-id> --batch-id <id>
+eigenpal workflow experiment status <workflow-id> <batch-id>
 
 # Pull results when done.
-eigenpal workflow experiment results <workflow-id> --batch-id <id> \
+eigenpal workflow experiment results <workflow-id> <batch-id> \
   --format csv --out results.csv
 ```
 

package/dist/skill/reference/step-exec.md

@@ -11,8 +11,8 @@
 >
 > Calling `eigenpal workflow step exec <type>` today exits 2 with a
 > redirect message. The server-side replacement is tracked in EIG-104:
-> a thin `POST /api/v1/workflows/step-exec` endpoint that runs the same
-> code path executions take.
+> a future server-routed endpoint that runs the same code path executions
+> take.
 
 ## What to use instead
 
@@ -36,12 +36,12 @@ To inspect what a step actually produced (input / output / resolved
 config), use:
 
 ```bash
-eigenpal runs get <executionId> --json --include input,output,config
+eigenpal runs get <executionId> --expand execution --json --include input,output,config
 ```
 
-The server returns `inputData` / `outputData` / `resolvedConfig` per
-step on `?includeSteps=true`; the CLI projects them under shorter
-names (`input` / `output` / `config`).
+The CLI requests the run detail with `expand=execution` and projects
+per-step `inputData` / `outputData` / `resolvedConfig` under shorter names
+(`input` / `output` / `config`).
 
 ## Exit codes (current placeholder)
 

package/dist/skill/reference/workflow-yaml.md

@@ -42,8 +42,10 @@ Required. Each entry is an object that adds an invocation surface:
 - `{ type: manual }` — the workflow can be started manually
 - `{ type: email, whitelist?: ... }` — inbound email
 
-If `{ type: api }` is missing, `eigenpal run workflows.<slug>` rejects with a
-403 / "Workflow does not have API trigger enabled."
+If `{ type: api }` is missing, `eigenpal run workflows.<slug>` rejects with
+`403` / issue code `api_trigger_disabled` — enable the API trigger in the
+workflow editor or dashboard settings. Runtime gates read the
+`automation_triggers` projection (synced on workflow publish).
 
 ### `inputs`
 

package/package.json

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