lazy-gravity 0.1.0 → 0.3.0

package/README.md

@@ -3,24 +3,22 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-0.0.4-blue?style=flat-square" alt="Version" />
+  <img src="https://img.shields.io/badge/version-0.3.0-blue?style=flat-square" alt="Version" />
+  <img src="https://img.shields.io/badge/Antigravity-1.19.5-ff6b35?style=flat-square" alt="Antigravity" />
   <img src="https://img.shields.io/badge/node-18.x+-brightgreen?style=flat-square&logo=node.js" alt="Node.js" />
   <img src="https://img.shields.io/badge/discord.js-14.x-5865F2?style=flat-square&logo=discord&logoColor=white" alt="discord.js" />
+  <img src="https://img.shields.io/badge/telegram-optional-26A5E4?style=flat-square&logo=telegram&logoColor=white" alt="Telegram" />
   <img src="https://img.shields.io/badge/protocol-CDP%20%2F%20WebSocket-orange?style=flat-square" alt="CDP/WebSocket" />
   <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License" />
 </p>
 
 # LazyGravity
 
-**LazyGravity** is a local, secure Discord Bot that lets you remotely operate [Antigravity](https://antigravity.dev) on your home PC — from your smartphone's Discord app, anywhere.
+**LazyGravity** is a local, secure bot that lets you remotely operate [Antigravity](https://antigravity.dev) on your home PC — from your smartphone, anywhere. Supports **Discord** and **Telegram** (optional).
 
-Send natural language instructions like "fix that bug" or "start designing the new feature" from your phone. Antigravity executes them locally on your home PC using its full resources, and reports results back to Discord.
+Send natural language instructions like "fix that bug" or "start designing the new feature" from your phone. Antigravity executes them locally on your home PC using its full resources, and reports results back to your chat platform.
 
-<p align="center">
-  <video src="https://github.com/user-attachments/assets/84eca973-59e8-4ffa-93e9-fba78ba72f74" width="100%" controls autoplay muted loop>
-    Your browser does not support the video tag.
-  </video>
-</p>
+https://github.com/user-attachments/assets/08eac63e-5ede-469b-ac6c-1c40ec77b0c0
 
 
 ## Quick Setup
@@ -36,7 +34,7 @@ The interactive wizard walks you through Discord bot creation, token setup, and
 
 ```bash
 lazy-gravity open     # Launch Antigravity with CDP enabled
-lazy-gravity start    # Start the Discord bot
+lazy-gravity start    # Start the bot (Discord by default, or both platforms)
 ```
 
 Or run directly without installing:
@@ -50,23 +48,30 @@ npx lazy-gravity
 ## Features
 
 1. **Fully Local & Secure**
-   - **No external server or port exposure** — runs as a local process on your PC, communicating directly with Discord.
-   - **Whitelist access control**: only authorized Discord user IDs (`allowedUserIds`) can interact with the bot.
+   - **No external server or port exposure** — runs as a local process on your PC, communicating directly with Discord/Telegram.
+   - **Whitelist access control**: only authorized user IDs can interact with the bot (per-platform allowlists).
    - **Secure credential management**: Bot tokens and API keys are stored locally (never in source code).
    - **Path traversal prevention & resource protection**: sandboxed directory access and concurrent task limits prevent abuse.
 
-2. **Project Management (Channel-Directory Binding)**
-   - Use `/project` to bind a Discord channel to a local project directory via an interactive select menu with buttons.
-   - Messages sent in a bound channel are automatically forwarded to Antigravity with the correct project context.
+2. **Multi-Platform Support**
+   - **Discord** (default): Full feature set with slash commands, rich embeds, reactions, and channel management.
+   - **Telegram** (optional): Send prompts, receive responses, and use inline keyboard buttons. Requires [grammy](https://grammy.dev/) (`npm install grammy`).
+   - Run both platforms simultaneously from a single process, or use either one standalone.
+
+3. **Project Management (Channel-Directory Binding)**
+   - **Discord**: Use `/project` to bind a channel to a local project directory via an interactive select menu.
+   - **Telegram**: Use `/project` to bind a chat to a workspace directory.
+   - Messages sent in a bound channel/chat are automatically forwarded to Antigravity with the correct project context.
 
-3. **Context-Aware Embed Replies**
-   - Results are delivered as rich Discord Embeds. Use Discord's Reply feature on any result to continue the conversation — the bot preserves full context (directory, task history) across reply chains.
+4. **Context-Aware Replies**
+   - **Discord**: Results delivered as rich Embeds. Use Reply to continue the conversation with full context preserved.
+   - **Telegram**: Results delivered as formatted HTML messages with inline keyboard buttons.
 
-4. **Real-Time Progress Monitoring**
+5. **Real-Time Progress Monitoring**
    - Long-running Antigravity tasks report progress as a series of messages (delivery confirmed / planning / analysis / execution / implementation / final summary).
 
-5. **File Attachments & Context Parsing**
-   - Send images (screenshots, mockups) or text files via Discord — they are automatically forwarded to Antigravity as context.
+6. **File Attachments & Context Parsing**
+   - Send images (screenshots, mockups) or text files — they are automatically forwarded to Antigravity as context.
 
 ## Usage & Commands
 
@@ -85,13 +90,37 @@ Just type in any bound channel:
 - `📝 /template list` — Display registered templates with execute buttons
 - `📝 /template add <name> <prompt>` — Register a new prompt template
 - `📝 /template delete <name>` — Delete a template
+- `🔗 /join` — Join an existing Antigravity session (shows up to 20 recent sessions)
+- `🔗 /mirror` — Toggle PC→Discord message mirroring for the current session
 - `🛑 /stop` — Force-stop a running Antigravity task
 - `📸 /screenshot` — Capture and send Antigravity's current screen
 - `🔧 /status` — Show bot connection status, current mode, and active project
 - `✅ /autoaccept [on|off|status]` — Toggle auto-approval of file edit dialogs
+- `📝 /output [embed|plain]` — Toggle output format between Embed and Plain Text (plain text is easier to copy on mobile)
+- `📋 /logs [lines] [level]` — View recent bot logs (ephemeral)
+- `🏓 /ping` — Check bot latency
 - `🧹 /cleanup [days]` — Scan and clean up inactive session channels (default: 7 days)
 - `❓ /help` — Display list of available commands
 
+### Telegram Commands
+
+Telegram commands use underscores instead of subcommand syntax (Telegram does not allow hyphens or spaces in command names).
+
+- `/project` — Manage workspace bindings (list, select, create)
+- `/project_create <name>` — Create a new workspace directory
+- `/template` — List prompt templates with execute buttons
+- `/template_add <name> <prompt>` — Add a new prompt template
+- `/template_delete <name>` — Delete a prompt template
+- `/mode` — Switch execution mode
+- `/model` — Switch LLM model
+- `/screenshot` — Capture Antigravity screenshot
+- `/autoaccept [on|off]` — Toggle auto-accept mode
+- `/logs [count]` — Show recent log entries
+- `/stop` — Interrupt active LLM generation
+- `/status` — Show bot status and connections
+- `/ping` — Check bot latency
+- `/help` — Show available commands
+
 ### CLI Commands
 
 ```bash
@@ -100,6 +129,8 @@ lazy-gravity setup        # Interactive setup wizard
 lazy-gravity open         # Open Antigravity with CDP (auto-selects available port)
 lazy-gravity start        # Start the Discord bot
 lazy-gravity doctor       # Check environment and dependencies
+lazy-gravity --verbose    # Show debug-level logs (CDP details, detector events, etc.)
+lazy-gravity --quiet      # Only show errors
 lazy-gravity --version    # Show version
 lazy-gravity --help       # Show help
 ```
@@ -148,6 +179,7 @@ DISCORD_BOT_TOKEN=your_bot_token_here
 GUILD_ID=your_guild_id_here
 ALLOWED_USER_IDS=123456789,987654321
 WORKSPACE_BASE_DIR=~/Code
+# ANTIGRAVITY_PATH=/path/to/antigravity.AppImage  # Optional: For Linux users or custom installations
 ```
 
 Then start the bot:
@@ -156,6 +188,20 @@ Then start the bot:
 npm run start
 ```
 
+#### Adding Telegram Support (Optional)
+
+1. Install grammy: `npm install grammy`
+2. Create a bot via [@BotFather](https://t.me/BotFather) on Telegram and copy the token.
+3. Add the following to your `.env`:
+
+```env
+PLATFORMS=discord,telegram        # or just "telegram" for Telegram-only
+TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here
+TELEGRAM_ALLOWED_USER_IDS=123456789    # Your Telegram numeric user ID
+```
+
+For Telegram-only deployments, Discord credentials (`DISCORD_BOT_TOKEN`, `CLIENT_ID`, `ALLOWED_USER_IDS`) are not required.
+
 Alternatively, you can build and use the CLI:
 
 ```bash
@@ -185,6 +231,13 @@ Double-click **`start_antigravity_win.bat`** in the repo root.
 
 - **If it doesn't launch**: the executable may not be in your PATH. Right-click the file, edit it, and replace `"Antigravity.exe"` with the full install path (e.g. `"%LOCALAPPDATA%\Programs\Antigravity\Antigravity.exe"`).
 
+#### Linux
+On Linux (especially when using AppImages), the `antigravity` command might not be globally available.
+You can specify the exact path to your executable by setting the `ANTIGRAVITY_PATH` environment variable in your `.env` file:
+```env
+ANTIGRAVITY_PATH=/opt/applications/antigravity.AppImage
+```
+
 > **Tip**: CDP ports are auto-scanned from candidates (9222, 9223, 9333, 9444, 9555, 9666).
 > Launch Antigravity first, then start the bot — it connects automatically.
 
@@ -220,7 +273,27 @@ Run `lazy-gravity doctor` to diagnose configuration and connectivity issues.
 2. Connects via WebSocket to CDP (`Runtime.evaluate` for DOM operations)
 3. Injects messages into the chat input, monitors Antigravity responses, and captures screenshots
 
-**On disconnect**: automatically retries up to 3 times (`maxReconnectAttempts`). If all retries fail, an error notification is sent to Discord.
+**On disconnect**: automatically retries up to 3 times (`maxReconnectAttempts`). If all retries fail, an error notification is sent to the active chat platform.
+
+## Platform Architecture
+
+LazyGravity uses a **platform abstraction layer** so the core bot logic is platform-independent:
+
+```
+src/platform/
+├── types.ts              # Shared interfaces (PlatformMessage, PlatformChannel, etc.)
+├── adapter.ts            # PlatformAdapter interface
+├── richContentBuilder.ts # Immutable builder for rich content (embeds/HTML)
+├── discord/              # Discord adapter (discord.js wrappers)
+│   ├── discordAdapter.ts
+│   └── wrappers.ts
+└── telegram/             # Telegram adapter (grammy-compatible wrappers)
+    ├── telegramAdapter.ts
+    ├── telegramFormatter.ts  # Markdown → Telegram HTML conversion
+    └── wrappers.ts
+```
+
+Both adapters implement the same `PlatformAdapter` interface and emit events through `PlatformAdapterEvents`. The `EventRouter` dispatches events to platform-agnostic handlers, and the `WorkspaceQueue` serializes concurrent requests per workspace across platforms.
 
 ## License
 

package/dist/bin/cli.js

@@ -43,37 +43,37 @@ const doctor_1 = require("./commands/doctor");
 const setup_1 = require("./commands/setup");
 const open_1 = require("./commands/open");
 const configLoader_1 = require("../utils/configLoader");
-let commandRan = false;
-const markRan = (fn) => ((...args) => { commandRan = true; return fn(...args); });
 const program = new commander_1.Command()
     .name('lazy-gravity')
     .description('Control your AI coding assistant from Discord')
-    .version(package_json_1.version);
+    .version(package_json_1.version)
+    .option('--verbose', 'Show debug-level logs')
+    .option('--quiet', 'Only show errors');
+// Default action: no subcommand → start or setup
+program.action(() => {
+    const hasConfig = configLoader_1.ConfigLoader.configExists();
+    const hasEnv = fs.existsSync(path.resolve(process.cwd(), '.env'));
+    if (!hasConfig && !hasEnv) {
+        (0, setup_1.setupAction)();
+    }
+    else {
+        (0, start_1.startAction)(program.opts(), program);
+    }
+});
 program
     .command('start')
     .description('Start the Discord bot')
-    .action(markRan(start_1.startAction));
+    .action((_opts, cmd) => (0, start_1.startAction)(cmd.parent.opts(), cmd.parent));
 program
     .command('doctor')
     .description('Check environment and dependencies')
-    .action(markRan(doctor_1.doctorAction));
+    .action(doctor_1.doctorAction);
 program
     .command('setup')
     .description('Interactive setup wizard')
-    .action(markRan(setup_1.setupAction));
+    .action(setup_1.setupAction);
 program
     .command('open')
     .description('Open Antigravity with CDP enabled (auto-selects available port)')
-    .action(markRan(open_1.openAction));
+    .action(open_1.openAction);
 program.parse();
-// Default behavior: if no subcommand was matched, decide what to run
-if (!commandRan) {
-    const hasConfig = configLoader_1.ConfigLoader.configExists();
-    const hasEnv = fs.existsSync(path.resolve(process.cwd(), '.env'));
-    if (!hasConfig && !hasEnv) {
-        (0, setup_1.setupAction)();
-    }
-    else {
-        (0, start_1.startAction)();
-    }
-}

package/dist/bin/commands/doctor.js

@@ -39,6 +39,7 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const cdpPorts_1 = require("../../utils/cdpPorts");
 const configLoader_1 = require("../../utils/configLoader");
+const pathUtils_1 = require("../../utils/pathUtils");
 const logger_1 = require("../../utils/logger");
 const ok = (msg) => console.log(`  ${logger_1.COLORS.green}[OK]${logger_1.COLORS.reset} ${msg}`);
 const warn = (msg) => console.log(`  ${logger_1.COLORS.yellow}[--]${logger_1.COLORS.reset} ${msg}`);
@@ -70,8 +71,23 @@ function checkEnvFile() {
     const envPath = path.resolve(process.cwd(), '.env');
     return { exists: fs.existsSync(envPath), path: envPath };
 }
+const VALID_PLATFORMS = ['discord', 'telegram'];
+function getActivePlatforms() {
+    const raw = process.env.PLATFORMS || 'discord';
+    return raw
+        .split(',')
+        .map((p) => p.trim().toLowerCase())
+        .filter((p) => VALID_PLATFORMS.includes(p));
+}
 function checkRequiredEnvVars() {
-    const required = ['DISCORD_BOT_TOKEN', 'CLIENT_ID', 'ALLOWED_USER_IDS'];
+    const platforms = getActivePlatforms();
+    const required = [];
+    if (platforms.includes('discord')) {
+        required.push('DISCORD_BOT_TOKEN', 'CLIENT_ID', 'ALLOWED_USER_IDS');
+    }
+    if (platforms.includes('telegram')) {
+        required.push('TELEGRAM_BOT_TOKEN', 'TELEGRAM_ALLOWED_USER_IDS');
+    }
     return required.map((name) => ({
         name,
         set: Boolean(process.env[name]),
@@ -113,7 +129,9 @@ async function doctorAction() {
             warn(`.env file not found: ${env.path} (not needed — config.json used)`);
         }
     }
-    // 4. Required environment variables (check both env and config.json sources)
+    // 4. Required environment variables (platform-aware)
+    const platforms = getActivePlatforms();
+    ok(`Active platforms: ${platforms.join(', ')}`);
     const vars = checkRequiredEnvVars();
     for (const v of vars) {
         if (v.set) {
@@ -136,7 +154,7 @@ async function doctorAction() {
     }
     if (!cdpOk) {
         fail('No CDP ports responding');
-        hint('Run: open -a Antigravity --args --remote-debugging-port=9222');
+        hint(`Run: ${(0, pathUtils_1.getAntigravityCdpHint)(9222)}`);
         allOk = false;
     }
     // 6. Node.js version check