hive-intelligence 1.7.3 → 1.9.0

package/build/{chunk-WDF56OFL.js → chunk-MVO6LL3H.js}

@@ -19461,8 +19461,15 @@ var DeFiLlamaAPI = class {
   async getPriceChart(coins, start, span, period, searchWidth, end) {
     const endpoint = `/chart/${encodeURIComponent(coins)}`;
     const params = {};
+    const bounded = Boolean(start && end && end > start);
+    if (bounded && !span) {
+      span = Math.min(
+        Math.ceil((end - start) / chartPeriodSeconds(period)) + 1,
+        500
+      );
+    }
     if (start) params.start = start;
-    if (end) params.end = end;
+    if (end && !start) params.end = end;
     if (span) params.span = span;
     if (period) params.period = period;
     if (searchWidth) params.searchWidth = searchWidth;
@@ -19473,10 +19480,13 @@ var DeFiLlamaAPI = class {
       for (const [coin, coinData] of Object.entries(data.coins)) {
         const typedCoinData = coinData;
         if (typedCoinData.prices && Array.isArray(typedCoinData.prices)) {
+          const inRange = bounded ? typedCoinData.prices.filter(
+            (point) => typeof point.timestamp !== "number" || point.timestamp <= end
+          ) : typedCoinData.prices;
           limitedData.coins[coin] = {
             ...typedCoinData,
-            prices: typedCoinData.prices.slice(-100),
-            originalPriceCount: typedCoinData.prices.length
+            prices: inRange.slice(-100),
+            originalPriceCount: inRange.length
           };
         } else {
           limitedData.coins[coin] = typedCoinData;
@@ -19806,6 +19816,12 @@ var DeFiLlamaAPI = class {
     return data;
   }
 };
+function chartPeriodSeconds(period) {
+  const match = /^(\d+)\s*([mhdw])$/i.exec((period ?? "").trim());
+  if (!match) return 86400;
+  const unit = { m: 60, h: 3600, d: 86400, w: 604800 };
+  return Math.max(Number(match[1]), 1) * unit[match[2].toLowerCase()];
+}
 
 // src/tools/defillamaTools/tools/categories/protocols.ts
 function protocolsTools(apiClient) {
@@ -26777,7 +26793,14 @@ function classifyRuntimeStatusFromError(error) {
   normalized.includes("unknown chain") || // Provider-side rejections of a malformed identifier (GoPlus "Address
   // format error!", "invalid address", "not a valid address") are the
   // caller's to fix, not an outage (2026-09-16 audit).
-  normalized.includes("address format") || normalized.includes("invalid address") || normalized.includes("not a valid address") || normalized.includes("malformed address")) {
+  normalized.includes("address format") || normalized.includes("invalid address") || normalized.includes("not a valid address") || normalized.includes("malformed address") || // 2026-09-24 sweep: upstream bodies the HTTP client now surfaces. Helius
+  // "Invalid wallet address ... is not a valid Solana address", DAS "Pubkey
+  // Validation Err", GoPlus 7012 "Not fungible spl token address", Alchemy
+  // "invalid 1st argument", and a simulated transaction that reverts.
+  /\binvalid [a-z ]{0,24}address\b/.test(normalized) || /\bnot a valid [a-z ]{0,24}address\b/.test(normalized) || normalized.includes("pubkey validation") || normalized.includes("invalid pubkey") || normalized.includes("not fungible") || /\binvalid \d+(st|nd|rd|th) argument\b/.test(normalized) || normalized.includes("execution reverted") || // Tenderly gateway: -32006 "Bad request input parameters".
+  normalized.includes("bad request input") || // An upstream 404 that says the id or address does not exist. A bare
+  // "status code 404" with no body stays failing: it may be our own route.
+  /\b404\b/.test(normalized) && normalized.includes("not found")) {
     return "invalid_input";
   }
   if (normalized.includes("timed out") || normalized.includes("timeout") || normalized.includes("temporarily") || normalized.includes("service unavailable") || normalized.includes("502") || normalized.includes("503") || normalized.includes("504")) {
@@ -30937,16 +30960,35 @@ function getCircuitBreaker(serviceName) {
   }
   return circuitBreakers.get(serviceName);
 }
+function upstreamDetail(error) {
+  const data = error.response?.data;
+  const text = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
+  let detail;
+  if (typeof data === "string") {
+    detail = text(data.replace(/<[^>]*>/g, " "));
+  } else if (data && typeof data === "object") {
+    const body = data;
+    const nested = body.error && typeof body.error === "object" ? text(body.error.message) : void 0;
+    const primary = text(body.message) ?? text(body.error) ?? nested ?? text(body.error_message) ?? text(body.status?.error_message) ?? text(body.msg);
+    const details = text(body.details);
+    detail = primary && details && !primary.includes(details) ? `${primary} (${details})` : primary ?? details;
+  }
+  if (!detail) return null;
+  const compact = detail.replace(/\s+/g, " ").trim();
+  return compact ? compact.slice(0, 240) : null;
+}
+function withUpstreamDetail(error) {
+  if (!(error instanceof AxiosError)) return error;
+  const detail = upstreamDetail(error);
+  if (detail && !error.message.includes(detail)) {
+    error.message = `${error.message}: ${detail}`;
+  }
+  return error;
+}
 function failureMessage(error) {
   let message = "";
   if (error instanceof AxiosError) {
-    const data = error.response?.data;
-    const fromBody = [
-      data?.message,
-      data?.error,
-      data?.status?.error_message
-    ].find((value) => typeof value === "string" && value.trim());
-    message = typeof fromBody === "string" ? fromBody : error.message;
+    message = upstreamDetail(error) ?? error.message;
   } else if (error instanceof Error) {
     message = error.message;
   } else if (error) {
@@ -31159,7 +31201,7 @@ var ResilientHttpClient = class {
         break;
       }
     }
-    throw lastError;
+    throw withUpstreamDetail(lastError);
   }
   /**
    * Perform a GET request
@@ -31243,6 +31285,39 @@ function createHttpClient(config2) {
 }
 
 // src/tools/tenderly/tenderlyClient.ts
+var GATEWAY_MAX_IN_FLIGHT = 2;
+var GATEWAY_MAX_ATTEMPTS = 4;
+var gatewayInFlight = 0;
+var gatewayWaiters = [];
+async function withGatewaySlot(task) {
+  if (gatewayInFlight >= GATEWAY_MAX_IN_FLIGHT) {
+    await new Promise((resolve) => gatewayWaiters.push(resolve));
+  }
+  gatewayInFlight++;
+  try {
+    return await task();
+  } finally {
+    gatewayInFlight--;
+    gatewayWaiters.shift()?.();
+  }
+}
+function gatewayRetryDelayMs(attempt, retryAfter) {
+  const seconds = Number(retryAfter);
+  if (Number.isFinite(seconds) && seconds > 0) {
+    return Math.min(seconds * 1e3, 5e3);
+  }
+  return 1e3 * 2 ** (attempt - 1) + Math.random() * 250;
+}
+function gatewayErrorDetail(bodyText) {
+  try {
+    const parsed = JSON.parse(bodyText);
+    const message = parsed?.error?.message;
+    return typeof message === "string" && message.trim() ? `: ${message.trim()}` : "";
+  } catch {
+    const compact = bodyText.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
+    return compact ? `: ${compact.slice(0, 200)}` : "";
+  }
+}
 var TenderlyClient = class {
   httpClient;
   apiKey;
@@ -31428,17 +31503,37 @@ var TenderlyClient = class {
       params
     };
     try {
-      const response = await fetch(url, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(body),
-        signal: AbortSignal.timeout(3e4)
+      const response = await withGatewaySlot(async () => {
+        for (let attempt = 1; ; attempt++) {
+          const attemptResponse = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(3e4)
+          });
+          if (attemptResponse.ok) return attemptResponse;
+          const retryable = attemptResponse.status === 429 || attemptResponse.status >= 500;
+          if (retryable && attempt < GATEWAY_MAX_ATTEMPTS) {
+            await attemptResponse.body?.cancel().catch(() => void 0);
+            await new Promise(
+              (resolve) => setTimeout(
+                resolve,
+                gatewayRetryDelayMs(
+                  attempt,
+                  attemptResponse.headers.get("retry-after")
+                )
+              )
+            );
+            continue;
+          }
+          const detail = gatewayErrorDetail(
+            await attemptResponse.text().catch(() => "")
+          );
+          throw new Error(
+            `Gateway RPC error: ${attemptResponse.status} ${attemptResponse.statusText}${detail}`
+          );
+        }
       });
-      if (!response.ok) {
-        throw new Error(
-          `Gateway RPC error: ${response.status} ${response.statusText}`
-        );
-      }
       const json = await response.json();
       if (json.error) {
         throw new Error(`RPC error ${json.error.code}: ${json.error.message}`);
@@ -32608,7 +32703,9 @@ var gatewayDefinitions = [
   makeGatewayTool(
     "suggestGasFee",
     "tenderly_suggest_gas_fee",
-    "suggestGasFee",
+    // The gateway method is plural; "suggestGasFee" answers "method not
+    // found" (2026-09-24 sweep).
+    "suggestGasFees",
     "Get EIP-1559 max-fee and priority-fee suggestions with estimated inclusion times.",
     {},
     [],
@@ -43819,7 +43916,7 @@ var AlchemyClient = class {
   apiPath(path) {
     return path.replace("{apiKey}", encodeURIComponent(this.apiKey));
   }
-  async rpc(network, method, params = []) {
+  async rpc(network, method, params = [], options = {}) {
     const startTime = Date.now();
     const client2 = this.getHttpClient(
       `https://${network}.g.alchemy.com`,
@@ -43834,7 +43931,7 @@ var AlchemyClient = class {
     try {
       const response = await client2.post(
         `/v2/${encodeURIComponent(this.apiKey)}`,
-        { body }
+        { body, ...options }
       );
       if (response.error) {
         secureLogger.toolCall(`AlchemyRPC:${method}`, false, Date.now() - startTime, {
@@ -44226,46 +44323,146 @@ function rpcTool(key, name, description, method, properties, paramsBuilder, requ
     }
   };
 }
+var HELIUS_DAS_METHODS = {
+  getAssets: "getAssetBatch",
+  getAssetProofs: "getAssetProofBatch",
+  getAssetSignatures: "getSignaturesForAsset"
+};
+var HELIUS_DAS_PARAM_RENAMES = {
+  getNftEditions: { mintAddress: "mint" },
+  getTokenAccounts: { ownerAddress: "owner", mintAddress: "mint" }
+};
+var ALCHEMY_SOLANA_INDEXER_TIMEOUT_MS = 6e3;
+var heliusFallbackClient = null;
+function getHeliusFallbackClient() {
+  if (!heliusFallbackClient && process.env.HELIUS_API_KEY) {
+    heliusFallbackClient = new HeliusClient(process.env.HELIUS_API_KEY);
+  }
+  return heliusFallbackClient;
+}
+function toHeliusRequest(method, params) {
+  const renames = HELIUS_DAS_PARAM_RENAMES[method];
+  const renamed = renames && params && typeof params === "object" && !Array.isArray(params) ? Object.fromEntries(
+    Object.entries(params).map(
+      ([key, value]) => [renames[key] ?? key, value]
+    )
+  ) : params;
+  return { method: HELIUS_DAS_METHODS[method] ?? method, params: renamed };
+}
+function withSolanaIndexerFallback(definition, method, paramsBuilder) {
+  const name = definition.tool.name;
+  return {
+    ...definition,
+    handler: async (clientParam, args = {}) => {
+      const network = String(args.network || "solana-mainnet");
+      const helius2 = network === "solana-mainnet" ? getHeliusFallbackClient() : null;
+      if (!helius2) return definition.handler(clientParam, args);
+      let alchemyError = new Error("Alchemy API key not configured");
+      const client2 = resolveClient4(clientParam);
+      if (client2) {
+        try {
+          const result2 = await client2.rpc(network, method, paramsBuilder(args), {
+            timeout: ALCHEMY_SOLANA_INDEXER_TIMEOUT_MS,
+            skipRetry: true
+          });
+          return createSuccessResponse6(shapeRpcResult(name, network, result2));
+        } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          if (classifyRuntimeStatusFromError(message) === "invalid_input") {
+            return createErrorResponse6(
+              error,
+              name,
+              "Check JSON-RPC params and network support.",
+              args
+            );
+          }
+          alchemyError = error;
+        }
+      }
+      const request = toHeliusRequest(method, paramsBuilder(args));
+      try {
+        const result2 = await helius2.request(
+          request.method,
+          request.params
+        );
+        const reason = alchemyError instanceof Error ? alchemyError.message : String(alchemyError);
+        const shaped = shapeRpcResult(name, network, result2);
+        const payload = shaped && typeof shaped === "object" && !Array.isArray(shaped) ? { ...shaped } : { result: shaped };
+        return {
+          ...createSuccessResponse6({
+            ...payload,
+            _fallback: {
+              provider: "Helius",
+              method: request.method,
+              reason: `Alchemy ${method} unavailable: ${reason.slice(0, 160)}`
+            }
+          }),
+          _hiveExec: { source: "fallback", originSource: "fallback" }
+        };
+      } catch (heliusError) {
+        const heliusMessage = heliusError instanceof Error ? heliusError.message : String(heliusError);
+        const alchemyMessage = alchemyError instanceof Error ? alchemyError.message : String(alchemyError);
+        return createErrorResponse6(
+          new Error(
+            `${alchemyMessage}; Helius fallback (${request.method}) also failed: ${heliusMessage}`
+          ),
+          name,
+          "Check JSON-RPC params and network support.",
+          args
+        );
+      }
+    }
+  };
+}
 function dasTool(key, name, description, method, properties, required = [], schemaExtensions = {}) {
-  return rpcTool(
-    key,
-    name,
-    `${description} Uses Alchemy's Solana Digital Asset Standard (DAS) API.`,
-    method,
-    {
-      network: {
-        type: "string",
-        enum: ["solana-mainnet", "solana-devnet"],
-        default: "solana-mainnet",
-        description: "Alchemy Solana network slug."
+  const paramsBuilder = (args) => omitKeys(args, ["network"]);
+  return withSolanaIndexerFallback(
+    rpcTool(
+      key,
+      name,
+      `${description} Uses Alchemy's Solana Digital Asset Standard (DAS) API, with Helius as the mainnet fallback.`,
+      method,
+      {
+        network: {
+          type: "string",
+          enum: ["solana-mainnet", "solana-devnet"],
+          default: "solana-mainnet",
+          description: "Alchemy Solana network slug."
+        },
+        ...properties
       },
-      ...properties
-    },
-    (args) => omitKeys(args, ["network"]),
-    required,
-    { ...schemaExtensions, additionalProperties: false },
-    "solana-mainnet"
+      paramsBuilder,
+      required,
+      { ...schemaExtensions, additionalProperties: false },
+      "solana-mainnet"
+    ),
+    method,
+    paramsBuilder
   );
 }
 function photonTool(key, name, description, method, properties, paramsBuilder, required = [], schemaExtensions = {}) {
-  return rpcTool(
-    key,
-    name,
-    `${description} Uses Alchemy's Solana Photon/ZK Compression indexer.`,
-    method,
-    {
-      network: {
-        type: "string",
-        enum: ["solana-mainnet", "solana-devnet"],
-        default: "solana-mainnet",
-        description: "Alchemy Solana network slug."
+  return withSolanaIndexerFallback(
+    rpcTool(
+      key,
+      name,
+      `${description} Uses Alchemy's Solana Photon/ZK Compression indexer, with Helius as the mainnet fallback.`,
+      method,
+      {
+        network: {
+          type: "string",
+          enum: ["solana-mainnet", "solana-devnet"],
+          default: "solana-mainnet",
+          description: "Alchemy Solana network slug."
+        },
+        ...properties
       },
-      ...properties
-    },
-    paramsBuilder,
-    required,
-    { ...schemaExtensions, additionalProperties: false },
-    "solana-mainnet"
+      paramsBuilder,
+      required,
+      { ...schemaExtensions, additionalProperties: false },
+      "solana-mainnet"
+    ),
+    method,
+    paramsBuilder
   );
 }
 function requireExactlyOne(args, first, second) {
@@ -44865,8 +45062,16 @@ var definitions = [
         description: "Block context used for the simulation."
       }
     },
-    (args) => [args.format ?? "FLAT", args.transaction, args.blockTag ?? "latest"],
-    ["format", "transaction", "blockTag"]
+    // Alchemy's positional order is [transaction, blockTag, { format }]. Sending
+    // the format first made every call fail with "invalid 1st argument"
+    // (2026-09-24 sweep); format and blockTag have defaults, so neither is
+    // required.
+    (args) => [
+      args.transaction,
+      args.blockTag ?? "latest",
+      { format: args.format ?? "FLAT" }
+    ],
+    ["transaction"]
   ),
   rpcTool(
     "simulateAssetChangesBundle",
@@ -46235,6 +46440,42 @@ var HyperliquidAPI = class {
 
 // src/tools/hyperliquid/infoTools.ts
 var MAX_ARRAY_ITEMS = 500;
+var SPOT_TOKEN_TTL_MS = 10 * 60 * 1e3;
+var spotTokenCache = null;
+async function listSpotTokens(api) {
+  if (spotTokenCache && Date.now() - spotTokenCache.at < SPOT_TOKEN_TTL_MS) {
+    return spotTokenCache.tokens;
+  }
+  const meta2 = await api.info({ type: "spotMeta" });
+  const tokens = (meta2?.tokens ?? []).flatMap(
+    (token) => typeof token.name === "string" && typeof token.tokenId === "string" ? [
+      {
+        name: token.name,
+        tokenId: token.tokenId,
+        index: typeof token.index === "number" ? token.index : void 0
+      }
+    ] : []
+  );
+  spotTokenCache = { at: Date.now(), tokens };
+  return tokens;
+}
+async function resolveSpotTokenId(value, api) {
+  const raw = String(value).trim();
+  let tokens;
+  try {
+    tokens = await listSpotTokens(api);
+  } catch {
+    return raw;
+  }
+  const lower = raw.toLowerCase();
+  const match = tokens.find((token) => token.tokenId.toLowerCase() === lower) ?? tokens.find((token) => token.name.toLowerCase() === lower) ?? (/^\d+$/.test(raw) ? tokens.find((token) => token.index === Number(raw)) : void 0);
+  if (!match) {
+    throw new Error(
+      `Invalid arguments: unknown Hyperliquid spot token '${raw}'. Pass a tokenId from hyperliquid_get_spot_meta tokens[].tokenId (USDC is 0x6d1e7cde53ba9467b783cb7c530ce054) or a spot token name such as "HYPE".`
+    );
+  }
+  return match.tokenId;
+}
 var USER = {
   arg: "user",
   field: "user",
@@ -46738,8 +46979,9 @@ var HYPERLIQUID_INFO_DESCRIPTORS = [
         required: true,
         schema: {
           type: "string",
-          description: 'Token id in 34-character hexadecimal format (from hyperliquid_get_spot_meta tokens[].tokenId), e.g. "0x00000000000000000000000000000000".'
-        }
+          description: 'Token id in 34-character hexadecimal format (from hyperliquid_get_spot_meta tokens[].tokenId), e.g. "0x6d1e7cde53ba9467b783cb7c530ce054" (USDC). A spot token name such as "HYPE" is also accepted.'
+        },
+        resolve: resolveSpotTokenId
       }
     ]
   },
@@ -47103,7 +47345,8 @@ function getHyperliquidInfoEndpoints(api) {
           }
           continue;
         }
-        body[param.field] = param.coerce ? param.coerce(raw) : raw;
+        const coerced = param.coerce ? param.coerce(raw) : raw;
+        body[param.field] = param.resolve ? await param.resolve(coerced, api) : coerced;
       }
       const data = await api.info(body);
       const transformed = descriptor.transform ? descriptor.transform(data) : data;
@@ -48786,7 +49029,14 @@ function getArchiveClient() {
 // src/tools/archive/api.ts
 var DEFAULT_LIMIT2 = 100;
 var MAX_LIMIT2 = 500;
-var ARCHIVE_SINCE_NOTE = "archive since 2023-11";
+var ARCHIVE_SINCE = {
+  funding: "2023-11",
+  open_interest: "2025-04",
+  basis: "2025-03",
+  long_short: "2026-03",
+  liquidations: "2025-04"
+};
+var ARCHIVE_SINCE_NOTE = `archive since ${ARCHIVE_SINCE.funding}`;
 var QUERY_TIMEOUT_MS = 1e4;
 var VENUE_SCAN_MAX_STEPS = 64;
 var COVERAGE_CACHE_TTL_MS = 10 * 60 * 1e3;
@@ -49080,7 +49330,7 @@ function historyHandler(toolName, dataset, options) {
         dataset: spec.table,
         runtime_status: "ok",
         fetched_at: (/* @__PURE__ */ new Date()).toISOString(),
-        note: options?.extraNote ? `${ARCHIVE_SINCE_NOTE}. ${options.extraNote}` : ARCHIVE_SINCE_NOTE,
+        note: options?.extraNote ? `archive since ${ARCHIVE_SINCE[dataset]}. ${options.extraNote}` : `archive since ${ARCHIVE_SINCE[dataset]}`,
         filters,
         order: `${spec.tsColumn} desc`,
         returnedCount: mapped.length,
@@ -53889,7 +54139,7 @@ var PROVIDER_CATALOG = [
     id: "archive",
     name: "Hive Archive",
     prefix: "archive_",
-    type: "Cross-venue crypto derivatives history since 2023-11 (33 CEX+DEX venues): funding-rate settlements, open interest, basis, long/short ratio, and liquidations from Hive's own archive store",
+    type: "Cross-venue crypto derivatives history from Hive's own archive store: funding-rate settlements across 33 CEX+DEX venues since 2023-11, basis since 2025-03, open interest and liquidations since 2025-04, and long/short ratio since 2026-03",
     clientStrategy: "internal",
     credentialRequirement: {
       label: "SHARPE_ARCHIVE_SUPABASE_URL and SHARPE_ARCHIVE_SUPABASE_SERVICE_ROLE_KEY",
@@ -54089,6 +54339,199 @@ function normalizeEndpointSchema(endpoint) {
   };
 }
 
+// src/config/retiredTools.ts
+var RETIRED_TOOLS_DATE = "2026-09-06";
+var RETIRED_TOOL_REPLACEMENTS = {
+  // wallet
+  codex_filter_wallets_by_network: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  codex_get_wallet_aggregate_backfill_state: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  codex_get_wallet_label_types: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  filter_network_wallets: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  filter_token_wallets: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  filter_wallets: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  get_wallet_balances: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  get_wallet_chart: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  get_wallet_stats: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  get_wallet_token_events: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  // holders
+  get_token_holders: "Use get_token_top_holders for holders on any network, coingecko_get_onchain_token_top_traders for traders where CoinGecko serves them (base and similar; not Ethereum on the current plan), or moralis_get_token_holder_metrics for holder metrics.",
+  get_token_top_traders: "Use get_token_top_holders for holders on any network, coingecko_get_onchain_token_top_traders for traders where CoinGecko serves them (base and similar; not Ethereum on the current plan), or moralis_get_token_holder_metrics for holder metrics.",
+  get_top_holders_percentage: "Use get_token_top_holders for holders on any network, coingecko_get_onchain_token_top_traders for traders where CoinGecko serves them (base and similar; not Ethereum on the current plan), or moralis_get_token_holder_metrics for holder metrics.",
+  // pairs
+  codex_get_detailed_token_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  codex_get_windowed_pair_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  filter_pairs: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  get_detailed_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  get_latest_pairs: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  get_liquidity_info: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  get_pair_chart_metadata: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  get_pair_info: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  get_pair_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  get_pairs_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  get_token_liquidity_metadata: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  get_token_pairs: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  get_token_pairs_metadata: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
+  // charts
+  codex_get_bars: "Use get_token_ohlcv, get_pool_ohlcv, or moralis_get_pair_ohlcv for candles.",
+  codex_get_token_bars: "Use get_token_ohlcv, get_pool_ohlcv, or moralis_get_pair_ohlcv for candles.",
+  get_token_chart_data: "Use get_token_ohlcv, get_pool_ohlcv, or moralis_get_pair_ohlcv for candles.",
+  get_token_chart_urls: "Use get_token_ohlcv, get_pool_ohlcv, or moralis_get_pair_ohlcv for candles.",
+  get_token_sparklines: "Use get_token_ohlcv, get_pool_ohlcv, or moralis_get_pair_ohlcv for candles.",
+  // price
+  codex_get_token_price: "Use alchemy_get_token_prices_by_address or get_onchain_token_price for on-chain token prices.",
+  // tokens
+  codex_filter_launchpads: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
+  filter_tokens: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
+  get_new_tokens: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
+  get_token_details: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
+  get_token_transactions: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
+  get_tokens: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
+  list_top_tokens: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
+  search_tokens: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
+  // network
+  codex_get_blocks: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
+  codex_get_network_configs: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
+  filter_exchanges: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
+  filter_networks: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
+  get_network_dexes: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
+  get_network_stats: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
+  get_network_status: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
+  get_networks_list: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
+  // locks
+  get_liquidity_locks: "Use get_token_lock_info or the goplus_get_lp_v3_locks and goplus_get_lp_v4_locks security tools for LP locks.",
+  // misc
+  codex_get_categories: "No direct replacement; use get_categories_market_data or moralis_get_entity_categories for category data.",
+  codex_get_category: "No direct replacement; use get_categories_market_data or moralis_get_entity_categories for category data.",
+  codex_get_category_tokens: "No direct replacement; use get_categories_market_data or moralis_get_entity_categories for category data.",
+  get_community_notes: "No direct replacement; use get_categories_market_data or moralis_get_entity_categories for category data.",
+  get_event_labels: "No direct replacement; use get_categories_market_data or moralis_get_entity_categories for category data."
+};
+var PREDICTION_REPLACEMENT = 'Prediction markets are served by first-party Polymarket tools since 1.7.0: polymarket_search_markets, polymarket_get_events, polymarket_get_market, polymarket_get_price_history, polymarket_get_orderbook, polymarket_get_wallet_positions, polymarket_get_wallet_activity. Kalshi is not covered. Start with search_tools({"query": "prediction markets"}) or hive://toolsets/prediction_markets.';
+var UNSERVABLE_TOOLS_DATE = "2026-09-24";
+var COINGECKO_ENTERPRISE = "because it needs a CoinGecko Enterprise plan, which Hive does not have";
+var COINGECKO_SUPPLY_REPLACEMENT = "Use get_coin_supply_breakdown for current circulating, total, and max supply, or get_coin_market_chart_range for a market-cap and price series.";
+var HELIUS_WALLET_PLAN = "because Helius answers 403 for it on Hive's current Helius plan";
+var DEFILLAMA_PRO = "because it needs a DeFiLlama Pro plan, which Hive does not have";
+var DEFILLAMA_DERIVATIVES_REPLACEMENT = "Use defillama_get_open_interest, defillama_get_derivatives_aggregator_volumes, or get_derivatives_exchanges for derivatives activity.";
+var ALCHEMY_PAYG = "because Alchemy offers it only on Pay As You Go and Enterprise plans, and Hive's key is on the Free tier";
+var ALCHEMY_BUNDLE_REPLACEMENT = "Use tenderly_simulate_bundle for multi-transaction simulation, or alchemy_simulate_asset_changes and alchemy_simulate_execution one transaction at a time.";
+var CCXT_PRIVATE = "because every exchange that serves it requires an authenticated exchange account";
+var CCXT_BORROW_REPLACEMENT = "Use ccxt_fetch_borrow_rate_history or ccxt_fetch_borrow_rate_histories (public) and read the latest point.";
+var UNSERVABLE_TOOLS = {
+  get_coin_circulating_supply_chart: {
+    reason: COINGECKO_ENTERPRISE,
+    replacement: COINGECKO_SUPPLY_REPLACEMENT
+  },
+  get_coin_circulating_supply_chart_range: {
+    reason: COINGECKO_ENTERPRISE,
+    replacement: COINGECKO_SUPPLY_REPLACEMENT
+  },
+  get_coin_total_supply_chart: {
+    reason: COINGECKO_ENTERPRISE,
+    replacement: COINGECKO_SUPPLY_REPLACEMENT
+  },
+  get_coin_total_supply_chart_range: {
+    reason: COINGECKO_ENTERPRISE,
+    replacement: COINGECKO_SUPPLY_REPLACEMENT
+  },
+  get_coin_insights: {
+    reason: COINGECKO_ENTERPRISE,
+    replacement: "No direct replacement; use get_coins_market_data and get_coin_tickers for the market facts behind an insight."
+  },
+  helius_get_wallet_identity: {
+    reason: HELIUS_WALLET_PLAN,
+    replacement: "No other wallet-identity source is live on Hive's plans; use helius_get_wallet_history or helius_get_transfers_by_address for the wallet's activity."
+  },
+  helius_get_wallet_batch_identity: {
+    reason: HELIUS_WALLET_PLAN,
+    replacement: "No other wallet-identity source is live on Hive's plans; use helius_get_wallet_history or helius_get_transfers_by_address for each wallet's activity."
+  },
+  helius_get_wallet_funded_by: {
+    reason: HELIUS_WALLET_PLAN,
+    replacement: "Use helius_get_wallet_transfers or helius_get_transfers_by_address and take the earliest inbound SOL transfer."
+  },
+  alchemy_simulate_asset_changes_bundle: {
+    reason: ALCHEMY_PAYG,
+    replacement: ALCHEMY_BUNDLE_REPLACEMENT
+  },
+  alchemy_simulate_execution_bundle: {
+    reason: ALCHEMY_PAYG,
+    replacement: ALCHEMY_BUNDLE_REPLACEMENT
+  },
+  defillama_get_derivatives_volumes: {
+    reason: DEFILLAMA_PRO,
+    replacement: DEFILLAMA_DERIVATIVES_REPLACEMENT
+  },
+  defillama_get_derivatives_volumes_by_chain: {
+    reason: DEFILLAMA_PRO,
+    replacement: DEFILLAMA_DERIVATIVES_REPLACEMENT
+  },
+  defillama_get_derivatives_volume: {
+    reason: DEFILLAMA_PRO,
+    replacement: DEFILLAMA_DERIVATIVES_REPLACEMENT
+  },
+  defillama_get_categories: {
+    reason: DEFILLAMA_PRO,
+    replacement: "Use get_categories_market_data for sector data, or get_defi_protocols, whose records carry each protocol's category."
+  },
+  defillama_get_oracles: {
+    reason: DEFILLAMA_PRO,
+    replacement: "Use get_defi_protocols or get_defi_protocol; protocol records list the oracles they use where DeFiLlama has them."
+  },
+  defillama_get_forks: {
+    reason: DEFILLAMA_PRO,
+    replacement: "Use get_defi_protocols; protocol records carry forkedFrom where DeFiLlama has it."
+  },
+  defillama_get_entities: {
+    reason: DEFILLAMA_PRO,
+    replacement: "Use get_entities_list or get_treasury_by_entity for public companies and their treasuries."
+  },
+  ccxt_fetch_cross_borrow_rates: {
+    reason: CCXT_PRIVATE,
+    replacement: CCXT_BORROW_REPLACEMENT
+  },
+  ccxt_fetch_cross_borrow_rate: {
+    reason: CCXT_PRIVATE,
+    replacement: CCXT_BORROW_REPLACEMENT
+  },
+  ccxt_fetch_isolated_borrow_rates: {
+    reason: CCXT_PRIVATE,
+    replacement: CCXT_BORROW_REPLACEMENT
+  },
+  goplus_simulate_solana_transaction: {
+    reason: 'because GoPlus answers "system error" to every Solana pre-execution request, including a fresh valid transfer',
+    replacement: "Use get_solana_token_security for the tokens the transaction touches; Hive has no other Solana pre-signing simulation."
+  }
+};
+function isUnservableTool(toolName) {
+  return Object.prototype.hasOwnProperty.call(UNSERVABLE_TOOLS, toolName);
+}
+function getRetiredTool(toolName) {
+  if (isUnservableTool(toolName)) {
+    const entry2 = UNSERVABLE_TOOLS[toolName];
+    return {
+      date: UNSERVABLE_TOOLS_DATE,
+      cause: entry2.reason,
+      replacement: entry2.replacement
+    };
+  }
+  const replacement = getRetiredToolReplacement(toolName);
+  return replacement ? {
+    date: RETIRED_TOOLS_DATE,
+    cause: "when the Codex.io provider was removed",
+    replacement
+  } : null;
+}
+function getRetiredToolReplacement(toolName) {
+  if (isUnservableTool(toolName)) return UNSERVABLE_TOOLS[toolName].replacement;
+  const direct = RETIRED_TOOL_REPLACEMENTS[toolName];
+  if (direct) return direct;
+  if (/^codex_/.test(toolName)) {
+    return PREDICTION_REPLACEMENT;
+  }
+  return null;
+}
+
 // src/wrapper/index.ts
 var CHARACTER_LIMIT = 1e5;
 var ANNOTATION_HEADROOM = 1024;
@@ -54479,6 +54922,7 @@ function createSafeHandler(handler96, metadata100, toolName) {
       }
       let result2 = await handler96(effectiveClient, safeArgs);
       const observedAt = (/* @__PURE__ */ new Date()).toISOString();
+      if (result2._hiveExec?.source === "fallback") usedFallback = true;
       if (!result2.isError && credentialRequirement && !credentialRequirement.isConfigured() && result2?.content?.[0]?.type === "text" && result2.content[0].text) {
         const rawText = result2.content[0].text;
         let warningText;
@@ -54805,7 +55249,7 @@ function getAllWrappedEndpoints() {
       }
     }
   }
-  _wrappedEndpointsCache = updatedTools.map(normalizeEndpointSchema).map((endpoint) => ({
+  _wrappedEndpointsCache = updatedTools.filter((endpoint) => !isUnservableTool(endpoint.tool.name)).map(normalizeEndpointSchema).map((endpoint) => ({
     ...endpoint,
     tool: withResponseHeadroomMeta(endpoint.tool)
   }));
@@ -54829,7 +55273,7 @@ var ToolRegistry = [
   {
     category: "Market Data and Price",
     name: "get_market_and_price_endpoints",
-    description: "Endpoints to retrieve real-time and historical cryptocurrency prices, market caps, trading volumes, OHLC data, global market statistics, supported currencies, basic market performance metrics across different timeframes and asset platforms, stablecoin market analytics, stablecoin price tracking, comprehensive stablecoin market cap data across multiple chains, centralized exchange (CEX) trading data including real-time tickers, order books, recent trades, candlestick charts, best bid/ask prices, CEX exchange metadata and volume charts, derivatives pricing (index, mark, and premium), perpetual futures funding rates, leverage tiers, options trading analytics, and available trading markets/currencies across major exchanges. Provider guide: Use coingecko tools for market-wide price data. Use ccxt_ tools for CEX trading data. Use alchemy_ tools for supported token price reads and EVM gas data. Use archive_ tools for cross-venue derivatives HISTORY (funding settlements, open interest, basis, long/short ratio, liquidations) since 2023-11.",
+    description: "Endpoints to retrieve real-time and historical cryptocurrency prices, market caps, trading volumes, OHLC data, global market statistics, supported currencies, basic market performance metrics across different timeframes and asset platforms, stablecoin market analytics, stablecoin price tracking, comprehensive stablecoin market cap data across multiple chains, centralized exchange (CEX) trading data including real-time tickers, order books, recent trades, candlestick charts, best bid/ask prices, CEX exchange metadata and volume charts, derivatives pricing (index, mark, and premium), perpetual futures funding rates, leverage tiers, options trading analytics, and available trading markets/currencies across major exchanges. Provider guide: Use coingecko tools for market-wide price data. Use ccxt_ tools for CEX trading data. Use alchemy_ tools for supported token price reads and EVM gas data. Use archive_ tools for cross-venue derivatives HISTORY: funding settlements since 2023-11; open interest, basis, long/short ratio and liquidations over shorter windows (archive_get_coverage gives exact depth).",
     tools: [
       "get_coins_index",
       "get_coins_market_data",
@@ -54852,11 +55296,6 @@ var ToolRegistry = [
       "get_global_market_cap_chart",
       "get_coin_ohlc",
       "get_coin_ohlc_range",
-      "get_coin_insights",
-      "get_coin_circulating_supply_chart",
-      "get_coin_circulating_supply_chart_range",
-      "get_coin_total_supply_chart",
-      "get_coin_total_supply_chart_range",
       "get_rwa_list",
       "get_rwa_markets",
       "get_rwa_asset",
@@ -54981,9 +55420,6 @@ var ToolRegistry = [
       "ccxt_fetch_convert_quote",
       "ccxt_fetch_borrow_rate_history",
       "ccxt_fetch_borrow_rate_histories",
-      "ccxt_fetch_cross_borrow_rates",
-      "ccxt_fetch_cross_borrow_rate",
-      "ccxt_fetch_isolated_borrow_rates",
       "ccxt_fetch_funding_rates_multi",
       "ccxt_fetch_open_interest_multi",
       "alchemy_get_token_prices_by_symbol",
@@ -55142,13 +55578,10 @@ var ToolRegistry = [
       "helius_get_parsed_address_transactions",
       "helius_get_parsed_events_transactions",
       "helius_get_parsed_events_transaction_history",
-      "helius_get_wallet_identity",
-      "helius_get_wallet_batch_identity",
       "helius_get_wallet_balances",
       "helius_get_wallet_balance_at",
       "helius_get_wallet_history",
       "helius_get_wallet_transfers",
-      "helius_get_wallet_funded_by",
       "helius_get_transactions_for_address",
       "helius_get_transfers_by_address"
     ]
@@ -55233,13 +55666,6 @@ var ToolRegistry = [
       "defillama_get_open_interest_by_chain",
       "defillama_get_open_interest_protocol",
       // Coverage wave 1: perps-protocol volumes + protocol metadata
-      "defillama_get_derivatives_volumes",
-      "defillama_get_derivatives_volumes_by_chain",
-      "defillama_get_derivatives_volume",
-      "defillama_get_categories",
-      "defillama_get_oracles",
-      "defillama_get_forks",
-      "defillama_get_entities",
       // Moralis DeFi / volume analytics
       "moralis_get_defi_positions_by_protocol",
       "moralis_get_supported_defi_protocols",
@@ -55345,7 +55771,6 @@ var ToolRegistry = [
       "goplus_detect_dust_attack",
       "goplus_start_address_scan",
       "goplus_get_address_scan_result",
-      "goplus_simulate_solana_transaction",
       "goplus_get_lp_v4_lock",
       "goplus_get_lp_v4_locks",
       "goplus_get_lp_v3_lock",
@@ -55375,9 +55800,7 @@ var ToolRegistry = [
       "tenderly_get_transactions_range",
       "alchemy_get_token_allowance",
       "alchemy_simulate_asset_changes",
-      "alchemy_simulate_execution",
-      "alchemy_simulate_asset_changes_bundle",
-      "alchemy_simulate_execution_bundle"
+      "alchemy_simulate_execution"
     ]
   },
   {
@@ -57087,83 +57510,6 @@ function clientProfileFromName(raw) {
   return normalizeClientName(raw).profile;
 }
 
-// src/config/retiredTools.ts
-var RETIRED_TOOLS_DATE = "2026-09-06";
-var RETIRED_TOOL_REPLACEMENTS = {
-  // wallet
-  codex_filter_wallets_by_network: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  codex_get_wallet_aggregate_backfill_state: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  codex_get_wallet_label_types: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  filter_network_wallets: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  filter_token_wallets: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  filter_wallets: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  get_wallet_balances: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  get_wallet_chart: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  get_wallet_stats: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  get_wallet_token_events: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  // holders
-  get_token_holders: "Use get_token_top_holders for holders on any network, coingecko_get_onchain_token_top_traders for traders where CoinGecko serves them (base and similar; not Ethereum on the current plan), or moralis_get_token_holder_metrics for holder metrics.",
-  get_token_top_traders: "Use get_token_top_holders for holders on any network, coingecko_get_onchain_token_top_traders for traders where CoinGecko serves them (base and similar; not Ethereum on the current plan), or moralis_get_token_holder_metrics for holder metrics.",
-  get_top_holders_percentage: "Use get_token_top_holders for holders on any network, coingecko_get_onchain_token_top_traders for traders where CoinGecko serves them (base and similar; not Ethereum on the current plan), or moralis_get_token_holder_metrics for holder metrics.",
-  // pairs
-  codex_get_detailed_token_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  codex_get_windowed_pair_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  filter_pairs: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  get_detailed_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  get_latest_pairs: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  get_liquidity_info: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  get_pair_chart_metadata: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  get_pair_info: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  get_pair_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  get_pairs_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  get_token_liquidity_metadata: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  get_token_pairs: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  get_token_pairs_metadata: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
-  // charts
-  codex_get_bars: "Use get_token_ohlcv, get_pool_ohlcv, or moralis_get_pair_ohlcv for candles.",
-  codex_get_token_bars: "Use get_token_ohlcv, get_pool_ohlcv, or moralis_get_pair_ohlcv for candles.",
-  get_token_chart_data: "Use get_token_ohlcv, get_pool_ohlcv, or moralis_get_pair_ohlcv for candles.",
-  get_token_chart_urls: "Use get_token_ohlcv, get_pool_ohlcv, or moralis_get_pair_ohlcv for candles.",
-  get_token_sparklines: "Use get_token_ohlcv, get_pool_ohlcv, or moralis_get_pair_ohlcv for candles.",
-  // price
-  codex_get_token_price: "Use alchemy_get_token_prices_by_address or get_onchain_token_price for on-chain token prices.",
-  // tokens
-  codex_filter_launchpads: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
-  filter_tokens: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
-  get_new_tokens: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
-  get_token_details: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
-  get_token_transactions: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
-  get_tokens: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
-  list_top_tokens: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
-  search_tokens: "Use get_token_info, alchemy_get_token_metadata, moralis_search_tokens, get_new_pools, or get_token_trades for token discovery and activity.",
-  // network
-  codex_get_blocks: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
-  codex_get_network_configs: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
-  filter_exchanges: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
-  filter_networks: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
-  get_network_dexes: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
-  get_network_stats: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
-  get_network_status: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
-  get_networks_list: "Use get_networks, tenderly_get_supported_networks, alchemy_get_block_by_number, or get_dexes for network and DEX reads.",
-  // locks
-  get_liquidity_locks: "Use get_token_lock_info or the goplus_get_lp_v3_locks and goplus_get_lp_v4_locks security tools for LP locks.",
-  // misc
-  codex_get_categories: "No direct replacement; use get_categories_market_data or moralis_get_entity_categories for category data.",
-  codex_get_category: "No direct replacement; use get_categories_market_data or moralis_get_entity_categories for category data.",
-  codex_get_category_tokens: "No direct replacement; use get_categories_market_data or moralis_get_entity_categories for category data.",
-  get_community_notes: "No direct replacement; use get_categories_market_data or moralis_get_entity_categories for category data.",
-  get_event_labels: "No direct replacement; use get_categories_market_data or moralis_get_entity_categories for category data."
-};
-var PREDICTION_REPLACEMENT = 'Prediction markets are served by first-party Polymarket tools since 1.7.0: polymarket_search_markets, polymarket_get_events, polymarket_get_market, polymarket_get_price_history, polymarket_get_orderbook, polymarket_get_wallet_positions, polymarket_get_wallet_activity. Kalshi is not covered. Start with search_tools({"query": "prediction markets"}) or hive://toolsets/prediction_markets.';
-function getRetiredToolReplacement(toolName) {
-  const direct = RETIRED_TOOL_REPLACEMENTS[toolName];
-  if (direct) return direct;
-  if (/^codex_/.test(toolName)) {
-    return PREDICTION_REPLACEMENT;
-  }
-  return null;
-}
-
 // src/services/tool-execution-pipeline.ts
 function isToolExecutionBilling(value) {
   return typeof value === "object" && value !== null && value.type === "billing";
@@ -57326,6 +57672,27 @@ function createHiveExecutionMetadata(endpoint, durationMs, runtimeStatus, source
 function unchargedCredit(context) {
   return context.creditCost === void 0 ? {} : { creditCost: context.creditCost, creditsUsed: 0 };
 }
+var FAILED_CALL_REFUND_WARNING = "This call failed, so the credit it used was refunded.";
+async function refundFailedCall(billing, toolName, runtimeStatus, warnings) {
+  if (!billing?.refund || billing.credits_used <= 0) return billing;
+  try {
+    const outcome = await billing.refund({ toolName, runtimeStatus });
+    if (!outcome.refunded) return billing;
+    warnings.push(FAILED_CALL_REFUND_WARNING);
+    return {
+      ...billing,
+      credits_used: 0,
+      ...outcome.creditsRemaining !== void 0 && {
+        credits_remaining: outcome.creditsRemaining
+      }
+    };
+  } catch (error) {
+    secureLogger.error("Credit refund for a failed call failed", error, {
+      toolName
+    });
+    return billing;
+  }
+}
 function chargedCredit(context, billing) {
   if (context.creditCost === void 0 && !billing) return {};
   return {
@@ -57484,9 +57851,10 @@ function unavailableReplacementNote(guidance) {
   ).join(" ");
 }
 function createToolNotFoundResult(toolName, durationMs = 0) {
-  const retired = getRetiredToolReplacement(toolName);
+  const retiredTool = getRetiredTool(toolName);
+  const retired = retiredTool?.replacement ?? null;
   const availabilityNote = retired ? unavailableReplacementNote(retired) : "";
-  const message = retired ? `Tool '${toolName}' was retired on ${RETIRED_TOOLS_DATE}. ${retired}${availabilityNote}` : `Tool '${toolName}' not found.`;
+  const message = retiredTool ? `Tool '${toolName}' was retired on ${retiredTool.date}. ${retired}${availabilityNote}` : `Tool '${toolName}' not found.`;
   const errorCode = retired ? "TOOL_RETIRED" : "TOOL_NOT_FOUND";
   const mcpResult = createErrorResponse7(errorCode, message);
   const hive = {
@@ -57514,7 +57882,7 @@ function createToolNotFoundResult(toolName, durationMs = 0) {
     warnings: [
       retired ? "Tool name was retired; the replacement is named in the message." : "Tool name did not resolve to a Hive endpoint."
     ],
-    cause: retired ? `Tool '${toolName}' was retired on ${RETIRED_TOOLS_DATE} when the Codex.io provider was removed; nothing was executed.` : `Tool '${toolName}' does not resolve to a Hive endpoint; nothing was executed.`,
+    cause: retiredTool ? `Tool '${toolName}' was retired on ${retiredTool.date} ${retiredTool.cause}; nothing was executed.` : `Tool '${toolName}' does not resolve to a Hive endpoint; nothing was executed.`,
     next_action: retired ? `${retired}${availabilityNote} Call search_tools with your task if that tool does not fit.` : "Call search_tools (or a category endpoint tools/list) to find the exact endpoint name, then retry with that name."
   };
   const enrichedMcpResult = attachHiveMetadata(mcpResult, hive);
@@ -57921,6 +58289,14 @@ async function executeEndpoint(endpoint, args, context) {
         );
       }
     }
+    if (normalized.isError) {
+      billing = await refundFailedCall(
+        billing,
+        endpoint.tool.name,
+        runtimeStatus,
+        guardWarnings
+      );
+    }
     const durationMs = Date.now() - start;
     const hive = createHiveExecutionMetadata(
       endpoint,
@@ -58000,12 +58376,21 @@ async function executeEndpoint(endpoint, args, context) {
       endpoint.tool.name,
       args
     );
+    const thrownWarnings = [
+      "Tool execution threw before returning a provider result."
+    ];
+    billing = await refundFailedCall(
+      billing,
+      endpoint.tool.name,
+      runtimeStatus,
+      thrownWarnings
+    );
     const hive = createHiveExecutionMetadata(
       endpoint,
       durationMs,
       runtimeStatus,
       "unavailable",
-      ["Tool execution threw before returning a provider result."],
+      thrownWarnings,
       void 0,
       {
         input: args ?? {},
@@ -59369,7 +59754,7 @@ var TASK_TOOLSET_ROUTES = {
     {
       id: "transaction_readiness",
       label: "Solana transaction readiness",
-      trigger: "Solana transaction details, priority fee, compression context, or pre-execution risk.",
+      trigger: "Solana transaction details, priority fee, compression context, or the risk of the tokens it touches.",
       exampleQuestion: "Inspect this Solana transaction and tell me whether the proposed call looks safe.",
       requiredIdentifiers: ["transaction signature or serialized transaction"],
       maxMaterialCalls: 4,
@@ -59389,12 +59774,12 @@ var TASK_TOOLSET_ROUTES = {
         ),
         step(
           "risk",
-          "Simulate a serialized transaction without broadcasting.",
-          "goplus_simulate_solana_transaction",
+          "Check GoPlus token security for the mints the transaction touches.",
+          "get_solana_token_security",
           null
         )
       ],
-      stopCondition: "Stop after transaction context and the requested fee or simulation check; never submit the transaction."
+      stopCondition: "Stop after transaction context and the requested fee or token security check; never submit the transaction."
     }
   ],
   rwa_perp_analysis: [
@@ -59751,10 +60136,8 @@ var TASK_TOOLSET_CATALOG = [
       "hyperliquid_get_outcome_meta",
       "hyperliquid_get_all_borrow_lend_reserve_states",
       "ccxt_fetch_option_chain",
-      "ccxt_fetch_cross_borrow_rates",
       "get_exchange_tickers",
-      "get_supported_currencies",
-      "get_coin_insights"
+      "get_supported_currencies"
     ],
     stableFixtures: [
       {
@@ -59829,11 +60212,7 @@ var TASK_TOOLSET_CATALOG = [
       "get_contract_coin",
       "coingecko_get_onchain_token_top_traders",
       "get_solana_token_security",
-      "get_coin_supply_breakdown",
-      "get_coin_circulating_supply_chart",
-      "get_coin_circulating_supply_chart_range",
-      "get_coin_total_supply_chart",
-      "get_coin_total_supply_chart_range"
+      "get_coin_supply_breakdown"
     ],
     stableFixtures: [
       {
@@ -59982,10 +60361,7 @@ var TASK_TOOLSET_CATALOG = [
       "alchemy_solana_get_latest_non_voting_signatures",
       "alchemy_simulate_asset_changes",
       "alchemy_simulate_execution",
-      "alchemy_simulate_asset_changes_bundle",
-      "alchemy_simulate_execution_bundle",
       "simulate_evm_transaction",
-      "goplus_simulate_solana_transaction",
       "defillama_get_hacks"
     ],
     fallbackTools: [
@@ -60105,8 +60481,6 @@ var TASK_TOOLSET_CATALOG = [
       "defillama_get_bridge_aggregator_volumes",
       "defillama_get_bridge_aggregator_volumes_by_chain",
       "get_dex_volumes",
-      "defillama_get_derivatives_volumes",
-      "defillama_get_derivatives_volume",
       "moralis_get_supported_defi_protocols",
       "moralis_get_wallet_defi_positions"
     ],
@@ -60118,12 +60492,7 @@ var TASK_TOOLSET_CATALOG = [
       "get_chains_tvl_history",
       "get_stablecoin_chains",
       "stablecoin_data_by_id",
-      "get_fees_overview",
-      "defillama_get_derivatives_volumes_by_chain",
-      "defillama_get_categories",
-      "defillama_get_oracles",
-      "defillama_get_forks",
-      "defillama_get_entities"
+      "get_fees_overview"
     ],
     stableFixtures: [
       {
@@ -60309,12 +60678,10 @@ var TASK_TOOLSET_CATALOG = [
       "moralis_get_sol_token_prices_batch",
       "moralis_get_token_analytics_timeseries",
       "moralis_get_sol_token_swaps",
-      "get_solana_token_security",
-      "goplus_simulate_solana_transaction"
+      "get_solana_token_security"
     ],
     fallbackTools: [
       "get_token_top_holders",
-      "helius_get_wallet_identity",
       "helius_get_wallet_history",
       "helius_get_program_accounts_v2",
       "helius_get_parsed_transactions",
@@ -65630,8 +65997,9 @@ var FULL_MODE_DEFAULT_ARGS = {
     user: HYPERLIQUID_USER,
     builder: HYPERLIQUID_USER,
     vault_address: HYPERLIQUID_HLP_VAULT,
-    // Spot token index 0 (USDC) — canonical 34-char zero tokenId.
-    token_id: "0x00000000000000000000000000000000",
+    // USDC's real tokenId (spotMeta tokens[0]); the all-zero id is unknown to
+    // Hyperliquid and answers 500.
+    token_id: "0x6d1e7cde53ba9467b783cb7c530ce054",
     token: 0,
     // First HIP-4 outcome market id.
     outcome: 0
@@ -66135,9 +66503,11 @@ var TOOL_PROBE_ARGS = {
     network: "mainnet",
     input: `${ERC20_TRANSFER_SELECTOR}${"0".repeat(128)}`
   },
+  // A plain zero-value transfer between EOAs: a call into USDC with empty
+  // calldata reverts, and estimateGas reports a revert as an error.
   tenderly_node_estimate_gas: {
     network: "mainnet",
-    transaction: { from: ETH_WALLET, to: ETH_USDC, data: "0x" },
+    transaction: { from: ETH_WALLET, to: MORALIS_EVM_WALLET, value: "0x0" },
     block_number: "latest"
   },
   tenderly_node_simulate_transaction: {
@@ -66160,10 +66530,16 @@ var TOOL_PROBE_ARGS = {
     network: "mainnet",
     data: "0x08c379a0"
   },
+  // A complete ERC-20 Transfer log (from, to indexed; amount in data). The
+  // signature topic alone with empty data is rejected as bad input.
   tenderly_decode_event: {
     network: "mainnet",
-    topics: [ERC20_TRANSFER_TOPIC],
-    data: "0x"
+    topics: [
+      ERC20_TRANSFER_TOPIC,
+      "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",
+      "0x000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
+    ],
+    data: "0x00000000000000000000000000000000000000000000000000000000000f4240"
   },
   tenderly_get_error_signatures: {
     network: "mainnet",
@@ -66456,9 +66832,10 @@ var TOOL_PROBE_ARGS = {
     page: 1,
     limit: 1
   },
+  // DAS asset signatures are defined for compressed assets.
   alchemy_solana_get_asset_signatures: {
     network: "solana-mainnet",
-    id: SOL_HELIUS_ASSET,
+    id: SOL_COMPRESSED_ASSET,
     page: 1,
     limit: 1
   },
@@ -66935,6 +67312,32 @@ function extractGoPlusAddressScanArgs(response) {
   );
   return requestId ? { request_id: requestId } : null;
 }
+function findFirstObjectWithKey(value, keys) {
+  if (!value || typeof value !== "object") return null;
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const found = findFirstObjectWithKey(item, keys);
+      if (found) return found;
+    }
+    return null;
+  }
+  const obj = value;
+  if (keys.some((key) => typeof obj[key] === "string")) return obj;
+  for (const child of Object.values(obj)) {
+    const found = findFirstObjectWithKey(child, keys);
+    if (found) return found;
+  }
+  return null;
+}
+function firstString(value, keys) {
+  const obj = findFirstObjectWithKey(value, keys);
+  if (!obj) return void 0;
+  for (const key of keys) {
+    const candidate = obj[key];
+    if (typeof candidate === "string" && candidate) return candidate;
+  }
+  return void 0;
+}
 function getCachedDynamicArgs(cacheKey2, resolver) {
   const cached = dynamicProbeArgCache.get(cacheKey2);
   if (cached) return cached;
@@ -66996,6 +67399,29 @@ async function getCcxtSettlementArgs(clients) {
     return { exchange: "okx", symbol, limit: 10 };
   });
 }
+var HIVE_FIXTURE_MISSING = "No Hive fixture";
+var HIVE_ID_FIXTURES = {
+  hive_get_monitor: {
+    listTool: "hive_list_monitors",
+    field: "monitor_id",
+    keys: ["monitor_id", "id"]
+  },
+  hive_get_latest_snapshot: {
+    listTool: "hive_list_monitors",
+    field: "monitor_id",
+    keys: ["monitor_id", "id"]
+  },
+  hive_generate_monitor_report: {
+    listTool: "hive_list_monitors",
+    field: "monitor_id",
+    keys: ["monitor_id", "id"]
+  },
+  hive_get_subject: {
+    listTool: "hive_list_subjects",
+    field: "subject_id",
+    keys: ["subject_id", "id"]
+  }
+};
 async function getEffectiveProbeArgs(toolName, provider, clients, args) {
   if (args) return args;
   if (toolName === "ccxt_fetch_option" || toolName === "ccxt_fetch_greeks") {
@@ -67032,7 +67458,28 @@ async function getEffectiveProbeArgs(toolName, provider, clients, args) {
     return fixture;
   }
   if (provider === "hive") {
-    return {};
+    const idFixture = HIVE_ID_FIXTURES[toolName];
+    if (!idFixture) return {};
+    return getCachedDynamicArgs(`hive:${idFixture.listTool}`, async () => {
+      const listEndpoint = getAllWrappedEndpoints().find(
+        (endpoint) => endpoint.tool.name === idFixture.listTool
+      );
+      if (!listEndpoint) {
+        throw new Error(`${HIVE_FIXTURE_MISSING}: ${idFixture.listTool} is not registered`);
+      }
+      const context = await getHiveCanarySubjectContext();
+      const listed = await runWithSubjectContext(
+        context,
+        () => listEndpoint.handler(null, { limit: 1 })
+      );
+      const id = firstString(parseToolResponseJson(listed), idFixture.keys);
+      if (!id) {
+        throw new Error(
+          `${HIVE_FIXTURE_MISSING}: the canary subject has no ${idFixture.field.replace("_id", "")} to read yet`
+        );
+      }
+      return { [idFixture.field]: id };
+    });
   }
   const toolFixture = TOOL_PROBE_ARGS[toolName];
   if (toolFixture) return toolFixture;
@@ -67129,6 +67576,14 @@ async function runEndpointProbe(endpoint, provider, clients, args, timeoutMs = P
       return { name: toolName, status: "passed", duration };
     } catch (err) {
       const errorMsg = err instanceof Error ? err.message : "Unknown error";
+      if (errorMsg.startsWith(HIVE_FIXTURE_MISSING)) {
+        return {
+          name: toolName,
+          status: "skipped",
+          duration: Date.now() - start,
+          error: errorMsg
+        };
+      }
       if (shouldRetryGoPlusRateLimit(provider, errorMsg, attempt, maxAttempts)) {
         await delay(GOPLUS_RATE_LIMIT_RETRY_DELAY_MS * attempt);
         continue;
@@ -70036,7 +70491,7 @@ function dynamicTools(endpoints, options = {}) {
     tool: {
       name: "get_api_endpoint_schema",
       title: "API Endpoint Schema",
-      description: "Returns the full input schema, operation type, and correct root invoker for any Hive tool by name. Call a category tool first to discover available tool names, then inspect this contract before execution.",
+      description: "Returns the full input schema, operation type, and correct root invoker for any Hive tool by name. Tool names come from search_tools; inspect this contract before execution.",
       inputSchema: {
         ...zodToInputSchema2(getEndpointSchema),
         additionalProperties: true
@@ -70045,18 +70500,13 @@ function dynamicTools(endpoints, options = {}) {
       annotations: READ_ONLY_ANNOTATIONS
     },
     handler: async (_client, args) => {
-      if (!args) {
-        return errorResult6(
-          "No endpoint provided. Pass an 'endpoint' (or 'endpoint_name') parameter with the tool name."
-        );
-      }
-      const parsedEndpointArgs = getEndpointSchema.parse(args);
+      const missingEndpoint = "Invalid arguments: no endpoint provided. Pass an 'endpoint' (or 'endpoint_name') parameter with one tool name as a string.";
+      if (!args) return errorResult6(missingEndpoint);
+      const parsedArgs = getEndpointSchema.safeParse(args);
+      if (!parsedArgs.success) return errorResult6(missingEndpoint);
+      const parsedEndpointArgs = parsedArgs.data;
       const requestedEndpoint = parsedEndpointArgs.endpoint ?? parsedEndpointArgs.endpoint_name ?? firstStringArg(args, ENDPOINT_NAME_ALIASES);
-      if (!requestedEndpoint) {
-        return errorResult6(
-          "No endpoint provided. Pass an 'endpoint' (or 'endpoint_name') parameter with the tool name."
-        );
-      }
+      if (!requestedEndpoint) return errorResult6(missingEndpoint);
       const lookup = resolveEndpoint(endpoints, requestedEndpoint);
       const metaEndpoint = lookup.ok ? void 0 : [
         searchToolsTool,