@eigenpal/cli 0.6.8 → 0.6.10
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.
- package/CHANGELOG.md +6 -0
- package/README.md +2 -2
- package/dist/cli.js +1362 -1274
- package/dist/skill/SKILL.md +60 -57
- package/dist/skill/reference/cli/agents.md +143 -556
- package/dist/skill/reference/cli/init.md +1 -1
- package/dist/skill/reference/cli/runs.md +481 -0
- package/dist/skill/reference/cli/surface.md +135 -0
- package/dist/skill/reference/cli/workflow.md +35 -149
- package/dist/skill/reference/dataset-format.md +1 -1
- package/dist/skill/reference/debugging.md +23 -22
- package/dist/skill/reference/step-exec.md +3 -3
- package/dist/skill/reference/workflow-yaml.md +2 -2
- package/dist/templates/blank/README.md +1 -1
- package/dist/templates/pdf-extraction/README.md +1 -1
- package/dist/templates/text-classification/README.md +1 -1
- package/package.json +1 -1
|
@@ -10,79 +10,59 @@ Manage Eigenpal agents: Git source, datasets, runs, experiments, sessions, and r
|
|
|
10
10
|
- [File](#file)
|
|
11
11
|
- [Secret](#secret)
|
|
12
12
|
- [Dataset](#dataset)
|
|
13
|
-
- [Runs](#runs)
|
|
14
13
|
- [Experiment](#experiment)
|
|
15
14
|
- [Session](#session)
|
|
16
15
|
- [Env](#env)
|
|
17
16
|
- [Secrets](#secrets)
|
|
18
17
|
- [Details](#details)
|
|
19
|
-
- [`eigenpal agents
|
|
20
|
-
- [`eigenpal agents|
|
|
21
|
-
- [`eigenpal agents
|
|
22
|
-
- [`eigenpal agents
|
|
23
|
-
- [`eigenpal agents
|
|
24
|
-
- [`eigenpal agents
|
|
25
|
-
- [`eigenpal agents
|
|
26
|
-
- [`eigenpal agents
|
|
27
|
-
- [`eigenpal agents
|
|
28
|
-
- [`eigenpal agents
|
|
29
|
-
- [`eigenpal agents
|
|
30
|
-
- [`eigenpal agents
|
|
31
|
-
- [`eigenpal agents
|
|
32
|
-
- [`eigenpal agents
|
|
33
|
-
- [`eigenpal agents
|
|
34
|
-
- [`eigenpal agents
|
|
35
|
-
- [`eigenpal agents
|
|
36
|
-
- [`eigenpal agents
|
|
37
|
-
- [`eigenpal agents
|
|
38
|
-
- [`eigenpal agents|
|
|
39
|
-
- [`eigenpal agents
|
|
40
|
-
- [`eigenpal agents
|
|
41
|
-
- [`eigenpal agents
|
|
42
|
-
- [`eigenpal agents
|
|
43
|
-
- [`eigenpal agents
|
|
44
|
-
- [`eigenpal agents
|
|
45
|
-
- [`eigenpal agents
|
|
46
|
-
- [`eigenpal agents
|
|
47
|
-
- [`eigenpal agents
|
|
48
|
-
- [`eigenpal agents|
|
|
49
|
-
- [`eigenpal agents|
|
|
50
|
-
- [`eigenpal agents|
|
|
51
|
-
- [`eigenpal agents|
|
|
52
|
-
- [`eigenpal agents
|
|
53
|
-
- [`eigenpal agents
|
|
54
|
-
- [`eigenpal agents
|
|
55
|
-
- [`eigenpal agents
|
|
56
|
-
- [`eigenpal agents
|
|
57
|
-
- [`eigenpal agents
|
|
58
|
-
- [`eigenpal agents
|
|
59
|
-
- [`eigenpal agents
|
|
60
|
-
- [`eigenpal agents
|
|
61
|
-
- [`eigenpal agents|agent runs expected copy-output [options] <run-id> <output-file>`](#eigenpal-agentsagent-runs-expected-copy-output-options-run-id-output-file)
|
|
62
|
-
- [`eigenpal agents|agent runs expected rename [options] <run-id> <old-name> <new-name>`](#eigenpal-agentsagent-runs-expected-rename-options-run-id-old-name-new-name)
|
|
63
|
-
- [`eigenpal agents|agent runs expected delete [options] <run-id> <name>`](#eigenpal-agentsagent-runs-expected-delete-options-run-id-name)
|
|
64
|
-
- [`eigenpal agents|agent runs watch [options] <run-id>`](#eigenpal-agentsagent-runs-watch-options-run-id)
|
|
65
|
-
- [`eigenpal agents|agent runs cancel [options] <run-id>`](#eigenpal-agentsagent-runs-cancel-options-run-id)
|
|
66
|
-
- [`eigenpal agents|agent experiment|exp run [options] <agent-id-or-slug>`](#eigenpal-agentsagent-experimentexp-run-options-agent-id-or-slug)
|
|
67
|
-
- [`eigenpal agents|agent experiment|exp status [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agentsagent-experimentexp-status-options-agent-id-or-slug-batch-id)
|
|
68
|
-
- [`eigenpal agents|agent experiment|exp results [options] <agent-id-or-slug> [batch-id]`](#eigenpal-agentsagent-experimentexp-results-options-agent-id-or-slug-batch-id)
|
|
69
|
-
- [`eigenpal agents|agent experiment|exp list|ls [options] <agent-id-or-slug>`](#eigenpal-agentsagent-experimentexp-listls-options-agent-id-or-slug)
|
|
70
|
-
- [`eigenpal agents|agent experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>`](#eigenpal-agentsagent-experimentexp-comparediff-options-batch-id-a-batch-id-b)
|
|
71
|
-
- [`eigenpal agents|agent experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agentsagent-experimentexp-cancel-options-agent-id-or-slug-batch-id)
|
|
72
|
-
- [`eigenpal agents|agent session list|ls [options] <agent-id-or-slug>`](#eigenpal-agentsagent-session-listls-options-agent-id-or-slug)
|
|
73
|
-
- [`eigenpal agents|agent session get [options] <session-id>`](#eigenpal-agentsagent-session-get-options-session-id)
|
|
74
|
-
- [`eigenpal agents|agent session start [options] <agent-id-or-slug>`](#eigenpal-agentsagent-session-start-options-agent-id-or-slug)
|
|
75
|
-
- [`eigenpal agents|agent session message [options] <session-id>`](#eigenpal-agentsagent-session-message-options-session-id)
|
|
76
|
-
- [`eigenpal agents|agent session stop [options] <session-id>`](#eigenpal-agentsagent-session-stop-options-session-id)
|
|
77
|
-
- [`eigenpal agents|agent env pull [options] [target]`](#eigenpal-agentsagent-env-pull-options-target)
|
|
78
|
-
- [`eigenpal agents|agent secrets export [options] [target]`](#eigenpal-agentsagent-secrets-export-options-target)
|
|
18
|
+
- [`eigenpal agents run [options] <target>`](#eigenpal-agents-run-options-target)
|
|
19
|
+
- [`eigenpal agents list|ls [options]`](#eigenpal-agents-listls-options)
|
|
20
|
+
- [`eigenpal agents validate [options] [dir]`](#eigenpal-agents-validate-options-dir)
|
|
21
|
+
- [`eigenpal agents clone [options]`](#eigenpal-agents-clone-options)
|
|
22
|
+
- [`eigenpal agents install [options] [packageRef]`](#eigenpal-agents-install-options-packageref)
|
|
23
|
+
- [`eigenpal agents init [options] <name>`](#eigenpal-agents-init-options-name)
|
|
24
|
+
- [`eigenpal agents pull [options]`](#eigenpal-agents-pull-options)
|
|
25
|
+
- [`eigenpal agents commit [options]`](#eigenpal-agents-commit-options)
|
|
26
|
+
- [`eigenpal agents save [options]`](#eigenpal-agents-save-options)
|
|
27
|
+
- [`eigenpal agents push [options]`](#eigenpal-agents-push-options)
|
|
28
|
+
- [`eigenpal agents upgrade [options]`](#eigenpal-agents-upgrade-options)
|
|
29
|
+
- [`eigenpal agents doctor [options]`](#eigenpal-agents-doctor-options)
|
|
30
|
+
- [`eigenpal agents status [options]`](#eigenpal-agents-status-options)
|
|
31
|
+
- [`eigenpal agents deps [options]`](#eigenpal-agents-deps-options)
|
|
32
|
+
- [`eigenpal agents clean [options]`](#eigenpal-agents-clean-options)
|
|
33
|
+
- [`eigenpal agents show [options] <automation>`](#eigenpal-agents-show-options-automation)
|
|
34
|
+
- [`eigenpal agents versions [options] <package>`](#eigenpal-agents-versions-options-package)
|
|
35
|
+
- [`eigenpal agents release [options] <version> [dir]`](#eigenpal-agents-release-options-version-dir)
|
|
36
|
+
- [`eigenpal agents sync [options] [automation]`](#eigenpal-agents-sync-options-automation)
|
|
37
|
+
- [`eigenpal agents file list|ls [options] <agent-id-or-slug>`](#eigenpal-agents-file-listls-options-agent-id-or-slug)
|
|
38
|
+
- [`eigenpal agents file get [options] <agent-id-or-slug> <remote-path>`](#eigenpal-agents-file-get-options-agent-id-or-slug-remote-path)
|
|
39
|
+
- [`eigenpal agents file diff [options] <agent-id-or-slug> <remote-path> <local-path>`](#eigenpal-agents-file-diff-options-agent-id-or-slug-remote-path-local-path)
|
|
40
|
+
- [`eigenpal agents secret set [options] <name>`](#eigenpal-agents-secret-set-options-name)
|
|
41
|
+
- [`eigenpal agents secret unset [options] <name>`](#eigenpal-agents-secret-unset-options-name)
|
|
42
|
+
- [`eigenpal agents secret import [options] <env-file>`](#eigenpal-agents-secret-import-options-env-file)
|
|
43
|
+
- [`eigenpal agents dataset list|ls [options] <agent-id-or-slug>`](#eigenpal-agents-dataset-listls-options-agent-id-or-slug)
|
|
44
|
+
- [`eigenpal agents dataset push [options] <agent-id-or-slug>`](#eigenpal-agents-dataset-push-options-agent-id-or-slug)
|
|
45
|
+
- [`eigenpal agents dataset pull [options] <agent-id-or-slug>`](#eigenpal-agents-dataset-pull-options-agent-id-or-slug)
|
|
46
|
+
- [`eigenpal agents dataset validate [options] [path]`](#eigenpal-agents-dataset-validate-options-path)
|
|
47
|
+
- [`eigenpal agents experiment|exp run [options] <agent-id-or-slug>`](#eigenpal-agents-experimentexp-run-options-agent-id-or-slug)
|
|
48
|
+
- [`eigenpal agents experiment|exp status [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agents-experimentexp-status-options-agent-id-or-slug-batch-id)
|
|
49
|
+
- [`eigenpal agents experiment|exp results [options] <agent-id-or-slug> [batch-id]`](#eigenpal-agents-experimentexp-results-options-agent-id-or-slug-batch-id)
|
|
50
|
+
- [`eigenpal agents experiment|exp list|ls [options] <agent-id-or-slug>`](#eigenpal-agents-experimentexp-listls-options-agent-id-or-slug)
|
|
51
|
+
- [`eigenpal agents experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>`](#eigenpal-agents-experimentexp-comparediff-options-batch-id-a-batch-id-b)
|
|
52
|
+
- [`eigenpal agents experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agents-experimentexp-cancel-options-agent-id-or-slug-batch-id)
|
|
53
|
+
- [`eigenpal agents session list|ls [options] <agent-id-or-slug>`](#eigenpal-agents-session-listls-options-agent-id-or-slug)
|
|
54
|
+
- [`eigenpal agents session get [options] <session-id>`](#eigenpal-agents-session-get-options-session-id)
|
|
55
|
+
- [`eigenpal agents session start [options] <agent-id-or-slug>`](#eigenpal-agents-session-start-options-agent-id-or-slug)
|
|
56
|
+
- [`eigenpal agents session message [options] <session-id>`](#eigenpal-agents-session-message-options-session-id)
|
|
57
|
+
- [`eigenpal agents session stop [options] <session-id>`](#eigenpal-agents-session-stop-options-session-id)
|
|
58
|
+
- [`eigenpal agents env pull [options] [target]`](#eigenpal-agents-env-pull-options-target)
|
|
59
|
+
- [`eigenpal agents secrets export [options] [target]`](#eigenpal-agents-secrets-export-options-target)
|
|
79
60
|
|
|
80
61
|
## Surface
|
|
81
62
|
|
|
82
63
|
```
|
|
83
64
|
agents
|
|
84
65
|
├── run <target>
|
|
85
|
-
├── rerun <run-id>
|
|
86
66
|
├── list|ls
|
|
87
67
|
├── file
|
|
88
68
|
│ ├── list|ls <agent-id-or-slug>
|
|
@@ -114,27 +94,6 @@ agents
|
|
|
114
94
|
│ ├── push <agent-id-or-slug>
|
|
115
95
|
│ ├── pull <agent-id-or-slug>
|
|
116
96
|
│ └── validate [path]
|
|
117
|
-
├── runs
|
|
118
|
-
│ ├── list|ls <target>
|
|
119
|
-
│ ├── get <run-id>
|
|
120
|
-
│ ├── compare|diff <reference-run-id> <run-id>
|
|
121
|
-
│ ├── artifacts|artifact
|
|
122
|
-
│ │ ├── list|ls <run-id>
|
|
123
|
-
│ │ └── fetch <run-id>
|
|
124
|
-
│ ├── trace <run-id>
|
|
125
|
-
│ ├── feedback|fb
|
|
126
|
-
│ │ ├── update <run-id>
|
|
127
|
-
│ │ ├── resolve <run-id>
|
|
128
|
-
│ │ └── clear <run-id>
|
|
129
|
-
│ ├── expected
|
|
130
|
-
│ │ ├── list|ls <run-id>
|
|
131
|
-
│ │ ├── pull <run-id>
|
|
132
|
-
│ │ ├── upload <run-id> <file>
|
|
133
|
-
│ │ ├── copy-output <run-id> <output-file>
|
|
134
|
-
│ │ ├── rename <run-id> <old-name> <new-name>
|
|
135
|
-
│ │ └── delete <run-id> <name>
|
|
136
|
-
│ ├── watch <run-id>
|
|
137
|
-
│ └── cancel <run-id>
|
|
138
97
|
├── experiment|exp
|
|
139
98
|
│ ├── run <agent-id-or-slug>
|
|
140
99
|
│ ├── status <agent-id-or-slug> <batch-id>
|
|
@@ -158,112 +117,89 @@ agents
|
|
|
158
117
|
|
|
159
118
|
### Core
|
|
160
119
|
|
|
161
|
-
| Command
|
|
162
|
-
|
|
|
163
|
-
| `eigenpal agents
|
|
164
|
-
| `eigenpal agents\|
|
|
165
|
-
| `eigenpal agents
|
|
166
|
-
| `eigenpal agents
|
|
167
|
-
| `eigenpal agents
|
|
168
|
-
| `eigenpal agents
|
|
169
|
-
| `eigenpal agents
|
|
170
|
-
| `eigenpal agents
|
|
171
|
-
| `eigenpal agents
|
|
172
|
-
| `eigenpal agents
|
|
173
|
-
| `eigenpal agents
|
|
174
|
-
| `eigenpal agents
|
|
175
|
-
| `eigenpal agents
|
|
176
|
-
| `eigenpal agents
|
|
177
|
-
| `eigenpal agents
|
|
178
|
-
| `eigenpal agents
|
|
179
|
-
| `eigenpal agents
|
|
180
|
-
| `eigenpal agents
|
|
181
|
-
| `eigenpal agents
|
|
182
|
-
| `eigenpal agents\|agent sync [options] [automation]` | Sync an automation from the latest Git source release. |
|
|
120
|
+
| Command | Description |
|
|
121
|
+
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
122
|
+
| `eigenpal agents run [options] <target>` | Run an agent target, e.g. agents.invoice-agent@latest. |
|
|
123
|
+
| `eigenpal agents list\|ls [options]` | List agents. |
|
|
124
|
+
| `eigenpal agents validate [options] [dir]` | Validate a local agent package (layout, manifest, schemas, and Git source rules). |
|
|
125
|
+
| `eigenpal agents clone [options]` | Clone the organization source repository. |
|
|
126
|
+
| `eigenpal agents install [options] [packageRef]` | Materialize a source package and its workspace dependencies. |
|
|
127
|
+
| `eigenpal agents init [options] <name>` | Create a new source package scaffold. |
|
|
128
|
+
| `eigenpal agents pull [options]` | Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use runs artifacts fetch. |
|
|
129
|
+
| `eigenpal agents commit [options]` | Validate changed source packages and commit them. |
|
|
130
|
+
| `eigenpal agents save [options]` | Validate, commit if dirty, and push the current source branch. |
|
|
131
|
+
| `eigenpal agents push [options]` | Push the current organization source branch and tags. |
|
|
132
|
+
| `eigenpal agents upgrade [options]` | Upgrade the source repository schema in place. |
|
|
133
|
+
| `eigenpal agents doctor [options]` | Check organization source repository health. |
|
|
134
|
+
| `eigenpal agents status [options]` | Show source repo and package status. |
|
|
135
|
+
| `eigenpal agents deps [options]` | List package workspace dependencies. |
|
|
136
|
+
| `eigenpal agents clean [options]` | Require a clean source working tree. |
|
|
137
|
+
| `eigenpal agents show [options] <automation>` | Show Git-backed automation details. |
|
|
138
|
+
| `eigenpal agents versions [options] <package>` | List package release versions. |
|
|
139
|
+
| `eigenpal agents release [options] <version> [dir]` | Create and push an immutable package release tag. Never move or overwrite an existing tag; release a new patch instead. |
|
|
140
|
+
| `eigenpal agents sync [options] [automation]` | Sync an automation from the latest Git source release. |
|
|
183
141
|
|
|
184
142
|
### File
|
|
185
143
|
|
|
186
|
-
| Command
|
|
187
|
-
|
|
|
188
|
-
| `eigenpal agents
|
|
189
|
-
| `eigenpal agents
|
|
190
|
-
| `eigenpal agents
|
|
144
|
+
| Command | Description |
|
|
145
|
+
| ----------------------------------------------------------------------------------- | ------------------------------------------------- |
|
|
146
|
+
| `eigenpal agents file list\|ls [options] <agent-id-or-slug>` | List live files for an agent. |
|
|
147
|
+
| `eigenpal agents file get [options] <agent-id-or-slug> <remote-path>` | Download one live agent file. |
|
|
148
|
+
| `eigenpal agents file diff [options] <agent-id-or-slug> <remote-path> <local-path>` | Compare one live agent file against a local file. |
|
|
191
149
|
|
|
192
150
|
### Secret
|
|
193
151
|
|
|
194
|
-
| Command
|
|
195
|
-
|
|
|
196
|
-
| `eigenpal agents
|
|
197
|
-
| `eigenpal agents
|
|
198
|
-
| `eigenpal agents
|
|
152
|
+
| Command | Description |
|
|
153
|
+
| ---------------------------------------------------- | ---------------------------------------------------------------- |
|
|
154
|
+
| `eigenpal agents secret set [options] <name>` | Encrypt and set a secret value in secrets.enc.yaml. |
|
|
155
|
+
| `eigenpal agents secret unset [options] <name>` | Remove a secret from secrets.enc.yaml. |
|
|
156
|
+
| `eigenpal agents secret import [options] <env-file>` | Import KEY=value entries from an env file into secrets.enc.yaml. |
|
|
199
157
|
|
|
200
158
|
### Dataset
|
|
201
159
|
|
|
202
|
-
| Command
|
|
203
|
-
|
|
|
204
|
-
| `eigenpal agents
|
|
205
|
-
| `eigenpal agents
|
|
206
|
-
| `eigenpal agents
|
|
207
|
-
| `eigenpal agents
|
|
208
|
-
|
|
209
|
-
### Runs
|
|
210
|
-
|
|
211
|
-
| Command | Description |
|
|
212
|
-
| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
|
|
213
|
-
| `eigenpal agents\|agent runs list\|ls [options] <target>` | List runs for an agent target; unqualified targets include all source refs. |
|
|
214
|
-
| `eigenpal agents\|agent runs get [options] <run-id>` | Get one agent run. |
|
|
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. |
|
|
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. |
|
|
218
|
-
| `eigenpal agents\|agent runs trace [options] <run-id>` | Print raw trace.jsonl for a run, or write it with --out. |
|
|
219
|
-
| `eigenpal agents\|agent runs feedback\|fb update [options] <run-id>` | Edit feedback state, rating, message, or expected JSON for a run. |
|
|
220
|
-
| `eigenpal agents\|agent runs feedback\|fb resolve [options] <run-id>` | Mark run feedback as resolved. |
|
|
221
|
-
| `eigenpal agents\|agent runs feedback\|fb clear [options] <run-id>` | Delete feedback, expected.json, and expected files for a run. |
|
|
222
|
-
| `eigenpal agents\|agent runs expected list\|ls [options] <run-id>` | List expected JSON and files attached to a run. |
|
|
223
|
-
| `eigenpal agents\|agent runs expected pull [options] <run-id>` | Download expected JSON and files attached to a run. |
|
|
224
|
-
| `eigenpal agents\|agent runs expected upload [options] <run-id> <file>` | Upload a local file as an expected artifact. |
|
|
225
|
-
| `eigenpal agents\|agent runs expected copy-output [options] <run-id> <output-file>` | Copy a generated output file into expected artifacts. |
|
|
226
|
-
| `eigenpal agents\|agent runs expected rename [options] <run-id> <old-name> <new-name>` | Rename an expected artifact. |
|
|
227
|
-
| `eigenpal agents\|agent runs expected delete [options] <run-id> <name>` | Delete an expected artifact. |
|
|
228
|
-
| `eigenpal agents\|agent runs watch [options] <run-id>` | Watch a run until it reaches a terminal status. |
|
|
229
|
-
| `eigenpal agents\|agent runs cancel [options] <run-id>` | Cancel an agent run. |
|
|
160
|
+
| Command | Description |
|
|
161
|
+
| --------------------------------------------------------------- | -------------------------------------------------------------------------- |
|
|
162
|
+
| `eigenpal agents dataset list\|ls [options] <agent-id-or-slug>` | List dataset examples for an agent. |
|
|
163
|
+
| `eigenpal agents dataset push [options] <agent-id-or-slug>` | Upload dataset examples from a local dataset directory. |
|
|
164
|
+
| `eigenpal agents dataset pull [options] <agent-id-or-slug>` | Download an agent dataset directory. |
|
|
165
|
+
| `eigenpal agents dataset validate [options] [path]` | Validate a local dataset directory against the agent input/output schemas. |
|
|
230
166
|
|
|
231
167
|
### Experiment
|
|
232
168
|
|
|
233
|
-
| Command
|
|
234
|
-
|
|
|
235
|
-
| `eigenpal agents
|
|
236
|
-
| `eigenpal agents
|
|
237
|
-
| `eigenpal agents
|
|
238
|
-
| `eigenpal agents
|
|
239
|
-
| `eigenpal agents
|
|
240
|
-
| `eigenpal agents
|
|
169
|
+
| Command | Description |
|
|
170
|
+
| ----------------------------------------------------------------------------------- | ----------------------------------------------- |
|
|
171
|
+
| `eigenpal agents experiment\|exp run [options] <agent-id-or-slug>` | Start an experiment over dataset examples. |
|
|
172
|
+
| `eigenpal agents experiment\|exp status [options] <agent-id-or-slug> <batch-id>` | Get experiment status. |
|
|
173
|
+
| `eigenpal agents experiment\|exp results [options] <agent-id-or-slug> [batch-id]` | Print experiment results as JSON or CSV. |
|
|
174
|
+
| `eigenpal agents experiment\|exp list\|ls [options] <agent-id-or-slug>` | List experiments. |
|
|
175
|
+
| `eigenpal agents experiment\|exp compare\|diff [options] <batch-id-a> <batch-id-b>` | Compare two experiment batches. |
|
|
176
|
+
| `eigenpal agents experiment\|exp cancel [options] <agent-id-or-slug> <batch-id>` | Cancel every active execution in an experiment. |
|
|
241
177
|
|
|
242
178
|
### Session
|
|
243
179
|
|
|
244
|
-
| Command
|
|
245
|
-
|
|
|
246
|
-
| `eigenpal agents
|
|
247
|
-
| `eigenpal agents
|
|
248
|
-
| `eigenpal agents
|
|
249
|
-
| `eigenpal agents
|
|
250
|
-
| `eigenpal agents
|
|
180
|
+
| Command | Description |
|
|
181
|
+
| --------------------------------------------------------------- | -------------------------------------- |
|
|
182
|
+
| `eigenpal agents session list\|ls [options] <agent-id-or-slug>` | List builder sessions for an agent. |
|
|
183
|
+
| `eigenpal agents session get [options] <session-id>` | Get a builder session and messages. |
|
|
184
|
+
| `eigenpal agents session start [options] <agent-id-or-slug>` | Start a builder session. |
|
|
185
|
+
| `eigenpal agents session message [options] <session-id>` | Append a message to a builder session. |
|
|
186
|
+
| `eigenpal agents session stop [options] <session-id>` | Stop a builder session. |
|
|
251
187
|
|
|
252
188
|
### Env
|
|
253
189
|
|
|
254
|
-
| Command
|
|
255
|
-
|
|
|
256
|
-
| `eigenpal agents
|
|
190
|
+
| Command | Description |
|
|
191
|
+
| --------------------------------------------- | ----------------------------------------------- |
|
|
192
|
+
| `eigenpal agents env pull [options] [target]` | Decrypt source secrets and print shell exports. |
|
|
257
193
|
|
|
258
194
|
### Secrets
|
|
259
195
|
|
|
260
|
-
| Command
|
|
261
|
-
|
|
|
262
|
-
| `eigenpal agents
|
|
196
|
+
| Command | Description |
|
|
197
|
+
| --------------------------------------------------- | ----------------------------------------------- |
|
|
198
|
+
| `eigenpal agents secrets export [options] [target]` | Decrypt source secrets and print shell exports. |
|
|
263
199
|
|
|
264
200
|
## Details
|
|
265
201
|
|
|
266
|
-
### `eigenpal agents
|
|
202
|
+
### `eigenpal agents run [options] <target>`
|
|
267
203
|
|
|
268
204
|
Run an agent target, e.g. agents.invoice-agent@latest.
|
|
269
205
|
|
|
@@ -286,28 +222,7 @@ Run an agent target, e.g. agents.invoice-agent@latest.
|
|
|
286
222
|
| `--interval <seconds>` | no | `2` | Polling interval in seconds |
|
|
287
223
|
| `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
|
|
288
224
|
|
|
289
|
-
### `eigenpal agents|
|
|
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 |
|
|
309
|
-
|
|
310
|
-
### `eigenpal agents|agent list|ls [options]`
|
|
225
|
+
### `eigenpal agents list|ls [options]`
|
|
311
226
|
|
|
312
227
|
List agents.
|
|
313
228
|
|
|
@@ -321,7 +236,7 @@ List agents.
|
|
|
321
236
|
| `--json` | no | | Output the raw server response as JSON |
|
|
322
237
|
| `--search <q>` | no | | Search by slug, name, or description |
|
|
323
238
|
|
|
324
|
-
### `eigenpal agents
|
|
239
|
+
### `eigenpal agents validate [options] [dir]`
|
|
325
240
|
|
|
326
241
|
Validate a local agent package (layout, manifest, schemas, and Git source rules).
|
|
327
242
|
|
|
@@ -337,7 +252,7 @@ Validate a local agent package (layout, manifest, schemas, and Git source rules)
|
|
|
337
252
|
| -------- | -------- | ------- | -------------------------------------- |
|
|
338
253
|
| `--json` | no | | Output the raw server response as JSON |
|
|
339
254
|
|
|
340
|
-
### `eigenpal agents
|
|
255
|
+
### `eigenpal agents clone [options]`
|
|
341
256
|
|
|
342
257
|
Clone the organization source repository.
|
|
343
258
|
|
|
@@ -349,7 +264,7 @@ Clone the organization source repository.
|
|
|
349
264
|
| `--out <dir>` | no | | Output directory |
|
|
350
265
|
| `--tenant-id <tenantId>` | no | | Target tenant id for admin-token source clones |
|
|
351
266
|
|
|
352
|
-
### `eigenpal agents
|
|
267
|
+
### `eigenpal agents install [options] [packageRef]`
|
|
353
268
|
|
|
354
269
|
Materialize a source package and its workspace dependencies.
|
|
355
270
|
|
|
@@ -369,7 +284,7 @@ Materialize a source package and its workspace dependencies.
|
|
|
369
284
|
| `--frozen-lockfile` | no | | Install exactly from the existing lockfile |
|
|
370
285
|
| `--remote-url <url>` | no | | Use an explicit organization Git remote URL |
|
|
371
286
|
|
|
372
|
-
### `eigenpal agents
|
|
287
|
+
### `eigenpal agents init [options] <name>`
|
|
373
288
|
|
|
374
289
|
Create a new source package scaffold.
|
|
375
290
|
|
|
@@ -386,9 +301,9 @@ Create a new source package scaffold.
|
|
|
386
301
|
| `--template <template>` | yes | | Package template |
|
|
387
302
|
| `--dir <dir>` | no | | Repository directory |
|
|
388
303
|
|
|
389
|
-
### `eigenpal agents
|
|
304
|
+
### `eigenpal agents pull [options]`
|
|
390
305
|
|
|
391
|
-
Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use
|
|
306
|
+
Pull organization source from origin/main with --ff-only. For datasets use agents dataset pull; for run artifacts use runs artifacts fetch.
|
|
392
307
|
|
|
393
308
|
### Options
|
|
394
309
|
|
|
@@ -397,7 +312,7 @@ Pull organization source from origin/main with --ff-only. For datasets use agent
|
|
|
397
312
|
| `--base-url <url>` | no | | Server base URL |
|
|
398
313
|
| `--dir <dir>` | no | | Repository directory |
|
|
399
314
|
|
|
400
|
-
### `eigenpal agents
|
|
315
|
+
### `eigenpal agents commit [options]`
|
|
401
316
|
|
|
402
317
|
Validate changed source packages and commit them.
|
|
403
318
|
|
|
@@ -409,7 +324,7 @@ Validate changed source packages and commit them.
|
|
|
409
324
|
| `-m, --message <message>` | yes | | Commit message |
|
|
410
325
|
| `--dir <dir>` | no | | Repository directory |
|
|
411
326
|
|
|
412
|
-
### `eigenpal agents
|
|
327
|
+
### `eigenpal agents save [options]`
|
|
413
328
|
|
|
414
329
|
Validate, commit if dirty, and push the current source branch.
|
|
415
330
|
|
|
@@ -421,7 +336,7 @@ Validate, commit if dirty, and push the current source branch.
|
|
|
421
336
|
| `-m, --message <message>` | no | | Commit message when source changes are dirty |
|
|
422
337
|
| `--dir <dir>` | no | | Repository directory |
|
|
423
338
|
|
|
424
|
-
### `eigenpal agents
|
|
339
|
+
### `eigenpal agents push [options]`
|
|
425
340
|
|
|
426
341
|
Push the current organization source branch and tags.
|
|
427
342
|
|
|
@@ -432,7 +347,7 @@ Push the current organization source branch and tags.
|
|
|
432
347
|
| `--base-url <url>` | no | | Server base URL |
|
|
433
348
|
| `--dir <dir>` | no | | Repository directory |
|
|
434
349
|
|
|
435
|
-
### `eigenpal agents
|
|
350
|
+
### `eigenpal agents upgrade [options]`
|
|
436
351
|
|
|
437
352
|
Upgrade the source repository schema in place.
|
|
438
353
|
|
|
@@ -443,7 +358,7 @@ Upgrade the source repository schema in place.
|
|
|
443
358
|
| `--dir <dir>` | no | | Repository directory |
|
|
444
359
|
| `--dry-run` | no | | Print upgrade actions without changing files |
|
|
445
360
|
|
|
446
|
-
### `eigenpal agents
|
|
361
|
+
### `eigenpal agents doctor [options]`
|
|
447
362
|
|
|
448
363
|
Check organization source repository health.
|
|
449
364
|
|
|
@@ -454,7 +369,7 @@ Check organization source repository health.
|
|
|
454
369
|
| `--json` | no | | Output the raw server response as JSON |
|
|
455
370
|
| `--dir <dir>` | no | | Directory to inspect |
|
|
456
371
|
|
|
457
|
-
### `eigenpal agents
|
|
372
|
+
### `eigenpal agents status [options]`
|
|
458
373
|
|
|
459
374
|
Show source repo and package status.
|
|
460
375
|
|
|
@@ -465,7 +380,7 @@ Show source repo and package status.
|
|
|
465
380
|
| `--json` | no | | Output the raw server response as JSON |
|
|
466
381
|
| `--dir <dir>` | no | | Directory to inspect |
|
|
467
382
|
|
|
468
|
-
### `eigenpal agents
|
|
383
|
+
### `eigenpal agents deps [options]`
|
|
469
384
|
|
|
470
385
|
List package workspace dependencies.
|
|
471
386
|
|
|
@@ -476,7 +391,7 @@ List package workspace dependencies.
|
|
|
476
391
|
| `--json` | no | | Output the raw server response as JSON |
|
|
477
392
|
| `--dir <dir>` | no | | Directory to inspect |
|
|
478
393
|
|
|
479
|
-
### `eigenpal agents
|
|
394
|
+
### `eigenpal agents clean [options]`
|
|
480
395
|
|
|
481
396
|
Require a clean source working tree.
|
|
482
397
|
|
|
@@ -486,7 +401,7 @@ Require a clean source working tree.
|
|
|
486
401
|
| ------------- | -------- | ------- | -------------------- |
|
|
487
402
|
| `--dir <dir>` | no | | Directory to inspect |
|
|
488
403
|
|
|
489
|
-
### `eigenpal agents
|
|
404
|
+
### `eigenpal agents show [options] <automation>`
|
|
490
405
|
|
|
491
406
|
Show Git-backed automation details.
|
|
492
407
|
|
|
@@ -503,7 +418,7 @@ Show Git-backed automation details.
|
|
|
503
418
|
| `--base-url <url>` | no | | Server base URL |
|
|
504
419
|
| `--json` | no | | Output the raw server response as JSON |
|
|
505
420
|
|
|
506
|
-
### `eigenpal agents
|
|
421
|
+
### `eigenpal agents versions [options] <package>`
|
|
507
422
|
|
|
508
423
|
List package release versions.
|
|
509
424
|
|
|
@@ -520,7 +435,7 @@ List package release versions.
|
|
|
520
435
|
| `--base-url <url>` | no | | Server base URL |
|
|
521
436
|
| `--json` | no | | Output the raw server response as JSON |
|
|
522
437
|
|
|
523
|
-
### `eigenpal agents
|
|
438
|
+
### `eigenpal agents release [options] <version> [dir]`
|
|
524
439
|
|
|
525
440
|
Create and push an immutable package release tag. Never move or overwrite an existing tag; release a new patch instead.
|
|
526
441
|
|
|
@@ -538,7 +453,7 @@ Create and push an immutable package release tag. Never move or overwrite an exi
|
|
|
538
453
|
| `--base-url <url>` | no | | Server base URL |
|
|
539
454
|
| `-m, --message <message>` | no | | Annotated tag message (default: Release <packagePath>) |
|
|
540
455
|
|
|
541
|
-
### `eigenpal agents
|
|
456
|
+
### `eigenpal agents sync [options] [automation]`
|
|
542
457
|
|
|
543
458
|
Sync an automation from the latest Git source release.
|
|
544
459
|
|
|
@@ -555,7 +470,7 @@ Sync an automation from the latest Git source release.
|
|
|
555
470
|
| `--base-url <url>` | no | | Server base URL |
|
|
556
471
|
| `--dir <dir>` | no | | Directory to inspect |
|
|
557
472
|
|
|
558
|
-
### `eigenpal agents
|
|
473
|
+
### `eigenpal agents file list|ls [options] <agent-id-or-slug>`
|
|
559
474
|
|
|
560
475
|
List live files for an agent.
|
|
561
476
|
|
|
@@ -573,7 +488,7 @@ List live files for an agent.
|
|
|
573
488
|
| `--json` | no | | Output the raw server response as JSON |
|
|
574
489
|
| `--path <prefix>` | no | | Only list files beneath this relative path |
|
|
575
490
|
|
|
576
|
-
### `eigenpal agents
|
|
491
|
+
### `eigenpal agents file get [options] <agent-id-or-slug> <remote-path>`
|
|
577
492
|
|
|
578
493
|
Download one live agent file.
|
|
579
494
|
|
|
@@ -592,7 +507,7 @@ Download one live agent file.
|
|
|
592
507
|
| `--json` | no | | Output the raw server response as JSON |
|
|
593
508
|
| `--out <file>` | no | | Output file path |
|
|
594
509
|
|
|
595
|
-
### `eigenpal agents
|
|
510
|
+
### `eigenpal agents file diff [options] <agent-id-or-slug> <remote-path> <local-path>`
|
|
596
511
|
|
|
597
512
|
Compare one live agent file against a local file.
|
|
598
513
|
|
|
@@ -611,7 +526,7 @@ Compare one live agent file against a local file.
|
|
|
611
526
|
| `--base-url <url>` | no | | Server base URL |
|
|
612
527
|
| `--json` | no | | Output the raw server response as JSON |
|
|
613
528
|
|
|
614
|
-
### `eigenpal agents
|
|
529
|
+
### `eigenpal agents secret set [options] <name>`
|
|
615
530
|
|
|
616
531
|
Encrypt and set a secret value in secrets.enc.yaml.
|
|
617
532
|
|
|
@@ -630,7 +545,7 @@ Encrypt and set a secret value in secrets.enc.yaml.
|
|
|
630
545
|
| `--value-file <path>` | no | | Read the secret value from a file |
|
|
631
546
|
| `--description <text>` | no | | Secret description |
|
|
632
547
|
|
|
633
|
-
### `eigenpal agents
|
|
548
|
+
### `eigenpal agents secret unset [options] <name>`
|
|
634
549
|
|
|
635
550
|
Remove a secret from secrets.enc.yaml.
|
|
636
551
|
|
|
@@ -646,7 +561,7 @@ Remove a secret from secrets.enc.yaml.
|
|
|
646
561
|
| ------------- | -------- | ------- | -------------------- |
|
|
647
562
|
| `--dir <dir>` | no | | Directory to inspect |
|
|
648
563
|
|
|
649
|
-
### `eigenpal agents
|
|
564
|
+
### `eigenpal agents secret import [options] <env-file>`
|
|
650
565
|
|
|
651
566
|
Import KEY=value entries from an env file into secrets.enc.yaml.
|
|
652
567
|
|
|
@@ -662,7 +577,7 @@ Import KEY=value entries from an env file into secrets.enc.yaml.
|
|
|
662
577
|
| ------------- | -------- | ------- | -------------------- |
|
|
663
578
|
| `--dir <dir>` | no | | Directory to inspect |
|
|
664
579
|
|
|
665
|
-
### `eigenpal agents
|
|
580
|
+
### `eigenpal agents dataset list|ls [options] <agent-id-or-slug>`
|
|
666
581
|
|
|
667
582
|
List dataset examples for an agent.
|
|
668
583
|
|
|
@@ -681,7 +596,7 @@ List dataset examples for an agent.
|
|
|
681
596
|
| `--offset <n>` | no | `0` | Page offset |
|
|
682
597
|
| `--json` | no | | Output the raw server response as JSON |
|
|
683
598
|
|
|
684
|
-
### `eigenpal agents
|
|
599
|
+
### `eigenpal agents dataset push [options] <agent-id-or-slug>`
|
|
685
600
|
|
|
686
601
|
Upload dataset examples from a local dataset directory.
|
|
687
602
|
|
|
@@ -701,7 +616,7 @@ Upload dataset examples from a local dataset directory.
|
|
|
701
616
|
| `--mode <append\|replace>` | no | `"append"` | Upload mode |
|
|
702
617
|
| `--yes` | no | | Confirm replace mode in non-interactive environments |
|
|
703
618
|
|
|
704
|
-
### `eigenpal agents
|
|
619
|
+
### `eigenpal agents dataset pull [options] <agent-id-or-slug>`
|
|
705
620
|
|
|
706
621
|
Download an agent dataset directory.
|
|
707
622
|
|
|
@@ -718,7 +633,7 @@ Download an agent dataset directory.
|
|
|
718
633
|
| `--base-url <url>` | no | | Server base URL |
|
|
719
634
|
| `--out <dir>` | no | `"dataset"` | Output directory |
|
|
720
635
|
|
|
721
|
-
### `eigenpal agents
|
|
636
|
+
### `eigenpal agents dataset validate [options] [path]`
|
|
722
637
|
|
|
723
638
|
Validate a local dataset directory against the agent input/output schemas.
|
|
724
639
|
|
|
@@ -735,335 +650,7 @@ Validate a local dataset directory against the agent input/output schemas.
|
|
|
735
650
|
| `--json` | no | | Output the raw server response as JSON |
|
|
736
651
|
| `--agent-dir <dir>` | no | `"."` | Agent package directory containing input/output schemas |
|
|
737
652
|
|
|
738
|
-
### `eigenpal agents|
|
|
739
|
-
|
|
740
|
-
List runs for an agent target; unqualified targets include all source refs.
|
|
741
|
-
|
|
742
|
-
### Arguments
|
|
743
|
-
|
|
744
|
-
| Name | Required | Variadic | Description |
|
|
745
|
-
| -------- | -------- | -------- | ----------- |
|
|
746
|
-
| `target` | yes | no | |
|
|
747
|
-
|
|
748
|
-
### Options
|
|
749
|
-
|
|
750
|
-
| Flag | Required | Default | Description |
|
|
751
|
-
| --------------------- | -------- | ------- | -------------------------------------- |
|
|
752
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
753
|
-
| `--limit <n>` | no | `50` | Page size |
|
|
754
|
-
| `--offset <n>` | no | `0` | Page offset |
|
|
755
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
756
|
-
| `--status <status>` | no | | Filter by run status |
|
|
757
|
-
| `--include <items>` | no | | Comma-separated include list |
|
|
758
|
-
| `--compact` | no | | Render compact run rows |
|
|
759
|
-
| `--sort <field>` | no | | Sort field |
|
|
760
|
-
| `--order <asc\|desc>` | no | | Sort order |
|
|
761
|
-
|
|
762
|
-
### `eigenpal agents|agent runs get [options] <run-id>`
|
|
763
|
-
|
|
764
|
-
Get one agent run.
|
|
765
|
-
|
|
766
|
-
### Arguments
|
|
767
|
-
|
|
768
|
-
| Name | Required | Variadic | Description |
|
|
769
|
-
| -------- | -------- | -------- | ----------- |
|
|
770
|
-
| `run-id` | yes | no | |
|
|
771
|
-
|
|
772
|
-
### Options
|
|
773
|
-
|
|
774
|
-
| Flag | Required | Default | Description |
|
|
775
|
-
| ------------------- | -------- | ------------ | ----------------------------------------------------------------- |
|
|
776
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
777
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
778
|
-
| `--include <parts>` | no | `"feedback"` | Comma-separated extra parts: feedback,expected,files,trace,issues |
|
|
779
|
-
|
|
780
|
-
### `eigenpal agents|agent runs compare|diff [options] <reference-run-id> <run-id>`
|
|
781
|
-
|
|
782
|
-
Compare one run against another run. PDF/DOCX text comparison uses pdftotext/python3 and reports byte fallbacks.
|
|
783
|
-
|
|
784
|
-
### Arguments
|
|
785
|
-
|
|
786
|
-
| Name | Required | Variadic | Description |
|
|
787
|
-
| ------------------ | -------- | -------- | ----------- |
|
|
788
|
-
| `reference-run-id` | yes | no | |
|
|
789
|
-
| `run-id` | yes | no | |
|
|
790
|
-
|
|
791
|
-
### Options
|
|
792
|
-
|
|
793
|
-
| Flag | Required | Default | Description |
|
|
794
|
-
| ------------------- | -------- | ------- | ------------------------------------------------------------------- |
|
|
795
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
796
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
797
|
-
| `--baseline` | no | | Compare actual outputs from both runs instead of expected artifacts |
|
|
798
|
-
| `--out <dir>` | no | | Write comparison artifacts to this directory |
|
|
799
|
-
| `--normalize-dates` | no | | Normalize YYYYMMDD and YYYY-MM-DD tokens in filenames/text |
|
|
800
|
-
| `--fail-on-diff` | no | | Exit 1 when comparison status is fail |
|
|
801
|
-
|
|
802
|
-
### `eigenpal agents|agent runs artifacts|artifact list|ls [options] <run-id>`
|
|
803
|
-
|
|
804
|
-
List available run artifacts without downloading them.
|
|
805
|
-
|
|
806
|
-
### Arguments
|
|
807
|
-
|
|
808
|
-
| Name | Required | Variadic | Description |
|
|
809
|
-
| -------- | -------- | -------- | ----------- |
|
|
810
|
-
| `run-id` | yes | no | |
|
|
811
|
-
|
|
812
|
-
### Options
|
|
813
|
-
|
|
814
|
-
| Flag | Required | Default | Description |
|
|
815
|
-
| ------------------ | -------- | ------- | -------------------------------------- |
|
|
816
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
817
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
818
|
-
|
|
819
|
-
### `eigenpal agents|agent runs artifacts|artifact fetch [options] <run-id>`
|
|
820
|
-
|
|
821
|
-
Download run artifacts by canonical artifact path.
|
|
822
|
-
|
|
823
|
-
### Arguments
|
|
824
|
-
|
|
825
|
-
| Name | Required | Variadic | Description |
|
|
826
|
-
| -------- | -------- | -------- | ----------- |
|
|
827
|
-
| `run-id` | yes | no | |
|
|
828
|
-
|
|
829
|
-
### Options
|
|
830
|
-
|
|
831
|
-
| Flag | Required | Default | Description |
|
|
832
|
-
| ------------------- | -------- | ------- | ------------------------------------------------------------------------------- |
|
|
833
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
834
|
-
| `--out <dir>` | no | | Output directory |
|
|
835
|
-
| `--include <parts>` | no | `"all"` | Comma-separated parts: output,input,metadata,issues,trace,lockfile,expected,all |
|
|
836
|
-
| `--path <path>` | no | `[]` | Fetch one exact artifact path from `artifacts list`; repeatable |
|
|
837
|
-
| `--json` | no | | Output a JSON summary of written artifacts |
|
|
838
|
-
|
|
839
|
-
### `eigenpal agents|agent runs trace [options] <run-id>`
|
|
840
|
-
|
|
841
|
-
Print raw trace.jsonl for a run, or write it with --out.
|
|
842
|
-
|
|
843
|
-
### Arguments
|
|
844
|
-
|
|
845
|
-
| Name | Required | Variadic | Description |
|
|
846
|
-
| -------- | -------- | -------- | ----------- |
|
|
847
|
-
| `run-id` | yes | no | |
|
|
848
|
-
|
|
849
|
-
### Options
|
|
850
|
-
|
|
851
|
-
| Flag | Required | Default | Description |
|
|
852
|
-
| ------------------ | -------- | ------- | ---------------- |
|
|
853
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
854
|
-
| `--out <file>` | no | | Output file path |
|
|
855
|
-
|
|
856
|
-
### `eigenpal agents|agent runs feedback|fb update [options] <run-id>`
|
|
857
|
-
|
|
858
|
-
Edit feedback state, rating, message, or expected JSON for a run.
|
|
859
|
-
|
|
860
|
-
### Arguments
|
|
861
|
-
|
|
862
|
-
| Name | Required | Variadic | Description |
|
|
863
|
-
| -------- | -------- | -------- | ----------- |
|
|
864
|
-
| `run-id` | yes | no | |
|
|
865
|
-
|
|
866
|
-
### Options
|
|
867
|
-
|
|
868
|
-
| Flag | Required | Default | Description |
|
|
869
|
-
| -------------------------------------- | -------- | ------- | ----------------------------------------- |
|
|
870
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
871
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
872
|
-
| `--status <open\|resolved\|ignored>` | no | | Set feedback status |
|
|
873
|
-
| `--rating <pass\|fail\|partial\|none>` | no | | Set feedback rating |
|
|
874
|
-
| `--message <text>` | no | | Set feedback message body |
|
|
875
|
-
| `--message-file <path>` | no | | Read feedback message body from a file |
|
|
876
|
-
| `--expected-json <json>` | no | | Set structured expected JSON |
|
|
877
|
-
| `--expected-json-file <path>` | no | | Read structured expected JSON from a file |
|
|
878
|
-
| `--clear-message` | no | | Clear the feedback message body |
|
|
879
|
-
| `--clear-rating` | no | | Clear feedback rating |
|
|
880
|
-
| `--clear-expected-json` | no | | Delete structured expected JSON |
|
|
881
|
-
|
|
882
|
-
### `eigenpal agents|agent runs feedback|fb resolve [options] <run-id>`
|
|
883
|
-
|
|
884
|
-
Mark run feedback as resolved.
|
|
885
|
-
|
|
886
|
-
### Arguments
|
|
887
|
-
|
|
888
|
-
| Name | Required | Variadic | Description |
|
|
889
|
-
| -------- | -------- | -------- | ----------- |
|
|
890
|
-
| `run-id` | yes | no | |
|
|
891
|
-
|
|
892
|
-
### Options
|
|
893
|
-
|
|
894
|
-
| Flag | Required | Default | Description |
|
|
895
|
-
| ----------------------- | -------- | ------- | -------------------------------------- |
|
|
896
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
897
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
898
|
-
| `--message <text>` | no | | Set feedback message body |
|
|
899
|
-
| `--message-file <path>` | no | | Read feedback message body from a file |
|
|
900
|
-
|
|
901
|
-
### `eigenpal agents|agent runs feedback|fb clear [options] <run-id>`
|
|
902
|
-
|
|
903
|
-
Delete feedback, expected.json, and expected files for a run.
|
|
904
|
-
|
|
905
|
-
### Arguments
|
|
906
|
-
|
|
907
|
-
| Name | Required | Variadic | Description |
|
|
908
|
-
| -------- | -------- | -------- | ----------- |
|
|
909
|
-
| `run-id` | yes | no | |
|
|
910
|
-
|
|
911
|
-
### Options
|
|
912
|
-
|
|
913
|
-
| Flag | Required | Default | Description |
|
|
914
|
-
| ------------------ | -------- | ------- | ---------------------------------------- |
|
|
915
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
916
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
917
|
-
| `--yes` | no | | Required in non-interactive environments |
|
|
918
|
-
|
|
919
|
-
### `eigenpal agents|agent runs expected list|ls [options] <run-id>`
|
|
920
|
-
|
|
921
|
-
List expected JSON and files attached to a run.
|
|
922
|
-
|
|
923
|
-
### Arguments
|
|
924
|
-
|
|
925
|
-
| Name | Required | Variadic | Description |
|
|
926
|
-
| -------- | -------- | -------- | ----------- |
|
|
927
|
-
| `run-id` | yes | no | |
|
|
928
|
-
|
|
929
|
-
### Options
|
|
930
|
-
|
|
931
|
-
| Flag | Required | Default | Description |
|
|
932
|
-
| ------------------ | -------- | ------- | -------------------------------------- |
|
|
933
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
934
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
935
|
-
|
|
936
|
-
### `eigenpal agents|agent runs expected pull [options] <run-id>`
|
|
937
|
-
|
|
938
|
-
Download expected JSON and files attached to a run.
|
|
939
|
-
|
|
940
|
-
### Arguments
|
|
941
|
-
|
|
942
|
-
| Name | Required | Variadic | Description |
|
|
943
|
-
| -------- | -------- | -------- | ----------- |
|
|
944
|
-
| `run-id` | yes | no | |
|
|
945
|
-
|
|
946
|
-
### Options
|
|
947
|
-
|
|
948
|
-
| Flag | Required | Default | Description |
|
|
949
|
-
| ------------------ | -------- | ------- | ---------------- |
|
|
950
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
951
|
-
| `--out <dir>` | no | | Output directory |
|
|
952
|
-
|
|
953
|
-
### `eigenpal agents|agent runs expected upload [options] <run-id> <file>`
|
|
954
|
-
|
|
955
|
-
Upload a local file as an expected artifact.
|
|
956
|
-
|
|
957
|
-
### Arguments
|
|
958
|
-
|
|
959
|
-
| Name | Required | Variadic | Description |
|
|
960
|
-
| -------- | -------- | -------- | ----------- |
|
|
961
|
-
| `run-id` | yes | no | |
|
|
962
|
-
| `file` | yes | no | |
|
|
963
|
-
|
|
964
|
-
### Options
|
|
965
|
-
|
|
966
|
-
| Flag | Required | Default | Description |
|
|
967
|
-
| ------------------ | -------- | ------- | -------------------------------------- |
|
|
968
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
969
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
970
|
-
| `--name <name>` | no | | Expected artifact name |
|
|
971
|
-
|
|
972
|
-
### `eigenpal agents|agent runs expected copy-output [options] <run-id> <output-file>`
|
|
973
|
-
|
|
974
|
-
Copy a generated output file into expected artifacts.
|
|
975
|
-
|
|
976
|
-
### Arguments
|
|
977
|
-
|
|
978
|
-
| Name | Required | Variadic | Description |
|
|
979
|
-
| ------------- | -------- | -------- | ----------- |
|
|
980
|
-
| `run-id` | yes | no | |
|
|
981
|
-
| `output-file` | yes | no | |
|
|
982
|
-
|
|
983
|
-
### Options
|
|
984
|
-
|
|
985
|
-
| Flag | Required | Default | Description |
|
|
986
|
-
| ------------------ | -------- | ------- | -------------------------------------- |
|
|
987
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
988
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
989
|
-
| `--name <name>` | no | | Expected artifact name |
|
|
990
|
-
|
|
991
|
-
### `eigenpal agents|agent runs expected rename [options] <run-id> <old-name> <new-name>`
|
|
992
|
-
|
|
993
|
-
Rename an expected artifact.
|
|
994
|
-
|
|
995
|
-
### Arguments
|
|
996
|
-
|
|
997
|
-
| Name | Required | Variadic | Description |
|
|
998
|
-
| ---------- | -------- | -------- | ----------- |
|
|
999
|
-
| `run-id` | yes | no | |
|
|
1000
|
-
| `old-name` | yes | no | |
|
|
1001
|
-
| `new-name` | yes | no | |
|
|
1002
|
-
|
|
1003
|
-
### Options
|
|
1004
|
-
|
|
1005
|
-
| Flag | Required | Default | Description |
|
|
1006
|
-
| ------------------ | -------- | ------- | -------------------------------------- |
|
|
1007
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
1008
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
1009
|
-
|
|
1010
|
-
### `eigenpal agents|agent runs expected delete [options] <run-id> <name>`
|
|
1011
|
-
|
|
1012
|
-
Delete an expected artifact.
|
|
1013
|
-
|
|
1014
|
-
### Arguments
|
|
1015
|
-
|
|
1016
|
-
| Name | Required | Variadic | Description |
|
|
1017
|
-
| -------- | -------- | -------- | ----------- |
|
|
1018
|
-
| `run-id` | yes | no | |
|
|
1019
|
-
| `name` | yes | no | |
|
|
1020
|
-
|
|
1021
|
-
### Options
|
|
1022
|
-
|
|
1023
|
-
| Flag | Required | Default | Description |
|
|
1024
|
-
| ------------------ | -------- | ------- | ---------------------------------------- |
|
|
1025
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
1026
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
1027
|
-
| `--yes` | no | | Required in non-interactive environments |
|
|
1028
|
-
|
|
1029
|
-
### `eigenpal agents|agent runs watch [options] <run-id>`
|
|
1030
|
-
|
|
1031
|
-
Watch a run until it reaches a terminal status.
|
|
1032
|
-
|
|
1033
|
-
### Arguments
|
|
1034
|
-
|
|
1035
|
-
| Name | Required | Variadic | Description |
|
|
1036
|
-
| -------- | -------- | -------- | ----------- |
|
|
1037
|
-
| `run-id` | yes | no | |
|
|
1038
|
-
|
|
1039
|
-
### Options
|
|
1040
|
-
|
|
1041
|
-
| Flag | Required | Default | Description |
|
|
1042
|
-
| ---------------------- | -------- | ------- | -------------------------------------- |
|
|
1043
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
1044
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
1045
|
-
| `--interval <seconds>` | no | `2` | Polling interval in seconds |
|
|
1046
|
-
| `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
|
|
1047
|
-
|
|
1048
|
-
### `eigenpal agents|agent runs cancel [options] <run-id>`
|
|
1049
|
-
|
|
1050
|
-
Cancel an agent run.
|
|
1051
|
-
|
|
1052
|
-
### Arguments
|
|
1053
|
-
|
|
1054
|
-
| Name | Required | Variadic | Description |
|
|
1055
|
-
| -------- | -------- | -------- | ----------- |
|
|
1056
|
-
| `run-id` | yes | no | |
|
|
1057
|
-
|
|
1058
|
-
### Options
|
|
1059
|
-
|
|
1060
|
-
| Flag | Required | Default | Description |
|
|
1061
|
-
| ------------------ | -------- | ------- | ---------------------------------------- |
|
|
1062
|
-
| `--base-url <url>` | no | | Server base URL |
|
|
1063
|
-
| `--json` | no | | Output the raw server response as JSON |
|
|
1064
|
-
| `--yes` | no | | Required in non-interactive environments |
|
|
1065
|
-
|
|
1066
|
-
### `eigenpal agents|agent experiment|exp run [options] <agent-id-or-slug>`
|
|
653
|
+
### `eigenpal agents experiment|exp run [options] <agent-id-or-slug>`
|
|
1067
654
|
|
|
1068
655
|
Start an experiment over dataset examples.
|
|
1069
656
|
|
|
@@ -1083,7 +670,7 @@ Start an experiment over dataset examples.
|
|
|
1083
670
|
| `--wait` | no | | Poll until the experiment reaches a terminal status |
|
|
1084
671
|
| `--interval <seconds>` | no | `2` | Polling interval in seconds |
|
|
1085
672
|
|
|
1086
|
-
### `eigenpal agents
|
|
673
|
+
### `eigenpal agents experiment|exp status [options] <agent-id-or-slug> <batch-id>`
|
|
1087
674
|
|
|
1088
675
|
Get experiment status.
|
|
1089
676
|
|
|
@@ -1105,7 +692,7 @@ Get experiment status.
|
|
|
1105
692
|
| `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
|
|
1106
693
|
| `--include <parts>` | no | | Reserved for future detailed parts |
|
|
1107
694
|
|
|
1108
|
-
### `eigenpal agents
|
|
695
|
+
### `eigenpal agents experiment|exp results [options] <agent-id-or-slug> [batch-id]`
|
|
1109
696
|
|
|
1110
697
|
Print experiment results as JSON or CSV.
|
|
1111
698
|
|
|
@@ -1124,7 +711,7 @@ Print experiment results as JSON or CSV.
|
|
|
1124
711
|
| `--format <csv\|json>` | yes | | Output format |
|
|
1125
712
|
| `--out <path>` | no | | Write output to file |
|
|
1126
713
|
|
|
1127
|
-
### `eigenpal agents
|
|
714
|
+
### `eigenpal agents experiment|exp list|ls [options] <agent-id-or-slug>`
|
|
1128
715
|
|
|
1129
716
|
List experiments.
|
|
1130
717
|
|
|
@@ -1144,7 +731,7 @@ List experiments.
|
|
|
1144
731
|
| `--json` | no | | Output the raw server response as JSON |
|
|
1145
732
|
| `--batch-id <id>` | no | | Filter to one batch id |
|
|
1146
733
|
|
|
1147
|
-
### `eigenpal agents
|
|
734
|
+
### `eigenpal agents experiment|exp compare|diff [options] <batch-id-a> <batch-id-b>`
|
|
1148
735
|
|
|
1149
736
|
Compare two experiment batches.
|
|
1150
737
|
|
|
@@ -1164,7 +751,7 @@ Compare two experiment batches.
|
|
|
1164
751
|
| `--sort <mode>` | no | | Accepted for compatibility; sorting happens client-side later |
|
|
1165
752
|
| `--regression-threshold <n>` | no | | Accepted for compatibility |
|
|
1166
753
|
|
|
1167
|
-
### `eigenpal agents
|
|
754
|
+
### `eigenpal agents experiment|exp cancel [options] <agent-id-or-slug> <batch-id>`
|
|
1168
755
|
|
|
1169
756
|
Cancel every active execution in an experiment.
|
|
1170
757
|
|
|
@@ -1183,7 +770,7 @@ Cancel every active execution in an experiment.
|
|
|
1183
770
|
| `--json` | no | | Output the raw server response as JSON |
|
|
1184
771
|
| `--yes` | no | | Required in non-interactive environments |
|
|
1185
772
|
|
|
1186
|
-
### `eigenpal agents
|
|
773
|
+
### `eigenpal agents session list|ls [options] <agent-id-or-slug>`
|
|
1187
774
|
|
|
1188
775
|
List builder sessions for an agent.
|
|
1189
776
|
|
|
@@ -1202,7 +789,7 @@ List builder sessions for an agent.
|
|
|
1202
789
|
| `--offset <n>` | no | `0` | Page offset |
|
|
1203
790
|
| `--json` | no | | Output the raw server response as JSON |
|
|
1204
791
|
|
|
1205
|
-
### `eigenpal agents
|
|
792
|
+
### `eigenpal agents session get [options] <session-id>`
|
|
1206
793
|
|
|
1207
794
|
Get a builder session and messages.
|
|
1208
795
|
|
|
@@ -1219,7 +806,7 @@ Get a builder session and messages.
|
|
|
1219
806
|
| `--base-url <url>` | no | | Server base URL |
|
|
1220
807
|
| `--json` | no | | Output the raw server response as JSON |
|
|
1221
808
|
|
|
1222
|
-
### `eigenpal agents
|
|
809
|
+
### `eigenpal agents session start [options] <agent-id-or-slug>`
|
|
1223
810
|
|
|
1224
811
|
Start a builder session.
|
|
1225
812
|
|
|
@@ -1237,7 +824,7 @@ Start a builder session.
|
|
|
1237
824
|
| `--json` | no | | Output the raw server response as JSON |
|
|
1238
825
|
| `--title <title>` | no | | Session title |
|
|
1239
826
|
|
|
1240
|
-
### `eigenpal agents
|
|
827
|
+
### `eigenpal agents session message [options] <session-id>`
|
|
1241
828
|
|
|
1242
829
|
Append a message to a builder session.
|
|
1243
830
|
|
|
@@ -1256,7 +843,7 @@ Append a message to a builder session.
|
|
|
1256
843
|
| `--text <message>` | yes | | Message text |
|
|
1257
844
|
| `--wait` | no | | Reserved; server acknowledges after enqueueing the message |
|
|
1258
845
|
|
|
1259
|
-
### `eigenpal agents
|
|
846
|
+
### `eigenpal agents session stop [options] <session-id>`
|
|
1260
847
|
|
|
1261
848
|
Stop a builder session.
|
|
1262
849
|
|
|
@@ -1274,7 +861,7 @@ Stop a builder session.
|
|
|
1274
861
|
| `--json` | no | | Output the raw server response as JSON |
|
|
1275
862
|
| `--yes` | no | | Required in non-interactive environments |
|
|
1276
863
|
|
|
1277
|
-
### `eigenpal agents
|
|
864
|
+
### `eigenpal agents env pull [options] [target]`
|
|
1278
865
|
|
|
1279
866
|
Decrypt source secrets and print shell exports.
|
|
1280
867
|
|
|
@@ -1292,7 +879,7 @@ Decrypt source secrets and print shell exports.
|
|
|
1292
879
|
| `--dir <dir>` | no | `"."` | Installed agent package directory |
|
|
1293
880
|
| `--format <format>` | no | `"shell"` | Output format: shell or dotenv |
|
|
1294
881
|
|
|
1295
|
-
### `eigenpal agents
|
|
882
|
+
### `eigenpal agents secrets export [options] [target]`
|
|
1296
883
|
|
|
1297
884
|
Decrypt source secrets and print shell exports.
|
|
1298
885
|
|