lua-cli 3.32.4 → 3.32.6

package/dist/api-exports.d.ts

@@ -582,6 +582,13 @@ declare interface ApiResponse<T = any> {
         stepId?: string;
         /** the live step status on 409 NOT_SUSPENDED (LUA-644) */
         status?: string;
+        /** LUA-810 — 503 UPSTREAM_UNAVAILABLE: the internal Lua service behind the API that answered a fault or did
+         *  not answer (`lua-agents`, `lua-core`, …), and the id on the server's matching error log line. */
+        upstream?: string;
+        requestId?: string;
+        /** LUA-812 — 503 VENDOR_UNAVAILABLE: the third-party vendor behind the API that failed (`unified` | `github` |
+         *  `pusher` | `google`); `retryAfterSeconds` above is present only when a blind retry is safe. */
+        vendor?: string;
     };
 }
 
@@ -599,6 +606,11 @@ export declare interface ApprovalOptions {
     /** default 'continue' (denial is data unless 'fail') */
     onDeny?: WorkflowApprovalOnDeny;
     businessHours?: WorkflowBusinessHours;
+    /**
+     * Optional — inferred `true` from a non-empty `editablePaths` (LUA-808 / LUA-825: the validator's `approvalEditable`
+     * rule, applied by the builder too); an explicit `false` beside paths is refused as contradictory. Absent with no
+     * paths ⇒ `false` (the approver decides, never edits).
+     */
     editable?: boolean;
     /** grammar: `drafts`, `drafts[*]`, `drafts[*].body`, `drafts[3].body`, `summary.title` */
     editablePaths?: string[];
@@ -2229,6 +2241,15 @@ declare abstract class HttpClient {
      * @private
      */
     private calculateBackoff;
+    /**
+     * The wait before the next attempt: the client's jittered exponential backoff, floored by the server's
+     * `retryAfterSeconds` on a 429 (the limiter's word is final) and on an idempotent read (GET / HEAD). LUA-810: a
+     * POST / PUT / PATCH / DELETE that met a 5xx keeps the client's own backoff — every 503 body carries
+     * `retryAfterSeconds: 5` (`CONTROL_UNAVAILABLE`, `UPSTREAM_UNAVAILABLE`), which floored all three waits at 5 s:
+     * a ≥15 s stall on a write that may already have landed, and retrying an ambiguous write harder does not make
+     * it less ambiguous. The client's own schedule is ≤1 s + ≤2 s + ≤4 s.
+     */
+    private retryDelayMs;
     /**
      * Wraps request with retry logic for transient failures
      * @param url - The full URL to request
@@ -7314,11 +7335,21 @@ declare interface WorkflowRun {
     parentRunId?: string;
     correlationKey?: string;
     tags?: string[];
+    /** R4 `gate` (02 §2.4). LUA-788: a `kind:'billing'` gate names the wallet's refusal (`code`), the held step and its expiry. */
     gate?: {
         kind: string;
         reason?: string;
-        since?: string;
+        since?: string | number;
+        code?: string;
+        stepId?: string;
+        expiresAt?: number;
     };
+    /**
+     * Server-decided (09 §9.6): `raise_budget` on a budget gate (LUA-665), `top_up` on a billing gate (LUA-788 — the
+     * wallet clears it; the engine re-checks and resumes on its own), `cancel_again` / `force` under a pending cancel,
+     * else `none`. Absent on an older server.
+     */
+    nextAction?: 'cancel_again' | 'force' | 'none' | 'raise_budget' | 'top_up';
     /**
      * The pending / audited cancel request (`runCancelView`): who asked and when; `wall` when it was the run wall's
      * own (LUA-686); LUA-704: `forcedBy` / `forcedAt` / `forceReason` on a forced terminal (`abandoned`, or