@fre4x/grok 1.0.64 → 1.0.65-beta.1

package/README.md

@@ -18,6 +18,8 @@ xAI's Grok is more than an LLM. It's a real-time sensor for the global conscious
 
 Search tools support `limit` and `offset` pagination and return normalized results with citations.
 
+`grok_search_x` accepts `allowed_x_handles`, `excluded_x_handles`, `from_date`, `to_date`, `enable_image_understanding`, and `enable_video_understanding`. `grok_search_web` accepts `allowed_domains`, `excluded_domains`, and `enable_image_understanding`. Include and exclude filters are mutually exclusive per tool, and web domain filters follow xAI's max-5 constraint.
+
 Image generation responses include direct MCP `image` content blocks when media can be embedded. Video responses include direct MCP embedded `resource` blobs because MCP does not define a dedicated `video` content block.
 
 ## Configuration

package/dist/index.js

@@ -3498,7 +3498,7 @@ var require_schemes = __commonJS({
         serialize: httpSerialize
       }
     );
-    var https2 = (
+    var https3 = (
       /** @type {SchemeHandler} */
       {
         scheme: "https",
@@ -3547,7 +3547,7 @@ var require_schemes = __commonJS({
       /** @type {Record<SchemeName, SchemeHandler>} */
       {
         http: http3,
-        https: https2,
+        https: https3,
         ws,
         wss,
         urn,
@@ -16763,7 +16763,7 @@ var require_form_data = __commonJS({
     var util4 = __require("util");
     var path3 = __require("path");
     var http3 = __require("http");
-    var https2 = __require("https");
+    var https3 = __require("https");
     var parseUrl = __require("url").parse;
     var fs3 = __require("fs");
     var Stream = __require("stream").Stream;
@@ -17032,7 +17032,7 @@ var require_form_data = __commonJS({
       }
       options.headers = this.getHeaders(params.headers);
       if (options.protocol === "https:") {
-        request = https2.request(options);
+        request = https3.request(options);
       } else {
         request = http3.request(options);
       }
@@ -17945,7 +17945,7 @@ var require_follow_redirects = __commonJS({
     var url3 = __require("url");
     var URL2 = url3.URL;
     var http3 = __require("http");
-    var https2 = __require("https");
+    var https3 = __require("https");
     var Writable = __require("stream").Writable;
     var assert2 = __require("assert");
     var debug = require_debug();
@@ -18430,7 +18430,7 @@ var require_follow_redirects = __commonJS({
     function isURL(value) {
       return URL2 && value instanceof URL2;
     }
-    module.exports = wrap({ http: http3, https: https2 });
+    module.exports = wrap({ http: http3, https: https3 });
     module.exports.wrap = wrap;
   }
 });
@@ -32560,9 +32560,11 @@ import * as crypto from "node:crypto";
 var PersistentCache = class {
   cacheDir;
   memoryCache = /* @__PURE__ */ new Map();
-  constructor(namespace) {
-    const baseDir = process.env.FRE4X_CACHE_DIR || path.join(os.homedir(), ".fre4x-cache");
+  onDiskWriteError;
+  constructor(namespace, options = {}) {
+    const baseDir = options.dir ?? process.env.FRE4X_CACHE_DIR ?? path.join(os.homedir(), ".fre4x-cache");
     this.cacheDir = path.join(baseDir, namespace);
+    this.onDiskWriteError = options.onDiskWriteError;
   }
   async ensureDir() {
     await fs.mkdir(this.cacheDir, { recursive: true });
@@ -32606,7 +32608,7 @@ var PersistentCache = class {
       const fpath = this.getFilePath(key);
       await fs.writeFile(fpath, JSON.stringify(entry), "utf8");
     } catch (error48) {
-      console.error(`[Cache] Failed to save to disk: ${error48}`);
+      this.onDiskWriteError?.(error48);
     }
   }
   async wrap(key, ttlMs, fetchFn) {
@@ -45933,6 +45935,9 @@ var {
   mergeConfig: mergeConfig2
 } = axios_default;
 
+// src/index.ts
+import https2 from "node:https";
+
 // src/mock.ts
 var IS_MOCK = process.env.MOCK === "true" || process.env.GROK_MOCK === "true";
 var MOCK_FIXTURES = {
@@ -46071,16 +46076,29 @@ var MOCK_VIDEO_BASE64 = "AAAAHGZ0eXBpc29tAAAAAGlzb21pc28yYXZjMQ==";
 function getErrorMessage(error48) {
   return error48 instanceof Error ? error48.message : String(error48);
 }
+var isoDatePattern = /^\d{4}-\d{2}-\d{2}$/;
+var isoDateOrDateTimeSchema = z3.string().refine(
+  (value) => isoDatePattern.test(value) || z3.string().datetime({ offset: true }).safeParse(value).success,
+  "must be an ISO8601 date or datetime with timezone"
+);
+function parseSearchDate(value) {
+  return isoDatePattern.test(value) ? Date.parse(`${value}T00:00:00Z`) : Date.parse(value);
+}
 var xSearchSchema = paginationSchema.extend({
   query: z3.string().min(1).max(500),
-  allowed_handles: z3.array(z3.string().min(1).max(50)).max(10).optional(),
-  from_date: z3.string().datetime({ offset: true }).optional(),
-  to_date: z3.string().datetime({ offset: true }).optional(),
+  allowed_x_handles: z3.array(z3.string().min(1).max(50)).max(10).optional(),
+  excluded_x_handles: z3.array(z3.string().min(1).max(50)).max(10).optional(),
+  from_date: isoDateOrDateTimeSchema.optional(),
+  to_date: isoDateOrDateTimeSchema.optional(),
+  enable_image_understanding: z3.boolean().default(false),
+  enable_video_understanding: z3.boolean().default(false),
   output_dir: z3.string().optional()
 }).strict();
 var webSearchSchema = paginationSchema.extend({
   query: z3.string().min(1).max(500),
-  allowed_domains: z3.array(z3.string().min(1).max(255)).max(20).optional(),
+  allowed_domains: z3.array(z3.string().min(1).max(255)).max(5).optional(),
+  excluded_domains: z3.array(z3.string().min(1).max(255)).max(5).optional(),
+  enable_image_understanding: z3.boolean().default(false),
   output_dir: z3.string().optional()
 }).strict();
 var imagineSchema = z3.object({
@@ -46110,6 +46128,8 @@ var cache = new PersistentCache("grok");
 var SEARCH_CACHE_TTL = 30 * 60 * 1e3;
 var xaiClient = axios_default.create({
   baseURL: "https://api.x.ai/v1",
+  // ⚡ Bolt: Use HTTP Keep-Alive connection pooling to reduce expensive TCP/TLS handshakes on repeated calls
+  httpsAgent: new https2.Agent({ keepAlive: true }),
   headers: {
     Authorization: `Bearer ${XAI_API_KEY || "mock-key"}`,
     "Content-Type": "application/json"
@@ -46134,15 +46154,24 @@ function getValidationResult(error48) {
 async function handleGrokSearchX(params, client = xaiClient) {
   const {
     query,
-    allowed_handles,
+    allowed_x_handles,
+    excluded_x_handles,
     from_date,
     to_date,
+    enable_image_understanding,
+    enable_video_understanding,
     limit,
     offset,
     output_dir
   } = params;
   try {
-    if (from_date && to_date && from_date > to_date) {
+    if (allowed_x_handles && excluded_x_handles) {
+      return createValidationError(
+        "allowed_x_handles",
+        "cannot be used together with excluded_x_handles"
+      );
+    }
+    if (from_date && to_date && parseSearchDate(from_date) > parseSearchDate(to_date)) {
       return createValidationError(
         "from_date",
         "must be earlier than or equal to to_date"
@@ -46151,9 +46180,12 @@ async function handleGrokSearchX(params, client = xaiClient) {
     const cacheKey = JSON.stringify({
       tool: "grok_search_x",
       query,
-      allowed_handles,
+      allowed_x_handles,
+      excluded_x_handles,
       from_date,
-      to_date
+      to_date,
+      enable_image_understanding,
+      enable_video_understanding
     });
     const rawResponse = await cache.wrap(
       cacheKey,
@@ -46167,9 +46199,12 @@ async function handleGrokSearchX(params, client = xaiClient) {
             {
               type: "x_search",
               query,
-              allowed_x_handles: allowed_handles,
+              allowed_x_handles,
+              excluded_x_handles,
               from_date,
-              to_date
+              to_date,
+              enable_image_understanding,
+              enable_video_understanding
             }
           ]
         });
@@ -46213,12 +46248,28 @@ async function handleGrokSearchX(params, client = xaiClient) {
   }
 }
 async function handleGrokSearchWeb(params, client = xaiClient) {
-  const { query, allowed_domains, limit, offset, output_dir } = params;
+  const {
+    query,
+    allowed_domains,
+    excluded_domains,
+    enable_image_understanding,
+    limit,
+    offset,
+    output_dir
+  } = params;
   try {
+    if (allowed_domains && excluded_domains) {
+      return createValidationError(
+        "allowed_domains",
+        "cannot be used together with excluded_domains"
+      );
+    }
     const cacheKey = JSON.stringify({
       tool: "grok_search_web",
       query,
-      allowed_domains
+      allowed_domains,
+      excluded_domains,
+      enable_image_understanding
     });
     const rawResponse = await cache.wrap(
       cacheKey,
@@ -46237,7 +46288,9 @@ async function handleGrokSearchWeb(params, client = xaiClient) {
             {
               type: "web_search",
               query,
-              allowed_domains
+              allowed_domains,
+              excluded_domains,
+              enable_image_understanding
             }
           ]
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fre4x/grok",
-  "version": "1.0.64",
+  "version": "1.0.65-beta.1",
   "description": "An MCP server for xAI (Grok) with search and generation capabilities.",
   "type": "module",
   "main": "dist/index.js",
@@ -18,7 +18,7 @@
     "watch": "tsc -w",
     "inspector": "npm run build && node ../scripts/run-official-inspector.mjs node dist/index.js",
     "prepublishOnly": "npm run build && npm run typecheck",
-    "test": "vitest run --passWithNoTests --exclude dist"
+    "test": "node ../scripts/run-vitest.mjs run --passWithNoTests --exclude dist"
   },
   "keywords": [
     "mcp",