@thirdfy/agent-cli 0.1.23 → 0.1.25

package/CHANGELOG.md

@@ -4,6 +4,32 @@ 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)  
+**Git tag:** `v0.1.24`
+
+### Changed
+
+- **Public docs / npm README:** Replaced stale “What’s new in 0.1.12” with a **Release notes** pointer to `CHANGELOG.md`; refreshed the release footer example to **v0.1.23**.
+- **Discovery docs:** Documented **case-insensitive** `actions --provider` matching and earn-row normalization aligned with MCP `getProviderActions`, in `README.md`, `docs/command-reference.md`, and `docs/action-inventory-and-compatibility.md`.
+
 ## [0.1.23] - 2026-05-02
 
 **npm:** [`@thirdfy/agent-cli@0.1.23`](https://www.npmjs.com/package/@thirdfy/agent-cli/v/0.1.23)  

package/README.md

@@ -38,12 +38,9 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in 0.1.12
+## Release notes
 
-- Added Model D onboarding commands: `bootstrap begin` and `bootstrap complete`.
-- Added `onboarding begin` and `onboarding complete` aliases for clearer operator flows.
-- Aligned bootstrap completion to session-proof issuance (`session_token`), with wallet challenge/signature supported as an exchange step into session proof.
-- Hardened bootstrap path behavior for safer timeout and one-time challenge handling.
+Version history and highlights: [CHANGELOG.md](./CHANGELOG.md). Recent CLI releases document earn/prediction provider discovery, case-insensitive `actions --provider` filtering, self-lane guards for offchain venue orders, and npm-facing README refresh (**v0.1.24**).
 
 ## Quick start
 
@@ -269,7 +266,7 @@ Provider and venue guides are kept outside `README` so this page stays stable as
 
 ## Command groups
 
-- Discovery: `catalogs list`, `actions`
+- Discovery: `catalogs list`, `actions` (optional `--provider`, `--chain-id`; see [`docs/command-reference.md`](./docs/command-reference.md) for trading vs earn vs prediction providers and case-insensitive matching)
 - Execution: `preflight`, `run`, `intent-status`, `jeff preflight`, `jeff trade`, `jeff status`
 - Managed signer execution: `wallet execute`, `wallet sign`, `wallet submit`, `agent run`
 - Profiles: `profile init`, `profile use`, `profile show`, `whoami`
@@ -407,7 +404,7 @@ npm run e2e:managed:delegation:parity
 
 ## Release
 
-Version history and user-facing notes: [CHANGELOG.md](./CHANGELOG.md) (for example [0.1.12](https://github.com/thirdfy/agent-cli/releases/tag/v0.1.12) — bootstrap onboarding commands and session-proof alignment).
+Version history and user-facing notes: [CHANGELOG.md](./CHANGELOG.md) (for example [v0.1.24](https://github.com/thirdfy/agent-cli/releases/tag/v0.1.24) — npm README and discovery docs aligned with MCP).
 
 ```bash
 npm version patch

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.23",
+  "version": "0.1.25",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {