@fre4x/grok 1.1.0-beta.3 → 1.1.0-beta.4

package/README.md

@@ -10,15 +10,15 @@ xAI's Grok is more than an LLM. It's a real-time sensor for the global conscious
 
 | Tool | Capability |
 |------|------------|
-| `grok_search_x` | Search X posts and threads with optional date and handle filters |
-| `grok_search_web` | Search the public web with optional domain filters |
-| `grok_imagine` | Generate high-quality images from text prompts |
-| `grok_animate` | Start an asynchronous video generation task |
-| `grok_check_video_status` | Check the status of a video generation task |
+| `search_x` | Search X posts and threads with optional date and handle filters |
+| `search_web` | Search the public web with optional domain filters |
+| `generate_image` | Generate high-quality images from text prompts |
+| `generate_video` | Start an asynchronous video generation task |
+| `get_video_status` | Check the status of a video generation task |
 
 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.
+`search_x` accepts `allowed_x_handles`, `excluded_x_handles`, `from_date`, `to_date`, `enable_image_understanding`, and `enable_video_understanding`. `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.
 

package/dist/index.js

@@ -36556,7 +36556,7 @@ function object2(shape, params) {
   return new ZodMiniObject(def);
 }
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
 function isZ4Schema(s) {
   const schema = s;
   return !!schema._zod;
@@ -36700,7 +36700,7 @@ function getLiteralValue(schema) {
   return void 0;
 }
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
 var LATEST_PROTOCOL_VERSION = "2025-11-25";
 var SUPPORTED_PROTOCOL_VERSIONS = [LATEST_PROTOCOL_VERSION, "2025-06-18", "2025-03-26", "2024-11-05", "2024-10-07"];
 var RELATED_TASK_META_KEY = "io.modelcontextprotocol/related-task";
@@ -36710,10 +36710,9 @@ var ProgressTokenSchema = union([string2(), number2().int()]);
 var CursorSchema = string2();
 var TaskCreationParamsSchema = looseObject({
   /**
-   * Time in milliseconds to keep task results available after completion.
-   * If null, the task has unlimited lifetime until manually cleaned up.
+   * Requested duration in milliseconds to retain task from creation.
    */
-  ttl: union([number2(), _null3()]).optional(),
+  ttl: number2().optional(),
   /**
    * Time in milliseconds to wait between task status requests.
    */
@@ -37013,7 +37012,11 @@ var ClientCapabilitiesSchema = object({
   /**
    * Present if the client supports task creation.
    */
-  tasks: ClientTasksCapabilitySchema.optional()
+  tasks: ClientTasksCapabilitySchema.optional(),
+  /**
+   * Extensions that the client supports. Keys are extension identifiers (vendor-prefix/extension-name).
+   */
+  extensions: record(string2(), AssertObjectSchema).optional()
 });
 var InitializeRequestParamsSchema = BaseRequestParamsSchema.extend({
   /**
@@ -37074,7 +37077,11 @@ var ServerCapabilitiesSchema = object({
   /**
    * Present if the server supports task creation.
    */
-  tasks: ServerTasksCapabilitySchema.optional()
+  tasks: ServerTasksCapabilitySchema.optional(),
+  /**
+   * Extensions that the server supports. Keys are extension identifiers (vendor-prefix/extension-name).
+   */
+  extensions: record(string2(), AssertObjectSchema).optional()
 });
 var InitializeResultSchema = ResultSchema.extend({
   /**
@@ -37266,6 +37273,12 @@ var ResourceSchema = object({
    * The MIME type of this resource, if known.
    */
   mimeType: optional(string2()),
+  /**
+   * The size of the raw resource content, in bytes (i.e., before base64 encoding or any tokenization), if known.
+   *
+   * This can be used by Hosts to display file sizes and estimate context window usage.
+   */
+  size: optional(number2()),
   /**
    * Optional annotations for the client.
    */
@@ -38218,7 +38231,7 @@ var UrlElicitationRequiredError = class extends McpError {
   }
 };
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
 function isTerminal(status) {
   return status === "completed" || status === "failed" || status === "cancelled";
 }
@@ -39507,7 +39520,7 @@ var zodToJsonSchema = (schema, options) => {
   return combined;
 };
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
 function mapMiniTarget(t) {
   if (!t)
     return "draft-7";
@@ -39549,7 +39562,7 @@ function parseWithCompat(schema, data) {
   return result.data;
 }
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
 var DEFAULT_REQUEST_TIMEOUT_MSEC = 6e4;
 var Protocol = class {
   constructor(_options) {
@@ -39761,6 +39774,10 @@ var Protocol = class {
     this._progressHandlers.clear();
     this._taskProgressTokens.clear();
     this._pendingDebouncedNotifications.clear();
+    for (const info of this._timeoutInfo.values()) {
+      clearTimeout(info.timeoutId);
+    }
+    this._timeoutInfo.clear();
     for (const controller of this._requestHandlerAbortControllers.values()) {
       controller.abort();
     }
@@ -39891,7 +39908,9 @@ var Protocol = class {
         await capturedTransport?.send(errorResponse);
       }
     }).catch((error48) => this._onerror(new Error(`Failed to send response: ${error48}`))).finally(() => {
-      this._requestHandlerAbortControllers.delete(request.id);
+      if (this._requestHandlerAbortControllers.get(request.id) === abortController) {
+        this._requestHandlerAbortControllers.delete(request.id);
+      }
     });
   }
   _onprogress(notification) {
@@ -40497,7 +40516,7 @@ function mergeCapabilities(base, additional) {
   return result;
 }
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/validation/ajv-provider.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/validation/ajv-provider.js
 var import_ajv = __toESM(require_ajv(), 1);
 var import_ajv_formats = __toESM(require_dist(), 1);
 function createDefaultAjvInstance() {
@@ -40565,7 +40584,7 @@ var AjvJsonSchemaValidator = class {
   }
 };
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.js
 var ExperimentalServerTasks = class {
   constructor(_server) {
     this._server = _server;
@@ -40778,7 +40797,7 @@ var ExperimentalServerTasks = class {
   }
 };
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/helpers.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/helpers.js
 function assertToolsCallTaskCapability(requests, method, entityName) {
   if (!requests) {
     throw new Error(`${entityName} does not support task creation (required for ${method})`);
@@ -40813,7 +40832,7 @@ function assertClientRequestTaskCapability(requests, method, entityName) {
   }
 }
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
 var Server = class extends Protocol {
   /**
    * Initializes this server with the given name and version information.
@@ -41193,7 +41212,7 @@ var Server = class extends Protocol {
   }
 };
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
 var COMPLETABLE_SYMBOL = /* @__PURE__ */ Symbol.for("mcp.completable");
 function isCompletable(schema) {
   return !!schema && typeof schema === "object" && COMPLETABLE_SYMBOL in schema;
@@ -41207,7 +41226,7 @@ var McpZodTypeKind;
   McpZodTypeKind2["Completable"] = "McpCompletable";
 })(McpZodTypeKind || (McpZodTypeKind = {}));
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
 var TOOL_NAME_REGEX = /^[A-Za-z0-9._-]{1,128}$/;
 function validateToolName(name) {
   const warnings = [];
@@ -41265,7 +41284,7 @@ function validateAndWarnToolName(name) {
   return result.isValid;
 }
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.js
 var ExperimentalMcpServerTasks = class {
   constructor(_mcpServer) {
     this._mcpServer = _mcpServer;
@@ -41280,7 +41299,7 @@ var ExperimentalMcpServerTasks = class {
   }
 };
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
 var McpServer = class {
   constructor(serverInfo, options) {
     this._registeredResources = {};
@@ -41904,6 +41923,9 @@ var McpServer = class {
           annotations = rest.shift();
         }
       } else if (typeof firstArg === "object" && firstArg !== null) {
+        if (Object.values(firstArg).some((v) => typeof v === "object" && v !== null)) {
+          throw new Error(`Tool ${name} expected a Zod schema or ToolAnnotations, but received an unrecognized object`);
+        }
         annotations = rest.shift();
       }
     }
@@ -42022,6 +42044,9 @@ function getZodSchemaObject(schema) {
   if (isZodRawShapeCompat(schema)) {
     return objectFromShape(schema);
   }
+  if (!isZodSchemaInstance(schema)) {
+    throw new Error("inputSchema must be a Zod schema or raw shape, received an unrecognized object");
+  }
   return schema;
 }
 function promptArgumentsFromSchema(schema) {
@@ -42066,10 +42091,10 @@ var EMPTY_COMPLETION_RESULT = {
   }
 };
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 import process3 from "node:process";
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
 var ReadBuffer = class {
   append(chunk) {
     this._buffer = this._buffer ? Buffer.concat([this._buffer, chunk]) : chunk;
@@ -42097,7 +42122,7 @@ function serializeMessage(message) {
   return JSON.stringify(message) + "\n";
 }
 
-// ../node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
+// node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var StdioServerTransport = class {
   constructor(_stdin = process3.stdin, _stdout = process3.stdout) {
     this._stdin = _stdin;
@@ -45941,7 +45966,7 @@ import https2 from "node:https";
 // src/mock.ts
 var IS_MOCK = process.env.MOCK === "true" || process.env.GROK_MOCK === "true";
 var MOCK_FIXTURES = {
-  grok_search_x: {
+  search_x: {
     id: "mock_resp_1",
     model: "grok-4-1-fast-reasoning",
     output: [
@@ -45990,7 +46015,7 @@ var MOCK_FIXTURES = {
       }
     ]
   },
-  grok_search_web: {
+  search_web: {
     id: "mock_resp_2",
     model: "grok-4-1-fast-reasoning",
     output: [
@@ -46035,7 +46060,7 @@ var MOCK_FIXTURES = {
       }
     ]
   },
-  grok_imagine: {
+  generate_image: {
     data: [
       {
         url: "https://api.x.ai/v1/images/mock_image_123.png",
@@ -46043,11 +46068,11 @@ var MOCK_FIXTURES = {
       }
     ]
   },
-  grok_animate: {
+  generate_video: {
     request_id: "vid_mock_987",
     status: "processing"
   },
-  grok_check_video_status: {
+  get_video_status: {
     request_id: "vid_mock_987",
     status: "completed",
     video_url: "https://api.x.ai/v1/videos/mock_video_987.mp4"
@@ -46140,11 +46165,11 @@ var server = new McpServer({
   version: PACKAGE_VERSION
 });
 var TOOL_DEFINITIONS = [
-  { name: "grok_search_x" },
-  { name: "grok_search_web" },
-  { name: "grok_imagine" },
-  { name: "grok_animate" },
-  { name: "grok_check_video_status" }
+  { name: "search_x" },
+  { name: "search_web" },
+  { name: "generate_image" },
+  { name: "generate_video" },
+  { name: "get_video_status" }
 ];
 function getValidationResult(error48) {
   const issue2 = error48.issues[0];
@@ -46178,7 +46203,7 @@ async function handleGrokSearchX(params, client = xaiClient) {
       );
     }
     const cacheKey = JSON.stringify({
-      tool: "grok_search_x",
+      tool: "search_x",
       query,
       allowed_x_handles,
       excluded_x_handles,
@@ -46191,7 +46216,7 @@ async function handleGrokSearchX(params, client = xaiClient) {
       cacheKey,
       SEARCH_CACHE_TTL,
       async () => {
-        if (IS_MOCK) return MOCK_FIXTURES.grok_search_x;
+        if (IS_MOCK) return MOCK_FIXTURES.search_x;
         const { data } = await client.post("/responses", {
           model: GROK_SEARCH_MODEL,
           input: [{ role: "user", content: query }],
@@ -46265,7 +46290,7 @@ async function handleGrokSearchWeb(params, client = xaiClient) {
       );
     }
     const cacheKey = JSON.stringify({
-      tool: "grok_search_web",
+      tool: "search_web",
       query,
       allowed_domains,
       excluded_domains,
@@ -46275,7 +46300,7 @@ async function handleGrokSearchWeb(params, client = xaiClient) {
       cacheKey,
       SEARCH_CACHE_TTL,
       async () => {
-        if (IS_MOCK) return MOCK_FIXTURES.grok_search_web;
+        if (IS_MOCK) return MOCK_FIXTURES.search_web;
         const { data } = await client.post("/responses", {
           model: GROK_SEARCH_MODEL,
           input: [
@@ -46336,7 +46361,7 @@ async function handleGrokSearchWeb(params, client = xaiClient) {
 async function handleGrokImagine(params, client = xaiClient) {
   const { prompt, aspect_ratio, output_dir } = params;
   try {
-    const rawResponse = IS_MOCK ? MOCK_FIXTURES.grok_imagine : (await client.post("/images/generations", {
+    const rawResponse = IS_MOCK ? MOCK_FIXTURES.generate_image : (await client.post("/images/generations", {
       model: GROK_IMAGE_MODEL,
       prompt,
       aspect_ratio,
@@ -46367,6 +46392,9 @@ async function handleGrokImagine(params, client = xaiClient) {
             )
           )
         );
+        output.images.forEach((image, index) => {
+          image.savedPath = savedPaths[index];
+        });
         extraText = `
 
 \u2705 Images saved to:
@@ -46395,7 +46423,7 @@ ${savedPaths.join("\n")}`;
 async function handleGrokAnimate(params, client = xaiClient) {
   const { prompt, image_url, aspect_ratio } = params;
   try {
-    const rawResponse = IS_MOCK ? MOCK_FIXTURES.grok_animate : (await client.post("/videos/generations", {
+    const rawResponse = IS_MOCK ? MOCK_FIXTURES.generate_video : (await client.post("/videos/generations", {
       model: GROK_VIDEO_MODEL,
       prompt,
       image_url,
@@ -46421,7 +46449,7 @@ async function handleGrokAnimate(params, client = xaiClient) {
 async function handleGrokVideoStatus(params, client = xaiClient) {
   const { request_id, output_dir } = params;
   try {
-    const rawResponse = IS_MOCK ? MOCK_FIXTURES.grok_check_video_status : (await client.get(`/videos/${request_id}`)).data;
+    const rawResponse = IS_MOCK ? MOCK_FIXTURES.get_video_status : (await client.get(`/videos/${request_id}`)).data;
     const output = normalizeVideoStatusResponse(rawResponse, request_id);
     let mediaContent = [];
     let extraText = "";
@@ -46439,6 +46467,7 @@ async function handleGrokVideoStatus(params, client = xaiClient) {
               `video-${Date.now()}.mp4`,
               mediaRes.buffer
             );
+            output.savedPath = fpath;
             extraText = `
 
 \u2705 Video saved to: ${fpath}`;
@@ -46467,23 +46496,23 @@ async function handleGrokVideoStatus(params, client = xaiClient) {
 }
 async function handleToolCall(name, args, client = xaiClient) {
   switch (name) {
-    case "grok_search_x": {
+    case "search_x": {
       const parsed = xSearchSchema.safeParse(args);
       return parsed.success ? handleGrokSearchX(parsed.data, client) : getValidationResult(parsed.error);
     }
-    case "grok_search_web": {
+    case "search_web": {
       const parsed = webSearchSchema.safeParse(args);
       return parsed.success ? handleGrokSearchWeb(parsed.data, client) : getValidationResult(parsed.error);
     }
-    case "grok_imagine": {
+    case "generate_image": {
       const parsed = imagineSchema.safeParse(args);
       return parsed.success ? handleGrokImagine(parsed.data, client) : getValidationResult(parsed.error);
     }
-    case "grok_animate": {
+    case "generate_video": {
       const parsed = animateSchema.safeParse(args);
       return parsed.success ? handleGrokAnimate(parsed.data, client) : getValidationResult(parsed.error);
     }
-    case "grok_check_video_status": {
+    case "get_video_status": {
       const parsed = videoStatusSchema.safeParse(args);
       return parsed.success ? handleGrokVideoStatus(parsed.data, client) : getValidationResult(parsed.error);
     }
@@ -46492,31 +46521,31 @@ async function handleToolCall(name, args, client = xaiClient) {
   }
 }
 server.tool(
-  "grok_search_x",
+  "search_x",
   "Search X posts and threads via Grok.",
   xSearchSchema.shape,
   async (args) => handleGrokSearchX(args)
 );
 server.tool(
-  "grok_search_web",
+  "search_web",
   "Search the public web via Grok.",
   webSearchSchema.shape,
   async (args) => handleGrokSearchWeb(args)
 );
 server.tool(
-  "grok_imagine",
+  "generate_image",
   "Generate images from a text prompt.",
   imagineSchema.shape,
   async (args) => handleGrokImagine(args)
 );
 server.tool(
-  "grok_animate",
+  "generate_video",
   "Start a Grok video generation task.",
   animateSchema.shape,
   async (args) => handleGrokAnimate(args)
 );
 server.tool(
-  "grok_check_video_status",
+  "get_video_status",
   "Check a Grok video task status.",
   videoStatusSchema.shape,
   async (args) => handleGrokVideoStatus(args)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fre4x/grok",
-  "version": "1.1.0-beta.3",
+  "version": "1.1.0-beta.4",
   "description": "An MCP server for xAI (Grok) with search and generation capabilities.",
   "type": "module",
   "main": "dist/index.js",
@@ -33,7 +33,7 @@
   "author": "fritzprix",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "axios": "^1.13.5",
     "zod": "^4.3.6"
   },