@thirdfy/agent-cli 0.2.81 → 0.2.82

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## Unreleased
 
+## [0.2.82] - 2026-10-01
+
+### Fixed
+
+- **`preflight` / `run --run-mode agent_wallet` keep the API's native gas readiness.** On user-pays-gas chains (DogeOS 6281971) Thirdfy API 3.18.2 returns `gasSponsored`, `gasReady`, `nativeGasBalance` and, at 0, `nativeGasWarning` from `/execution-wallet`; the CLI rebuilt the preflight from a fixed field list and dropped them. They now appear under `data.executionWalletPreflight`, and a write whose wallet holds 0 native coin stops before `/execute` with `INSUFFICIENT_NATIVE_GAS` and the faucet message. Sponsored chains and older APIs are unchanged. Pin: `test/preflight-native-gas.test.cjs`.
+- **DogeOS Laika writes check the right funding token.** `dogeos-laika-buy-token` and `dogeos-laika-launch-token` spend native DOGE (`dogeAmountWei`, `initialPurchaseWei`), and `dogeos-laika-claim` receives `tokenAddress`; the CLI sent that bonding-curve token as the execution-wallet `tokenIn` and blocked a buy with `INSUFFICIENT_FUNDS`. They now skip the ERC-20 balance check, as does any action that carries `dogeAmountWei`. `dogeos-laika-sell-token` still checks the token it sells. Pin: `test/funding-token-in.test.cjs`.
+
 ## [0.2.81] - 2026-10-01
 
 ### Added

package/README.md

@@ -40,11 +40,10 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.81
+## What's new in v0.2.82
 
-- **DogeOS onboarding**: the quickstart starts with `login email`, warns not to use `managed wallet init` for `agent_wallet`, funds gas and test USDC from the DogeOS faucet, starts with a USDC→WDOGE swap, and adds `dogeos-laika-sell-token`. See [docs/dogeos-quickstart.md](./docs/dogeos-quickstart.md).
-- **Chain-aware gas notes**: `help onboarding --chain-id` and `doctor auth --chain-id` say when the sending wallet pays gas (DogeOS) and link the faucet.
-- **`wallet submit --chain-id` works**, reads the chain from the signed transaction when `--chain-id` is omitted, and picks the RPC for that chain. Base keeps its order (`BASE_RPC_URL`, `BASE_RPC_HTTP_URL`, `RPC_URL`); other chains use `--rpc-url`, then `RPC_URL`, then the built-in DogeOS RPC. Self-mode broadcast (`self-exec`) uses the same rule. A Base RPC is never used on DogeOS.
+- **`agent_wallet` preflight shows native gas** on chains where the wallet pays gas (DogeOS 6281971): `gasSponsored`, `gasReady`, `nativeGasBalance`, from Thirdfy API 3.18.2. A write from a wallet with 0 native coin stops before `/execute` with `INSUFFICIENT_NATIVE_GAS` and the faucet link.
+- **DogeOS Laika buys pass preflight.** A buy spends native DOGE (`dogeAmountWei`); the CLI no longer checks the balance of the token being bought. Launch and claim are treated the same way, and a sell still checks the token it sells.
 - See [CHANGELOG.md](./CHANGELOG.md) and GitHub Releases for older versions.
 
 ## Quick start

package/package.json

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

package/src/core/fundingTokenIn.mjs

@@ -9,6 +9,9 @@ const NATIVE_ETH_SPEND_ACTIONS = new Set([
   'basedbid_create_lbp',
   'basedbid_create_flash',
   'basedbid_create_board',
+  // DogeOS Laika: buys and launches spend native DOGE; tokenAddress is the bonding-curve token received.
+  'dogeos_laika_buy_token',
+  'dogeos_laika_launch_token',
 ]);
 
 /**
@@ -18,6 +21,7 @@ const NATIVE_ETH_SPEND_ACTIONS = new Set([
 const POSITION_EXIT_ACTIONS = new Set([
   'withdraw_earn_position',
   'claim_earn_rewards',
+  'dogeos_laika_claim',
 ]);
 
 export function resolveTokenInForFunding(params, action) {
@@ -28,5 +32,6 @@ export function resolveTokenInForFunding(params, action) {
   if (NATIVE_ETH_SPEND_ACTIONS.has(actionId)) return '';
   if (POSITION_EXIT_ACTIONS.has(actionId)) return '';
   if (params.amountEth != null && String(params.amountEth).trim() !== '') return '';
+  if (params.dogeAmountWei != null && String(params.dogeAmountWei).trim() !== '') return '';
   return String(params.tokenAddress || params.token || '').trim();
 }

package/src/runtime/execution/nativeGas.mjs

@@ -0,0 +1,13 @@
+const NATIVE_GAS_FIELDS = ['gasSponsored', 'gasReady', 'nativeGasBalance', 'nativeGasBalanceUnavailable', 'nativeGasWarning'];
+
+/**
+ * Native gas readiness from an `/execution-wallet` reply (Thirdfy API 3.18.2+). Present only on
+ * user-pays-gas chains (DogeOS 6281971); empty for sponsored chains and older APIs.
+ */
+export function pickNativeGasFields(response) {
+  const out = {};
+  for (const key of NATIVE_GAS_FIELDS) {
+    if (response && response[key] !== undefined) out[key] = response[key];
+  }
+  return out;
+}

package/src/runtime/execution/runners.mjs

@@ -1,4 +1,5 @@
 import { randomUUID } from 'crypto';
+import { pickNativeGasFields } from './nativeGas.mjs';
 import { requireFlag } from '../../core/args.mjs';
 import { createCliError } from '../../core/envelope.mjs';
 import {
@@ -778,6 +779,7 @@ async function resolveManagedExecutionPreflight(ctx, flags, resolved, options =
       executionWalletAddress: preflightSeed.executionWalletAddress || null,
       signerMethod: preflightSeed.signerMethod || null,
       fundingTokenBalance: preflightSeed.fundingTokenBalance || null,
+      ...pickNativeGasFields(preflightSeed),
     }
     : await apiGet(ctx, `/api/v1/agent/execution-wallet?${query.toString()}`, {
       'x-agent-api-key': agentApiKey,
@@ -832,6 +834,23 @@ async function resolveManagedExecutionPreflight(ctx, flags, resolved, options =
     };
   }
 
+  // User-pays-gas chains (DogeOS): the API reports native gas readiness (API 3.18.2+). Keep it, and
+  // stop a write before /execute when the wallet holds 0 native coin.
+  const nativeGas = pickNativeGasFields(response);
+  if (options.requireFundingCheck && nativeGas.gasReady === false) {
+    return {
+      success: false,
+      blockedReason: 'INSUFFICIENT_NATIVE_GAS',
+      blockedStage: 'sizing',
+      error: nativeGas.nativeGasWarning?.message
+        || `Execution wallet ${executionWalletAddress || 'unknown'} has 0 native gas on chain ${chainId}; gas on this chain is paid by the wallet.`,
+      executionWalletAddress,
+      signerMethod,
+      fundingTokenBalance: response?.fundingTokenBalance || null,
+      ...nativeGas,
+    };
+  }
+
   return {
     success: true,
     executionWalletAddress,
@@ -840,6 +859,7 @@ async function resolveManagedExecutionPreflight(ctx, flags, resolved, options =
     userDid,
     chainId,
     tokenIn: tokenIn || null,
+    ...nativeGas,
   };
 }