@automattic/mcp-wordpress-remote 0.3.1 → 0.3.4

package/README.md

@@ -266,6 +266,12 @@ For WooCommerce-specific tools and reports:
 | `WP_MCP_CONFIG_DIR`           | Config directory override                        | `~/.mcp-auth`        | -                     |
 | `LOG_FILE`                    | Log file path                                    | -                    | -                     |
 | `LOG_LEVEL`                   | Log level (0-3)                                  | `2`                  | -                     |
+| `LOG_TO_STDERR`               | Mirror all log levels to stderr (errors always are) | `false`           | -                     |
+| `WP_API_TIMEOUT_MS`           | Request timeout for tool calls (ms)              | `120000`             | -                     |
+| `WP_API_INIT_TIMEOUT_MS`      | Timeout for the initialize handshake (ms)        | `25000`              | -                     |
+| **TLS / Certificates**        |                                                  |                      |                       |
+| `NODE_EXTRA_CA_CERTS`         | Path to an extra CA file to trust (mkcert/corporate CA) | -             | -                     |
+| `NODE_USE_SYSTEM_CA`          | Trust the OS certificate store (Node 22.15+)     | -                    | -                     |
 | **Legacy Authentication**     |                                                  |                      |                       |
 | `JWT_TOKEN`                   | JWT token for authentication                     | -                    | -                     |
 | `WP_API_USERNAME`             | WordPress username (legacy)                      | -                    | -                     |

package/dist/lib.d.ts

@@ -15,7 +15,7 @@ interface WordPressResponse {
     [key: string]: any;
 }
 
-declare const MCP_WORDPRESS_REMOTE_VERSION = "0.3.0";
+declare const MCP_WORDPRESS_REMOTE_VERSION = "0.3.4";
 /**
  * Centralized configuration for MCP WordPress Remote
  * All default values are defined here and can be overridden via environment variables
@@ -36,6 +36,8 @@ declare const CONFIG: {
     readonly OAUTH_SCOPES: string;
     readonly OAUTH_TIMEOUT: 30000;
     readonly LOCK_TIMEOUT: 300000;
+    readonly WP_API_TIMEOUT: number;
+    readonly WP_API_INIT_TIMEOUT: number;
     readonly WP_MCP_CONFIG_DIR: string;
     readonly LOG_FILE: string | null;
     readonly WP_API_USERNAME: string | undefined;
@@ -75,6 +77,10 @@ declare const getConfig: () => {
     oauthTimeout: 30000;
     /** Lock operation timeout in milliseconds */
     lockTimeout: 300000;
+    /** WordPress request timeout in milliseconds (tool calls and non-init requests) */
+    wpApiTimeout: number;
+    /** WordPress initialize handshake timeout in milliseconds */
+    wpApiInitTimeout: number;
     /** Configuration directory path */
     configDir: string;
     /** Log file path (null if not set) */
@@ -217,7 +223,9 @@ declare class APIError extends Error {
     readonly statusCode: number;
     readonly endpoint: string;
     readonly response?: any;
-    constructor(message: string, statusCode: number, endpoint: string, response?: any);
+    /** Underlying network/TLS error code (e.g. "UNABLE_TO_VERIFY_LEAF_SIGNATURE"), when the failure was below the HTTP layer. */
+    readonly code?: string;
+    constructor(message: string, statusCode: number, endpoint: string, response?: any, code?: string);
 }
 /**
  * Error type guards
@@ -282,16 +290,30 @@ declare function getFetchInfo(): {
  *
  * Supports:
  * - macOS: Automatic PAC file detection from system proxy settings
- * - macOS: System SOCKS proxy detection (AutoProxxy Tunnel All Traffic)
+ * - macOS: System SOCKS proxy detection (manual "tunnel all traffic" config)
  * - All platforms: Environment variables (SOCKS_PROXY, HTTPS_PROXY, etc.)
  */
 
 type ProxyAgent = SocksProxyAgent | HttpsProxyAgent<string>;
+interface MacOsProxyInfo {
+    pacUrl: string | null;
+    socks: {
+        host: string;
+        port: string;
+    } | null;
+}
+/**
+ * Detector for macOS system proxy settings. Injectable so the precedence
+ * logic in doInitializeProxy() can be tested without shelling out to scutil.
+ */
+type MacOsProxyDetector = () => MacOsProxyInfo | null;
 /**
  * Initialize proxy configuration (call once at startup)
  * Guards against concurrent initialization calls
+ *
+ * @param detectMacOs - Optional override for macOS proxy detection (testing seam)
  */
-declare function initializeProxy(): Promise<void>;
+declare function initializeProxy(detectMacOs?: MacOsProxyDetector): Promise<void>;
 /**
  * Get appropriate agent for a URL based on proxy configuration
  */