clodds 1.2.9 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/skills/bundled/acp/SKILL.md +188 -0
- package/dist/skills/bundled/acp/index.d.ts +0 -3
- package/dist/skills/bundled/acp/index.js +1 -1
- package/dist/skills/bundled/acp/index.js.map +1 -1
- package/dist/skills/bundled/agentbets/SKILL.md +19 -0
- package/dist/skills/bundled/agentbets/index.js +1 -1
- package/dist/skills/bundled/agentbets/index.js.map +1 -1
- package/dist/skills/bundled/ai-strategy/SKILL.md +111 -0
- package/dist/skills/bundled/ai-strategy/index.js +1 -1
- package/dist/skills/bundled/ai-strategy/index.js.map +1 -1
- package/dist/skills/bundled/alerts/SKILL.md +87 -0
- package/dist/skills/bundled/analytics/SKILL.md +252 -0
- package/dist/skills/bundled/analytics/index.js +2 -2
- package/dist/skills/bundled/analytics/index.js.map +1 -1
- package/dist/skills/bundled/arbitrage/SKILL.md +287 -0
- package/dist/skills/bundled/arbitrage/index.js +6 -1
- package/dist/skills/bundled/arbitrage/index.js.map +1 -1
- package/dist/skills/bundled/auto-reply/SKILL.md +285 -0
- package/dist/skills/bundled/auto-reply/index.js +2 -2
- package/dist/skills/bundled/auto-reply/index.js.map +1 -1
- package/dist/skills/bundled/automation/SKILL.md +242 -0
- package/dist/skills/bundled/automation/index.js +2 -2
- package/dist/skills/bundled/automation/index.js.map +1 -1
- package/dist/skills/bundled/backtest/SKILL.md +225 -0
- package/dist/skills/bundled/bags/SKILL.md +131 -0
- package/dist/skills/bundled/bankr/SKILL.md +114 -0
- package/dist/skills/bundled/betfair/SKILL.md +113 -0
- package/dist/skills/bundled/binance-futures/SKILL.md +84 -0
- package/dist/skills/bundled/binance-futures/index.d.ts +0 -3
- package/dist/skills/bundled/binance-futures/index.js +1 -2
- package/dist/skills/bundled/binance-futures/index.js.map +1 -1
- package/dist/skills/bundled/botchan/SKILL.md +66 -0
- package/dist/skills/bundled/botchan/index.d.ts +0 -3
- package/dist/skills/bundled/botchan/index.js +0 -1
- package/dist/skills/bundled/botchan/index.js.map +1 -1
- package/dist/skills/bundled/bridge/SKILL.md +215 -0
- package/dist/skills/bundled/bridge/index.js +6 -0
- package/dist/skills/bundled/bridge/index.js.map +1 -1
- package/dist/skills/bundled/bybit-futures/SKILL.md +84 -0
- package/dist/skills/bundled/bybit-futures/index.d.ts +0 -3
- package/dist/skills/bundled/bybit-futures/index.js +0 -1
- package/dist/skills/bundled/bybit-futures/index.js.map +1 -1
- package/dist/skills/bundled/clanker/SKILL.md +125 -0
- package/dist/skills/bundled/clanker/index.d.ts +0 -3
- package/dist/skills/bundled/clanker/index.js +0 -1
- package/dist/skills/bundled/clanker/index.js.map +1 -1
- package/dist/skills/bundled/copy-trading/SKILL.md +285 -0
- package/dist/skills/bundled/copy-trading/index.js +15 -8
- package/dist/skills/bundled/copy-trading/index.js.map +1 -1
- package/dist/skills/bundled/copy-trading-solana/SKILL.md +66 -0
- package/dist/skills/bundled/credentials/SKILL.md +261 -0
- package/dist/skills/bundled/credentials/index.js +4 -0
- package/dist/skills/bundled/credentials/index.js.map +1 -1
- package/dist/skills/bundled/crypto-hft/SKILL.md +121 -0
- package/dist/skills/bundled/crypto-hft/index.js +18 -3
- package/dist/skills/bundled/crypto-hft/index.js.map +1 -1
- package/dist/skills/bundled/dca/SKILL.md +27 -0
- package/dist/skills/bundled/dex/SKILL.md +92 -0
- package/dist/skills/bundled/dex/index.js +77 -29
- package/dist/skills/bundled/dex/index.js.map +1 -1
- package/dist/skills/bundled/divergence/SKILL.md +83 -0
- package/dist/skills/bundled/doctor/SKILL.md +267 -0
- package/dist/skills/bundled/doctor/index.js +2 -8
- package/dist/skills/bundled/doctor/index.js.map +1 -1
- package/dist/skills/bundled/drift/SKILL.md +53 -0
- package/dist/skills/bundled/drift-sdk/SKILL.md +103 -0
- package/dist/skills/bundled/drift-sdk/index.d.ts +0 -3
- package/dist/skills/bundled/drift-sdk/index.js +0 -1
- package/dist/skills/bundled/drift-sdk/index.js.map +1 -1
- package/dist/skills/bundled/edge/SKILL.md +84 -0
- package/dist/skills/bundled/embeddings/SKILL.md +244 -0
- package/dist/skills/bundled/endaoment/SKILL.md +65 -0
- package/dist/skills/bundled/endaoment/index.d.ts +0 -3
- package/dist/skills/bundled/endaoment/index.js +0 -1
- package/dist/skills/bundled/endaoment/index.js.map +1 -1
- package/dist/skills/bundled/ens/SKILL.md +63 -0
- package/dist/skills/bundled/ens/index.d.ts +0 -3
- package/dist/skills/bundled/ens/index.js +0 -1
- package/dist/skills/bundled/ens/index.js.map +1 -1
- package/dist/skills/bundled/erc8004/SKILL.md +79 -0
- package/dist/skills/bundled/erc8004/index.d.ts +0 -3
- package/dist/skills/bundled/erc8004/index.js +0 -1
- package/dist/skills/bundled/erc8004/index.js.map +1 -1
- package/dist/skills/bundled/execution/SKILL.md +278 -0
- package/dist/skills/bundled/farcaster/SKILL.md +80 -0
- package/dist/skills/bundled/farcaster/index.js +12 -0
- package/dist/skills/bundled/farcaster/index.js.map +1 -1
- package/dist/skills/bundled/features/SKILL.md +20 -0
- package/dist/skills/bundled/feeds/SKILL.md +288 -0
- package/dist/skills/bundled/harden/SKILL.md +74 -0
- package/dist/skills/bundled/history/SKILL.md +257 -0
- package/dist/skills/bundled/hyperliquid/SKILL.md +200 -0
- package/dist/skills/bundled/hyperliquid/index.d.ts +0 -3
- package/dist/skills/bundled/hyperliquid/index.js +0 -1
- package/dist/skills/bundled/hyperliquid/index.js.map +1 -1
- package/dist/skills/bundled/identity/SKILL.md +228 -0
- package/dist/skills/bundled/identity/index.js +2 -2
- package/dist/skills/bundled/identity/index.js.map +1 -1
- package/dist/skills/bundled/integrations/SKILL.md +321 -0
- package/dist/skills/bundled/integrations/index.js +2 -2
- package/dist/skills/bundled/integrations/index.js.map +1 -1
- package/dist/skills/bundled/jupiter/SKILL.md +163 -0
- package/dist/skills/bundled/jupiter/index.js +2 -2
- package/dist/skills/bundled/kamino/SKILL.md +69 -0
- package/dist/skills/bundled/ledger/SKILL.md +20 -0
- package/dist/skills/bundled/lighter/SKILL.md +83 -0
- package/dist/skills/bundled/lighter/index.d.ts +0 -3
- package/dist/skills/bundled/lighter/index.js +0 -1
- package/dist/skills/bundled/lighter/index.js.map +1 -1
- package/dist/skills/bundled/marginfi/SKILL.md +62 -0
- package/dist/skills/bundled/market-index/SKILL.md +242 -0
- package/dist/skills/bundled/market-index/index.js +1 -3
- package/dist/skills/bundled/market-index/index.js.map +1 -1
- package/dist/skills/bundled/markets/SKILL.md +49 -0
- package/dist/skills/bundled/mcp/SKILL.md +235 -0
- package/dist/skills/bundled/mcp/index.js +1 -3
- package/dist/skills/bundled/mcp/index.js.map +1 -1
- package/dist/skills/bundled/memory/SKILL.md +209 -0
- package/dist/skills/bundled/metaculus/SKILL.md +62 -0
- package/dist/skills/bundled/metaculus/index.js +4 -1
- package/dist/skills/bundled/metaculus/index.js.map +1 -1
- package/dist/skills/bundled/meteora/SKILL.md +28 -0
- package/dist/skills/bundled/meteora-dbc/SKILL.md +25 -0
- package/dist/skills/bundled/metrics/SKILL.md +338 -0
- package/dist/skills/bundled/mev/SKILL.md +239 -0
- package/dist/skills/bundled/mev/index.js +2 -2
- package/dist/skills/bundled/mev/index.js.map +1 -1
- package/dist/skills/bundled/mexc-futures/SKILL.md +86 -0
- package/dist/skills/bundled/mexc-futures/index.d.ts +0 -3
- package/dist/skills/bundled/mexc-futures/index.js +0 -1
- package/dist/skills/bundled/mexc-futures/index.js.map +1 -1
- package/dist/skills/bundled/mm/SKILL.md +142 -0
- package/dist/skills/bundled/mm/index.js +28 -27
- package/dist/skills/bundled/mm/index.js.map +1 -1
- package/dist/skills/bundled/monitoring/SKILL.md +249 -0
- package/dist/skills/bundled/news/SKILL.md +95 -0
- package/dist/skills/bundled/news/index.js +1 -2
- package/dist/skills/bundled/news/index.js.map +1 -1
- package/dist/skills/bundled/onchainkit/SKILL.md +83 -0
- package/dist/skills/bundled/opinion/SKILL.md +87 -0
- package/dist/skills/bundled/opportunity/SKILL.md +308 -0
- package/dist/skills/bundled/orca/SKILL.md +28 -0
- package/dist/skills/bundled/orca/index.js +11 -7
- package/dist/skills/bundled/orca/index.js.map +1 -1
- package/dist/skills/bundled/pairing/SKILL.md +275 -0
- package/dist/skills/bundled/pancakeswap/SKILL.md +93 -0
- package/dist/skills/bundled/pancakeswap/index.d.ts +0 -3
- package/dist/skills/bundled/pancakeswap/index.js +0 -1
- package/dist/skills/bundled/pancakeswap/index.js.map +1 -1
- package/dist/skills/bundled/percolator/SKILL.md +22 -0
- package/dist/skills/bundled/permissions/SKILL.md +269 -0
- package/dist/skills/bundled/permissions/index.js +2 -2
- package/dist/skills/bundled/permissions/index.js.map +1 -1
- package/dist/skills/bundled/plugins/SKILL.md +263 -0
- package/dist/skills/bundled/plugins/index.js +2 -2
- package/dist/skills/bundled/plugins/index.js.map +1 -1
- package/dist/skills/bundled/portfolio/SKILL.md +161 -0
- package/dist/skills/bundled/portfolio/index.js +1 -1
- package/dist/skills/bundled/portfolio/index.js.map +1 -1
- package/dist/skills/bundled/portfolio-sync/SKILL.md +466 -0
- package/dist/skills/bundled/positions/SKILL.md +262 -0
- package/dist/skills/bundled/predictfun/SKILL.md +109 -0
- package/dist/skills/bundled/predictfun/index.js +1 -1
- package/dist/skills/bundled/predictfun/index.js.map +1 -1
- package/dist/skills/bundled/predictit/SKILL.md +66 -0
- package/dist/skills/bundled/predictit/index.js +4 -1
- package/dist/skills/bundled/predictit/index.js.map +1 -1
- package/dist/skills/bundled/presence/SKILL.md +217 -0
- package/dist/skills/bundled/presence/index.js +2 -2
- package/dist/skills/bundled/presence/index.js.map +1 -1
- package/dist/skills/bundled/processes/SKILL.md +254 -0
- package/dist/skills/bundled/pump-swarm/SKILL.md +309 -0
- package/dist/skills/bundled/pumpfun/SKILL.md +145 -0
- package/dist/skills/bundled/pumpfun/index.js +82 -8
- package/dist/skills/bundled/pumpfun/index.js.map +1 -1
- package/dist/skills/bundled/qmd/SKILL.md +129 -0
- package/dist/skills/bundled/qrcoin/SKILL.md +60 -0
- package/dist/skills/bundled/qrcoin/index.d.ts +0 -3
- package/dist/skills/bundled/qrcoin/index.js +0 -1
- package/dist/skills/bundled/qrcoin/index.js.map +1 -1
- package/dist/skills/bundled/raydium/SKILL.md +198 -0
- package/dist/skills/bundled/remote/SKILL.md +201 -0
- package/dist/skills/bundled/research/SKILL.md +83 -0
- package/dist/skills/bundled/research/index.js +2 -2
- package/dist/skills/bundled/research/index.js.map +1 -1
- package/dist/skills/bundled/risk/SKILL.md +323 -0
- package/dist/skills/bundled/router/SKILL.md +233 -0
- package/dist/skills/bundled/routing/SKILL.md +258 -0
- package/dist/skills/bundled/sandbox/SKILL.md +257 -0
- package/dist/skills/bundled/search-config/SKILL.md +257 -0
- package/dist/skills/bundled/search-config/index.js +2 -2
- package/dist/skills/bundled/search-config/index.js.map +1 -1
- package/dist/skills/bundled/sessions/SKILL.md +251 -0
- package/dist/skills/bundled/sessions/index.js +1 -1
- package/dist/skills/bundled/sessions/index.js.map +1 -1
- package/dist/skills/bundled/setup/SKILL.md +53 -0
- package/dist/skills/bundled/shield/SKILL.md +21 -0
- package/dist/skills/bundled/signals/SKILL.md +106 -0
- package/dist/skills/bundled/signals/index.d.ts +0 -3
- package/dist/skills/bundled/signals/index.js +3 -4
- package/dist/skills/bundled/signals/index.js.map +1 -1
- package/dist/skills/bundled/sizing/SKILL.md +238 -0
- package/dist/skills/bundled/slippage/SKILL.md +306 -0
- package/dist/skills/bundled/smarkets/SKILL.md +107 -0
- package/dist/skills/bundled/smarkets/index.js +3 -3
- package/dist/skills/bundled/smarkets/index.js.map +1 -1
- package/dist/skills/bundled/solend/SKILL.md +63 -0
- package/dist/skills/bundled/strategy/SKILL.md +266 -0
- package/dist/skills/bundled/streaming/SKILL.md +150 -0
- package/dist/skills/bundled/streaming/index.js +2 -2
- package/dist/skills/bundled/streaming/index.js.map +1 -1
- package/dist/skills/bundled/tailscale/SKILL.md +249 -0
- package/dist/skills/bundled/tailscale/index.js +2 -2
- package/dist/skills/bundled/tailscale/index.js.map +1 -1
- package/dist/skills/bundled/ticks/SKILL.md +61 -0
- package/dist/skills/bundled/token-security/SKILL.md +18 -0
- package/dist/skills/bundled/trading-evm/SKILL.md +329 -0
- package/dist/skills/bundled/trading-futures/SKILL.md +865 -0
- package/dist/skills/bundled/trading-kalshi/SKILL.md +629 -0
- package/dist/skills/bundled/trading-kalshi/index.js +2 -0
- package/dist/skills/bundled/trading-kalshi/index.js.map +1 -1
- package/dist/skills/bundled/trading-manifold/SKILL.md +387 -0
- package/dist/skills/bundled/trading-polymarket/SKILL.md +1080 -0
- package/dist/skills/bundled/trading-polymarket/index.js +28 -19
- package/dist/skills/bundled/trading-polymarket/index.js.map +1 -1
- package/dist/skills/bundled/trading-solana/SKILL.md +418 -0
- package/dist/skills/bundled/trading-solana/index.js +1 -1
- package/dist/skills/bundled/trading-solana/index.js.map +1 -1
- package/dist/skills/bundled/trading-system/SKILL.md +290 -0
- package/dist/skills/bundled/triggers/SKILL.md +433 -0
- package/dist/skills/bundled/tts/SKILL.md +220 -0
- package/dist/skills/bundled/tweet-ideas/SKILL.md +77 -0
- package/dist/skills/bundled/usage/SKILL.md +239 -0
- package/dist/skills/bundled/usage/index.js +2 -2
- package/dist/skills/bundled/usage/index.js.map +1 -1
- package/dist/skills/bundled/veil/SKILL.md +76 -0
- package/dist/skills/bundled/veil/index.d.ts +0 -3
- package/dist/skills/bundled/veil/index.js +0 -1
- package/dist/skills/bundled/veil/index.js.map +1 -1
- package/dist/skills/bundled/verify/SKILL.md +199 -0
- package/dist/skills/bundled/verify/index.d.ts +0 -3
- package/dist/skills/bundled/verify/index.js +0 -1
- package/dist/skills/bundled/verify/index.js.map +1 -1
- package/dist/skills/bundled/virtuals/SKILL.md +82 -0
- package/dist/skills/bundled/voice/SKILL.md +217 -0
- package/dist/skills/bundled/voice/index.js +2 -2
- package/dist/skills/bundled/voice/index.js.map +1 -1
- package/dist/skills/bundled/weather/SKILL.md +80 -0
- package/dist/skills/bundled/weather/index.js +3 -0
- package/dist/skills/bundled/weather/index.js.map +1 -1
- package/dist/skills/bundled/webhooks/SKILL.md +297 -0
- package/dist/skills/bundled/webhooks/index.js +2 -2
- package/dist/skills/bundled/webhooks/index.js.map +1 -1
- package/dist/skills/bundled/whale-tracking/SKILL.md +287 -0
- package/dist/skills/bundled/whale-tracking/index.js +2 -2
- package/dist/skills/bundled/whale-tracking/index.js.map +1 -1
- package/dist/skills/bundled/yoink/SKILL.md +54 -0
- package/dist/skills/bundled/yoink/index.d.ts +0 -3
- package/dist/skills/bundled/yoink/index.js +0 -1
- package/dist/skills/bundled/yoink/index.js.map +1 -1
- package/dist/skills/executor.js +5 -3
- package/dist/skills/executor.js.map +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: market-index
|
|
3
|
+
description: "Search, discover, and browse indexed markets across all platforms"
|
|
4
|
+
emoji: "🔍"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Market Index - Complete API Reference
|
|
8
|
+
|
|
9
|
+
Search, discover, and browse markets across all prediction market platforms with advanced filtering and categorization.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Chat Commands
|
|
14
|
+
|
|
15
|
+
### Search
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
/index search "trump" # Search all indexed markets
|
|
19
|
+
/index search "election" --platform poly # Search specific platform
|
|
20
|
+
/index search "fed rate" --category finance # Filter by category
|
|
21
|
+
/index search "crypto" --min-volume 10000 # Min volume filter
|
|
22
|
+
/index search "sports" --active-only # Active markets only
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### Browse Categories
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
/index categories # List all categories
|
|
29
|
+
/index category politics # Browse politics markets
|
|
30
|
+
/index category crypto # Browse crypto markets
|
|
31
|
+
/index category sports # Browse sports markets
|
|
32
|
+
/index trending # Trending markets
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
### Market Discovery
|
|
36
|
+
|
|
37
|
+
```
|
|
38
|
+
/index new # Newly created markets
|
|
39
|
+
/index new --last 24h # Last 24 hours
|
|
40
|
+
/index hot # High activity markets
|
|
41
|
+
/index closing-soon # Markets ending soon
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
### Index Management
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
/index update # Refresh market index
|
|
48
|
+
/index update poly # Update specific platform
|
|
49
|
+
/index stats # Index statistics
|
|
50
|
+
/index status # Index health status
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## TypeScript API Reference
|
|
56
|
+
|
|
57
|
+
### Create Market Index
|
|
58
|
+
|
|
59
|
+
```typescript
|
|
60
|
+
import { createMarketIndex } from 'clodds/market-index';
|
|
61
|
+
|
|
62
|
+
const index = createMarketIndex({
|
|
63
|
+
platforms: ['polymarket', 'kalshi', 'manifold', 'betfair'],
|
|
64
|
+
|
|
65
|
+
// Auto-refresh
|
|
66
|
+
autoRefresh: true,
|
|
67
|
+
refreshIntervalMs: 300000, // 5 minutes
|
|
68
|
+
|
|
69
|
+
// Storage
|
|
70
|
+
cachePath: './market-index.db',
|
|
71
|
+
});
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### Search Markets
|
|
75
|
+
|
|
76
|
+
```typescript
|
|
77
|
+
// Full-text search
|
|
78
|
+
const results = await index.search('trump election', {
|
|
79
|
+
platforms: ['polymarket', 'kalshi'],
|
|
80
|
+
limit: 20,
|
|
81
|
+
sortBy: 'volume', // 'volume' | 'relevance' | 'endDate' | 'created'
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
for (const market of results) {
|
|
85
|
+
console.log(`[${market.platform}] ${market.question}`);
|
|
86
|
+
console.log(` Category: ${market.category}`);
|
|
87
|
+
console.log(` Volume: $${market.volume.toLocaleString()}`);
|
|
88
|
+
console.log(` End: ${market.endDate}`);
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
// With filters
|
|
92
|
+
const filtered = await index.search('', {
|
|
93
|
+
category: 'politics',
|
|
94
|
+
minVolume: 10000,
|
|
95
|
+
activeOnly: true,
|
|
96
|
+
endsBefore: '2024-12-31',
|
|
97
|
+
});
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### Browse Categories
|
|
101
|
+
|
|
102
|
+
```typescript
|
|
103
|
+
// Get all categories
|
|
104
|
+
const categories = await index.getCategories();
|
|
105
|
+
|
|
106
|
+
for (const cat of categories) {
|
|
107
|
+
console.log(`${cat.name}: ${cat.marketCount} markets`);
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
// Get markets in category
|
|
111
|
+
const politics = await index.getMarketsByCategory('politics', {
|
|
112
|
+
limit: 50,
|
|
113
|
+
sortBy: 'volume',
|
|
114
|
+
});
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
### Market Discovery
|
|
118
|
+
|
|
119
|
+
```typescript
|
|
120
|
+
// Get new markets
|
|
121
|
+
const newMarkets = await index.getNewMarkets({
|
|
122
|
+
since: Date.now() - 24 * 60 * 60 * 1000, // Last 24h
|
|
123
|
+
limit: 20,
|
|
124
|
+
});
|
|
125
|
+
|
|
126
|
+
// Get trending/hot markets
|
|
127
|
+
const trending = await index.getTrendingMarkets({
|
|
128
|
+
period: '24h',
|
|
129
|
+
limit: 10,
|
|
130
|
+
});
|
|
131
|
+
|
|
132
|
+
for (const market of trending) {
|
|
133
|
+
console.log(`${market.question}`);
|
|
134
|
+
console.log(` Volume 24h: $${market.volume24h.toLocaleString()}`);
|
|
135
|
+
console.log(` Volume change: ${market.volumeChange > 0 ? '+' : ''}${market.volumeChange}%`);
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
// Markets closing soon
|
|
139
|
+
const closingSoon = await index.getClosingSoon({
|
|
140
|
+
within: '48h',
|
|
141
|
+
minVolume: 1000,
|
|
142
|
+
});
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Index Management
|
|
146
|
+
|
|
147
|
+
```typescript
|
|
148
|
+
// Update index
|
|
149
|
+
await index.update();
|
|
150
|
+
|
|
151
|
+
// Update specific platform
|
|
152
|
+
await index.update('polymarket');
|
|
153
|
+
|
|
154
|
+
// Get index stats
|
|
155
|
+
const stats = await index.getStats();
|
|
156
|
+
|
|
157
|
+
console.log(`Total markets: ${stats.totalMarkets}`);
|
|
158
|
+
console.log(`By platform:`);
|
|
159
|
+
for (const [platform, count] of Object.entries(stats.byPlatform)) {
|
|
160
|
+
console.log(` ${platform}: ${count}`);
|
|
161
|
+
}
|
|
162
|
+
console.log(`By category:`);
|
|
163
|
+
for (const [category, count] of Object.entries(stats.byCategory)) {
|
|
164
|
+
console.log(` ${category}: ${count}`);
|
|
165
|
+
}
|
|
166
|
+
console.log(`Last updated: ${stats.lastUpdated}`);
|
|
167
|
+
|
|
168
|
+
// Check status
|
|
169
|
+
const status = await index.getStatus();
|
|
170
|
+
console.log(`Status: ${status.status}`);
|
|
171
|
+
console.log(`Markets indexed: ${status.marketCount}`);
|
|
172
|
+
console.log(`Index age: ${status.ageMinutes} minutes`);
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
### Get Single Market
|
|
176
|
+
|
|
177
|
+
```typescript
|
|
178
|
+
// Get market details
|
|
179
|
+
const market = await index.getMarket('polymarket', 'market-123');
|
|
180
|
+
|
|
181
|
+
console.log(`Question: ${market.question}`);
|
|
182
|
+
console.log(`Description: ${market.description}`);
|
|
183
|
+
console.log(`Category: ${market.category}`);
|
|
184
|
+
console.log(`Platform: ${market.platform}`);
|
|
185
|
+
console.log(`Volume: $${market.volume.toLocaleString()}`);
|
|
186
|
+
console.log(`Liquidity: $${market.liquidity.toLocaleString()}`);
|
|
187
|
+
console.log(`Start: ${market.startDate}`);
|
|
188
|
+
console.log(`End: ${market.endDate}`);
|
|
189
|
+
console.log(`Outcomes: ${market.outcomes.join(', ')}`);
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## Categories
|
|
195
|
+
|
|
196
|
+
Standard categories across platforms:
|
|
197
|
+
|
|
198
|
+
| Category | Description |
|
|
199
|
+
|----------|-------------|
|
|
200
|
+
| **politics** | Elections, policy, government |
|
|
201
|
+
| **crypto** | Cryptocurrency prices, events |
|
|
202
|
+
| **finance** | Fed rates, stocks, economy |
|
|
203
|
+
| **sports** | Games, tournaments, awards |
|
|
204
|
+
| **entertainment** | Movies, TV, celebrities |
|
|
205
|
+
| **science** | Research, space, climate |
|
|
206
|
+
| **technology** | Tech companies, products |
|
|
207
|
+
| **world** | International events |
|
|
208
|
+
| **other** | Miscellaneous |
|
|
209
|
+
|
|
210
|
+
---
|
|
211
|
+
|
|
212
|
+
## Search Syntax
|
|
213
|
+
|
|
214
|
+
| Syntax | Example | Description |
|
|
215
|
+
|--------|---------|-------------|
|
|
216
|
+
| Keywords | `trump election` | Match any word |
|
|
217
|
+
| Exact phrase | `"federal reserve"` | Match exact phrase |
|
|
218
|
+
| Exclude | `election -trump` | Exclude word |
|
|
219
|
+
| Platform filter | `platform:poly` | Specific platform |
|
|
220
|
+
| Category filter | `category:politics` | Specific category |
|
|
221
|
+
|
|
222
|
+
---
|
|
223
|
+
|
|
224
|
+
## Sorting Options
|
|
225
|
+
|
|
226
|
+
| Option | Description |
|
|
227
|
+
|--------|-------------|
|
|
228
|
+
| `volume` | Highest volume first |
|
|
229
|
+
| `relevance` | Best match first |
|
|
230
|
+
| `endDate` | Ending soonest first |
|
|
231
|
+
| `created` | Newest first |
|
|
232
|
+
| `liquidity` | Highest liquidity first |
|
|
233
|
+
|
|
234
|
+
---
|
|
235
|
+
|
|
236
|
+
## Best Practices
|
|
237
|
+
|
|
238
|
+
1. **Refresh regularly** - Markets change frequently
|
|
239
|
+
2. **Use filters** - Narrow down large result sets
|
|
240
|
+
3. **Check liquidity** - Not just volume
|
|
241
|
+
4. **Monitor new markets** - Opportunities in new listings
|
|
242
|
+
5. **Track closing dates** - Don't miss resolution
|
|
@@ -43,7 +43,6 @@ var __importStar = (this && this.__importStar) || (function () {
|
|
|
43
43
|
};
|
|
44
44
|
})();
|
|
45
45
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
46
|
-
const logger_1 = require("../../../utils/logger");
|
|
47
46
|
function helpText() {
|
|
48
47
|
return `**Market Index Commands**
|
|
49
48
|
|
|
@@ -169,8 +168,7 @@ async function execute(args) {
|
|
|
169
168
|
}
|
|
170
169
|
}
|
|
171
170
|
catch (error) {
|
|
172
|
-
|
|
173
|
-
return helpText();
|
|
171
|
+
return `Error: ${error instanceof Error ? error.message : String(error)}`;
|
|
174
172
|
}
|
|
175
173
|
}
|
|
176
174
|
exports.default = {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/market-index/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/market-index/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: markets
|
|
3
|
+
description: "Search and view prediction market data from Polymarket, Kalshi, Manifold, and Metaculus"
|
|
4
|
+
emoji: "📊"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Markets Skill
|
|
8
|
+
|
|
9
|
+
Use this skill to search for prediction markets and view current prices across platforms.
|
|
10
|
+
|
|
11
|
+
## Commands
|
|
12
|
+
|
|
13
|
+
### Search Markets
|
|
14
|
+
Search for markets matching a query:
|
|
15
|
+
```
|
|
16
|
+
/markets trump 2028
|
|
17
|
+
/markets fed rate cut
|
|
18
|
+
/markets super bowl
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
### Get Price
|
|
22
|
+
Get current price for a specific market:
|
|
23
|
+
```
|
|
24
|
+
/price [market-id or slug]
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
### View Orderbook
|
|
28
|
+
View bid/ask spread:
|
|
29
|
+
```
|
|
30
|
+
/orderbook [market-id]
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Supported Platforms
|
|
34
|
+
|
|
35
|
+
- **Polymarket** - Crypto prediction market, highest volume
|
|
36
|
+
- **Kalshi** - CFTC-regulated, US legal
|
|
37
|
+
- **Manifold** - Play money, anyone can create markets
|
|
38
|
+
- **Metaculus** - Forecasting platform, community predictions
|
|
39
|
+
|
|
40
|
+
## Examples
|
|
41
|
+
|
|
42
|
+
User: "What's the current price on Trump winning 2028?"
|
|
43
|
+
→ Search Polymarket for "Trump 2028", return YES price
|
|
44
|
+
|
|
45
|
+
User: "Show me Fed rate cut markets"
|
|
46
|
+
→ Search all platforms for "Fed rate", list top results with prices
|
|
47
|
+
|
|
48
|
+
User: "Compare prices across platforms for Bitcoin ETF approval"
|
|
49
|
+
→ Search multiple platforms, show price comparison table
|
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mcp
|
|
3
|
+
description: "Model Context Protocol server management and tool integration"
|
|
4
|
+
emoji: "🔌"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# MCP - Complete API Reference
|
|
8
|
+
|
|
9
|
+
Manage Model Context Protocol (MCP) servers, external tools, and AI integrations.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Chat Commands
|
|
14
|
+
|
|
15
|
+
### Server Management
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
/mcp list List configured MCP servers
|
|
19
|
+
/mcp status Check server connection status
|
|
20
|
+
/mcp add <name> <command> Add new MCP server
|
|
21
|
+
/mcp remove <name> Remove MCP server
|
|
22
|
+
/mcp restart <name> Restart server
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### Tool Interaction
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
/mcp tools List available tools
|
|
29
|
+
/mcp tools <server> Tools from specific server
|
|
30
|
+
/mcp call <server> <tool> [args] Call a tool directly
|
|
31
|
+
/mcp resources <server> List server resources
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Configuration
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
/mcp config <server> View server config
|
|
38
|
+
/mcp config <server> set <key> <value> Update config
|
|
39
|
+
/mcp logs <server> View server logs
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## TypeScript API Reference
|
|
45
|
+
|
|
46
|
+
### Create MCP Client
|
|
47
|
+
|
|
48
|
+
```typescript
|
|
49
|
+
import { createMCPClient } from 'clodds/mcp';
|
|
50
|
+
|
|
51
|
+
const mcp = createMCPClient({
|
|
52
|
+
// Transport
|
|
53
|
+
transport: 'stdio', // 'stdio' | 'sse'
|
|
54
|
+
|
|
55
|
+
// Server command
|
|
56
|
+
command: 'npx',
|
|
57
|
+
args: ['-y', '@modelcontextprotocol/server-filesystem'],
|
|
58
|
+
|
|
59
|
+
// Options
|
|
60
|
+
timeout: 30000,
|
|
61
|
+
retries: 3,
|
|
62
|
+
});
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Connect to Server
|
|
66
|
+
|
|
67
|
+
```typescript
|
|
68
|
+
// Connect
|
|
69
|
+
await mcp.connect();
|
|
70
|
+
|
|
71
|
+
// Check status
|
|
72
|
+
const status = mcp.getStatus();
|
|
73
|
+
console.log(`Connected: ${status.connected}`);
|
|
74
|
+
console.log(`Server: ${status.serverInfo?.name}`);
|
|
75
|
+
console.log(`Version: ${status.serverInfo?.version}`);
|
|
76
|
+
|
|
77
|
+
// Disconnect
|
|
78
|
+
await mcp.disconnect();
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
### List Tools
|
|
82
|
+
|
|
83
|
+
```typescript
|
|
84
|
+
// Get available tools
|
|
85
|
+
const tools = await mcp.listTools();
|
|
86
|
+
|
|
87
|
+
for (const tool of tools) {
|
|
88
|
+
console.log(`${tool.name}: ${tool.description}`);
|
|
89
|
+
console.log(` Input schema: ${JSON.stringify(tool.inputSchema)}`);
|
|
90
|
+
}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### Call Tool
|
|
94
|
+
|
|
95
|
+
```typescript
|
|
96
|
+
// Call a tool
|
|
97
|
+
const result = await mcp.callTool({
|
|
98
|
+
name: 'read_file',
|
|
99
|
+
arguments: {
|
|
100
|
+
path: '/path/to/file.txt',
|
|
101
|
+
},
|
|
102
|
+
});
|
|
103
|
+
|
|
104
|
+
console.log(`Result: ${JSON.stringify(result)}`);
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
### List Resources
|
|
108
|
+
|
|
109
|
+
```typescript
|
|
110
|
+
// Get available resources
|
|
111
|
+
const resources = await mcp.listResources();
|
|
112
|
+
|
|
113
|
+
for (const resource of resources) {
|
|
114
|
+
console.log(`${resource.uri}: ${resource.name}`);
|
|
115
|
+
console.log(` Type: ${resource.mimeType}`);
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
// Read a resource
|
|
119
|
+
const content = await mcp.readResource('file:///path/to/file.txt');
|
|
120
|
+
console.log(content);
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
### List Prompts
|
|
124
|
+
|
|
125
|
+
```typescript
|
|
126
|
+
// Get available prompts
|
|
127
|
+
const prompts = await mcp.listPrompts();
|
|
128
|
+
|
|
129
|
+
for (const prompt of prompts) {
|
|
130
|
+
console.log(`${prompt.name}: ${prompt.description}`);
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
// Get prompt content
|
|
134
|
+
const prompt = await mcp.getPrompt('code-review', {
|
|
135
|
+
code: 'function add(a, b) { return a + b; }',
|
|
136
|
+
});
|
|
137
|
+
|
|
138
|
+
console.log(prompt.messages);
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
### MCP Registry
|
|
142
|
+
|
|
143
|
+
```typescript
|
|
144
|
+
import { createMCPRegistry } from 'clodds/mcp';
|
|
145
|
+
|
|
146
|
+
const registry = createMCPRegistry({
|
|
147
|
+
configPath: './mcp-servers.json',
|
|
148
|
+
});
|
|
149
|
+
|
|
150
|
+
// Add server
|
|
151
|
+
registry.addServer({
|
|
152
|
+
name: 'filesystem',
|
|
153
|
+
command: 'npx',
|
|
154
|
+
args: ['-y', '@modelcontextprotocol/server-filesystem', '/home/user'],
|
|
155
|
+
env: {},
|
|
156
|
+
});
|
|
157
|
+
|
|
158
|
+
// List servers
|
|
159
|
+
const servers = registry.listServers();
|
|
160
|
+
|
|
161
|
+
// Get server
|
|
162
|
+
const server = registry.getServer('filesystem');
|
|
163
|
+
|
|
164
|
+
// Remove server
|
|
165
|
+
registry.removeServer('filesystem');
|
|
166
|
+
|
|
167
|
+
// Start all servers
|
|
168
|
+
await registry.startAll();
|
|
169
|
+
|
|
170
|
+
// Stop all servers
|
|
171
|
+
await registry.stopAll();
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
## Popular MCP Servers
|
|
177
|
+
|
|
178
|
+
| Server | Purpose | Install |
|
|
179
|
+
|--------|---------|---------|
|
|
180
|
+
| **filesystem** | File operations | `@modelcontextprotocol/server-filesystem` |
|
|
181
|
+
| **github** | GitHub API | `@modelcontextprotocol/server-github` |
|
|
182
|
+
| **postgres** | Database queries | `@modelcontextprotocol/server-postgres` |
|
|
183
|
+
| **brave-search** | Web search | `@modelcontextprotocol/server-brave-search` |
|
|
184
|
+
| **puppeteer** | Browser automation | `@modelcontextprotocol/server-puppeteer` |
|
|
185
|
+
|
|
186
|
+
---
|
|
187
|
+
|
|
188
|
+
## Server Configuration
|
|
189
|
+
|
|
190
|
+
```json
|
|
191
|
+
{
|
|
192
|
+
"mcpServers": {
|
|
193
|
+
"filesystem": {
|
|
194
|
+
"command": "npx",
|
|
195
|
+
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"],
|
|
196
|
+
"env": {}
|
|
197
|
+
},
|
|
198
|
+
"github": {
|
|
199
|
+
"command": "npx",
|
|
200
|
+
"args": ["-y", "@modelcontextprotocol/server-github"],
|
|
201
|
+
"env": {
|
|
202
|
+
"GITHUB_TOKEN": "ghp_..."
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
---
|
|
210
|
+
|
|
211
|
+
## CLI Commands
|
|
212
|
+
|
|
213
|
+
```bash
|
|
214
|
+
# List MCP servers
|
|
215
|
+
clodds mcp list
|
|
216
|
+
|
|
217
|
+
# Add MCP server
|
|
218
|
+
clodds mcp add filesystem "npx -y @modelcontextprotocol/server-filesystem /home"
|
|
219
|
+
|
|
220
|
+
# Test server connection
|
|
221
|
+
clodds mcp test filesystem
|
|
222
|
+
|
|
223
|
+
# Remove server
|
|
224
|
+
clodds mcp remove filesystem
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
---
|
|
228
|
+
|
|
229
|
+
## Best Practices
|
|
230
|
+
|
|
231
|
+
1. **Use official servers** — Start with well-tested MCP servers
|
|
232
|
+
2. **Limit file access** — Restrict filesystem server to specific directories
|
|
233
|
+
3. **Secure credentials** — Use env vars for tokens, not command args
|
|
234
|
+
4. **Monitor logs** — Check server logs for errors
|
|
235
|
+
5. **Timeout handling** — Set appropriate timeouts for slow operations
|
|
@@ -44,7 +44,6 @@ var __importStar = (this && this.__importStar) || (function () {
|
|
|
44
44
|
};
|
|
45
45
|
})();
|
|
46
46
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
47
|
-
const logger_1 = require("../../../utils/logger");
|
|
48
47
|
function helpText() {
|
|
49
48
|
return `**MCP Commands**
|
|
50
49
|
|
|
@@ -199,8 +198,7 @@ async function execute(args) {
|
|
|
199
198
|
}
|
|
200
199
|
}
|
|
201
200
|
catch (error) {
|
|
202
|
-
|
|
203
|
-
return helpText();
|
|
201
|
+
return `Error: ${error instanceof Error ? error.message : String(error)}`;
|
|
204
202
|
}
|
|
205
203
|
}
|
|
206
204
|
exports.default = {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/mcp/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/mcp/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIH,SAAS,QAAQ;IACf,OAAO;;;;;;;;;;;;;cAaK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,MAAM,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,EACJ,iBAAiB,EACjB,aAAa,EACb,oBAAoB,GACrB,GAAG,wDAAa,oBAAoB,GAAC,CAAC;QAEvC,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;QAC/B,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEvC,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,MAAM,CAAC;YACZ,KAAK,IAAI,CAAC,CAAC,CAAC;gBACV,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,qPAAqP,CAAC;gBAC/P,CAAC;gBAED,IAAI,MAAM,GAAG,oBAAoB,OAAO,CAAC,MAAM,OAAO,CAAC;gBACvD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;oBAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBACxC,MAAM,MAAM,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;oBAChE,MAAM,IAAI,GAAG,MAAM,EAAE,UAAU,CAAC;oBAChC,MAAM,IAAI,OAAO,IAAI,OAAO,MAAM,GAAG,CAAC;oBACtC,IAAI,IAAI,EAAE,CAAC;wBACT,MAAM,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,cAAc,IAAI,CAAC,eAAe,GAAG,CAAC;oBACjF,CAAC;oBACD,MAAM,IAAI,IAAI,CAAC;gBACjB,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,wDAAwD,CAAC;gBAClE,CAAC;gBAED,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAE5B,IAAI,MAAM,GAAG,6BAA6B,CAAC;gBAC3C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;oBAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBACxC,MAAM,MAAM,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;oBAC1D,MAAM,IAAI,KAAK,IAAI,KAAK,MAAM,EAAE,CAAC;oBACjC,IAAI,MAAM,EAAE,UAAU,EAAE,CAAC;wBACvB,MAAM,IAAI,KAAK,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC;oBACzE,CAAC;oBACD,MAAM,IAAI,IAAI,CAAC;gBACjB,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,CAAC,IAAI;oBAAE,OAAO,+BAA+B,CAAC;gBAElD,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACxC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,YAAY,IAAI,iDAAiD,CAAC;gBAC3E,CAAC;gBAED,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC1B,OAAO,uBAAuB,IAAI,KAAK,CAAC;YAC1C,CAAC;YAED,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAE9B,sCAAsC;gBACtC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAE5B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC9C,MAAM,KAAK,GAAG,YAAY;oBACxB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC;oBACjD,CAAC,CAAC,QAAQ,CAAC;gBAEb,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACvB,OAAO,YAAY;wBACjB,CAAC,CAAC,+BAA+B,YAAY,4CAA4C;wBACzF,CAAC,CAAC,oEAAoE,CAAC;gBAC3E,CAAC;gBAED,IAAI,MAAM,GAAG,kBAAkB,KAAK,CAAC,MAAM,OAAO,CAAC;gBACnD,IAAI,aAAa,GAAG,EAAE,CAAC;gBACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;wBAClC,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;wBAC5B,MAAM,IAAI,OAAO,aAAa,OAAO,CAAC;oBACxC,CAAC;oBACD,MAAM,IAAI,SAAS,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;oBAChD,IAAI,IAAI,CAAC,WAAW;wBAAE,MAAM,IAAI,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;oBACzD,MAAM,IAAI,IAAI,CAAC;oBACf,IAAI,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;wBACjC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;wBACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC;wBACjD,MAAM,IAAI,eAAe,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;oBAC9F,CAAC;gBACH,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC1B,IAAI,CAAC,QAAQ;oBAAE,OAAO,oGAAoG,CAAC;gBAE3H,uCAAuC;gBACvC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACzC,IAAI,QAAQ,GAA4B,EAAE,CAAC;gBAC3C,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,CAAC;wBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBACjC,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,2BAA2B,OAAO,wDAAwD,CAAC;oBACpG,CAAC;gBACH,CAAC;gBAED,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAE3D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,OAAO,qBAAqB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjF,CAAC;gBAED,IAAI,MAAM,GAAG,kBAAkB,QAAQ,QAAQ,CAAC;gBAChD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC/B,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI;wBAAE,MAAM,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;yBACpD,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU;wBAAE,MAAM,IAAI,cAAc,CAAC,CAAC,GAAG,KAAK,CAAC;yBAC9D,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;wBAAE,MAAM,IAAI,WAAW,CAAC,CAAC,QAAQ,KAAK,CAAC;gBACpE,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,4BAA4B,CAAC;gBACtC,CAAC;gBAED,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAE5C,IAAI,MAAM,GAAG,2BAA2B,CAAC;gBACzC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrD,MAAM,IAAI,KAAK,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC;gBAChE,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAED;gBACE,OAAO,QAAQ,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,kBAAe;IACb,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,+DAA+D;IAC5E,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO;CAChB,CAAC"}
|