@jellyos/agent 0.1.4 → 0.1.6

package/README.npm.md

@@ -0,0 +1,212 @@
+# @jellyos/agent
+
+<div align="center">
+
+<pre>
+   ██╗███████╗██╗     ██╗  ██╗   ██╗  ██████╗ ███████╗
+   ██║██╔════╝██║     ██║  ╚██╗ ██╔╝ ██╔═══██╗██╔════╝
+   ██║█████╗  ██║     ██║   ╚████╔╝  ██║   ██║███████╗
+██ ██║██╔══╝  ██║     ██║    ╚██╔╝   ██║   ██║╚════██║
+╚█████╔╝███████╗███████╗██║   ██║    ╚██████╔╝███████║
+ ╚════╝ ╚══════╝╚══════╝╚═╝   ╚═╝     ╚═════╝ ╚══════╝
+</pre>
+
+**Autonomous AI trading agent. Runs 100% locally. No server. No inbound ports.**
+
+[![npm](https://img.shields.io/npm/v/@jellyos/agent?color=14b8a6&style=flat-square)](https://www.npmjs.com/package/@jellyos/agent)
+[![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen?style=flat-square)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](LICENSE)
+
+</div>
+
+---
+
+## What's in this package
+
+This NPM package contains the **core JellyOS agent engine**:
+
+| Component | Description |
+|-----------|-------------|
+| `AgentRunner` | Multi-model agentic loop with tool dispatch, swarm routing, reflection |
+| `ModelClient` | Streaming OpenAI-compatible client with fallback rotation + thinking mode |
+| `ModelRegistry` | Dynamic model discovery, tier classification, cost tracking (356 models) |
+| `SwarmRouter` | LLM-based task decomposition + parallel sub-agent execution |
+| `SessionManager` | Conversation history with 3-tier smart compaction + turbo headroom tracking |
+| `MemoryStore` | SQLite long-term memory (cross-session, persistent) |
+| `GoalManager` | Persistent cross-session goals injected into every turn |
+| `ContextStore` | Ephemeral task context folders (auto-deleted on completion) |
+| `AgentScheduler` | Cron + price-trigger autonomous task scheduling |
+| `MCPServer` | Model Context Protocol server (Claude Desktop / Cursor compatible) |
+| **18 built-in tools** | Prices, candles+TA, news, Fear&Greed, funding rates, BTC mempool, DeFi TVL, Solana TPS, model management, goals, tasks, scheduling |
+| Ink TUI | Terminal UI with live ticker, context pressure monitor, approval gates |
+
+For wallets, vault, on-chain signing, and the full 28-tool trading suite → [JellyOS full project](https://github.com/jelly-chain/JellyOS)
+
+---
+
+## Install
+
+```bash
+npm install -g @jellyos/agent
+```
+
+## Quick Start
+
+```bash
+mkdir -p ~/.jelly
+echo "OPENROUTER_API_KEY=sk-or-..." > ~/.jelly/.env
+jellyos
+```
+
+## Headless Mode
+
+```bash
+# Single turn, print to stdout, exit
+jellyos --headless "what is the current ETH price and RSI on the 1h chart?"
+
+# Use in scripts
+RESULT=$(jellyos --headless "summarize BTC market conditions")
+echo "$RESULT"
+```
+
+## MCP Server (Claude Desktop / Cursor)
+
+```bash
+# Start MCP server — exposes all 18 tools to any MCP client
+jellyos-mcp
+```
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "jellyos": {
+      "command": "jellyos-mcp"
+    }
+  }
+}
+```
+
+---
+
+## Configuration (`~/.jelly/.env`)
+
+```env
+# AI Provider (pick one)
+OPENROUTER_API_KEY=sk-or-...    # recommended — 356 models
+ANTHROPIC_API_KEY=sk-ant-...    # direct Anthropic
+OPENAI_API_KEY=sk-...           # direct OpenAI
+OPENAI_BASE_URL=http://localhost:11434/v1  # Ollama / local
+
+# Optional model pool (up to 5, rotated on rate-limit)
+JELLY_MODEL_1=anthropic/claude-opus-4.7
+JELLY_MODEL_2=openai/gpt-5.5
+JELLY_MODEL_3=google/gemini-3.5-flash
+```
+
+---
+
+## Built-in Tools
+
+| Tool | Description | Source |
+|------|-------------|--------|
+| `get_prices` | Live prices + 24h change | Binance + CoinGecko |
+| `get_candles` | OHLCV data + RSI/MACD/Bollinger analysis | Binance |
+| `get_top_movers` | Largest 24h movers | Binance |
+| `get_market_overview` | Aggregated market summary | Multi-source |
+| `get_news` | Headlines + sentiment scoring | CoinDesk/CoinTelegraph/TheBlock |
+| `get_fear_greed` | Fear & Greed Index (7-day history) | alternative.me |
+| `get_funding_rates` | Perp funding rates (long/short bias) | Binance |
+| `get_btc_mempool` | BTC pending txs + fee rates | mempool.space |
+| `get_defi_tvl` | DeFi TVL by chain | DeFiLlama |
+| `get_solana_stats` | Solana TPS + network health | Solana RPC |
+| `analyze_ta` | RSI, MACD, Bollinger, EMA, ATR on price arrays | Local |
+| `list_models` | Search 356 available AI models | OpenRouter |
+| `pick_model` | Find cheapest model for requirements | OpenRouter |
+| `set_goal` / `list_goals` / `complete_goal` | Persistent cross-session goals | Local |
+| `schedule_task` / `list_schedule` | Cron + price-trigger scheduling | Local |
+| `read_task_context` / `list_tasks` | Ephemeral task context folders | Local |
+| `cost_report` | Session + lifetime token usage | Local |
+
+All data tools are free — no API keys required.
+
+---
+
+## Effect Levels
+
+```
+/effect eco      # minimal tool calls, cheapest models
+/effect normal   # balanced (default)
+/effect turbo    # 2 parallel sub-agents for complex tasks
+/effect max      # 5 agents + thinking models for deep research
+```
+
+---
+
+## Extension API
+
+```typescript
+import { Type } from "@jellyos/agent";
+import type { ExtensionAPI } from "@jellyos/agent";
+
+export default function (agent: ExtensionAPI) {
+  agent.setSystemPrompt("You are a DeFi yield optimizer.");
+
+  agent.registerTool({
+    name:             "get_apy",
+    label:            "Get APY",
+    description:      "Fetch current APY for a DeFi protocol",
+    requiresApproval: false,  // set true for money-moving tools
+    parameters: Type.Object({
+      protocol: Type.String({ description: "Protocol name e.g. aave" }),
+    }),
+    async execute(_id, { protocol }) {
+      const res  = await fetch(`https://api.llama.fi/protocol/${protocol}`);
+      const data = await res.json() as Record<string, unknown>;
+      return {
+        content: [{ type: "text", text: `${protocol}: ${JSON.stringify(data)}` }],
+        details: {},
+      };
+    },
+  });
+
+  agent.on("session_start", async (ctx) => {
+    ctx.ui.setStatus("yields", "ready");
+  });
+}
+```
+
+```bash
+jellyos --extension ./my-extension.ts
+```
+
+---
+
+## REPL Commands
+
+```
+/help                  List commands
+/effect [level]        eco | normal | turbo | max
+/prices [symbols]      Quick price check
+/news                  Latest headlines + sentiment
+/goals                 List active goals
+/goal add <text>       Add a persistent goal
+/goal done <id>        Mark goal complete
+/schedule              List scheduled tasks
+/tasks                 List active context folders
+/traces                Show last 5 agent traces with timing
+/memory <query>        Search long-term memory
+/models [query]        Search available AI models
+/cost                  Session + lifetime cost report
+/approve | /deny       Respond to tool approval gates
+/palette               Full command + tool list
+/clear                 Clear conversation history
+Escape                 Abort in-flight model stream
+Ctrl-C                 Exit
+```
+
+---
+
+## License
+
+MIT

package/bin/jellyos-mcp

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * jellyos-mcp — JellyOS MCP server entry point.
+ * Exposes all JellyOS tools via the Model Context Protocol (stdio transport).
+ * Compatible with Claude Desktop, Cursor, Continue, and any MCP client.
+ */
+import { createRequire }   from "module";
+import { fileURLToPath }   from "url";
+import { dirname, join }   from "path";
+import { existsSync }      from "fs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require   = createRequire(import.meta.url);
+
+const distEntry = join(__dirname, "..", "dist", "mcp", "entry.js");
+const srcEntry  = join(__dirname, "..", "src",  "mcp",  "entry.ts");
+
+if (existsSync(distEntry)) {
+  await import(distEntry);
+} else if (existsSync(srcEntry)) {
+  const { register } = await import("tsx/esm");
+  await import(srcEntry);
+} else {
+  process.stderr.write("JellyOS MCP: run 'npm run build' first\n");
+  process.exit(1);
+}

package/dist/api/ExtensionAPI.d.ts

@@ -24,6 +24,12 @@ export interface ToolDef<P extends TSchema = TSchema> {
     label: string;
     description: string;
     parameters: P;
+    /**
+     * #10: If true, the agent pauses before executing this tool and asks the
+     * user for confirmation. Use for any tool that moves money or signs txs.
+     * The REPL renders an [APPROVE] prompt — user types y/n within 60 seconds.
+     */
+    requiresApproval?: boolean;
     execute(id: string, params: Static<P>): Promise<ToolContent>;
 }
 export interface TuiHeader {
@@ -54,6 +60,11 @@ export interface UIContext {
      * Pi compat — accepted but engine renders its own Ink header.
      */
     setHeader(factory: HeaderFactory): void;
+    /**
+     * Open the interactive model selector overlay.
+     * @param query Optional initial search query to pre-filter the list.
+     */
+    showModelSelector(query?: string): void;
     theme: ThemeContext;
 }
 export interface CommandContext {

package/dist/cli.js

@@ -2,7 +2,7 @@
  * cli.ts — JellyOS entry point.
  * Completely standalone — all outbound, no inbound ports exposed.
  */
-import { readFileSync, existsSync } from "node:fs";
+import { readFileSync, existsSync, writeFileSync } from "node:fs";
 import { resolve, join } from "node:path";
 import { homedir } from "node:os";
 import { render } from "ink";
@@ -14,6 +14,9 @@ import { App } from "./tui/App.js";
 import { T } from "./tui/theme.js";
 import { modelRegistry } from "./models/ModelRegistry.js";
 import { CostTracker } from "./models/CostTracker.js";
+import { AgentRunner } from "./runner/AgentRunner.js";
+import { SessionManager } from "./session/SessionManager.js";
+import { makeTheme } from "./tui/theme.js";
 // ── Load env vars from ~/.jelly/.env ─────────────────────────────────────────
 const JELLY_HOME = process.env.JELLYOS_HOME ?? join(homedir(), ".jelly");
 const envPath = join(JELLY_HOME, ".env");
@@ -77,16 +80,89 @@ function loadContext() {
         return { effectLevel: "normal", chain: "ethereum" };
     try {
         const ctx = JSON.parse(readFileSync(ctxPath, "utf-8"));
+        if (ctx.model && typeof ctx.model === "string") {
+            process.env.DEFAULT_MODEL = ctx.model;
+            try {
+                const ef = join(JELLY_HOME, ".env");
+                const c = existsSync(ef) ? readFileSync(ef, "utf-8") : "";
+                const re = /^DEFAULT_MODEL=.*$/m;
+                writeFileSync(ef, re.test(c) ? c.replace(re, `DEFAULT_MODEL=${ctx.model}`) : c + `\nDEFAULT_MODEL=${ctx.model}\n`, "utf-8");
+            }
+            catch { /* non-fatal */ }
+        }
         return { effectLevel: ctx.effect_level ?? "normal", chain: ctx.active_chain ?? "ethereum" };
     }
     catch {
         return { effectLevel: "normal", chain: "ethereum" };
     }
 }
-// ── Boot ──────────────────────────────────────────────────────────────────────
-(async () => {
-    console.clear();
-    console.log(T.accent(`
+// ── Headless mode (#26) ─────────────────────────────────────────────────────
+const headlessIdx = args.indexOf("--headless");
+const headlessMsg = headlessIdx >= 0 ? args[headlessIdx + 1] : null;
+if (headlessMsg) {
+    (async () => {
+        if (existsSync(envPath))
+            loadDotenv({ path: envPath, override: false });
+        const registry = new Registry();
+        if (extensionPath) {
+            try {
+                await loadExtension(extensionPath, registry);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                process.stderr.write(`Extension load failed: ${msg}\n`);
+                process.exit(1);
+            }
+        }
+        await modelRegistry.initialise();
+        const session = new SessionManager();
+        const prompt = systemPrompt || registry.getSystemPrompt() || "You are JellyOS, an autonomous AI trading agent.";
+        session.setSystemPrompt(prompt);
+        const theme = makeTheme();
+        const nullUi = {
+            notify: () => { },
+            setStatus: () => { },
+            setTheme: () => { },
+            setHeader: () => { },
+            showModelSelector: () => { },
+            theme,
+        };
+        const sessionCtx = {
+            ui: nullUi,
+            hasUI: false,
+            config: { OPENROUTER_API_KEY: process.env.OPENROUTER_API_KEY },
+        };
+        // Fire session_start hooks
+        await registry.fireHook("session_start", sessionCtx);
+        session.setSystemPrompt(registry.getSystemPrompt() || prompt);
+        let exitCode = 0;
+        const runner = new AgentRunner(registry, session, (event) => {
+            if (event.type === "text_delta")
+                process.stdout.write(event.text);
+            if (event.type === "turn_done")
+                process.stdout.write("\n");
+            if (event.type === "error") {
+                process.stderr.write(`\nError: ${event.message}\n`);
+                exitCode = 1;
+            }
+        }, sessionCtx, "normal", modelRegistry);
+        try {
+            await runner.run(headlessMsg);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            process.stderr.write(`Runner error: ${msg}\n`);
+            exitCode = 1;
+        }
+        await registry.fireHook("session_end", sessionCtx);
+        process.exit(exitCode);
+    })();
+}
+else {
+    // ── Boot (interactive TUI) ────────────────────────────────────────────────────
+    (async () => {
+        console.clear();
+        console.log(T.accent(`
    ██╗███████╗██╗     ██╗  ██╗   ██╗  ██████╗ ███████╗
    ██║██╔════╝██║     ██║  ╚██╗ ██╔╝ ██╔═══██╗██╔════╝
    ██║█████╗  ██║     ██║   ╚████╔╝  ██║   ██║███████╗
@@ -94,50 +170,52 @@ function loadContext() {
 ╚█████╔╝███████╗███████╗██║   ██║    ╚██████╔╝███████║
  ╚════╝ ╚══════╝╚══════╝╚═╝   ╚═╝     ╚═════╝ ╚══════╝
   `));
-    console.log(T.muted("  Standalone AI trading agent — all local, zero exposure\n"));
-    const registry = new Registry();
-    const { effectLevel, chain } = loadContext();
-    // These callbacks are forwarded into the extension API so ui.setStatus
-    // and ui.notify work even during the session_start hook (before Ink mounts).
-    let _notifyFn = null;
-    let _setStatusFn = null;
-    if (extensionPath) {
-        try {
-            console.log(T.muted(`  Loading: ${extensionPath}`));
-            await loadExtension(extensionPath, registry, {
-                onNotify: (msg) => { _notifyFn?.(msg); },
-                onStatusUpdate: (k, v) => { _setStatusFn?.(k, v); },
-            });
-            console.log(T.success(`  ✓ ${registry.listTools().length} tools · ${registry.listCommands().length} commands`));
+        console.log(T.muted("  Standalone AI trading agent — all local, zero exposure\n"));
+        const registry = new Registry();
+        const { effectLevel, chain } = loadContext();
+        let _notifyFn = null;
+        let _setStatusFn = null;
+        let _showModelSelectorFn = null;
+        if (extensionPath) {
+            try {
+                console.log(T.muted(`  Loading: ${extensionPath}`));
+                await loadExtension(extensionPath, registry, {
+                    onNotify: (msg) => { _notifyFn?.(msg); },
+                    onStatusUpdate: (k, v) => { _setStatusFn?.(k, v); },
+                    onShowModelSelector: (q) => { _showModelSelectorFn?.(q); },
+                });
+                console.log(T.success(`  ✓ ${registry.listTools().length} tools · ${registry.listCommands().length} commands`));
+            }
+            catch (e) {
+                console.error(T.error(`  ✗ Extension load failed: ${e.message}`));
+                process.exit(1);
+            }
         }
-        catch (e) {
-            console.error(T.error(`  ✗ Extension load failed: ${e.message}`));
-            process.exit(1);
+        else {
+            console.log(T.warn("  No extension found — base agent only."));
+            console.log(T.muted("  Run from jellyos project root or pass --extension path\n"));
         }
-    }
-    else {
-        console.log(T.warn("  No extension found — base agent only."));
-        console.log(T.muted("  Run from jellyos project root or pass --extension path\n"));
-    }
-    if (!process.env.OPENROUTER_API_KEY && !process.env.ANTHROPIC_API_KEY && !process.env.OPENAI_API_KEY) {
-        console.log(T.warn("  No API key found. Set OPENROUTER_API_KEY in ~/.jelly/.env\n"));
-    }
-    // ── Initialise model registry & cost tracker ─────────────────────────────
-    const costTracker = new CostTracker(modelRegistry);
-    console.log(T.muted("  Discovering available models via OpenRouter…"));
-    await modelRegistry.initialise();
-    console.log(T.success(`  ✓ ${modelRegistry.modelCount} models available \n`));
-    await new Promise(r => setTimeout(r, 500));
-    console.clear();
-    render(React.createElement(App, {
-        registry,
-        systemPrompt,
-        effectLevel,
-        chain,
-        modelReg: modelRegistry,
-        costTracker,
-        onNotifyReady: (fn) => { _notifyFn = fn; },
-        onStatusReady: (fn) => { _setStatusFn = fn; },
-    }), { exitOnCtrlC: false });
-})();
+        if (!process.env.OPENROUTER_API_KEY && !process.env.ANTHROPIC_API_KEY && !process.env.OPENAI_API_KEY) {
+            console.log(T.warn("  No API key found. Set OPENROUTER_API_KEY in ~/.jelly/.env\n"));
+        }
+        // ── Initialise model registry & cost tracker ─────────────────────────────
+        const costTracker = new CostTracker(modelRegistry);
+        console.log(T.muted("  Discovering available models via OpenRouter…"));
+        await modelRegistry.initialise();
+        console.log(T.success(`  ✓ ${modelRegistry.modelCount} models available \n`));
+        await new Promise(r => setTimeout(r, 500));
+        console.clear();
+        render(React.createElement(App, {
+            registry,
+            systemPrompt,
+            effectLevel,
+            chain,
+            modelReg: modelRegistry,
+            costTracker,
+            onNotifyReady: (fn) => { _notifyFn = fn; },
+            onStatusReady: (fn) => { _setStatusFn = fn; },
+            onModelSelectorReady: (fn) => { _showModelSelectorFn = fn; },
+        }), { exitOnCtrlC: false });
+    })();
+} // end headless else
 //# sourceMappingURL=cli.js.map

package/dist/index.d.ts

@@ -12,17 +12,30 @@ export { Registry } from "./api/Registry.js";
 export { AgentRunner } from "./runner/AgentRunner.js";
 export { ModelClient, resolveModelConfig } from "./runner/ModelClient.js";
 export { ToolDispatcher } from "./runner/ToolDispatcher.js";
-export { SessionManager } from "./session/SessionManager.js";
 export { loadExtension } from "./loader.js";
 export { makeTheme, T, JELLY_COLORS } from "./tui/theme.js";
 export { ModelRegistry, modelRegistry, classifyModel } from "./models/ModelRegistry.js";
 export { CostTracker } from "./models/CostTracker.js";
 export type { OpenRouterModel, TieredModel, TieredPool, ModelTier } from "./models/ModelRegistry.js";
 export type { UsageEntry, SessionUsage, LifetimeUsage } from "./models/CostTracker.js";
-export { fullAnalysis, rsi, macd, ema, sma, bollingerBands, atr } from "./tools/TechnicalAnalysis.js";
+export { fullAnalysis, rsi, macd, ema, sma, bollingerBands, atr, getCandlesTool, getCandlesParams } from "./tools/TechnicalAnalysis.js";
 export { PriceFeed, priceFeed, getPricesTool, topMoversTool, marketOverviewTool } from "./tools/PriceFeed.js";
 export { NewsFeed, newsFeed, getNewsTool, scoreSentiment } from "./tools/NewsSentiment.js";
+export { getFearGreedTool, fundingRatesParams, getFundingRatesTool, getBtcMempoolTool, getDefiTvlTool, getSolanaStatsTool, } from "./tools/MarketSentiment.js";
 export type { OHLCV, AnalysisResult } from "./tools/TechnicalAnalysis.js";
 export type { PriceTick } from "./tools/PriceFeed.js";
 export type { NewsItem, SentimentReport } from "./tools/NewsSentiment.js";
+export { SessionManager } from "./session/SessionManager.js";
+export { MemoryStore, memoryStore } from "./session/MemoryStore.js";
+export { GoalManager, goalManager } from "./session/GoalManager.js";
+export { ContextStore, contextStore } from "./session/ContextStore.js";
+export type { MemoryEntry, RecentSession } from "./session/MemoryStore.js";
+export type { Goal } from "./session/GoalManager.js";
+export type { TaskContext } from "./session/ContextStore.js";
+export type { ContextPressure } from "./session/SessionManager.js";
+export { MCPServer } from "./mcp/server.js";
+export { AgentScheduler, agentScheduler } from "./scheduler/AgentScheduler.js";
+export type { ScheduledTask, PriceTrigger } from "./scheduler/AgentScheduler.js";
+export { Tracer } from "./telemetry/Tracer.js";
+export type { Span, Trace } from "./telemetry/Tracer.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -15,8 +15,6 @@ export { Registry } from "./api/Registry.js";
 export { AgentRunner } from "./runner/AgentRunner.js";
 export { ModelClient, resolveModelConfig } from "./runner/ModelClient.js";
 export { ToolDispatcher } from "./runner/ToolDispatcher.js";
-// Session
-export { SessionManager } from "./session/SessionManager.js";
 // Loader (for embedding the agent in other tools)
 export { loadExtension } from "./loader.js";
 // Theme
@@ -25,7 +23,19 @@ export { makeTheme, T, JELLY_COLORS } from "./tui/theme.js";
 export { ModelRegistry, modelRegistry, classifyModel } from "./models/ModelRegistry.js";
 export { CostTracker } from "./models/CostTracker.js";
 // Tools
-export { fullAnalysis, rsi, macd, ema, sma, bollingerBands, atr } from "./tools/TechnicalAnalysis.js";
+export { fullAnalysis, rsi, macd, ema, sma, bollingerBands, atr, getCandlesTool, getCandlesParams } from "./tools/TechnicalAnalysis.js";
 export { PriceFeed, priceFeed, getPricesTool, topMoversTool, marketOverviewTool } from "./tools/PriceFeed.js";
 export { NewsFeed, newsFeed, getNewsTool, scoreSentiment } from "./tools/NewsSentiment.js";
+export { getFearGreedTool, fundingRatesParams, getFundingRatesTool, getBtcMempoolTool, getDefiTvlTool, getSolanaStatsTool, } from "./tools/MarketSentiment.js";
+// Session / Memory / Goals / Context
+export { SessionManager } from "./session/SessionManager.js";
+export { MemoryStore, memoryStore } from "./session/MemoryStore.js";
+export { GoalManager, goalManager } from "./session/GoalManager.js";
+export { ContextStore, contextStore } from "./session/ContextStore.js";
+// MCP server
+export { MCPServer } from "./mcp/server.js";
+// Scheduler
+export { AgentScheduler, agentScheduler } from "./scheduler/AgentScheduler.js";
+// Telemetry
+export { Tracer } from "./telemetry/Tracer.js";
 //# sourceMappingURL=index.js.map

package/dist/loader.d.ts

@@ -7,17 +7,10 @@
  */
 import { Registry } from "./api/Registry.js";
 export interface LoaderOptions {
-    /**
-     * Called when the extension uses ui.setStatus(key, value).
-     * The App component passes a state-setter here so status badges update live.
-     */
     onStatusUpdate?: (key: string, value: string) => void;
-    /**
-     * Called when the extension calls ui.notify(message).
-     * Before the TUI is mounted, the App wires this to React state.
-     * We store the latest notifier here so the extension can call it any time.
-     */
     onNotify?: (message: string) => void;
+    /** Called when the extension calls ui.showModelSelector(query). */
+    onShowModelSelector?: (query?: string) => void;
 }
 export declare function loadExtension(extensionPath: string, registry: Registry, opts?: LoaderOptions): Promise<void>;
 //# sourceMappingURL=loader.d.ts.map

package/dist/loader.js

@@ -15,14 +15,15 @@ export async function loadExtension(extensionPath, registry, opts = {}) {
         throw new Error(`Extension file not found: ${abs}`);
     }
     const theme = makeTheme();
-    // Live-updateable notifier — App.tsx replaces this once mounted
     let _notify = opts.onNotify ?? ((_msg) => { });
     let _setStatus = opts.onStatusUpdate ?? ((_k, _v) => { });
+    let _showModelSelector = opts.onShowModelSelector ?? ((_q) => { });
     const ui = {
         notify(message) { _notify(message); },
         setStatus(key, value) { _setStatus(key, value); },
         setTheme(_name) { },
         setHeader(_factory) { },
+        showModelSelector(query) { _showModelSelector(query); },
         theme,
     };
     const api = {

package/dist/mcp/entry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entry.d.ts.map

package/dist/mcp/entry.js

@@ -0,0 +1,71 @@
+/**
+ * MCP server entry — bootstraps the Registry with built-in tools
+ * and starts the MCP stdio server.
+ */
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { existsSync } from "node:fs";
+import { config as loadDotenv } from "dotenv";
+import { Registry } from "../api/Registry.js";
+import { loadExtension } from "../loader.js";
+import { MCPServer } from "./server.js";
+import { modelRegistry } from "../models/ModelRegistry.js";
+import { getPricesTool, topMoversTool, marketOverviewTool, getPricesParams, topMoversParams, marketOverviewParams, priceFeed, } from "../tools/PriceFeed.js";
+import { getNewsTool, getNewsParams, newsFeed } from "../tools/NewsSentiment.js";
+import { getCandlesParams, getCandlesTool, analyzeTAParams, fullAnalysis } from "../tools/TechnicalAnalysis.js";
+import { getFearGreedTool, fearGreedParams, getFundingRatesTool, fundingRatesParams, getBtcMempoolTool, btcMempoolParams, getDefiTvlTool, defiTvlParams, getSolanaStatsTool, solanaStatsParams, } from "../tools/MarketSentiment.js";
+const JELLY_HOME = process.env.JELLYOS_HOME ?? join(homedir(), ".jelly");
+const envPath = join(JELLY_HOME, ".env");
+if (existsSync(envPath))
+    loadDotenv({ path: envPath, override: false });
+const registry = new Registry();
+// Load optional extension from --extension arg
+const extIdx = process.argv.indexOf("--extension");
+const extPath = extIdx >= 0 ? process.argv[extIdx + 1] : null;
+if (extPath && existsSync(extPath)) {
+    try {
+        await loadExtension(extPath, registry);
+    }
+    catch (e) {
+        process.stderr.write(`[MCP] Extension load failed: ${e}\n`);
+    }
+}
+// Register all built-in tools
+await modelRegistry.initialise();
+const mk = modelRegistry;
+registry.addTool({ name: "list_models", label: "List Models", description: "Search available AI models.", parameters: mk["listModelsParams"], execute: (id, p) => mk["listModelsTool"](id, p) });
+registry.addTool({ name: "get_prices", label: "Get Prices", description: "Get live crypto prices.", parameters: getPricesParams, execute: (id, p) => getPricesTool(id, p) });
+registry.addTool({ name: "get_top_movers", label: "Top Movers", description: "Top 24h price movers.", parameters: topMoversParams, execute: (id, p) => topMoversTool(id, p) });
+registry.addTool({ name: "market_overview", label: "Market Overview", description: "Aggregated market data.", parameters: marketOverviewParams, execute: () => marketOverviewTool() });
+registry.addTool({ name: "get_news", label: "Get News", description: "Crypto news + sentiment.", parameters: getNewsParams, execute: (id, p) => getNewsTool(id, p) });
+registry.addTool({ name: "get_candles", label: "Get Candles", description: "OHLCV + TA analysis from Binance.", parameters: getCandlesParams, execute: (id, p) => getCandlesTool(id, p) });
+registry.addTool({ name: "get_fear_greed", label: "Fear & Greed", description: "Crypto fear & greed index.", parameters: fearGreedParams, execute: (id, p) => getFearGreedTool(id, p) });
+registry.addTool({ name: "get_funding_rates", label: "Funding Rates", description: "Perp funding rates.", parameters: fundingRatesParams, execute: (id, p) => getFundingRatesTool(id, p) });
+registry.addTool({ name: "get_btc_mempool", label: "BTC Mempool", description: "BTC mempool + fees.", parameters: btcMempoolParams, execute: () => getBtcMempoolTool() });
+registry.addTool({ name: "get_defi_tvl", label: "DeFi TVL", description: "DeFiLlama TVL.", parameters: defiTvlParams, execute: (id, p) => getDefiTvlTool(id, p) });
+registry.addTool({ name: "get_solana_stats", label: "Solana Stats", description: "Solana TPS + health.", parameters: solanaStatsParams, execute: () => getSolanaStatsTool() });
+registry.addTool({
+    name: "analyze_ta", label: "Technical Analysis", description: "RSI, MACD, Bollinger on price arrays.",
+    parameters: analyzeTAParams,
+    execute: async (_id, p) => {
+        const params = p;
+        const closes = params.prices;
+        const candles = closes.map((c, i) => ({
+            timestamp: i, open: c, high: (params.highs?.[i] ?? c), low: (params.lows?.[i] ?? c), close: c, volume: (params.volumes?.[i] ?? 0),
+        }));
+        const results = fullAnalysis(candles);
+        const text = results.map(r => {
+            const s = r.signal === "bullish" ? "🟢" : r.signal === "bearish" ? "🔴" : "⚪";
+            return `${s} ${r.indicator}: ${typeof r.value === "number" ? r.value.toFixed(2) : String(r.value)}`;
+        }).join("\n");
+        return { content: [{ type: "text", text: `Technical Analysis:\n${text}` }], details: {} };
+    },
+});
+// Start price + news feeds
+priceFeed.track("btc", "eth", "sol", "bnb", "matic", "arb", "op", "avax");
+priceFeed.start();
+newsFeed.start();
+// Start MCP server
+const server = new MCPServer(registry);
+await server.run();
+//# sourceMappingURL=entry.js.map