@eigenpal/cli 0.4.10 → 0.4.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,805 @@
1
1
  # eigenpal agent
2
2
 
3
- Agent (agentic process) operations — coming soon. Agent workflows live on the server today; CLI surface is reserved for future commands.
3
+ Manage Eigenpal agents, triggers, datasets, executions, experiments, and sessions.
4
+
5
+ ## Contents
6
+
7
+ - [Surface](#surface)
8
+ - [Commands](#commands)
9
+ - [Core](#core)
10
+ - [Dataset](#dataset)
11
+ - [Execution](#execution)
12
+ - [Experiment](#experiment)
13
+ - [Session](#session)
14
+ - [Trigger](#trigger)
15
+ - [Evaluators](#evaluators)
16
+ - [Versions](#versions)
17
+ - [Details](#details)
18
+ - [`eigenpal agent list [options]`](#eigenpal-agent-list-options)
19
+ - [`eigenpal agent push [options]`](#eigenpal-agent-push-options)
20
+ - [`eigenpal agent pull [options] <agent-id-or-slug>`](#eigenpal-agent-pull-options-agent-id-or-slug)
21
+ - [`eigenpal agent validate [options] [dir]`](#eigenpal-agent-validate-options-dir)
22
+ - [`eigenpal agent dataset list [options] <agent-id-or-slug>`](#eigenpal-agent-dataset-list-options-agent-id-or-slug)
23
+ - [`eigenpal agent dataset push [options] <agent-id-or-slug>`](#eigenpal-agent-dataset-push-options-agent-id-or-slug)
24
+ - [`eigenpal agent dataset pull [options] <agent-id-or-slug>`](#eigenpal-agent-dataset-pull-options-agent-id-or-slug)
25
+ - [`eigenpal agent dataset validate [options] [path]`](#eigenpal-agent-dataset-validate-options-path)
26
+ - [`eigenpal agent execution run [options] <agent-id-or-slug>`](#eigenpal-agent-execution-run-options-agent-id-or-slug)
27
+ - [`eigenpal agent execution get [options] <execution-id>`](#eigenpal-agent-execution-get-options-execution-id)
28
+ - [`eigenpal agent execution list [options] <agent-id-or-slug>`](#eigenpal-agent-execution-list-options-agent-id-or-slug)
29
+ - [`eigenpal agent execution watch [options] <execution-id>`](#eigenpal-agent-execution-watch-options-execution-id)
30
+ - [`eigenpal agent execution cancel [options] <execution-id>`](#eigenpal-agent-execution-cancel-options-execution-id)
31
+ - [`eigenpal agent experiment run [options] <agent-id-or-slug>`](#eigenpal-agent-experiment-run-options-agent-id-or-slug)
32
+ - [`eigenpal agent experiment status [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agent-experiment-status-options-agent-id-or-slug-batch-id)
33
+ - [`eigenpal agent experiment results [options] <agent-id-or-slug> [batch-id]`](#eigenpal-agent-experiment-results-options-agent-id-or-slug-batch-id)
34
+ - [`eigenpal agent experiment list [options] <agent-id-or-slug>`](#eigenpal-agent-experiment-list-options-agent-id-or-slug)
35
+ - [`eigenpal agent experiment compare [options] <batch-id-a> <batch-id-b>`](#eigenpal-agent-experiment-compare-options-batch-id-a-batch-id-b)
36
+ - [`eigenpal agent experiment cancel [options] <agent-id-or-slug> <batch-id>`](#eigenpal-agent-experiment-cancel-options-agent-id-or-slug-batch-id)
37
+ - [`eigenpal agent session list [options] <agent-id-or-slug>`](#eigenpal-agent-session-list-options-agent-id-or-slug)
38
+ - [`eigenpal agent session get [options] <session-id>`](#eigenpal-agent-session-get-options-session-id)
39
+ - [`eigenpal agent session start [options] <agent-id-or-slug>`](#eigenpal-agent-session-start-options-agent-id-or-slug)
40
+ - [`eigenpal agent session message [options] <session-id>`](#eigenpal-agent-session-message-options-session-id)
41
+ - [`eigenpal agent session stop [options] <session-id>`](#eigenpal-agent-session-stop-options-session-id)
42
+ - [`eigenpal agent trigger list [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-list-options-agent-id-or-slug)
43
+ - [`eigenpal agent trigger api enable [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-api-enable-options-agent-id-or-slug)
44
+ - [`eigenpal agent trigger api disable [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-api-disable-options-agent-id-or-slug)
45
+ - [`eigenpal agent trigger email enable [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-email-enable-options-agent-id-or-slug)
46
+ - [`eigenpal agent trigger email disable [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-email-disable-options-agent-id-or-slug)
47
+ - [`eigenpal agent trigger email list [options] [agent-id-or-slug]`](#eigenpal-agent-trigger-email-list-options-agent-id-or-slug)
48
+ - [`eigenpal agent trigger email add [options] <agent-id-or-slug>`](#eigenpal-agent-trigger-email-add-options-agent-id-or-slug)
49
+ - [`eigenpal agent trigger email update [options] <agent-id-or-slug> <email-id>`](#eigenpal-agent-trigger-email-update-options-agent-id-or-slug-email-id)
50
+ - [`eigenpal agent trigger email remove [options] <agent-id-or-slug> <email-id>`](#eigenpal-agent-trigger-email-remove-options-agent-id-or-slug-email-id)
51
+ - [`eigenpal agent evaluators list [options] [agent-id-or-slug]`](#eigenpal-agent-evaluators-list-options-agent-id-or-slug)
52
+ - [`eigenpal agent versions list [options] [agent-id-or-slug]`](#eigenpal-agent-versions-list-options-agent-id-or-slug)
53
+
54
+ ## Surface
55
+
56
+ ```
57
+ agent
58
+ ├── list
59
+ ├── push
60
+ ├── pull <agent-id-or-slug>
61
+ ├── validate [dir]
62
+ ├── dataset
63
+ │ ├── list <agent-id-or-slug>
64
+ │ ├── push <agent-id-or-slug>
65
+ │ ├── pull <agent-id-or-slug>
66
+ │ └── validate [path]
67
+ ├── execution
68
+ │ ├── run <agent-id-or-slug>
69
+ │ ├── get <execution-id>
70
+ │ ├── list <agent-id-or-slug>
71
+ │ ├── watch <execution-id>
72
+ │ └── cancel <execution-id>
73
+ ├── experiment
74
+ │ ├── run <agent-id-or-slug>
75
+ │ ├── status <agent-id-or-slug> <batch-id>
76
+ │ ├── results <agent-id-or-slug> [batch-id]
77
+ │ ├── list <agent-id-or-slug>
78
+ │ ├── compare <batch-id-a> <batch-id-b>
79
+ │ └── cancel <agent-id-or-slug> <batch-id>
80
+ ├── session
81
+ │ ├── list <agent-id-or-slug>
82
+ │ ├── get <session-id>
83
+ │ ├── start <agent-id-or-slug>
84
+ │ ├── message <session-id>
85
+ │ └── stop <session-id>
86
+ ├── trigger
87
+ │ ├── list <agent-id-or-slug>
88
+ │ ├── api
89
+ │ │ ├── enable <agent-id-or-slug>
90
+ │ │ └── disable <agent-id-or-slug>
91
+ │ └── email
92
+ │ ├── enable <agent-id-or-slug>
93
+ │ ├── disable <agent-id-or-slug>
94
+ │ ├── list [agent-id-or-slug]
95
+ │ ├── add <agent-id-or-slug>
96
+ │ ├── update <agent-id-or-slug> <email-id>
97
+ │ └── remove <agent-id-or-slug> <email-id>
98
+ ├── evaluators
99
+ │ └── list [agent-id-or-slug]
100
+ └── versions
101
+ └── list [agent-id-or-slug]
102
+ ```
103
+
104
+ ## Commands
105
+
106
+ ### Core
107
+
108
+ | Command | Description |
109
+ | -------------------------------------------------- | ---------------------------------------------------------------- |
110
+ | `eigenpal agent list [options]` | List agents. |
111
+ | `eigenpal agent push [options]` | Create or update an agent from agent.yaml, agent/, and dataset/. |
112
+ | `eigenpal agent pull [options] <agent-id-or-slug>` | Download an agent project as agent.yaml, agent/, and dataset/. |
113
+ | `eigenpal agent validate [options] [dir]` | Validate a local agent project layout. |
114
+
115
+ ### Dataset
116
+
117
+ | Command | Description |
118
+ | ---------------------------------------------------------- | ------------------------------------------------------- |
119
+ | `eigenpal agent dataset list [options] <agent-id-or-slug>` | List dataset examples for an agent. |
120
+ | `eigenpal agent dataset push [options] <agent-id-or-slug>` | Upload dataset examples from a local dataset directory. |
121
+ | `eigenpal agent dataset pull [options] <agent-id-or-slug>` | Download an agent dataset directory. |
122
+ | `eigenpal agent dataset validate [options] [path]` | Validate a local dataset directory. |
123
+
124
+ ### Execution
125
+
126
+ | Command | Description |
127
+ | ------------------------------------------------------------ | ------------------------------------------------------ |
128
+ | `eigenpal agent execution run [options] <agent-id-or-slug>` | Start one agent execution. |
129
+ | `eigenpal agent execution get [options] <execution-id>` | Get one agent execution. |
130
+ | `eigenpal agent execution list [options] <agent-id-or-slug>` | List agent executions. |
131
+ | `eigenpal agent execution watch [options] <execution-id>` | Watch an execution until it reaches a terminal status. |
132
+ | `eigenpal agent execution cancel [options] <execution-id>` | Cancel an agent execution. |
133
+
134
+ ### Experiment
135
+
136
+ | Command | Description |
137
+ | --------------------------------------------------------------------------- | ----------------------------------------------- |
138
+ | `eigenpal agent experiment run [options] <agent-id-or-slug>` | Start an experiment over dataset examples. |
139
+ | `eigenpal agent experiment status [options] <agent-id-or-slug> <batch-id>` | Get experiment status. |
140
+ | `eigenpal agent experiment results [options] <agent-id-or-slug> [batch-id]` | Print experiment results as JSON or CSV. |
141
+ | `eigenpal agent experiment list [options] <agent-id-or-slug>` | List experiments. |
142
+ | `eigenpal agent experiment compare [options] <batch-id-a> <batch-id-b>` | Compare two experiment batches. |
143
+ | `eigenpal agent experiment cancel [options] <agent-id-or-slug> <batch-id>` | Cancel every active execution in an experiment. |
144
+
145
+ ### Session
146
+
147
+ | Command | Description |
148
+ | ----------------------------------------------------------- | -------------------------------------- |
149
+ | `eigenpal agent session list [options] <agent-id-or-slug>` | List builder sessions for an agent. |
150
+ | `eigenpal agent session get [options] <session-id>` | Get a builder session and messages. |
151
+ | `eigenpal agent session start [options] <agent-id-or-slug>` | Start a builder session. |
152
+ | `eigenpal agent session message [options] <session-id>` | Append a message to a builder session. |
153
+ | `eigenpal agent session stop [options] <session-id>` | Stop a builder session. |
154
+
155
+ ### Trigger
156
+
157
+ | Command | Description |
158
+ | ----------------------------------------------------------------------------- | ------------------------------------------------------ |
159
+ | `eigenpal agent trigger list [options] <agent-id-or-slug>` | List enabled agent triggers. |
160
+ | `eigenpal agent trigger api enable [options] <agent-id-or-slug>` | Enable the API trigger for an agent. |
161
+ | `eigenpal agent trigger api disable [options] <agent-id-or-slug>` | Disable the API trigger for an agent. |
162
+ | `eigenpal agent trigger email enable [options] <agent-id-or-slug>` | Enable the email trigger for an agent. |
163
+ | `eigenpal agent trigger email disable [options] <agent-id-or-slug>` | Disable the email trigger for an agent. |
164
+ | `eigenpal agent trigger email list [options] [agent-id-or-slug]` | List email triggers, optionally filtered to one agent. |
165
+ | `eigenpal agent trigger email add [options] <agent-id-or-slug>` | Add an email trigger to an agent. |
166
+ | `eigenpal agent trigger email update [options] <agent-id-or-slug> <email-id>` | Update an email trigger. |
167
+ | `eigenpal agent trigger email remove [options] <agent-id-or-slug> <email-id>` | Remove an email trigger. |
168
+
169
+ ### Evaluators
170
+
171
+ | Command | Description |
172
+ | ------------------------------------------------------------- | -------------------------------------------------------------------------------- |
173
+ | `eigenpal agent evaluators list [options] [agent-id-or-slug]` | Agent evaluators are reserved for future workflow-style evaluators. Coming soon. |
174
+
175
+ ### Versions
176
+
177
+ | Command | Description |
178
+ | ----------------------------------------------------------- | -------------------------------------------- |
179
+ | `eigenpal agent versions list [options] [agent-id-or-slug]` | Agent versions are coming soon. Coming soon. |
180
+
181
+ ## Details
182
+
183
+ ### `eigenpal agent list [options]`
184
+
185
+ List agents.
186
+
187
+ ### Options
188
+
189
+ | Flag | Required | Default | Description |
190
+ | ------------------ | -------- | ------- | -------------------------------------- |
191
+ | `--base-url <url>` | no | | Server base URL |
192
+ | `--limit <n>` | no | `50` | Page size |
193
+ | `--offset <n>` | no | `0` | Page offset |
194
+ | `--json` | no | | Output the raw server response as JSON |
195
+ | `--search <q>` | no | | Search by slug, name, or description |
196
+
197
+ ### `eigenpal agent push [options]`
198
+
199
+ Create or update an agent from agent.yaml, agent/, and dataset/.
200
+
201
+ ### Options
202
+
203
+ | Flag | Required | Default | Description |
204
+ | ------------------------- | -------- | ------- | ------------------------------------------------ |
205
+ | `--base-url <url>` | no | | Server base URL |
206
+ | `--json` | no | | Output the raw server response as JSON |
207
+ | `--dir <dir>` | no | `"."` | Agent project directory |
208
+ | `--agent-id <id-or-slug>` | no | | Update an existing agent instead of creating one |
209
+
210
+ ### `eigenpal agent pull [options] <agent-id-or-slug>`
211
+
212
+ Download an agent project as agent.yaml, agent/, and dataset/.
213
+
214
+ ### Arguments
215
+
216
+ | Name | Required | Variadic | Description |
217
+ | ------------------ | -------- | -------- | ----------- |
218
+ | `agent-id-or-slug` | yes | no | |
219
+
220
+ ### Options
221
+
222
+ | Flag | Required | Default | Description |
223
+ | ------------------ | -------- | ------- | ---------------- |
224
+ | `--base-url <url>` | no | | Server base URL |
225
+ | `--out <dir>` | no | | Output directory |
226
+
227
+ ### `eigenpal agent validate [options] [dir]`
228
+
229
+ Validate a local agent project layout.
230
+
231
+ ### Arguments
232
+
233
+ | Name | Required | Variadic | Description |
234
+ | ----- | -------- | -------- | ----------- |
235
+ | `dir` | no | no | |
236
+
237
+ ### Options
238
+
239
+ | Flag | Required | Default | Description |
240
+ | -------- | -------- | ------- | -------------------------------------- |
241
+ | `--json` | no | | Output the raw server response as JSON |
242
+
243
+ ### `eigenpal agent dataset list [options] <agent-id-or-slug>`
244
+
245
+ List dataset examples for an agent.
246
+
247
+ ### Arguments
248
+
249
+ | Name | Required | Variadic | Description |
250
+ | ------------------ | -------- | -------- | ----------- |
251
+ | `agent-id-or-slug` | yes | no | |
252
+
253
+ ### Options
254
+
255
+ | Flag | Required | Default | Description |
256
+ | ------------------ | -------- | ------- | -------------------------------------- |
257
+ | `--base-url <url>` | no | | Server base URL |
258
+ | `--limit <n>` | no | `50` | Page size |
259
+ | `--offset <n>` | no | `0` | Page offset |
260
+ | `--json` | no | | Output the raw server response as JSON |
261
+
262
+ ### `eigenpal agent dataset push [options] <agent-id-or-slug>`
263
+
264
+ Upload dataset examples from a local dataset directory.
265
+
266
+ ### Arguments
267
+
268
+ | Name | Required | Variadic | Description |
269
+ | ------------------ | -------- | -------- | ----------- |
270
+ | `agent-id-or-slug` | yes | no | |
271
+
272
+ ### Options
273
+
274
+ | Flag | Required | Default | Description |
275
+ | -------------------------- | -------- | ---------- | ---------------------------------------------------- |
276
+ | `--base-url <url>` | no | | Server base URL |
277
+ | `--json` | no | | Output the raw server response as JSON |
278
+ | `--file <path>` | yes | | Dataset directory |
279
+ | `--mode <append\|replace>` | no | `"append"` | Upload mode |
280
+ | `--yes` | no | | Confirm replace mode in non-interactive environments |
281
+
282
+ ### `eigenpal agent dataset pull [options] <agent-id-or-slug>`
283
+
284
+ Download an agent dataset directory.
285
+
286
+ ### Arguments
287
+
288
+ | Name | Required | Variadic | Description |
289
+ | ------------------ | -------- | -------- | ----------- |
290
+ | `agent-id-or-slug` | yes | no | |
291
+
292
+ ### Options
293
+
294
+ | Flag | Required | Default | Description |
295
+ | ------------------ | -------- | ----------- | ---------------- |
296
+ | `--base-url <url>` | no | | Server base URL |
297
+ | `--out <dir>` | no | `"dataset"` | Output directory |
298
+
299
+ ### `eigenpal agent dataset validate [options] [path]`
300
+
301
+ Validate a local dataset directory.
302
+
303
+ ### Arguments
304
+
305
+ | Name | Required | Variadic | Description |
306
+ | ------ | -------- | -------- | ----------- |
307
+ | `path` | no | no | |
308
+
309
+ ### Options
310
+
311
+ | Flag | Required | Default | Description |
312
+ | -------- | -------- | ------- | -------------------------------------- |
313
+ | `--json` | no | | Output the raw server response as JSON |
314
+
315
+ ### `eigenpal agent execution run [options] <agent-id-or-slug>`
316
+
317
+ Start one agent execution.
318
+
319
+ ### Arguments
320
+
321
+ | Name | Required | Variadic | Description |
322
+ | ------------------ | -------- | -------- | ----------- |
323
+ | `agent-id-or-slug` | yes | no | |
324
+
325
+ ### Options
326
+
327
+ | Flag | Required | Default | Description |
328
+ | --------------------- | -------- | ------- | -------------------------------------------------- |
329
+ | `--base-url <url>` | no | | Server base URL |
330
+ | `--json` | no | | Output the raw server response as JSON |
331
+ | `--input-json <json>` | no | | JSON input object |
332
+ | `--input-file <path>` | no | | Input file to upload as multipart form-data |
333
+ | `--wait` | no | | Poll until the execution reaches a terminal status |
334
+
335
+ ### `eigenpal agent execution get [options] <execution-id>`
336
+
337
+ Get one agent execution.
338
+
339
+ ### Arguments
340
+
341
+ | Name | Required | Variadic | Description |
342
+ | -------------- | -------- | -------- | ----------- |
343
+ | `execution-id` | yes | no | |
344
+
345
+ ### Options
346
+
347
+ | Flag | Required | Default | Description |
348
+ | ------------------- | -------- | ------- | --------------------------------------- |
349
+ | `--base-url <url>` | no | | Server base URL |
350
+ | `--json` | no | | Output the raw server response as JSON |
351
+ | `--include <parts>` | no | | Comma-separated extra parts, e.g. files |
352
+
353
+ ### `eigenpal agent execution list [options] <agent-id-or-slug>`
354
+
355
+ List agent executions.
356
+
357
+ ### Arguments
358
+
359
+ | Name | Required | Variadic | Description |
360
+ | ------------------ | -------- | -------- | ----------- |
361
+ | `agent-id-or-slug` | yes | no | |
362
+
363
+ ### Options
364
+
365
+ | Flag | Required | Default | Description |
366
+ | ------------------- | -------- | ------- | -------------------------------------- |
367
+ | `--base-url <url>` | no | | Server base URL |
368
+ | `--limit <n>` | no | `50` | Page size |
369
+ | `--offset <n>` | no | `0` | Page offset |
370
+ | `--json` | no | | Output the raw server response as JSON |
371
+ | `--status <status>` | no | | Filter by status |
372
+
373
+ ### `eigenpal agent execution watch [options] <execution-id>`
374
+
375
+ Watch an execution until it reaches a terminal status.
376
+
377
+ ### Arguments
378
+
379
+ | Name | Required | Variadic | Description |
380
+ | -------------- | -------- | -------- | ----------- |
381
+ | `execution-id` | yes | no | |
382
+
383
+ ### Options
384
+
385
+ | Flag | Required | Default | Description |
386
+ | ---------------------- | -------- | ------- | -------------------------------------- |
387
+ | `--base-url <url>` | no | | Server base URL |
388
+ | `--json` | no | | Output the raw server response as JSON |
389
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
390
+ | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
391
+
392
+ ### `eigenpal agent execution cancel [options] <execution-id>`
393
+
394
+ Cancel an agent execution.
395
+
396
+ ### Arguments
397
+
398
+ | Name | Required | Variadic | Description |
399
+ | -------------- | -------- | -------- | ----------- |
400
+ | `execution-id` | yes | no | |
401
+
402
+ ### Options
403
+
404
+ | Flag | Required | Default | Description |
405
+ | ------------------ | -------- | ------- | ---------------------------------------- |
406
+ | `--base-url <url>` | no | | Server base URL |
407
+ | `--json` | no | | Output the raw server response as JSON |
408
+ | `--yes` | no | | Required in non-interactive environments |
409
+
410
+ ### `eigenpal agent experiment run [options] <agent-id-or-slug>`
411
+
412
+ Start an experiment over dataset examples.
413
+
414
+ ### Arguments
415
+
416
+ | Name | Required | Variadic | Description |
417
+ | ------------------ | -------- | -------- | ----------- |
418
+ | `agent-id-or-slug` | yes | no | |
419
+
420
+ ### Options
421
+
422
+ | Flag | Required | Default | Description |
423
+ | ---------------------- | -------- | ------- | --------------------------------------------------- |
424
+ | `--base-url <url>` | no | | Server base URL |
425
+ | `--json` | no | | Output the raw server response as JSON |
426
+ | `--example-id <id>` | no | | Run one dataset example |
427
+ | `--wait` | no | | Poll until the experiment reaches a terminal status |
428
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
429
+
430
+ ### `eigenpal agent experiment status [options] <agent-id-or-slug> <batch-id>`
431
+
432
+ Get experiment status.
433
+
434
+ ### Arguments
435
+
436
+ | Name | Required | Variadic | Description |
437
+ | ------------------ | -------- | -------- | ----------- |
438
+ | `agent-id-or-slug` | yes | no | |
439
+ | `batch-id` | yes | no | |
440
+
441
+ ### Options
442
+
443
+ | Flag | Required | Default | Description |
444
+ | ---------------------- | -------- | ------- | -------------------------------------- |
445
+ | `--base-url <url>` | no | | Server base URL |
446
+ | `--json` | no | | Output the raw server response as JSON |
447
+ | `--watch` | no | | Poll until complete |
448
+ | `--interval <seconds>` | no | `2` | Polling interval in seconds |
449
+ | `--max-wait <seconds>` | no | `1800` | Maximum wait before exiting 2 |
450
+ | `--include <parts>` | no | | Reserved for future detailed parts |
451
+
452
+ ### `eigenpal agent experiment results [options] <agent-id-or-slug> [batch-id]`
453
+
454
+ Print experiment results as JSON or CSV.
455
+
456
+ ### Arguments
457
+
458
+ | Name | Required | Variadic | Description |
459
+ | ------------------ | -------- | -------- | ----------- |
460
+ | `agent-id-or-slug` | yes | no | |
461
+ | `batch-id` | no | no | |
462
+
463
+ ### Options
464
+
465
+ | Flag | Required | Default | Description |
466
+ | ---------------------- | -------- | ------- | -------------------- |
467
+ | `--base-url <url>` | no | | Server base URL |
468
+ | `--format <csv\|json>` | yes | | Output format |
469
+ | `--out <path>` | no | | Write output to file |
470
+
471
+ ### `eigenpal agent experiment list [options] <agent-id-or-slug>`
472
+
473
+ List experiments.
474
+
475
+ ### Arguments
476
+
477
+ | Name | Required | Variadic | Description |
478
+ | ------------------ | -------- | -------- | ----------- |
479
+ | `agent-id-or-slug` | yes | no | |
480
+
481
+ ### Options
482
+
483
+ | Flag | Required | Default | Description |
484
+ | ------------------ | -------- | ------- | -------------------------------------- |
485
+ | `--base-url <url>` | no | | Server base URL |
486
+ | `--limit <n>` | no | `50` | Page size |
487
+ | `--offset <n>` | no | `0` | Page offset |
488
+ | `--json` | no | | Output the raw server response as JSON |
489
+ | `--batch-id <id>` | no | | Filter to one batch id |
490
+
491
+ ### `eigenpal agent experiment compare [options] <batch-id-a> <batch-id-b>`
492
+
493
+ Compare two experiment batches.
494
+
495
+ ### Arguments
496
+
497
+ | Name | Required | Variadic | Description |
498
+ | ------------ | -------- | -------- | ----------- |
499
+ | `batch-id-a` | yes | no | |
500
+ | `batch-id-b` | yes | no | |
501
+
502
+ ### Options
503
+
504
+ | Flag | Required | Default | Description |
505
+ | ---------------------------- | -------- | ------- | ------------------------------------------------------------- |
506
+ | `--base-url <url>` | no | | Server base URL |
507
+ | `--json` | no | | Output the raw server response as JSON |
508
+ | `--sort <mode>` | no | | Accepted for compatibility; sorting happens client-side later |
509
+ | `--regression-threshold <n>` | no | | Accepted for compatibility |
510
+
511
+ ### `eigenpal agent experiment cancel [options] <agent-id-or-slug> <batch-id>`
512
+
513
+ Cancel every active execution in an experiment.
514
+
515
+ ### Arguments
516
+
517
+ | Name | Required | Variadic | Description |
518
+ | ------------------ | -------- | -------- | ----------- |
519
+ | `agent-id-or-slug` | yes | no | |
520
+ | `batch-id` | yes | no | |
521
+
522
+ ### Options
523
+
524
+ | Flag | Required | Default | Description |
525
+ | ------------------ | -------- | ------- | ---------------------------------------- |
526
+ | `--base-url <url>` | no | | Server base URL |
527
+ | `--json` | no | | Output the raw server response as JSON |
528
+ | `--yes` | no | | Required in non-interactive environments |
529
+
530
+ ### `eigenpal agent session list [options] <agent-id-or-slug>`
531
+
532
+ List builder sessions for an agent.
533
+
534
+ ### Arguments
535
+
536
+ | Name | Required | Variadic | Description |
537
+ | ------------------ | -------- | -------- | ----------- |
538
+ | `agent-id-or-slug` | yes | no | |
539
+
540
+ ### Options
541
+
542
+ | Flag | Required | Default | Description |
543
+ | ------------------ | -------- | ------- | -------------------------------------- |
544
+ | `--base-url <url>` | no | | Server base URL |
545
+ | `--limit <n>` | no | `50` | Page size |
546
+ | `--offset <n>` | no | `0` | Page offset |
547
+ | `--json` | no | | Output the raw server response as JSON |
548
+
549
+ ### `eigenpal agent session get [options] <session-id>`
550
+
551
+ Get a builder session and messages.
552
+
553
+ ### Arguments
554
+
555
+ | Name | Required | Variadic | Description |
556
+ | ------------ | -------- | -------- | ----------- |
557
+ | `session-id` | yes | no | |
558
+
559
+ ### Options
560
+
561
+ | Flag | Required | Default | Description |
562
+ | ------------------ | -------- | ------- | -------------------------------------- |
563
+ | `--base-url <url>` | no | | Server base URL |
564
+ | `--json` | no | | Output the raw server response as JSON |
565
+
566
+ ### `eigenpal agent session start [options] <agent-id-or-slug>`
567
+
568
+ Start a builder session.
569
+
570
+ ### Arguments
571
+
572
+ | Name | Required | Variadic | Description |
573
+ | ------------------ | -------- | -------- | ----------- |
574
+ | `agent-id-or-slug` | yes | no | |
575
+
576
+ ### Options
577
+
578
+ | Flag | Required | Default | Description |
579
+ | ------------------ | -------- | ------- | -------------------------------------- |
580
+ | `--base-url <url>` | no | | Server base URL |
581
+ | `--json` | no | | Output the raw server response as JSON |
582
+ | `--title <title>` | no | | Session title |
583
+
584
+ ### `eigenpal agent session message [options] <session-id>`
585
+
586
+ Append a message to a builder session.
587
+
588
+ ### Arguments
589
+
590
+ | Name | Required | Variadic | Description |
591
+ | ------------ | -------- | -------- | ----------- |
592
+ | `session-id` | yes | no | |
593
+
594
+ ### Options
595
+
596
+ | Flag | Required | Default | Description |
597
+ | ------------------ | -------- | ------- | ---------------------------------------------------------- |
598
+ | `--base-url <url>` | no | | Server base URL |
599
+ | `--json` | no | | Output the raw server response as JSON |
600
+ | `--text <message>` | yes | | Message text |
601
+ | `--wait` | no | | Reserved; server acknowledges after enqueueing the message |
602
+
603
+ ### `eigenpal agent session stop [options] <session-id>`
604
+
605
+ Stop a builder session.
606
+
607
+ ### Arguments
608
+
609
+ | Name | Required | Variadic | Description |
610
+ | ------------ | -------- | -------- | ----------- |
611
+ | `session-id` | yes | no | |
612
+
613
+ ### Options
614
+
615
+ | Flag | Required | Default | Description |
616
+ | ------------------ | -------- | ------- | ---------------------------------------- |
617
+ | `--base-url <url>` | no | | Server base URL |
618
+ | `--json` | no | | Output the raw server response as JSON |
619
+ | `--yes` | no | | Required in non-interactive environments |
620
+
621
+ ### `eigenpal agent trigger list [options] <agent-id-or-slug>`
622
+
623
+ List enabled agent triggers.
624
+
625
+ ### Arguments
626
+
627
+ | Name | Required | Variadic | Description |
628
+ | ------------------ | -------- | -------- | ----------- |
629
+ | `agent-id-or-slug` | yes | no | |
630
+
631
+ ### Options
632
+
633
+ | Flag | Required | Default | Description |
634
+ | ------------------ | -------- | ------- | -------------------------------------- |
635
+ | `--base-url <url>` | no | | Server base URL |
636
+ | `--json` | no | | Output the raw server response as JSON |
637
+
638
+ ### `eigenpal agent trigger api enable [options] <agent-id-or-slug>`
639
+
640
+ Enable the API trigger for an agent.
641
+
642
+ ### Arguments
643
+
644
+ | Name | Required | Variadic | Description |
645
+ | ------------------ | -------- | -------- | ----------- |
646
+ | `agent-id-or-slug` | yes | no | |
647
+
648
+ ### Options
649
+
650
+ | Flag | Required | Default | Description |
651
+ | ------------------ | -------- | ------- | -------------------------------------- |
652
+ | `--base-url <url>` | no | | Server base URL |
653
+ | `--json` | no | | Output the raw server response as JSON |
654
+
655
+ ### `eigenpal agent trigger api disable [options] <agent-id-or-slug>`
656
+
657
+ Disable the API trigger for an agent.
658
+
659
+ ### Arguments
660
+
661
+ | Name | Required | Variadic | Description |
662
+ | ------------------ | -------- | -------- | ----------- |
663
+ | `agent-id-or-slug` | yes | no | |
664
+
665
+ ### Options
666
+
667
+ | Flag | Required | Default | Description |
668
+ | ------------------ | -------- | ------- | -------------------------------------- |
669
+ | `--base-url <url>` | no | | Server base URL |
670
+ | `--json` | no | | Output the raw server response as JSON |
671
+
672
+ ### `eigenpal agent trigger email enable [options] <agent-id-or-slug>`
673
+
674
+ Enable the email trigger for an agent.
675
+
676
+ ### Arguments
677
+
678
+ | Name | Required | Variadic | Description |
679
+ | ------------------ | -------- | -------- | ----------- |
680
+ | `agent-id-or-slug` | yes | no | |
681
+
682
+ ### Options
683
+
684
+ | Flag | Required | Default | Description |
685
+ | ------------------ | -------- | ------- | -------------------------------------- |
686
+ | `--base-url <url>` | no | | Server base URL |
687
+ | `--json` | no | | Output the raw server response as JSON |
688
+
689
+ ### `eigenpal agent trigger email disable [options] <agent-id-or-slug>`
690
+
691
+ Disable the email trigger for an agent.
692
+
693
+ ### Arguments
694
+
695
+ | Name | Required | Variadic | Description |
696
+ | ------------------ | -------- | -------- | ----------- |
697
+ | `agent-id-or-slug` | yes | no | |
698
+
699
+ ### Options
700
+
701
+ | Flag | Required | Default | Description |
702
+ | ------------------ | -------- | ------- | -------------------------------------- |
703
+ | `--base-url <url>` | no | | Server base URL |
704
+ | `--json` | no | | Output the raw server response as JSON |
705
+
706
+ ### `eigenpal agent trigger email list [options] [agent-id-or-slug]`
707
+
708
+ List email triggers, optionally filtered to one agent.
709
+
710
+ ### Arguments
711
+
712
+ | Name | Required | Variadic | Description |
713
+ | ------------------ | -------- | -------- | ----------- |
714
+ | `agent-id-or-slug` | no | no | |
715
+
716
+ ### Options
717
+
718
+ | Flag | Required | Default | Description |
719
+ | ------------------ | -------- | ------- | -------------------------------------- |
720
+ | `--base-url <url>` | no | | Server base URL |
721
+ | `--json` | no | | Output the raw server response as JSON |
722
+
723
+ ### `eigenpal agent trigger email add [options] <agent-id-or-slug>`
724
+
725
+ Add an email trigger to an agent.
726
+
727
+ ### Arguments
728
+
729
+ | Name | Required | Variadic | Description |
730
+ | ------------------ | -------- | -------- | ----------- |
731
+ | `agent-id-or-slug` | yes | no | |
732
+
733
+ ### Options
734
+
735
+ | Flag | Required | Default | Description |
736
+ | ---------------------------- | -------- | ------- | -------------------------------------- |
737
+ | `--base-url <url>` | no | | Server base URL |
738
+ | `--json` | no | | Output the raw server response as JSON |
739
+ | `--email <local-part>` | yes | | Email local-part, e.g. invoice-intake |
740
+ | `--label <label>` | no | | Human label |
741
+ | `--allow <sender>` | no | `[]` | Allowed sender pattern; repeatable |
742
+ | `--reply <never\|always>` | no | | Reply behavior |
743
+ | `--reply-mode <sender\|all>` | no | | Reply recipients |
744
+
745
+ ### `eigenpal agent trigger email update [options] <agent-id-or-slug> <email-id>`
746
+
747
+ Update an email trigger.
748
+
749
+ ### Arguments
750
+
751
+ | Name | Required | Variadic | Description |
752
+ | ------------------ | -------- | -------- | ----------- |
753
+ | `agent-id-or-slug` | yes | no | |
754
+ | `email-id` | yes | no | |
755
+
756
+ ### Options
757
+
758
+ | Flag | Required | Default | Description |
759
+ | ----------------------------- | -------- | ------- | -------------------------------------- |
760
+ | `--base-url <url>` | no | | Server base URL |
761
+ | `--json` | no | | Output the raw server response as JSON |
762
+ | `--label <label>` | no | | Human label |
763
+ | `--allow <sender>` | no | `[]` | Allowed sender pattern; repeatable |
764
+ | `--status <active\|disabled>` | no | | Email trigger status |
765
+ | `--reply <never\|always>` | no | | Reply behavior |
766
+ | `--reply-mode <sender\|all>` | no | | Reply recipients |
767
+
768
+ ### `eigenpal agent trigger email remove [options] <agent-id-or-slug> <email-id>`
769
+
770
+ Remove an email trigger.
771
+
772
+ ### Arguments
773
+
774
+ | Name | Required | Variadic | Description |
775
+ | ------------------ | -------- | -------- | ----------- |
776
+ | `agent-id-or-slug` | yes | no | |
777
+ | `email-id` | yes | no | |
778
+
779
+ ### Options
780
+
781
+ | Flag | Required | Default | Description |
782
+ | ------------------ | -------- | ------- | ---------------------------------------- |
783
+ | `--base-url <url>` | no | | Server base URL |
784
+ | `--json` | no | | Output the raw server response as JSON |
785
+ | `--yes` | no | | Required in non-interactive environments |
786
+
787
+ ### `eigenpal agent evaluators list [options] [agent-id-or-slug]`
788
+
789
+ Agent evaluators are reserved for future workflow-style evaluators. Coming soon.
790
+
791
+ ### Arguments
792
+
793
+ | Name | Required | Variadic | Description |
794
+ | ------------------ | -------- | -------- | ----------- |
795
+ | `agent-id-or-slug` | no | no | |
796
+
797
+ ### `eigenpal agent versions list [options] [agent-id-or-slug]`
798
+
799
+ Agent versions are coming soon. Coming soon.
800
+
801
+ ### Arguments
802
+
803
+ | Name | Required | Variadic | Description |
804
+ | ------------------ | -------- | -------- | ----------- |
805
+ | `agent-id-or-slug` | no | no | |