@proofofprotocol/inscribe-mcp 0.3.3 → 0.3.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proofofprotocol/inscribe-mcp",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Verifiable inscription for AI agents - inscribe anything to blockchain with Hedera HCS",
   "type": "module",
   "main": "src/server.js",

package/src/cli/commands/debug.js

@@ -85,9 +85,10 @@ export const debugCommand = new Command('debug')
       console.log(`Auto-off:  in ${durationMinutes} minutes`);
       console.log('');
       console.log(colors.bold('Next steps:'));
-      console.log('  1. ' + colors.cyan('Restart Claude Desktop') + ' to apply');
-      console.log('  2. Use inscribe tools to generate debug traces');
-      console.log('  3. ' + colors.cyan('inscribe-mcp show --debug') + ' to view traces');
+      console.log('  1. Use inscribe tools to generate debug traces');
+      console.log('  2. ' + colors.cyan('inscribe-mcp show --debug') + ' to view traces');
+      console.log('');
+      console.log(colors.dim('No restart required - takes effect immediately.'));
       console.log('');
       process.exit(EXIT_CODES.SUCCESS);
     }
@@ -97,7 +98,7 @@ export const debugCommand = new Command('debug')
       console.log('');
       console.log(colors.green('✓') + ' Debug mode ' + colors.dim('OFF'));
       console.log('');
-      console.log('Restart Claude Desktop to apply.');
+      console.log(colors.dim('Takes effect immediately.'));
       console.log('');
       process.exit(EXIT_CODES.SUCCESS);
     }

package/src/lib/logger.js

@@ -5,7 +5,7 @@
  * Used by MCP Server to record all tool executions.
  */
 
-import { existsSync, mkdirSync, appendFileSync } from 'fs';
+import { existsSync, mkdirSync, appendFileSync, readFileSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 
@@ -80,6 +80,41 @@ export function logToolExecution({
   });
 }
 
+/**
+ * Check if debug mode is enabled (config or env)
+ */
+function isDebugEnabled() {
+  // Environment variable takes precedence
+  if (process.env.INSCRIBE_MCP_DEBUG === '1' || process.env.INSCRIBE_MCP_DEBUG === 'true') {
+    return true;
+  }
+
+  // Check config file
+  const configPath = join(homedir(), '.inscribe-mcp', 'config.json');
+  if (!existsSync(configPath)) {
+    return false;
+  }
+
+  try {
+    const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    if (!config.debug || !config.debug.enabled) {
+      return false;
+    }
+
+    // Check expiry
+    if (config.debug.expiresAt) {
+      const expiry = new Date(config.debug.expiresAt);
+      if (Date.now() > expiry.getTime()) {
+        return false; // Expired
+      }
+    }
+
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Log a debug sequence trace
  * @param {Object} options - Debug trace options
@@ -90,10 +125,13 @@ export function logDebugTrace({
   payload = null,
   status = null,
   txId = null,
-  result = null
+  result = null,
+  duration = null,
+  args = null,
+  error = null
 }) {
   // Only log if debug mode is enabled
-  if (!process.env.INSCRIBE_MCP_DEBUG) return;
+  if (!isDebugEnabled()) return;
 
   writeLog({
     level: 'debug',
@@ -102,7 +140,10 @@ export function logDebugTrace({
     payload,
     status,
     txId,
-    result
+    result,
+    duration,
+    args,
+    error
   });
 }
 

package/src/server.js

@@ -20,6 +20,9 @@ import { existsSync, readFileSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 
+// Logger for file-based debug traces (import early for use in debugLog)
+import { logDebugTrace } from './lib/logger.js';
+
 /**
  * Check if debug mode is enabled (config or env)
  */
@@ -55,14 +58,12 @@ function isDebugEnabled() {
   }
 }
 
-// Debug mode check (evaluated at startup)
-const DEBUG = isDebugEnabled();
-
 /**
- * Debug log to stderr (safe for MCP stdio transport)
+ * Debug log to stderr AND file (safe for MCP stdio transport)
+ * Checks config on each call for hot-reload support
  */
 function debugLog(phase, data = {}) {
-  if (!DEBUG) return;
+  if (!isDebugEnabled()) return;
 
   const timestamp = new Date().toISOString();
   const message = {
@@ -73,6 +74,16 @@ function debugLog(phase, data = {}) {
 
   // Output to stderr to avoid interfering with MCP JSON-RPC over stdout
   console.error(`[DEBUG] ${JSON.stringify(message)}`);
+
+  // Also write to file for `inscribe-mcp show --debug`
+  logDebugTrace({
+    phase,
+    tool: data.tool,
+    args: data.args,
+    status: data.status,
+    duration: data.duration,
+    error: data.error
+  });
 }
 
 // Layer 1 Tools (Primary)
@@ -218,16 +229,16 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 
-  if (DEBUG) {
-    console.error('inscribe-mcp server started (stdio) [DEBUG MODE]');
-    console.error('Debug logs will be written to stderr');
+  // Log startup (debug mode is now hot-reloadable)
+  console.error('inscribe-mcp server started (stdio)');
+
+  // Initial debug log if enabled
+  if (isDebugEnabled()) {
+    console.error('Debug mode is currently ON (hot-reloadable)');
     debugLog('server_start', {
-      version: '0.3.3',
-      debug: true,
+      version: '0.3.5',
       tools: allTools.map(t => t.name)
     });
-  } else {
-    console.error('inscribe-mcp server started (stdio)');
   }
 }