@nqminds/mcp-client 1.0.14 → 1.0.21

package/dist/MCPChat.js

@@ -191,7 +191,7 @@ export function MCPChat({ companyNumber, apiEndpoint = "/api/mcp/chat", customSt
         }
         catch (error) {
             if (error instanceof Error && error.name === "AbortError") {
-                console.log("Request was cancelled");
+                // Request cancelled by user — no-op
                 return;
             }
             console.error("Error:", error);
@@ -268,7 +268,7 @@ export function MCPChat({ companyNumber, apiEndpoint = "/api/mcp/chat", customSt
     const visibleMessages = messages.filter((m) => !m.hidden);
     const showHome = visibleMessages.length === 0 && !isLoading;
     return (React.createElement("div", { className: `mcp-root ${className}`, style: customStyles, "data-theme": theme },
-        !isOpen && (React.createElement("button", { className: "mcp-float-icon", onClick: () => setIsOpen(true), "aria-label": "Open AI assistant", title: "Open AI assistant" }, "\uD83E\uDD16")),
+        !isOpen && (React.createElement("button", { className: "mcp-float-icon", onClick: () => setIsOpen(true), "aria-label": "Corporata AI assistant", title: "Corporata AI assistant" }, "\uD83E\uDD16")),
         isOpen && (React.createElement("div", { className: "mcp-overlay" },
             React.createElement("div", { className: "mcp-panel" },
                 React.createElement("div", { className: "mcp-chat-header" },

package/dist/api-helpers.d.ts

@@ -5,6 +5,8 @@ export interface CreateMCPHandlerConfig {
     openaiApiKey: string;
     mcpServerCommand: string;
     openaiModel?: string;
+    /** Override log directory. Falls back to MCP_LOG_DIR env var. */
+    logDir?: string;
 }
 /**
  * Creates a streaming MCP chat handler for Next.js API routes

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,uBAmH/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;IACrB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,IACnD,SAAS,OAAO,uBAoH/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,KACrB,SAAS,OAAO,uBAU/B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,kBAKtC"}

package/dist/api-helpers.js

@@ -17,6 +17,7 @@ export function createMCPChatHandler(config) {
                 openaiApiKey: config.openaiApiKey,
                 mcpServerCommand: config.mcpServerCommand,
                 openaiModel: config.openaiModel,
+                logDir: config.logDir || process.env.MCP_LOG_DIR,
             });
             await client.connect();
             clients.set(sessionId, client);
@@ -96,7 +97,7 @@ export function createMCPChatHandler(config) {
             },
             cancel() {
                 // This is called when client disconnects/cancels
-                console.log("Client disconnected, aborting server processing");
+                console.error("Client disconnected, aborting server processing");
                 abortController.abort();
             }
         });

package/dist/openai-client.d.ts

@@ -38,6 +38,11 @@ export interface MCPClientConfig {
      * Guardrail for unusually large tool outputs stored in history.
      */
     maxToolOutputChars?: number;
+    /**
+     * Directory to write structured JSONL log files.
+     * Falls back to the MCP_LOG_DIR env var, then to ./logs relative to CWD.
+     */
+    logDir?: string;
 }
 interface UsageStats {
     inputTokens: number;
@@ -81,6 +86,7 @@ export declare class MCPClientOpenAI {
      */
     private turnStats;
     private config;
+    private logger;
     constructor(config: MCPClientConfig);
     connect(): Promise<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;;;;;;;;;;;;;;;;;GAiBG;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;IAEvB;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAiBD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAuB;IAExC;;;OAGG;IACH,OAAO,CAAC,YAAY,CAAuB;IAE3C;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAA2B;IAEtD;;;OAGG;IACH,OAAO,CAAC,UAAU,CAGhB;IAEF;;OAEG;IACH,OAAO,CAAC,eAAe,CAAK;IAE5B;;OAEG;IACH,OAAO,CAAC,SAAS,CAOf;IAEF;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAKf;IAEF,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,EAAE,eAAe;IAoC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,YAAY,IAAI,IAAI;IAkBpB,QAAQ,IAAI,UAAU;IAItB;;;OAGG;YACW,kBAAkB;IA0BhC;;;OAGG;IACH,OAAO,CAAC,UAAU;IAalB;;;OAGG;YACW,gBAAgB;IAuB9B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IAmCpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8EzB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,kBAAkB;IAQ1B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA2CzB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAsC9B;;OAEG;YACW,kBAAkB;IA4ChC;;;OAGG;YACW,mBAAmB;IAoBjC;;;OAGG;IACH,OAAO,CAAC,8BAA8B;IAatC;;OAEG;YACW,UAAU;IAiBxB;;OAEG;YACW,cAAc;IAoB5B;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACtC,WAAW,CAAC,EAAE,WAAW,EACzB,kBAAkB,UAAQ,GACzB,OAAO,CAAC,MAAM,CAAC;IA8OlB;;OAEG;YACW,eAAe;CAyG9B"}
+{"version":3,"file":"openai-client.d.ts","sourceRoot":"","sources":["../src/openai-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAsEH,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;IAEvB;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAiBD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAuB;IAExC;;;OAGG;IACH,OAAO,CAAC,YAAY,CAAuB;IAE3C;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAA2B;IAEtD;;;OAGG;IACH,OAAO,CAAC,UAAU,CAGhB;IAEF;;OAEG;IACH,OAAO,CAAC,eAAe,CAAK;IAE5B;;OAEG;IACH,OAAO,CAAC,SAAS,CAOf;IAEF;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAKf;IAEF,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,EAAE,eAAe;IAuC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,YAAY,IAAI,IAAI;IAmBpB,QAAQ,IAAI,UAAU;IAItB;;;OAGG;YACW,kBAAkB;IA0BhC;;;OAGG;IACH,OAAO,CAAC,UAAU;IAalB;;;OAGG;YACW,gBAAgB;IAuB9B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IAmCpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8EzB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,kBAAkB;IAQ1B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA2CzB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAsC9B;;OAEG;YACW,kBAAkB;IA4DhC;;;OAGG;YACW,mBAAmB;IAoBjC;;;OAGG;IACH,OAAO,CAAC,8BAA8B;IAatC;;OAEG;YACW,UAAU;IAiBxB;;OAEG;YACW,cAAc;IAqC5B;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACtC,WAAW,CAAC,EAAE,WAAW,EACzB,kBAAkB,UAAQ,GACzB,OAAO,CAAC,MAAM,CAAC;IAyRlB;;OAEG;YACW,eAAe;CA8H9B"}

package/dist/openai-client.js

@@ -19,6 +19,69 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 import OpenAI from "openai";
+import fs from "fs";
+import path from "path";
+// ── Privacy-safe input shape descriptor (logs types/lengths, never payload values) ── //
+function describeShape(value, depth = 0) {
+    if (depth > 2)
+        return "…";
+    if (value === null || value === undefined)
+        return String(value);
+    if (typeof value === "string")
+        return `string(len=${value.length})`;
+    if (typeof value === "number" || typeof value === "boolean")
+        return typeof value;
+    if (Array.isArray(value))
+        return `array(len=${value.length})`;
+    if (typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = describeShape(v, depth + 1);
+        }
+        return out;
+    }
+    return typeof value;
+}
+// ── JSONL file logger — non-blocking fire-and-forget writes ── //
+// INFO/WARN/ERROR go to mcp-client-YYYY-MM-DD.log (clean operational log)
+// DEBUG goes to mcp-client-debug-YYYY-MM-DD.log (full payloads for reproduction)
+// Log filenames are computed at write-time so files rotate at midnight.
+class McpLogger {
+    constructor(logDir) {
+        let ready = false;
+        try {
+            fs.mkdirSync(logDir, { recursive: true });
+            ready = true;
+        }
+        catch (e) {
+            console.error("[McpLogger] Failed to open log dir:", logDir, e);
+        }
+        this.logDir = logDir;
+        this.ready = ready;
+    }
+    today() {
+        return new Date().toISOString().slice(0, 10); // YYYY-MM-DD recomputed each call
+    }
+    info(event, data = {}) {
+        this.write("INFO", event, data, path.join(this.logDir, `mcp-client-${this.today()}.log`));
+    }
+    warn(event, data = {}) {
+        this.write("WARN", event, data, path.join(this.logDir, `mcp-client-${this.today()}.log`));
+    }
+    error(event, data = {}) {
+        this.write("ERROR", event, data, path.join(this.logDir, `mcp-client-${this.today()}.log`));
+    }
+    /** Full-payload debug — written to the separate debug file only. */
+    debug(event, data = {}) {
+        this.write("DEBUG", event, data, path.join(this.logDir, `mcp-client-debug-${this.today()}.log`));
+    }
+    write(level, event, data, file) {
+        if (!this.ready)
+            return;
+        const line = JSON.stringify({ ts: new Date().toISOString(), level, event, ...data }) + "\n";
+        fs.appendFile(file, line, () => { }); // fire-and-forget
+    }
+}
 export class MCPClientOpenAI {
     constructor(config) {
         /**
@@ -74,7 +137,9 @@ export class MCPClientOpenAI {
             compactTriggerInputTokens: config.compactTriggerInputTokens ?? 200000,
             hotContextTargetInputTokens: config.hotContextTargetInputTokens ?? 100000,
             maxToolOutputChars: config.maxToolOutputChars ?? 20000,
+            logDir: config.logDir ?? process.env.MCP_LOG_DIR ?? path.resolve(process.cwd(), "logs"),
         };
+        this.logger = new McpLogger(this.config.logDir);
         this.openai = new OpenAI({
             apiKey: this.config.openaiApiKey,
         });
@@ -94,11 +159,14 @@ export class MCPClientOpenAI {
     }
     async connect() {
         await this.client.connect(this.transport);
+        this.logger.info("CLIENT_CONNECTED", { model: this.config.openaiModel });
     }
     async cleanup() {
+        this.logger.info("CLIENT_DISCONNECTED", {});
         await this.client.close();
     }
     clearHistory() {
+        this.logger.info("HISTORY_CLEARED", {});
         this.conversationHistory = [];
         this.compaction = {
             item: null,
@@ -420,6 +488,12 @@ export class MCPClientOpenAI {
             if (this.compaction.item)
                 compactInput.push(this.compaction.item);
             compactInput.push(...coldItems);
+            this.logger.debug("COMPACTION_REQUEST", {
+                model: this.config.openaiModel,
+                coldItemCount: coldItems.length,
+                hasPriorCompactionItem: !!this.compaction.item,
+                compactInput,
+            });
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const response = await this.openai.responses.compact({
                 model: this.config.openaiModel,
@@ -435,6 +509,11 @@ export class MCPClientOpenAI {
             if (newItem) {
                 this.compaction.item = newItem;
                 this.compaction.compactedTurns += this.getTurnBoundaries(coldItems).length;
+                this.logger.debug("COMPACTION_RESPONSE", {
+                    newCompactionItem: newItem,
+                    totalCompactedTurns: this.compaction.compactedTurns,
+                    rawResponse: response,
+                });
             }
             else {
                 throw new Error("Compaction response did not include a reusable compaction item");
@@ -444,6 +523,10 @@ export class MCPClientOpenAI {
         catch (error) {
             // Fallback: if compaction fails, just drop the cold part rather than
             // keeping everything and risking repeated context overflows.
+            this.logger.error("COMPACTION_FAILED", {
+                errorMessage: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
             console.error("[MCPClient] Compaction failed, dropping cold history:", error);
         }
     }
@@ -499,6 +582,15 @@ export class MCPClientOpenAI {
      * Create a response against the current full context.
      */
     async createResponse(params) {
+        this.logger.debug("LLM_REQUEST", {
+            model: this.config.openaiModel,
+            instructionsLength: this.instructions?.length ?? 0,
+            instructions: this.instructions,
+            inputItems: params.input.length,
+            input: params.input,
+            toolNames: params.tools.map((t) => t.name ?? t.type),
+            previousResponseId: params.previousResponseId ?? null,
+        });
         const response = await this.openai.responses.create({
             model: this.config.openaiModel,
             instructions: this.instructions ?? undefined,
@@ -509,6 +601,12 @@ export class MCPClientOpenAI {
             truncation: "disabled",
             prompt_cache_retention: "24h",
         });
+        this.logger.debug("LLM_RESPONSE", {
+            responseId: response.id,
+            outputItems: (response.output ?? []).length,
+            output: response.output,
+            usage: response.usage,
+        });
         this.captureUsage(response);
         return response;
     }
@@ -523,6 +621,7 @@ export class MCPClientOpenAI {
             return this.processRawQuery(query, onThinking, abortSignal);
         }
         this.startTurn();
+        this.logger.info("QUERY_START", { queryShape: describeShape(query), bypassSystemPrompt });
         await this.ensureSystemPrompt();
         // Proactive compaction based on last real measured request.
         await this.maybeCompactHistory();
@@ -568,6 +667,13 @@ export class MCPClientOpenAI {
             }
             catch (error) {
                 const err = error;
+                this.logger.warn("API_ERROR", {
+                    status: err.status,
+                    code: err.code,
+                    message: err.message,
+                    stack: error instanceof Error ? error.stack : undefined,
+                    state: "ERROR_STATE",
+                });
                 const message = err.message?.toLowerCase() || "";
                 const contextProblem = err.status === 400 &&
                     (err.code === "context_length_exceeded" ||
@@ -612,6 +718,13 @@ export class MCPClientOpenAI {
                     }
                 }
                 else {
+                    this.logger.error("API_ERROR_UNHANDLED", {
+                        status: err.status,
+                        code: err.code,
+                        message: err.message,
+                        stack: error instanceof Error ? error.stack : undefined,
+                        state: "FATAL",
+                    });
                     throw error;
                 }
             }
@@ -648,17 +761,39 @@ export class MCPClientOpenAI {
                         toolDesc = `web_search → "${functionArgs.query}"`;
                     }
                     onThinking?.(`🔧 ${toolDesc}`);
+                    this.logger.info("TOOL_CALL_SENDING", {
+                        tool: functionName,
+                        inputShape: describeShape(functionArgs),
+                        state: "SENDING",
+                    });
+                    this.logger.debug("TOOL_CALL_FULL_ARGS", {
+                        tool: functionName,
+                        arguments: functionArgs,
+                    });
                     try {
                         const result = await this.client.callTool({
                             name: functionName,
                             arguments: functionArgs,
                         });
                         const compactOutput = this.compactToolResult(result.content);
+                        this.logger.info("TOOL_CALL_SUCCESS", { tool: functionName, state: "RECEIVED" });
+                        this.logger.debug("TOOL_CALL_FULL_RESULT", {
+                            tool: functionName,
+                            result: result.content,
+                        });
                         const toolOutputItem = this.makeFunctionOutput(functionCall.call_id, compactOutput);
                         toolOutputsForNextStep.push(toolOutputItem);
                         this.conversationHistory.push(toolOutputItem);
                     }
                     catch (error) {
+                        this.logger.error("TOOL_CALL_ERROR", {
+                            tool: functionName,
+                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                            errorCode: error?.code ?? error?.name ?? "UNKNOWN",
+                            errorMessage: error instanceof Error ? error.message : String(error),
+                            stack: error instanceof Error ? error.stack : undefined,
+                            state: "ERROR_STATE",
+                        });
                         const toolOutputItem = this.makeFunctionOutput(functionCall.call_id, `Error: ${error instanceof Error ? error.message : String(error)}`);
                         toolOutputsForNextStep.push(toolOutputItem);
                         this.conversationHistory.push(toolOutputItem);
@@ -677,7 +812,12 @@ export class MCPClientOpenAI {
                     }
                 }
             }
+            this.logger.info("QUERY_COMPLETE", { loops: loopCount, responseLength: finalResponse.length });
             this.conversationHistory.push(...output);
+            this.logger.debug("CONVERSATION_HISTORY_SNAPSHOT", {
+                itemCount: this.conversationHistory.length,
+                history: this.conversationHistory,
+            });
             break;
         }
         if (loopCount >= maxLoops && !finalResponse) {
@@ -730,14 +870,13 @@ export class MCPClientOpenAI {
             loopCount++;
             if (abortSignal?.aborted)
                 throw new Error("Request was cancelled");
+            const rawInput = (!previousResponseId ? isolatedHistory : (pendingRawToolOutputs ?? []));
+            this.logger.info("QUERY_START", { queryShape: describeShape(rawInput), bypassSystemPrompt: true });
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const response = await this.openai.responses.create({
-                model: this.config.openaiModel,
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                input: (!previousResponseId ? isolatedHistory : (pendingRawToolOutputs ?? [])),
-                previous_response_id: previousResponseId,
+            const response = await this.createResponse({
+                input: rawInput,
                 tools,
-                truncation: "disabled",
+                previousResponseId,
             });
             pendingRawToolOutputs = null;
             this.captureUsage(response);
@@ -771,14 +910,36 @@ export class MCPClientOpenAI {
                         toolDesc = `web_search → "${functionArgs.query}"`;
                     }
                     onThinking?.(`🔧 ${toolDesc}`);
+                    this.logger.info("TOOL_CALL_SENDING", {
+                        tool: functionName,
+                        inputShape: describeShape(functionArgs),
+                        state: "SENDING",
+                    });
+                    this.logger.debug("TOOL_CALL_FULL_ARGS", {
+                        tool: functionName,
+                        arguments: functionArgs,
+                    });
                     try {
                         const result = await this.client.callTool({
                             name: functionName,
                             arguments: functionArgs,
                         });
+                        this.logger.info("TOOL_CALL_SUCCESS", { tool: functionName, state: "RECEIVED" });
+                        this.logger.debug("TOOL_CALL_FULL_RESULT", {
+                            tool: functionName,
+                            result: result.content,
+                        });
                         newToolOutputs.push(this.makeFunctionOutput(functionCall.call_id, this.compactToolResult(result.content)));
                     }
                     catch (error) {
+                        this.logger.error("TOOL_CALL_ERROR", {
+                            tool: functionName,
+                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                            errorCode: error?.code ?? error?.name ?? "UNKNOWN",
+                            errorMessage: error instanceof Error ? error.message : String(error),
+                            stack: error instanceof Error ? error.stack : undefined,
+                            state: "ERROR_STATE",
+                        });
                         newToolOutputs.push(this.makeFunctionOutput(functionCall.call_id, `Error: ${error instanceof Error ? error.message : String(error)}`));
                     }
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nqminds/mcp-client",
-  "version": "1.0.14",
+  "version": "1.0.21",
   "description": "Reusable MCP client component with AI chat interface",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,6 +47,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
+    "@types/node": "^20.0.0",
     "openai": "^6.15.0"
   },
   "devDependencies": {