@praveencs/agent 0.9.29 → 0.10.0

package/agent-skills/plugins/telegram/tools/telegram.js

@@ -0,0 +1,131 @@
+/**
+ * Telegram Bot API automation tool.
+ */
+export async function execute(params) {
+    const { action, ...args } = params;
+    const token = process.env.TELEGRAM_BOT_TOKEN;
+
+    if (!token) {
+        throw new Error('TELEGRAM_BOT_TOKEN is not set. Create a bot via @BotFather on Telegram.');
+    }
+
+    async function tgFetch(method, body = {}) {
+        const res = await fetch(`https://api.telegram.org/bot${token}/${method}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body)
+        });
+        const data = await res.json();
+        if (!data.ok) throw new Error(`Telegram API Error: ${data.description}`);
+        return data.result;
+    }
+
+    try {
+        switch (action) {
+            case 'send_message':
+                return await tgFetch('sendMessage', {
+                    chat_id: args.chat_id,
+                    text: args.text,
+                    parse_mode: args.parse_mode || 'HTML',
+                    reply_to_message_id: args.reply_to
+                });
+
+            case 'send_photo':
+                return await tgFetch('sendPhoto', {
+                    chat_id: args.chat_id,
+                    photo: args.photo,
+                    caption: args.caption
+                });
+
+            case 'send_document':
+                return await tgFetch('sendDocument', {
+                    chat_id: args.chat_id,
+                    document: args.document,
+                    caption: args.caption
+                });
+
+            case 'edit_message':
+                return await tgFetch('editMessageText', {
+                    chat_id: args.chat_id,
+                    message_id: args.message_id,
+                    text: args.text,
+                    parse_mode: args.parse_mode || 'HTML'
+                });
+
+            case 'delete_message':
+                return await tgFetch('deleteMessage', {
+                    chat_id: args.chat_id,
+                    message_id: args.message_id
+                });
+
+            case 'get_updates':
+                return await tgFetch('getUpdates', {
+                    limit: args.limit || 10,
+                    offset: args.offset
+                });
+
+            case 'get_me':
+                return await tgFetch('getMe');
+
+            case 'get_chat':
+                return await tgFetch('getChat', { chat_id: args.chat_id });
+
+            case 'get_chat_members':
+                return await tgFetch('getChatMemberCount', { chat_id: args.chat_id });
+
+            case 'create_poll':
+                return await tgFetch('sendPoll', {
+                    chat_id: args.chat_id,
+                    question: args.question,
+                    options: args.options,
+                    is_anonymous: args.is_anonymous !== false
+                });
+
+            case 'pin_message':
+                return await tgFetch('pinChatMessage', {
+                    chat_id: args.chat_id,
+                    message_id: args.message_id
+                });
+
+            case 'set_chat_title':
+                return await tgFetch('setChatTitle', {
+                    chat_id: args.chat_id,
+                    title: args.title
+                });
+
+            default:
+                throw new Error(`Unknown action: ${action}`);
+        }
+    } catch (err) {
+        return { error: err.message, stack: err.stack };
+    }
+}
+
+export const definition = {
+    name: 'telegram',
+    description: 'Send messages, photos, documents, polls, and manage Telegram groups via the Bot API. Requires TELEGRAM_BOT_TOKEN.',
+    parameters: {
+        type: 'object',
+        required: ['action'],
+        properties: {
+            action: {
+                type: 'string',
+                enum: ['send_message', 'send_photo', 'send_document', 'edit_message', 'delete_message', 'get_updates', 'get_me', 'get_chat', 'get_chat_members', 'create_poll', 'pin_message', 'set_chat_title']
+            },
+            chat_id: { type: 'string', description: 'Chat/group/channel ID' },
+            text: { type: 'string', description: 'Message text (supports HTML formatting)' },
+            photo: { type: 'string', description: 'Photo URL or file_id' },
+            document: { type: 'string', description: 'Document URL or file_id' },
+            caption: { type: 'string', description: 'Caption for photos/documents' },
+            message_id: { type: 'number', description: 'Message ID for edit/delete/pin' },
+            reply_to: { type: 'number', description: 'Message ID to reply to' },
+            parse_mode: { type: 'string', description: 'Parse mode: HTML or MarkdownV2' },
+            question: { type: 'string', description: 'Poll question' },
+            options: { type: 'array', items: { type: 'string' }, description: 'Poll answer options' },
+            is_anonymous: { type: 'boolean', description: 'Whether poll is anonymous' },
+            title: { type: 'string', description: 'Chat title' },
+            limit: { type: 'number', description: 'Max results' },
+            offset: { type: 'number', description: 'Update offset for pagination' }
+        }
+    }
+};

package/agent-skills/plugins/vercel/plugin.json

@@ -0,0 +1,22 @@
+{
+    "name": "vercel",
+    "version": "1.0.0",
+    "description": "Deploy projects, manage domains, view deployment logs, and manage environment variables on Vercel.",
+    "author": "Praveen",
+    "category": "DevOps & Cloud",
+    "tags": [
+        "vercel",
+        "deploy",
+        "hosting",
+        "frontend",
+        "serverless"
+    ],
+    "exports": {
+        "tools": [
+            "tools/vercel.js"
+        ],
+        "skills": [
+            "skills/vercel-manager.md"
+        ]
+    }
+}

package/agent-skills/plugins/vercel/skills/vercel-manager.md

@@ -0,0 +1,15 @@
+# Vercel Manager
+
+## Description
+This skill enables you to deploy projects, manage domains, configure environment variables, and monitor deployments on Vercel.
+
+## Instructions
+1. To deploy or redeploy, use `action: "redeploy"` with the `project` name and optionally a `deployment_id` to redeploy from.
+2. To create a new Vercel project linked to a GitHub repo, use `action: "create_project"` with `name` and `repo` (format: `"owner/repo"`).
+3. To add environment variables, use `action: "add_env"` with `project`, `key`, and `value`. By default, variables are encrypted and available in all environments (production, preview, development).
+4. To check deployment status, use `action: "list_deployments"` with the `project` name. The most recent deployment will be first.
+5. To view build logs, use `action: "get_deployment_events"` with the `deployment_id`.
+6. If the tool returns an authentication error, the user needs to export `VERCEL_TOKEN`. They can create one at https://vercel.com/account/tokens.
+
+## Input Variables
+{{input}}

package/agent-skills/plugins/vercel/tools/vercel.js

@@ -0,0 +1,145 @@
+/**
+ * Vercel automation tool.
+ * Provides deployment, domain, and project management via the Vercel REST API.
+ */
+export async function execute(params) {
+    const { action, ...args } = params;
+    const token = process.env.VERCEL_TOKEN;
+
+    if (!token) {
+        throw new Error('VERCEL_TOKEN environment variable is not set. Create a token at https://vercel.com/account/tokens');
+    }
+
+    const headers = {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${token}`
+    };
+
+    async function vercelFetch(method, endpoint, body = null) {
+        const teamId = args.teamId ? `?teamId=${args.teamId}` : '';
+        const url = `https://api.vercel.com${endpoint}${teamId}`;
+        const options = { method, headers };
+        if (body) options.body = JSON.stringify(body);
+
+        const res = await fetch(url, options);
+        if (res.status === 204) return { success: true };
+
+        const data = await res.json();
+        if (!res.ok) {
+            throw new Error(`Vercel API Error (${res.status}): ${JSON.stringify(data.error || data)}`);
+        }
+        return data;
+    }
+
+    try {
+        switch (action) {
+            // --- PROJECTS ---
+            case 'list_projects':
+                return await vercelFetch('GET', `/v9/projects?limit=${args.limit || 20}`);
+
+            case 'get_project':
+                return await vercelFetch('GET', `/v9/projects/${args.project}`);
+
+            case 'create_project':
+                return await vercelFetch('POST', '/v10/projects', {
+                    name: args.name,
+                    framework: args.framework || null,
+                    gitRepository: args.repo ? {
+                        type: 'github',
+                        repo: args.repo
+                    } : undefined
+                });
+
+            case 'delete_project':
+                return await vercelFetch('DELETE', `/v9/projects/${args.project}`);
+
+            // --- DEPLOYMENTS ---
+            case 'list_deployments':
+                return await vercelFetch('GET', `/v6/deployments?projectId=${args.project}&limit=${args.limit || 10}`);
+
+            case 'get_deployment':
+                return await vercelFetch('GET', `/v13/deployments/${args.deployment_id}`);
+
+            case 'redeploy':
+                return await vercelFetch('POST', `/v13/deployments`, {
+                    name: args.project,
+                    target: args.target || 'production',
+                    deploymentId: args.deployment_id
+                });
+
+            case 'cancel_deployment':
+                return await vercelFetch('PATCH', `/v12/deployments/${args.deployment_id}/cancel`);
+
+            // --- DOMAINS ---
+            case 'list_domains':
+                return await vercelFetch('GET', `/v5/domains?limit=${args.limit || 20}`);
+
+            case 'add_domain':
+                return await vercelFetch('POST', `/v10/projects/${args.project}/domains`, {
+                    name: args.domain
+                });
+
+            case 'remove_domain':
+                return await vercelFetch('DELETE', `/v9/projects/${args.project}/domains/${args.domain}`);
+
+            // --- ENVIRONMENT VARIABLES ---
+            case 'list_env':
+                return await vercelFetch('GET', `/v9/projects/${args.project}/env`);
+
+            case 'add_env':
+                return await vercelFetch('POST', `/v10/projects/${args.project}/env`, {
+                    key: args.key,
+                    value: args.value,
+                    type: args.type || 'encrypted',
+                    target: args.target || ['production', 'preview', 'development']
+                });
+
+            case 'remove_env':
+                return await vercelFetch('DELETE', `/v9/projects/${args.project}/env/${args.env_id}`);
+
+            // --- LOGS ---
+            case 'get_deployment_events':
+                return await vercelFetch('GET', `/v3/deployments/${args.deployment_id}/events`);
+
+            default:
+                throw new Error(`Unknown action: ${action}`);
+        }
+    } catch (err) {
+        return { error: err.message, stack: err.stack };
+    }
+}
+
+export const definition = {
+    name: 'vercel',
+    description: 'Manage Vercel deployments, projects, domains, and environment variables. Requires VERCEL_TOKEN.',
+    parameters: {
+        type: 'object',
+        required: ['action'],
+        properties: {
+            action: {
+                type: 'string',
+                description: 'The Vercel operation to perform',
+                enum: [
+                    'list_projects', 'get_project', 'create_project', 'delete_project',
+                    'list_deployments', 'get_deployment', 'redeploy', 'cancel_deployment',
+                    'list_domains', 'add_domain', 'remove_domain',
+                    'list_env', 'add_env', 'remove_env',
+                    'get_deployment_events'
+                ]
+            },
+            project: { type: 'string', description: 'Project name or ID' },
+            name: { type: 'string', description: 'Name for new project' },
+            framework: { type: 'string', description: 'Framework preset (nextjs, vite, nuxtjs, etc.)' },
+            repo: { type: 'string', description: 'GitHub repo in "owner/repo" format' },
+            deployment_id: { type: 'string', description: 'Deployment ID' },
+            target: { type: 'string', description: 'Deployment target: production or preview' },
+            domain: { type: 'string', description: 'Domain name (e.g., myapp.com)' },
+            key: { type: 'string', description: 'Env variable key' },
+            value: { type: 'string', description: 'Env variable value' },
+            type: { type: 'string', description: 'Env var type: encrypted, plain, secret, system' },
+            env_id: { type: 'string', description: 'Environment variable ID (for removal)' },
+            teamId: { type: 'string', description: 'Vercel team ID (optional)' },
+            limit: { type: 'number', description: 'Max results to return' }
+        }
+    }
+};