@thirdfy/agent-cli 0.2.13 → 0.2.14

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.14] - 2026-06-24
+
+### Changed
+
+- HTTP client (`src/core/http.mjs`) retries once on **502/503/504** and timeout/abort errors with short jittered backoff. Pairs with Thirdfy API **v3.5.6+** Supabase REST resilience (`UPSTREAM_DB_UNAVAILABLE`).
+
 ## [0.2.13] - 2026-06-23
 
 ### Changed

package/README.md

@@ -40,14 +40,9 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.13
+## What's new in v0.2.14
 
-- Lighter provider hints prioritize Base-first `complete_lighter_onboarding` and catalog-aligned action names for CCTP funding, API-key setup, and integrator approval. Pairs with Thirdfy API **v3.5.3+** and `thirdfy-mcp` **v0.0.62+**.
-
-## What's new in v0.2.12
-
-- Lighter perps provider support: funding discovery, `complete_lighter_onboarding`, market/account reads, API-key setup, and signed perps order management via the `lighter` command group. Pairs with Thirdfy API **v3.5.2+**.
-- Provider parity validation and command reference updated for `provider=lighter` actions.
+- HTTP client retries once on Thirdfy API **502/503/504** and client timeouts (bounded `AbortController`), so PostgREST outages surface as transient failures instead of hanging Hermes read cycles. Pairs with Thirdfy API **v3.5.6+**.
 
 Older versions: see [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thirdfy/agent-cli",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {

package/src/core/http.mjs

@@ -4,6 +4,25 @@ import {
   resolveExecutionContextFromInput,
 } from './executionContext.mjs';
 
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function isRetryableApiStatus(statusCode) {
+  return statusCode === 502 || statusCode === 503 || statusCode === 504;
+}
+
+function isRetryableApiError(error) {
+  const statusCode = Number(error?.statusCode || 0);
+  const message = String(error?.message || '').toLowerCase();
+  return (
+    isRetryableApiStatus(statusCode) ||
+    error?.name === 'AbortError' ||
+    message.includes('abort') ||
+    message.includes('timeout')
+  );
+}
+
 export async function apiGet(ctx, route, headers = {}) {
   return requestJson(ctx, route, { method: 'GET', headers: mergeExecutionContextHeaders(headers) });
 }
@@ -28,7 +47,7 @@ export async function apiPost(ctx, route, body, headers = {}) {
   });
 }
 
-export async function requestJson(ctx, route, init) {
+async function requestJsonOnce(ctx, route, init) {
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), ctx.timeoutMs);
   try {
@@ -50,6 +69,23 @@ export async function requestJson(ctx, route, init) {
   }
 }
 
+export async function requestJson(ctx, route, init) {
+  let lastError = null;
+  for (let attempt = 0; attempt < 2; attempt += 1) {
+    try {
+      return await requestJsonOnce(ctx, route, init);
+    } catch (error) {
+      lastError = error;
+      if (attempt === 0 && isRetryableApiError(error)) {
+        await sleep(250 + Math.floor(Math.random() * 250));
+        continue;
+      }
+      throw error;
+    }
+  }
+  throw lastError || new Error('Request failed');
+}
+
 export async function requestWithRouteFallback(ctx, options) {
   const routes = Array.isArray(options.routes) ? options.routes : [];
   let lastError = null;