@thirdfy/agent-cli 0.2.37 → 0.2.38

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.38] - 2026-07-25
+
+### Fixed
+
+- JSON `--json` envelopes use sync stdout writes so `process.exit` after print no longer truncates piped output (offline doctor certify tests).
+
+### Changed
+
+- Earn provider hints: canonical discovery `get_earning_opportunities` / `get-earning-opportunities`; `get_earn_opportunities` / `get-earn-opportunities` remain aliases. Pairs with Thirdfy API develop + `thirdfy-mcp` Unreleased.
+- Lighter command reference: `complete_lighter_onboarding` example uses `--chain-id 8453` and `preferredSourceChainId: 8453` (not Arbitrum 42161).
+- Lighter provider hints and command reference: repeat `complete_lighter_onboarding` on Base (chainId 8453) until `get_lighter_setup_status.ready`; API auto-orchestrates Ethereum registration. Pairs with Thirdfy API develop + `thirdfy-mcp` Unreleased.
+
 ## [0.2.37] - 2026-07-25
 
 ### Added

package/README.md

@@ -40,10 +40,11 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.37
+## What's new in v0.2.38
 
-- Polymarket provider hints include `get_polymarket_user_positions` next to open-order reads, so `actions` / provider discovery surfaces Data API position inventory.
-- Pairs with MCP **0.0.80**. Requires the matching Thirdfy API action on the host you call.
+- Earn discovery prefers `get_earning_opportunities` / `get-earning-opportunities` (legacy `get_earn_opportunities` aliases remain).
+- Lighter onboarding hints: repeat `complete_lighter_onboarding` on Base (`8453`) until setup is ready.
+- Pairs with MCP **0.0.81** and Thirdfy API **v3.13.26**.
 
 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.37",
+  "version": "0.2.38",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {

package/src/core/envelope.mjs

@@ -1,3 +1,5 @@
+import { writeSync } from 'node:fs';
+
 export function createCliError(code, message, payload = {}) {
   const error = new Error(message);
   error.payload = {
@@ -10,11 +12,10 @@ export function createCliError(code, message, payload = {}) {
 }
 
 export function printEnvelope(payload, { jsonMode = false } = {}) {
-  if (jsonMode) {
-    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
-    return;
-  }
-  const status = payload.success ? 'OK' : 'ERROR';
-  process.stdout.write(`[${status}] ${payload.code}: ${payload.message}\n`);
-  process.stdout.write(`${JSON.stringify(payload.data || {}, null, 2)}\n`);
+  // writeSync: callers often process.exit() immediately after print. Async
+  // process.stdout.write can truncate JSON when stdout is a pipe (tests/CI).
+  const text = jsonMode
+    ? `${JSON.stringify(payload, null, 2)}\n`
+    : `[${payload.success ? 'OK' : 'ERROR'}] ${payload.code}: ${payload.message}\n${JSON.stringify(payload.data || {}, null, 2)}\n`;
+  writeSync(1, text);
 }

package/src/runtime/actions/selection.mjs

@@ -109,6 +109,7 @@ function inferActionProvider(action) {
     'place-lighter-perps-order': 'lighter',
     'cancel-lighter-perps-order': 'lighter',
     'update-lighter-leverage': 'lighter',
+    'get-earning-opportunities': 'earn',
     'get-earn-opportunities': 'earn',
     'get-earn-provider': 'earn',
     'get-earn-position': 'earn',

package/src/runtime/providerHints.mjs

@@ -187,11 +187,11 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         ],
         sourceBridgeProvider: 'lifi',
         funding:
-          'Run complete_lighter_onboarding on Base (chainId 8453) for automated Li.Fi, CCTP intent, and USDC transfer. API key registration uses an Ethereum priority changePubKey transaction (chainId 1). Minimum CCTP deposit is 5 USDC.',
+          'Run complete_lighter_onboarding on Base (chainId 8453) for Li.Fi, CCTP intent, and USDC transfer. When margin is credited, the API auto-switches to Ethereum API key registration on the next complete_lighter_onboarding call. Minimum CCTP deposit is 5 USDC.',
         laneCompatibility:
-          'Use agent_wallet for automated complete_lighter_onboarding (CCTP on Base, priority changePubKey on Ethereum). Perps writes use thirdfy, hybrid, or agent_wallet with a stored lighter_api_key credential. Gator covers EVM funding and setup only, not L2 orders.',
+          'Use agent_wallet and repeat complete_lighter_onboarding on chainId 8453 until get_lighter_setup_status.ready is true. Perps writes use thirdfy, hybrid, or agent_wallet with a stored lighter_api_key credential. Gator covers EVM funding and setup only, not L2 orders.',
         setupExample:
-          'actions --provider lighter -> complete_lighter_onboarding (chainId 8453, agent_wallet) -> re-run after CCTP credit -> setup_lighter_api_key on chainId 1 when prompted -> credentials upsert lighter_api_key (auto on agent_wallet) -> get_lighter_setup_status -> place_lighter_perps_order',
+          'actions --provider lighter -> complete_lighter_onboarding (chainId 8453, agent_wallet) -> repeat until get_lighter_setup_status.ready -> place_lighter_perps_order',
         example:
           'thirdfy-agent actions --provider lighter && thirdfy-agent preflight --action place_lighter_perps_order --params \'{"accountIndex":1,"apiKeyIndex":4,"marketId":0,"baseAmount":100,"price":310000,"isAsk":false,"orderType":"limit"}\'',
       };
@@ -339,9 +339,10 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       return {
         provider,
         category: 'earn',
-        canonicalReadAction: 'get_earn_opportunities',
+        canonicalReadAction: 'get_earning_opportunities',
         canonicalWriteAction: 'deposit_earn_position',
         readActions: [
+          'get_earning_opportunities',
           'get_earn_opportunities',
           'get_earn_provider',
           'get_earn_position',
@@ -364,7 +365,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         category: 'earn',
         canonicalReadAction: 'get_capyfi_markets',
         canonicalWriteAction: 'deposit_earn_position',
-        readActions: ['get_capyfi_markets', 'get_earn_opportunities', 'get_earn_position'],
+        readActions: ['get_capyfi_markets', 'get_earning_opportunities', 'get_earn_opportunities', 'get_earn_position'],
         orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
         supportedChains: [1, 480],
         laneCompatibility: 'CapyFi Compound-v2 supply on Ethereum and World Chain; Gnosis pending deployment addresses.',
@@ -403,7 +404,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         category: 'earn',
         canonicalReadAction: 'get_aegis_pools',
         canonicalWriteAction: 'deposit_aegis_lender',
-        readActions: ['get_earn_opportunities', 'get_aegis_pools', 'get_aegis_pool_state', 'get_aegis_vault_state', 'get_earn_provider'],
+        readActions: ['get_earning_opportunities', 'get_earn_opportunities', 'get_aegis_pools', 'get_aegis_pool_state', 'get_aegis_vault_state', 'get_earn_provider'],
         orderManagementActions: [
           'deposit_aegis_lender',
           'redeem_aegis_lender',
@@ -424,7 +425,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         category: 'earn',
         canonicalReadAction: 'get_curve_pools',
         canonicalWriteAction: 'deposit_earn_position',
-        readActions: ['get_curve_pools', 'get_earn_opportunities', 'get_earn_provider', 'get_earn_position'],
+        readActions: ['get_curve_pools', 'get_earning_opportunities', 'get_earn_opportunities', 'get_earn_provider', 'get_earn_position'],
         orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
         supportedChains: [8453],
         laneCompatibility:
@@ -437,7 +438,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         category: 'earn',
         canonicalReadAction: 'get-vaults-fyi-vaults',
         canonicalWriteAction: 'deposit_earn_position',
-        readActions: ['get-vaults-fyi-vaults', 'get_earn_opportunities', 'get_earn_provider', 'get_earn_position'],
+        readActions: ['get-vaults-fyi-vaults', 'get_earning_opportunities', 'get_earn_opportunities', 'get_earn_provider', 'get_earn_position'],
         orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
         laneCompatibility:
           'Vaults.fyi writes are transaction-prep first. Thirdfy validates partner payloads, chain/user context, and allowed targets before returning or submitting prepared calls.',
@@ -451,7 +452,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         category: 'earn',
         canonicalReadAction: 'get_yield_xyz_opportunities',
         canonicalWriteAction: 'deposit_earn_position',
-        readActions: ['get_yield_xyz_opportunities', 'get_earn_opportunities', 'get_earn_provider', 'get_earn_position'],
+        readActions: ['get_yield_xyz_opportunities', 'get_earning_opportunities', 'get_earn_opportunities', 'get_earn_provider', 'get_earn_position'],
         orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
         laneCompatibility:
           'Yield.xyz writes are transaction-prep first. Thirdfy calls Yield.xyz directly and validates returned unsigned transactions with @yieldxyz/shield before signing or returning prepared calls.',
@@ -500,7 +501,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       'yield-xyz': 'deposit_earn_position',
     };
     const canonicalReadActions = {
-      earn: 'get_earn_opportunities',
+      earn: 'get_earning_opportunities',
       morpho: 'get_morpho_vaults',
       aegis: 'get_aegis_pools',
       curve: 'get_curve_pools',