group-chat-mcp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-03-21
+
+### Added
+
+- MCP server with 8 tools: `list_conversations`, `list_participants`, `send_message`, `get_conversation`, `update_profile`, `create_conversation`, `join_conversation`, `leave_conversation`
+- Self-registering server: generates a fresh UUID per startup, registers the agent, joins the project conversation, performs full cleanup on shutdown, and reaps stale agents
+- `gchat install` and `gchat uninstall` CLI commands for configuring Claude Code and Cursor MCP server entries (global or local scope)
+- File-based shared state with atomic locking via `withFileLock` and `withStateLock`
+- Inbox polling service for channel-push notifications to connected agents
+- UUID validation on file paths to prevent directory traversal
+- Participant verification on `send_message` (agent must be in conversation)
+- Signal handler cleanup (SIGTERM, SIGINT) with `process.once`
+- TypeScript project scaffolding with `tsconfig.json`, build scripts, and Vitest
+- 58 unit tests covering state service, tool handlers, installer service, and server lifecycle
+- Type definitions for agents, conversations, messages, notifications, and profiles
+- Enums for `ConversationType`, `MessageType`, `NotificationType`, `IDE`, and `Scope`
+- Tool schemas (`src/schemas/tool-schemas.ts`) and handlers (`src/services/tool-handlers.ts`)
+- Environment config with `GC_PROJECT_PATH` (optional) and `GC_POLL_INTERVAL_MS` (optional, 2000ms default)

package/README.md

@@ -0,0 +1,170 @@
+# Group Chat MCP
+
+Multi-agent communication server using the Model Context Protocol. Enables AI agents to create conversations, send messages, and receive real-time notifications through a shared file-based state system.
+
+## Features
+
+- Real-time multi-agent messaging via MCP channel notifications
+- Project-scoped and direct message conversations
+- Automatic agent registration and cleanup per session
+- File-based shared state with atomic locking
+- Zero-config setup via `gchat install`
+
+## Installation
+
+### From npm
+
+```bash
+npm install -g group-chat-mcp
+```
+
+### From source
+
+```bash
+git clone https://github.com/appboypov/group-chat-mcp.git
+cd group-chat-mcp
+npm install
+npm run build
+npm install -g .
+```
+
+## Setup
+
+Run the installer to configure your IDE:
+
+```bash
+gchat install
+```
+
+The installer prompts for:
+- **IDE**: Claude Code, Cursor, or Both
+- **Scope**: Global (all projects) or Local (current project only)
+
+This writes the MCP server configuration to the appropriate settings file. No manual JSON editing required.
+
+To remove the configuration:
+
+```bash
+gchat uninstall
+```
+
+### Enable channel notifications
+
+Channel notifications allow agents to receive messages in real-time as they arrive. For Claude Code, start your session with:
+
+```bash
+claude --dangerously-load-development-channels server:group-chat-mcp
+```
+
+Without this flag, agents can still read messages by calling `get_conversation`, but incoming messages will not be injected into the conversation automatically.
+
+## Usage
+
+After setup, the MCP server starts automatically when your IDE launches a session. Each session:
+
+1. Generates a unique agent ID
+2. Registers the agent in the shared state
+3. Joins the project conversation (one per project directory)
+4. Polls for incoming notifications
+5. Cleans up on disconnect (leaves conversations, unregisters)
+
+Multiple agents in the same project directory share a single project conversation.
+
+## Tools
+
+### list_conversations
+
+List active conversations.
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| scope | string | No | `"project"`, `"global"`, or `"all"` (default: `"all"`) |
+
+Returns a list of active conversations with ID, name, type, topic, and participant count.
+
+### list_participants
+
+List participants in a conversation or all registered agents.
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| conversationId | string | No | If provided, lists participants in that conversation. Otherwise lists all agents. |
+
+Returns agent details including ID, name, role, expertise, and status.
+
+### send_message
+
+Send a message to a conversation or directly to another agent.
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| content | string | Yes | Message content |
+| conversationId | string | No | Target conversation ID |
+| agentId | string | No | Target agent ID for direct message |
+
+Either `conversationId` or `agentId` is required. Returns confirmation with message ID.
+
+### get_conversation
+
+Get conversation details and message history.
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| conversationId | string | Yes | Conversation ID |
+
+Returns conversation metadata and full message history.
+
+### update_profile
+
+Update the current agent's profile.
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| name | string | No | Display name |
+| role | string | No | Agent role |
+| expertise | string | No | Areas of expertise |
+| status | string | No | Current status |
+
+Returns the updated profile.
+
+### create_conversation
+
+Create a new group conversation.
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| name | string | Yes | Conversation name |
+| topic | string | No | Conversation topic |
+
+Returns the created conversation details.
+
+### join_conversation
+
+Join an existing conversation.
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| conversationId | string | Yes | Conversation ID |
+
+Returns confirmation. Notifies existing participants.
+
+### leave_conversation
+
+Leave a conversation.
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| conversationId | string | Yes | Conversation ID |
+
+Returns confirmation. Notifies remaining participants.
+
+## Configuration
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| GC_PROJECT_PATH | No | `process.cwd()` | Override the project directory path (must be an absolute path) |
+| GC_POLL_INTERVAL_MS | No | `2000` | Inbox polling interval in milliseconds |
+
+## License
+
+MIT

package/dist/constants/env.d.ts

@@ -0,0 +1,3 @@
+export declare const GC_PROJECT_PATH: string | undefined;
+export declare const GC_POLL_INTERVAL_MS: number;
+//# sourceMappingURL=env.d.ts.map

package/dist/constants/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,EAAE,MAAM,GAAG,SAAuC,CAAC;AAM/E,eAAO,MAAM,mBAAmB,EAAE,MAA8D,CAAC"}

package/dist/constants/env.js

@@ -0,0 +1,6 @@
+export const GC_PROJECT_PATH = process.env.GC_PROJECT_PATH;
+const parsedPollInterval = process.env.GC_POLL_INTERVAL_MS
+    ? parseInt(process.env.GC_POLL_INTERVAL_MS, 10)
+    : 2000;
+export const GC_POLL_INTERVAL_MS = isNaN(parsedPollInterval) ? 2000 : parsedPollInterval;
+//# sourceMappingURL=env.js.map

package/dist/constants/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAuB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAE/E,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB;IACxD,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC;IAC/C,CAAC,CAAC,IAAI,CAAC;AAET,MAAM,CAAC,MAAM,mBAAmB,GAAW,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC"}

package/dist/constants/settings-paths.d.ts

@@ -0,0 +1,5 @@
+export declare const CLAUDE_CODE_GLOBAL: string;
+export declare const CURSOR_GLOBAL: string;
+export declare function CLAUDE_CODE_LOCAL(): string;
+export declare function CURSOR_LOCAL(): string;
+//# sourceMappingURL=settings-paths.d.ts.map

package/dist/constants/settings-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-paths.d.ts","sourceRoot":"","sources":["../../src/constants/settings-paths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,QAAsD,CAAC;AACtF,eAAO,MAAM,aAAa,QAAiD,CAAC;AAE5E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/constants/settings-paths.js

@@ -0,0 +1,11 @@
+import os from 'node:os';
+import path from 'node:path';
+export const CLAUDE_CODE_GLOBAL = path.join(os.homedir(), '.claude', 'settings.json');
+export const CURSOR_GLOBAL = path.join(os.homedir(), '.cursor', 'mcp.json');
+export function CLAUDE_CODE_LOCAL() {
+    return path.join(process.cwd(), '.mcp.json');
+}
+export function CURSOR_LOCAL() {
+    return path.join(process.cwd(), '.cursor', 'mcp.json');
+}
+//# sourceMappingURL=settings-paths.js.map

package/dist/constants/settings-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-paths.js","sourceRoot":"","sources":["../../src/constants/settings-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAE5E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC"}

package/dist/constants/storage.d.ts

@@ -0,0 +1,6 @@
+export declare const BASE_DIR: string;
+export declare const AGENTS_FILE = "agents.json";
+export declare const CONVERSATIONS_FILE = "conversations.json";
+export declare const MESSAGES_DIR = "messages";
+export declare const INBOXES_DIR = "inboxes";
+//# sourceMappingURL=storage.d.ts.map

package/dist/constants/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/constants/storage.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ,QAA6C,CAAC;AACnE,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,WAAW,YAAY,CAAC"}

package/dist/constants/storage.js

@@ -0,0 +1,8 @@
+import os from 'node:os';
+import path from 'node:path';
+export const BASE_DIR = path.join(os.homedir(), '.group-chat-mcp');
+export const AGENTS_FILE = 'agents.json';
+export const CONVERSATIONS_FILE = 'conversations.json';
+export const MESSAGES_DIR = 'messages';
+export const INBOXES_DIR = 'inboxes';
+//# sourceMappingURL=storage.js.map

package/dist/constants/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/constants/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC"}

package/dist/enums/conversation-type.d.ts

@@ -0,0 +1,6 @@
+export declare enum ConversationType {
+    Project = "project",
+    Dm = "dm",
+    Group = "group"
+}
+//# sourceMappingURL=conversation-type.d.ts.map

package/dist/enums/conversation-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-type.d.ts","sourceRoot":"","sources":["../../src/enums/conversation-type.ts"],"names":[],"mappings":"AAAA,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,EAAE,OAAO;IACT,KAAK,UAAU;CAChB"}

package/dist/enums/conversation-type.js

@@ -0,0 +1,7 @@
+export var ConversationType;
+(function (ConversationType) {
+    ConversationType["Project"] = "project";
+    ConversationType["Dm"] = "dm";
+    ConversationType["Group"] = "group";
+})(ConversationType || (ConversationType = {}));
+//# sourceMappingURL=conversation-type.js.map

package/dist/enums/conversation-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-type.js","sourceRoot":"","sources":["../../src/enums/conversation-type.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,uCAAmB,CAAA;IACnB,6BAAS,CAAA;IACT,mCAAe,CAAA;AACjB,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B"}

package/dist/enums/ide.d.ts

@@ -0,0 +1,5 @@
+export declare enum IDE {
+    ClaudeCode = "claudeCode",
+    Cursor = "cursor"
+}
+//# sourceMappingURL=ide.d.ts.map

package/dist/enums/ide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide.d.ts","sourceRoot":"","sources":["../../src/enums/ide.ts"],"names":[],"mappings":"AAAA,oBAAY,GAAG;IACb,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB"}

package/dist/enums/ide.js

@@ -0,0 +1,6 @@
+export var IDE;
+(function (IDE) {
+    IDE["ClaudeCode"] = "claudeCode";
+    IDE["Cursor"] = "cursor";
+})(IDE || (IDE = {}));
+//# sourceMappingURL=ide.js.map

package/dist/enums/ide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide.js","sourceRoot":"","sources":["../../src/enums/ide.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,GAGX;AAHD,WAAY,GAAG;IACb,gCAAyB,CAAA;IACzB,wBAAiB,CAAA;AACnB,CAAC,EAHW,GAAG,KAAH,GAAG,QAGd"}

package/dist/enums/index.d.ts

@@ -0,0 +1,4 @@
+export { ConversationType } from './conversation-type.js';
+export { MessageType } from './message-type.js';
+export { NotificationType } from './notification-type.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/enums/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enums/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/enums/index.js

@@ -0,0 +1,4 @@
+export { ConversationType } from './conversation-type.js';
+export { MessageType } from './message-type.js';
+export { NotificationType } from './notification-type.js';
+//# sourceMappingURL=index.js.map

package/dist/enums/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enums/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/enums/message-type.d.ts

@@ -0,0 +1,5 @@
+export declare enum MessageType {
+    Message = "message",
+    System = "system"
+}
+//# sourceMappingURL=message-type.d.ts.map

package/dist/enums/message-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-type.d.ts","sourceRoot":"","sources":["../../src/enums/message-type.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB"}

package/dist/enums/message-type.js

@@ -0,0 +1,6 @@
+export var MessageType;
+(function (MessageType) {
+    MessageType["Message"] = "message";
+    MessageType["System"] = "system";
+})(MessageType || (MessageType = {}));
+//# sourceMappingURL=message-type.js.map

package/dist/enums/message-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-type.js","sourceRoot":"","sources":["../../src/enums/message-type.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;AACnB,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB"}

package/dist/enums/notification-type.d.ts

@@ -0,0 +1,9 @@
+export declare enum NotificationType {
+    Message = "message",
+    Join = "join",
+    Leave = "leave",
+    ProfileUpdate = "profile_update",
+    ConversationCreated = "conversation_created",
+    ConversationUpdated = "conversation_updated"
+}
+//# sourceMappingURL=notification-type.d.ts.map

package/dist/enums/notification-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-type.d.ts","sourceRoot":"","sources":["../../src/enums/notification-type.ts"],"names":[],"mappings":"AAAA,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,aAAa,mBAAmB;IAChC,mBAAmB,yBAAyB;IAC5C,mBAAmB,yBAAyB;CAC7C"}

package/dist/enums/notification-type.js

@@ -0,0 +1,10 @@
+export var NotificationType;
+(function (NotificationType) {
+    NotificationType["Message"] = "message";
+    NotificationType["Join"] = "join";
+    NotificationType["Leave"] = "leave";
+    NotificationType["ProfileUpdate"] = "profile_update";
+    NotificationType["ConversationCreated"] = "conversation_created";
+    NotificationType["ConversationUpdated"] = "conversation_updated";
+})(NotificationType || (NotificationType = {}));
+//# sourceMappingURL=notification-type.js.map

package/dist/enums/notification-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-type.js","sourceRoot":"","sources":["../../src/enums/notification-type.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,gBAOX;AAPD,WAAY,gBAAgB;IAC1B,uCAAmB,CAAA;IACnB,iCAAa,CAAA;IACb,mCAAe,CAAA;IACf,oDAAgC,CAAA;IAChC,gEAA4C,CAAA;IAC5C,gEAA4C,CAAA;AAC9C,CAAC,EAPW,gBAAgB,KAAhB,gBAAgB,QAO3B"}

package/dist/enums/scope.d.ts

@@ -0,0 +1,5 @@
+export declare enum Scope {
+    Global = "global",
+    Local = "local"
+}
+//# sourceMappingURL=scope.d.ts.map

package/dist/enums/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/enums/scope.ts"],"names":[],"mappings":"AAAA,oBAAY,KAAK;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB"}

package/dist/enums/scope.js

@@ -0,0 +1,6 @@
+export var Scope;
+(function (Scope) {
+    Scope["Global"] = "global";
+    Scope["Local"] = "local";
+})(Scope || (Scope = {}));
+//# sourceMappingURL=scope.js.map

package/dist/enums/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/enums/scope.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,KAGX;AAHD,WAAY,KAAK;IACf,0BAAiB,CAAA;IACjB,wBAAe,CAAA;AACjB,CAAC,EAHW,KAAK,KAAL,KAAK,QAGhB"}

package/dist/gchat.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import type { ParseResult } from './types/parse-result.js';
+export declare function parseCommand(args: string[]): ParseResult;
+//# sourceMappingURL=gchat.d.ts.map

package/dist/gchat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gchat.d.ts","sourceRoot":"","sources":["../src/gchat.ts"],"names":[],"mappings":";AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CASxD"}

package/dist/gchat.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import { realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { IDE } from './enums/ide.js';
+import { Scope } from './enums/scope.js';
+import { InstallerService } from './services/installer-service.js';
+import { PromptUtils } from './utils/prompt-utils.js';
+const installer = new InstallerService();
+export function parseCommand(args) {
+    const command = args[0];
+    if (!command) {
+        return { error: 'no-command' };
+    }
+    if (command !== 'install' && command !== 'uninstall') {
+        return { error: 'unknown-command' };
+    }
+    return { command };
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const result = parseCommand(args);
+    if ('error' in result) {
+        if (result.error === 'no-command') {
+            console.error('Usage: gchat <command>');
+            console.error('Commands:');
+            console.error('  install     Install group-chat-mcp into your IDE');
+            console.error('  uninstall   Remove group-chat-mcp from your IDE');
+            process.exit(1);
+        }
+        console.error(`Unknown command: ${args[0]}`);
+        console.error('Available commands: install, uninstall');
+        process.exit(1);
+    }
+    const prompt = new PromptUtils();
+    try {
+        const ides = await prompt.selectIDE();
+        const scope = await prompt.selectScope();
+        for (const ide of ides) {
+            const ideName = ide === IDE.ClaudeCode ? 'Claude Code' : 'Cursor';
+            const scopeName = scope === Scope.Global ? 'global' : 'local';
+            if (result.command === 'install') {
+                await installer.install({ ide, scope });
+                const settingsPath = installer.resolveSettingsPath(ide, scope);
+                console.log(`✓ Installed group-chat-mcp for ${ideName} (${scopeName}): ${settingsPath}`);
+            }
+            else {
+                await installer.uninstall({ ide, scope });
+                const settingsPath = installer.resolveSettingsPath(ide, scope);
+                console.log(`✓ Uninstalled group-chat-mcp from ${ideName} (${scopeName}): ${settingsPath}`);
+            }
+        }
+    }
+    finally {
+        prompt.close();
+    }
+}
+const currentFile = fileURLToPath(import.meta.url);
+const isDirectExecution = (() => {
+    try {
+        return realpathSync(process.argv[1]) === currentFile;
+    }
+    catch {
+        return false;
+    }
+})();
+if (isDirectExecution) {
+    main().catch((err) => {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=gchat.js.map

package/dist/gchat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gchat.js","sourceRoot":"","sources":["../src/gchat.ts"],"names":[],"mappings":"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"}

package/dist/handlers/tool-handlers.d.ts

@@ -0,0 +1,10 @@
+import { NotificationType } from '../enums/notification-type.js';
+import { StateService } from '../services/state-service.js';
+export declare function writeNotificationToParticipants(stateService: StateService, conversationId: string, senderId: string, type: NotificationType, content: string, excludeAgentId?: string): Promise<void>;
+export declare function handleToolCall(stateService: StateService, name: string, agentId: string, rawArgs: Record<string, unknown> | undefined): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=tool-handlers.d.ts.map

package/dist/handlers/tool-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/tool-handlers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAWjE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAa5D,wBAAsB,+BAA+B,CACnD,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;;;;GAuN7C"}