thinkncollab-shell 0.0.3 → 0.0.5

package/Readme.md

@@ -1,26 +1,402 @@
-# ThinkNCollab Shell
+# ThinkNCollab Shell (`thinknsh`)
 
-A powerful collaborative shell with WebSocket integration for real-time team collaboration.
+A powerful collaborative shell with WebSocket integration for real-time team collaboration — built on top of the ThinkNCollab platform.
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Configuration](#configuration)
+- [CLI Flags](#cli-flags)
+- [Interactive Shell](#interactive-shell)
+- [Commands Reference](#commands-reference)
+  - [Auth Commands](#auth-commands)
+  - [Team Commands](#team-commands)
+  - [Room Commands](#room-commands)
+  - [Message Commands](#message-commands)
+  - [Shell Commands](#shell-commands)
+- [Single-Command Mode](#single-command-mode)
+- [Built-in Shell Features](#built-in-shell-features)
+- [Examples](#examples)
+- [Environment Variables](#environment-variables)
+
+---
 
 ## Features
 
-- 🚀 **Custom Shell** - Full-featured command-line interface
-- 🔌 **WebSocket Integration** - Real-time communication with ThinkNCollab servers
-- 👥 **Room Collaboration** - Join rooms and collaborate with team members
-- 💬 **Messaging** - Send and receive messages in real-time
-- 🔔 **Notifications** - Get notified of important events
-- 📁 **File System** - Built-in file system commands
-- ⚡ **Command System** - Extensible command registration
-- 🔧 **Aliases** - Create custom command aliases
-- 📊 **Variables** - Shell variables support
-- 📜 **History** - Command history with persistence
-- 🎨 **Colored Output** - Beautiful colored terminal output
+- 🚀 **Custom Shell** — Full-featured interactive command-line interface
+- 🔌 **WebSocket Integration** — Real-time communication with ThinkNCollab servers
+- 👥 **Room Collaboration** — Join rooms and collaborate with teammates live
+- 💬 **Messaging** — Send and receive messages in real-time
+- 🔔 **Notifications** — Get notified of tasks, uploads, and room events
+- 📁 **File System** — Built-in file system commands (ls, cd, pwd, cat, mkdir)
+- ⚡ **Command System** — Extensible command registration by category
+- 🔧 **Aliases** — Create and manage custom command shortcuts
+- 📊 **Variables** — Shell variable support (`set`, `$VAR`)
+- 📜 **History** — Persistent command history across sessions
+- 🎨 **Colored Output** — Beautiful chalk-powered terminal output
+
+---
 
 ## Installation
 
 ```bash
-# Install globally
+# Install globally (recommended)
 npm install -g thinkncollab-shell
 
-# Or install locally
-npm install thinkncollab-shell
+# Or install locally in a project
+npm install thinkncollab-shell
+```
+
+After global install, the `thinknsh` binary is available everywhere on your system.
+
+---
+
+## Quick Start
+
+```bash
+# 1. Start the interactive shell
+thinknsh
+
+# 2. Log in to your ThinkNCollab account
+thinknsh> login
+
+# 3. Join a room
+thinknsh> join my-room
+
+# 4. Send a message
+thinknsh> say Hello team!
+
+# 5. Check your status
+thinknsh> status
+```
+
+---
+
+## Configuration
+
+By default `thinknsh` connects to `https://thinkncollab.com`. In production, set environment variables before starting the shell:
+
+```bash
+export THINKNCOLLAB_SERVER=https://thinkncollab.com
+export THINKNCOLLAB_API_URL=https://thinkncollab.com
+export THINKNCOLLAB_WS_URL=https://thinkncollab.com
+thinknsh
+```
+
+Or inline for a single session:
+
+```bash
+THINKNCOLLAB_SERVER=https://thinkncollab.com thinknsh
+```
+
+---
+
+## CLI Flags
+
+These flags are used **before** entering the interactive shell (passed directly to the `thinknsh` binary).
+
+| Flag | Alias | Description |
+|------|-------|-------------|
+| `--help` | `-h` | Show help message and exit |
+| `--version` | `-v` | Print the installed version and exit |
+
+```bash
+thinknsh --help
+thinknsh --version
+```
+
+---
+
+## Interactive Shell
+
+Running `thinknsh` with no arguments starts the **interactive shell** — a persistent REPL where you stay logged in, maintain a WebSocket connection, and run commands one after another.
+
+```
+$ thinknsh
+
+  ████████╗██╗  ██╗██╗███╗   ██╗██╗  ██╗███╗   ██╗
+     ╚══██╔╝██║  ██║██║████╗  ██║██║ ██╔╝████╗  ██║
+        ██║ ███████║██║██╔██╗ ██║█████╔╝ ██╔██╗ ██║
+        ██║ ██╔══██║██║██║╚██╗██║██╔═██╗ ██║╚██╗██║
+        ██║ ██║  ██║██║██║ ╚████║██║  ██╗██║ ╚████║
+        ╚═╝ ╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═══╝
+
+thinknsh> _
+```
+
+Type `help` inside the shell to list all available commands at any time.
+
+---
+
+## Commands Reference
+
+### Auth Commands
+
+#### `login`
+Authenticate with your ThinkNCollab account. Prompts for email and password interactively.
+
+```bash
+thinknsh> login
+# Enter your email: you@example.com
+# Enter your password: ********
+# ✅ Logged in as you@example.com
+```
+
+#### `logout`
+End your current session and clear saved credentials.
+
+```bash
+thinknsh> logout
+# ✅ Logged out successfully
+```
+
+#### `whoami`
+Display information about the currently authenticated user.
+
+```bash
+thinknsh> whoami
+# 👤 Logged in as: Ramanh (raman@thinkncollab.com)
+# 🏢 Team: ThinkNCollab Core
+```
+
+---
+
+### Team Commands
+
+#### `myteam`
+Show details about your current team — name, plan, member count.
+
+```bash
+thinknsh> myteam
+# 🏢 Team: ThinkNCollab Core
+# 📋 Plan: Pro
+# 👥 Members: 8
+```
+
+#### `teammates`
+List all members in your team with their online status.
+
+```bash
+thinknsh> teammates
+# 👥 Team Members:
+#   🟢 Raman Singh       (you)
+#   🟢 Omkar Yadav
+#   🔴 Radhika Chauhan     (offline)
+#   🟡 --------------      (away)
+```
+
+#### `invite <email>`
+Send a team invitation to an email address.
+
+```bash
+thinknsh> invite newmember@example.com
+# ✅ Invitation sent to newmember@example.com
+```
+
+---
+
+### Room Commands
+
+#### `join <room-id>`
+Join a collaboration room. Establishes a WebSocket connection and streams live activity.
+
+```bash
+thinknsh> join room-abc123
+# 🚪 Joined room: room-abc123
+# 👥 Members online: 3
+# 📜 Recent activity loaded
+```
+
+You will automatically receive real-time notifications for messages, task updates, and file uploads while inside a room.
+
+#### `leave`
+Leave the currently active room and disconnect from its WebSocket stream.
+
+```bash
+thinknsh> leave
+# 👋 Left room: room-abc123
+```
+
+#### `rooms`
+List all rooms available to you — showing name, ID, and member count.
+
+```bash
+thinknsh> rooms
+# 📁 Your Rooms:
+#   [1] frontend-team    (ID: room-abc123)  👥 4 members
+#   [2] backend-infra    (ID: room-def456)  👥 2 members
+#   [3] design-review    (ID: room-ghi789)  👥 6 members
+```
+
+---
+
+### Message Commands
+
+#### `say <message>`
+Send a message to the room you are currently in. Requires you to be in a room (use `join` first).
+
+```bash
+thinknsh> say Hey team, PR is ready for review!
+# 💬 [You → frontend-team]: Hey team, PR is ready for review!
+```
+
+Supports multi-word messages — no quotes needed.
+
+```bash
+thinknsh> say Pushing the hotfix now, give me 5 minutes
+```
+
+---
+
+### Shell Commands
+
+#### `status`
+Show a full overview of your current shell session: auth status, active room, WebSocket connection, server URL, and version.
+
+```bash
+thinknsh> status
+# ──────────────────────────────────────
+#  ThinkNCollab Shell — Session Status
+# ──────────────────────────────────────
+#  User       : Raman Singh
+#  Email      : raman@example.com
+#  Server     : https://app.thinkncollab.com
+#  WebSocket  : ✅ Connected
+#  Active Room: frontend-team (room-abc123)
+#  Version    : 1.2.0
+# ──────────────────────────────────────
+```
+
+#### `help`
+List all registered commands grouped by category, with descriptions.
+
+```bash
+thinknsh> help
+```
+
+#### `clear`
+Clear the terminal screen.
+
+```bash
+thinknsh> clear
+```
+
+#### `exit` / `quit`
+Exit the interactive shell gracefully.
+
+```bash
+thinknsh> exit
+```
+
+---
+
+## Single-Command Mode
+
+You can run **any command as a one-liner** without entering the interactive shell. The shell executes the command and exits immediately — great for scripting or CI pipelines.
+
+```bash
+thinknsh status
+thinknsh whoami
+thinknsh join room-abc123
+thinknsh say "Deployment complete ✅"
+thinknsh rooms
+```
+
+Multi-word commands work naturally:
+
+```bash
+thinknsh say Build passed. Deploying to staging now.
+thinknsh invite contractor@example.com
+```
+
+---
+
+## Built-in Shell Features
+
+### Command History
+The interactive shell remembers your previously run commands across sessions. Use the **Up/Down arrow keys** to navigate history.
+
+### Aliases
+Create shortcuts for frequently used commands:
+
+```bash
+thinknsh> alias fe="join room-abc123"
+thinknsh> fe          # runs: join room-abc123
+```
+
+### Shell Variables
+Set and use variables within the shell:
+
+```bash
+thinknsh> set ROOM=room-abc123
+thinknsh> join $ROOM
+```
+
+### Tab Completion
+Press `Tab` to autocomplete commands and room names.
+
+### Piping & Chaining (Single-command mode)
+Chain commands using `&&` in your terminal:
+
+```bash
+thinknsh login && thinknsh join room-abc123 && thinknsh status
+```
+
+---
+
+## Examples
+
+```bash
+# Check who you are
+thinknsh whoami
+
+# See all your rooms, then join one
+thinknsh rooms
+thinknsh join room-abc123
+
+# Send a quick message without opening the shell
+thinknsh say "Hotfix deployed to production"
+
+# Invite a new member
+thinknsh invite dev@company.com
+
+# Full interactive session
+thinknsh
+thinknsh> login
+thinknsh> rooms
+thinknsh> join frontend-team
+thinknsh> say Good morning everyone 🚀
+thinknsh> teammates
+thinknsh> status
+thinknsh> exit
+```
+
+---
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `THINKNCOLLAB_SERVER` | `https://thinkncollab.com` | Main server URL (REST + WebSocket base) |
+| `THINKNCOLLAB_API_URL` | `https://thinkncollab.com` | REST API base URL (overrides SERVER for API calls) |
+| `THINKNCOLLAB_WS_URL` | `https://thinkncollab.com` | WebSocket server URL |
+| `THINKNCOLLAB_AUTO_CONNECT` | `false` | Set to `true` to auto-connect WebSocket on shell start |
+
+In production, all three URL variables typically point to the same host:
+
+```bash
+export THINKNCOLLAB_SERVER=https://app.thinkncollab.com
+export THINKNCOLLAB_API_URL=https://app.thinkncollab.com
+export THINKNCOLLAB_WS_URL=https://app.thinkncollab.com
+export THINKNCOLLAB_AUTO_CONNECT=true
+```
+
+---
+
+## License
+
+MIT © ThinkNCollab

package/bin/thinknsh.js

@@ -46,9 +46,9 @@ if (args.includes('--version') || args.includes('-v')) {
 }
 
 const shell = new ThinkNCollabShell({
-    serverUrl:   process.env.THINKNCOLLAB_SERVER    || 'https//thinkncollab.com',  // ← /thinknsh hata
-    apiUrl:      process.env.THINKNCOLLAB_API_URL   || 'https//thinkncollab.com',
-    wsUrl:       process.env.THINKNCOLLAB_WS_URL    || 'https//thinkncollab.com',
+    serverUrl:   process.env.THINKNCOLLAB_SERVER    || 'https://thinkncollab.com',  // ← /thinknsh hata
+    apiUrl:      process.env.THINKNCOLLAB_API_URL   || 'https://thinkncollab.com',
+    wsUrl:       process.env.THINKNCOLLAB_WS_URL    || 'https://thinkncollab.com',
     autoConnect: process.env.THINKNCOLLAB_AUTO_CONNECT === 'true'
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thinkncollab-shell",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "ThinkNCollab Custom Shell with WebSocket collaboration",
   "main": "src/core/shell.js",
   "bin": {

package/src/core/notification-window.js

@@ -71,6 +71,7 @@ function printNotification(data) {
             break;
         }
         case 'typing':
+            beep();
             process.stdout.write(`\r${chalk.dim(`✏️  ${data.username} is typing...    `)}`);
             break;
         case 'stoppedTyping':

package/src/core/shell.js

@@ -408,7 +408,7 @@ class ThinkNCollabShell extends EventEmitter {
         console.log(chalk.cyan(`🔗 Joining: ${args[0]}...`));
         try {
             const result = await this.ws.joinRoom(args[0], args[1]);
-            console.log(chalk.green(`✅ Joined: ${result.roomName || args[0]}`));
+            console.log(chalk.green(`Joined: ${result.roomName || args[0]}`));
         } catch (err) { console.log(chalk.red(`❌ ${err.message}`)); }
     }
 
@@ -446,7 +446,7 @@ class ThinkNCollabShell extends EventEmitter {
         if (!msg) { console.log(chalk.red('Usage: notify <type> <message>')); return; }
         try {
             await this.ws.sendNotification({ type, title: 'Shell Notification', message: msg });
-            console.log(chalk.green('✅ Notification sent'));
+            console.log(chalk.green('Notification sent'));
         } catch (err) { console.log(chalk.red(`Failed: ${err.message}`)); }
     }
 
@@ -454,24 +454,24 @@ class ThinkNCollabShell extends EventEmitter {
         if (!args.length) { for (const [a, c] of this.aliases) console.log(`  ${chalk.green(a.padEnd(12))} → ${chalk.dim(c)}`); return; }
         if (args.length < 2) { console.log(chalk.red('Usage: alias <n> <cmd>')); return; }
         this.addAlias(args[0], args.slice(1).join(' '));
-        console.log(chalk.green(`✅ ${args[0]} → ${args.slice(1).join(' ')}`));
+        console.log(chalk.green(`${args[0]} → ${args.slice(1).join(' ')}`));
     }
 
     async unaliasCommand(args) {
         if (!args[0]) { console.log(chalk.red('Usage: unalias <n>')); return; }
-        this.aliases.delete(args[0]) ? console.log(chalk.green(`✅ Removed: ${args[0]}`)) : console.log(chalk.red(`Not found: ${args[0]}`));
+        this.aliases.delete(args[0]) ? console.log(chalk.green(`Removed: ${args[0]}`)) : console.log(chalk.red(`Not found: ${args[0]}`));
     }
 
     async setCommand(args) {
         if (!args.length) { for (const [k, v] of this.variables) console.log(`  ${chalk.green(k.padEnd(12))} = ${v}`); return; }
         if (args.length < 2) { console.log(chalk.red('Usage: set <n> <value>')); return; }
         this.variables.set(args[0], args.slice(1).join(' '));
-        console.log(chalk.green(`✅ ${args[0]} = ${args.slice(1).join(' ')}`));
+        console.log(chalk.green(`${args[0]} = ${args.slice(1).join(' ')}`));
     }
 
     async unsetCommand(args) {
         if (!args[0]) { console.log(chalk.red('Usage: unset <n>')); return; }
-        this.variables.delete(args[0]) ? console.log(chalk.green(`✅ Removed`)) : console.log(chalk.red(`Not found`));
+        this.variables.delete(args[0]) ? console.log(chalk.green(`Removed`)) : console.log(chalk.red(`Not found`));
     }
 
     getSessionPath() { return path.join(this.config.configDir, 'session.json'); }
@@ -509,7 +509,7 @@ class ThinkNCollabShell extends EventEmitter {
         } catch {}
         console.log(chalk.cyan(`
 ╔══════════════════════════════════════════════════════╗
-║     ThinkNCollab Shell v0.0.03                       ║
+║     ThinkNCollab Shell v0.0.05                       ║
 ║     Type 'help' for commands                         ║
 ╚══════════════════════════════════════════════════════╝`));
     }

package/src/core/websocket.js

@@ -19,10 +19,12 @@ class WebSocketManager extends EventEmitter {
 
         this.socket         = null;
         this.connected      = false;
-        this.currentUser    = null;  // { userId, name, userType }
+        this.currentUser    = null;
         this.roomId         = null;
         this.reconnectCount = 0;
         this.messageQueue   = [];
+        this._authToken     = null;
+        this._handlersSetup = false;
     }
 
     // ─── Connect ──────────────────────────────────────────────────────────────
@@ -30,7 +32,8 @@ class WebSocketManager extends EventEmitter {
     connect(authToken = null) {
         return new Promise((resolve, reject) => {
             try {
-                // Connect to /thinknsh namespace — isolated from web
+                this._authToken = authToken;
+
                 this.socket = io(this.config.serverUrl + '/thinknsh', {
                     transports:           ['websocket', 'polling'],
                     reconnection:         true,
@@ -45,9 +48,7 @@ class WebSocketManager extends EventEmitter {
                     clearTimeout(timeout);
                     this.connected      = true;
                     this.reconnectCount = 0;
-                    this._authToken     = authToken;
 
-                    // Announce terminal to backend — join personal notification room
                     if (this.currentUser) {
                         console.log('🖥️  Emitting thinknsh:connected for', this.currentUser.userId);
                         this.socket.emit('thinknsh:connected', {
@@ -61,6 +62,10 @@ class WebSocketManager extends EventEmitter {
                     this.emit('connected', { socketId: this.socket.id });
                     resolve({ success: true, socketId: this.socket.id });
                 });
+                // One-time listener for confirmation
+// this.ws.once('notified', (data) => {
+//     console.log(chalk.green(`✅ Notification sent to ${data.sentTo} member(s) in "${data.roomName}"`));
+// });
 
                 this.socket.on('connect_error', (error) => {
                     clearTimeout(timeout);
@@ -79,13 +84,27 @@ class WebSocketManager extends EventEmitter {
                 this.socket.on('reconnect', (attemptNumber) => {
                     this.connected = true;
                     this.emit('reconnected', { attemptNumber });
+
+                    // Re-announce user after reconnect
+                    if (this.currentUser) {
+                        this.socket.emit('thinknsh:connected', {
+                            userId:     this.currentUser.userId,
+                            userName:   this.currentUser.name,
+                            shellToken: this._authToken,
+                        });
+                    }
+
                     // Rejoin room after reconnect
                     if (this.roomId && this.currentUser) {
                         this._emitJoin(this.roomId);
                     }
                 });
 
-                this.setupEventHandlers(authToken);
+                // ✅ Setup handlers only ONCE per socket instance
+                if (!this._handlersSetup) {
+                    this.setupEventHandlers();
+                    this._handlersSetup = true;
+                }
 
             } catch (error) {
                 reject(error);
@@ -93,33 +112,39 @@ class WebSocketManager extends EventEmitter {
         });
     }
 
-    // ─── thinknsh: event handlers ─────────────────────────────────────────────
+    // ─── Event Handlers (registered once) ────────────────────────────────────
 
-    setupEventHandlers(authToken) {
+    setupEventHandlers() {
 
         // Terminal ready confirmed by server
         this.socket.on('thinknsh:ready', (data) => {
             this.emit('ready', data);
         });
 
-        // Room join confirmed
+        // ✅ Room join confirmed + history delivered
         this.socket.on('thinknsh:joined', (data) => {
             this.roomId = data.roomId;
+
+            // Emit history separately so shell.js can display it
+            if (data.history && data.history.length > 0) {
+                this.emit('messageHistory', data.history);
+            }
+
             this.emit('roomJoined', data);
         });
 
-        // Incoming message from terminal or web
+        // Incoming message from terminal users
         this.socket.on('thinknsh:message', (data) => {
             this.emit('message', {
                 username:  data.name,
                 userId:    data.userId,
                 message:   data.message,
-                source:    data.source || 'web',
+                source:    data.source || 'shell',
                 timestamp: data.timestamp,
             });
         });
 
-        // Also listen to standard chat-message (from web users)
+        // Incoming message from web users
         this.socket.on('chat-message', (data) => {
             this.emit('message', {
                 username:  data.name,
@@ -135,14 +160,19 @@ class WebSocketManager extends EventEmitter {
             this.emit('userJoined', { username: data.name, source: 'shell' });
         });
 
+        // ✅ User left from terminal
+        this.socket.on('thinknsh:userLeft', (data) => {
+            this.emit('userLeft', { username: data.name, source: 'shell' });
+        });
+
         // User joined from web
         this.socket.on('user-joined', (name) => {
             this.emit('userJoined', { username: name, source: 'web' });
         });
 
-        // User left
+        // User left from web
         this.socket.on('user-left', (name) => {
-            this.emit('userLeft', { username: name });
+            this.emit('userLeft', { username: name, source: 'web' });
         });
 
         // User list updated
@@ -150,40 +180,50 @@ class WebSocketManager extends EventEmitter {
             this.emit('userList', { users });
         });
 
-        // Notifications from NotificationEngine
-        this.socket.on('new-notification', (notification) => {
-            this.emit('notification', {
-                type:    notification.type    || 'info',
-                title:   notification.type    || 'Notification',
-                message: notification.message || '',
-                meta:    notification.meta    || {},
-            });
-        });
-
-        // Terminal status (online/offline) — website sends this
-        this.socket.on('thinknsh:status', (data) => {
-            this.emit('shellStatus', data);
+        // ✅ Manual history fetch response
+        this.socket.on('thinknsh:history', (data) => {
+            if (data.messages && data.messages.length > 0) {
+                this.emit('messageHistory', data.messages);
+            } else {
+                this.emit('messageHistory', []);
+            }
         });
 
-        // ── new-notification from NotificationEngine → forward to TCP window ──
+        // Single new-notification listener
         this.socket.on('new-notification', (data) => {
-            // This goes to shell.js pushNotification → TCP → notification window
             this.emit('notification', {
-                type:    data.type    || 'notification',
-                level:   data.type   || 'info',
-                title:   data.type   || 'Notification',
-                message: data.message || '',
+                type:       data.type       || 'notification',
+                level:      data.type       || 'info',
+                title:      data.type       || 'Notification',
+                message:    data.message    || '',
+                meta:       data.meta       || {},
                 taskTitle:  data.taskTitle  || data.meta?.taskTitle  || '',
                 assignedBy: data.assignedBy || data.meta?.assignedBy || '',
             });
         });
 
+        // Room activity feed
+        this.socket.on('room:activity', (data) => {
+            this.emit('roomActivity', {
+                action:    data.action,
+                label:     data.label,
+                userName:  data.userName,
+                meta:      data.meta      || {},
+                createdAt: data.createdAt || new Date(),
+            });
+        });
+
+        // Terminal status (online/offline)
+        this.socket.on('thinknsh:status', (data) => {
+            this.emit('shellStatus', data);
+        });
+
         // Notification list response
         this.socket.on('thinknsh:notifications', (data) => {
             this.emit('notificationList', data.notifications);
         });
 
-        // Error from server
+        // Server errors
         this.socket.on('thinknsh:error', (data) => {
             this.emit('serverError', data);
         });
@@ -197,11 +237,13 @@ class WebSocketManager extends EventEmitter {
 
     setUser(user, token = null) {
         this.currentUser = user;
-        // If already connected, announce now
+        if (token) this._authToken = token;
+
         if (this.connected && this.socket) {
             this.socket.emit('thinknsh:connected', {
                 userId:     user.userId,
-                shellToken: token,
+                userName:   user.name,
+                shellToken: token || this._authToken,
             });
         }
     }
@@ -265,13 +307,48 @@ class WebSocketManager extends EventEmitter {
         return Promise.resolve({ success: true });
     }
 
-    // ─── Get unread notifications ─────────────────────────────────────────────
+    // ─── Fetch message history manually ──────────────────────────────────────
+
+    getHistory(limit = 30, skip = 0) {
+        if (!this.connected || !this.socket) return;
+        if (!this.roomId) return;
+
+        this.socket.emit('thinknsh:getHistory', {
+            roomId: this.roomId,
+            limit,
+            skip,
+        });
+    }
+
+    // ─── Notifications ────────────────────────────────────────────────────────
 
     getNotifications() {
         if (!this.connected || !this.currentUser) return;
-        this.socket.emit('thinknsh:getNotifications', { userId: this.currentUser.userId });
+        this.socket.emit('thinknsh:getNotifications', {
+            userId: this.currentUser.userId
+        });
+    }
+
+    // ─── Send notification ────────────────────────────────────────────────────
+
+sendNotification(notification, target = 'room') {
+    if (!this.connected || !this.socket) {
+        return Promise.reject(new Error('Not connected'));
     }
 
+    const payload = {
+        type:      notification.type    || 'info',
+        title:     notification.title   || 'Notification',
+        message:   notification.message,
+        data:      notification.data    || {},
+        target:    target === 'room' ? this.roomId : target,
+        timestamp: new Date().toISOString()
+    };
+
+    this.socket.emit('notification:send', payload);
+    return Promise.resolve({ success: true });
+}
+
     markNotificationsRead(notificationIds = []) {
         if (!this.connected || !this.currentUser) return;
         this.socket.emit('thinknsh:markRead', {
@@ -287,12 +364,10 @@ class WebSocketManager extends EventEmitter {
         this.socket.emit('thinknsh:connected', {
             userId,
             userName:   this.currentUser?.name || '',
-            shellToken: this._token || null,
+            shellToken: this._authToken || null,
         });
     }
 
-    sendTyping() {}  // add later if needed
-
     ping() {
         if (this.connected && this.socket) this.socket.emit('ping');
     }
@@ -304,19 +379,22 @@ class WebSocketManager extends EventEmitter {
         }
     }
 
+    sendTyping() {} // add later if needed
+
     disconnect() {
         if (this.socket) {
             this.socket.disconnect();
-            this.socket      = null;
-            this.connected   = false;
-            this.currentUser = null;
-            this.roomId      = null;
+            this.socket         = null;
+            this.connected      = false;
+            this.currentUser    = null;
+            this.roomId         = null;
+            this._handlersSetup = false;
         }
     }
 
-    isConnected()    { return this.connected && !!this.socket?.connected; }
-    getCurrentRoom() { return this.roomId; }
-    getSocketId()    { return this.socket?.id || null; }
+    isConnected()     { return this.connected && !!this.socket?.connected; }
+    getCurrentRoom()  { return this.roomId; }
+    getSocketId()     { return this.socket?.id || null; }
     getParticipants() { return Promise.resolve([]); }
 }