@runpod/mcp-server 4.7.0 → 4.8.0

package/dist/stdio.mjs

@@ -12,7 +12,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 
 // src/server.ts
 var SERVER_NAME = "Runpod API Server";
-var SERVER_VERSION = true ? "4.7.0" : "dev";
+var SERVER_VERSION = true ? "4.8.0" : "dev";
 
 // src/specgen/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -477,9 +477,36 @@ var generatedTools = [
         },
         ClusterMounts: {
           description: "Storage mounts for a cluster create: `persistent` or `network`, not both. Clusters cannot mount global volumes, so `global` is rejected.",
+          "x-go-type": "BaseMounts",
           allOf: [
             {
               $ref: "#/$defs/BaseMounts"
+            },
+            {
+              type: "object",
+              properties: {
+                persistent: {
+                  type: "object",
+                  properties: {
+                    path: {
+                      type: "string",
+                      minLength: 1
+                    }
+                  }
+                },
+                network: {
+                  type: "array",
+                  items: {
+                    type: "object",
+                    properties: {
+                      path: {
+                        type: "string",
+                        minLength: 1
+                      }
+                    }
+                  }
+                }
+              }
             }
           ],
           unevaluatedProperties: false
@@ -2555,6 +2582,37 @@ var generatedTools = [
       properties: {}
     }
   },
+  {
+    name: "get-organization-user",
+    title: "Get organization user",
+    operationId: "getOrganizationUser",
+    description: "Get an organization member. Returns one member of the authenticated caller's organization by user ID, with the role they hold. Any member can read it. A user who is not a member, including one from another organization, returns 404. Returns 404 when the caller does not belong to an organization, or 403 when organizations are unavailable to the caller.",
+    method: "GET",
+    path: "/v2/organization/users/{id}",
+    params: [
+      {
+        name: "id",
+        location: "path"
+      }
+    ],
+    hasBody: false,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "User identifier"
+        }
+      },
+      required: ["id"]
+    }
+  },
   {
     name: "get-pod",
     title: "Get Pod",
@@ -3694,6 +3752,26 @@ var generatedTools = [
       }
     }
   },
+  {
+    name: "list-organization-users",
+    title: "List organization users",
+    operationId: "listOrganizationUsers",
+    description: "List organization members. Returns every member of the authenticated caller's organization with the role each holds. Any member can read the roster. The list is complete and takes no pagination parameters. Returns 404 when the caller does not belong to an organization, or 403 when organizations are unavailable to the caller.",
+    method: "GET",
+    path: "/v2/organization/users",
+    params: [],
+    hasBody: false,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
   {
     name: "list-pod-billing",
     title: "List Pod billing",
@@ -5250,6 +5328,7 @@ function networkFailureResult(error) {
   return {
     ok: false,
     status: unreached ? 503 : 502,
+    requestDelivery: unreached ? "not_sent" : "uncertain",
     payload: unreached ? {
       error: "Could not reach the Runpod API.",
       cause: code,
@@ -5276,6 +5355,7 @@ async function runTool(body) {
       return {
         ok: false,
         status: 504,
+        requestDelivery: "uncertain",
         payload: {
           error: "The Runpod API did not respond before the request deadline.",
           hint: "Transient upstream stall: retry the same call once; if it persists, check https://uptime.runpod.io."
@@ -5367,6 +5447,7 @@ var DIRECTORY_TOOLS = {
   "get-job-status": IN,
   "get-network-volume": IN,
   "get-organization": IN,
+  "get-organization-user": IN,
   "get-pod": IN,
   "get-ssh-keys": IN,
   "get-template": IN,
@@ -5388,6 +5469,7 @@ var DIRECTORY_TOOLS = {
   "list-hub-repos": IN,
   "list-network-volume-billing": IN,
   "list-network-volumes": IN,
+  "list-organization-users": IN,
   "list-pod-billing": IN,
   "list-pods": IN,
   "list-public-endpoints": IN,
@@ -9051,6 +9133,7 @@ function captureToolCall(apiKey, event) {
     ...event.clientName ? { client_name: event.clientName } : {},
     ...event.guideKind ? { guide_kind: event.guideKind } : {},
     ...event.blockedBy ? { blocked_by: event.blockedBy } : {},
+    ...event.profile ? { profile: event.profile } : {},
     ...args
   });
 }
@@ -9927,6 +10010,7 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
           status: 429,
           durationMs: 0,
           ...verdict.reason ? { blockedBy: verdict.reason } : {},
+          profile,
           ...opts.analytics
         });
       }
@@ -9947,6 +10031,9 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
     const curated = servedCuratedTools.find(
       (tool) => tool.name === request.params.name
     );
+    const generated = servedGeneratedTools.find(
+      (tool) => tool.name === request.params.name
+    );
     const omitted = directory ? directoryOmittedInputs(request.params.name).filter((key) => key in args) : [];
     const rejected = omitted.length ? {
       ok: false,
@@ -9959,7 +10046,7 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
       args
     ) : null;
     const result = rejected ?? await runTool(
-      () => curated ? curated.handler(ctx, args) : dispatchTool(request.params.name, args)
+      () => curated ? curated.handler(ctx, args) : dispatchTool(generated, request.params.name, args)
     );
     logToolCall({
       tool: request.params.name,
@@ -9979,23 +10066,27 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
           args: recordedArgumentValues(curated?.recordedArguments, args),
           guideKind: curated?.recordedGuideKind?.(args)
         },
+        profile,
         ...opts.analytics
       });
     }
     opts.onToolResult?.(request.params.name, result.status);
     if (!result.ok && result.status === 401) opts.onUnauthorized?.();
+    const annotations = curated?.annotations ?? generated?.annotations;
     const payload = redactSecretEnv(
-      result.ok ? result.payload : withRecoveryHint(result, callShapeOnlyTools.has(request.params.name))
+      result.ok ? result.payload : withRecoveryHint(
+        result,
+        annotations?.idempotentHint === true,
+        request.params.name,
+        callShapeOnlyTools.has(request.params.name)
+      )
     );
     return {
       content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
       isError: !result.ok
     };
   });
-  async function dispatchTool(name, args) {
-    const tool = servedGeneratedTools.find(
-      (candidate) => candidate.name === name
-    );
+  async function dispatchTool(tool, name, args) {
     if (!tool)
       return {
         ok: false,
@@ -10043,8 +10134,24 @@ function errorHint(status, detail) {
   return void 0;
 }
 var CALL_SHAPE_ONLY_HINT = `This tool lists its call shape only; ${DESCRIBE_TOOL_NAME} serves the full argument schema.`;
-function withRecoveryHint(result, listsCallShapeOnly = false) {
+var OUTCOME_UNKNOWN_HINT = "Runpod may have completed this operation even though its response failed. Do not submit it again yet. Check the matching get- or list- tool or the Runpod console using the original request details and time. Lists can lag; if you cannot confirm the outcome, stop and ask the user to verify before retrying.";
+var JOB_OUTCOME_UNKNOWN_HINT = "Runpod may have submitted this Serverless job even though its response failed. Do not submit it again yet. No job-list tool is available, and get-job-status requires a job ID that this failed response may not have returned. Check the endpoint in the Runpod console or ask the user to verify the submission. If the outcome remains uncertain, stop instead of retrying.";
+var RETRY_JOB_OUTCOME_UNKNOWN_HINT = "Runpod may have requeued this Serverless job even though its response failed. Do not retry it again yet. Check get-job-status with the endpoint and job IDs you supplied, or check the Runpod console. If you cannot confirm the outcome, stop and ask the user to verify before retrying.";
+var JOB_SUBMISSION_TOOLS = /* @__PURE__ */ new Set(["run-endpoint", "runsync-endpoint"]);
+function withRecoveryHint(result, idempotent, toolName, listsCallShapeOnly = false) {
   const payload = asRecord(result.payload) ?? { error: result.payload };
+  if (!idempotent && result.status >= 500 && result.requestDelivery !== "not_sent") {
+    const detail = asRecord(payload.detail);
+    const safeDetail = detail ? { ...detail } : void 0;
+    if (safeDetail) delete safeDetail.hint;
+    return {
+      ...payload,
+      ...safeDetail ? { detail: safeDetail } : {},
+      ...payload.code !== void 0 ? { upstreamCode: payload.code } : {},
+      code: "outcome_unknown",
+      hint: toolName === "retry-job" ? RETRY_JOB_OUTCOME_UNKNOWN_HINT : JOB_SUBMISSION_TOOLS.has(toolName) ? JOB_OUTCOME_UNKNOWN_HINT : OUTCOME_UNKNOWN_HINT
+    };
+  }
   const hint = payload.hint ?? asRecord(payload.detail)?.hint ?? errorHint(result.status, detailText(payload));
   const shapeRejected = result.status === 400 || result.status === 422;
   return {