@eigenpal/cli 0.10.5 → 0.10.7

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @eigenpal/cli
 
+## 0.10.7
+
+### Patch Changes
+
+- 664bbed: `eigenpal --help` now groups `run`, `rerun`, and `runs` under a dedicated "Run" section instead of the catch-all "Other" bucket, so starting a run and reading its output is easy to find from the top-level help. The "Workflows" and "Agents" group descriptions were tightened to match.
+
 ## 0.10.5
 
 ### Minor Changes

package/dist/cli.js

@@ -65647,7 +65647,9 @@ function inputToJsonSchema(input) {
       if (itemType === "enum" && input.items?.values?.length) {
         return { type: "array", items: { type: "string", enum: input.items.values } };
       }
-      return itemType ? { type: "array", items: { type: itemType } } : { type: "array" };
+      if (!itemType || itemType === "file")
+        return { type: "array" };
+      return { type: "array", items: { type: itemType } };
     }
     case "file":
       return {};
@@ -190434,7 +190436,7 @@ import { fileURLToPath as fileURLToPath8 } from "url";
 // package.json
 var package_default = {
   name: "@eigenpal/cli",
-  version: "0.10.5",
+  version: "0.10.7",
   description: "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
   keywords: [
     "eigenpal",
@@ -200580,14 +200582,19 @@ var HELP_GROUPS = [
   },
   {
     title: "Workflows",
-    description: "Definition, evaluators, dataset, experiments, and local runs",
+    description: "Definition, evaluators, dataset, experiments, and versions",
     commands: ["workflow"]
   },
   {
     title: "Agents",
-    description: "Git-backed source (clone, save, release, sync), runs, datasets, sessions. `git` passthrough adds org remote auth.",
+    description: "Git-backed source (clone, save, release, sync), datasets, sessions. `git` passthrough adds org remote auth.",
     commands: ["agents", "git"]
   },
+  {
+    title: "Run",
+    description: "Start runs, then watch them, read their output, and download artifacts.",
+    commands: ["run", "rerun", "runs"]
+  },
   {
     title: "Tooling",
     description: "Install the Eigenpal skill into your agent tools (Claude Code, Cursor, …)",

package/dist/skill/SKILL.md

@@ -20,7 +20,10 @@ appear in user examples, but do not prefer them.
   experiments, versions, and step schemas.
 - `eigenpal agents` manages Git-backed agent source packages, shared resources,
   releases, sync, secrets, datasets, and live file inspection.
-- `eigenpal run` starts a workflow or agent run from a target.
+- `eigenpal run` starts a single workflow or agent run from a target. This is the
+  command for running something once and reading its output, including
+  API-triggered workflows. (`eigenpal workflow experiment` is a separate batch run
+  over a whole dataset, not the single-run path.)
 - `eigenpal runs` inspects, watches, compares, reruns, cancels, and downloads
   artifacts for workflow or agent runs.
 
@@ -48,10 +51,20 @@ eigenpal workflow step-type get ai.extract --json | jq '.configSchema.properties
 eigenpal workflow validate ./workflow.yaml
 eigenpal workflow push --file workflow.yaml
 
-# Run one example.
+# Run with ad-hoc input and read the output (use this for API-triggered workflows).
+# `--wait --json` polls to completion and prints the run with top-level `output`.
+eigenpal run workflows.<workflow-id> --input-json '{"document":"..."}' --wait --json | jq '.output'
+eigenpal run workflows.<workflow-id> --input-file document=./invoice.pdf --wait --json | jq '.output'
+
+# Run one persisted example instead.
 eigenpal run workflows.<workflow-id> --example <example-name>
+
+# Inspect a run after the fact. `runs get --json` returns top-level
+# `output`/`files`/`error` once the run is completed. Plain `run --wait`
+# without `--json` only prints "Run <id> is completed", so pass `--json` or
+# use `runs get` to see the output.
 eigenpal runs watch <execution-id>
-eigenpal runs get <execution-id> --json
+eigenpal runs get <execution-id> --json | jq '.output'
 
 # Push dataset and evaluators.
 eigenpal workflow dataset validate ./dataset

package/package.json

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