@jellyos/agent 0.1.3 → 0.1.5

package/dist/tools/NewsSentiment.js

@@ -0,0 +1,226 @@
+/**
+ * NewsSentiment — fetches RSS feeds, runs headline sentiment scoring
+ * with a cheap model, and surfaces trending narratives.
+ */
+import { Type } from "@sinclair/typebox";
+// ── RSS sources ───────────────────────────────────────────────────────────────
+const FEEDS = [
+    { name: "CoinDesk", url: "https://www.coindesk.com/arc/outboundfeeds/rss/" },
+    { name: "CoinTelegraph", url: "https://cointelegraph.com/rss" },
+    { name: "The Block", url: "https://www.theblock.co/rss" },
+];
+// ── Simple keyword-based sentiment (no model required) ────────────────────────
+const BULLISH_WORDS = [
+    "surge", "soar", "rally", "bull", "breakout", "moon", "pump", "record high",
+    "all-time high", "ath", "accumulate", "institutional", "adoption", "approval",
+    "etf approved", "launch", "partnership", "upgrade", "mainnet", "listing",
+    "airdrop", "halving", "buyback", "burn", "yield", "staking",
+];
+const BEARISH_WORDS = [
+    "crash", "plunge", "dump", "bear", "downturn", "correction", "liquidate",
+    "hack", "exploit", "rug", "scam", "sec", "lawsuit", "regulation", "ban",
+    "crackdown", "fine", "penalty", "delist", "suspend", "halt", "freeze",
+    "insolvent", "bankrupt", "depeg", "exploit",
+];
+export function scoreSentiment(text) {
+    const lower = text.toLowerCase();
+    let score = 0;
+    let hits = 0;
+    for (const w of BULLISH_WORDS) {
+        if (lower.includes(w)) {
+            score++;
+            hits++;
+        }
+    }
+    for (const w of BEARISH_WORDS) {
+        if (lower.includes(w)) {
+            score--;
+            hits++;
+        }
+    }
+    return hits === 0 ? 0 : Math.max(-1, Math.min(1, score / hits));
+}
+// ── Fetch & parse ────────────────────────────────────────────────────────────
+/**
+ * Proper RSS item extractor — handles CDATA, encoded entities, attributes.
+ * No regex on the whole document; scans block by block.
+ */
+function extractTag(block, tag) {
+    // Try CDATA form first: <tag><![CDATA[...]]></tag>
+    const cdataRe = new RegExp(`<${tag}[^>]*><!\\[CDATA\\[([\\s\\S]*?)\\]\\]>`, "i");
+    const cdataM = block.match(cdataRe);
+    if (cdataM?.[1])
+        return cdataM[1].trim();
+    // Plain text form: <tag ...>content</tag>
+    const plainRe = new RegExp(`<${tag}[^>]*>([^<]*)`, "i");
+    const plainM = block.match(plainRe);
+    if (plainM?.[1]) {
+        return plainM[1]
+            .replace(/&amp;/g, "&")
+            .replace(/&lt;/g, "<")
+            .replace(/&gt;/g, ">")
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'")
+            .trim();
+    }
+    return "";
+}
+async function fetchRSS(url, source) {
+    try {
+        const res = await fetch(url, {
+            signal: AbortSignal.timeout(10_000),
+            headers: { "User-Agent": "JellyOS/1.0", "Accept": "application/rss+xml, application/xml, text/xml, */*" },
+        });
+        if (!res.ok)
+            return [];
+        const xml = await res.text();
+        // Find all <item>...</item> blocks (also handles <entry> for Atom feeds)
+        const TAG_RE = /<(?:item|entry)[^>]*>([\s\S]*?)<\/(?:item|entry)>/gi;
+        const items = [];
+        let match;
+        while ((match = TAG_RE.exec(xml)) !== null) {
+            const block = match[1] ?? "";
+            const title = extractTag(block, "title");
+            const link = extractTag(block, "link") || extractTag(block, "guid");
+            const pubDate = extractTag(block, "pubDate") || extractTag(block, "updated") || extractTag(block, "published");
+            if (!title)
+                continue;
+            items.push({
+                title,
+                source,
+                url: link,
+                published: pubDate ? (new Date(pubDate).getTime() || Date.now()) : Date.now(),
+                sentiment: scoreSentiment(title),
+            });
+            if (items.length >= 25)
+                break; // cap per feed
+        }
+        return items;
+    }
+    catch {
+        return [];
+    }
+}
+// ── Keyword extraction ────────────────────────────────────────────────────────
+function extractKeywords(items, topN = 10) {
+    const wordFreq = new Map();
+    const stopWords = new Set(["the", "a", "an", "in", "on", "at", "to", "for", "of", "and", "is", "are", "was", "were", "will", "has", "have", "it", "its", "with", "from", "by", "as", "be", "that", "this", "but", "or", "not", "can", "may"]);
+    for (const item of items) {
+        const words = item.title.toLowerCase().replace(/[^a-z0-9 ]/g, "").split(/\s+/);
+        for (const w of words) {
+            if (w.length < 3 || stopWords.has(w))
+                continue;
+            wordFreq.set(w, (wordFreq.get(w) ?? 0) + 1);
+        }
+    }
+    return [...wordFreq.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, topN)
+        .map(([w]) => w);
+}
+// ── NewsFeed class ────────────────────────────────────────────────────────────
+export class NewsFeed {
+    lastReport = null;
+    pollInterval;
+    timer;
+    constructor(pollIntervalMs = 600_000) {
+        this.pollInterval = pollIntervalMs;
+    }
+    start() {
+        this.fetch();
+        this.timer = setInterval(() => this.fetch(), this.pollInterval);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+    }
+    async fetch() {
+        const allItems = [];
+        for (const feed of FEEDS) {
+            const items = await fetchRSS(feed.url, feed.name);
+            allItems.push(...items);
+        }
+        allItems.sort((a, b) => b.published - a.published);
+        const scored = allItems.filter(i => i.sentiment !== undefined && i.sentiment !== 0);
+        const avgSent = scored.length > 0 ? scored.reduce((s, i) => s + (i.sentiment ?? 0), 0) / scored.length : 0;
+        const positive = allItems.filter(i => (i.sentiment ?? 0) > 0.1).length;
+        const negative = allItems.filter(i => (i.sentiment ?? 0) < -0.1).length;
+        const neutral = allItems.length - positive - negative;
+        const topKeywords = extractKeywords(allItems);
+        this.lastReport = {
+            items: allItems,
+            avgSentiment: Math.round(avgSent * 1000) / 1000,
+            positive,
+            negative,
+            neutral,
+            updatedAt: Date.now(),
+            topKeywords,
+        };
+    }
+    getLatest() {
+        return this.lastReport;
+    }
+    summary() {
+        if (!this.lastReport)
+            return "No news data available.";
+        const r = this.lastReport;
+        const score = r.avgSentiment;
+        const mood = score > 0.2 ? "🟢 Bullish" : score < -0.2 ? "🔴 Bearish" : "🟡 Neutral";
+        return [
+            `News Sentiment: ${mood} (score: ${score >= 0 ? "+" : ""}${score.toFixed(3)})`,
+            `  ${r.positive} positive · ${r.negative} negative · ${r.neutral} neutral (${r.items.length} articles)`,
+            `  Trending: ${r.topKeywords.slice(0, 8).join(", ")}`,
+            `  Latest:`,
+            ...r.items.slice(0, 5).map(i => {
+                const s = (i.sentiment ?? 0) >= 0.1 ? "🟢" : (i.sentiment ?? 0) <= -0.1 ? "🔴" : "  ";
+                return `    ${s} [${i.source}] ${i.title.slice(0, 80)}`;
+            }),
+        ].join("\n");
+    }
+    /** Compact sentiment badge for status bar. */
+    statusBadge() {
+        if (!this.lastReport)
+            return "📰 ?";
+        const s = this.lastReport.avgSentiment;
+        const emoji = s > 0.3 ? "🟢" : s > 0 ? "🟡" : "🔴";
+        return `📰 ${emoji} ${(s * 100).toFixed(0)}%`;
+    }
+}
+// ── Singleton ─────────────────────────────────────────────────────────────────
+export const newsFeed = new NewsFeed();
+// ── Tool: get_news ────────────────────────────────────────────────────────────
+export const getNewsParams = Type.Object({
+    limit: Type.Optional(Type.Number({ default: 10, description: "Number of articles to show" })),
+});
+export async function getNewsTool(_id, params) {
+    const report = newsFeed.getLatest();
+    if (!report) {
+        return {
+            content: [{ type: "text", text: "News data not yet available. Please wait for the first fetch." }],
+            details: {},
+        };
+    }
+    const items = report.items.slice(0, params.limit ?? 10)
+        .map(i => {
+        const s = (i.sentiment ?? 0) >= 0.1 ? "+" : (i.sentiment ?? 0) <= -0.1 ? "-" : " ";
+        return `${s} [${i.source}] ${i.title}`;
+    })
+        .join("\n");
+    return {
+        content: [{
+                type: "text",
+                text: `News Sentiment: ${report.avgSentiment >= 0 ? "+" : ""}${(report.avgSentiment * 100).toFixed(0)}% sentiment · ${report.positive}p/${report.negative}n/${report.neutral}·\nTrending: ${report.topKeywords.join(", ")}\n\n${items}`,
+            }],
+        details: {
+            avgSentiment: report.avgSentiment,
+            positive: report.positive,
+            negative: report.negative,
+            neutral: report.neutral,
+            articleCount: report.items.length,
+            topKeywords: report.topKeywords,
+        },
+    };
+}
+//# sourceMappingURL=NewsSentiment.js.map

package/dist/tools/PriceFeed.d.ts

@@ -0,0 +1,105 @@
+/**
+ * PriceFeed — real-time price aggregation from CoinGecko and Binance.
+ *
+ * Provides:
+ *  - Background polling with configurable intervals
+ *  - Multi-source aggregation (prioritises Binance for precision, CG for breadth)
+ *  - 24h change, volume, and market cap tracking
+ *  - In-memory price cache for tool lookups
+ *  - Exposed as tools for the AI to query
+ */
+import { type Static } from "@sinclair/typebox";
+import { EventEmitter } from "node:events";
+export interface PriceTick {
+    symbol: string;
+    price: number;
+    change24h: number;
+    volume24h: number;
+    marketCap: number;
+    high24h: number;
+    low24h: number;
+    source: "coingecko" | "binance";
+    timestamp: number;
+}
+export interface CoinGeckoCoin {
+    id: string;
+    symbol: string;
+    name: string;
+    current_price: number;
+    price_change_percentage_24h: number;
+    market_cap: number;
+    total_volume: number;
+    high_24h: number;
+    low_24h: number;
+}
+export declare class PriceFeed extends EventEmitter {
+    private prices;
+    private pollInterval;
+    private timer?;
+    private tracking;
+    constructor(pollIntervalMs?: number);
+    start(): void;
+    stop(): void;
+    /** Add symbols to track. IDs are auto-resolved from the symbol map. */
+    track(...symbols: string[]): void;
+    fetchAll(): Promise<void>;
+    private fetchBinance;
+    private fetchCoinGecko;
+    get(symbol: string): PriceTick | undefined;
+    getMultiple(symbols: string[]): PriceTick[];
+    getAll(): PriceTick[];
+    getTopMovers(limit?: number): PriceTick[];
+    formatPrice(tick: PriceTick): string;
+    /** Compact ticker line for the status bar. */
+    tickerLine(maxSymbols?: number): string;
+}
+export declare const priceFeed: PriceFeed;
+export declare const getPricesParams: import("@sinclair/typebox").TObject<{
+    symbols: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+}>;
+export declare function getPricesTool(_id: string, params: Static<typeof getPricesParams>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    details: Record<string, unknown>;
+}>;
+export declare const topMoversParams: import("@sinclair/typebox").TObject<{
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export declare function topMoversTool(_id: string, params: Static<typeof topMoversParams>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    details: {
+        count: number;
+    };
+}>;
+export declare const marketOverviewParams: import("@sinclair/typebox").TObject<{}>;
+export declare function marketOverviewTool(): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    details: {
+        totalMarketCap?: undefined;
+        avgChange24h?: undefined;
+        gainers?: undefined;
+        losers?: undefined;
+        assets?: undefined;
+    };
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    details: {
+        totalMarketCap: number;
+        avgChange24h: number;
+        gainers: number;
+        losers: number;
+        assets: number;
+    };
+}>;
+//# sourceMappingURL=PriceFeed.d.ts.map

package/dist/tools/PriceFeed.js

@@ -0,0 +1,282 @@
+/**
+ * PriceFeed — real-time price aggregation from CoinGecko and Binance.
+ *
+ * Provides:
+ *  - Background polling with configurable intervals
+ *  - Multi-source aggregation (prioritises Binance for precision, CG for breadth)
+ *  - 24h change, volume, and market cap tracking
+ *  - In-memory price cache for tool lookups
+ *  - Exposed as tools for the AI to query
+ */
+import { Type } from "@sinclair/typebox";
+import { EventEmitter } from "node:events";
+// ── CoinGecko ID map (common symbols) ────────────────────────────────────────
+const SYMBOL_TO_ID = {
+    btc: "bitcoin",
+    eth: "ethereum",
+    sol: "solana",
+    bnb: "binancecoin",
+    xrp: "ripple",
+    ada: "cardano",
+    doge: "dogecoin",
+    dot: "polkadot",
+    matic: "matic-network",
+    avax: "avalanche-2",
+    link: "chainlink",
+    uni: "uniswap",
+    atom: "cosmos",
+    arb: "arbitrum",
+    op: "optimism",
+    near: "near",
+    apt: "aptos",
+    sui: "sui",
+    sei: "sei-network",
+    inj: "injective-protocol",
+    tia: "celestia",
+    wld: "worldcoin-wld",
+    pepe: "pepe",
+    wif: "dogwifcoin",
+    bonk: "bonk",
+    floki: "floki",
+    shib: "shiba-inu",
+    aave: "aave",
+    mkr: "maker",
+    ldo: "lido-dao",
+    ens: "ethereum-name-service",
+    pendle: "pendle",
+    ltc: "litecoin",
+    bch: "bitcoin-cash",
+    etc: "ethereum-classic",
+    fil: "filecoin",
+    trx: "tron",
+    usdc: "usd-coin",
+    usdt: "tether",
+    dai: "dai",
+};
+// ── PriceFeed class ──────────────────────────────────────────────────────────
+export class PriceFeed extends EventEmitter {
+    prices = new Map();
+    pollInterval;
+    timer;
+    tracking = new Set(["btc", "eth", "sol", "bnb", "matic", "arb", "op", "avax"]);
+    constructor(pollIntervalMs = 60_000) {
+        super();
+        this.pollInterval = pollIntervalMs;
+    }
+    // ── Lifecycle ────────────────────────────────────────────────────────────
+    start() {
+        this.fetchAll();
+        this.timer = setInterval(() => this.fetchAll(), this.pollInterval);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+    }
+    /** Add symbols to track. IDs are auto-resolved from the symbol map. */
+    track(...symbols) {
+        for (const s of symbols)
+            this.tracking.add(s.toLowerCase());
+    }
+    // ── Fetch ────────────────────────────────────────────────────────────────
+    async fetchAll() {
+        // #17: Fan-out to Binance (primary) + CoinGecko (secondary)
+        // Binance: no rate limits on public endpoints, real-time order book prices
+        // CoinGecko: covers long-tail tokens Binance doesn't list, includes market cap
+        const [binanceResult, cgResult] = await Promise.allSettled([
+            this.fetchBinance(),
+            this.fetchCoinGecko(),
+        ]);
+        let updated = false;
+        // Binance wins for price precision on listed pairs
+        if (binanceResult.status === "fulfilled") {
+            for (const tick of binanceResult.value) {
+                this.prices.set(tick.symbol.toLowerCase(), tick);
+                updated = true;
+            }
+        }
+        // CoinGecko fills gaps (market cap data, unlisted tokens)
+        if (cgResult.status === "fulfilled") {
+            for (const tick of cgResult.value) {
+                const key = tick.symbol.toLowerCase();
+                const existing = this.prices.get(key);
+                if (!existing) {
+                    // Token not on Binance — add from CoinGecko
+                    this.prices.set(key, tick);
+                    updated = true;
+                }
+                else if (tick.marketCap > 0) {
+                    // Enrich Binance tick with market cap from CoinGecko
+                    existing.marketCap = tick.marketCap;
+                }
+            }
+        }
+        if (updated)
+            this.emit("prices", [...this.prices.values()]);
+    }
+    async fetchBinance() {
+        // Build list of USDT pairs for tracked symbols
+        const pairs = [...this.tracking]
+            .map(s => s.toUpperCase() + "USDT")
+            .filter(s => !s.startsWith("USDT") && !s.startsWith("DAI")); // skip stablecoins
+        if (!pairs.length)
+            return [];
+        const url = `https://api.binance.com/api/v3/ticker/24hr?symbols=${encodeURIComponent(JSON.stringify(pairs))}`;
+        const res = await fetch(url, {
+            signal: AbortSignal.timeout(8_000),
+            headers: { "User-Agent": "JellyOS/1.0" },
+        });
+        if (!res.ok)
+            throw new Error(`Binance ticker HTTP ${res.status}`);
+        const data = await res.json();
+        return data.map(d => ({
+            symbol: d.symbol.replace(/USDT$/, ""),
+            price: parseFloat(d.lastPrice),
+            change24h: parseFloat(d.priceChangePercent),
+            volume24h: parseFloat(d.quoteVolume),
+            marketCap: 0, // Binance doesn't provide market cap — CoinGecko fills this
+            high24h: parseFloat(d.highPrice),
+            low24h: parseFloat(d.lowPrice),
+            source: "binance",
+            timestamp: Date.now(),
+        }));
+    }
+    async fetchCoinGecko() {
+        const ids = [...this.tracking]
+            .map(s => SYMBOL_TO_ID[s])
+            .filter((id) => Boolean(id))
+            .join(",");
+        if (!ids)
+            return [];
+        const res = await fetch(`https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=${ids}&order=market_cap_desc&sparkline=false`, { signal: AbortSignal.timeout(10_000), headers: { "User-Agent": "JellyOS/1.0" } });
+        if (!res.ok)
+            throw new Error(`CoinGecko HTTP ${res.status}`);
+        const data = await res.json();
+        return data.map(coin => ({
+            symbol: coin.symbol.toUpperCase(),
+            price: coin.current_price,
+            change24h: coin.price_change_percentage_24h ?? 0,
+            volume24h: coin.total_volume ?? 0,
+            marketCap: coin.market_cap ?? 0,
+            high24h: coin.high_24h ?? 0,
+            low24h: coin.low_24h ?? 0,
+            source: "coingecko",
+            timestamp: Date.now(),
+        }));
+    }
+    // ── Query ─────────────────────────────────────────────────────────────────
+    get(symbol) {
+        return this.prices.get(symbol.toLowerCase());
+    }
+    getMultiple(symbols) {
+        return symbols.map(s => this.get(s)).filter(Boolean);
+    }
+    getAll() {
+        return [...this.prices.values()];
+    }
+    getTopMovers(limit = 5) {
+        return [...this.prices.values()]
+            .sort((a, b) => Math.abs(b.change24h) - Math.abs(a.change24h))
+            .slice(0, limit);
+    }
+    formatPrice(tick) {
+        const changeStr = tick.change24h >= 0
+            ? `+${tick.change24h.toFixed(2)}%`
+            : `${tick.change24h.toFixed(2)}%`;
+        const priceStr = tick.price < 1
+            ? `$${tick.price.toFixed(6)}`
+            : tick.price < 100
+                ? `$${tick.price.toFixed(2)}`
+                : `$${tick.price.toLocaleString()}`;
+        return `${tick.symbol.padEnd(6)} ${priceStr} ${changeStr}`;
+    }
+    /** Compact ticker line for the status bar. */
+    tickerLine(maxSymbols = 5) {
+        return [...this.prices.values()]
+            .slice(0, maxSymbols)
+            .map(t => {
+            const sign = t.change24h >= 0 ? "▲" : "▼";
+            const p = t.price < 1 ? t.price.toFixed(4) : t.price.toFixed(0);
+            return `${t.symbol} $${p} ${sign}${Math.abs(t.change24h).toFixed(1)}%`;
+        })
+            .join(" · ");
+    }
+}
+// ── Singleton ─────────────────────────────────────────────────────────────────
+export const priceFeed = new PriceFeed();
+// ── Tool: get_prices ─────────────────────────────────────────────────────────
+export const getPricesParams = Type.Object({
+    symbols: Type.Array(Type.String(), { description: "Symbols to fetch (e.g. btc, eth, sol)" }),
+});
+export async function getPricesTool(_id, params) {
+    const ticks = priceFeed.getAll();
+    if (ticks.length === 0) {
+        return {
+            content: [{ type: "text", text: "No price data available yet. Please wait for the first price update." }],
+            details: {},
+        };
+    }
+    const requested = params.symbols.map(s => s.toLowerCase());
+    const results = ticks.filter(t => requested.includes(t.symbol.toLowerCase()));
+    if (results.length === 0) {
+        return {
+            content: [{ type: "text", text: `No data for: ${params.symbols.join(", ")}. Available: ${ticks.map(t => t.symbol).join(", ")}` }],
+            details: {},
+        };
+    }
+    const text = results.map(t => priceFeed.formatPrice(t)).join("\n");
+    return {
+        content: [{ type: "text", text }],
+        details: results.reduce((acc, t) => {
+            acc[t.symbol] = { price: t.price, change24h: t.change24h, volume24h: t.volume24h, marketCap: t.marketCap, source: t.source };
+            return acc;
+        }, {}),
+    };
+}
+// ── Tool: get_top_movers ─────────────────────────────────────────────────────
+export const topMoversParams = Type.Object({
+    limit: Type.Optional(Type.Number({ default: 5, description: "Number of top movers to show" })),
+});
+export async function topMoversTool(_id, params) {
+    const movers = priceFeed.getTopMovers(params.limit ?? 5);
+    const text = movers.map(t => priceFeed.formatPrice(t)).join("\n");
+    return {
+        content: [{ type: "text", text: text || "No data available" }],
+        details: { count: movers.length },
+    };
+}
+// ── Tool: get_market_overview ────────────────────────────────────────────────
+export const marketOverviewParams = Type.Object({});
+export async function marketOverviewTool() {
+    const ticks = priceFeed.getAll();
+    if (ticks.length === 0) {
+        return {
+            content: [{ type: "text", text: "No market data available yet." }],
+            details: {},
+        };
+    }
+    const totalCap = ticks.reduce((s, t) => s + t.marketCap, 0);
+    const avgChange = ticks.reduce((s, t) => s + t.change24h, 0) / ticks.length;
+    const gainers = ticks.filter(t => t.change24h > 0).length;
+    const losers = ticks.filter(t => t.change24h < 0).length;
+    const text = [
+        `Market Overview (${ticks.length} assets tracked)`,
+        `Total Market Cap: $${(totalCap / 1e9).toFixed(1)}B`,
+        `Avg 24h Change: ${avgChange >= 0 ? "+" : ""}${avgChange.toFixed(2)}%`,
+        `Gainers: ${gainers} | Losers: ${losers}`,
+        `---`,
+        ...ticks.slice(0, 10).map(t => priceFeed.formatPrice(t)),
+    ].join("\n");
+    return {
+        content: [{ type: "text", text }],
+        details: {
+            totalMarketCap: totalCap,
+            avgChange24h: avgChange,
+            gainers,
+            losers,
+            assets: ticks.length,
+        },
+    };
+}
+//# sourceMappingURL=PriceFeed.js.map