morpheus-cli 0.1.5 → 0.1.8

package/README.md

@@ -1,213 +1,273 @@
-<div align="center">
-  <img src="./assets/logo.png" alt="Morpheus Logo" width="220" />
-</div>
-
-# Morpheus
-
-> **Morpheus is a local-first AI operator that bridges developers and machines.**
-
-Morpheus is a local AI agent for developers, running as a CLI daemon that connects to **LLMs**, **local tools**, and **MCPs**, enabling interaction via **Terminal, Telegram, and Discord**. Inspired by the character Morpheus from *The Matrix*, the project acts as an **intelligent orchestrator**, bridging the gap between the developer and complex systems.
-
-## Installation
-
-Install Morpheus globally via npm:
-
-```bash
-npm install -g morpheus-cli
-```
-
-## Quick Start
-
-### 1. Initialize
-
-Set up your configuration (API keys, preferences):
-
-```bash
-morpheus init
-```
-
-### 2. Start the Agent
-
-Run the background daemon and Web UI:
-
-```bash
-morpheus start
-```
-
-This will:
-- Start the agent process
-- Launch the Web UI at http://localhost:3333
-
-### Other Commands
-
-```bash
-# Check if Morpheus is running
-morpheus status
-
-# Stop the agent
-morpheus stop
-
-# Diagnose issues
-morpheus doctor
-```
-
-## Troubleshooting
-
-### Command not found
-
-If you installed successfully but can't run the `morpheus` command:
-
-1.  **Check your PATH**: Ensure your global npm bin directory is in your system PATH.
-    -   Run `npm bin -g` to see the folder.
-    -   On Windows, this is usually `%APPDATA%\npm`.
-    -   On Linux/Mac, verify `echo $PATH`.
-2.  **Restart Terminal**: New installations might not be visible until you restart your shell.
-
-## Using NPX
-You can run Morpheus without installing it globally using `npx`:
-
-```bash
-
-npx morpheus-cli init
-
-npx morpheus-cli start
-
-```
-
-## Technical Overview
-
-Morpheus is built with **Node.js** and **TypeScript**, using **LangChain** as the orchestration engine. It runs as a background daemon process, managing connections to LLM providers (OpenAI, Anthropic, Ollama) and external channels (Telegram, Discord).
-
-### Core Components
-
-- **Runtime (`src/runtime/`)**: The heart of the application. Manages the agent lifecycle, provider instantiation, and command execution.
-- **CLI (`src/cli/`)**: Built with `commander`, handles user interaction, configuration, and daemon control (`start`, `stop`, `status`).
-- **Configuration (`src/config/`)**: Singleton-based configuration manager using `zod` for validation and `js-yaml` for persistence (`~/.morpheus/config.yaml`).
-- **Channels (`src/channels/`)**: Adapters for external communication. Currently supports Telegram (`telegraf`) with strict user whitelisting.
-
-## Features
-
-### 🎙️ Audio Transcription (Telegram)
-Send voice messages directly to the Telegram bot. Morpheus will:
-1. Transcribe the audio using **Google Gemini**.
-2. Process the text as a standard prompt.
-3. Reply with the answer.
-
-*Requires a Google Gemini API Key.*
-
-## Development Setup
-
-This guide is for developers contributing to the Morpheus codebase.
-
-### Prerequisites
-
-- **Node.js**: >= 18.x
-- **npm**: >= 9.x
-- **TypeScript**: >= 5.x
-
-### 1. Clone & Install
-
-```bash
-git clone https://github.com/your-org/morpheus.git
-cd morpheus
-npm install
-```
-
-### 2. Build
-
-Compile TypeScript source to `dist/`.
-
-```bash
-npm run build
-```
-
-### 3. Run the CLI
-
-You can run the CLI directly from the source using `npm start`.
-
-```bash
-# Initialize configuration (creates ~/.morpheus)
-npm start -- init
-
-# Start the daemon
-npm start -- start
-
-# Check status
-npm start -- status
-```
-
-### 4. Configuration
-
-The configuration file is located at `~/.morpheus/config.yaml`. You can edit it manually or use the `morpheus config` command.
-
-```yaml
-agent:
-  name: "Morpheus"
-  personality: "stoic, wise, and helpful"
-llm:
-  provider: "openai" # options: openai, anthropic, ollama
-  model: "gpt-4-turbo"
-  temperature: 0.7
-  api_key: "sk-..."
-memory:
-  limit: 100 # Number of messages to retain in context
-channels:
-  telegram:
-    enabled: true
-    token: "YOUR_TELEGRAM_BOT_TOKEN"
-    allowedUsers: ["123456789"] # Your Telegram User ID
-
-# Audio Transcription Support
-audio:
-  enabled: true
-  apiKey: "YOUR_GEMINI_API_KEY" # Optional if llm.provider is 'gemini'
-  maxDurationSeconds: 300
-```
-
-## Testing
-
-We use **Vitest** for testing.
-
-```bash
-# Run unit tests
-npm test
-
-# Run tests in watch mode
-npm run test:watch
-```
-
-## Project Structure
-
-```text
-.
-├── assets/          # Static assets
-├── bin/             # CLI entry point (morpheus.js)
-├── specs/           # Technical specifications & documentation
-├── src/
-│   ├── channels/    # Communication adapters (Telegram, etc.)
-│   ├── cli/         # CLI commands and logic
-│   ├── config/      # Configuration management
-│   ├── runtime/     # Core agent logic, lifecycle, and providers
-│   ├── types/       # Shared TypeScript definitions
-│   └── index.ts
-└── package.json
-```
-
-## Roadmap
-
-- [ ] **MCP Support**: Full integration with Model Context Protocol.
-- [ ] **Discord Adapter**: Support for Discord interactions.
-- [ ] **Web Dashboard**: Local UI for management and logs.
-- [ ] **Plugin System**: Extend functionality via external modules.
-
-## Contributing
-
-1.  Fork the repository.
-2.  Create a feature branch (`git checkout -b feature/amazing-feature`).
-3.  Commit your changes (`git commit -m 'feat: Add amazing feature'`).
-4.  Push to the branch (`git push origin feature/amazing-feature`).
-5.  Open a Pull Request.
-
-## License
-
-MIT
+<div align="center">
+  <img src="./assets/logo.png" alt="Morpheus Logo" width="220" />
+</div>
+
+# Morpheus
+
+> **Morpheus is a local-first AI operator that bridges developers and machines.**
+
+Morpheus is a local AI agent for developers, running as a CLI daemon that connects to **LLMs**, **local tools**, and **MCPs**, enabling interaction via **Terminal, Telegram, and Discord**. Inspired by the character Morpheus from *The Matrix*, the project acts as an **intelligent orchestrator**, bridging the gap between the developer and complex systems.
+
+## Installation
+
+Install Morpheus globally via npm:
+
+```bash
+npm install -g morpheus-cli
+```
+
+## Quick Start
+
+### 1. Initialize
+
+Set up your configuration (API keys, preferences):
+
+```bash
+morpheus init
+```
+
+### 2. Start the Agent
+
+Run the background daemon and Web UI:
+
+```bash
+morpheus start
+```
+
+This will:
+- Start the agent process
+- Launch the Web UI at http://localhost:3333
+
+### Other Commands
+
+```bash
+# Check if Morpheus is running
+morpheus status
+
+# Stop the agent
+morpheus stop
+
+# Diagnose issues
+morpheus doctor
+```
+
+## Troubleshooting
+
+### Command not found
+
+If you installed successfully but can't run the `morpheus` command:
+
+1.  **Check your PATH**: Ensure your global npm bin directory is in your system PATH.
+    -   Run `npm bin -g` to see the folder.
+    -   On Windows, this is usually `%APPDATA%\npm`.
+    -   On Linux/Mac, verify `echo $PATH`.
+2.  **Restart Terminal**: New installations might not be visible until you restart your shell.
+
+## Using NPX
+You can run Morpheus without installing it globally using `npx`:
+
+```bash
+
+npx morpheus-cli init
+
+npx morpheus-cli start
+
+```
+
+## Technical Overview
+
+Morpheus is built with **Node.js** and **TypeScript**, using **LangChain** as the orchestration engine. It runs as a background daemon process, managing connections to LLM providers (OpenAI, Anthropic, Ollama) and external channels (Telegram, Discord).
+
+### Core Components
+
+- **Runtime (`src/runtime/`)**: The heart of the application. Manages the agent lifecycle, provider instantiation, and command execution.
+- **CLI (`src/cli/`)**: Built with `commander`, handles user interaction, configuration, and daemon control (`start`, `stop`, `status`).
+- **Configuration (`src/config/`)**: Singleton-based configuration manager using `zod` for validation and `js-yaml` for persistence (`~/.morpheus/config.yaml`).
+- **Channels (`src/channels/`)**: Adapters for external communication. Currently supports Telegram (`telegraf`) with strict user whitelisting.
+
+## Features
+
+### 🖥️ Web Dashboard
+Local React-based UI to manage recordings, chat history, and system status across your agent instances.
+
+#### 🔒 UI Authentication
+To protect your Web UI, use the `THE_ARCHITECT_PASS` environment variable. This ensures only authorized users can access the dashboard and API.
+
+**Option 1: Using a `.env` file**
+Create a `.env` file in the root of your project:
+
+```env
+THE_ARCHITECT_PASS="your-secure-password"
+```
+
+**Option 2: Using Shell export**
+
+```bash
+export THE_ARCHITECT_PASS="your-secure-password"
+morpheus start
+```
+
+When enabled:
+- The Web UI will redirect to a Login page.
+- API requests require the `x-architect-pass` header.
+- The session is persisted locally in your browser.
+
+### 🧩 MCP Support (Model Context Protocol)
+Full integration with [Model Context Protocol](https://modelcontextprotocol.io/), allowing Morpheus to use standardized tools from any MCP-compatible server.
+
+### 📊 Usage Analytics
+Track your token usage across different providers and models directly from the Web UI. View detailed breakdowns of input/output tokens and message counts to monitor costs and activity.
+
+### 🎙️ Audio Transcription (Telegram)
+Send voice messages directly to the Telegram bot. Morpheus will:
+1. Transcribe the audio using **Google Gemini**.
+2. Process the text as a standard prompt.
+3. Reply with the answer.
+
+*Requires a Google Gemini API Key.*
+
+## Development Setup
+
+This guide is for developers contributing to the Morpheus codebase.
+
+### Prerequisites
+
+- **Node.js**: >= 18.x
+- **npm**: >= 9.x
+- **TypeScript**: >= 5.x
+
+### 1. Clone & Install
+
+```bash
+git clone https://github.com/your-org/morpheus.git
+cd morpheus
+npm install
+```
+
+### 2. Build
+
+Compile TypeScript source to `dist/` and build the Web UI.
+
+```bash
+npm run build
+```
+
+### 3. Run the CLI
+
+You can run the CLI directly from the source using `npm start`.
+
+```bash
+# Initialize configuration (creates ~/.morpheus)
+npm start -- init
+
+# Start the daemon
+npm start -- start
+
+# Check status
+npm start -- status
+```
+
+### 4. Configuration
+
+The configuration file is located at `~/.morpheus/config.yaml`. You can edit it manually or use the `morpheus config` command.
+
+```yaml
+agent:
+  name: "Morpheus"
+  personality: "stoic, wise, and helpful"
+llm:
+  provider: "openai" # options: openai, anthropic, ollama, gemini
+  model: "gpt-4-turbo"
+  temperature: 0.7
+  api_key: "sk-..."
+memory:
+  limit: 100 # Number of messages to retain in context
+channels:
+  telegram:
+    enabled: true
+    token: "YOUR_TELEGRAM_BOT_TOKEN"
+    allowedUsers: ["123456789"] # Your Telegram User ID
+  discord:
+    enabled: false # Coming soon
+
+# Web UI Dashboard
+ui:
+  enabled: true
+  port: 3333
+
+# Audio Transcription Support
+audio:
+  enabled: true
+  apiKey: "YOUR_GEMINI_API_KEY" # Optional if llm.provider is 'gemini'
+  maxDurationSeconds: 300
+```
+
+### 5. MCP Configuration
+
+Morpheus supports external tools via **MCP (Model Context Protocol)**. Configure your MCP servers in `~/.morpheus/mcps.json`:
+
+```json
+{
+  "coolify": {
+    "transport": "stdio",
+    "command": "npx",
+    "args": ["-y", "@coolify/mcp-server"],
+    "env": {
+      "COOLIFY_URL": "https://app.coolify.io",
+      "COOLIFY_TOKEN": "your-token"
+    }
+  },
+  "coingecko": {
+    "transport": "http",
+    "url": "https://mcps.mnunes.xyz/coingecko/mcp"
+  }
+}
+```
+
+## Testing
+
+We use **Vitest** for testing.
+
+```bash
+# Run unit tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+```
+
+## Project Structure
+
+```text
+.
+├── assets/          # Static assets
+├── bin/             # CLI entry point (morpheus.js)
+├── specs/           # Technical specifications & documentation
+├── src/
+│   ├── channels/    # Communication adapters (Telegram, etc.)
+│   ├── cli/         # CLI commands and logic
+│   ├── config/      # Configuration management
+│   ├── runtime/     # Core agent logic, lifecycle, and providers
+│   ├── types/       # Shared TypeScript definitions
+│   └── ui/          # React Web UI Dashboard
+└── package.json
+```
+
+## Roadmap
+
+- [x] **Web Dashboard**: Local UI for management and logs.
+- [x] **MCP Support**: Full integration with Model Context Protocol.
+- [ ] **Discord Adapter**: Support for Discord interactions.
+- [ ] **Plugin System**: Extend functionality via external modules.
+
+## Contributing
+
+1.  Fork the repository.
+2.  Create a feature branch (`git checkout -b feature/amazing-feature`).
+3.  Commit your changes (`git commit -m 'feat: Add amazing feature'`).
+4.  Push to the branch (`git push origin feature/amazing-feature`).
+5.  Open a Pull Request.
+
+## License
+
+MIT

package/bin/morpheus.js

@@ -1,4 +1,34 @@
 #!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+
+// Load .env file if it exists (Simple shim to avoid 'dotenv' dependency issues)
+const envPath = path.join(process.cwd(), '.env');
+if (fs.existsSync(envPath)) {
+  try {
+    const envConfig = fs.readFileSync(envPath, 'utf-8');
+    envConfig.split('\n').forEach(line => {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith('#')) return;
+      
+      const match = trimmed.match(/^([^=]+)=(.*)$/);
+      if (match) {
+        const key = match[1].trim();
+        let value = match[2].trim();
+        // Remove quotes if present
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+          value = value.slice(1, -1);
+        }
+        // Don't overwrite existing env vars
+        if (!process.env[key]) {
+          process.env[key] = value;
+        }
+      }
+    });
+  } catch (err) {
+    // Ignore .env errors
+  }
+}
 
 // Suppress experimental warnings for JSON modules
 const originalEmit = process.emit;

package/dist/channels/telegram.js

@@ -7,6 +7,7 @@ import os from 'os';
 import { ConfigManager } from '../config/manager.js';
 import { DisplayManager } from '../runtime/display.js';
 import { AudioAgent } from '../runtime/audio-agent.js';
+import { convert } from 'telegram-markdown-v2';
 export class TelegramAdapter {
     bot = null;
     isConnected = false;
@@ -22,6 +23,10 @@ export class TelegramAdapter {
             this.display.log('Telegram adapter already connected.', { source: 'Telegram', level: 'warning' });
             return;
         }
+        const escapeMarkdownV2 = (text) => {
+            // Regex matches all special characters requiring escaping
+            return convert(text);
+        };
         try {
             this.display.log('Connecting to Telegram...', { source: 'Telegram' });
             this.bot = new Telegraf(token);
@@ -96,7 +101,7 @@ export class TelegramAdapter {
                     filePath = await this.downloadToTemp(fileLink);
                     // Transcribe
                     this.display.log(`Transcribing audio for @${user}...`, { source: 'AgentAudio' });
-                    const text = await this.audioAgent.transcribe(filePath, 'audio/ogg', apiKey);
+                    const { text, usage } = await this.audioAgent.transcribe(filePath, 'audio/ogg', apiKey);
                     this.display.log(`Transcription success for @${user}: "${text}"`, { source: 'AgentAudio', level: 'success' });
                     // Reply with transcription (optional, maybe just process it?)
                     // The prompt says "reply with the answer".
@@ -105,7 +110,7 @@ export class TelegramAdapter {
                     await ctx.reply(`🎤 *Transcription*: _"${text}"_`, { parse_mode: 'Markdown' });
                     await ctx.sendChatAction('typing');
                     // Process with Agent
-                    const response = await this.agent.chat(text);
+                    const response = await this.agent.chat(text, usage);
                     // if (listeningMsg) {
                     //   try {
                     //     await ctx.telegram.deleteMessage(ctx.chat.id, listeningMsg.message_id);

package/dist/cli/commands/config.js

@@ -22,18 +22,33 @@ export const configCommand = new Command('config')
     try {
         await scaffold(); // Ensure config exits
         if (options.edit) {
-            console.log(chalk.cyan(`Opening config file: ${PATHS.config}`));
+            console.log(chalk.cyan(`Opening configuration files...`));
             await open(PATHS.config);
+            if (await fs.pathExists(PATHS.mcps)) {
+                await open(PATHS.mcps);
+            }
         }
         else {
-            console.log(chalk.bold('Configuration File:'), chalk.cyan(PATHS.config));
+            // Show config.yaml
+            console.log(chalk.bold('Main Configuration:'), chalk.cyan(PATHS.config));
             console.log(chalk.gray('---'));
             if (await fs.pathExists(PATHS.config)) {
                 const content = await fs.readFile(PATHS.config, 'utf8');
                 console.log(content);
             }
             else {
-                console.log(chalk.yellow('Config file not found (scaffold should have created it).'));
+                console.log(chalk.yellow('Config file not found.'));
+            }
+            console.log(chalk.gray('---\n'));
+            // Show mcps.json
+            console.log(chalk.bold('MCP Configuration:'), chalk.cyan(PATHS.mcps));
+            console.log(chalk.gray('---'));
+            if (await fs.pathExists(PATHS.mcps)) {
+                const content = await fs.readFile(PATHS.mcps, 'utf8');
+                console.log(content);
+            }
+            else {
+                console.log(chalk.yellow('MCP config file not found (create it to add tools).'));
             }
             console.log(chalk.gray('---'));
         }

package/dist/cli/commands/init.js

@@ -4,7 +4,7 @@ import chalk from 'chalk';
 import { ConfigManager } from '../../config/manager.js';
 import { renderBanner } from '../utils/render.js';
 import { DisplayManager } from '../../runtime/display.js';
-import { scaffold } from '../../runtime/scaffold.js';
+// import { scaffold } from '../../runtime/scaffold.js';
 export const initCommand = new Command('init')
     .description('Initialize Morpheus configuration')
     .action(async () => {
@@ -12,8 +12,8 @@ export const initCommand = new Command('init')
     renderBanner();
     const configManager = ConfigManager.getInstance();
     const currentConfig = await configManager.load();
-    // Ensure directory exists
-    await scaffold();
+    // Ensure directory exists - Handled by preAction hook
+    // await scaffold();
     display.log(chalk.blue('Let\'s set up your Morpheus agent!'));
     try {
         const name = await input({

package/dist/cli/index.js

@@ -8,6 +8,7 @@ import { statusCommand } from './commands/status.js';
 import { configCommand } from './commands/config.js';
 import { doctorCommand } from './commands/doctor.js';
 import { initCommand } from './commands/init.js';
+import { scaffold } from '../runtime/scaffold.js';
 // Helper to read package.json version
 const getVersion = () => {
     try {
@@ -28,6 +29,9 @@ export async function cli() {
         .name('morpheus')
         .description('Morpheus CLI Agent')
         .version(getVersion());
+    program.hook('preAction', async () => {
+        await scaffold();
+    });
     program.addCommand(initCommand);
     program.addCommand(startCommand);
     program.addCommand(stopCommand);
@@ -36,3 +40,7 @@ export async function cli() {
     program.addCommand(doctorCommand);
     program.parse(process.argv);
 }
+// Support direct execution via tsx
+if (import.meta.url.startsWith('file:') && (process.argv[1]?.endsWith('index.ts') || process.argv[1]?.endsWith('cli/index.js'))) {
+    cli();
+}