@thirdfy/agent-cli 0.2.62 → 0.2.64

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.64] - 2026-09-10
+
+### Added
+
+- Fomo API provider (`providerId: fomo`): read-only `get_fomo_search`, `get_fomo_user`, `get_fomo_balances`, `get_fomo_leaderboard`, `get_fomo_alerts`. Unofficial [fomoapi.io](https://fomoapi.io/docs) integration, not the Fomo consumer app. See [`docs/providers/fomo.md`](./docs/providers/fomo.md). Pairs with `thirdfy-mcp` **0.0.114** and Thirdfy API **3.14.33**.
+
+### Fixed
+
+- Catalog `paramsSchema` coerces finite numbers on `amount*` keys to strings when the schema type is string (`amountUsdc: 29.24` → `"29.24"`). `orderId` numbers still fail. Pairs with `thirdfy-mcp` **0.0.114**. Pin: `test/params-schema-validation.test.cjs`.
+
+## [0.2.63] - 2026-09-09
+
+### Changed
+
+- Prediction provider hints prefer `get_prediction_markets` with Gamma `tag_id` and `end_date_min` / `end_date_max` over `search_prediction_markets` for discovery. Pairs with `thirdfy-mcp` **0.0.113** and Thirdfy API **3.14.30**.
+
 ## [0.2.62] - 2026-09-09
 
 ### Added

package/README.md

@@ -40,11 +40,10 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.62
+## What's new in v0.2.64
 
-- Ratehopper Managed USDC LP on Base is a named earn provider (`ratehopper`).
-- Discover agents and portfolio, then prepare Safe deploy and cash_lp setup when you confirm.
-- Close and owner sweep stay blocked until Ratehopper confirms the REST close path.
+- Fomo API (`providerId: fomo`) read-only handle intel and app alerts via `get_fomo_*`. Unofficial fomoapi.io integration, not the Fomo consumer app. See [`docs/providers/fomo.md`](./docs/providers/fomo.md).
+- Catalog `paramsSchema` coerces finite numbers on `amount*` keys to strings when the schema type is string (`amountUsdc: 29.24` → `"29.24"`).
 - See [CHANGELOG.md](./CHANGELOG.md) and GitHub Releases for older versions.
 
 ## Quick start

package/package.json

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

package/src/runtime/providerHints.mjs

@@ -433,11 +433,18 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         canonicalWriteAction: 'place_prediction_order',
         readActions: [
           'get_prediction_tags',
-          'search_prediction_markets',
-          'get_prediction_events',
           'get_prediction_markets',
+          'get_prediction_events',
           'get_prediction_market',
           'get_prediction_order_book',
+          'search_prediction_markets',
+        ],
+        discoveryFlow: [
+          'get_prediction_tags (resolve numeric tag_id once)',
+          'get_prediction_markets with tag_id + end_date_min/end_date_max + liquidity_num_min',
+          'get_prediction_order_book when book prices are missing',
+          'place_prediction_order after setup/funding/preflight',
+          'search_prediction_markets last for human text/slug lookup only',
         ],
         orderManagementActions: ['place_prediction_order', 'cancel_prediction_order'],
         compatibilityProvider: 'polymarket',
@@ -700,6 +707,25 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'thirdfy-agent condor policy-status && thirdfy-agent condor preflight --estimated-amount-usd 25 --idempotency-key <key>',
       };
     }
+    if (provider === 'fomo') {
+      return {
+        provider,
+        category: 'smart_money_intel',
+        canonicalReadAction: 'get_fomo_alerts',
+        readActions: [
+          'get_fomo_search',
+          'get_fomo_user',
+          'get_fomo_balances',
+          'get_fomo_leaderboard',
+          'get_fomo_alerts',
+        ],
+        supportedChains: [],
+        laneCompatibility:
+          'Fomo API (fomoapi.io) uses string chain slugs (robinhood, solana, base, bsc, eth), not numeric chainId. Unofficial integration; not the Fomo consumer app. Read-only handle intel and app alerts via Thirdfy API. Resolve handles before storing watchlists. Pace calls (~1 req/s).',
+        example:
+          'thirdfy-agent run --action get_fomo_alerts --params \'{"chain":"robinhood","type":"buy","limit":5}\' --provider fomo --json',
+      };
+    }
     if (provider === 'gmgn') {
       return {
         provider,
@@ -862,6 +888,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       'vaults-fyi': 'get-vaults-fyi-vaults',
       'yield-xyz': 'get_yield_xyz_opportunities',
       'market-data': 'get_trending_tokens',
+      fomo: 'get_fomo_alerts',
       gmgn: 'get_gmgn_kol_trades',
       nansen: 'get_nansen_perp_screener',
       basedbid: 'basedbid_get_tokens',

package/src/runtime/validation/paramsSchema.mjs

@@ -44,12 +44,29 @@ function extractFieldFromError(message) {
   return null;
 }
 
+/** Coerce JSON numbers on amount* keys when the catalog schema type is string. Do not coerce orderId. */
+export function coerceAmountKeysToSchemaStrings(params, schema) {
+  const next = params && typeof params === 'object' ? params : {};
+  const properties = schema?.properties;
+  if (!properties || typeof properties !== 'object') return next;
+  for (const [key, value] of Object.entries(next)) {
+    if (!/amount/i.test(key)) continue;
+    const rule = properties[key];
+    if (!rule || String(rule.type) !== 'string') continue;
+    if (typeof value === 'number' && Number.isFinite(value)) {
+      next[key] = String(value);
+    }
+  }
+  return next;
+}
+
 /**
  * Validate action params against catalog paramsSchema (JSON Schema subset used by Thirdfy API).
  * Mirrors AgentExecutionService.validateParamsSchema for client-side fail-fast.
  */
 export function validateParamsSchema(params, schema) {
   if (!schema || typeof schema !== 'object') return { valid: true };
+  coerceAmountKeysToSchemaStrings(params, schema);
 
   const required = Array.isArray(schema.required) ? schema.required.map((k) => String(k)) : [];
   const properties =