hive-intelligence 1.1.2 → 1.1.3

package/agent-skills/packs/hive-defi-research/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: hive-defi-research
+description: Use this skill for DeFi protocol and chain research covering TVL, fees, revenue, yields, stablecoins, bridges, protocol slugs, and chain-level DeFi metrics. Use it for current protocol comparisons and freshness-sensitive DeFi analysis.
+license: MIT
+metadata:
+  package: "@hiveintelligence/agent-skills"
+  category: "defi"
+  requires_network: "true"
+version: 1.0.0
+---
+
+# hive-defi-research — DeFi Protocol Analysis
+
+Use this skill for protocol, TVL, fees, yield, stablecoin, bridge, or chain
+DeFi questions.
+
+## Task toolset
+
+Use `defi_protocol_analysis`.
+
+Required identifiers: protocol name or chain.
+
+## Procedure
+
+Read `references/workflow.md` when the request needs protocol comparison,
+metric normalization, timestamp caveats, or a structured DeFi report.
+
+1. Resolve the protocol slug or chain name.
+2. Pull TVL, fee/revenue, yield, bridge, stablecoin, or chain metrics depending
+   on the user question.
+3. Compare protocols only with like-for-like metrics and timestamps.
+4. State if a metric is unavailable or stale.
+
+## Example
+
+For "compare Aave and Compound", run protocol-level TVL and fee/yield checks for
+each, then summarize differences in a table.
+
+## Runtime status handling
+
+Treat unreliable or temporarily unavailable DeFi endpoints as `degraded`.
+Do not silently omit a metric; mark it unavailable with the runtime status.

package/agent-skills/packs/hive-defi-research/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "hive-defi-research",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Compare Aave and Compound by current TVL, fees, and yield context.",
+      "expected_output": "Uses defi_protocol_analysis, resolves protocol slugs, fetches like-for-like metrics with timestamps, and marks missing/stale data.",
+      "files": [],
+      "assertions": [
+        "Chooses defi_protocol_analysis.",
+        "Normalizes metrics and timestamps.",
+        "Caveats missing or stale metrics."
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "What are the top DeFi protocols on Arbitrum right now?",
+      "expected_output": "Uses chain-level DeFi metrics with bounded limit, reports provider/freshness/runtime status, and avoids unsupported investment recommendations.",
+      "files": [],
+      "assertions": [
+        "Uses chain-level DeFi workflow.",
+        "Bounds the result list.",
+        "Reports provider and freshness."
+      ]
+    }
+  ]
+}

package/agent-skills/packs/hive-defi-research/references/workflow.md

@@ -0,0 +1,41 @@
+# DeFi Research Workflow
+
+Use this reference for protocol TVL, fees, revenue, yields, stablecoins,
+bridges, and chain-level DeFi metrics.
+
+## Required identifiers
+
+- Protocol slug or chain.
+- Optional: time window, metric type, yield pool, stablecoin, or bridge.
+
+Ask for a protocol slug or choose a provider-supported slug only when the user
+clearly named the protocol.
+
+## Tool selection order
+
+1. Resolve protocol or chain.
+2. Use `search_tools` for protocol, TVL, fee/revenue, yield, stablecoin, bridge,
+   or chain metrics.
+3. Inspect schemas before invocation.
+4. Pull only the metrics needed for the question.
+5. For comparisons, normalize metric type and timestamp.
+
+## Bounded calls
+
+- Limit protocol lists and yield pools.
+- Avoid comparing TVL snapshots from different dates without caveat.
+- Mark missing fee/yield/stablecoin metrics instead of omitting them.
+
+## Report template
+
+- Summary: protocol or chain DeFi read.
+- Calls made: endpoints, protocol/chain, metric filters.
+- Evidence: TVL, fees/revenue, yield, bridge/stablecoin metrics, freshness.
+- Caveats: unavailable metrics, stale snapshots, methodology differences.
+- Next action: compare peers, inspect yield pool, or add token/pool diligence.
+
+## Gotchas
+
+- TVL, revenue, and fees answer different questions.
+- High APY without liquidity/risk context is not a recommendation.
+- Provider methodology can differ across chains and protocols.

package/agent-skills/packs/hive-dex-pool-analysis/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: hive-dex-pool-analysis
+description: Use this skill for on-chain DEX and pool analysis covering pools, pairs, swaps, liquidity, trades, OHLCV, trending pools, and token-level DEX flow. Use exact chain, pair, pool, or token identifiers before selecting tools.
+license: MIT
+metadata:
+  package: "@hiveintelligence/agent-skills"
+  category: "dex"
+  requires_network: "true"
+version: 1.0.0
+---
+
+# hive-dex-pool-analysis — DEX And Pool Analysis
+
+Use this skill for pool, pair, swap, liquidity, DEX trend, or token flow
+questions.
+
+## Task toolset
+
+Use `onchain_dex_pool_analysis`.
+
+Required identifiers: chain and pair address or token contract.
+
+## Procedure
+
+Read `references/workflow.md` when the request needs pool/pair resolution,
+liquidity context, trade-flow comparison, or a structured DEX report.
+
+1. Resolve the chain and pair/token identifier.
+2. Pull pool info, liquidity, trades, OHLCV, and pair stats only as needed.
+3. Distinguish pool-level facts from token-level facts.
+4. Report liquidity depth, recent flow, and data freshness.
+
+## Example
+
+If the user provides only a token contract, first search for relevant pools or
+pairs, then choose the pool with the most relevant liquidity/volume.
+
+## Runtime status handling
+
+If a DEX/pool endpoint is `degraded`, fall back to pair search or token-pool
+tools and state which exact metric is missing.

package/agent-skills/packs/hive-dex-pool-analysis/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "hive-dex-pool-analysis",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Analyze the main Uniswap pool for this token and summarize liquidity and recent flow.",
+      "expected_output": "Uses onchain_dex_pool_analysis, resolves chain/token/pool, fetches bounded pool/liquidity/trade data, and separates pool facts from token facts.",
+      "files": [],
+      "assertions": [
+        "Chooses onchain_dex_pool_analysis.",
+        "Resolves pool or asks for enough identifiers.",
+        "Caveats pool-specific liquidity."
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "Find which pool has the most relevant liquidity for this token contract.",
+      "expected_output": "Searches candidate pools, uses bounded limits, chooses based on liquidity/volume evidence, and reports provider/freshness.",
+      "files": [],
+      "assertions": [
+        "Searches candidate pools before choosing.",
+        "Uses liquidity or volume evidence.",
+        "Reports source and freshness."
+      ]
+    }
+  ]
+}

package/agent-skills/packs/hive-dex-pool-analysis/references/workflow.md

@@ -0,0 +1,42 @@
+# DEX And Pool Analysis Workflow
+
+Use this reference for pool, pair, liquidity, swap, trade, OHLCV, and DEX-flow
+questions.
+
+## Required identifiers
+
+- Chain/network.
+- Pair/pool address, token contract, or both token sides.
+- Optional: DEX name, time window, candle interval, trade direction.
+
+If the user gives only one token, search candidate pools and prefer the pool
+most relevant to liquidity/volume.
+
+## Tool selection order
+
+1. Resolve chain and pool/pair/token identifiers.
+2. Use `search_tools` for pair search, pool info, liquidity, trades, OHLCV, and
+   trending pool tools.
+3. Inspect schemas before invocation.
+4. Start with pool/pair metadata and liquidity.
+5. Add trades/OHLCV for flow or trend questions.
+
+## Bounded calls
+
+- Limit trade lists and candle counts.
+- Do not infer token-wide liquidity from one pool without saying so.
+- Keep pool-level and token-level metrics separate.
+
+## Report template
+
+- Summary: pool/liquidity/trade-flow read.
+- Calls made: endpoints, chain, pair/pool/token identifiers.
+- Evidence: liquidity, volume, trades, OHLCV, provider/freshness/runtime status.
+- Caveats: missing pools, stale candles, thin liquidity, degraded provider.
+- Next action: compare pools, widen time window, or add token diligence.
+
+## Gotchas
+
+- Same token pair can have multiple pools with different fee tiers and liquidity.
+- Trending pools are not necessarily safe or liquid.
+- OHLCV data can be unavailable even when pair metadata exists.

package/agent-skills/packs/hive-market-research/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: hive-market-research
+description: Use this skill for live crypto market research including prices, liquidity, exchange data, OHLC candles, order books, tickers, funding rates, derivatives, and trading context. Use it whenever the user needs current market data or venue-specific market evidence.
+license: MIT
+metadata:
+  package: "@hiveintelligence/agent-skills"
+  category: "market"
+  requires_network: "true"
+version: 1.0.0
+---
+
+# hive-market-research — Market Research
+
+Use this skill for live price, liquidity, exchange, OHLC, order book,
+derivatives, or trading-context questions.
+
+## Task toolset
+
+Use `market_research`.
+
+Required identifiers: token symbol or contract, plus chain or exchange id when
+the request is venue-specific.
+
+## Procedure
+
+Read `references/workflow.md` when the request needs multi-step market
+analysis, venue selection, freshness comparison, or a provenance-aware report
+template.
+
+1. Resolve ambiguous symbols with `search_tools`.
+2. Inspect schemas for exact market tools before execution.
+3. Prefer focused calls for price, ticker, OHLC, order book, or funding data.
+4. Return freshness and avoid trading conclusions without liquidity context.
+
+## Example
+
+Ask for the exchange id if the user says "check the order book" without naming
+a venue. Use `binance`, `kraken`, or another explicit exchange id only when the
+user provided it or asked you to choose a fixture.
+
+## Runtime status handling
+
+Report `ok`, `missing_key`, `plan_required`, `rate_limited`, `degraded`, or
+`failing` per tool/provider. If a venue endpoint is degraded, fall back to
+another public market-data endpoint and state the substitution.

package/agent-skills/packs/hive-market-research/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "hive-market-research",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "What's the live BTC price, recent liquidity context, and source freshness?",
+      "expected_output": "Routes to market_research, resolves BTC to a provider-supported id, inspects schemas, makes bounded price/liquidity calls, and reports provider/freshness/runtime status.",
+      "files": [],
+      "assertions": [
+        "Chooses market_research.",
+        "Uses schema lookup before execution.",
+        "Reports provider and freshness."
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "Check the SOL order book on Kraken and tell me if liquidity is thin.",
+      "expected_output": "Requires or uses explicit venue id, performs venue-specific order book lookup, bounds depth, and avoids market-wide claims from one venue.",
+      "files": [],
+      "assertions": [
+        "Treats Kraken as a venue-specific request.",
+        "Bounds order book depth.",
+        "Caveats venue-specific liquidity."
+      ]
+    }
+  ]
+}

package/agent-skills/packs/hive-market-research/references/workflow.md

@@ -0,0 +1,47 @@
+# Market Research Workflow
+
+Use this reference for live prices, venue data, order books, OHLC, derivatives,
+and liquidity context.
+
+## Required identifiers
+
+- Asset: token id, symbol, or contract address.
+- Quote currency, usually `usd`, when asking for prices.
+- Venue/exchange id when the request is order-book, ticker, or derivatives
+  specific.
+- Time window and candle interval for OHLC or trend questions.
+
+Ask for missing venue or chain details when the choice changes the answer. For
+general price questions, choose a broad market-data toolset and state the source.
+
+## Tool selection order
+
+1. Use `search_tools` with the asset, venue, and market-data intent.
+2. Inspect the exact schema with `get_api_endpoint_schema`.
+3. For spot context, prefer price, ticker, and liquidity tools.
+4. For chart context, prefer OHLC/OHLCV tools with explicit interval and limit.
+5. For venue context, use exchange/order-book tools only after venue resolution.
+6. For derivatives, include funding/open-interest context when available.
+
+## Bounded calls
+
+- Use small limits for candles and order-book depth unless the user asks for
+  more.
+- Avoid fetching all exchanges or all markets for a single-asset question.
+- Do not compare data from different timestamps without saying so.
+
+## Report template
+
+- Summary: current market read in one sentence.
+- Calls made: task toolset and exact endpoints.
+- Evidence: provider, venue, identifiers, freshness, and key metrics.
+- Caveats: stale data, missing venue, fallback, degraded provider, or thin
+  liquidity.
+- Next action: deeper venue, time-window, or liquidity drilldown if needed.
+
+## Gotchas
+
+- Symbols collide. Prefer contract addresses, CoinGecko ids, or venue ids.
+- Order-book liquidity is venue-specific; do not generalize it to the full
+  market.
+- Market data can be fresh but still incomplete if a venue/provider is degraded.

package/agent-skills/packs/hive-mcp/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: hive-mcp
+description: Use this skill when installing, configuring, or debugging Hive MCP in Claude Code, Cursor, VS Code, Windsurf, Claude Desktop, ChatGPT Desktop, Gemini CLI, or any MCP-compatible client. Includes hosted-vs-stdio guidance, auth headers, skills installation, and verification.
+license: MIT
+metadata:
+  package: "@hiveintelligence/agent-skills"
+  category: "setup"
+  requires_network: "true"
+version: 1.0.0
+---
+
+# hive-mcp — Add Hive to an MCP Client
+
+Walk the user through adding Hive's MCP endpoint to whichever AI client
+they're using. The endpoint is the same everywhere; only the config
+file path and shape vary per client.
+
+## Universal facts
+
+- **MCP URL** — `https://mcp.hiveintelligence.xyz/mcp`
+- **Transport** — Streamable HTTP (single endpoint, supports both
+  POST and GET; SSE is legacy)
+- **Auth** — `Authorization: Bearer <HIVE_API_KEY>`. Legacy alias
+  `x-api-key: <HIVE_API_KEY>` also works.
+- **Per-key cost** — one credit per tool call regardless of payload
+  size. 4xx errors don't consume credits; 5xx errors are refunded.
+
+If the user doesn't have a key yet, route to `hive-build-onboarding`
+first.
+
+## Fast path — one command
+
+If the user is on a machine with multiple MCP-capable clients and just
+wants Hive everywhere:
+
+```bash
+npx -y -p hive-intelligence@latest hive init --all --browser
+```
+
+This detects every client on the machine, registers Hive in each
+config, and runs PKCE browser auth. Recommended.
+
+For agents that support standalone skills, install or copy the Hive skills
+after MCP is connected. In this repo, validate the package locally before
+publishing it to npm or a public skills mirror:
+
+```bash
+npx skills add ./agent-skills --list
+npm --workspace @hiveintelligence/agent-skills run pack:check
+```
+
+Read `references/client-install-matrix.md` when the user asks for install
+strategy, hosted-vs-stdio tradeoffs, or package boundaries.
+
+## Per-client instructions
+
+### Claude Code
+
+```bash
+claude mcp add --transport http hive https://mcp.hiveintelligence.xyz/mcp \
+  --header "Authorization: Bearer $HIVE_API_KEY"
+```
+
+Add `--scope user` to install globally, or `--scope project` to commit
+to the repo's `.mcp.json`. Default scope is local. Restart isn't
+required — tools appear in the next chat session.
+
+### Cursor
+
+Edit `~/.cursor/mcp.json`. Add the `hive` server block:
+
+```json
+{
+  "mcpServers": {
+    "hive": {
+      "url": "https://mcp.hiveintelligence.xyz/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_HIVE_API_KEY"
+      }
+    }
+  }
+}
+```
+
+Reload the MCP server list from Cursor's command palette
+(`Cmd+Shift+P` → "MCP: Reload Servers"). Or use the deeplink:
+
+```
+cursor://anysphere.cursor-deeplink/mcp/install?name=hive&config=<base64-encoded-config>
+```
+
+### Claude Desktop
+
+Settings → Developer → Edit Config. The file opens in your default
+editor. Same shape as Cursor:
+
+```json
+{
+  "mcpServers": {
+    "hive": {
+      "url": "https://mcp.hiveintelligence.xyz/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_HIVE_API_KEY"
+      }
+    }
+  }
+}
+```
+
+Quit Claude Desktop fully (⌘Q on macOS — the menu bar icon must
+disappear) and reopen. Tools become available on next chat.
+
+### VS Code (GitHub Copilot Chat)
+
+Requires VS Code 1.101 or newer. Create `.vscode/mcp.json` in the
+project root (or use User Settings for a global install):
+
+```json
+{
+  "servers": {
+    "hive": {
+      "type": "http",
+      "url": "https://mcp.hiveintelligence.xyz/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_HIVE_API_KEY"
+      }
+    }
+  }
+}
+```
+
+Reload the window. Note the `type: "http"` field — this is required
+in VS Code's schema and differs from Cursor / Claude Desktop.
+
+### Windsurf
+
+Edit `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "hive": {
+      "url": "https://mcp.hiveintelligence.xyz/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_HIVE_API_KEY"
+      }
+    }
+  }
+}
+```
+
+Reload Windsurf.
+
+### ChatGPT Desktop
+
+Paid tier required. Settings → Connectors → "Add MCP server" →
+
+- **URL** — `https://mcp.hiveintelligence.xyz/mcp`
+- **Auth header** — `Authorization: Bearer YOUR_HIVE_API_KEY`
+
+### Gemini CLI
+
+Edit `~/.gemini/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "hive": {
+      "url": "https://mcp.hiveintelligence.xyz/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_HIVE_API_KEY"
+      }
+    }
+  }
+}
+```
+
+## Verifying the install
+
+Run a test query in the connected client. Any of these works:
+
+> "What is the current price of Bitcoin?"
+> "Is the token at 0x6982508145454Ce325dDbE47a25d4ec3d2311933 safe?"
+> "Show me the top 5 DeFi protocols by TVL."
+
+If the agent calls a Hive tool (you'll see `get_price`,
+`go_plus_token_security`, or `defillama_get_protocols` in the tool
+log), the install worked. If the agent answers from training data
+without a tool call, the MCP connection isn't wired correctly — check
+the config file path and the auth header.
+
+## Common failures
+
+- **"401 / Authentication failed"** — header format must be exactly
+  `"Authorization": "Bearer YOUR_KEY"` with one literal space after
+  `Bearer`. Don't wrap the key in quotes inside the JSON value. Verify
+  the key at https://www.hiveintelligence.xyz/dashboard/keys.
+
+## Runtime status handling
+
+Hive reports runtime states as `ok`, `missing_key`, `plan_required`,
+`rate_limited`, `degraded`, and `failing`. Installation succeeds when the MCP
+server is connected; individual provider tools may still report non-`ok`
+runtime states until credentials, plan access, or rate limits are resolved.
+- **Connection error / timeout** — corporate proxy may block
+  `mcp.hiveintelligence.xyz`. Test on a non-corporate network. If you
+  must stay behind the firewall, use the stdio fallback documented at
+  https://www.hiveintelligence.xyz/install/claude-desktop.
+- **"createPopperScope is not a function"** — webpack/dev-server
+  cache issue, not a Hive bug. Restart the client.
+
+## Source of truth
+
+Canonical agent-readable install manifest:
+https://www.hiveintelligence.xyz/agent-onboarding/SKILL.md
+
+Per-client docs:
+- https://www.hiveintelligence.xyz/install/claude-code
+- https://www.hiveintelligence.xyz/install/claude-desktop
+- https://www.hiveintelligence.xyz/install/cursor
+- https://www.hiveintelligence.xyz/install/vs-code
+- https://www.hiveintelligence.xyz/install/windsurf
+- https://www.hiveintelligence.xyz/install/chatgpt
+- https://www.hiveintelligence.xyz/install/gemini-cli

package/agent-skills/packs/hive-mcp/evals/evals.json

@@ -0,0 +1,38 @@
+{
+  "skill_name": "hive-mcp",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Set up Hive MCP in Cursor and make sure the agent also gets Hive skills.",
+      "expected_output": "Provides Cursor MCP config for hosted HTTP, Authorization header format, reload step, and skills install path.",
+      "files": [],
+      "assertions": [
+        "Uses https://mcp.hiveintelligence.xyz/mcp.",
+        "Shows Authorization: Bearer YOUR_HIVE_API_KEY.",
+        "Mentions Hive skills installation or package."
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "Should I use hosted Hive MCP or local stdio for Claude Desktop?",
+      "expected_output": "Recommends hosted remote MCP by default and local stdio for development, self-hosting, local-only clients, or provider-key experiments.",
+      "files": [],
+      "assertions": [
+        "States hosted remote MCP is the default product path.",
+        "Explains when stdio is appropriate.",
+        "Includes verification guidance."
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "How many Hive npm packages should we publish for MCP, adapters, and skills?",
+      "expected_output": "Separates server/CLI, typed client adapter, skills-only package, and compatibility CLI/docs surface with clear package responsibilities.",
+      "files": [],
+      "assertions": [
+        "Mentions hive-intelligence and the hive CLI.",
+        "Mentions @hiveintelligence/mcp-client.",
+        "Mentions @hiveintelligence/agent-skills."
+      ]
+    }
+  ]
+}