lua-cli 3.32.2 → 3.32.3

package/dist/workflow-builder.d.ts

@@ -365,13 +365,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 */