@thirdfy/agent-cli 0.2.13 → 0.2.15

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.15] - 2026-06-26
+
+### Added
+
+- Hummingbot API provider: `hummingbot` command group (`status`, `connectors`, `executor-schema`, `executor-create`) and provider runbook [`docs/providers/hummingbot.md`](./docs/providers/hummingbot.md). Pairs with Thirdfy API **v3.6.0+** (governed `/api/v1/agent/hummingbot/*` proxy) and `thirdfy-mcp` **v0.0.64+**.
+
+## [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.15
 
-- 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.
+- `hummingbot` command group for governed Condor CEX executor ops: `status`, `connectors`, `executor-schema`, `executor-create`. Provider runbook at [`docs/providers/hummingbot.md`](./docs/providers/hummingbot.md). Pairs with Thirdfy API **v3.6.0+** and `thirdfy-mcp` **v0.0.64+**.
 
 Older versions: see [CHANGELOG.md](./CHANGELOG.md) and [GitHub Releases](https://github.com/thirdfy/agent-cli/releases).
 
@@ -309,6 +304,7 @@ Provider and venue guides are kept outside `README` so this page stays stable as
 - Discovery: `catalogs list`, `actions` (optional `--provider`, `--chain-id`; see [`docs/command-reference.md`](./docs/command-reference.md) for trading vs earn vs prediction providers and case-insensitive matching)
 - Execution: `preflight`, `run`, `intent-status`, `jeff preflight`, `jeff trade`, `jeff status`
 - Polymarket: `polymarket status`, `polymarket setup`, `polymarket dry-run`
+- Hummingbot: `hummingbot status`, `hummingbot connectors`, `hummingbot executor-schema`, `hummingbot executor-create`
 - Managed signer execution: `wallet execute`, `wallet sign`, `wallet submit`, `agent run`
 - Profiles: `profile init`, `profile use`, `profile show`, `whoami`
 - Onboarding: `login email`, `help onboarding`, `doctor auth`, `wallet list`, `bootstrap begin`, `bootstrap complete`, `onboarding begin`, `onboarding complete`, `agent auth challenge`, `agent auth verify`, `agent register`, `agent key rotate`, `agent key revoke`, `developer bootstrap`

package/package.json

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

package/src/cli/help.mjs

@@ -38,6 +38,10 @@ Core commands:
   thirdfy-agent polymarket status [--agent-key <key>] [--amount-pusd <n>] [--json]
   thirdfy-agent polymarket setup [--agent-key <key>] [--params <json>] [--json]
   thirdfy-agent polymarket dry-run --params <json> [--action place_polymarket_order] [--json]
+  thirdfy-agent hummingbot status [--org-id <id>] [--runtime-id <id>] [--agent-api-key <key>] [--json]
+  thirdfy-agent hummingbot connectors [--org-id <id>] [--json]
+  thirdfy-agent hummingbot executor-schema [--org-id <id>] [--executor-type position_executor] [--json]
+  thirdfy-agent hummingbot executor-create --agent-api-key <key> --user-did <did> [--org-id <id>] [--connector <name>] [--pair <pair>] [--params <json>] [--json]
   thirdfy-agent wallet sign --agent-api-key <key> --action <id> --params <json> [--chain-id <id>] [--json]
   thirdfy-agent wallet submit --signed-tx-hex <hex> [--chain-id <id>] [--rpc-url <url>] [--json]
   thirdfy-agent agent run --agent-api-key <key> --action <id> --params <json> [--signer-method managed_wallet_server|byow|fanout_intent] [--strategy-intent single_wallet|fanout] [--run-mode <mode>] [--user-did <did>] [--json]

package/src/cli/manifest.mjs

@@ -92,6 +92,31 @@ export const CLI_MANIFEST = [
     options: ['auth', 'execution', 'polymarket'],
     description: 'Polymarket dry-run preflight',
   },
+  {
+    path: ['hummingbot', 'status'],
+    handler: 'commandHummingbotStatus',
+    options: ['auth', 'hummingbot'],
+    description: 'Hummingbot instance health summary for an org',
+  },
+  {
+    path: ['hummingbot', 'connectors'],
+    handler: 'commandHummingbotConnectors',
+    options: ['auth', 'hummingbot'],
+    description: 'List Hummingbot connectors for an org HB instance',
+  },
+  {
+    path: ['hummingbot', 'executor-schema'],
+    handler: 'commandHummingbotExecutorSchema',
+    options: ['auth', 'hummingbot'],
+    description: 'Fetch Hummingbot executor config schema',
+  },
+  {
+    path: ['hummingbot', 'executor-create'],
+    handler: 'commandHummingbotExecutorCreate',
+    tier: 'online',
+    options: ['auth', 'execution', 'hummingbot'],
+    description: 'Governed Hummingbot executor create via Thirdfy proxy',
+  },
   // online
   {
     path: ['agent', 'run'],

package/src/cli/options/hummingbot.mjs

@@ -0,0 +1,8 @@
+export function attachHummingbotOptions(cmd) {
+  return cmd
+    .option('--org-id <id>', 'Hummingbot org id (default: HUMMINGBOT_ORG_ID or default)')
+    .option('--runtime-id <id>', 'EarnClaw runtime id for health summary scoping')
+    .option('--executor-type <type>', 'Hummingbot executor type')
+    .option('--connector <name>', 'Hummingbot connector name')
+    .option('--pair <pair>', 'Hummingbot trading pair');
+}

package/src/cli/options/index.mjs

@@ -8,6 +8,7 @@ import { attachBootstrapOptions } from './bootstrap.mjs';
 import { attachCredentialsOptions } from './credentials.mjs';
 import { attachAnalyticsOptions } from './analytics.mjs';
 import { attachPolymarketOptions } from './polymarket.mjs';
+import { attachHummingbotOptions } from './hummingbot.mjs';
 import { attachAgentRegisterOptions } from './agent.mjs';
 import { attachChainOptions } from './chains.mjs';
 
@@ -21,6 +22,7 @@ const BUNDLES = {
   credentials: attachCredentialsOptions,
   analytics: attachAnalyticsOptions,
   polymarket: attachPolymarketOptions,
+  hummingbot: attachHummingbotOptions,
   agent: attachAgentRegisterOptions,
   chains: attachChainOptions,
 };

package/src/commands/hummingbot.mjs

@@ -0,0 +1,79 @@
+import { apiGet, apiPost } from '../core/http.mjs';
+import { parseJsonFlag } from '../core/args.mjs';
+import { resolveConfigAgentKey } from './polymarket.mjs';
+
+function orgIdFromFlags(flags) {
+  return String(flags.orgId || flags.org_id || process.env.HUMMINGBOT_ORG_ID || 'default').trim();
+}
+
+function agentApiKeyFromFlags(flags, ctx) {
+  return String(flags.agentApiKey || flags.agent_api_key || ctx?.agentApiKey || '').trim();
+}
+
+export function createHummingbotCommands({ printEnvelope }) {
+  async function commandHummingbotStatus(ctx, flags) {
+    const orgId = orgIdFromFlags(flags);
+    const agentApiKey = agentApiKeyFromFlags(flags, ctx);
+    const query = new URLSearchParams({ orgId });
+    if (flags.runtimeId) query.set('runtimeId', String(flags.runtimeId));
+    const headers = agentApiKey ? { 'x-agent-api-key': agentApiKey } : {};
+    const data = await apiGet(ctx, `/api/v1/agent/hummingbot/health/summary?${query.toString()}`, headers);
+    printEnvelope({ success: true, data, meta: { apiBase: ctx.apiBase, orgId } });
+  }
+
+  async function commandHummingbotConnectors(ctx, flags) {
+    const orgId = orgIdFromFlags(flags);
+    const data = await apiGet(ctx, `/api/v1/agent/hummingbot/connectors?orgId=${encodeURIComponent(orgId)}`);
+    printEnvelope({ success: true, data, meta: { apiBase: ctx.apiBase, orgId } });
+  }
+
+  async function commandHummingbotExecutorSchema(ctx, flags) {
+    const orgId = orgIdFromFlags(flags);
+    const executorType = String(flags.executorType || flags.executor_type || 'position_executor');
+    const data = await apiGet(
+      ctx,
+      `/api/v1/agent/hummingbot/executors/types/${encodeURIComponent(executorType)}/config?orgId=${encodeURIComponent(orgId)}`
+    );
+    printEnvelope({ success: true, data, meta: { apiBase: ctx.apiBase, orgId, executorType } });
+  }
+
+  async function commandHummingbotExecutorCreate(ctx, flags) {
+    const orgId = orgIdFromFlags(flags);
+    const agentApiKey = agentApiKeyFromFlags(flags, ctx);
+    const userDid = String(flags.userDid || flags.user_did || '').trim();
+    const params = parseJsonFlag(flags, 'params') || {};
+    if (!agentApiKey || !userDid) {
+      printEnvelope({
+        success: false,
+        code: 'MISSING_AUTH',
+        message: 'Provide --agent-api-key and --user-did for governed executor create',
+        data: {},
+      });
+      process.exit(1);
+    }
+    const body = {
+      ...params,
+      orgId,
+      userDid,
+      connector_name: flags.connector || params.connector_name,
+      trading_pair: flags.pair || params.trading_pair,
+      estimatedAmountUsd: Number(flags.estimatedAmountUsd || params.estimatedAmountUsd || 0),
+      type: flags.executorType || flags.executor_type || params.type || 'position_executor',
+    };
+    const data = await apiPost(
+      ctx,
+      '/api/v1/agent/hummingbot/executors',
+      body,
+      { 'x-agent-api-key': agentApiKey }
+    );
+    printEnvelope({ success: true, data, meta: { apiBase: ctx.apiBase, orgId } });
+  }
+
+  return {
+    commandHummingbotStatus,
+    commandHummingbotConnectors,
+    commandHummingbotExecutorSchema,
+    commandHummingbotExecutorCreate,
+    resolveHummingbotAgentKey: resolveConfigAgentKey,
+  };
+}

package/src/commands/index.mjs

@@ -1,6 +1,7 @@
 export { createPolymarketCommands, resolveConfigAgentKey } from './polymarket.mjs';
 export { createHyperliquidHelpers } from './hyperliquid.mjs';
 export { createLighterHelpers } from './lighter.mjs';
+export { createHummingbotCommands } from './hummingbot.mjs';
 export { createExecuteCommands } from './execute.mjs';
 export { createWalletCommands } from './wallet.mjs';
 export { createDelegationCommands } from './delegation.mjs';

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;

package/src/runtime/handlers.mjs

@@ -1,5 +1,6 @@
 import { negotiateCapabilities } from '../core/http.mjs';
 import { createPolymarketCommands } from '../commands/polymarket.mjs';
+import { createHummingbotCommands } from '../commands/hummingbot.mjs';
 import { createHyperliquidHelpers } from '../commands/hyperliquid.mjs';
 import { createLighterHelpers } from '../commands/lighter.mjs';
 import { createExecuteCommands } from '../commands/execute.mjs';
@@ -142,6 +143,10 @@ export function createRuntimeHandlers(deps) {
     printEnvelope,
   });
 
+  const __hummingbot = createHummingbotCommands({
+    printEnvelope,
+  });
+
   const __bootstrap = createBootstrapCommands({
     printEnvelope,
     extractAgentApiKey,
@@ -160,6 +165,7 @@ export function createRuntimeHandlers(deps) {
     ...__wallet,
     ...__delegation,
     ...__polymarket,
+    ...__hummingbot,
     ...__bootstrap,
     ...__discovery,
     ...__telemetry,