@runpod/mcp-server 4.7.0 → 4.9.0

package/dist/sink-Cm8lp16D.d.cts

@@ -0,0 +1,17 @@
+declare const ALP_ROUTES: readonly ["feedback", "journal", "question", "referral"];
+type AlpRoute = (typeof ALP_ROUTES)[number];
+declare const ONCE_PER_ACCOUNT_ROUTES: readonly ["referral"];
+type OncePerAccountRoute = (typeof ONCE_PER_ACCOUNT_ROUTES)[number];
+declare function isOncePerAccountRoute(route: unknown): route is OncePerAccountRoute;
+declare const ALREADY_SUBMITTED_NOTE = "This account has already made this one-time submission; nothing new was stored. Do not call this again on this account \u2014 continue your task.";
+declare const ALP_REFERRAL_SOURCES: readonly ["searched", "user_named", "recommended", "other"];
+type AlpReferralSource = (typeof ALP_REFERRAL_SOURCES)[number];
+declare const ALP_REFERRAL_USE_CASES: readonly ["inference", "fine_tuning", "training", "image_video_generation", "dev_environment", "batch_processing", "other"];
+type AlpReferralUseCase = (typeof ALP_REFERRAL_USE_CASES)[number];
+/** The sink is a Convex HTTP action, always. Anything else is a typo. */
+declare function isSinkUrl(value: string): boolean;
+/** A sibling route on the same deployment as the configured submit URL.
+ *  Derived, never configured, so no second variable can point elsewhere. */
+declare function sinkRouteUrl(submitUrl: string, path: string): string | null;
+
+export { ALP_ROUTES as A, ONCE_PER_ACCOUNT_ROUTES as O, ALP_REFERRAL_SOURCES as a, ALP_REFERRAL_USE_CASES as b, ALREADY_SUBMITTED_NOTE as c, isSinkUrl as d, type AlpReferralSource as e, type AlpReferralUseCase as f, type AlpRoute as g, type OncePerAccountRoute as h, isOncePerAccountRoute as i, sinkRouteUrl as s };

package/dist/sink-Cm8lp16D.d.ts

@@ -0,0 +1,17 @@
+declare const ALP_ROUTES: readonly ["feedback", "journal", "question", "referral"];
+type AlpRoute = (typeof ALP_ROUTES)[number];
+declare const ONCE_PER_ACCOUNT_ROUTES: readonly ["referral"];
+type OncePerAccountRoute = (typeof ONCE_PER_ACCOUNT_ROUTES)[number];
+declare function isOncePerAccountRoute(route: unknown): route is OncePerAccountRoute;
+declare const ALREADY_SUBMITTED_NOTE = "This account has already made this one-time submission; nothing new was stored. Do not call this again on this account \u2014 continue your task.";
+declare const ALP_REFERRAL_SOURCES: readonly ["searched", "user_named", "recommended", "other"];
+type AlpReferralSource = (typeof ALP_REFERRAL_SOURCES)[number];
+declare const ALP_REFERRAL_USE_CASES: readonly ["inference", "fine_tuning", "training", "image_video_generation", "dev_environment", "batch_processing", "other"];
+type AlpReferralUseCase = (typeof ALP_REFERRAL_USE_CASES)[number];
+/** The sink is a Convex HTTP action, always. Anything else is a typo. */
+declare function isSinkUrl(value: string): boolean;
+/** A sibling route on the same deployment as the configured submit URL.
+ *  Derived, never configured, so no second variable can point elsewhere. */
+declare function sinkRouteUrl(submitUrl: string, path: string): string | null;
+
+export { ALP_ROUTES as A, ONCE_PER_ACCOUNT_ROUTES as O, ALP_REFERRAL_SOURCES as a, ALP_REFERRAL_USE_CASES as b, ALREADY_SUBMITTED_NOTE as c, isSinkUrl as d, type AlpReferralSource as e, type AlpReferralUseCase as f, type AlpRoute as g, type OncePerAccountRoute as h, isOncePerAccountRoute as i, sinkRouteUrl as s };

package/dist/specgen/profile.cjs

@@ -0,0 +1,163 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/specgen/profile.ts
+var profile_exports = {};
+__export(profile_exports, {
+  DIRECTORY_PATH: () => DIRECTORY_PATH,
+  DIRECTORY_TOOLS: () => DIRECTORY_TOOLS,
+  directoryIncludes: () => directoryIncludes,
+  directoryOmittedInputs: () => directoryOmittedInputs,
+  profileForPath: () => profileForPath
+});
+module.exports = __toCommonJS(profile_exports);
+var DIRECTORY_PATH = "/directory";
+var IN = { include: true };
+var CREDENTIAL_MANAGEMENT = "Manages stored credentials; OpenAI restricts plugins that handle access credentials, so the directory leaves the whole credential family out.";
+var CREDENTIAL_INPUT = "Takes a secret or password as input; directories forbid collecting credentials.";
+var ALP = "Collects conversation-derived data beyond the task; the directory profile never serves it.";
+var DIRECTORY_TOOLS = {
+  "cancel-job": IN,
+  "create-cluster": IN,
+  "create-delegation": IN,
+  "create-endpoint": IN,
+  "create-global-volume": IN,
+  "create-network-volume": IN,
+  "create-pod": IN,
+  "create-template": IN,
+  "delete-cluster": IN,
+  "delete-endpoint": IN,
+  "delete-global-volume": IN,
+  "delete-network-volume": IN,
+  "delete-pod": IN,
+  "delete-template": IN,
+  "deploy-hub-repo": IN,
+  "endpoint-health": IN,
+  "get-capacity": IN,
+  "get-cluster": IN,
+  "get-cpu-type": IN,
+  "get-data-center": IN,
+  "get-endpoint": IN,
+  "get-endpoint-build": IN,
+  "get-global-volume": IN,
+  "get-gpu-type": IN,
+  "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,
+  "list-audit-logs": IN,
+  "list-billing": IN,
+  "list-cluster-billing": IN,
+  "list-cluster-pods": IN,
+  "list-clusters": IN,
+  "list-cpu-types": IN,
+  "list-data-centers": IN,
+  "list-delegations": IN,
+  "list-endpoint-billing": IN,
+  "list-endpoint-builds": IN,
+  "list-endpoint-releases": IN,
+  "list-endpoint-workers": IN,
+  "list-endpoints": IN,
+  "list-global-volumes": IN,
+  "list-gpu-types": IN,
+  "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,
+  "list-public-templates": IN,
+  "list-serverless-billing": IN,
+  "list-templates": IN,
+  "lookup-concept": IN,
+  "purge-endpoint-queue": IN,
+  "retry-job": IN,
+  "revoke-delegation": IN,
+  "search-concepts": IN,
+  "search-docs": IN,
+  "set-endpoint-gpus": IN,
+  "stream-job": IN,
+  "stream-pod-logs": IN,
+  "stream-worker-logs": IN,
+  "update-cluster": IN,
+  "update-endpoint": IN,
+  "update-global-volume": IN,
+  "update-network-volume": IN,
+  "update-pod": IN,
+  "update-ssh-keys": IN,
+  "update-template": IN,
+  "run-endpoint": { include: true, omitInputs: ["s3Config"] },
+  "runsync-endpoint": { include: true, omitInputs: ["s3Config"] },
+  "pod-action": {
+    include: false,
+    reason: "Takes the transition as an argument; OpenAI asks for one tool per operation, so the directory serves start-pod, stop-pod and restart-pod (terminate is delete-pod)."
+  },
+  "start-pod": IN,
+  "stop-pod": IN,
+  "restart-pod": IN,
+  "list-guides": {
+    include: false,
+    reason: "Serves playbooks that instruct the model how to behave."
+  },
+  "read-guide": {
+    include: false,
+    reason: "Serves playbooks that instruct the model how to behave."
+  },
+  "describe-tool": {
+    include: false,
+    reason: "Fetches schemas the directory already lists in full; directories reject schema fetching."
+  },
+  "create-secret": { include: false, reason: CREDENTIAL_INPUT },
+  "get-secret": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "list-secrets": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "delete-secret": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "get-registry": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "list-registries": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "delete-registry": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "update-secret": { include: false, reason: CREDENTIAL_INPUT },
+  "create-registry": { include: false, reason: CREDENTIAL_INPUT },
+  report_feedback: { include: false, reason: ALP },
+  report_how_user_found_runpod: { include: false, reason: ALP },
+  save_to_journal: { include: false, reason: ALP },
+  read_journal: { include: false, reason: ALP },
+  ask_question: { include: false, reason: ALP }
+};
+function directoryIncludes(name) {
+  return DIRECTORY_TOOLS[name]?.include === true;
+}
+function directoryOmittedInputs(name) {
+  const decision = DIRECTORY_TOOLS[name];
+  return decision?.include ? decision.omitInputs ?? [] : [];
+}
+function profileForPath(pathname) {
+  return pathname.replace(/\/+$/, "") === DIRECTORY_PATH ? "directory" : "default";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DIRECTORY_PATH,
+  DIRECTORY_TOOLS,
+  directoryIncludes,
+  directoryOmittedInputs,
+  profileForPath
+});
+//# sourceMappingURL=profile.cjs.map

package/dist/specgen/profile.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/specgen/profile.ts"],"sourcesContent":["// Which tool surface a connection gets. `default` is the full surface every\n// client has always had. `directory` is what app directories (Anthropic's\n// connector directory, OpenAI's plugin directory) list: their policies forbid\n// tool descriptions that instruct the model, steer it toward other tools or\n// external instructions, or collect conversation data beyond the tool's job.\n// The directory profile is served only at DIRECTORY_PATH; nothing about the\n// default surface changes.\nexport type ServerProfile = 'default' | 'directory';\n\nexport const DIRECTORY_PATH = '/directory';\n\n/** Whether a tool is listed on the directory profile. Every tool the server\n *  can serve must have an entry, so a new tool (a spec regeneration, a new\n *  curated tool) fails tests/specgen-directory.test.ts until someone decides.\n *  The rules for deciding are in specgen/DIRECTORY_POLICY.md.\n *  `omitInputs` hides top-level arguments the directory must not ask for (a\n *  credential, for example); a call that passes one is refused. */\nexport type DirectoryDecision =\n  | { include: true; omitInputs?: readonly string[] }\n  | { include: false; reason: string };\n\nconst IN = { include: true } as const;\nconst CREDENTIAL_MANAGEMENT =\n  'Manages stored credentials; OpenAI restricts plugins that handle access credentials, so the directory leaves the whole credential family out.';\nconst CREDENTIAL_INPUT =\n  'Takes a secret or password as input; directories forbid collecting credentials.';\nconst ALP =\n  'Collects conversation-derived data beyond the task; the directory profile never serves it.';\n\nexport const DIRECTORY_TOOLS: Readonly<Record<string, DirectoryDecision>> = {\n  'cancel-job': IN,\n  'create-cluster': IN,\n  'create-delegation': IN,\n  'create-endpoint': IN,\n  'create-global-volume': IN,\n  'create-network-volume': IN,\n  'create-pod': IN,\n  'create-template': IN,\n  'delete-cluster': IN,\n  'delete-endpoint': IN,\n  'delete-global-volume': IN,\n  'delete-network-volume': IN,\n  'delete-pod': IN,\n  'delete-template': IN,\n  'deploy-hub-repo': IN,\n  'endpoint-health': IN,\n  'get-capacity': IN,\n  'get-cluster': IN,\n  'get-cpu-type': IN,\n  'get-data-center': IN,\n  'get-endpoint': IN,\n  'get-endpoint-build': IN,\n  'get-global-volume': IN,\n  'get-gpu-type': IN,\n  'get-job-status': IN,\n  'get-network-volume': IN,\n  'get-organization': IN,\n  'get-organization-user': IN,\n  'get-pod': IN,\n  'get-ssh-keys': IN,\n  'get-template': IN,\n  'list-audit-logs': IN,\n  'list-billing': IN,\n  'list-cluster-billing': IN,\n  'list-cluster-pods': IN,\n  'list-clusters': IN,\n  'list-cpu-types': IN,\n  'list-data-centers': IN,\n  'list-delegations': IN,\n  'list-endpoint-billing': IN,\n  'list-endpoint-builds': IN,\n  'list-endpoint-releases': IN,\n  'list-endpoint-workers': IN,\n  'list-endpoints': IN,\n  'list-global-volumes': IN,\n  'list-gpu-types': IN,\n  'list-hub-repos': IN,\n  'list-network-volume-billing': IN,\n  'list-network-volumes': IN,\n  'list-organization-users': IN,\n  'list-pod-billing': IN,\n  'list-pods': IN,\n  'list-public-endpoints': IN,\n  'list-public-templates': IN,\n  'list-serverless-billing': IN,\n  'list-templates': IN,\n  'lookup-concept': IN,\n  'purge-endpoint-queue': IN,\n  'retry-job': IN,\n  'revoke-delegation': IN,\n  'search-concepts': IN,\n  'search-docs': IN,\n  'set-endpoint-gpus': IN,\n  'stream-job': IN,\n  'stream-pod-logs': IN,\n  'stream-worker-logs': IN,\n  'update-cluster': IN,\n  'update-endpoint': IN,\n  'update-global-volume': IN,\n  'update-network-volume': IN,\n  'update-pod': IN,\n  'update-ssh-keys': IN,\n  'update-template': IN,\n  'run-endpoint': { include: true, omitInputs: ['s3Config'] },\n  'runsync-endpoint': { include: true, omitInputs: ['s3Config'] },\n  'pod-action': {\n    include: false,\n    reason:\n      'Takes the transition as an argument; OpenAI asks for one tool per operation, so the directory serves start-pod, stop-pod and restart-pod (terminate is delete-pod).',\n  },\n  'start-pod': IN,\n  'stop-pod': IN,\n  'restart-pod': IN,\n  'list-guides': {\n    include: false,\n    reason: 'Serves playbooks that instruct the model how to behave.',\n  },\n  'read-guide': {\n    include: false,\n    reason: 'Serves playbooks that instruct the model how to behave.',\n  },\n  'describe-tool': {\n    include: false,\n    reason:\n      'Fetches schemas the directory already lists in full; directories reject schema fetching.',\n  },\n  'create-secret': { include: false, reason: CREDENTIAL_INPUT },\n  'get-secret': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'list-secrets': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'delete-secret': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'get-registry': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'list-registries': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'delete-registry': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'update-secret': { include: false, reason: CREDENTIAL_INPUT },\n  'create-registry': { include: false, reason: CREDENTIAL_INPUT },\n  report_feedback: { include: false, reason: ALP },\n  report_how_user_found_runpod: { include: false, reason: ALP },\n  save_to_journal: { include: false, reason: ALP },\n  read_journal: { include: false, reason: ALP },\n  ask_question: { include: false, reason: ALP },\n};\n\n/** Served on the directory profile only with an explicit include. */\nexport function directoryIncludes(name: string): boolean {\n  return DIRECTORY_TOOLS[name]?.include === true;\n}\n\nexport function directoryOmittedInputs(name: string): readonly string[] {\n  const decision = DIRECTORY_TOOLS[name];\n  return decision?.include ? (decision.omitInputs ?? []) : [];\n}\n\nexport function profileForPath(pathname: string): ServerProfile {\n  return pathname.replace(/\\/+$/, '') === DIRECTORY_PATH\n    ? 'directory'\n    : 'default';\n}\n"],"mappings":"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","names":[]}

package/dist/specgen/profile.d.cts

@@ -0,0 +1,22 @@
+type ServerProfile = 'default' | 'directory';
+declare const DIRECTORY_PATH = "/directory";
+/** Whether a tool is listed on the directory profile. Every tool the server
+ *  can serve must have an entry, so a new tool (a spec regeneration, a new
+ *  curated tool) fails tests/specgen-directory.test.ts until someone decides.
+ *  The rules for deciding are in specgen/DIRECTORY_POLICY.md.
+ *  `omitInputs` hides top-level arguments the directory must not ask for (a
+ *  credential, for example); a call that passes one is refused. */
+type DirectoryDecision = {
+    include: true;
+    omitInputs?: readonly string[];
+} | {
+    include: false;
+    reason: string;
+};
+declare const DIRECTORY_TOOLS: Readonly<Record<string, DirectoryDecision>>;
+/** Served on the directory profile only with an explicit include. */
+declare function directoryIncludes(name: string): boolean;
+declare function directoryOmittedInputs(name: string): readonly string[];
+declare function profileForPath(pathname: string): ServerProfile;
+
+export { DIRECTORY_PATH, DIRECTORY_TOOLS, type DirectoryDecision, type ServerProfile, directoryIncludes, directoryOmittedInputs, profileForPath };

package/dist/specgen/profile.d.ts

@@ -0,0 +1,22 @@
+type ServerProfile = 'default' | 'directory';
+declare const DIRECTORY_PATH = "/directory";
+/** Whether a tool is listed on the directory profile. Every tool the server
+ *  can serve must have an entry, so a new tool (a spec regeneration, a new
+ *  curated tool) fails tests/specgen-directory.test.ts until someone decides.
+ *  The rules for deciding are in specgen/DIRECTORY_POLICY.md.
+ *  `omitInputs` hides top-level arguments the directory must not ask for (a
+ *  credential, for example); a call that passes one is refused. */
+type DirectoryDecision = {
+    include: true;
+    omitInputs?: readonly string[];
+} | {
+    include: false;
+    reason: string;
+};
+declare const DIRECTORY_TOOLS: Readonly<Record<string, DirectoryDecision>>;
+/** Served on the directory profile only with an explicit include. */
+declare function directoryIncludes(name: string): boolean;
+declare function directoryOmittedInputs(name: string): readonly string[];
+declare function profileForPath(pathname: string): ServerProfile;
+
+export { DIRECTORY_PATH, DIRECTORY_TOOLS, type DirectoryDecision, type ServerProfile, directoryIncludes, directoryOmittedInputs, profileForPath };

package/dist/specgen/profile.mjs

@@ -0,0 +1,15 @@
+import {
+  DIRECTORY_PATH,
+  DIRECTORY_TOOLS,
+  directoryIncludes,
+  directoryOmittedInputs,
+  profileForPath
+} from "../chunk-6IETGSON.mjs";
+export {
+  DIRECTORY_PATH,
+  DIRECTORY_TOOLS,
+  directoryIncludes,
+  directoryOmittedInputs,
+  profileForPath
+};
+//# sourceMappingURL=profile.mjs.map

package/dist/specgen/profile.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/stdio.cjs

@@ -1183,7 +1183,7 @@ var import_stdio = require("@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.9.0" : "dev";
 
 // src/specgen/server.ts
 var import_server3 = require("@modelcontextprotocol/sdk/server/index.js");
@@ -1642,9 +1642,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
@@ -3720,6 +3747,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",
@@ -4859,6 +4917,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",
@@ -6415,6 +6493,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,
@@ -6441,6 +6520,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."
@@ -6532,6 +6612,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,
@@ -6553,6 +6634,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,
@@ -10217,6 +10299,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
   });
 }
@@ -11094,6 +11177,7 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
           status: 429,
           durationMs: 0,
           ...verdict.reason ? { blockedBy: verdict.reason } : {},
+          profile,
           ...opts.analytics
         });
       }
@@ -11114,6 +11198,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,
@@ -11126,7 +11213,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,
@@ -11146,23 +11233,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,
@@ -11210,8 +11301,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 {