@thirdfy/agent-cli 0.2.56 → 0.2.58

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.58] - 2026-09-05
+
+### Fixed
+
+- `basedbid_buy` managed-wallet preflight no longer treats listing `tokenAddress` as an ERC-20 `tokenIn`. Buy spends native ETH, so a zero listing-token balance no longer blocks a funded wallet. `basedbid_sell` and earn deposits still fund from `tokenAddress`. Pairs with `thirdfy-mcp` **0.0.106**.
+
+## [0.2.57] - 2026-09-04
+
+### Added
+
+- `basedbid` provider hints and `docs/providers/basedbid.md`. `basedbid_get_tokens` is in `READ_ONLY_EXACT`. LBP and flash create are writes on Base 8453, Ethereum 1, and Robinhood Chain 4663. Buy and sell are writes on Base. Board, fee claim, and hook writes stay fail-closed. Pairs with `thirdfy-mcp` **0.0.105**.
+
 ## [0.2.56] - 2026-09-03
 
 ### Added

package/README.md

@@ -40,18 +40,11 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.56
+## What's new in v0.2.58
 
-- `cmc` provider hints and [`docs/providers/cmc.md`](./docs/providers/cmc.md) for nineteen read-only `get_cmc_*` actions (quotes, metrics, fear/greed, composed Skill Hub briefs). Long-running skill actions use a 180s timeout.
-- Pairs with Thirdfy API **3.14.18** and `thirdfy-mcp` **0.0.104**.
-
-## What's new in v0.2.55
-
-- Nansen and GMGN provider notes no longer list per-action credit or USD prices. Thirdfy auth is enough.
-- See [`docs/providers/nansen.md`](./docs/providers/nansen.md) for discovery examples.
+- `basedbid_buy` managed-wallet preflight no longer treats listing `tokenAddress` as an ERC-20 funding token. Buy spends native ETH. Sell still funds from the listing token.
 - See [CHANGELOG.md](./CHANGELOG.md) and GitHub Releases for older versions.
 
-
 ## Quick start
 
 Hosted solo agents use profile `personal` and `--run-mode agent_wallet` (Path A). Fund the managed **execution wallet**, complete venue trading setup from the catalog when needed, then preflight and run. MetaMask Gator / `delegation *` is not required on this path.

package/package.json

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

package/src/core/fundingTokenIn.mjs

@@ -0,0 +1,22 @@
+import { normalizeActionKey } from './readOnlyActions.mjs';
+
+/**
+ * Native-ETH spends pass `tokenAddress` as the listing or output, not the funding ERC-20.
+ * Sending that address as execution-wallet `tokenIn` checks the wrong balance and blocks buys.
+ */
+const NATIVE_ETH_SPEND_ACTIONS = new Set([
+  'basedbid_buy',
+  'basedbid_create_lbp',
+  'basedbid_create_flash',
+  'basedbid_create_board',
+]);
+
+export function resolveTokenInForFunding(params, action) {
+  if (!params || typeof params !== 'object') return '';
+  const explicit = String(params.tokenIn || '').trim();
+  if (explicit) return explicit;
+  const actionId = normalizeActionKey(action);
+  if (NATIVE_ETH_SPEND_ACTIONS.has(actionId)) return '';
+  if (params.amountEth != null && String(params.amountEth).trim() !== '') return '';
+  return String(params.tokenAddress || params.token || '').trim();
+}

package/src/core/readOnlyActions.mjs

@@ -13,6 +13,7 @@ const READ_ONLY_EXACT = new Set([
   'dogeos_barkswap_get_quote',
   'dogeos_laika_read_contract',
   'dogeos_laika_token_state',
+  'basedbid_get_tokens',
   'prepare_polymarket_onboarding',
   'create_polymarket_bridge_deposit',
   'create_polymarket_bridge_withdraw',

package/src/runtime/execution/payloads.mjs

@@ -4,6 +4,7 @@ import { loadProfileConfig } from '../../core/context.mjs';
 import { createCliError } from '../../core/envelope.mjs';
 import { normalizeRunMode, normalizeManagedRunMode, normalizeHybridWalletMode } from '../../core/runMode.mjs';
 import { assertEarnclawPolymarketWriteIdempotency } from './earnclawRuntimeWriteGate.mjs';
+import { resolveTokenInForFunding } from '../../core/fundingTokenIn.mjs';
 export function createExecutionPayloads({ getPreparedParams, rawUnitsToDecimalString }) {
 function buildBuildTxPayload(flags, resolvedAction) {
   const runMode = String(flags.runMode || '').trim().toLowerCase() || 'self';
@@ -134,12 +135,6 @@ function buildManagedExecutePayload(flags, options) {
   return payload;
 }
 
-function resolveTokenInForFunding(params) {
-  if (!params || typeof params !== 'object') return '';
-  const tokenIn = String(params.tokenIn || params.tokenAddress || params.token || '').trim();
-  return tokenIn;
-}
-
 function buildIntentPayload(flags, options) {
   const runMode = String(options.runMode || flags.runMode || '').trim().toLowerCase() || 'thirdfy';
   const payload = {

package/src/runtime/execution/runners.mjs

@@ -650,7 +650,10 @@ async function resolveManagedExecutionPreflight(ctx, flags, resolved, options =
       signerMethod: 'managed_wallet_server',
     };
   }
-  const tokenIn = resolveTokenInForFunding(getPreparedParams(flags));
+  const tokenIn = resolveTokenInForFunding(
+    getPreparedParams(flags),
+    resolved?.resolvedAction || flags.action
+  );
   const query = new URLSearchParams({
     userDid,
     chainId: String(chainId),

package/src/runtime/providerHints.mjs

@@ -594,6 +594,29 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'thirdfy-agent run --action get_gmgn_kol_trades --params \'{"chain":"sol","limit":5}\' --provider gmgn --json',
       };
     }
+    if (provider === 'basedbid') {
+      return {
+        provider,
+        category: 'spot',
+        canonicalReadAction: 'basedbid_get_tokens',
+        canonicalWriteAction: 'basedbid_create_lbp',
+        readActions: ['basedbid_get_tokens'],
+        orderManagementActions: [
+          'basedbid_create_lbp',
+          'basedbid_create_flash',
+          'basedbid_create_board',
+          'basedbid_buy',
+          'basedbid_sell',
+          'basedbid_claim_fees',
+          'basedbid_update_hook',
+        ],
+        supportedChains: [8453, 1, 4663],
+        laneCompatibility:
+          'basedbid launchpad. Discovery is read-only. LBP and flash create are write-enabled on 8453, 1, and 4663. Buy and sell are write-enabled on 8453. Board, fee claim, and hook writes stay fail-closed. Console uses the existing preview-then-confirm path. No extra venue credential.',
+        example:
+          'thirdfy-agent run --action basedbid_get_tokens --params \'{"chainId":8453,"limit":10}\' --provider basedbid --json',
+      };
+    }
     if (provider === 'nansen') {
       return {
         provider,
@@ -686,6 +709,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       morpho: 'deposit_earn_position',
       aave: 'deposit_earn_position',
       aegis: 'deposit_aegis_lender',
+      basedbid: 'basedbid_create_lbp',
       curve: 'deposit_earn_position',
       uniswap: 'mint_uniswap_position',
       'vaults-fyi': 'deposit_earn_position',
@@ -703,6 +727,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       'market-data': 'get_trending_tokens',
       gmgn: 'get_gmgn_kol_trades',
       nansen: 'get_nansen_perp_screener',
+      basedbid: 'basedbid_get_tokens',
       cmc: 'get_cmc_quotes',
       prediction: 'get_prediction_markets',
     };