@stripe/link-cli 0.4.0 → 0.4.1

package/README.md

@@ -84,6 +84,14 @@ link-cli spend-request retrieve lsrq_001 --format json
 ```
 By default, retrieving a spend request will not include card details. Use the `--include=card` to see unmasked card details.
 
+For agent polling, pass `--interval` and optionally `--max-attempts`:
+
+```bash
+link-cli spend-request retrieve lsrq_001 --interval 2 --max-attempts 150 --format json
+```
+
+Polling exits successfully only after the request reaches a terminal status such as `approved`, `denied`, or `expired`. If polling reaches `--timeout` or exhausts `--max-attempts` while the request is still non-terminal, the command exits non-zero with `code: "POLLING_TIMEOUT"` so callers do not treat a still-pending request as complete.
+
 If the merchant supports MPP, use `link-cli mpp pay` instead:
 
 ```bash

package/dist/cli.js

@@ -14207,11 +14207,15 @@ var createOptions = z6.object({
   )
 });
 var retrieveOptions = z6.object({
-  timeout: z6.coerce.number().default(300).describe("Polling timeout in seconds"),
+  timeout: z6.coerce.number().default(300).describe(
+    "Polling timeout in seconds. When reached during active polling, exits non-zero with POLLING_TIMEOUT."
+  ),
   interval: z6.coerce.number().default(0).describe(
-    "Poll interval in seconds. When > 0, polls until status is terminal or timeout is reached, yielding status on each attempt."
+    "Poll interval in seconds. When > 0, polls until status is terminal, timeout is reached, or max attempts are exhausted."
+  ),
+  maxAttempts: z6.coerce.number().default(0).describe(
+    "Max poll attempts. 0 = unlimited. Exhaustion during active polling exits non-zero with POLLING_TIMEOUT."
   ),
-  maxAttempts: z6.coerce.number().default(0).describe("Max poll attempts. 0 = unlimited (use timeout instead)."),
   include: z6.array(z6.string()).default([]).describe("Include extra data (repeatable, e.g. --include card)")
 });
 var updateOptions = z6.object({
@@ -14600,11 +14604,20 @@ function createSpendRequestCli(repository) {
           return;
         }
         attempts++;
-        const shouldStop = interval <= 0 || maxAttempts > 0 && attempts >= maxAttempts || Date.now() >= deadline;
-        if (shouldStop) {
+        if (interval <= 0) {
           yield request;
           return;
         }
+        const maxAttemptsExhausted = maxAttempts > 0 && attempts >= maxAttempts;
+        const timeoutReached = Date.now() >= deadline;
+        if (maxAttemptsExhausted || timeoutReached) {
+          const reason = maxAttemptsExhausted ? `max attempts (${maxAttempts}) exhausted` : `timeout (${timeout}s) reached`;
+          return c.error({
+            code: "POLLING_TIMEOUT",
+            message: `Polling stopped before spend request ${id} reached a terminal status: ${reason}; current status is ${request.status}.`,
+            retryable: true
+          });
+        }
         const snapshot = JSON.stringify(request);
         if (snapshot !== previousAttemptData) {
           previousAttemptData = snapshot;
@@ -14917,7 +14930,7 @@ var ResourceFactory = class {
 };
 
 // src/cli.tsx
-var cliVersion = "0.4.0";
+var cliVersion = "0.4.1";
 var buildNumber = "1";
 var cliName = "@stripe/link-cli";
 var defaultHeaders = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/link-cli",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "bin": {
     "link-cli": "./dist/cli.js"