@eigenpal/cli 0.6.5 → 0.6.7

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 (9) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +2 -4
  3. package/dist/cli.js +26202 -23625
  4. package/dist/skill/SKILL.md +164 -53
  5. package/dist/skill/reference/cli/agents.md +85 -105
  6. package/dist/skill/reference/cli/init.md +1 -20
  7. package/package.json +1 -1
  8. package/dist/skill/reference/cli/run.md +0 -18
  9. package/dist/skill/reference/cli/runs.md +0 -23
package/dist/skill/SKILL.md CHANGED
@@ -36,8 +36,6 @@ For exact flags and defaults, prefer the generated references:
36
36
  - [`reference/cli/workflow.md`](reference/cli/workflow.md)
37
37
  - [`reference/cli/agents.md`](reference/cli/agents.md)
38
38
  - [`reference/cli/git.md`](reference/cli/git.md)
39
- - [`reference/cli/run.md`](reference/cli/run.md)
40
- - [`reference/cli/runs.md`](reference/cli/runs.md)
41
39
 
42
40
  ## Pick The Surface
43
41
 
@@ -112,52 +110,122 @@ a folder unless the user specifically asks for that placement.
112
110
 
113
111
  ## Agent Iteration Loop
114
112
 
115
- Git-backed agent source lives in the organization repository under `agents/<slug>/`.
116
- Edit source in Git, save builder work with `eigenpal agents save`, and ship with
117
- `eigenpal agents release` + `eigenpal agents sync`. Builder sessions usually work
118
- on `builder/<agent>/<session>` branches. This is all Git under the hood, but use
119
- the Eigenpal CLI whenever possible:
120
-
121
- - `eigenpal agents save` = validate changed packages, commit if dirty, and push the current branch.
122
- - `eigenpal agents release <version> agents/<slug>` = safely land the package onto the release/tag path. Treat this like the merge step.
123
- - `eigenpal agents sync agents.<slug>` = apply the latest released manifest, including triggers, to the server DB.
124
- - `eigenpal git -- <args>` = authenticated git passthrough. Use it for every git command, including nuanced/read-only commands (`status`, `diff`, `log`, `rev-parse HEAD`, `merge`) and conflict recovery. Do not call raw `git` directly in normal agent work.
125
-
126
- Do not use `eigenpal agents push` or `agents file put` — those targeted the legacy
127
- HTTP upload API. Configure triggers in `eigenpal.yaml`; `agents sync` applies the
128
- latest release manifest to the DB.
113
+ Agents are Git-backed source packages. The server runs released source packages
114
+ from the organization source repository; editing live files is not the normal
115
+ workflow. Prefer the Eigenpal CLI over raw provider/API calls because it handles
116
+ validation, source refs, release tags, and server sync consistently. Cloned
117
+ source repos also work with raw Git and IDE source-control panels: `agents clone`
118
+ and `eigenpal git -- ...` configure a repo-local credential helper for the
119
+ Eigenpal Git remote, so `git status`, `git log`, `git pull`, and `git push`
120
+ can authenticate without copying API keys into `.git/config`.
121
+
122
+ Core mental model:
123
+
124
+ - `agents/<slug>/` is one agent package.
125
+ - `resources/skills/<slug>/`, `resources/knowledge/<slug>/`,
126
+ `resources/templates/<slug>/`, and `resources/rules/<slug>/` are shared
127
+ packages that agents depend on through `eigenpal.yaml`.
128
+ - `eigenpal agents save` validates changed packages, commits if dirty, and
129
+ pushes the current branch.
130
+ - `eigenpal agents release patch agents/<slug>` lands a package as an immutable
131
+ release tag.
132
+ - `eigenpal agents sync agents.<slug>` applies the latest released agent
133
+ manifest to the server DB, including triggers.
134
+ - `@latest` means latest released package, not your current branch.
135
+ - To test current branch work before release, run the exact commit SHA from
136
+ `eigenpal git -- rev-parse HEAD`.
137
+
138
+ Use branches. Do not casually edit `main` unless the user explicitly wants that:
129
139
 
130
140
  ```bash
131
- # 1. Clone org source and open the agent package.
141
+ # 1. Clone org source and create a branch.
132
142
  eigenpal agents clone --out ./source
133
- cd source/agents/<slug>
134
- eigenpal agents install
143
+ cd ./source
144
+ eigenpal git -- switch -c <short-task-branch>
135
145
 
136
- # 2. Edit agent source.
137
- # AGENT.md is the inference orchestrator. Schemas are plain JSON files.
138
- $EDITOR AGENT.md eigenpal.yaml input-schema.json output-schema.json
139
- $EDITOR skills/<skill>/SKILL.md skills/<skill>/run.py
140
-
141
- # 3. Validate layout, manifest, and schema files; then save durable source changes on the current branch.
142
- cd ../.. # repo root
146
+ # 2. Inspect package state.
143
147
  eigenpal agents status
148
+ eigenpal agents show agents.<slug> --json
149
+ eigenpal agents versions agents.<slug> --json
150
+
151
+ # 3. Edit source.
152
+ $EDITOR agents/<slug>/AGENT.md
153
+ $EDITOR agents/<slug>/eigenpal.yaml
154
+ $EDITOR agents/<slug>/input-schema.json agents/<slug>/output-schema.json
155
+ $EDITOR agents/<slug>/skills/<skill>/SKILL.md agents/<slug>/skills/<skill>/run.py
156
+
157
+ # 4. Validate and save the branch.
144
158
  eigenpal agents validate agents/<slug>
145
- eigenpal agents save -m "Improve invoice extraction prompts"
159
+ eigenpal agents deps --dir agents/<slug>
160
+ eigenpal agents save -m "Improve <agent> behavior"
146
161
 
147
- # 4. Run exactly what was saved.
162
+ # 5. Test the exact saved commit.
148
163
  SOURCE_REF="$(eigenpal git -- rev-parse HEAD)"
149
164
  eigenpal agents run agents.<slug>@"$SOURCE_REF" --input-json '{"text":"hello"}' --wait
150
165
  eigenpal agents run agents.<slug>@"$SOURCE_REF" --example example-name --wait
151
- eigenpal agents runs get <agent-execution-id> --json | jq '.run'
152
- eigenpal agents runs trace <agent-execution-id> --out ./trace.jsonl
166
+ eigenpal agents runs get <run-id> --json | jq '.run | {status,schemaValid,error,requestedSourceRef,resolvedGitRef,resolvedGitTag,resolvedCommitSha,cost}'
167
+ eigenpal agents runs artifacts list <run-id>
168
+ eigenpal agents runs trace <run-id> --out ./review/<run-id>/trace.jsonl
153
169
 
154
- # 5. Release to main + tag when ready to ship (-m optional; defaults to "Release <packagePath>").
155
- # Release tags are immutable — never move, delete, or force-update a published tag.
156
- # If a release is wrong, ship a new patch (`eigenpal agents release patch`).
170
+ # 6. Release and sync only when ready.
157
171
  eigenpal agents release patch agents/<slug>
158
172
  eigenpal agents sync agents.<slug>
173
+
174
+ # 7. Verify the released package.
175
+ eigenpal agents run agents.<slug>@latest --example example-name --wait --json
176
+ eigenpal agents runs get <released-run-id> --json | jq '.run | {status,schemaValid,error,resolvedGitTag,resolvedCommitSha,cost}'
159
177
  ```
160
178
 
179
+ File inputs must use schema field names when there is more than one file input:
180
+
181
+ ```bash
182
+ eigenpal agents run agents.<slug>@latest \
183
+ --input-file start_info_doc=./ZFRP.docx \
184
+ --wait
185
+
186
+ eigenpal agents run agents.<slug>@latest \
187
+ --input-file zfzal_doc=./ZFZAL.pdf \
188
+ --input-file lv_doc=./list_vlastnictva.pdf \
189
+ --input-json '{"skip_name_check":false}' \
190
+ --wait
191
+ ```
192
+
193
+ There is no live file upload command for Git-backed agents. `agents file list/get/diff`
194
+ are read/compare tools only. Source changes go through Git + `agents save` +
195
+ `agents release` + `agents sync`.
196
+
197
+ ### Shared Resource Rollouts
198
+
199
+ When you edit a shared resource, do not assume every dependent agent should move
200
+ immediately. Find usage, then ask the user which dependents to bump:
201
+
202
+ ```bash
203
+ # 1. Edit and validate the shared package.
204
+ $EDITOR resources/skills/<slug>/SKILL.md resources/skills/<slug>/run.py
205
+ eigenpal agents validate resources/skills/<slug>
206
+
207
+ # 2. Find dependent agents/resources.
208
+ rg '<slug>|resources/skills/<slug>|resources/knowledge/<slug>' agents/ resources/
209
+ eigenpal agents deps --dir agents/<dependent-slug>
210
+
211
+ # 3. Ask the user which dependents should move to the new resource version.
212
+
213
+ # 4. Release the shared package.
214
+ eigenpal agents save -m "Improve shared <slug>"
215
+ eigenpal agents release patch resources/skills/<slug>
216
+
217
+ # 5. Bump selected agents' eigenpal.yaml dependency refs, then release/sync them.
218
+ $EDITOR agents/<dependent-slug>/eigenpal.yaml
219
+ eigenpal agents validate agents/<dependent-slug>
220
+ eigenpal agents save -m "Bump <slug> dependency"
221
+ eigenpal agents release patch agents/<dependent-slug>
222
+ eigenpal agents sync agents.<dependent-slug>
223
+ ```
224
+
225
+ After a shared dependency rollout, run one affected agent and inspect
226
+ `eigenpal.lock` via `agents runs artifacts fetch` to confirm the dependency
227
+ version and commit that inference actually installed.
228
+
161
229
  ### Agent Datasets And Examples
162
230
 
163
231
  Agent eval examples are runtime data, not Git source. `eigenpal agents save`
@@ -194,9 +262,11 @@ Run a persisted example with `eigenpal agents run agents.<slug>@<ref> --example
194
262
  ```bash
195
263
  eigenpal agents runs list agents.<slug> --compact
196
264
  eigenpal agents runs list agents.<slug> --status failed --compact
197
- eigenpal agents runs pull <agent-execution-id> --include all --out ./review/<agent-execution-id>
265
+ eigenpal agents runs artifacts list <agent-execution-id>
266
+ eigenpal agents runs artifacts fetch <agent-execution-id> --include all --out ./review/<agent-execution-id>
198
267
  eigenpal agents runs trace <agent-execution-id> --out ./review/<agent-execution-id>/trace.jsonl
199
- eigenpal agents runs rerun <agent-execution-id> --wait
268
+ eigenpal agents rerun <agent-execution-id> --wait
269
+ eigenpal agents rerun <agent-execution-id> --source-ref original --wait
200
270
  eigenpal agents runs compare <source-agent-execution-id> <new-agent-execution-id> \
201
271
  --baseline \
202
272
  --normalize-dates
@@ -206,13 +276,15 @@ eigenpal agents runs feedback resolve <source-agent-execution-id> \
206
276
  ```
207
277
 
208
278
  Agent commands commonly accept `<agent-id-or-slug>`. Agent execution commands
209
- take an agent execution id. Execution pulls and comparisons write review
279
+ take an agent execution id. Artifact fetches and comparisons write review
210
280
  artifacts under `.eigenpal/artifacts/...` by default. Unqualified run-list
211
281
  targets show all source refs; add `@<ref>` only when you want a specific
212
282
  release, branch, tag, semver range, or commit. `runs list --json` returns
213
283
  `{ runs, total, limit, offset }`; `runs get --json` returns `{ run }`.
214
284
 
215
- Root `eigenpal run` / `eigenpal runs` and `eigenpal git <cmd>` (for moved subcommands) exit with a deprecation message — use `agents run`, `agents runs list`, and `agents <cmd>` instead.
285
+ `agents rerun <run-id>` reuses the previous input snapshot with `latest` source
286
+ by default. Use `--source-ref original` only when you need to reproduce the
287
+ previous resolved version exactly.
216
288
 
217
289
  Use source refs such as `latest`, `main`, exact versions/tags (`1.2.3`),
218
290
  semver ranges (`1.2.x`, `1.x`), or exact commit SHAs when you need provenance.
@@ -304,20 +376,26 @@ both batches must belong to the same workflow.
304
376
 
305
377
  ## Agent Recipes
306
378
 
307
- ### Inspect And Edit Agent Files
379
+ ### Inspect Agent Source And Live Files
308
380
 
309
381
  ```bash
310
382
  eigenpal agents list
383
+ eigenpal agents show agents.<slug> --json
384
+ eigenpal agents versions agents.<slug> --json
385
+ eigenpal agents clone --out ./source
386
+ cd ./source
387
+ eigenpal agents status
388
+ eigenpal agents deps --dir agents/<slug>
389
+
390
+ # Live file inspection only. Do not edit through this surface.
311
391
  eigenpal agents file list <agent-id-or-slug>
312
- eigenpal agents file list <agent-id-or-slug> --prefix agent/knowledge
392
+ eigenpal agents file list <agent-id-or-slug> --path agent/knowledge
313
393
  eigenpal agents file get <agent-id-or-slug> agent/instructions.md --out instructions.md
314
394
  eigenpal agents file diff <agent-id-or-slug> agent/instructions.md instructions.md
315
- eigenpal agents file put <agent-id-or-slug> agent/instructions.md instructions.md --preview
316
- eigenpal agents file put <agent-id-or-slug> agent/instructions.md instructions.md
317
395
  ```
318
396
 
319
- Use `--preview` before writing substantial changes; it shows how the target file
320
- would change.
397
+ Edit `agents/<slug>/...` in Git source, then `agents save`, `agents release`,
398
+ and `agents sync`. Live file commands are read/compare tools.
321
399
 
322
400
  ### Inspect Agent Executions
323
401
 
@@ -325,8 +403,8 @@ would change.
325
403
  eigenpal agents runs list <agent-id-or-slug> --status failed --limit 10
326
404
  eigenpal agents runs list <agent-id-or-slug> --feedback-rating fail --include feedback,expected
327
405
  eigenpal agents runs get <agent-execution-id> --include feedback,expected,files,trace,issues --json | jq '.run'
328
- eigenpal agents runs pull <agent-execution-id> --include all
329
406
  eigenpal agents runs artifacts list <agent-execution-id>
407
+ eigenpal agents runs artifacts fetch <agent-execution-id> --include all --out ./review/<agent-execution-id>
330
408
  ```
331
409
 
332
410
  Use `--compact` on execution lists when you only need triage rows.
@@ -365,7 +443,8 @@ used when comparing future runs.
365
443
  ### Rerun And Compare Agent Executions
366
444
 
367
445
  ```bash
368
- eigenpal agents runs rerun <agent-execution-id> --wait
446
+ eigenpal agents rerun <agent-execution-id> --wait
447
+ eigenpal agents rerun <agent-execution-id> --source-ref original --wait
369
448
  eigenpal agents runs compare <source-agent-execution-id> <new-agent-execution-id>
370
449
  eigenpal agents runs compare <source-agent-execution-id> <new-agent-execution-id> \
371
450
  --baseline \
@@ -375,6 +454,8 @@ eigenpal agents runs compare <source-agent-execution-id> <new-agent-execution-id
375
454
 
376
455
  By default, compare a new output against the reference execution's expected
377
456
  artifacts. Use `--baseline` to compare actual outputs from both executions.
457
+ By default, rerun uses the previous inputs with latest source. Use
458
+ `--source-ref original` for provenance reproduction.
378
459
 
379
460
  ## Output And Exit Codes
380
461
 
@@ -413,8 +494,6 @@ CLI command references:
413
494
 
414
495
  - [`reference/cli/workflow.md`](reference/cli/workflow.md)
415
496
  - [`reference/cli/agents.md`](reference/cli/agents.md)
416
- - [`reference/cli/run.md`](reference/cli/run.md)
417
- - [`reference/cli/runs.md`](reference/cli/runs.md)
418
497
  - [`reference/cli/auth.md`](reference/cli/auth.md)
419
498
  - [`reference/cli/status.md`](reference/cli/status.md)
420
499
 
@@ -445,18 +524,50 @@ eigenpal
445
524
  │ ├── step-type
446
525
  │ └── evaluator-type
447
526
  ├── agents
527
+ │ ├── run
528
+ │ ├── rerun
448
529
  │ ├── list
449
- │ ├── push
450
- │ ├── pull
451
530
  │ ├── validate
531
+ │ ├── clone
532
+ │ ├── install
533
+ │ ├── init
534
+ │ ├── pull
535
+ │ ├── commit
536
+ │ ├── save
537
+ │ ├── push
538
+ │ ├── release
539
+ │ ├── sync
540
+ │ ├── status
541
+ │ ├── deps
542
+ │ ├── clean
543
+ │ ├── doctor
544
+ │ ├── show
545
+ │ ├── versions
546
+ │ ├── secret
547
+ │ ├── env
452
548
  │ ├── file
453
- │ ├── trigger
454
- │ ├── execution
549
+ │ ├── dataset
550
+ │ ├── runs
455
551
  │ └── experiment
456
- ├── run
457
- ├── runs
552
+ │ └── session
458
553
  └── skill
459
554
  ├── install
460
555
  ├── uninstall
461
556
  └── list
462
557
  ```
558
+
559
+ Agent command roles:
560
+
561
+ - `agents clone` — clone organization source and configure raw Git/IDE auth.
562
+ - `agents pull` — fast-forward source from `origin/main`; not datasets or run artifacts.
563
+ - `agents status` / `agents doctor` / `agents clean` — inspect source health.
564
+ - `agents validate` / `agents deps` — validate one package and inspect workspace dependencies.
565
+ - `agents save` — validate, commit if dirty, and push the current branch.
566
+ - `agents release` — create immutable package release tags.
567
+ - `agents sync` — apply latest released agent manifest/triggers to the server.
568
+ - `agents run` — start a run from a source ref (`@latest`, version, branch, commit).
569
+ - `agents rerun` — reuse a previous input snapshot; defaults to latest source.
570
+ - `agents runs list/get/watch/cancel/compare/trace` — inspect and manage executions.
571
+ - `agents runs artifacts list/fetch` — inventory and download run artifacts by path.
572
+ - `agents dataset` — manage persisted agent examples; runtime data, not Git source.
573
+ - `agents file` — live read/diff inspection only.
package/dist/skill/reference/cli/agents.md CHANGED
@@ -17,6 +17,7 @@ Manage Eigenpal agents: Git source, datasets, runs, experiments, sessions, and r
17
17
  - [Secrets](#secrets)
18
18
  - [Details](#details)
19
19
  - [`eigenpal agents|agent run [options] <target>`](#eigenpal-agentsagent-run-options-target)
20
+ - [`eigenpal agents|agent rerun [options] <run-id>`](#eigenpal-agentsagent-rerun-options-run-id)
20
21
  - [`eigenpal agents|agent list|ls [options]`](#eigenpal-agentsagent-listls-options)
21
22
  - [`eigenpal agents|agent validate [options] [dir]`](#eigenpal-agentsagent-validate-options-dir)
22
23
  - [`eigenpal agents|agent clone [options]`](#eigenpal-agentsagent-clone-options)
@@ -37,7 +38,6 @@ Manage Eigenpal agents: Git source, datasets, runs, experiments, sessions, and r
37
38
  - [`eigenpal agents|agent sync [options] [automation]`](#eigenpal-agentsagent-sync-options-automation)
38
39
  - [`eigenpal agents|agent file list|ls [options] <agent-id-or-slug>`](#eigenpal-agentsagent-file-listls-options-agent-id-or-slug)
39
40
  - [`eigenpal agents|agent file get [options] <agent-id-or-slug> <remote-path>`](#eigenpal-agentsagent-file-get-options-agent-id-or-slug-remote-path)
40
- - [`eigenpal agents|agent file put [options] <agent-id-or-slug> <remote-path> <local-path>`](#eigenpal-agentsagent-file-put-options-agent-id-or-slug-remote-path-local-path)
41
41
  - [`eigenpal agents|agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>`](#eigenpal-agentsagent-file-diff-options-agent-id-or-slug-remote-path-local-path)
42
42
  - [`eigenpal agents|agent secret set [options] <name>`](#eigenpal-agentsagent-secret-set-options-name)
43
43
  - [`eigenpal agents|agent secret unset [options] <name>`](#eigenpal-agentsagent-secret-unset-options-name)
@@ -48,10 +48,9 @@ Manage Eigenpal agents: Git source, datasets, runs, experiments, sessions, and r
48
48
  - [`eigenpal agents|agent dataset validate [options] [path]`](#eigenpal-agentsagent-dataset-validate-options-path)
49
49
  - [`eigenpal agents|agent runs list|ls [options] <target>`](#eigenpal-agentsagent-runs-listls-options-target)
50
50
  - [`eigenpal agents|agent runs get [options] <run-id>`](#eigenpal-agentsagent-runs-get-options-run-id)
51
- - [`eigenpal agents|agent runs rerun [options] <run-id>`](#eigenpal-agentsagent-runs-rerun-options-run-id)
52
- - [`eigenpal agents|agent runs pull [options] <run-id>`](#eigenpal-agentsagent-runs-pull-options-run-id)
53
51
  - [`eigenpal agents|agent runs compare|diff [options] <reference-run-id> <run-id>`](#eigenpal-agentsagent-runs-comparediff-options-reference-run-id-run-id)
54
52
  - [`eigenpal agents|agent runs artifacts|artifact list|ls [options] <run-id>`](#eigenpal-agentsagent-runs-artifactsartifact-listls-options-run-id)
53
+ - [`eigenpal agents|agent runs artifacts|artifact fetch [options] <run-id>`](#eigenpal-agentsagent-runs-artifactsartifact-fetch-options-run-id)
55
54
  - [`eigenpal agents|agent runs trace [options] <run-id>`](#eigenpal-agentsagent-runs-trace-options-run-id)
56
55
  - [`eigenpal agents|agent runs feedback|fb update [options] <run-id>`](#eigenpal-agentsagent-runs-feedbackfb-update-options-run-id)
57
56
  - [`eigenpal agents|agent runs feedback|fb resolve [options] <run-id>`](#eigenpal-agentsagent-runs-feedbackfb-resolve-options-run-id)
@@ -83,11 +82,11 @@ Manage Eigenpal agents: Git source, datasets, runs, experiments, sessions, and r
83
82
  ```
84
83
  agents
85
84
  ├── run <target>
85
+ ├── rerun <run-id>
86
86
  ├── list|ls
87
87
  ├── file
88
88
  │ ├── list|ls <agent-id-or-slug>
89
89
  │ ├── get <agent-id-or-slug> <remote-path>
90
- │ ├── put <agent-id-or-slug> <remote-path> <local-path>
91
90
  │ └── diff <agent-id-or-slug> <remote-path> <local-path>
92
91
  ├── validate [dir]
93
92
  ├── clone
@@ -118,11 +117,10 @@ agents
118
117
  ├── runs
119
118
  │ ├── list|ls <target>
120
119
  │ ├── get <run-id>
121
- │ ├── rerun <run-id>
122
- │ ├── pull <run-id>
123
120
  │ ├── compare|diff <reference-run-id> <run-id>
124
121
  │ ├── artifacts|artifact
125
- │ │ └── list|ls <run-id>
122
+ │ │ ├── list|ls <run-id>
123
+ │ │ └── fetch <run-id>
126
124
  │ ├── trace <run-id>
127
125
  │ ├── feedback|fb
128
126
  │ │ ├── update <run-id>
@@ -160,36 +158,36 @@ agents
160
158
 
161
159
  ### Core
162
160
 
163
- | Command | Description |
164
- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
165
- | `eigenpal agents\|agent run [options] <target>` | Run an agent target, e.g. agents.invoice-agent@latest. |
166
- | `eigenpal agents\|agent list\|ls [options]` | List agents. |
167
- | `eigenpal agents\|agent validate [options] [dir]` | Validate a local agent package (layout, manifest, schemas, and Git source rules). |
168
- | `eigenpal agents\|agent clone [options]` | Clone the organization source repository. |
169
- | `eigenpal agents\|agent install [options] [packageRef]` | Materialize a source package and its workspace dependencies. |
170
- | `eigenpal agents\|agent init [options] <name>` | Create a new source package scaffold. |
171
- | `eigenpal agents\|agent pull [options]` | Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use agents runs pull. |
172
- | `eigenpal agents\|agent commit [options]` | Validate changed source packages and commit them. |
173
- | `eigenpal agents\|agent save [options]` | Validate, commit if dirty, and push the current source branch. |
174
- | `eigenpal agents\|agent push [options]` | Push the current organization source branch and tags. |
175
- | `eigenpal agents\|agent upgrade [options]` | Upgrade the source repository schema in place. |
176
- | `eigenpal agents\|agent doctor [options]` | Check organization source repository health. |
177
- | `eigenpal agents\|agent status [options]` | Show source repo and package status. |
178
- | `eigenpal agents\|agent deps [options]` | List package workspace dependencies. |
179
- | `eigenpal agents\|agent clean [options]` | Require a clean source working tree. |
180
- | `eigenpal agents\|agent show [options] <automation>` | Show Git-backed automation details. |
181
- | `eigenpal agents\|agent versions [options] <package>` | List package release versions. |
182
- | `eigenpal agents\|agent release [options] <version> [dir]` | Create and push an immutable package release tag. Never move or overwrite an existing tag; release a new patch instead. |
183
- | `eigenpal agents\|agent sync [options] [automation]` | Sync an automation from the latest Git source release. |
161
+ | Command | Description |
162
+ | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
163
+ | `eigenpal agents\|agent run [options] <target>` | Run an agent target, e.g. agents.invoice-agent@latest. |
164
+ | `eigenpal agents\|agent rerun [options] <run-id>` | Create a new run from a previous run's stored input snapshot. |
165
+ | `eigenpal agents\|agent list\|ls [options]` | List agents. |
166
+ | `eigenpal agents\|agent validate [options] [dir]` | Validate a local agent package (layout, manifest, schemas, and Git source rules). |
167
+ | `eigenpal agents\|agent clone [options]` | Clone the organization source repository. |
168
+ | `eigenpal agents\|agent install [options] [packageRef]` | Materialize a source package and its workspace dependencies. |
169
+ | `eigenpal agents\|agent init [options] <name>` | Create a new source package scaffold. |
170
+ | `eigenpal agents\|agent pull [options]` | Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use agents runs artifacts fetch. |
171
+ | `eigenpal agents\|agent commit [options]` | Validate changed source packages and commit them. |
172
+ | `eigenpal agents\|agent save [options]` | Validate, commit if dirty, and push the current source branch. |
173
+ | `eigenpal agents\|agent push [options]` | Push the current organization source branch and tags. |
174
+ | `eigenpal agents\|agent upgrade [options]` | Upgrade the source repository schema in place. |
175
+ | `eigenpal agents\|agent doctor [options]` | Check organization source repository health. |
176
+ | `eigenpal agents\|agent status [options]` | Show source repo and package status. |
177
+ | `eigenpal agents\|agent deps [options]` | List package workspace dependencies. |
178
+ | `eigenpal agents\|agent clean [options]` | Require a clean source working tree. |
179
+ | `eigenpal agents\|agent show [options] <automation>` | Show Git-backed automation details. |
180
+ | `eigenpal agents\|agent versions [options] <package>` | List package release versions. |
181
+ | `eigenpal agents\|agent release [options] <version> [dir]` | Create and push an immutable package release tag. Never move or overwrite an existing tag; release a new patch instead. |
182
+ | `eigenpal agents\|agent sync [options] [automation]` | Sync an automation from the latest Git source release. |
184
183
 
185
184
  ### File
186
185
 
187
- | Command | Description |
188
- | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- |
189
- | `eigenpal agents\|agent file list\|ls [options] <agent-id-or-slug>` | List live files for an agent. |
190
- | `eigenpal agents\|agent file get [options] <agent-id-or-slug> <remote-path>` | Download one live agent file. |
191
- | `eigenpal agents\|agent file put [options] <agent-id-or-slug> <remote-path> <local-path>` | [removed] Git-backed agents — edit source in Git and run `eigenpal agents save`. |
192
- | `eigenpal agents\|agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>` | Compare one live agent file against a local file. |
186
+ | Command | Description |
187
+ | ------------------------------------------------------------------------------------------ | ------------------------------------------------- |
188
+ | `eigenpal agents\|agent file list\|ls [options] <agent-id-or-slug>` | List live files for an agent. |
189
+ | `eigenpal agents\|agent file get [options] <agent-id-or-slug> <remote-path>` | Download one live agent file. |
190
+ | `eigenpal agents\|agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>` | Compare one live agent file against a local file. |
193
191
 
194
192
  ### Secret
195
193
 
@@ -214,10 +212,9 @@ agents
214
212
  | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
215
213
  | `eigenpal agents\|agent runs list\|ls [options] <target>` | List runs for an agent target; unqualified targets include all source refs. |
216
214
  | `eigenpal agents\|agent runs get [options] <run-id>` | Get one agent run. |
217
- | `eigenpal agents\|agent runs rerun [options] <run-id>` | Create a new run from a previous run's stored input snapshot. |
218
- | `eigenpal agents\|agent runs pull [options] <run-id>` | Download run feedback, expected artifacts, files, and metadata. |
219
215
  | `eigenpal agents\|agent runs compare\|diff [options] <reference-run-id> <run-id>` | Compare one run against another run. PDF/DOCX text comparison uses pdftotext/python3 and reports byte fallbacks. |
220
216
  | `eigenpal agents\|agent runs artifacts\|artifact list\|ls [options] <run-id>` | List available run artifacts without downloading them. |
217
+ | `eigenpal agents\|agent runs artifacts\|artifact fetch [options] <run-id>` | Download run artifacts by canonical artifact path. |
221
218
  | `eigenpal agents\|agent runs trace [options] <run-id>` | Print raw trace.jsonl for a run, or write it with --out. |
222
219
  | `eigenpal agents\|agent runs feedback\|fb update [options] <run-id>` | Edit feedback state, rating, message, or expected JSON for a run. |
223
220
  | `eigenpal agents\|agent runs feedback\|fb resolve [options] <run-id>` | Mark run feedback as resolved. |
@@ -278,16 +275,37 @@ Run an agent target, e.g. agents.invoice-agent@latest.
278
275
 
279
276
  ### Options
280
277
 
281
- | Flag | Required | Default | Description |
282
- | ---------------------- | -------- | ------- | -------------------------------------------- |
283
- | `--base-url <url>` | no | | Server base URL |
284
- | `--json` | no | | Output the raw server response as JSON |
285
- | `--input-json <json>` | no | | JSON input object |
286
- | `--input-file <path>` | no | | Input file to upload as multipart form-data |
287
- | `--example <name>` | no | | Run a persisted dataset example by name |
288
- | `--wait` | no | | Poll until the run reaches a terminal status |
289
- | `--interval <seconds>` | no | `2` | Polling interval in seconds |
290
- | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
278
+ | Flag | Required | Default | Description |
279
+ | --------------------------- | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
280
+ | `--base-url <url>` | no | | Server base URL |
281
+ | `--json` | no | | Output the raw server response as JSON |
282
+ | `--input-json <json>` | no | | JSON input object |
283
+ | `--input-file <field=path>` | no | `[]` | Input file to upload as multipart form-data. Repeat for multiple files; bare paths use field "file". |
284
+ | `--example <name>` | no | | Run a persisted dataset example by name |
285
+ | `--wait` | no | | Poll until the run reaches a terminal status |
286
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
287
+ | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
288
+
289
+ ### `eigenpal agents|agent rerun [options] <run-id>`
290
+
291
+ Create a new run from a previous run's stored input snapshot.
292
+
293
+ ### Arguments
294
+
295
+ | Name | Required | Variadic | Description |
296
+ | -------- | -------- | -------- | ----------- |
297
+ | `run-id` | yes | no | |
298
+
299
+ ### Options
300
+
301
+ | Flag | Required | Default | Description |
302
+ | ---------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------- |
303
+ | `--base-url <url>` | no | | Server base URL |
304
+ | `--json` | no | | Output the raw server response as JSON |
305
+ | `--source-ref <ref>` | no | | Source ref for the new run (default: latest). Use "original" to reproduce the previous resolved version. |
306
+ | `--wait` | no | | Poll until the rerun reaches a terminal status |
307
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
308
+ | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
291
309
 
292
310
  ### `eigenpal agents|agent list|ls [options]`
293
311
 
@@ -369,7 +387,7 @@ Create a new source package scaffold.
369
387
 
370
388
  ### `eigenpal agents|agent pull [options]`
371
389
 
372
- Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use agents runs pull.
390
+ Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use agents runs artifacts fetch.
373
391
 
374
392
  ### Options
375
393
 
@@ -573,25 +591,6 @@ Download one live agent file.
573
591
  | `--json` | no | | Output the raw server response as JSON |
574
592
  | `--out <file>` | no | | Output file path |
575
593
 
576
- ### `eigenpal agents|agent file put [options] <agent-id-or-slug> <remote-path> <local-path>`
577
-
578
- [removed] Git-backed agents — edit source in Git and run `eigenpal agents save`.
579
-
580
- ### Arguments
581
-
582
- | Name | Required | Variadic | Description |
583
- | ------------------ | -------- | -------- | ----------- |
584
- | `agent-id-or-slug` | yes | no | |
585
- | `remote-path` | yes | no | |
586
- | `local-path` | yes | no | |
587
-
588
- ### Options
589
-
590
- | Flag | Required | Default | Description |
591
- | ------------------ | -------- | ------- | -------------------------------------- |
592
- | `--base-url <url>` | no | | Server base URL |
593
- | `--json` | no | | Output the raw server response as JSON |
594
-
595
594
  ### `eigenpal agents|agent file diff [options] <agent-id-or-slug> <remote-path> <local-path>`
596
595
 
597
596
  Compare one live agent file against a local file.
@@ -777,45 +776,6 @@ Get one agent run.
777
776
  | `--json` | no | | Output the raw server response as JSON |
778
777
  | `--include <parts>` | no | `"feedback"` | Comma-separated extra parts: feedback,expected,files,trace,issues |
779
778
 
780
- ### `eigenpal agents|agent runs rerun [options] <run-id>`
781
-
782
- Create a new run from a previous run's stored input snapshot.
783
-
784
- ### Arguments
785
-
786
- | Name | Required | Variadic | Description |
787
- | -------- | -------- | -------- | ----------- |
788
- | `run-id` | yes | no | |
789
-
790
- ### Options
791
-
792
- | Flag | Required | Default | Description |
793
- | ---------------------- | -------- | ------- | ---------------------------------------------- |
794
- | `--base-url <url>` | no | | Server base URL |
795
- | `--json` | no | | Output the raw server response as JSON |
796
- | `--wait` | no | | Poll until the rerun reaches a terminal status |
797
- | `--interval <seconds>` | no | `2` | Polling interval in seconds |
798
- | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
799
-
800
- ### `eigenpal agents|agent runs pull [options] <run-id>`
801
-
802
- Download run feedback, expected artifacts, files, and metadata.
803
-
804
- ### Arguments
805
-
806
- | Name | Required | Variadic | Description |
807
- | -------- | -------- | -------- | ----------- |
808
- | `run-id` | yes | no | |
809
-
810
- ### Options
811
-
812
- | Flag | Required | Default | Description |
813
- | ------------------- | -------- | --------------------- | ---------------------------------------------------------------------------------------------- |
814
- | `--base-url <url>` | no | | Server base URL |
815
- | `--out <dir>` | no | | Output directory |
816
- | `--include <parts>` | no | `"feedback,expected"` | Comma-separated parts: feedback,expected,files,output,input,metadata,issues,trace,lockfile,all |
817
- | `--json` | no | | Output a JSON summary of written artifacts |
818
-
819
779
  ### `eigenpal agents|agent runs compare|diff [options] <reference-run-id> <run-id>`
820
780
 
821
781
  Compare one run against another run. PDF/DOCX text comparison uses pdftotext/python3 and reports byte fallbacks.
@@ -855,6 +815,26 @@ List available run artifacts without downloading them.
855
815
  | `--base-url <url>` | no | | Server base URL |
856
816
  | `--json` | no | | Output the raw server response as JSON |
857
817
 
818
+ ### `eigenpal agents|agent runs artifacts|artifact fetch [options] <run-id>`
819
+
820
+ Download run artifacts by canonical artifact path.
821
+
822
+ ### Arguments
823
+
824
+ | Name | Required | Variadic | Description |
825
+ | -------- | -------- | -------- | ----------- |
826
+ | `run-id` | yes | no | |
827
+
828
+ ### Options
829
+
830
+ | Flag | Required | Default | Description |
831
+ | ------------------- | -------- | ------- | ------------------------------------------------------------------------------- |
832
+ | `--base-url <url>` | no | | Server base URL |
833
+ | `--out <dir>` | no | | Output directory |
834
+ | `--include <parts>` | no | `"all"` | Comma-separated parts: output,input,metadata,issues,trace,lockfile,expected,all |
835
+ | `--path <path>` | no | `[]` | Fetch one exact artifact path from `artifacts list`; repeatable |
836
+ | `--json` | no | | Output a JSON summary of written artifacts |
837
+
858
838
  ### `eigenpal agents|agent runs trace [options] <run-id>`
859
839
 
860
840
  Print raw trace.jsonl for a run, or write it with --out.