perp-cli 0.5.3 → 0.6.1

package/dist/settings.js

@@ -19,10 +19,15 @@ const DEFAULTS = {
         pacifica: { taker: 0.00035, maker: 0.0001 },
         lighter: { taker: 0, maker: 0 },
     },
+    alerts: {
+        rules: [],
+        intervalSec: 300,
+        cooldownMin: 60,
+    },
 };
 export function loadSettings() {
     if (!existsSync(SETTINGS_FILE))
-        return { ...DEFAULTS, referralCodes: { ...DEFAULTS.referralCodes }, fees: { ...DEFAULTS.fees } };
+        return { ...DEFAULTS, referralCodes: { ...DEFAULTS.referralCodes }, fees: { ...DEFAULTS.fees }, alerts: { ...DEFAULTS.alerts } };
     try {
         const stored = JSON.parse(readFileSync(SETTINGS_FILE, "utf-8"));
         // Merge stored fees with defaults (so new exchanges get defaults)
@@ -47,11 +52,18 @@ export function loadSettings() {
                 hyperliquid: stored.referralApplied?.hyperliquid ?? DEFAULTS.referralApplied.hyperliquid,
                 lighter: stored.referralApplied?.lighter ?? DEFAULTS.referralApplied.lighter,
             },
+            alerts: {
+                discord: stored.alerts?.discord ?? DEFAULTS.alerts.discord,
+                telegram: stored.alerts?.telegram ?? DEFAULTS.alerts.telegram,
+                rules: Array.isArray(stored.alerts?.rules) ? stored.alerts.rules : DEFAULTS.alerts.rules,
+                intervalSec: stored.alerts?.intervalSec ?? DEFAULTS.alerts.intervalSec,
+                cooldownMin: stored.alerts?.cooldownMin ?? DEFAULTS.alerts.cooldownMin,
+            },
             fees,
         };
     }
     catch {
-        return { ...DEFAULTS, referralCodes: { ...DEFAULTS.referralCodes }, fees: { ...DEFAULTS.fees } };
+        return { ...DEFAULTS, referralCodes: { ...DEFAULTS.referralCodes }, fees: { ...DEFAULTS.fees }, alerts: { ...DEFAULTS.alerts } };
     }
 }
 export function saveSettings(settings) {

package/dist/telegram.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Telegram Bot API client.
+ *
+ * Sends messages to a user via Telegram Bot API (REST only).
+ * Requires: bot token (from @BotFather) + chat ID.
+ */
+export interface TelegramConfig {
+    botToken: string;
+    chatId: string;
+}
+/**
+ * Send a message to the configured chat.
+ */
+export declare function sendTelegramMessage(config: TelegramConfig, message: string, opts?: {
+    parseMode?: "Markdown" | "HTML";
+}): Promise<void>;
+/**
+ * Validate bot token by calling getMe.
+ * Returns the bot's username if valid.
+ */
+export declare function validateTelegramBot(token: string): Promise<{
+    valid: boolean;
+    username: string;
+}>;
+/**
+ * Get recent updates to find the chat ID from a user who messaged the bot.
+ * User must send /start to the bot first.
+ */
+export declare function getRecentChatId(token: string): Promise<{
+    chatId: string;
+    firstName: string;
+} | null>;

package/dist/telegram.js

@@ -0,0 +1,74 @@
+/**
+ * Telegram Bot API client.
+ *
+ * Sends messages to a user via Telegram Bot API (REST only).
+ * Requires: bot token (from @BotFather) + chat ID.
+ */
+const TG_API = "https://api.telegram.org";
+/**
+ * Send a message to the configured chat.
+ */
+export async function sendTelegramMessage(config, message, opts) {
+    const res = await fetch(`${TG_API}/bot${config.botToken}/sendMessage`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            chat_id: config.chatId,
+            text: message,
+            parse_mode: opts?.parseMode,
+        }),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`Telegram send failed (${res.status}): ${body}`);
+    }
+    const data = (await res.json());
+    if (!data.ok) {
+        throw new Error(`Telegram API error: ${data.description ?? "unknown"}`);
+    }
+}
+/**
+ * Validate bot token by calling getMe.
+ * Returns the bot's username if valid.
+ */
+export async function validateTelegramBot(token) {
+    try {
+        const res = await fetch(`${TG_API}/bot${token}/getMe`);
+        if (!res.ok)
+            return { valid: false, username: "" };
+        const data = (await res.json());
+        if (!data.ok || !data.result)
+            return { valid: false, username: "" };
+        return { valid: true, username: `@${data.result.username}` };
+    }
+    catch {
+        return { valid: false, username: "" };
+    }
+}
+/**
+ * Get recent updates to find the chat ID from a user who messaged the bot.
+ * User must send /start to the bot first.
+ */
+export async function getRecentChatId(token) {
+    try {
+        const res = await fetch(`${TG_API}/bot${token}/getUpdates?limit=10&offset=-10`);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        if (!data.ok || !data.result?.length)
+            return null;
+        // Find the most recent /start message or any message
+        for (const update of data.result.reverse()) {
+            if (update.message?.chat?.id) {
+                return {
+                    chatId: String(update.message.chat.id),
+                    firstName: update.message.chat.first_name ?? "",
+                };
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perp-cli",
-  "version": "0.5.3",
+  "version": "0.6.1",
   "description": "Multi-DEX Perpetual Futures CLI - Pacifica, Hyperliquid, Lighter",
   "bin": {
     "perp": "dist/index.js",
@@ -29,7 +29,14 @@
     "cli",
     "trading",
     "funding-rate",
-    "arbitrage"
+    "arbitrage",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-agent",
+    "perpetual-futures",
+    "defi",
+    "ethereum"
   ],
   "license": "MIT",
   "engines": {

package/skills/perp-cli/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@hypurrquant/perp-cli-skill",
+  "version": "0.5.3",
+  "description": "AI agent skill for perp-cli — multi-DEX perpetual futures trading via CLI",
+  "keywords": [
+    "ai-skill",
+    "claude",
+    "mcp",
+    "perp",
+    "perpetual-futures",
+    "trading",
+    "hyperliquid",
+    "pacifica",
+    "lighter",
+    "defi",
+    "arbitrage",
+    "funding-rate"
+  ],
+  "author": "hypurrquant",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hypurrquant/perp-cli",
+    "directory": "skills/perp-cli"
+  },
+  "homepage": "https://github.com/hypurrquant/perp-cli#ai-agent-skill",
+  "files": [
+    "SKILL.md",
+    "references",
+    "scripts"
+  ],
+  "peerDependencies": {
+    "perp-cli": ">=0.5.0"
+  }
+}