@automatalabs/workflows 0.52.1 → 0.53.0

package/README.md

@@ -654,31 +654,32 @@ expressions), then a **dry run** — the script executes in the real engine real
 `agent()` call is served by an in-process mock `AgentRunner` that fabricates schema-conforming
 results. The dry run catches what a parse can't: thunk-vs-promise mistakes, reference errors,
 broken plumbing between calls. Finally, validation opens one no-prompt session for every distinct
-routed `{ backend, model }` pair, selects that call's model verbatim when one was authored, surfaces
-the echoed model-specific config-option catalog, and checks every authored `configOptions` bag
-against it. This probe uses zero tokens. A pair that cannot spawn, authenticate, select its model,
-or open a session contributes one warning and `probed:false`; only that pair's option checks are
-skipped, so probe failure alone never invalidates the script. There is no cached catalog or opt-out
-flag.
+routed backend/model target, selects that call's model verbatim when one was authored, surfaces
+the echoed model-specific ACP modes and config-option catalog, and checks every authored `mode`
+and `configOptions` bag against it. Only exact ids in `modes.availableModes` pass; `modes:null`
+means omit `mode`, never infer `"default"`. This probe uses zero tokens. A target that cannot spawn,
+authenticate, select its model, or open a session contributes one warning and `probed:false`; only
+that target's configuration checks are skipped, so probe failure alone never invalidates the script.
+There is no cached catalog or opt-out flag.
 A mock live confirm answers checkpoints with `default ?? true`, so `headless: "pause"`
 dry-runs cleanly; `headless: "abort"` warns because a truly unattended run would abort.
 Script-declared `meta.backends` are treated as approved (with a warning that real runs require
-approval). The report lists every agent call with its backend attribution and `configOptions`
-echo, every checkpoint, the full option table for every routed backend/model pair (even when no call authors
-options), and warnings. Unknown ids, invalid select values, non-boolean boolean values, and the
-reserved `"model"` id make the report invalid with exit code `2`; each diagnostic names the call,
+approval). The report lists every agent call with its backend attribution, `mode`, and `configOptions`
+echo, every checkpoint, the full mode/option table for every routed backend/model target (even when no call authors
+options), and warnings. An unadvertised mode, unknown config id, invalid select value, non-boolean
+boolean value, or reserved `"model"` id makes the report invalid with exit code `2`; each diagnostic names the call,
 authored value, and advertised alternatives. For select options carrying
 `_meta["@automatalabs/agentprism"].recognizedValues`, a supported value passes, an unsupported but
 recognized value passes with a warning naming the effective clamp target, and an unrecognized value
 is invalid. Pi's `thinkingLevel` option publishes this metadata from Pi's own ordered domain and
 therefore needs no extra probes. For an ordered built-in that omits the metadata (Claude or Codex),
 validation reads its advertised model picker, probes each selectable model through the same
-per-`{ backend, model }` cache, merges consistent per-model thought-level orders, and applies the
+per-target probe cache, merges consistent per-model thought-level orders, and applies the
 same recognized-value/clamp path. Claude models that omit `effort` do not inherit another model's
 option, and its `default` sentinel is recognized but excluded from ceiling ordering. Enumeration is
 skipped, with a warning, when a picker advertises more than 32 models or the orders cannot be merged.
 OpenCode and custom/unknown backends are exact-set: an unadvertised thought-level value is invalid
-instead of clamping. Exit codes are `0` valid, `1` parse failure, `2` dry-run or config-option failure,
+instead of clamping. Exit codes are `0` valid, `1` parse failure, `2` dry-run or agent-configuration failure,
 `3` usage error.
 
 Flags: `--args <json>` / `--args-file <path>`, `--workflows-dir <dir>` (repeatable — validate by
@@ -732,7 +733,7 @@ const report = await validateWorkflowScript(script, { args: { target: "src/" },
 report.ok;                 // parse ok AND dry run completed
 report.dryRun?.agentCalls; // calls include mockAnswer: { glob, sequenceIndex?, sequenceLength? }
 report.dryRun?.harnessOptions;
-// [{ backendId, model?, probed, options?: SessionConfigOption[], error?: string }]
+// [{ backendId, model?, probed, modes?: SessionModeState | null, options?: SessionConfigOption[], error?: string }]
 report.dryRun?.mockAnswers;// normalized rule counters + item-level unused records
 report.warnings;           // approval reminders, phase mismatches, headless-abort checkpoints, …
 ```
@@ -754,8 +755,10 @@ npx @automatalabs/workflows config claude --json    # machine-readable report
 Harness names are the routing names: built-in `claude` / `codex` / `opencode` / `pi` plus any custom
 backend registered via `AGENTPRISM_BACKENDS` (registered customs also join the no-argument
 default set). Each harness opens one session without a prompt — zero tokens — and reports its
-advertised config-option catalog: model ids (including bracket variants), effort
-levels, modes, boolean knobs. A harness that cannot spawn or authenticate reports
+advertised ACP modes plus its config-option catalog: model ids (including bracket variants), effort
+levels, and boolean knobs. A non-null `modes` object contains `currentModeId` and `availableModes`;
+only exact listed ids may be authored. `modes: null` means omit `mode`, never infer `"default"`.
+A harness that cannot spawn or authenticate reports
 `probed: false` with the reason and never blocks the others. Flags: `--cwd <dir>` (probe
 session cwd; default the current directory), `--timeout-ms <n>` (per-harness bound, default
 60000), `--models[=<filter>]`, `--json`. Exit codes: `0` all probed, `1` at least one probe
@@ -776,7 +779,7 @@ import { probeHarnessConfig, formatHarnessConfigReport } from "@automatalabs/wor
 const report = await probeHarnessConfig({ harnesses: ["codex"] });
 const exact = await probeHarnessConfig({ modelSpecs: ["codex/gpt-5.6-sol"] }); // selects it first
 report.ok;             // every requested harness probed
-report.harnessOptions; // [{ backendId, model?, probed, options?: SessionConfigOption[], error?: string }]
+report.harnessOptions; // [{ backendId, model?, probed, modes?: SessionModeState | null, options?: SessionConfigOption[], error?: string }]
 formatHarnessConfigReport(report); // the CLI's human table
 ```
 

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAM7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAG/E,MAAM,WAAW,yBAAyB;IACxC;;4EAEwE;IACxE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;wDACoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC/C;yEACqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;+CAC2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,EAAE,EAAE,OAAO,CAAC;IACZ,qDAAqD;IACrD,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,2FAA2F;IAC3F,cAAc,EAAE,sBAAsB,EAAE,CAAC;CAC1C;AAID;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,mBAAmB,CAAC,CA4D9B;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAU7E;AAED;;2FAE2F;AAC3F,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,cAAc,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC7B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAYD;;yFAEyF;AACzF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAY3E;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,CAAC,EAAE,MAAM,GACd,iBAAiB,EAAE,CAmBrB;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,CA2B/E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAM7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAG/E,MAAM,WAAW,yBAAyB;IACxC;;4EAEwE;IACxE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;wDACoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC/C;yEACqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;+CAC2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,EAAE,EAAE,OAAO,CAAC;IACZ,qDAAqD;IACrD,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,2FAA2F;IAC3F,cAAc,EAAE,sBAAsB,EAAE,CAAC;CAC1C;AAID;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,mBAAmB,CAAC,CA6D9B;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAU7E;AAED;;2FAE2F;AAC3F,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,cAAc,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC7B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAYD;;yFAEyF;AACzF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAY3E;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,CAAC,EAAE,MAAM,GACd,iBAAiB,EAAE,CAmBrB;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,CA2B/E"}

package/dist/config.js

@@ -2,8 +2,9 @@
 // (see ./cli.ts), validate's sibling. Where validate probes only the harnesses a script
 // routes to, this probes any requested (or every routable) harness WITHOUT a script:
 // one no-prompt ACP session per harness, returning the agent-advertised session
-// config-option catalog verbatim — model ids (including bracket variants), effort
-// levels, modes, and every other negotiable option. Zero tokens. Authoring flows run
+// config-option catalog plus the effective ACP session-mode catalog — model ids
+// (including bracket variants), effort levels, modes, and every other negotiable option.
+// Zero tokens. Authoring flows run
 // this FIRST so `model` / `configOptions` values come from the live catalog, not memory.
 import { redactText } from "@automatalabs/workflow-engine";
 import { BUILTIN_BACKEND_IDS, resolveBackendRegistry, } from "@automatalabs/acp-agents";
@@ -46,6 +47,7 @@ export async function probeHarnessConfig(options = {}) {
                     backendId: result.backendId,
                     ...(target.selectModel ? { model: target.spec } : {}),
                     probed: true,
+                    modes: result.modes ?? null,
                     options: result.options,
                 });
             }
@@ -74,7 +76,7 @@ export async function probeHarnessConfig(options = {}) {
 }
 /** Render a HarnessConfigReport as the human-readable CLI output (validate's table format). */
 export function formatHarnessConfigReport(report) {
-    const lines = ["advertised config options:"];
+    const lines = ["advertised modes and config options:"];
     if (report.harnessOptions.length === 0) {
         lines.push("  (no harnesses requested)");
     }