@thirdfy/agent-cli 0.2.37 → 0.2.39

package/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.39] - 2026-07-27
+
+### Changed
+
+- Morpho provider hints: `supportedChains` `[8453, 4663]`; Base MetaMorpho V1 writable, Robinhood Vault V2 read-only until deposit capacity opens. Updated `docs/providers/earn-morpho.md`. Pairs with Thirdfy API develop + `thirdfy-mcp` **0.0.82**.
+
+## [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.39
 
-- 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.
+- Morpho hints: Base MetaMorpho V1 writes on `8453`; Robinhood Vault V2 on `4663` is discoverable read-only until `maxDeposit > 0`. Prefer `depositPlan` from `get_earn_opportunities`.
+- Updated [`docs/providers/earn-morpho.md`](./docs/providers/earn-morpho.md) for GraphQL discovery and V1 vs V2 behavior.
+- Pairs with `thirdfy-mcp` **0.0.82** and Thirdfy API develop (Morpho GraphQL integration).
 
 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.39",
   "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.',
@@ -391,10 +392,11 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         canonicalWriteAction: 'deposit_earn_position',
         readActions: ['get_morpho_vaults', 'get_earn_provider', 'get_earn_position'],
         orderManagementActions: ['deposit_earn_position', 'withdraw_earn_position'],
-        supportedChains: [8453, 84532],
-        laneCompatibility: 'Morpho deposits require ERC-20 approvals to the vault/market routes surfaced by the catalog before deposit_earn_position.',
+        supportedChains: [8453, 4663],
+        laneCompatibility:
+          'Base MetaMorpho V1 vaults are writable (use depositPlan from discovery). Robinhood Vault V2 on 4663 is discoverable read-only until maxDeposit > 0. Deposits require ERC-20 approval before deposit_earn_position.',
         example:
-          'thirdfy-agent actions --provider morpho && thirdfy-agent run --action deposit_earn_position --params \'{"providerId":"morpho","vaultAddress":"0x...","tokenAddress":"0x...","amount":"10","chainId":8453}\'',
+          'thirdfy-agent run --action get_earn_opportunities --params \'{"providerId":"morpho","chainId":8453,"asset":"USDC"}\' && thirdfy-agent run --action deposit_earn_position --params \'{"providerId":"morpho","chainId":8453,"vaultAddress":"0x...","tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"0.1","tokenDecimals":6}\'',
       };
     }
     if (provider === 'aegis') {
@@ -403,7 +405,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 +426,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 +439,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 +453,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 +502,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',