@kongyo2/mcp-request-context 1.0.1 → 1.0.2

package/dist/core/storage.js

@@ -0,0 +1,271 @@
+import { EventEmitter } from 'events';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { ok, err } from 'neverthrow';
+import chokidar from 'chokidar';
+import { ContextRequestSchema, CreateContextRequestSchema, generateId } from './types.js';
+// Error types
+export class StorageError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'StorageError';
+    }
+}
+export class ContextStorage extends EventEmitter {
+    storagePath;
+    watcher;
+    pendingEmit = null;
+    DEBOUNCE_MS = 300;
+    constructor(basePath) {
+        super();
+        this.storagePath = join(basePath, '.mcp-request-context', 'requests');
+    }
+    async initialize() {
+        try {
+            await fs.mkdir(this.storagePath, { recursive: true });
+            return ok(undefined);
+        }
+        catch (error) {
+            return err(new StorageError(`Failed to initialize storage: ${error instanceof Error ? error.message : String(error)}`, 'IO_ERROR'));
+        }
+    }
+    async start() {
+        const initResult = await this.initialize();
+        if (initResult.isErr()) {
+            return initResult;
+        }
+        try {
+            this.watcher = chokidar.watch(join(this.storagePath, '*.json'), {
+                ignoreInitial: true,
+                persistent: true,
+                ignorePermissionErrors: true
+            });
+            this.watcher.on('add', () => this.scheduleChangeEmit());
+            this.watcher.on('change', () => this.scheduleChangeEmit());
+            this.watcher.on('unlink', () => this.scheduleChangeEmit());
+            this.watcher.on('error', (error) => {
+                console.error('Storage watcher error:', error);
+            });
+            return ok(undefined);
+        }
+        catch (error) {
+            return err(new StorageError(`Failed to start file watcher: ${error instanceof Error ? error.message : String(error)}`, 'IO_ERROR'));
+        }
+    }
+    async stop() {
+        if (this.pendingEmit) {
+            clearTimeout(this.pendingEmit);
+            this.pendingEmit = null;
+        }
+        if (this.watcher) {
+            this.watcher.removeAllListeners();
+            await this.watcher.close();
+            this.watcher = undefined;
+        }
+        this.removeAllListeners();
+    }
+    scheduleChangeEmit() {
+        if (this.pendingEmit) {
+            clearTimeout(this.pendingEmit);
+        }
+        this.pendingEmit = setTimeout(() => {
+            this.pendingEmit = null;
+            this.emit('change');
+        }, this.DEBOUNCE_MS);
+    }
+    async createRequest(input) {
+        // Validate input
+        const parseResult = CreateContextRequestSchema.safeParse(input);
+        if (!parseResult.success) {
+            return err(new StorageError(`Validation error: ${parseResult.error.message}`, 'VALIDATION_ERROR'));
+        }
+        const now = new Date();
+        const id = generateId('ctx');
+        const request = {
+            id,
+            type: parseResult.data.type,
+            priority: parseResult.data.priority,
+            status: 'pending',
+            title: parseResult.data.title,
+            description: parseResult.data.description,
+            url: parseResult.data.url,
+            hints: parseResult.data.hints,
+            expectedFormat: parseResult.data.expectedFormat,
+            tags: parseResult.data.tags,
+            createdAt: now.toISOString(),
+            expiresAt: parseResult.data.expiresInMinutes
+                ? new Date(now.getTime() + parseResult.data.expiresInMinutes * 60000).toISOString()
+                : undefined
+        };
+        // Validate the complete request
+        const validationResult = ContextRequestSchema.safeParse(request);
+        if (!validationResult.success) {
+            return err(new StorageError(`Request validation error: ${validationResult.error.message}`, 'VALIDATION_ERROR'));
+        }
+        // Save to file
+        const filePath = join(this.storagePath, `${id}.json`);
+        try {
+            await fs.writeFile(filePath, JSON.stringify(request, null, 2), 'utf-8');
+            this.emit('request-created', request);
+            return ok(request);
+        }
+        catch (error) {
+            return err(new StorageError(`Failed to save request: ${error instanceof Error ? error.message : String(error)}`, 'IO_ERROR'));
+        }
+    }
+    async getRequest(id) {
+        const filePath = join(this.storagePath, `${id}.json`);
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const request = JSON.parse(content);
+            const validationResult = ContextRequestSchema.safeParse(request);
+            if (!validationResult.success) {
+                return err(new StorageError(`Invalid request data: ${validationResult.error.message}`, 'VALIDATION_ERROR'));
+            }
+            return ok(validationResult.data);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return err(new StorageError(`Request not found: ${id}`, 'NOT_FOUND'));
+            }
+            return err(new StorageError(`Failed to read request: ${error instanceof Error ? error.message : String(error)}`, 'IO_ERROR'));
+        }
+    }
+    async answerRequest(input) {
+        const requestResult = await this.getRequest(input.requestId);
+        if (requestResult.isErr()) {
+            return requestResult;
+        }
+        const request = requestResult.value;
+        if (request.status !== 'pending') {
+            return err(new StorageError(`Cannot answer request with status: ${request.status}`, 'ALREADY_ANSWERED'));
+        }
+        const updatedRequest = {
+            ...request,
+            status: 'answered',
+            response: input.response,
+            answeredAt: new Date().toISOString()
+        };
+        const filePath = join(this.storagePath, `${input.requestId}.json`);
+        try {
+            await fs.writeFile(filePath, JSON.stringify(updatedRequest, null, 2), 'utf-8');
+            this.emit('request-answered', updatedRequest);
+            return ok(updatedRequest);
+        }
+        catch (error) {
+            return err(new StorageError(`Failed to save response: ${error instanceof Error ? error.message : String(error)}`, 'IO_ERROR'));
+        }
+    }
+    async cancelRequest(id) {
+        const requestResult = await this.getRequest(id);
+        if (requestResult.isErr()) {
+            return requestResult;
+        }
+        const request = requestResult.value;
+        if (request.status !== 'pending') {
+            return err(new StorageError(`Cannot cancel request with status: ${request.status}`, 'INVALID_STATUS'));
+        }
+        const updatedRequest = {
+            ...request,
+            status: 'cancelled'
+        };
+        const filePath = join(this.storagePath, `${id}.json`);
+        try {
+            await fs.writeFile(filePath, JSON.stringify(updatedRequest, null, 2), 'utf-8');
+            this.emit('request-cancelled', updatedRequest);
+            return ok(updatedRequest);
+        }
+        catch (error) {
+            return err(new StorageError(`Failed to cancel request: ${error instanceof Error ? error.message : String(error)}`, 'IO_ERROR'));
+        }
+    }
+    async getAllRequests() {
+        try {
+            const files = await fs.readdir(this.storagePath);
+            const requests = [];
+            for (const file of files) {
+                if (file.endsWith('.json')) {
+                    const id = file.replace('.json', '');
+                    const result = await this.getRequest(id);
+                    if (result.isOk()) {
+                        requests.push(result.value);
+                    }
+                }
+            }
+            // Sort by createdAt descending (newest first)
+            requests.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+            return ok(requests);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return ok([]);
+            }
+            return err(new StorageError(`Failed to list requests: ${error instanceof Error ? error.message : String(error)}`, 'IO_ERROR'));
+        }
+    }
+    async getPendingRequests() {
+        const allResult = await this.getAllRequests();
+        if (allResult.isErr()) {
+            return allResult;
+        }
+        const pending = allResult.value.filter(r => r.status === 'pending');
+        return ok(pending);
+    }
+    async deleteRequest(id) {
+        const filePath = join(this.storagePath, `${id}.json`);
+        try {
+            await fs.unlink(filePath);
+            return ok(undefined);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return err(new StorageError(`Request not found: ${id}`, 'NOT_FOUND'));
+            }
+            return err(new StorageError(`Failed to delete request: ${error instanceof Error ? error.message : String(error)}`, 'IO_ERROR'));
+        }
+    }
+    async cleanupExpired() {
+        const allResult = await this.getAllRequests();
+        if (allResult.isErr()) {
+            return err(allResult.error);
+        }
+        const now = new Date();
+        let cleaned = 0;
+        for (const request of allResult.value) {
+            if (request.status === 'pending' &&
+                request.expiresAt &&
+                new Date(request.expiresAt) < now) {
+                const updateResult = await this.updateStatus(request.id, 'expired');
+                if (updateResult.isOk()) {
+                    cleaned++;
+                }
+            }
+        }
+        return ok(cleaned);
+    }
+    async updateStatus(id, status) {
+        const requestResult = await this.getRequest(id);
+        if (requestResult.isErr()) {
+            return requestResult;
+        }
+        const updatedRequest = {
+            ...requestResult.value,
+            status
+        };
+        const filePath = join(this.storagePath, `${id}.json`);
+        try {
+            await fs.writeFile(filePath, JSON.stringify(updatedRequest, null, 2), 'utf-8');
+            this.emit('request-updated', updatedRequest);
+            return ok(updatedRequest);
+        }
+        catch (error) {
+            return err(new StorageError(`Failed to update request: ${error instanceof Error ? error.message : String(error)}`, 'IO_ERROR'));
+        }
+    }
+    getStoragePath() {
+        return this.storagePath;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/core/storage.js.map

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

package/dist/core/types.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+// Context Request Types
+export const ContextTypeSchema = z.enum([
+    'url_content', // エージェントがアクセスできないURLの内容
+    'documentation', // APIや依存関係のドキュメント
+    'dependency_info', // 依存関係の情報
+    'code_snippet', // 特定のコードスニペット
+    'configuration', // 設定ファイルの内容
+    'api_response', // APIレスポンスの例
+    'error_context', // エラーの追加コンテキスト
+    'custom' // その他のカスタムリクエスト
+]);
+export const ContextPrioritySchema = z.enum([
+    'critical', // ブロッキング - これがないと続行不可
+    'high', // 重要 - 早急に必要
+    'normal', // 通常の優先度
+    'low' // あれば助かる程度
+]);
+export const ContextRequestStatusSchema = z.enum([
+    'pending', // 回答待ち
+    'answered', // 回答済み
+    'cancelled', // キャンセル
+    'expired' // 期限切れ
+]);
+// Context Request Schema
+export const ContextRequestSchema = z.object({
+    id: z.string(),
+    type: ContextTypeSchema,
+    priority: ContextPrioritySchema,
+    status: ContextRequestStatusSchema,
+    // リクエスト内容
+    title: z.string().min(1).max(200),
+    description: z.string().min(1).max(2000),
+    // オプショナルフィールド
+    url: z.string().url().optional(), // URL関連の場合
+    hints: z.array(z.string()).optional(), // 回答のヒント
+    expectedFormat: z.string().optional(), // 期待される回答形式
+    // メタデータ
+    createdAt: z.string().datetime(),
+    answeredAt: z.string().datetime().optional(),
+    expiresAt: z.string().datetime().optional(),
+    // 回答
+    response: z.string().optional(),
+    // タグ
+    tags: z.array(z.string()).optional()
+});
+// Create Request Input Schema
+export const CreateContextRequestSchema = z.object({
+    type: ContextTypeSchema,
+    priority: ContextPrioritySchema.default('normal'),
+    title: z.string().min(1).max(200),
+    description: z.string().min(1).max(2000),
+    url: z.string().url().optional(),
+    hints: z.array(z.string()).optional(),
+    expectedFormat: z.string().optional(),
+    expiresInMinutes: z.number().positive().optional(),
+    tags: z.array(z.string()).optional()
+});
+// Response Input Schema
+export const ContextResponseSchema = z.object({
+    requestId: z.string(),
+    response: z.string().min(1)
+});
+// WebSocket Message Types
+export const WSMessageTypeSchema = z.enum([
+    'initial',
+    'request-created',
+    'request-updated',
+    'request-answered',
+    'request-cancelled',
+    'ping',
+    'pong'
+]);
+// Helper function to convert ToolResponse to MCP format
+export function toMCPResponse(response, isError = false) {
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(response, null, 2)
+            }],
+        isError
+    };
+}
+// Generate unique ID
+export function generateId(prefix = 'ctx') {
+    return `${prefix}_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

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

package/dist/dashboard/server.js

@@ -0,0 +1,269 @@
+import fastify from 'fastify';
+import fastifyStatic from '@fastify/static';
+import fastifyWebsocket from '@fastify/websocket';
+import fastifyCors from '@fastify/cors';
+import { join, dirname } from 'path';
+import { promises as fs } from 'fs';
+import { fileURLToPath } from 'url';
+import open from 'open';
+import { WebSocket } from 'ws';
+import { ContextStorage } from '../core/storage.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export class DashboardServer {
+    app;
+    storage;
+    projectPath;
+    options;
+    clients = new Set();
+    heartbeatInterval;
+    HEARTBEAT_INTERVAL_MS = 30000;
+    constructor(projectPath, options = {}) {
+        this.projectPath = projectPath;
+        this.options = options;
+        this.storage = new ContextStorage(projectPath);
+        this.app = fastify({ logger: false });
+    }
+    async start() {
+        // Initialize storage
+        const initResult = await this.storage.start();
+        if (initResult.isErr()) {
+            throw new Error(`Failed to initialize storage: ${initResult.error.message}`);
+        }
+        // Setup storage event listeners
+        this.setupStorageEvents();
+        // Register plugins
+        await this.app.register(fastifyCors, {
+            origin: true,
+            methods: ['GET', 'POST', 'PUT', 'DELETE']
+        });
+        await this.app.register(fastifyStatic, {
+            root: join(__dirname, 'public'),
+            prefix: '/'
+        });
+        await this.app.register(fastifyWebsocket);
+        // WebSocket endpoint
+        await this.app.register(async (fastify) => {
+            fastify.get('/ws', { websocket: true }, (socket) => {
+                const connection = {
+                    socket: socket,
+                    isAlive: true
+                };
+                this.clients.add(connection);
+                socket.on('pong', () => {
+                    connection.isAlive = true;
+                });
+                // Send initial data
+                this.sendInitialData(socket);
+                const cleanup = () => {
+                    this.clients.delete(connection);
+                };
+                socket.on('close', cleanup);
+                socket.on('error', cleanup);
+            });
+        });
+        // Register API routes
+        this.registerApiRoutes();
+        // Start server
+        const port = this.options.port ?? 5100;
+        await this.app.listen({ port, host: '127.0.0.1' });
+        // Start heartbeat
+        this.startHeartbeat();
+        // Save session info
+        const dashboardUrl = `http://localhost:${port}`;
+        await this.saveSession(dashboardUrl, port);
+        // Open browser if requested
+        if (this.options.autoOpen) {
+            await open(dashboardUrl);
+        }
+        console.log(`Dashboard running at: ${dashboardUrl}`);
+        return dashboardUrl;
+    }
+    setupStorageEvents() {
+        this.storage.on('request-created', (request) => {
+            this.broadcast({
+                type: 'request-created',
+                data: request,
+                timestamp: new Date().toISOString()
+            });
+        });
+        this.storage.on('request-answered', (request) => {
+            this.broadcast({
+                type: 'request-answered',
+                data: request,
+                timestamp: new Date().toISOString()
+            });
+        });
+        this.storage.on('request-cancelled', (request) => {
+            this.broadcast({
+                type: 'request-cancelled',
+                data: request,
+                timestamp: new Date().toISOString()
+            });
+        });
+        this.storage.on('change', async () => {
+            const result = await this.storage.getAllRequests();
+            if (result.isOk()) {
+                this.broadcast({
+                    type: 'request-updated',
+                    data: result.value,
+                    timestamp: new Date().toISOString()
+                });
+            }
+        });
+    }
+    async sendInitialData(socket) {
+        const result = await this.storage.getAllRequests();
+        if (result.isOk()) {
+            const message = {
+                type: 'initial',
+                data: result.value,
+                timestamp: new Date().toISOString()
+            };
+            socket.send(JSON.stringify(message));
+        }
+    }
+    registerApiRoutes() {
+        // Health check
+        this.app.get('/api/health', async () => {
+            return { status: 'ok', timestamp: new Date().toISOString() };
+        });
+        // Get all requests
+        this.app.get('/api/requests', async (_, reply) => {
+            const result = await this.storage.getAllRequests();
+            if (result.isErr()) {
+                return reply.code(500).send({ error: result.error.message });
+            }
+            return result.value;
+        });
+        // Get pending requests
+        this.app.get('/api/requests/pending', async (_, reply) => {
+            const result = await this.storage.getPendingRequests();
+            if (result.isErr()) {
+                return reply.code(500).send({ error: result.error.message });
+            }
+            return result.value;
+        });
+        // Get single request
+        this.app.get('/api/requests/:id', async (request, reply) => {
+            const result = await this.storage.getRequest(request.params.id);
+            if (result.isErr()) {
+                const code = result.error.code === 'NOT_FOUND' ? 404 : 500;
+                return reply.code(code).send({ error: result.error.message });
+            }
+            return result.value;
+        });
+        // Answer a request
+        this.app.post('/api/requests/:id/answer', async (request, reply) => {
+            const { id } = request.params;
+            const { response } = request.body;
+            if (!response || typeof response !== 'string') {
+                return reply.code(400).send({ error: 'Response is required' });
+            }
+            const result = await this.storage.answerRequest({
+                requestId: id,
+                response
+            });
+            if (result.isErr()) {
+                const code = result.error.code === 'NOT_FOUND' ? 404 : 500;
+                return reply.code(code).send({ error: result.error.message });
+            }
+            return { success: true, request: result.value };
+        });
+        // Cancel a request
+        this.app.post('/api/requests/:id/cancel', async (request, reply) => {
+            const result = await this.storage.cancelRequest(request.params.id);
+            if (result.isErr()) {
+                const code = result.error.code === 'NOT_FOUND' ? 404 : 500;
+                return reply.code(code).send({ error: result.error.message });
+            }
+            return { success: true, request: result.value };
+        });
+        // Delete a request
+        this.app.delete('/api/requests/:id', async (request, reply) => {
+            const result = await this.storage.deleteRequest(request.params.id);
+            if (result.isErr()) {
+                const code = result.error.code === 'NOT_FOUND' ? 404 : 500;
+                return reply.code(code).send({ error: result.error.message });
+            }
+            return { success: true };
+        });
+        // Project info
+        this.app.get('/api/project', async () => {
+            return {
+                projectPath: this.projectPath,
+                storagePath: this.storage.getStoragePath()
+            };
+        });
+    }
+    broadcast(message) {
+        const messageStr = JSON.stringify(message);
+        for (const connection of this.clients) {
+            try {
+                if (connection.socket.readyState === WebSocket.OPEN) {
+                    connection.socket.send(messageStr);
+                }
+            }
+            catch (error) {
+                console.error('Error broadcasting:', error);
+                this.clients.delete(connection);
+            }
+        }
+    }
+    startHeartbeat() {
+        this.heartbeatInterval = setInterval(() => {
+            for (const connection of this.clients) {
+                if (!connection.isAlive) {
+                    connection.socket.terminate();
+                    this.clients.delete(connection);
+                    continue;
+                }
+                connection.isAlive = false;
+                connection.socket.ping();
+            }
+        }, this.HEARTBEAT_INTERVAL_MS);
+    }
+    async saveSession(url, port) {
+        const sessionPath = join(this.projectPath, '.mcp-request-context', 'dashboard-session.json');
+        const session = {
+            url,
+            port,
+            pid: process.pid,
+            startedAt: new Date().toISOString()
+        };
+        try {
+            await fs.mkdir(dirname(sessionPath), { recursive: true });
+            await fs.writeFile(sessionPath, JSON.stringify(session, null, 2), 'utf-8');
+        }
+        catch (error) {
+            console.error('Failed to save session:', error);
+        }
+    }
+    async stop() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+        }
+        for (const connection of this.clients) {
+            try {
+                connection.socket.close();
+            }
+            catch {
+                // Ignore
+            }
+        }
+        this.clients.clear();
+        await this.storage.stop();
+        await this.app.close();
+        // Remove session file
+        const sessionPath = join(this.projectPath, '.mcp-request-context', 'dashboard-session.json');
+        try {
+            await fs.unlink(sessionPath);
+        }
+        catch {
+            // Ignore
+        }
+    }
+    getStorage() {
+        return this.storage;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/dashboard/server.js.map

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

package/dist/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { resolve } from 'path';
+import { RequestContextMCPServer } from './server.js';
+import { DashboardServer } from './dashboard/server.js';
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {
+        projectPath: process.cwd(),
+        dashboard: false,
+        open: true
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i] ?? '';
+        if (arg === '--dashboard' || arg === '-d') {
+            result.dashboard = true;
+        }
+        else if (arg === '--port' || arg === '-p') {
+            const nextArg = args[i + 1] ?? '';
+            if (nextArg && !nextArg.startsWith('-')) {
+                result.port = parseInt(nextArg, 10);
+                i++;
+            }
+        }
+        else if (arg === '--no-open') {
+            result.open = false;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+        else if (arg && !arg.startsWith('-')) {
+            result.projectPath = resolve(arg);
+        }
+    }
+    return result;
+}
+function printHelp() {
+    console.log(`
+MCP Request Context - LLM agents request context from humans
+
+Usage:
+  mcp-request-context [project-path] [options]
+
+Options:
+  --dashboard, -d     Start the dashboard server instead of MCP server
+  --port, -p <port>   Dashboard port (default: 5100)
+  --no-open           Don't auto-open browser for dashboard
+  --help, -h          Show this help message
+
+Examples:
+  # Start MCP server for current directory
+  mcp-request-context
+
+  # Start MCP server for specific project
+  mcp-request-context /path/to/project
+
+  # Start dashboard server
+  mcp-request-context --dashboard
+
+  # Start dashboard on custom port without auto-opening browser
+  mcp-request-context --dashboard --port 5200 --no-open
+
+MCP Configuration:
+  Add to your MCP settings:
+  {
+    "mcpServers": {
+      "request-context": {
+        "command": "npx",
+        "args": ["-y", "mcp-request-context", "/path/to/project"]
+      }
+    }
+  }
+`);
+}
+async function main() {
+    const args = parseArgs();
+    if (args.dashboard) {
+        // Start dashboard server
+        const dashboard = new DashboardServer(args.projectPath, {
+            port: args.port ?? 5100,
+            autoOpen: args.open
+        });
+        const handleShutdown = async () => {
+            console.log('\nShutting down dashboard...');
+            await dashboard.stop();
+            process.exit(0);
+        };
+        process.on('SIGINT', handleShutdown);
+        process.on('SIGTERM', handleShutdown);
+        try {
+            const url = await dashboard.start();
+            console.log(`\nDashboard running at: ${url}`);
+            console.log('Press Ctrl+C to stop\n');
+        }
+        catch (error) {
+            console.error('Failed to start dashboard:', error);
+            process.exit(1);
+        }
+    }
+    else {
+        // Start MCP server
+        const server = new RequestContextMCPServer(args.projectPath);
+        try {
+            await server.initialize();
+        }
+        catch (error) {
+            console.error('Failed to start MCP server:', error);
+            process.exit(1);
+        }
+    }
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.js

@@ -0,0 +1,134 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ContextStorage } from './core/storage.js';
+import { toMCPResponse } from './core/types.js';
+import { RequestContextInputSchema, REQUEST_CONTEXT_TOOL_NAME, REQUEST_CONTEXT_TOOL_TITLE, REQUEST_CONTEXT_TOOL_DESCRIPTION, REQUEST_CONTEXT_ANNOTATIONS, requestContextHandler, GetContextResponseInputSchema, GET_CONTEXT_RESPONSE_TOOL_NAME, GET_CONTEXT_RESPONSE_TOOL_TITLE, GET_CONTEXT_RESPONSE_TOOL_DESCRIPTION, GET_CONTEXT_RESPONSE_ANNOTATIONS, getContextResponseHandler } from './tools/index.js';
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export class RequestContextMCPServer {
+    server;
+    storage;
+    projectPath;
+    dashboardUrl;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+        this.storage = new ContextStorage(projectPath);
+        // Get version from package.json
+        let version = '1.0.0';
+        try {
+            const packageJsonPath = join(__dirname, '..', 'package.json');
+            if (existsSync(packageJsonPath)) {
+                const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+                version = packageJson.version ?? version;
+            }
+        }
+        catch {
+            // Use default version
+        }
+        this.server = new McpServer({
+            name: 'mcp-request-context',
+            version
+        });
+    }
+    async initialize() {
+        // Initialize storage
+        const initResult = await this.storage.initialize();
+        if (initResult.isErr()) {
+            throw new Error(`Failed to initialize storage: ${initResult.error.message}`);
+        }
+        // Start storage watcher
+        const startResult = await this.storage.start();
+        if (startResult.isErr()) {
+            throw new Error(`Failed to start storage: ${startResult.error.message}`);
+        }
+        // Try to get dashboard URL from session file
+        try {
+            const sessionPath = join(this.projectPath, '.mcp-request-context', 'dashboard-session.json');
+            if (existsSync(sessionPath)) {
+                const sessionData = JSON.parse(readFileSync(sessionPath, 'utf-8'));
+                this.dashboardUrl = sessionData.url;
+            }
+        }
+        catch {
+            // Dashboard not running
+        }
+        // Register tools
+        this.registerTools();
+        // Connect to stdio transport
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        // Handle transport close
+        transport.onclose = async () => {
+            await this.stop();
+            process.exit(0);
+        };
+        process.stdin.on('end', async () => {
+            await this.stop();
+            process.exit(0);
+        });
+        process.stdin.on('error', async (error) => {
+            console.error('stdin error:', error);
+            await this.stop();
+            process.exit(1);
+        });
+        console.error(`MCP Request Context server initialized for: ${this.projectPath}`);
+        if (this.dashboardUrl) {
+            console.error(`Dashboard available at: ${this.dashboardUrl}`);
+        }
+    }
+    registerTools() {
+        // Register request_context tool
+        this.server.registerTool(REQUEST_CONTEXT_TOOL_NAME, {
+            title: REQUEST_CONTEXT_TOOL_TITLE,
+            description: REQUEST_CONTEXT_TOOL_DESCRIPTION,
+            inputSchema: RequestContextInputSchema,
+            annotations: REQUEST_CONTEXT_ANNOTATIONS
+        }, async (args) => {
+            try {
+                return await requestContextHandler(args, this.storage, this.dashboardUrl);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                const response = {
+                    success: false,
+                    message: `Tool execution failed: ${message}`
+                };
+                return toMCPResponse(response, true);
+            }
+        });
+        // Register get_context_response tool
+        this.server.registerTool(GET_CONTEXT_RESPONSE_TOOL_NAME, {
+            title: GET_CONTEXT_RESPONSE_TOOL_TITLE,
+            description: GET_CONTEXT_RESPONSE_TOOL_DESCRIPTION,
+            inputSchema: GetContextResponseInputSchema,
+            annotations: GET_CONTEXT_RESPONSE_ANNOTATIONS
+        }, async (args) => {
+            try {
+                return await getContextResponseHandler(args, this.storage, this.dashboardUrl);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                const response = {
+                    success: false,
+                    message: `Tool execution failed: ${message}`
+                };
+                return toMCPResponse(response, true);
+            }
+        });
+    }
+    async stop() {
+        try {
+            await this.storage.stop();
+            await this.server.close();
+        }
+        catch (error) {
+            console.error('Error during shutdown:', error);
+        }
+    }
+    getStorage() {
+        return this.storage;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/get-context-response.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { toMCPResponse } from '../core/types.js';
+// Zod schema for input validation
+export const GetContextResponseInputSchema = z.object({
+    requestId: z.string()
+        .min(1, 'Request ID is required')
+        .describe('The ID of the context request to check')
+}).strict();
+export const GET_CONTEXT_RESPONSE_TOOL_NAME = 'get_context_response';
+export const GET_CONTEXT_RESPONSE_TOOL_TITLE = 'Get Context Response';
+export const GET_CONTEXT_RESPONSE_TOOL_DESCRIPTION = `Check the status of a context request and retrieve the human's response.
+
+Use this tool to poll for responses after creating a context request with 'request_context'.
+
+## Status Values
+- pending: Human has not yet responded
+- answered: Human has provided the requested information
+- cancelled: Request was cancelled
+- expired: Request expired without a response
+
+When status is 'answered', the response field contains the information provided by the human.`;
+export const GET_CONTEXT_RESPONSE_ANNOTATIONS = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+};
+export async function getContextResponseHandler(args, storage, dashboardUrl) {
+    const result = await storage.getRequest(args.requestId);
+    if (result.isErr()) {
+        const response = {
+            success: false,
+            message: `Failed to get context request: ${result.error.message}`
+        };
+        return toMCPResponse(response, true);
+    }
+    const request = result.value;
+    const isAnswered = request.status === 'answered';
+    const isPending = request.status === 'pending';
+    const canProceed = isAnswered;
+    const nextSteps = [];
+    if (isPending) {
+        nextSteps.push('BLOCKED - Human has not yet responded');
+        nextSteps.push('Continue polling with get-context-response');
+        if (dashboardUrl) {
+            nextSteps.push(`Human should respond at: ${dashboardUrl}`);
+        }
+    }
+    else if (isAnswered) {
+        nextSteps.push('UNBLOCKED - Response received');
+        nextSteps.push('Use the response data to proceed with your task');
+    }
+    else if (request.status === 'cancelled') {
+        nextSteps.push('Request was cancelled by human');
+        nextSteps.push('Consider creating a new request if still needed');
+    }
+    else if (request.status === 'expired') {
+        nextSteps.push('Request expired without response');
+        nextSteps.push('Create a new request if still needed');
+    }
+    const response = {
+        success: true,
+        message: isAnswered
+            ? 'Context response received from human'
+            : `Request status: ${request.status}`,
+        data: {
+            requestId: request.id,
+            type: request.type,
+            priority: request.priority,
+            title: request.title,
+            status: request.status,
+            createdAt: request.createdAt,
+            answeredAt: request.answeredAt,
+            expiresAt: request.expiresAt,
+            response: request.response,
+            canProceed,
+            mustWait: isPending
+        },
+        nextSteps
+    };
+    return toMCPResponse(response);
+}
+//# sourceMappingURL=get-context-response.js.map

package/dist/tools/get-context-response.js.map

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

package/dist/tools/index.js

@@ -0,0 +1,4 @@
+// Re-export tool definitions
+export { RequestContextInputSchema, REQUEST_CONTEXT_TOOL_NAME, REQUEST_CONTEXT_TOOL_TITLE, REQUEST_CONTEXT_TOOL_DESCRIPTION, REQUEST_CONTEXT_ANNOTATIONS, requestContextHandler } from './request-context.js';
+export { GetContextResponseInputSchema, GET_CONTEXT_RESPONSE_TOOL_NAME, GET_CONTEXT_RESPONSE_TOOL_TITLE, GET_CONTEXT_RESPONSE_TOOL_DESCRIPTION, GET_CONTEXT_RESPONSE_ANNOTATIONS, getContextResponseHandler } from './get-context-response.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,6BAA6B;AAC7B,OAAO,EACL,yBAAyB,EAEzB,yBAAyB,EACzB,0BAA0B,EAC1B,gCAAgC,EAChC,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,6BAA6B,EAE7B,8BAA8B,EAC9B,+BAA+B,EAC/B,qCAAqC,EACrC,gCAAgC,EAChC,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC"}

package/dist/tools/request-context.js

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+import { toMCPResponse, ContextTypeSchema, ContextPrioritySchema } from '../core/types.js';
+// Zod schema for input validation
+export const RequestContextInputSchema = z.object({
+    type: ContextTypeSchema
+        .describe('The type of context being requested'),
+    priority: ContextPrioritySchema
+        .default('normal')
+        .describe('Priority level of the request'),
+    title: z.string()
+        .min(1, 'Title is required')
+        .max(200, 'Title must not exceed 200 characters')
+        .describe('Brief title describing what information is needed'),
+    description: z.string()
+        .min(1, 'Description is required')
+        .max(2000, 'Description must not exceed 2000 characters')
+        .describe('Detailed description of what information is needed and why'),
+    url: z.string()
+        .url('Must be a valid URL')
+        .optional()
+        .describe('URL to fetch content from (for url_content type)'),
+    hints: z.array(z.string())
+        .optional()
+        .describe('Hints to help the human provide the right information'),
+    expectedFormat: z.string()
+        .optional()
+        .describe('Description of the expected response format'),
+    expiresInMinutes: z.number()
+        .positive('Must be a positive number')
+        .optional()
+        .describe('Request expiration time in minutes'),
+    tags: z.array(z.string())
+        .optional()
+        .describe('Tags to categorize the request')
+}).strict();
+export const REQUEST_CONTEXT_TOOL_NAME = 'request_context';
+export const REQUEST_CONTEXT_TOOL_TITLE = 'Request Context from Human';
+export const REQUEST_CONTEXT_TOOL_DESCRIPTION = `Request context/information from a human operator.
+
+Use this tool when you need information that:
+- Is behind a URL you cannot access
+- Requires reading documentation that is difficult to parse
+- Involves dependency/API information the human can provide faster
+- Would take multiple turns to gather but the human can provide directly
+
+The human will see your request in a dashboard UI and can respond with the needed information.
+
+## Context Types
+- url_content: Content from a URL you cannot access
+- documentation: API/library documentation content
+- dependency_info: Package/dependency information
+- code_snippet: Specific code snippets
+- configuration: Configuration file contents
+- api_response: Example API responses
+- error_context: Additional error context
+- custom: Any other type of context
+
+## Priority Levels
+- critical: Blocking - cannot proceed without this
+- high: Important - needed soon
+- normal: Standard priority
+- low: Nice to have
+
+After creating a request, poll the status using 'get_context_response' tool.`;
+export const REQUEST_CONTEXT_ANNOTATIONS = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: false
+};
+export async function requestContextHandler(args, storage, dashboardUrl) {
+    const result = await storage.createRequest({
+        type: args.type,
+        priority: args.priority ?? 'normal',
+        title: args.title,
+        description: args.description,
+        url: args.url,
+        hints: args.hints,
+        expectedFormat: args.expectedFormat,
+        expiresInMinutes: args.expiresInMinutes,
+        tags: args.tags
+    });
+    if (result.isErr()) {
+        const response = {
+            success: false,
+            message: `Failed to create context request: ${result.error.message}`
+        };
+        return toMCPResponse(response, true);
+    }
+    const request = result.value;
+    const response = {
+        success: true,
+        message: `Context request created successfully. Human will respond via dashboard.`,
+        data: {
+            requestId: request.id,
+            type: request.type,
+            priority: request.priority,
+            title: request.title,
+            status: request.status,
+            createdAt: request.createdAt,
+            expiresAt: request.expiresAt,
+            dashboardUrl
+        },
+        nextSteps: [
+            'BLOCKING - Wait for human response',
+            dashboardUrl
+                ? `Human should respond at: ${dashboardUrl}`
+                : 'Start dashboard with: mcp-request-context --dashboard',
+            `Poll status with: get-context-response requestId:"${request.id}"`,
+            'Do NOT proceed until response is received'
+        ]
+    };
+    return toMCPResponse(response);
+}
+//# sourceMappingURL=request-context.js.map

package/dist/tools/request-context.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kongyo2/mcp-request-context",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP server for LLM agents to request context from humans - treating humans as a token-efficient API",
   "repository": {
     "type": "git",