@nqminds/mcp-client 1.0.8 → 1.0.9

package/dist/MCPChat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MCPChat.d.ts","sourceRoot":"","sources":["../src/MCPChat.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAGxE,OAAO,KAAK,EAAyB,YAAY,EAAe,MAAM,SAAS,CAAC;AA+ChF,wBAAgB,OAAO,CAAC,EACtB,aAAa,EACb,WAA6B,EAC7B,YAAiB,EACjB,SAAc,GACf,EAAE,YAAY,qBAgfd"}
+{"version":3,"file":"MCPChat.d.ts","sourceRoot":"","sources":["../src/MCPChat.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAGxE,OAAO,KAAK,EAAyB,YAAY,EAAe,MAAM,SAAS,CAAC;AA+ChF,wBAAgB,OAAO,CAAC,EACtB,aAAa,EACb,WAA6B,EAC7B,YAAiB,EACjB,SAAc,GACf,EAAE,YAAY,qBAifd"}

package/dist/MCPChat.js

@@ -76,7 +76,7 @@ export function MCPChat({ companyNumber, apiEndpoint = "/api/mcp/chat", customSt
             setMessages((prev) => prev.filter((m) => !m.isStreaming));
         }
     };
-    const sendMessage = useCallback(async (text, hidden = false) => {
+    const sendMessage = useCallback(async (text, hidden = false, bypass = false) => {
         if (!text.trim() || isLoading)
             return;
         setIsLoading(true);
@@ -108,6 +108,7 @@ export function MCPChat({ companyNumber, apiEndpoint = "/api/mcp/chat", customSt
                 body: JSON.stringify({
                     message: userMessage.content,
                     context: companyNumber ? { company_number: companyNumber } : undefined,
+                    bypassSystemPrompt: bypass || undefined,
                 }),
                 signal: abortController.signal,
             });
@@ -231,8 +232,8 @@ export function MCPChat({ companyNumber, apiEndpoint = "/api/mcp/chat", customSt
         if (!directPromptText.trim())
             return;
         setDirectPromptOpen(false);
-        // Send as a visible message so you can see exactly what went to the agent
-        await sendMessage(directPromptText, false);
+        // bypass=true: skips system prompt, sends raw to the model
+        await sendMessage(directPromptText, false, true);
         setDirectPromptText("");
     };
     const toggleTheme = () => {

package/dist/api-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-helpers.d.ts","sourceRoot":"","sources":["../src/api-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,IACnD,SAAS,OAAO,uBAgG/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,KACrB,SAAS,OAAO,uBAU/B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,kBAKtC"}
+{"version":3,"file":"api-helpers.d.ts","sourceRoot":"","sources":["../src/api-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,IACnD,SAAS,OAAO,uBAiG/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,KACrB,SAAS,OAAO,uBAU/B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,kBAKtC"}

package/dist/api-helpers.js

@@ -9,7 +9,7 @@ const clients = new Map();
  */
 export function createMCPChatHandler(config) {
     return async (request) => {
-        const { message, context, sessionId = "default" } = await request.json();
+        const { message, context, sessionId = "default", bypassSystemPrompt = false } = await request.json();
         // Get or create client for this session
         let client = clients.get(sessionId);
         if (!client) {
@@ -41,12 +41,12 @@ export function createMCPChatHandler(config) {
                     }
                 };
                 try {
-                    sendEvent("thinking", { message: "🤔 Analyzing your question..." });
+                    sendEvent("thinking", { message: bypassSystemPrompt ? "🔧 Sending direct prompt (no system context)…" : "🤔 Analyzing your question..." });
                     // Process the query with thinking callback and abort signal
                     const response = await client.processQuery(context ? `${message}\nContext: ${JSON.stringify(context)}` : message, (thinkingMessage) => {
                         sendEvent("thinking", { message: thinkingMessage });
-                    }, abortController.signal // Pass abort signal to enable cancellation
-                    );
+                    }, abortController.signal, // Pass abort signal to enable cancellation
+                    bypassSystemPrompt);
                     // Check if aborted before streaming response
                     if (abortController.signal.aborted) {
                         return;

package/dist/openai-client.d.ts

@@ -18,8 +18,19 @@ export declare class MCPClientOpenAI {
     private config;
     constructor(config: MCPClientConfig);
     private compactConversation;
+    /**
+     * Fetches the system prompt from the MCP server's registered "system-prompt" prompt
+     * and prepends it to conversationHistory. Cached — only runs once per session.
+     * Direct Prompt (bypass mode) skips this entirely.
+     */
+    private ensureSystemPrompt;
     connect(): Promise<void>;
-    processQuery(query: string, onThinking?: (message: string) => void, abortSignal?: AbortSignal): Promise<string>;
+    processQuery(query: string, onThinking?: (message: string) => void, abortSignal?: AbortSignal, bypassSystemPrompt?: boolean): Promise<string>;
+    /**
+     * Sends a raw query directly to the model — no system prompt, no conversation history.
+     * Used by the Direct Prompt dev tool to test prompts verbatim.
+     */
+    private processRawQuery;
     clearHistory(): void;
     cleanup(): Promise<void>;
 }

package/dist/openai-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-client.d.ts","sourceRoot":"","sources":["../src/openai-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,EAAE,eAAe;YA4ErB,mBAAmB;IAoB3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IA+MrH,YAAY,IAAI,IAAI;IAMd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}
+{"version":3,"file":"openai-client.d.ts","sourceRoot":"","sources":["../src/openai-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,EAAE,eAAe;YAsCrB,mBAAmB;IAoBjC;;;;OAIG;YACW,kBAAkB;IA4B1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,kBAAkB,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAuNjJ;;;OAGG;YACW,eAAe;IA4E7B,YAAY,IAAI,IAAI;IAOd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/openai-client.js

@@ -34,46 +34,8 @@ export class MCPClientOpenAI {
             capabilities: {},
         });
         // Initialize conversation with system message
-        this.conversationHistory = [
-            {
-                type: "message",
-                role: "system",
-                content: [
-                    {
-                        type: "input_text",
-                        text: `You are a helpful assistant with access to Companies House data through specialized tools.
-
-CRITICAL CONTEXT AWARENESS RULES:
-1. Carefully track ALL entities you mention in your responses (company numbers, names, people, dates, etc.)
-2. When the user refers to "that company," "the person," "those results," or uses similar references, ALWAYS look back at what you just discussed in the immediately preceding messages
-3. If you mentioned specific company numbers, names, or other identifiers, remember them for follow-up questions
-4. Before saying "I don't have a record of X," review your recent responses to check if you did mention it
-5. Maintain awareness of the conversation flow - if you just provided information about something, the user's next question likely refers to it
-
-RESPONSE FORMATTING RULES:
-- NEVER show raw JSON data to users unless they explicitly ask for "JSON", "raw data", or similar
-- Use rich Markdown formatting — the UI renders it fully (bold, italic, headings, tables, code blocks)
-- Use **bold** for key facts, names, amounts, and important values
-- Use ## and ### headings to organise longer responses into clear sections
-- Use tables whenever comparing multiple entities or showing structured data (e.g. list of officers, financial figures across years, search results) — prefer tables over bullet lists for multi-field data
-- Use bullet lists only for genuinely unordered or enumerable items (e.g. a list of risks, a list of SIC codes) — do NOT default to bullets for everything
-- Convert dates to readable format (e.g., "15 March 2023" instead of "2023-03-15")
-- Format addresses as natural inline text, not as structured fields
-- When showing company officers or PSCs, use a table with columns like Name, Role, Nationality, DOB rather than a bullet per person
-- When showing financial figures, use a table with Year / Metric / Value columns
-- Only include the most relevant information — don't dump all available fields
-- Avoid walls of bullet points; use prose sentences for narrative context and reserve lists/tables for structured data
-
-When responding:
-- Be concise and direct
-- Use tools to fetch accurate, up-to-date Companies House data
-- Track key identifiers (company numbers, PSC names, etc.) across the conversation
-- If unclear what the user is referring to, check your previous response first before asking for clarification
-- Never expose internal implementation details like "MCP Server" or tool names to users`,
-                    },
-                ],
-            },
-        ];
+        // System prompt is fetched from the MCP server on first use (see ensureSystemPrompt)
+        this.conversationHistory = [];
     }
     async compactConversation() {
         try {
@@ -94,14 +56,56 @@ When responding:
             }
         }
     }
+    /**
+     * Fetches the system prompt from the MCP server's registered "system-prompt" prompt
+     * and prepends it to conversationHistory. Cached — only runs once per session.
+     * Direct Prompt (bypass mode) skips this entirely.
+     */
+    async ensureSystemPrompt() {
+        // Already loaded if history starts with a system message
+        if (this.conversationHistory[0]?.role === "system")
+            return;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const result = await this.client.getPrompt({ name: "system-prompt" });
+            const parts = [];
+            for (const msg of result.messages) {
+                const c = msg.content;
+                if (typeof c === "string")
+                    parts.push(c);
+                else if (c?.text)
+                    parts.push(c.text);
+            }
+            const text = parts.join("\n\n");
+            if (text) {
+                this.conversationHistory = [
+                    {
+                        type: "message",
+                        role: "system",
+                        content: [{ type: "input_text", text }],
+                    },
+                    ...this.conversationHistory,
+                ];
+            }
+        }
+        catch (error) {
+            console.error("[MCPClient] Failed to fetch system prompt from MCP server:", error);
+        }
+    }
     async connect() {
         await this.client.connect(this.transport);
     }
-    async processQuery(query, onThinking, abortSignal) {
+    async processQuery(query, onThinking, abortSignal, bypassSystemPrompt = false) {
         // Check for cancellation at start
         if (abortSignal?.aborted) {
             throw new Error("Request was cancelled");
         }
+        // Bypass mode: send the raw prompt directly without system message or conversation history
+        if (bypassSystemPrompt) {
+            return this.processRawQuery(query, onThinking, abortSignal);
+        }
+        // Load system prompt from MCP server (no-op after first call)
+        await this.ensureSystemPrompt();
         // Check if we should compact
         const shouldCompact = this.conversationHistory.length >= 40 &&
             (Date.now() - this.lastCompaction > 10 * 60 * 1000);
@@ -282,9 +286,89 @@ When responding:
         }
         return finalResponse;
     }
+    /**
+     * Sends a raw query directly to the model — no system prompt, no conversation history.
+     * Used by the Direct Prompt dev tool to test prompts verbatim.
+     */
+    async processRawQuery(query, onThinking, abortSignal) {
+        const toolsResponse = await this.client.listTools();
+        const tools = toolsResponse.tools.map((tool) => ({
+            type: "function",
+            name: tool.name,
+            description: tool.description || "",
+            parameters: tool.inputSchema,
+            strict: false,
+        }));
+        // Isolated history — just this message, no system prompt
+        const isolatedHistory = [
+            {
+                type: "message",
+                role: "user",
+                content: [{ type: "input_text", text: query }],
+            },
+        ];
+        let loopCount = 0;
+        const maxLoops = 15;
+        let finalResponse = "";
+        while (loopCount < maxLoops) {
+            loopCount++;
+            if (abortSignal?.aborted)
+                throw new Error("Request was cancelled");
+            const response = await this.openai.responses.create({
+                model: this.config.openaiModel,
+                input: isolatedHistory,
+                tools,
+            });
+            const output = response.output;
+            const functionCalls = output.filter((item) => item.type === "function_call");
+            if (functionCalls.length > 0) {
+                isolatedHistory.push(...output);
+                for (const functionCall of functionCalls) {
+                    if (abortSignal?.aborted)
+                        throw new Error("Request was cancelled");
+                    const functionName = functionCall.name;
+                    const functionArgs = typeof functionCall.arguments === "string"
+                        ? JSON.parse(functionCall.arguments)
+                        : functionCall.arguments;
+                    let toolDesc = functionName;
+                    if (functionName === "fetch_webpage" && functionArgs.url) {
+                        try {
+                            toolDesc = `fetch_webpage → ${new URL(functionArgs.url).hostname}`;
+                        }
+                        catch {
+                            toolDesc = `fetch_webpage → ${functionArgs.url}`;
+                        }
+                    }
+                    else if (functionName === "web_search" && functionArgs.query) {
+                        toolDesc = `web_search → "${functionArgs.query}"`;
+                    }
+                    onThinking?.(`🔧 ${toolDesc}`);
+                    try {
+                        const result = await this.client.callTool({ name: functionName, arguments: functionArgs });
+                        isolatedHistory.push({ type: "function_call_output", call_id: functionCall.call_id, output: JSON.stringify(result.content) });
+                    }
+                    catch (error) {
+                        isolatedHistory.push({ type: "function_call_output", call_id: functionCall.call_id, output: `Error: ${error instanceof Error ? error.message : String(error)}` });
+                    }
+                }
+                continue;
+            }
+            for (const item of output) {
+                if (item.type === "message" && item.role === "assistant") {
+                    for (const contentItem of item.content) {
+                        if (contentItem.type === "output_text")
+                            finalResponse += contentItem.text;
+                    }
+                }
+            }
+            break;
+        }
+        return finalResponse;
+    }
     clearHistory() {
-        // Keep the system message (first item) when clearing history
-        const systemMessage = this.conversationHistory[0];
+        // Keep system message only if it genuinely is a system role message
+        const first = this.conversationHistory[0];
+        const systemMessage = first?.role === "system" ? this.conversationHistory[0] : undefined;
         this.conversationHistory = systemMessage ? [systemMessage] : [];
     }
     async cleanup() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nqminds/mcp-client",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Reusable MCP client component with AI chat interface",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",