@kongyo2/mcp-request-context 1.0.1 → 1.0.3

package/dist/index.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { RequestContextMCPServer } from './server.js';
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {
+        noOpen: false
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i] ?? '';
+        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.noOpen = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    return result;
+}
+function printHelp() {
+    console.log(`
+MCP Request Context - LLM agents request context from humans
+
+Usage:
+  mcp-request-context [options]
+
+Options:
+  --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 with integrated dashboard (browser auto-opens)
+  mcp-request-context
+
+  # Start on custom port without auto-opening browser
+  mcp-request-context --port 5200 --no-open
+
+MCP Configuration:
+  Add to your MCP settings:
+  {
+    "mcpServers": {
+      "request-context": {
+        "command": "npx",
+        "args": ["-y", "@kongyo2/mcp-request-context"]
+      }
+    }
+  }
+`);
+}
+async function main() {
+    const args = parseArgs();
+    // MCP + Dashboard 統合サーバーを起動
+    const server = new RequestContextMCPServer({
+        port: args.port,
+        autoOpen: !args.noOpen // デフォルトでブラウザを開く
+    });
+    const handleShutdown = async () => {
+        console.error('\nShutting down...');
+        await server.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', handleShutdown);
+    process.on('SIGTERM', handleShutdown);
+    try {
+        await server.initialize();
+    }
+    catch (error) {
+        console.error('Failed to start 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":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAOtD,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,MAAM,GAAY;QACtB,MAAM,EAAE,KAAK;KACd,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE1B,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACpC,CAAC,EAAE,CAAC;YACN,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Bb,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IAEzB,4BAA4B;IAC5B,MAAM,MAAM,GAAG,IAAI,uBAAuB,CAAC;QACzC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,CAAE,gBAAgB;KACzC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;QAChC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACpC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAEtC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -1,13 +1,18 @@
 import { ContextStorage } from './core/storage.js';
+export interface MCPServerOptions {
+    port?: number;
+    autoOpen?: boolean;
+}
 export declare class RequestContextMCPServer {
     private server;
     private storage;
-    private projectPath;
+    private dashboard;
     private dashboardUrl?;
-    constructor(projectPath: string);
+    constructor(options?: MCPServerOptions);
     initialize(): Promise<void>;
-    private registerTools;
+    private setupHandlers;
     stop(): Promise<void>;
     getStorage(): ContextStorage;
+    getDashboardUrl(): string | undefined;
 }
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA+BnD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAS;gBAElB,WAAW,EAAE,MAAM;IAsBzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2DjC,OAAO,CAAC,aAAa;IAwDf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,UAAU,IAAI,cAAc;CAG7B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASnD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,YAAY,CAAC,CAAS;gBAElB,OAAO,GAAE,gBAAqB;IA2CpC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CjC,OAAO,CAAC,aAAa;IAqBf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,UAAU,IAAI,cAAc;IAI5B,eAAe,IAAI,MAAM,GAAG,SAAS;CAGtC"}

package/dist/server.js

@@ -0,0 +1,125 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { ContextStorage } from './core/storage.js';
+import { registerTools, handleToolCall } from './tools/index.js';
+import { DashboardServer } from './dashboard/server.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;
+    dashboard;
+    dashboardUrl;
+    constructor(options = {}) {
+        // 共有ストレージを作成
+        this.storage = new ContextStorage();
+        // ダッシュボードを同じストレージで初期化
+        this.dashboard = new DashboardServer({
+            storage: this.storage,
+            port: options.port ?? 5100,
+            autoOpen: options.autoOpen ?? true // デフォルトでブラウザを開く
+        });
+        // 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
+        }
+        // Get all registered tools
+        const tools = registerTools();
+        // Create tools capability object with each tool name
+        const toolsCapability = tools.reduce((acc, tool) => {
+            acc[tool.name] = {};
+            return acc;
+        }, {});
+        this.server = new Server({
+            name: 'mcp-request-context',
+            version
+        }, {
+            capabilities: {
+                tools: toolsCapability
+            }
+        });
+    }
+    async initialize() {
+        // ダッシュボードを先に起動
+        try {
+            this.dashboardUrl = await this.dashboard.start();
+            console.error(`Dashboard started at: ${this.dashboardUrl}`);
+        }
+        catch (error) {
+            console.error('Failed to start dashboard:', error);
+            throw error;
+        }
+        // Create context for tools
+        const context = {
+            projectPath: process.cwd(),
+            storage: this.storage,
+            dashboardUrl: this.dashboardUrl
+        };
+        // Register handlers
+        this.setupHandlers(context);
+        // Connect to stdio transport
+        const transport = new StdioServerTransport();
+        // Handle client disconnection
+        transport.onclose = async () => {
+            await this.stop();
+            process.exit(0);
+        };
+        await this.server.connect(transport);
+        // Monitor stdin for client disconnection
+        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`);
+        console.error(`Dashboard URL: ${this.dashboardUrl}`);
+    }
+    setupHandlers(context) {
+        // Tool list handler
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: registerTools()
+        }));
+        // Tool call handler
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            try {
+                return await handleToolCall(request.params.name, request.params.arguments || {}, context);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new McpError(ErrorCode.InternalError, message);
+            }
+        });
+    }
+    async stop() {
+        try {
+            await this.dashboard.stop();
+            this.storage.stop();
+            await this.server.close();
+        }
+        catch (error) {
+            console.error('Error during shutdown:', error);
+        }
+    }
+    getStorage() {
+        return this.storage;
+    }
+    getDashboardUrl() {
+        return this.dashboardUrl;
+    }
+}
+//# 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.d.ts

@@ -1,22 +1,6 @@
-import { z } from 'zod';
-import { ContextStorage } from '../core/storage.js';
-import { MCPToolResponse } from '../core/types.js';
-export declare const GetContextResponseInputSchema: z.ZodObject<{
-    requestId: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    requestId: string;
-}, {
-    requestId: string;
-}>;
-export type GetContextResponseInput = z.infer<typeof GetContextResponseInputSchema>;
-export declare const GET_CONTEXT_RESPONSE_TOOL_NAME = "get_context_response";
-export declare const GET_CONTEXT_RESPONSE_TOOL_TITLE = "Get Context Response";
-export declare const GET_CONTEXT_RESPONSE_TOOL_DESCRIPTION = "Check the status of a context request and retrieve the human's response.\n\nUse this tool to poll for responses after creating a context request with 'request_context'.\n\n## Status Values\n- pending: Human has not yet responded\n- answered: Human has provided the requested information\n- cancelled: Request was cancelled\n- expired: Request expired without a response\n\nWhen status is 'answered', the response field contains the information provided by the human.";
-export declare const GET_CONTEXT_RESPONSE_ANNOTATIONS: {
-    readOnlyHint: boolean;
-    destructiveHint: boolean;
-    idempotentHint: boolean;
-    openWorldHint: boolean;
-};
-export declare function getContextResponseHandler(args: GetContextResponseInput, storage: ContextStorage, dashboardUrl?: string): Promise<MCPToolResponse>;
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ToolResponse } from '../core/types.js';
+import { ToolContext } from './types.js';
+export declare const getContextResponseTool: Tool;
+export declare function getContextResponseHandler(args: Record<string, unknown>, context: ToolContext): ToolResponse;
 //# sourceMappingURL=get-context-response.d.ts.map

package/dist/tools/get-context-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-context-response.d.ts","sourceRoot":"","sources":["../../src/tools/get-context-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA+B,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGhF,eAAO,MAAM,6BAA6B;;;;;;EAI/B,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE,eAAO,MAAM,+BAA+B,yBAAyB,CAAC;AAEtE,eAAO,MAAM,qCAAqC,udAU4C,CAAC;AAE/F,eAAO,MAAM,gCAAgC;;;;;CAK5C,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,EAC7B,OAAO,EAAE,cAAc,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,CAAC,CAyD1B"}
+{"version":3,"file":"get-context-response.d.ts","sourceRoot":"","sources":["../../src/tools/get-context-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,eAAO,MAAM,sBAAsB,EAAE,IAuBpC,CAAC;AAOF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,GACnB,YAAY,CAgEd"}

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

@@ -0,0 +1,87 @@
+// Tool definition using MCP Tool format with JSON Schema
+export const getContextResponseTool = {
+    name: 'get_context_response',
+    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.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            requestId: {
+                type: 'string',
+                description: 'The ID of the context request to check'
+            }
+        },
+        required: ['requestId']
+    }
+};
+export function getContextResponseHandler(args, context) {
+    const input = args;
+    // Validate required fields
+    if (!input.requestId) {
+        return {
+            success: false,
+            message: 'Missing required field: requestId is required'
+        };
+    }
+    const result = context.storage.getRequest(input.requestId);
+    if (result.isErr()) {
+        return {
+            success: false,
+            message: `Failed to get context request: ${result.error.message}`
+        };
+    }
+    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 (context.dashboardUrl) {
+            nextSteps.push(`Human should respond at: ${context.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');
+    }
+    return {
+        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
+    };
+}
+//# 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.d.ts

@@ -1,8 +1,7 @@
-import { ContextStorage } from '../core/storage.js';
-export { RequestContextInputSchema, RequestContextInput, REQUEST_CONTEXT_TOOL_NAME, REQUEST_CONTEXT_TOOL_TITLE, REQUEST_CONTEXT_TOOL_DESCRIPTION, REQUEST_CONTEXT_ANNOTATIONS, requestContextHandler } from './request-context.js';
-export { GetContextResponseInputSchema, GetContextResponseInput, 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';
-export interface ToolContext {
-    storage: ContextStorage;
-    dashboardUrl?: string;
-}
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { MCPToolResponse } from '../core/types.js';
+import { ToolContext } from './types.js';
+export { ToolContext } from './types.js';
+export declare function registerTools(): Tool[];
+export declare function handleToolCall(name: string, args: Record<string, unknown>, context: ToolContext): MCPToolResponse;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,gCAAgC,EAChC,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAC/B,qCAAqC,EACrC,gCAAgC,EAChC,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAgB,eAAe,EAAiB,MAAM,kBAAkB,CAAC;AAGhF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,wBAAgB,aAAa,IAAI,IAAI,EAAE,CAKtC;AAGD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,GACnB,eAAe,CA6BjB"}

package/dist/tools/index.js

@@ -0,0 +1,39 @@
+import { toMCPResponse } from '../core/types.js';
+import { requestContextTool, requestContextHandler } from './request-context.js';
+import { getContextResponseTool, getContextResponseHandler } from './get-context-response.js';
+// Export all registered tools as Tool[] for ListToolsRequestSchema
+export function registerTools() {
+    return [
+        requestContextTool,
+        getContextResponseTool
+    ];
+}
+// Handle tool calls - central dispatcher
+export function handleToolCall(name, args, context) {
+    let response;
+    let isError = false;
+    try {
+        switch (name) {
+            case 'request_context':
+                response = requestContextHandler(args, context);
+                break;
+            case 'get_context_response':
+                response = getContextResponseHandler(args, context);
+                break;
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        // Check if the response indicates an error
+        isError = !response.success;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        response = {
+            success: false,
+            message: `Tool execution failed: ${errorMessage}`
+        };
+        isError = true;
+    }
+    return toMCPResponse(response, isError);
+}
+//# 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":"AACA,OAAO,EAAiC,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAM9F,mEAAmE;AACnE,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,kBAAkB;QAClB,sBAAsB;KACvB,CAAC;AACJ,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,IAA6B,EAC7B,OAAoB;IAEpB,IAAI,QAAsB,CAAC;IAC3B,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,IAAI,CAAC;QACH,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,iBAAiB;gBACpB,QAAQ,GAAG,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAChD,MAAM;YACR,KAAK,sBAAsB;gBACzB,QAAQ,GAAG,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACpD,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,2CAA2C;QAC3C,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;IAE9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,QAAQ,GAAG;YACT,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,0BAA0B,YAAY,EAAE;SAClD,CAAC;QACF,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,OAAO,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/dist/tools/request-context.d.ts

@@ -1,46 +1,6 @@
-import { z } from 'zod';
-import { ContextStorage } from '../core/storage.js';
-import { MCPToolResponse } from '../core/types.js';
-export declare const RequestContextInputSchema: z.ZodObject<{
-    type: z.ZodEnum<["url_content", "documentation", "dependency_info", "code_snippet", "configuration", "api_response", "error_context", "custom"]>;
-    priority: z.ZodDefault<z.ZodEnum<["critical", "high", "normal", "low"]>>;
-    title: z.ZodString;
-    description: z.ZodString;
-    url: z.ZodOptional<z.ZodString>;
-    hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    expectedFormat: z.ZodOptional<z.ZodString>;
-    expiresInMinutes: z.ZodOptional<z.ZodNumber>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strict", z.ZodTypeAny, {
-    type: "url_content" | "documentation" | "dependency_info" | "code_snippet" | "configuration" | "api_response" | "error_context" | "custom";
-    priority: "critical" | "high" | "normal" | "low";
-    title: string;
-    description: string;
-    url?: string | undefined;
-    hints?: string[] | undefined;
-    expectedFormat?: string | undefined;
-    tags?: string[] | undefined;
-    expiresInMinutes?: number | undefined;
-}, {
-    type: "url_content" | "documentation" | "dependency_info" | "code_snippet" | "configuration" | "api_response" | "error_context" | "custom";
-    title: string;
-    description: string;
-    priority?: "critical" | "high" | "normal" | "low" | undefined;
-    url?: string | undefined;
-    hints?: string[] | undefined;
-    expectedFormat?: string | undefined;
-    tags?: string[] | undefined;
-    expiresInMinutes?: number | undefined;
-}>;
-export type RequestContextInput = z.infer<typeof RequestContextInputSchema>;
-export declare const REQUEST_CONTEXT_TOOL_NAME = "request_context";
-export declare const REQUEST_CONTEXT_TOOL_TITLE = "Request Context from Human";
-export declare const REQUEST_CONTEXT_TOOL_DESCRIPTION = "Request context/information from a human operator.\n\nUse this tool when you need information that:\n- Is behind a URL you cannot access\n- Requires reading documentation that is difficult to parse\n- Involves dependency/API information the human can provide faster\n- Would take multiple turns to gather but the human can provide directly\n\nThe human will see your request in a dashboard UI and can respond with the needed information.\n\n## Context Types\n- url_content: Content from a URL you cannot access\n- documentation: API/library documentation content\n- dependency_info: Package/dependency information\n- code_snippet: Specific code snippets\n- configuration: Configuration file contents\n- api_response: Example API responses\n- error_context: Additional error context\n- custom: Any other type of context\n\n## Priority Levels\n- critical: Blocking - cannot proceed without this\n- high: Important - needed soon\n- normal: Standard priority\n- low: Nice to have\n\nAfter creating a request, poll the status using 'get_context_response' tool.";
-export declare const REQUEST_CONTEXT_ANNOTATIONS: {
-    readOnlyHint: boolean;
-    destructiveHint: boolean;
-    idempotentHint: boolean;
-    openWorldHint: boolean;
-};
-export declare function requestContextHandler(args: RequestContextInput, storage: ContextStorage, dashboardUrl?: string): Promise<MCPToolResponse>;
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ToolResponse } from '../core/types.js';
+import { ToolContext } from './types.js';
+export declare const requestContextTool: Tool;
+export declare function requestContextHandler(args: Record<string, unknown>, context: ToolContext): ToolResponse;
 //# sourceMappingURL=request-context.d.ts.map

package/dist/tools/request-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/tools/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA+B,eAAe,EAA4C,MAAM,kBAAkB,CAAC;AAG1H,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B3B,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAE3D,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAEvE,eAAO,MAAM,gCAAgC,oiCA0BgC,CAAC;AAE9E,eAAO,MAAM,2BAA2B;;;;;CAKvC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,cAAc,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,CAAC,CA8C1B"}
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/tools/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,eAAO,MAAM,kBAAkB,EAAE,IA2EhC,CAAC;AAeF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,GACnB,YAAY,CAqDd"}

package/dist/tools/request-context.js

@@ -0,0 +1,128 @@
+// Tool definition using MCP Tool format with JSON Schema
+export const requestContextTool = {
+    name: 'request_context',
+    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.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            type: {
+                type: 'string',
+                enum: ['url_content', 'documentation', 'dependency_info', 'code_snippet', 'configuration', 'api_response', 'error_context', 'custom'],
+                description: 'The type of context being requested'
+            },
+            priority: {
+                type: 'string',
+                enum: ['critical', 'high', 'normal', 'low'],
+                description: 'Priority level of the request (default: normal)'
+            },
+            title: {
+                type: 'string',
+                description: 'Brief title describing what information is needed (max 200 chars)'
+            },
+            description: {
+                type: 'string',
+                description: 'Detailed description of what information is needed and why (max 2000 chars)'
+            },
+            url: {
+                type: 'string',
+                description: 'URL to fetch content from (for url_content type)'
+            },
+            hints: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Hints to help the human provide the right information'
+            },
+            expectedFormat: {
+                type: 'string',
+                description: 'Description of the expected response format'
+            },
+            expiresInMinutes: {
+                type: 'number',
+                description: 'Request expiration time in minutes'
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Tags to categorize the request'
+            }
+        },
+        required: ['type', 'title', 'description']
+    }
+};
+export function requestContextHandler(args, context) {
+    const input = args;
+    // Validate required fields
+    if (!input.type || !input.title || !input.description) {
+        return {
+            success: false,
+            message: 'Missing required fields: type, title, and description are required'
+        };
+    }
+    const result = context.storage.createRequest({
+        type: input.type,
+        priority: input.priority ?? 'normal',
+        title: input.title,
+        description: input.description,
+        url: input.url,
+        hints: input.hints,
+        expectedFormat: input.expectedFormat,
+        expiresInMinutes: input.expiresInMinutes,
+        tags: input.tags
+    });
+    if (result.isErr()) {
+        return {
+            success: false,
+            message: `Failed to create context request: ${result.error.message}`
+        };
+    }
+    const request = result.value;
+    return {
+        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: context.dashboardUrl
+        },
+        nextSteps: [
+            'BLOCKING - Wait for human response',
+            context.dashboardUrl
+                ? `Human should respond at: ${context.dashboardUrl}`
+                : 'Dashboard is starting...',
+            `Poll status with: get_context_response requestId:"${request.id}"`,
+            'Do NOT proceed until response is received'
+        ]
+    };
+}
+//# 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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"}