@thirdfy/agent-cli 0.1.24 → 0.1.25

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.1.25] - 2026-05-04
+
+**npm:** `@thirdfy/agent-cli@0.1.25` (publish after merge)
+
+### Changed
+
+- **Capabilities negotiation:** Cache negotiated Thirdfy CLI capabilities and derive provider hints from the live API response to reduce static hint drift.
+
+### Fixed
+
+- **Managed wallet payloads:** Align swap and related `params` with human-readable amount fields expected by the Thirdfy API when using `amountInHuman`.
+
+### Added
+
+- **Tests:** `test/managed-wallet-payload.test.cjs` for managed-wallet payload shape.
+
 ## [0.1.24] - 2026-05-02
 
 **npm:** [`@thirdfy/agent-cli@0.1.24`](https://www.npmjs.com/package/@thirdfy/agent-cli/v/0.1.24)  

package/bin/thirdfy-agent.mjs

@@ -27,6 +27,7 @@ const RUN_MODES = ['thirdfy', 'self', 'hybrid', 'agent_wallet'];
 const HYBRID_WALLET_MODES = ['self', 'agent_wallet'];
 const CUSTODY_MODES = ['managed', 'external'];
 const EFFECT_CHECK_MODES = ['strict', 'relaxed', 'off'];
+let negotiatedCapabilitiesCache = null;
 const PROFILE_DEFAULTS = {
   personal: 'self',
   builder: 'hybrid',
@@ -153,6 +154,7 @@ async function main() {
   }
 
   const capabilities = await negotiateCapabilities(context);
+  negotiatedCapabilitiesCache = capabilities;
 
   switch (commandKey) {
     case 'agent run':
@@ -556,8 +558,57 @@ function getTradingProviderHint(providerId) {
   return null;
 }
 
-function getCachedProviderHintFromCapabilities(_provider) {
-  return null;
+function getCachedProviderHintFromCapabilities(provider) {
+  const normalizedProvider = String(provider || '').trim().toLowerCase();
+  if (!normalizedProvider) return null;
+  const manifests = Array.isArray(negotiatedCapabilitiesCache?.providers?.manifests)
+    ? negotiatedCapabilitiesCache.providers.manifests
+    : [];
+  const match = manifests.find((entry) => String(entry?.providerId || '').trim().toLowerCase() === normalizedProvider);
+  if (!match) return null;
+  const canonicalWriteActions = {
+    trading: 'swap',
+    hyperliquid: 'place_hyperliquid_perps_order',
+    polymarket: 'place_polymarket_order',
+    prediction: 'place_prediction_order',
+    earn: 'deposit_earn_position',
+    morpho: 'deposit_earn_position',
+    curve: 'deposit_earn_position',
+  };
+  const canonicalReadActions = {
+    earn: 'get_earn_opportunities',
+    morpho: 'get_morpho_vaults',
+    curve: 'get_curve_pools',
+    prediction: 'get_prediction_markets',
+  };
+  return {
+    provider: normalizedProvider,
+    category: match.category || match.domain || match.providerKind || null,
+    ...(canonicalReadActions[normalizedProvider] ? { canonicalReadAction: canonicalReadActions[normalizedProvider] } : {}),
+    ...(canonicalWriteActions[normalizedProvider] ? { canonicalWriteAction: canonicalWriteActions[normalizedProvider] } : {}),
+    providerKind: match.providerKind || null,
+    capabilities: Array.isArray(match.capabilities) ? match.capabilities : [],
+    supportedChains: Array.isArray(match.supportedChains) ? match.supportedChains : [],
+    custodyMode: match.custodyMode || null,
+    description: match.description || null,
+    source: 'cli_capabilities_manifest',
+  };
+}
+
+function formatProviderAmbiguousActionHint(providerHint) {
+  if (!providerHint) return '';
+  const p = providerHint.provider;
+  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.`;
+}
+
+function formatProviderUnknownActionHint(providerHint) {
+  if (!providerHint) return '';
+  const p = providerHint.provider;
+  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.`;
 }
 
 const OFFCHAIN_VENUE_ORDER_ACTIONS = new Set([
@@ -2966,11 +3017,16 @@ function buildBuildTxPayload(flags, resolvedAction) {
 
 function buildManagedExecutePayload(flags, options) {
   const runMode = String(options.runMode || flags.runMode || 'agent_wallet').trim().toLowerCase();
+  const params = getPreparedParams(flags);
+  const managedParams = { ...params };
+  if (flags.__swapInput?.unitSource === 'human' && flags.__swapInput.amountInHuman) {
+    managedParams.amountIn = flags.__swapInput.amountInHuman;
+  }
   const payload = {
     agentApiKey: resolveAgentApiKey(flags, runMode),
     action: String(options.resolvedAction || requireFlag(flags, 'action', 'Missing --action')).trim(),
     userDid: String(flags.userDid || process.env.THIRDFY_USER_DID || '').trim(),
-    params: getPreparedParams(flags),
+    params: managedParams,
     chainId: Number(flags.chainId || 8453),
     executionStrategy: {
       runMode,
@@ -3235,7 +3291,7 @@ async function resolveActionSelection(ctx, flags) {
     throw new Error(
       `Ambiguous --action "${requestedAction}". Alias matches multiple actions: ${formatActionList(
         exactAlias.map((v) => v.key)
-      )}.${providerHint ? ` Provider ${providerHint.provider} expects ${providerHint.canonicalWriteAction}.` : ''}`
+      )}.${formatProviderAmbiguousActionHint(providerHint)}`
     );
   }
 
@@ -3252,14 +3308,14 @@ async function resolveActionSelection(ctx, flags) {
     throw new Error(
       `Ambiguous --action "${requestedAction}". Did you mean one of: ${formatActionList(
         fuzzy.slice(0, 10).map((v) => v.key)
-      )}?${providerHint ? ` Provider ${providerHint.provider} expects ${providerHint.canonicalWriteAction}.` : ''}`
+      )}?${formatProviderAmbiguousActionHint(providerHint)}`
     );
   }
   const providerHint = flags.provider ? getTradingProviderHint(flags.provider) : null;
   throw new Error(
-    `Unknown --action "${requestedAction}". No compatible action found in current catalog/provider scope.${
-      providerHint ? ` Provider ${providerHint.provider} expects ${providerHint.canonicalWriteAction}; run actions --provider ${providerHint.provider} first.` : ''
-    }`
+    `Unknown --action "${requestedAction}". No compatible action found in current catalog/provider scope.${formatProviderUnknownActionHint(
+      providerHint
+    )}`
   );
 }
 

package/package.json

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