lua-cli 3.32.2 → 3.32.4

package/dist/workflow-builder.d.ts

@@ -103,9 +103,11 @@ declare interface BuiltWorkflow {
 /**
  * A container arm: a `StepRef` — a `createStep` object, or a string naming an entry declared elsewhere in the chain
  * (`agentStep` / `specialistStep` / `toolStep` / `workflow`, and since LUA-684 `approval` / `waitForSignal`, so an
- * approval can run concurrently with another row) — or (B14 — lands with WF-509) the two-element chain
- * `[mapConfig, stepRef]`. A HITL arm takes the previous output as its payload, so it never heads a `[map, step]`
- * chain, and a `loop` body cannot be one until the engine proves it (`node-type-unsupported-in-container`).
+ * approval can run concurrently with another row) — or the two-element pair `[mapConfig, stepRef]`: the step runs
+ * with the map as its own `input` (LUA-780 — a `parallel` arm only; a `foreach` / `loop` body receives its item /
+ * the previous output and refuses the pair, `mapping-placement`, unless the target is a `.workflow()` node, whose
+ * `input` is the child run's). A HITL arm takes the previous output as its payload, so it never heads a
+ * `[map, step]` pair, and a `loop` body cannot be one until the engine proves it (`node-type-unsupported-in-container`).
  */
 export declare type ContainerArm = StepRef | [LuaMapConfig, StepRef];
 
@@ -365,13 +367,17 @@ export declare interface LuaWorkflowConfig {
      * `maxDurationSeconds` default 604 800; 2 592 000 when the graph contains an approval / waitForSignal / suspend-capable
      * step (P1-4). The three members the SDK forwards, spelled by the ONE definition budget (`WorkflowDefinitionBudget`).
      *
-     * `maxCredits` counts agent steps, never tokens (LUA-708): an inline agent step settles a flat 1 credit when it
-     * completes, a `tier:'job'` attempt a flat 4 at its first claim (a retry is a new attempt). The run parks on a
-     * budget gate (`nextAction:'raise_budget'`, `lua workflows raise-budget`) when what remains is under the next agent
-     * step's reserve — so `maxCredits: 40` buys ten Job-tier attempts, and a value under 4 never dispatches one. Each
-     * attempt then runs to its own wall (`timeoutSeconds`), `maxInputTokens` (default 4M ≈ $1–13 on a Sonnet-class
-     * model), `maxMessages` and `maxTurns`; nothing meters its tokens against the credits mid-attempt. Size
-     * `maxInputTokens` for what one attempt may cost and `maxCredits` for how many attempts the run may make.
+     * `maxCredits` never meters tokens (LUA-708). Flat metering (every run while `LUA_WORKFLOWS_METERING_V2` is off):
+     * an inline agent step settles a flat 1 credit when it completes, a `tier:'job'` attempt a flat 4 at its first
+     * claim (a retry is a new attempt) — so `maxCredits: 40` buys ten Job-tier attempts, and a value under 4 never
+     * dispatches one. Priced metering (LUA-724, the flag on): an inline agent step settles what chat charged for the
+     * turn — one credit per model call on the legacy plan, `tier × model multiplier` actions on a seat plan (then the
+     * cap is compared in actions) — and `lua workflows status` says which mode a run used (`usage.metering`). Either
+     * way the run parks on a budget gate (`nextAction:'raise_budget'`, `lua workflows raise-budget`) when what remains
+     * is under the next agent step's reserve. Each Job-tier attempt then runs to its own wall (`timeoutSeconds`),
+     * `maxInputTokens` (default 4M ≈ $1–13 on a Sonnet-class model), `maxMessages` and `maxTurns`; nothing meters its
+     * tokens against the credits mid-attempt. Size `maxInputTokens` for what one attempt may cost and `maxCredits`
+     * for how many attempts the run may make.
      */
     budget?: Pick<WorkflowDefinitionBudget, 'maxCredits' | 'maxSteps' | 'maxDurationSeconds'>;
     /** verbatim LuaJob union (D12) → Job{kind:'workflow'} on publish */