@thirdfy/agent-cli 0.2.77 → 0.2.79

package/src/runtime/main.mjs

@@ -1,5 +1,5 @@
 import { createRequire } from 'module';
-import { printEnvelope as corePrintEnvelope } from '../core/envelope.mjs';
+import { exitAfterOutput, printEnvelope as corePrintEnvelope } from '../core/envelope.mjs';
 import { negotiateCapabilities } from '../core/http.mjs';
 import {
   buildCliProgram,
@@ -38,7 +38,7 @@ export function createThirdfyAgentRuntime() {
         process.argv.includes('--json') ||
         (cliProgram ? cliProgram.opts()?.json : false)
     );
-    corePrintEnvelope(payload, { jsonMode });
+    corePrintEnvelope(payload, { jsonMode, humanLead: options.humanLead, humanData: options.humanData });
   }
 
   function prepareContextFromFlags(flags) {
@@ -174,7 +174,7 @@ export function createThirdfyAgentRuntime() {
           return;
         }
         const exitCode = Number(error.exitCode ?? 1);
-        process.exit(exitCode);
+        await exitAfterOutput(exitCode);
       }
       throw error;
     }
@@ -204,7 +204,7 @@ export function createThirdfyAgentRuntime() {
       },
       meta: { version: CLI_VERSION, apiBase: context.apiBase },
     });
-    process.exit(1);
+    return exitAfterOutput(1);
   }
 
   return {

package/src/runtime/providerHints.mjs

@@ -1,9 +1,27 @@
+import { normalizeVenueProviderId } from '../core/venueBrand.mjs';
+
+/**
+ * Veranta (formerly Avantis) naming for the `avantis` / `avantis-vault` hints, static or from the
+ * capabilities manifest. Empty for every other provider.
+ */
+function verantaNamingFields(provider) {
+  if (provider !== 'avantis' && provider !== 'avantis-vault') return {};
+  const alias = provider === 'avantis' ? 'veranta' : 'veranta-vault';
+  return {
+    displayName: 'Veranta',
+    formerName: 'Avantis',
+    providerAliases: [alias],
+    actionNaming: `Veranta (formerly Avantis). Veranta action names (*_veranta_*) are canonical; Avantis names (*_avantis_*) still resolve. Provider id stays ${provider}; --provider ${alias} is an alias.`,
+  };
+}
+
 /**
  * Static and capabilities-backed provider discovery hints for CLI actions filtering.
  */
 export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
   function getTradingProviderHint(providerId) {
-    const provider = String(providerId || '').trim().toLowerCase();
+    // `veranta` / `veranta-vault` resolve to the internal `avantis` / `avantis-vault` hints.
+    const provider = normalizeVenueProviderId(providerId || '');
     const manifestHint = getCachedProviderHintFromCapabilities(provider);
     const setupHints =
       manifestHint?.setupHints && typeof manifestHint.setupHints === 'object' ? manifestHint.setupHints : {};
@@ -206,68 +224,69 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
     if (provider === 'avantis') {
       return {
         provider,
+        ...verantaNamingFields(provider),
         category: 'leveraged_perps',
-        canonicalWriteAction: 'place_avantis_perps_order',
+        canonicalWriteAction: 'place_veranta_perps_order',
         readActions: [
-          'get_avantis_markets',
-          'get_avantis_pair',
-          'get_avantis_price',
-          'get_avantis_spread',
-          'get_avantis_positions',
-          'get_avantis_open_orders',
-          'get_avantis_allowance',
-          'get_avantis_delegation_status',
-          'get_avantis_funding_status',
-          'get_avantis_setup_status',
-          'get_avantis_onboarding_plan',
-          'get_avantis_builder_fee_status',
-          'get_avantis_referral_status',
-          'get_avantis_referral_stats',
+          'get_veranta_markets',
+          'get_veranta_pair',
+          'get_veranta_price',
+          'get_veranta_spread',
+          'get_veranta_positions',
+          'get_veranta_open_orders',
+          'get_veranta_allowance',
+          'get_veranta_delegation_status',
+          'get_veranta_funding_status',
+          'get_veranta_setup_status',
+          'get_veranta_onboarding_plan',
+          'get_veranta_builder_fee_status',
+          'get_veranta_referral_status',
+          'get_veranta_referral_stats',
         ],
         orderManagementActions: [
-          'place_avantis_perps_order',
-          'cancel_avantis_perps_order',
-          'close_avantis_position',
-          'update_avantis_tp_sl',
-          'cancel_avantis_tp_sl',
-          'place_avantis_twap_order',
-          'close_avantis_twap_order',
-          'cancel_avantis_twap_order',
-          'place_avantis_coin_perps_order',
-          'increase_avantis_coin_position',
-          'close_avantis_coin_position',
-          'place_avantis_mm_order',
-          'cancel_avantis_mm_order',
-          'get_avantis_open_orders',
-          'get_avantis_positions',
+          'place_veranta_perps_order',
+          'cancel_veranta_perps_order',
+          'close_veranta_position',
+          'update_veranta_tp_sl',
+          'cancel_veranta_tp_sl',
+          'place_veranta_twap_order',
+          'close_veranta_twap_order',
+          'cancel_veranta_twap_order',
+          'place_veranta_coin_perps_order',
+          'increase_veranta_coin_position',
+          'close_veranta_coin_position',
+          'place_veranta_mm_order',
+          'cancel_veranta_mm_order',
+          'get_veranta_open_orders',
+          'get_veranta_positions',
         ],
         setupActions: [
-          'get_avantis_funding_status',
-          'get_avantis_setup_status',
-          'get_avantis_onboarding_plan',
-          'prepare_avantis_onboarding',
-          'complete_avantis_onboarding',
-          'approve_avantis_builder_fee',
-          'revoke_avantis_builder_fee',
-          'set_avantis_referral_code',
-          'register_avantis_referral_code',
-          'claim_avantis_referral_rebate',
+          'get_veranta_funding_status',
+          'get_veranta_setup_status',
+          'get_veranta_onboarding_plan',
+          'prepare_veranta_onboarding',
+          'complete_veranta_onboarding',
+          'approve_veranta_builder_fee',
+          'revoke_veranta_builder_fee',
+          'set_veranta_referral_code',
+          'register_veranta_referral_code',
+          'claim_veranta_referral_rebate',
         ],
         statusActions: [
-          'get_avantis_funding_status',
-          'get_avantis_setup_status',
-          'get_avantis_builder_fee_status',
-          'get_avantis_delegation_status',
+          'get_veranta_funding_status',
+          'get_veranta_setup_status',
+          'get_veranta_builder_fee_status',
+          'get_veranta_delegation_status',
         ],
         recoveryActions: [
-          'get_avantis_positions',
-          'close_avantis_position',
+          'get_veranta_positions',
+          'close_veranta_position',
         ],
         decommissionExample:
-          'get_avantis_positions -> close_avantis_position -> withdraw-to-user on execution wallet (Base USDC)',
+          'get_veranta_positions -> close_veranta_position -> withdraw-to-user on execution wallet (Base USDC)',
         credentialType: 'avantis_delegate',
         credentialUx:
-          'Thirdfy mints and stores the encrypted Avantis delegate. CLI callers use Thirdfy auth only. Do not paste a private key.',
+          'Thirdfy mints and stores the encrypted Veranta delegate. CLI callers use Thirdfy auth only. Do not paste a private key.',
         recommendedFundingChainId: 8453,
         supportedFundingSourceChains: [
           { chainId: 8453, name: 'Base', path: 'native USDC in managed execution wallet (recommended)' },
@@ -283,32 +302,33 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         funding:
           'Fund the managed execution wallet on Base (8453) with native USDC. Minimum collateral follows the live catalog notional floor.',
         laneCompatibility:
-          'Use agent_wallet for solo managed-wallet onboarding and perps writes after avantis_delegate credential is stored. Use thirdfy or hybrid for delegated capital. Thirdfy builds EIP-712 intents; the delegate credential signs batched-market submissions. Relayer is default. Builder-fee collection stays unwired until Avantis supplies a fee-enabled template.',
+          'Use agent_wallet for solo managed-wallet onboarding and perps writes after avantis_delegate credential is stored. Use thirdfy or hybrid for delegated capital. Thirdfy builds EIP-712 intents; the delegate credential signs batched-market submissions. Relayer is default. Builder-fee collection stays unwired until Veranta supplies a fee-enabled template.',
         setupExample:
-          'actions --provider avantis -> get_avantis_funding_status -> complete_avantis_onboarding (agent_wallet on Base 8453) -> get_avantis_setup_status before place_avantis_perps_order. Do not call approve_avantis_builder_fee until setup status shows a wired template.',
+          'actions --provider veranta -> get_veranta_funding_status -> complete_veranta_onboarding (agent_wallet on Base 8453) -> get_veranta_setup_status before place_veranta_perps_order. Do not call approve_veranta_builder_fee until setup status shows a wired template.',
         example:
-          'thirdfy-agent actions --provider avantis && thirdfy-agent preflight --action place_avantis_perps_order --params \'{"pairIndex":0,"side":"long","collateralUsdc":10,"leverage":10,"orderType":"market"}\'',
+          'thirdfy-agent actions --provider veranta && thirdfy-agent preflight --action place_veranta_perps_order --params \'{"pairIndex":0,"side":"long","collateralUsdc":10,"leverage":10,"orderType":"market"}\'',
       };
     }
     if (provider === 'avantis-vault') {
       return {
         provider,
+        ...verantaNamingFields(provider),
         category: 'earn',
-        canonicalReadAction: 'get_avantis_vault_info',
-        canonicalWriteAction: 'deposit_avantis_vault',
-        readActions: ['get_avantis_vault_info', 'get_avantis_vault_position'],
+        canonicalReadAction: 'get_veranta_vault_info',
+        canonicalWriteAction: 'deposit_veranta_vault',
+        readActions: ['get_veranta_vault_info', 'get_veranta_vault_position'],
         orderManagementActions: [
-          'deposit_avantis_vault',
-          'request_avantis_vault_withdrawal',
-          'redeem_avantis_vault',
-          'claim_avantis_vault',
+          'deposit_veranta_vault',
+          'request_veranta_vault_withdrawal',
+          'redeem_veranta_vault',
+          'claim_veranta_vault',
         ],
         recommendedFundingChainId: 8453,
         supportedChains: [8453],
         funding: 'Fund the managed execution wallet on Base with native USDC before vault deposit.',
-        laneCompatibility: 'Avantis LP vault on Base. Use agent_wallet, thirdfy, or hybrid. Relayer is default.',
+        laneCompatibility: 'Veranta (formerly Avantis) LP vault on Base. Use agent_wallet, thirdfy, or hybrid. Relayer is default.',
         example:
-          'thirdfy-agent actions --provider avantis-vault && thirdfy-agent run --action get_avantis_vault_info --provider avantis-vault --json',
+          'thirdfy-agent actions --provider veranta-vault && thirdfy-agent run --action get_veranta_vault_info --provider veranta-vault --json',
       };
     }
     if (provider === 'bitfinex') {
@@ -901,12 +921,12 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
   }
 
   function getCachedProviderHintFromCapabilities(provider) {
-    const normalizedProvider = String(provider || '').trim().toLowerCase();
+    const normalizedProvider = normalizeVenueProviderId(provider || '');
     if (!normalizedProvider) return null;
     const manifests = Array.isArray(getNegotiatedCapabilitiesCache()?.providers?.manifests)
       ? getNegotiatedCapabilitiesCache().providers.manifests
       : [];
-    const match = manifests.find((entry) => String(entry?.providerId || '').trim().toLowerCase() === normalizedProvider);
+    const match = manifests.find((entry) => normalizeVenueProviderId(entry?.providerId || '') === normalizedProvider);
     if (!match) return null;
     const canonicalWriteActions = {
       trading: 'swap',
@@ -958,13 +978,20 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       custodyMode: match.custodyMode || null,
       description: match.description || null,
       source: 'cli_capabilities_manifest',
+      ...verantaNamingFields(normalizedProvider),
       ...(match.setupHints && typeof match.setupHints === 'object' ? { setupHints: match.setupHints } : {}),
     };
   }
 
+  // Veranta hints carry `providerAliases`; show the public name in messages (`--provider veranta`).
+  function providerLabelForHint(providerHint) {
+    const alias = Array.isArray(providerHint?.providerAliases) ? providerHint.providerAliases[0] : null;
+    return alias || providerHint.provider;
+  }
+
   function formatProviderAmbiguousActionHint(providerHint) {
     if (!providerHint) return '';
-    const p = providerHint.provider;
+    const p = providerLabelForHint(providerHint);
     const w = providerHint.canonicalWriteAction;
     if (w) return ` Provider ${p} expects ${w}.`;
     return ` Provider ${p} did not declare a canonical write action in capabilities; run actions --provider ${p} first.`;
@@ -972,7 +999,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
 
   function formatProviderUnknownActionHint(providerHint) {
     if (!providerHint) return '';
-    const p = providerHint.provider;
+    const p = providerLabelForHint(providerHint);
     const w = providerHint.canonicalWriteAction;
     if (w) return ` Provider ${p} expects ${w}; run actions --provider ${p} first.`;
     return ` Provider ${p} did not declare a canonical write action in capabilities; run actions --provider ${p} first.`;