@eigenpal/cli 0.16.8 → 0.16.9

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.
@@ -15,6 +15,7 @@ Manage Eigenpal agents: Git source, datasets, experiments, sessions, and release
15
15
  - [Env](#env)
16
16
  - [Details](#details)
17
17
  - [`eigenpal agents list|ls [options]`](#eigenpal-agents-listls-options)
18
+ - [`eigenpal agents delete [options] <agent-id-or-slug>`](#eigenpal-agents-delete-options-agent-id-or-slug)
18
19
  - [`eigenpal agents validate [options] [dir]`](#eigenpal-agents-validate-options-dir)
19
20
  - [`eigenpal agents clone [options]`](#eigenpal-agents-clone-options)
20
21
  - [`eigenpal agents install [options] [packageRef]`](#eigenpal-agents-install-options-packageref)
@@ -62,6 +63,7 @@ Manage Eigenpal agents: Git source, datasets, experiments, sessions, and release
62
63
  ```
63
64
  agents
64
65
  ├── list|ls
66
+ ├── delete <agent-id-or-slug>
65
67
  ├── file
66
68
  │ ├── list|ls <agent-id-or-slug>
67
69
  │ ├── get <agent-id-or-slug> <remote-path>
@@ -115,26 +117,27 @@ agents
115
117
 
116
118
  ### Core
117
119
 
118
- | Command | Description |
119
- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
120
- | `eigenpal agents list\|ls [options]` | List agents. |
121
- | `eigenpal agents validate [options] [dir]` | Validate a local agent package (layout, manifest, schemas, and Git source rules). |
122
- | `eigenpal agents clone [options]` | Clone the organization source repository. |
123
- | `eigenpal agents install [options] [packageRef]` | Materialize a source package and its workspace dependencies. |
124
- | `eigenpal agents init [options] <name>` | Create a new source package scaffold. |
125
- | `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. |
126
- | `eigenpal agents commit [options]` | Validate changed source packages and commit them. |
127
- | `eigenpal agents save [options]` | Validate, commit if dirty, and push the current source branch. |
128
- | `eigenpal agents push [options]` | Push the current organization source branch and tags. |
129
- | `eigenpal agents upgrade [options]` | Upgrade the source repository schema in place. |
130
- | `eigenpal agents doctor [options]` | Check organization source repository health. |
131
- | `eigenpal agents status [options]` | Show source repo and package status. |
132
- | `eigenpal agents deps [options]` | List package workspace dependencies. |
133
- | `eigenpal agents clean [options]` | Require a clean source working tree. |
134
- | `eigenpal agents show [options] <automation>` | Show Git-backed automation details. |
135
- | `eigenpal agents versions [options] <package>` | List package release versions. |
136
- | `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. |
137
- | `eigenpal agents sync [options] [automation]` | Sync an automation from the latest Git source release. |
120
+ | Command | Description |
121
+ | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
122
+ | `eigenpal agents list\|ls [options]` | List agents. |
123
+ | `eigenpal agents delete [options] <agent-id-or-slug>` | Delete an agent and its versions from the server. |
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. |
138
141
 
139
142
  ### File
140
143
 
@@ -206,6 +209,24 @@ List agents.
206
209
  | `--json` | no | | Emit machine-readable JSON on stdout |
207
210
  | `--search <q>` | no | | Search by slug, name, or description |
208
211
 
212
+ ### `eigenpal agents delete [options] <agent-id-or-slug>`
213
+
214
+ Delete an agent and its versions from the server.
215
+
216
+ ### Arguments
217
+
218
+ | Name | Required | Variadic | Description |
219
+ | ------------------ | -------- | -------- | ----------- |
220
+ | `agent-id-or-slug` | yes | no | |
221
+
222
+ ### Options
223
+
224
+ | Flag | Required | Default | Description |
225
+ | ------------------ | -------- | ------- | --------------------------------------------------------------------------- |
226
+ | `--base-url <url>` | no | | Server base URL |
227
+ | `--json` | no | | Emit machine-readable JSON on stdout |
228
+ | `--yes` | no | | Skip typed-id confirmation (required in CI / agent terminals without a TTY) |
229
+
209
230
  ### `eigenpal agents validate [options] [dir]`
210
231
 
211
232
  Validate a local agent package (layout, manifest, schemas, and Git source rules).
@@ -0,0 +1,154 @@
1
+ # eigenpal reviews
2
+
3
+ Work the live human-review queue for paused runs: list pending tasks, confirm fields, approve, reject, and download attachments.
4
+
5
+ ## Contents
6
+
7
+ - [Surface](#surface)
8
+ - [Commands](#commands)
9
+ - [Core](#core)
10
+ - [Details](#details)
11
+ - [`eigenpal reviews|rv list|ls [options]`](#eigenpal-reviewsrv-listls-options)
12
+ - [`eigenpal reviews|rv get [options] <task-id>`](#eigenpal-reviewsrv-get-options-task-id)
13
+ - [`eigenpal reviews|rv confirm [options] <task-id>`](#eigenpal-reviewsrv-confirm-options-task-id)
14
+ - [`eigenpal reviews|rv approve [options] <task-id>`](#eigenpal-reviewsrv-approve-options-task-id)
15
+ - [`eigenpal reviews|rv reject [options] <task-id>`](#eigenpal-reviewsrv-reject-options-task-id)
16
+ - [`eigenpal reviews|rv download [options] <task-id> <file-id>`](#eigenpal-reviewsrv-download-options-task-id-file-id)
17
+
18
+ ## Surface
19
+
20
+ ```
21
+ reviews
22
+ ├── list|ls
23
+ ├── get <task-id>
24
+ ├── confirm <task-id>
25
+ ├── approve <task-id>
26
+ ├── reject <task-id>
27
+ └── download <task-id> <file-id>
28
+ ```
29
+
30
+ ## Commands
31
+
32
+ ### Core
33
+
34
+ | Command | Description |
35
+ | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
36
+ | `eigenpal reviews\|rv list\|ls [options]` | List pending human-review tasks (oldest first, cursor-paginated). |
37
+ | `eigenpal reviews\|rv get [options] <task-id>` | Get one human-review task with its field decisions and attached files. |
38
+ | `eigenpal reviews\|rv confirm [options] <task-id>` | Confirm or edit one scalar review field. Use --withdraw to persist a draft edit without confirming. |
39
+ | `eigenpal reviews\|rv approve [options] <task-id>` | Approve a review task after all required fields are confirmed. |
40
+ | `eigenpal reviews\|rv reject [options] <task-id>` | Reject a review task and fail the paused run with a reason. |
41
+ | `eigenpal reviews\|rv download [options] <task-id> <file-id>` | Download one file attached to a review task. |
42
+
43
+ ## Details
44
+
45
+ ### `eigenpal reviews|rv list|ls [options]`
46
+
47
+ List pending human-review tasks (oldest first, cursor-paginated).
48
+
49
+ ### Options
50
+
51
+ | Flag | Required | Default | Description |
52
+ | ------------------------ | -------- | ------- | --------------------------------------------------------------- |
53
+ | `--automation-id <id>` | no | | Filter to one automation id |
54
+ | `--waiting-before <iso>` | no | | Only tasks created before this ISO timestamp (queue age filter) |
55
+ | `--cursor <token>` | no | | Pagination cursor from a previous list response |
56
+ | `--limit <n>` | no | `50` | Page size (1–100) |
57
+ | `--base-url <url>` | no | | Server base URL |
58
+ | `--json` | no | | Emit machine-readable JSON on stdout |
59
+
60
+ ### `eigenpal reviews|rv get [options] <task-id>`
61
+
62
+ Get one human-review task with its field decisions and attached files.
63
+
64
+ ### Arguments
65
+
66
+ | Name | Required | Variadic | Description |
67
+ | --------- | -------- | -------- | ----------- |
68
+ | `task-id` | yes | no | |
69
+
70
+ ### Options
71
+
72
+ | Flag | Required | Default | Description |
73
+ | ------------------ | -------- | ------- | ------------------------------------ |
74
+ | `--base-url <url>` | no | | Server base URL |
75
+ | `--json` | no | | Emit machine-readable JSON on stdout |
76
+
77
+ ### `eigenpal reviews|rv confirm [options] <task-id>`
78
+
79
+ Confirm or edit one scalar review field. Use --withdraw to persist a draft edit without confirming.
80
+
81
+ ### Arguments
82
+
83
+ | Name | Required | Variadic | Description |
84
+ | --------- | -------- | -------- | ----------- |
85
+ | `task-id` | yes | no | |
86
+
87
+ ### Options
88
+
89
+ | Flag | Required | Default | Description |
90
+ | ------------------------- | -------- | ------- | --------------------------------------------------------- |
91
+ | `--path <json-pointer>` | yes | | Field JSON pointer (for example /vendor or /items/0/name) |
92
+ | `--value <scalar>` | no | | Scalar value: string, number, true, false, or null |
93
+ | `--value-json <json>` | no | | Scalar JSON literal (alternative to --value) |
94
+ | `--expected-version <n>` | yes | | Optimistic concurrency version from get/list |
95
+ | `--idempotency-key <key>` | no | | Durable idempotency key (auto-generated when omitted) |
96
+ | `--withdraw` | no | | Persist the edit without confirming (confirmed=false) |
97
+ | `--base-url <url>` | no | | Server base URL |
98
+ | `--json` | no | | Emit machine-readable JSON on stdout |
99
+
100
+ ### `eigenpal reviews|rv approve [options] <task-id>`
101
+
102
+ Approve a review task after all required fields are confirmed.
103
+
104
+ ### Arguments
105
+
106
+ | Name | Required | Variadic | Description |
107
+ | --------- | -------- | -------- | ----------- |
108
+ | `task-id` | yes | no | |
109
+
110
+ ### Options
111
+
112
+ | Flag | Required | Default | Description |
113
+ | ------------------------ | -------- | ------- | -------------------------------------------- |
114
+ | `--expected-version <n>` | yes | | Optimistic concurrency version from get/list |
115
+ | `--base-url <url>` | no | | Server base URL |
116
+ | `--json` | no | | Emit machine-readable JSON on stdout |
117
+
118
+ ### `eigenpal reviews|rv reject [options] <task-id>`
119
+
120
+ Reject a review task and fail the paused run with a reason.
121
+
122
+ ### Arguments
123
+
124
+ | Name | Required | Variadic | Description |
125
+ | --------- | -------- | -------- | ----------- |
126
+ | `task-id` | yes | no | |
127
+
128
+ ### Options
129
+
130
+ | Flag | Required | Default | Description |
131
+ | ------------------------- | -------- | ------- | ----------------------------------------------------- |
132
+ | `--reason <text>` | yes | | Human-readable rejection reason |
133
+ | `--expected-version <n>` | yes | | Optimistic concurrency version from get/list |
134
+ | `--idempotency-key <key>` | no | | Durable idempotency key (auto-generated when omitted) |
135
+ | `--base-url <url>` | no | | Server base URL |
136
+ | `--json` | no | | Emit machine-readable JSON on stdout |
137
+
138
+ ### `eigenpal reviews|rv download [options] <task-id> <file-id>`
139
+
140
+ Download one file attached to a review task.
141
+
142
+ ### Arguments
143
+
144
+ | Name | Required | Variadic | Description |
145
+ | --------- | -------- | -------- | ----------- |
146
+ | `task-id` | yes | no | |
147
+ | `file-id` | yes | no | |
148
+
149
+ ### Options
150
+
151
+ | Flag | Required | Default | Description |
152
+ | ------------------ | -------- | ------- | ----------------------------- |
153
+ | `--out <path>` | yes | | Write bytes to this file path |
154
+ | `--base-url <url>` | no | | Server base URL |
@@ -18,6 +18,12 @@ eigenpal
18
18
  │ ├── schema <workflow-id>
19
19
  │ ├── push
20
20
  │ ├── move <workflow-id>
21
+ │ ├── delete <workflow-id>
22
+ │ ├── folders
23
+ │ │ ├── list|ls
24
+ │ │ ├── create <path>
25
+ │ │ ├── rename <path-or-id>
26
+ │ │ └── delete <path-or-id>
21
27
  │ ├── evaluators
22
28
  │ │ ├── pull <workflow-id>
23
29
  │ │ ├── push <workflow-id>
@@ -65,6 +71,7 @@ eigenpal
65
71
  │ └── exec <type>
66
72
  ├── agents
67
73
  │ ├── list|ls
74
+ │ ├── delete <agent-id-or-slug>
68
75
  │ ├── file
69
76
  │ │ ├── list|ls <agent-id-or-slug>
70
77
  │ │ ├── get <agent-id-or-slug> <remote-path>
@@ -147,6 +154,13 @@ eigenpal
147
154
  │ │ └── delete <run-id> <name>
148
155
  │ ├── watch <run-id>
149
156
  │ └── cancel <run-id>
157
+ ├── reviews|rv
158
+ │ ├── list|ls
159
+ │ ├── get <task-id>
160
+ │ ├── confirm <task-id>
161
+ │ ├── approve <task-id>
162
+ │ ├── reject <task-id>
163
+ │ └── download <task-id> <file-id>
150
164
  ├── docs
151
165
  │ ├── list|ls [prefix]
152
166
  │ ├── search <query>
@@ -7,6 +7,7 @@ Manage workflows: push, pull, and evaluate.
7
7
  - [Surface](#surface)
8
8
  - [Commands](#commands)
9
9
  - [Core](#core)
10
+ - [Folders](#folders)
10
11
  - [Evaluators](#evaluators)
11
12
  - [Dataset](#dataset)
12
13
  - [Templates](#templates)
@@ -21,8 +22,13 @@ Manage workflows: push, pull, and evaluate.
21
22
  - [`eigenpal workflow schema [options] <workflow-id>`](#eigenpal-workflow-schema-options-workflow-id)
22
23
  - [`eigenpal workflow push [options]`](#eigenpal-workflow-push-options)
23
24
  - [`eigenpal workflow move [options] <workflow-id>`](#eigenpal-workflow-move-options-workflow-id)
25
+ - [`eigenpal workflow delete [options] <workflow-id>`](#eigenpal-workflow-delete-options-workflow-id)
24
26
  - [`eigenpal workflow validate [options] [path]`](#eigenpal-workflow-validate-options-path)
25
27
  - [`eigenpal workflow clear-local [options] [examples...]`](#eigenpal-workflow-clear-local-options-examples)
28
+ - [`eigenpal workflow folders list|ls [options]`](#eigenpal-workflow-folders-listls-options)
29
+ - [`eigenpal workflow folders create [options] <path>`](#eigenpal-workflow-folders-create-options-path)
30
+ - [`eigenpal workflow folders rename [options] <path-or-id>`](#eigenpal-workflow-folders-rename-options-path-or-id)
31
+ - [`eigenpal workflow folders delete [options] <path-or-id>`](#eigenpal-workflow-folders-delete-options-path-or-id)
26
32
  - [`eigenpal workflow evaluators pull [options] <workflow-id>`](#eigenpal-workflow-evaluators-pull-options-workflow-id)
27
33
  - [`eigenpal workflow evaluators push [options] <workflow-id>`](#eigenpal-workflow-evaluators-push-options-workflow-id)
28
34
  - [`eigenpal workflow evaluators validate [options] [path]`](#eigenpal-workflow-evaluators-validate-options-path)
@@ -67,6 +73,12 @@ workflow
67
73
  ├── schema <workflow-id>
68
74
  ├── push
69
75
  ├── move <workflow-id>
76
+ ├── delete <workflow-id>
77
+ ├── folders
78
+ │ ├── list|ls
79
+ │ ├── create <path>
80
+ │ ├── rename <path-or-id>
81
+ │ └── delete <path-or-id>
70
82
  ├── evaluators
71
83
  │ ├── pull <workflow-id>
72
84
  │ ├── push <workflow-id>
@@ -125,9 +137,19 @@ workflow
125
137
  | `eigenpal workflow schema [options] <workflow-id>` | Show the inferred output schema for a workflow (what it returns). |
126
138
  | `eigenpal workflow push [options]` | Create or update a workflow from a YAML file. |
127
139
  | `eigenpal workflow move [options] <workflow-id>` | Move a workflow to a folder path, creating folders as needed |
140
+ | `eigenpal workflow delete [options] <workflow-id>` | Delete a workflow definition while preserving past runs. |
128
141
  | `eigenpal workflow validate [options] [path]` | Local-only validation. Without [path]: runs the templated three-way check (./workflow.yaml + ./evaluators.yaml + ./dataset/) in the project root. When the root has no workflow.yaml, discovers nested projects under eigenpal/workflows/<slug>/ or workflows/<slug>/ and validates each. With [path] pointing at a YAML file: validates that workflow.yaml only. For per-noun targeting use `evaluators validate` or `dataset validate`. |
129
142
  | `eigenpal workflow clear-local [options] [examples...]` | Delete local execution artifacts under ./dataset/examples/. Keeps the latest run per example by default. |
130
143
 
144
+ ### Folders
145
+
146
+ | Command | Description |
147
+ | --------------------------------------------------------- | ----------------------------------------------------------- |
148
+ | `eigenpal workflow folders list\|ls [options]` | List workflow folders. |
149
+ | `eigenpal workflow folders create [options] <path>` | Create a folder path, creating any missing parent segments. |
150
+ | `eigenpal workflow folders rename [options] <path-or-id>` | Rename a workflow folder. |
151
+ | `eigenpal workflow folders delete [options] <path-or-id>` | Delete a workflow folder. |
152
+
131
153
  ### Evaluators
132
154
 
133
155
  | Command | Description |
@@ -287,6 +309,24 @@ Move a workflow to a folder path, creating folders as needed
287
309
  | `--base-url <url>` | no | | Server base URL |
288
310
  | `--json` | no | | Emit machine-readable JSON on stdout |
289
311
 
312
+ ### `eigenpal workflow delete [options] <workflow-id>`
313
+
314
+ Delete a workflow definition while preserving past runs.
315
+
316
+ ### Arguments
317
+
318
+ | Name | Required | Variadic | Description |
319
+ | ------------- | -------- | -------- | ----------- |
320
+ | `workflow-id` | yes | no | |
321
+
322
+ ### Options
323
+
324
+ | Flag | Required | Default | Description |
325
+ | ------------------ | -------- | ------- | --------------------------------------------------------------------------- |
326
+ | `--yes` | no | | Skip typed-id confirmation (required in CI / agent terminals without a TTY) |
327
+ | `--base-url <url>` | no | | Server base URL |
328
+ | `--json` | no | | Emit machine-readable JSON on stdout |
329
+
290
330
  ### `eigenpal workflow validate [options] [path]`
291
331
 
292
332
  Local-only validation. Without [path]: runs the templated three-way check (./workflow.yaml + ./evaluators.yaml + ./dataset/) in the project root. When the root has no workflow.yaml, discovers nested projects under eigenpal/workflows/<slug>/ or workflows/<slug>/ and validates each. With [path] pointing at a YAML file: validates that workflow.yaml only. For per-noun targeting use `evaluators validate` or `dataset validate`.
@@ -323,6 +363,71 @@ Delete local execution artifacts under ./dataset/examples/. Keeps the latest run
323
363
  | `--dir <dir>` | no | | Local eigenpal directory |
324
364
  | `--all` | no | `false` | Remove all artifacts, including the latest kept by default |
325
365
 
366
+ ### `eigenpal workflow folders list|ls [options]`
367
+
368
+ List workflow folders.
369
+
370
+ ### Options
371
+
372
+ | Flag | Required | Default | Description |
373
+ | ------------------ | -------- | ------- | ------------------------------------ |
374
+ | `--base-url <url>` | no | | Server base URL |
375
+ | `--json` | no | | Emit machine-readable JSON on stdout |
376
+ | `--tree` | no | | Render folders as an indented tree |
377
+
378
+ ### `eigenpal workflow folders create [options] <path>`
379
+
380
+ Create a folder path, creating any missing parent segments.
381
+
382
+ ### Arguments
383
+
384
+ | Name | Required | Variadic | Description |
385
+ | ------ | -------- | -------- | ----------- |
386
+ | `path` | yes | no | |
387
+
388
+ ### Options
389
+
390
+ | Flag | Required | Default | Description |
391
+ | ------------------ | -------- | ------- | ------------------------------------ |
392
+ | `--base-url <url>` | no | | Server base URL |
393
+ | `--json` | no | | Emit machine-readable JSON on stdout |
394
+
395
+ ### `eigenpal workflow folders rename [options] <path-or-id>`
396
+
397
+ Rename a workflow folder.
398
+
399
+ ### Arguments
400
+
401
+ | Name | Required | Variadic | Description |
402
+ | ------------ | -------- | -------- | ----------- |
403
+ | `path-or-id` | yes | no | |
404
+
405
+ ### Options
406
+
407
+ | Flag | Required | Default | Description |
408
+ | ------------------ | -------- | ------- | ------------------------------------ |
409
+ | `--base-url <url>` | no | | Server base URL |
410
+ | `--json` | no | | Emit machine-readable JSON on stdout |
411
+ | `--name <name>` | yes | | New folder name |
412
+
413
+ ### `eigenpal workflow folders delete [options] <path-or-id>`
414
+
415
+ Delete a workflow folder.
416
+
417
+ ### Arguments
418
+
419
+ | Name | Required | Variadic | Description |
420
+ | ------------ | -------- | -------- | ----------- |
421
+ | `path-or-id` | yes | no | |
422
+
423
+ ### Options
424
+
425
+ | Flag | Required | Default | Description |
426
+ | ------------------ | -------- | ------- | --------------------------------------------------------------------------- |
427
+ | `--base-url <url>` | no | | Server base URL |
428
+ | `--json` | no | | Emit machine-readable JSON on stdout |
429
+ | `--yes` | no | | Skip typed-id confirmation (required in CI / agent terminals without a TTY) |
430
+
326
431
  ### `eigenpal workflow evaluators pull [options] <workflow-id>`
327
432
 
328
433
  Download the workflow's evaluators YAML.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@eigenpal/cli",
3
- "version": "0.16.8",
3
+ "version": "0.16.9",
4
4
  "description": "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
5
5
  "keywords": [
6
6
  "eigenpal",