@eigenpal/cli 0.20.19 → 0.20.21

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @eigenpal/cli
 
+## 0.20.21
+
+### Minor Changes
+
+- 7e2ebe0: Use `eigenpal runs list --tag <tag>` to find runs with an exact tag, such as a request ID.
+
+  Start an ad-hoc workflow or agent run with `eigenpal run <target> --tag <tag>`. Repeat `--tag` for multiple tags.
+
 ## 0.20.13
 
 ### Patch Changes

package/dist/cli.js

@@ -54900,6 +54900,7 @@ var init_step_configs = __esm(() => {
     responseCharset: string2().describe("Charset used to decode the response body (e.g. utf-8, windows-1250)")
   });
   ActionInvokeWorkflowConfigSchema = object({
+    tags: union([string2().min(1), array(string2().min(1)).max(100)]).optional().describe("Child mode only. One tag or a list. Supports templates resolving to a string or string array. Tags are not inherited."),
     workflow: string2().min(1).optional().describe("Workflow to invoke — definition name or wf_ id (tenant-scoped)"),
     workflowId: string2().min(1).optional().describe("Legacy alias for workflow when the value is a wf_ id"),
     execution: _enum(["inline", "child"]).optional().describe("inline: run target steps in this execution (default). child: spawn a separate run with lineage."),
@@ -54926,6 +54927,12 @@ var init_step_configs = __esm(() => {
     }
     const mode = data.execution === "child" ? "child" : "inline";
     if (mode === "inline") {
+      if (data.tags !== undefined)
+        ctx.addIssue({
+          code: "custom",
+          message: "tags are only supported with execution: child",
+          path: ["tags"]
+        });
       if (data.wait === false) {
         ctx.addIssue({
           code: "custom",
@@ -56881,6 +56888,14 @@ var init_webhooks = __esm(() => {
   });
 });
 
+// ../types/src/execution-tags.ts
+var ExecutionTagSchema, ExecutionTagsSchema;
+var init_execution_tags = __esm(() => {
+  init_zod();
+  ExecutionTagSchema = string2().min(1).max(256).refine((tag) => tag.trim().length > 0, "Tags must not be blank");
+  ExecutionTagsSchema = union([ExecutionTagSchema, array(ExecutionTagSchema).max(100)]).transform((tags) => [...new Set(typeof tags === "string" ? [tags] : tags)]);
+});
+
 // ../types/src/index.ts
 var init_src = __esm(() => {
   init_core3();
@@ -56889,6 +56904,7 @@ var init_src = __esm(() => {
   init_parser2();
   init_execution_row();
   init_run_expand();
+  init_execution_tags();
   init_validation();
   init_workflow2();
   init_file_source();
@@ -206948,7 +206964,7 @@ import { fileURLToPath as fileURLToPath8 } from "url";
 // package.json
 var package_default = {
   name: "@eigenpal/cli",
-  version: "0.20.19",
+  version: "0.20.21",
   description: "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
   keywords: [
     "eigenpal",
@@ -206997,7 +207013,6 @@ var package_default = {
     "generate:cli-docs": "bun scripts/generate-cli-docs.ts",
     "generate:cli-docs:check": "bun scripts/generate-cli-docs.ts --check",
     "generate:logo": "bun scripts/render-logo-ascii.ts --cells 20",
-    lint: "eslint src/",
     test: "bun test src/ scripts/",
     typecheck: "tsc --noEmit"
   },
@@ -207016,7 +207031,7 @@ var package_default = {
     "@eigenpal/types": "workspace:*",
     "@eigenpal/workflow-yaml": "workspace:*",
     "@t3-oss/env-core": "^0.13.11",
-    typescript: "^6.0.3"
+    typescript: "^7.0.2"
   },
   files: [
     "dist",
@@ -241085,7 +241100,7 @@ function registerRunsCommands(program) {
     process.stderr.write("`eigenpal runs` requires a subcommand. Run `eigenpal runs --help`.\n");
     process.exit(2);
   });
-  const listRunsCmd = addJsonFlag(withPagination(withBaseUrl(runs.command("list [source]")), 50)).alias("ls").description("List runs across workflows and agents, optionally scoped to one source.").option("--type <type>", "Filter by run type: workflow|agent").option("--status <status>", "Filter by run status").option("--source-ref <ref>", "Filter agent runs by source ref").option("--batch-id <id>", "Filter eval/experiment runs by batch id").option("--example-id <id>", "Filter eval runs by example id").option("--example-id-contains <text>", "Filter eval runs by example id substring").option("--from <date>", "Created at or after this ISO timestamp or relative date").option("--to <date>", "Created before this ISO timestamp or relative date").option("--created-after <date>", "Alias for --from").option("--created-before <date>", "Alias for --to").option("--completed-after <date>", "Completed at or after this ISO timestamp or relative date").option("--completed-before <date>", "Completed before this ISO timestamp or relative date").option("--compact", "Render compact run rows").option("--sort <field>", "Sort field; only createdAt is supported").option("--order <asc|desc>", "Sort order; only desc is supported");
+  const listRunsCmd = addJsonFlag(withPagination(withBaseUrl(runs.command("list [source]")), 50)).alias("ls").description("List runs across workflows and agents, optionally scoped to one source.").option("--tag <tag>", "Filter by an exact, case-sensitive execution tag").option("--type <type>", "Filter by run type: workflow|agent").option("--status <status>", "Filter by run status").option("--source-ref <ref>", "Filter agent runs by source ref").option("--batch-id <id>", "Filter eval/experiment runs by batch id").option("--example-id <id>", "Filter eval runs by example id").option("--example-id-contains <text>", "Filter eval runs by example id substring").option("--from <date>", "Created at or after this ISO timestamp or relative date").option("--to <date>", "Created before this ISO timestamp or relative date").option("--created-after <date>", "Alias for --from").option("--created-before <date>", "Alias for --to").option("--completed-after <date>", "Completed at or after this ISO timestamp or relative date").option("--completed-before <date>", "Completed before this ISO timestamp or relative date").option("--compact", "Render compact run rows").option("--sort <field>", "Sort field; only createdAt is supported").option("--order <asc|desc>", "Sort order; only desc is supported");
   listRunsCmd.action(action(listRuns));
   addJsonFlag(withBaseUrl(runs.command("get <run-id>"))).description("Get one run.").option("--step <name>", "For workflow runs, show only this step (or comma-separated list)").option("--select <path>", "Print only a nested JSON value; implies JSON output (for example output.subjects or output.subjects[].name)").option("--expand <sections>", "Comma-separated server expand sections for GET /api/v1/runs/:id: input, usage, execution, debug. Use execution for status/schemaValid; completed runs include top-level output/files/error.").option("--include <parts>", "Comma-separated local workflow step projection fields (error, duration, inputRef, …). Legacy expand names are mapped when possible; use --expand for server sections.", "review").action(action(getRun));
   addJsonFlag(withBaseUrl(runs.command("compare <reference-run-id> <run-id>"))).description("Compare one run against another. Repeated workflow steps are matched by stable branch/iteration path.").option("--baseline", "Compare actual outputs from both runs instead of expected artifacts").option("--step <name-or-path>", "For workflow runs, restrict by step name or stable path").option("--out <dir>", "Write comparison artifacts to this directory").option("--normalize-dates", "Normalize YYYYMMDD and YYYY-MM-DD tokens in filenames/text").option("--fail-on-diff", "Exit 1 when comparison status is fail").action(action(compareRun));
@@ -241982,6 +241997,7 @@ async function listRuns(source, opts) {
 }
 function buildRunListParams(opts) {
   return compactParams({
+    tag: "tag" in opts ? opts.tag : undefined,
     type: "type" in opts ? opts.type : undefined,
     sourceRef: "sourceRef" in opts ? opts.sourceRef : undefined,
     status: "status" in opts ? opts.status : undefined,
@@ -244547,6 +244563,8 @@ async function buildPreparedRunRequest(client, input) {
   const remaining = localFiles.filter((_, index) => !preUploadIndices.has(index));
   const form = new FormData;
   form.append("target", input.target);
+  if (input.tags?.length)
+    form.append("tags", JSON.stringify(input.tags));
   form.append("input", JSON.stringify(inputObj));
   if (input.overrides)
     form.append("overrides", JSON.stringify(input.overrides));
@@ -244681,7 +244699,7 @@ async function runSavedWorkflowExamples(workflow, examples, opts) {
 
 // src/commands/run.ts
 function registerRunCommands(program) {
-  addJsonFlag(withBaseUrl(program.command("run <target>"))).description("Start a workflow or agent run, e.g. workflows.extract-invoice.").option("--input-json <json>", "JSON input object").option("--input-file <field=path>", 'Input file to upload. Files exceeding EIGENPAL_MULTIPART_MAX_BYTES (default 4.5 MiB; "none" disables) are pre-uploaded; smaller files stay on multipart. Repeat for multiple files; bare paths use field "file".', collectRepeated, []).option("--example <name>", "Run one persisted example by name").option("--dir <dir>", "Local eigenpal directory for workflow examples", undefined).option("--fail-on-mismatch", "For --example runs, exit non-zero when a graded example fails (evaluator fail, or output mismatch)").option("--wait", "Poll until the run reaches a terminal status").option("--interval <seconds>", "Polling interval in seconds", intArg, 2).option("--max-wait <seconds>", "Maximum wait before exit code 2", intArg, 1800).action(action(runTarget)).addHelpText("after", `
+  addJsonFlag(withBaseUrl(program.command("run <target>"))).description("Start a workflow or agent run, e.g. workflows.extract-invoice.").option("--tag <tag>", "Execution tag. Repeat for multiple tags.", collectRepeated, []).option("--input-json <json>", "JSON input object").option("--input-file <field=path>", 'Input file to upload. Files exceeding EIGENPAL_MULTIPART_MAX_BYTES (default 4.5 MiB; "none" disables) are pre-uploaded; smaller files stay on multipart. Repeat for multiple files; bare paths use field "file".', collectRepeated, []).option("--example <name>", "Run one persisted example by name").option("--dir <dir>", "Local eigenpal directory for workflow examples", undefined).option("--fail-on-mismatch", "For --example runs, exit non-zero when a graded example fails (evaluator fail, or output mismatch)").option("--wait", "Poll until the run reaches a terminal status").option("--interval <seconds>", "Polling interval in seconds", intArg, 2).option("--max-wait <seconds>", "Maximum wait before exit code 2", intArg, 1800).action(action(runTarget)).addHelpText("after", `
 Grading --example runs
   --example runs the SERVER's stored dataset example for the target — workflows
   (workflows.<slug>) and agents (agents.<slug>) alike — so push your latest
@@ -244707,7 +244725,10 @@ Exit codes
 }
 async function runTarget(target, opts) {
   const parsed = parseRunTarget(target);
+  const tags = opts.tag?.length ? ExecutionTagsSchema.parse(opts.tag) : undefined;
   if (opts.example) {
+    if (tags)
+      throw new Error("--tag is supported for ad-hoc runs; example runs do not accept tags");
     if (opts.inputJson || opts.inputFile && opts.inputFile.length > 0) {
       throw new Error("--example cannot be combined with --input-json or --input-file");
     }
@@ -244732,16 +244753,20 @@ async function runTarget(target, opts) {
     const prepared = await buildPreparedRunRequest(client, {
       target: pathTarget,
       inputFile: opts.inputFile,
-      inputJson: opts.inputJson
+      inputJson: opts.inputJson,
+      tags
     });
     if (prepared.hasMultipartFiles) {
       payload = await client.postFormData(runPath, prepared.form);
     } else {
       const input = JSON.parse(String(prepared.form.get("input") ?? "{}"));
-      payload = await client.post(runPath, runStartJsonBody(target, input));
+      payload = await client.post(runPath, { ...runStartJsonBody(target, input), tags });
     }
   } else {
-    payload = await client.post(runPath, runStartJsonBody(target, opts.inputJson ? JSON.parse(opts.inputJson) : {}));
+    payload = await client.post(runPath, {
+      ...runStartJsonBody(target, opts.inputJson ? JSON.parse(opts.inputJson) : {}),
+      tags
+    });
   }
   const runId = String(payload.id ?? "");
   let waitedForTerminalRun = false;