group-chat-mcp 0.1.1 → 0.1.3

package/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: npm-publish
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org
+
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+
+      - name: Set version from tag
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          npm version "$TAG" --no-git-tag-version --allow-same-version
+
+      - run: npm publish --provenance --access public

package/CHANGELOG.md

@@ -5,6 +5,48 @@ 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.3] - 2026-03-21
+
+### Added
+
+- `read_notifications` MCP tool for pull-based notification retrieval (replaces push-based inbox poller for Cursor)
+- Cursor session lifecycle hooks: `sessionStart`, `sessionEnd`, `beforeMCPExecution` via `hooks.json`
+- `SessionStateService` for per-PID session state management with in-memory cache and stale session reaping
+- `cursor-join` and `cursor-leave` CLI commands for hook-driven agent registration
+- `GC_CLIENT_TYPE` environment variable to disable push-based inbox poller when set to `cursor`
+- `writeNotificationToParticipants` and `formatNotificationContent` extracted to `src/utils/notification-utils.ts`
+- `readAndClearInbox` method on `StateService` for atomic inbox read-and-clear
+- Cursor installer writes `hooks.json` with idempotent merge logic preserving existing non-group-chat-mcp hooks
+- Cursor `mcp.json` entry now includes `GC_CLIENT_TYPE` and `GC_POLL_INTERVAL_MS` in env block
+- 28 new tests across 5 test files covering session state, CLI commands, cursor hook, installer hooks, and read_notifications
+- Vitest configuration (`vitest.config.ts`)
+
+### Changed
+
+- `ParsedCommand` changed from interface to discriminated union type with `cursor-join` and `cursor-leave` variants
+- `ParsedError` extended with `missing-required-arg` variant and optional `message` field
+- MCP server dynamically resolves agent ID from session state on each tool call (falls back to startup-registered ID)
+- Inbox poller conditionally skipped when `GC_CLIENT_TYPE === 'cursor'`
+- Vitest include updated to cover both `src/__tests__/` and `tests/` directories
+
+### Fixed
+
+- `readStdin()` in cursor hook no longer leaks the timeout handle (added cleanup + `.unref()`)
+- `--server-pid` validation rejects zero, negative, and non-integer values in both `cursor-join` and `cursor-leave`
+- Existing installer tests updated to match new Cursor mcp.json format with `env` block
+
+## [0.1.2] - 2026-03-21
+
+### Added
+
+- npm auto-publish workflow on GitHub release
+- `repository` URL in `package.json` for npm provenance verification
+
+### Fixed
+
+- CI pipeline: switched to Node 24 for npm OIDC Trusted Publishing support
+- CI pipeline: resolved `NODE_AUTH_TOKEN` / OIDC auth conflicts for `npm publish`
+
 ## [0.1.1] - 2026-03-21
 
 ### Changed

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 appboypov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,9 @@
 # Group Chat MCP
 
+[![npm version](https://img.shields.io/npm/v/group-chat-mcp)](https://www.npmjs.com/package/group-chat-mcp)
+[![License](https://img.shields.io/github/license/appboypov/group-chat-mcp)](https://github.com/appboypov/group-chat-mcp/blob/main/LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+
 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
@@ -7,6 +11,8 @@ Multi-agent communication server using the Model Context Protocol. Enables AI ag
 - Real-time multi-agent messaging via MCP channel notifications
 - Project-scoped and direct message conversations
 - Automatic agent registration and cleanup per session
+- Per-session agent lifecycle for Cursor via hooks (`sessionStart`, `sessionEnd`, `beforeMCPExecution`)
+- Pull-based inbox for clients without push notification support (`read_notifications`)
 - File-based shared state with atomic locking
 - Zero-config setup via `gchat install`
 
@@ -40,7 +46,7 @@ The installer prompts for:
 - **IDE**: Claude Code, Cursor, or Both
 - **Scope**: Global (all projects) or Local (current project only)
 
-For Claude Code, the installer registers the MCP server via `claude mcp add` (requires the Claude Code CLI on PATH). For Cursor, it writes the configuration to the appropriate settings file.
+For Claude Code, the installer registers the MCP server via `claude mcp add` (requires the Claude Code CLI on PATH). For Cursor, it writes `mcp.json` with the server entry and `hooks.json` with session lifecycle hooks that register and unregister agents per chat session.
 
 To remove the configuration:
 
@@ -48,9 +54,9 @@ To remove the configuration:
 gchat uninstall
 ```
 
-### Enable channel notifications
+### Claude Code: enable channel notifications
 
-Channel notifications allow agents to receive messages in real-time as they arrive. For Claude Code, start your session with:
+Channel notifications allow agents to receive messages in real-time as they arrive. Start your session with:
 
 ```bash
 claude --dangerously-load-development-channels server:group-chat-mcp
@@ -58,6 +64,16 @@ 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.
 
+### Cursor: session lifecycle
+
+Cursor keeps MCP server processes alive across chat sessions. The installed hooks handle agent lifecycle automatically:
+
+- **`sessionStart`** registers a new agent and joins the project conversation.
+- **`sessionEnd`** leaves all conversations and unregisters the agent.
+- **`beforeMCPExecution`** auto-approves group-chat-mcp tools and prompts for all other MCP servers.
+
+Since Cursor does not support push notifications, agents use the `read_notifications` tool to poll for new messages.
+
 ## Usage
 
 After setup, the MCP server starts automatically when your IDE launches a session. Each session:
@@ -65,7 +81,7 @@ After setup, the MCP server starts automatically when your IDE launches a sessio
 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
+4. Polls for incoming notifications (Claude Code) or exposes `read_notifications` (Cursor)
 5. Cleans up on disconnect (leaves conversations, unregisters)
 
 Multiple agents in the same project directory share a single project conversation.
@@ -158,12 +174,21 @@ Leave a conversation.
 
 Returns confirmation. Notifies remaining participants.
 
+### read_notifications
+
+Check for new messages and notifications from other agents. Returns all pending notifications and clears the inbox. Cursor agents should call this periodically to stay updated on conversation activity.
+
+No input parameters.
+
+Returns pending notifications or `"No new notifications."` if the inbox is empty.
+
 ## 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 |
+| GC_POLL_INTERVAL_MS | No | `2000` (`5000` for Cursor) | Inbox polling interval in milliseconds. The Cursor installer sets this to `5000` via the mcp.json env block. |
+| GC_CLIENT_TYPE | No | — | Set to `"cursor"` to disable the push-based inbox poller (set automatically by the Cursor installer) |
 
 ## License
 

package/dist/__tests__/check-inbox.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=check-inbox.test.d.ts.map

package/dist/__tests__/check-inbox.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-inbox.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/check-inbox.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/check-inbox.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { StateService } from '../services/state-service.js';
+import { handleToolCall } from '../services/tool-handlers.js';
+import { NotificationType } from '../enums/notification-type.js';
+import { writeJsonFile } from '../utils/file-utils.js';
+import { formatNotificationContent } from '../utils/notification-utils.js';
+let tmpDir;
+let stateService;
+beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'gchat-inbox-test-'));
+    stateService = new StateService(tmpDir);
+    await stateService.init();
+});
+afterEach(async () => {
+    await fs.rm(tmpDir, { recursive: true, force: true });
+});
+describe('read_notifications', () => {
+    describe('Given 3 notifications in agent inbox', () => {
+        it('When read_notifications tool is called Then all 3 are returned', async () => {
+            const agent = await stateService.registerAgent('/test-project');
+            const inboxPath = path.join(tmpDir, 'inboxes', `${agent.id}.json`);
+            const notifications = [
+                { id: 'n1', type: NotificationType.Message, conversationId: 'conv-1', agentId: 'sender-1', content: 'Hello', timestamp: Date.now() },
+                { id: 'n2', type: NotificationType.Join, conversationId: 'conv-1', agentId: 'sender-2', content: 'sender-2 joined', timestamp: Date.now() },
+                { id: 'n3', type: NotificationType.Leave, conversationId: 'conv-1', agentId: 'sender-3', content: 'sender-3 left', timestamp: Date.now() },
+            ];
+            await writeJsonFile(inboxPath, notifications);
+            const result = await handleToolCall(stateService, 'read_notifications', agent.id, undefined);
+            const outputText = result.content[0].text;
+            const outputLines = outputText.split('\n');
+            const headerLine = outputLines[0];
+            const notificationLines = outputLines.slice(1).filter((line) => line.trim().length > 0);
+            expect(headerLine).toMatch(/^3 notification/);
+            expect(notificationLines.length).toBe(3);
+        });
+        it('When read_notifications tool is called Then inbox is empty after the call', async () => {
+            const agent = await stateService.registerAgent('/test-project');
+            const inboxPath = path.join(tmpDir, 'inboxes', `${agent.id}.json`);
+            const notifications = [
+                { id: 'n1', type: NotificationType.Message, conversationId: 'conv-1', agentId: 'sender-1', content: 'Hello', timestamp: Date.now() },
+                { id: 'n2', type: NotificationType.Join, conversationId: 'conv-1', agentId: 'sender-2', content: 'sender-2 joined', timestamp: Date.now() },
+                { id: 'n3', type: NotificationType.Leave, conversationId: 'conv-1', agentId: 'sender-3', content: 'sender-3 left', timestamp: Date.now() },
+            ];
+            await writeJsonFile(inboxPath, notifications);
+            await handleToolCall(stateService, 'read_notifications', agent.id, undefined);
+            const raw = await fs.readFile(inboxPath, 'utf-8');
+            const remaining = JSON.parse(raw);
+            expect(remaining).toEqual([]);
+        });
+    });
+    describe('Given empty inbox', () => {
+        it('When read_notifications tool is called Then result indicates no notifications and inbox remains empty', async () => {
+            const agent = await stateService.registerAgent('/test-project');
+            const result = await handleToolCall(stateService, 'read_notifications', agent.id, undefined);
+            expect(result.content).toBeDefined();
+            expect(result.content.length).toBeGreaterThan(0);
+            expect('isError' in result).toBe(false);
+            const inbox = await stateService.getInbox(agent.id);
+            expect(inbox).toEqual([]);
+        });
+    });
+    describe('Given agent has notifications', () => {
+        it('When read_notifications is called Then notifications are formatted using the same format as the inbox poller', async () => {
+            const agent = await stateService.registerAgent('/test-project');
+            const inboxPath = path.join(tmpDir, 'inboxes', `${agent.id}.json`);
+            const notifications = [
+                { id: 'n1', type: NotificationType.Message, conversationId: 'conv-1', agentId: 'sender-1', content: 'Hello', timestamp: Date.now() },
+                { id: 'n2', type: NotificationType.Join, conversationId: 'conv-1', agentId: 'sender-2', content: 'sender-2 joined', timestamp: Date.now() },
+                { id: 'n3', type: NotificationType.Leave, conversationId: 'conv-1', agentId: 'sender-3', content: 'sender-3 left', timestamp: Date.now() },
+            ];
+            await writeJsonFile(inboxPath, notifications);
+            const result = await handleToolCall(stateService, 'read_notifications', agent.id, undefined);
+            const outputText = result.content[0].text;
+            const outputLines = outputText.split('\n').slice(1);
+            for (let i = 0; i < notifications.length; i++) {
+                const expected = formatNotificationContent(notifications[i]);
+                expect(outputLines[i]).toBe(expected);
+            }
+        });
+    });
+});
+//# sourceMappingURL=check-inbox.test.js.map

package/dist/__tests__/check-inbox.test.js.map

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

package/dist/__tests__/cli-session-commands.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-session-commands.test.d.ts.map

package/dist/__tests__/cli-session-commands.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-session-commands.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cli-session-commands.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/cli-session-commands.test.js

@@ -0,0 +1,145 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { StateService } from '../services/state-service.js';
+import { SessionStateService } from '../services/session-state-service.js';
+import { handleCursorJoin, handleCursorLeave } from '../gchat.js';
+import { ConversationType } from '../enums/conversation-type.js';
+import { NotificationType } from '../enums/notification-type.js';
+import { INBOXES_DIR } from '../constants/storage.js';
+const UUID_V4_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+let tmpDir;
+let stateService;
+let sessionStateService;
+beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'gchat-cli-test-'));
+    stateService = new StateService(tmpDir);
+    await stateService.init();
+    sessionStateService = new SessionStateService(tmpDir);
+});
+afterEach(async () => {
+    await fs.rm(tmpDir, { recursive: true, force: true });
+});
+describe('cursor-join', () => {
+    describe('Given project path and server PID', () => {
+        it('When cursor-join is called Then an agent UUID and conversation UUID are returned', async () => {
+            const projectPath = '/test-project';
+            const serverPid = 12345;
+            const result = await handleCursorJoin(projectPath, serverPid, { stateService, sessionStateService });
+            expect(result.agentId).toMatch(UUID_V4_REGEX);
+            expect(result.conversationId).toMatch(UUID_V4_REGEX);
+        });
+        it('When cursor-join is called Then the agent is registered and session state is written', async () => {
+            const projectPath = '/test-project';
+            const serverPid = 12345;
+            const result = await handleCursorJoin(projectPath, serverPid, { stateService, sessionStateService });
+            const registeredAgent = await stateService.getAgent(result.agentId);
+            expect(registeredAgent).not.toBeNull();
+            expect(registeredAgent.projectPath).toBe(projectPath);
+            const sessionResult = await sessionStateService.readSessionAgent(serverPid);
+            expect(sessionResult).toEqual({ agentId: result.agentId, projectPath });
+        });
+        it('When cursor-join is called Then the agent is a participant in the project conversation', async () => {
+            const projectPath = '/test-project';
+            const serverPid = 12345;
+            const result = await handleCursorJoin(projectPath, serverPid, { stateService, sessionStateService });
+            const conversation = await stateService.getConversation(result.conversationId);
+            expect(conversation).not.toBeNull();
+            expect(conversation.participants).toContain(result.agentId);
+        });
+    });
+    describe('Given project path with existing conversation and 1 participant', () => {
+        it('When cursor-join is called Then a join notification is written to the existing participant inbox', async () => {
+            const projectPath = '/test-project';
+            const agentA = await stateService.registerAgent(projectPath);
+            const conversation = await stateService.getOrCreateProjectConversation(projectPath);
+            await stateService.joinConversation(agentA.id, conversation.id);
+            const serverPidB = 54321;
+            const result = await handleCursorJoin(projectPath, serverPidB, { stateService, sessionStateService });
+            const inboxPath = path.join(tmpDir, INBOXES_DIR, `${agentA.id}.json`);
+            let notifications = [];
+            try {
+                const raw = await fs.readFile(inboxPath, 'utf-8');
+                notifications = JSON.parse(raw);
+            }
+            catch {
+                notifications = [];
+            }
+            const joinNotification = notifications.find((n) => n.type === NotificationType.Join && n.agentId === result.agentId);
+            expect(joinNotification).toBeDefined();
+        });
+    });
+});
+describe('cursor-leave', () => {
+    describe('Given agent X registered with PID 1234', () => {
+        it('When cursor-leave is called Then X is unregistered and session state is cleared', async () => {
+            const projectPath = '/test-project';
+            const serverPid = 1234;
+            const joinResult = await handleCursorJoin(projectPath, serverPid, { stateService, sessionStateService });
+            await handleCursorLeave(serverPid, { stateService, sessionStateService });
+            const registeredAgent = await stateService.getAgent(joinResult.agentId);
+            expect(registeredAgent).toBeNull();
+            const sessionResult = await sessionStateService.readSessionAgent(serverPid);
+            expect(sessionResult).toBeNull();
+        });
+    });
+    describe('Given no session state for PID 9999', () => {
+        it('When cursor-leave is called Then no error is thrown', async () => {
+            await expect(handleCursorLeave(9999, { stateService, sessionStateService })).resolves.toBeUndefined();
+        });
+    });
+    describe('Given agent X in conversation with agent Y', () => {
+        it('When cursor-leave is called for X Then Y has a leave notification in its inbox', async () => {
+            const projectPath = '/test-project';
+            const serverPidX = 1234;
+            const serverPidY = 5678;
+            const resultY = await handleCursorJoin(projectPath, serverPidY, { stateService, sessionStateService });
+            const resultX = await handleCursorJoin(projectPath, serverPidX, { stateService, sessionStateService });
+            await handleCursorLeave(serverPidX, { stateService, sessionStateService });
+            const inboxPath = path.join(tmpDir, INBOXES_DIR, `${resultY.agentId}.json`);
+            let notifications = [];
+            try {
+                const raw = await fs.readFile(inboxPath, 'utf-8');
+                notifications = JSON.parse(raw);
+            }
+            catch {
+                notifications = [];
+            }
+            const leaveNotification = notifications.find((n) => n.type === NotificationType.Leave && n.agentId === resultX.agentId);
+            expect(leaveNotification).toBeDefined();
+        });
+    });
+    describe('Given agent X in 2 conversations with server PID', () => {
+        it('When cursor-leave is called Then X is removed from both conversations and unregistered', async () => {
+            const projectPath = '/test-project';
+            const serverPid = 1234;
+            const joinResult = await handleCursorJoin(projectPath, serverPid, { stateService, sessionStateService });
+            const secondConversation = await stateService.createConversation({
+                type: ConversationType.Group,
+                name: 'Second conversation',
+                participants: [joinResult.agentId],
+            });
+            await handleCursorLeave(serverPid, { stateService, sessionStateService });
+            const agent = await stateService.getAgent(joinResult.agentId);
+            expect(agent).toBeNull();
+            const conv1 = await stateService.getConversation(joinResult.conversationId);
+            expect(conv1.participants).not.toContain(joinResult.agentId);
+            const conv2 = await stateService.getConversation(secondConversation.id);
+            expect(conv2.participants).not.toContain(joinResult.agentId);
+        });
+    });
+    describe('Given agent X as sole participant in conversation C', () => {
+        it('When cursor-leave is called Then conversation C is archived', async () => {
+            const projectPath = '/test-project';
+            const serverPid = 1234;
+            const joinResult = await handleCursorJoin(projectPath, serverPid, { stateService, sessionStateService });
+            await handleCursorLeave(serverPid, { stateService, sessionStateService });
+            const conversation = await stateService.getConversation(joinResult.conversationId);
+            expect(conversation).not.toBeNull();
+            expect(conversation.archivedAt).toBeDefined();
+            expect(typeof conversation.archivedAt).toBe('number');
+        });
+    });
+});
+//# sourceMappingURL=cli-session-commands.test.js.map

package/dist/__tests__/cli-session-commands.test.js.map

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

package/dist/__tests__/cursor-hook.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cursor-hook.test.d.ts.map

package/dist/__tests__/cursor-hook.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-hook.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cursor-hook.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/cursor-hook.test.js

@@ -0,0 +1,79 @@
+import { describe, it, expect, beforeAll } from 'vitest';
+import { spawnSync, execFileSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const HOOK_PATH = path.resolve(__dirname, '../../dist/hooks/cursor-hook.js');
+const TEST_TIMEOUT = 15000;
+beforeAll(() => {
+    execFileSync('npm', ['run', 'build'], {
+        cwd: path.resolve(__dirname, '../..'),
+        encoding: 'utf-8',
+        timeout: 30000,
+    });
+});
+function runHook(input) {
+    const result = spawnSync('node', [HOOK_PATH], {
+        input,
+        encoding: 'utf-8',
+        timeout: 10000,
+    });
+    if (result.error) {
+        throw result.error;
+    }
+    return JSON.parse(result.stdout.trim());
+}
+describe('cursor-hook', () => {
+    describe('Given stdin JSON with hook_event_name beforeMCPExecution and server group-chat-mcp', () => {
+        it('Then stdout contains permission allow', () => {
+            const response = runHook(JSON.stringify({
+                hook_event_name: 'beforeMCPExecution',
+                server: 'group-chat-mcp',
+            }));
+            expect(response.permission).toBe('allow');
+        }, TEST_TIMEOUT);
+    });
+    describe('Given stdin JSON with hook_event_name beforeMCPExecution and server some-other-mcp', () => {
+        it('Then stdout contains permission ask', () => {
+            const response = runHook(JSON.stringify({
+                hook_event_name: 'beforeMCPExecution',
+                server: 'some-other-mcp',
+            }));
+            expect(response.permission).toBe('ask');
+        }, TEST_TIMEOUT);
+    });
+    describe('Given invalid JSON on stdin', () => {
+        it('When the hook script runs Then it outputs permission allow', () => {
+            const response = runHook('not-valid-json{{{');
+            expect(response.permission).toBe('allow');
+        }, TEST_TIMEOUT);
+    });
+    describe('Given unknown hook_event_name', () => {
+        it('When the hook script runs Then it outputs permission allow', () => {
+            const response = runHook(JSON.stringify({
+                hook_event_name: 'unknownEvent',
+            }));
+            expect(response.permission).toBe('allow');
+        }, TEST_TIMEOUT);
+    });
+    describe('Given stdin JSON with hook_event_name sessionEnd', () => {
+        it('Then stdout contains permission allow', () => {
+            const response = runHook(JSON.stringify({
+                hook_event_name: 'sessionEnd',
+            }));
+            expect(response.permission).toBe('allow');
+        }, TEST_TIMEOUT);
+    });
+    describe('Given stdin JSON with hook_event_name sessionStart and workspace_roots', () => {
+        it('Then it registers an agent and stdout contains permission allow with agent_message', () => {
+            const response = runHook(JSON.stringify({
+                hook_event_name: 'sessionStart',
+                workspace_roots: ['/tmp/test-project-hook'],
+            }));
+            expect(response.permission).toBe('allow');
+            expect(response.agent_message).toBeDefined();
+            expect(response.agent_message.length).toBeGreaterThan(0);
+        }, TEST_TIMEOUT);
+    });
+});
+//# sourceMappingURL=cursor-hook.test.js.map

package/dist/__tests__/cursor-hook.test.js.map

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

package/dist/__tests__/installer-hooks.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=installer-hooks.test.d.ts.map

package/dist/__tests__/installer-hooks.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer-hooks.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/installer-hooks.test.ts"],"names":[],"mappings":""}