@uipath/agenthub-tool 1.198.0 → 1.199.0-preview.104

package/dist/tool.js

@@ -3134,6 +3134,9 @@ function classifyError(status, error) {
   if (status === 405) {
     return { errorCode: "method_not_allowed", retry: "RetryWillNotFix" };
   }
+  if (status === 413) {
+    return { errorCode: "invalid_argument", retry: "RetryWillNotFix" };
+  }
   if (status === 408) {
     return { errorCode: "timeout", retry: "RetryLater" };
   }
@@ -3211,6 +3214,8 @@ async function extractErrorDetails(error, options) {
     result = "AuthenticationError";
   } else if (status === 405) {
     message = DEFAULT_405;
+  } else if (status === 413) {
+    message = DEFAULT_413;
   } else if (status === 400 || status === 422) {
     message = formatHttpStatusMessage(status, rawMessage, extractedMessage, inferredStatus);
     result = "ValidationError";
@@ -3333,7 +3338,7 @@ async function extractErrorMessage(error, options) {
   const { message } = await extractErrorDetails(error, options);
   return message;
 }
-var DEFAULT_401 = "Unauthorized (401). Run `uip login` to authenticate.", DEFAULT_403 = "Forbidden (403). Ensure the account has the required permissions.", DEFAULT_405 = "Method Not Allowed (405). The endpoint may not exist or the base URL may be incorrect.", HTML_RESPONSE_MESSAGE = "Received HTML instead of the expected JSON response.", NETWORK_ERROR_CODES, TLS_ERROR_CODES, TLS_INSTRUCTIONS, NETWORK_INSTRUCTIONS;
+var DEFAULT_401 = "Unauthorized (401). Run `uip login` to authenticate.", DEFAULT_403 = "Forbidden (403). Ensure the account has the required permissions.", DEFAULT_405 = "Method Not Allowed (405). The endpoint may not exist or the base URL may be incorrect.", DEFAULT_413 = "Payload too large (413). The upload exceeded the server or CDN size limit. Reduce the package size — for example, exclude unused dependencies or remove large files from the project — and try again.", HTML_RESPONSE_MESSAGE = "Received HTML instead of the expected JSON response.", NETWORK_ERROR_CODES, TLS_ERROR_CODES, TLS_INSTRUCTIONS, NETWORK_INSTRUCTIONS;
 var init_error_handler = __esm(() => {
   NETWORK_ERROR_CODES = new Set([
     "ECONNREFUSED",
@@ -3365,7 +3370,6 @@ var init_attachment_binding = __esm(() => {
   init_src2();
   init_error_handler();
 });
-
 // ../common/src/command-examples.ts
 var examplesByCommand;
 var init_command_examples = __esm(() => {
@@ -10203,6 +10207,7 @@ var init_command_attribution = __esm(() => {
   KNOWN_SKILL_NAMES = new Set(Object.keys(SKILL_ATTRIBUTION));
   COMMAND_ATTRIBUTION = commandAttribution([
     ["cli", "troubleshoot", ["uip.feedback"]],
+    ["llm-gateway", "operate", ["uip.llm-gateway"]],
     ["llm-gateway", "operate", ["uip.llm-configuration", "uip.model-hub"]],
     ["context-grounding", "build", ["uip.context-grounding"]],
     ["api-workflow", "build", ["uip.api-workflow"]],
@@ -11011,7 +11016,7 @@ var init_package = __esm(() => {
   package_default3 = {
     name: "@uipath/orchestrator-sdk",
     license: "MIT",
-    version: "1.198.0",
+    version: "1.199.0",
     repository: {
       type: "git",
       url: "https://github.com/UiPath/cli.git",
@@ -45540,6 +45545,7 @@ var DEFAULT_CLIENT_ID2 = "36dea5b8-e8bb-423d-8e7b-c808df8f1c00", AUTH_FILE_CONFI
   customAuthority,
   customClientId,
   customClientSecret,
+  customClientAssertion,
   customScopes
 } = {}) => {
   const fileAuth = getAuthFileConfig2();
@@ -45565,7 +45571,7 @@ var DEFAULT_CLIENT_ID2 = "36dea5b8-e8bb-423d-8e7b-c808df8f1c00", AUTH_FILE_CONFI
   if (!clientSecret && fileAuth.clientSecret) {
     clientSecret = fileAuth.clientSecret;
   }
-  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID2 && Boolean(clientSecret);
+  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID2 && (Boolean(clientSecret) || Boolean(customClientAssertion));
   const scopes = resolveScopes2(isExternalAppAuth, customScopes, fileAuth.scopes);
   return {
     clientId,
@@ -64909,9 +64915,19 @@ var init_authContext = __esm(() => {
   init_loginStatus();
 });
 
+// ../auth/src/tokenGrant.ts
+var init_tokenGrant = () => {};
+
 // ../auth/src/clientCredentials.ts
 var init_clientCredentials = __esm(() => {
   init_config();
+  init_tokenGrant();
+});
+
+// ../auth/src/federatedCredentials.ts
+var init_federatedCredentials = __esm(() => {
+  init_config();
+  init_tokenGrant();
 });
 // ../auth/src/selectTenant.ts
 var TENANT_SELECTION_REQUIRED_CODE2 = "TENANT_SELECTION_REQUIRED", INVALID_TENANT_CODE2 = "INVALID_TENANT", TENANT_SELECTION_CODES2;
@@ -64926,6 +64942,7 @@ var init_interactive = __esm(() => {
   init_src2();
   init_clientCredentials();
   init_config();
+  init_federatedCredentials();
   init_src5();
   init_selectTenant();
   init_envFile();
@@ -64952,6 +64969,7 @@ var init_src5 = __esm(() => {
   init_config();
   init_constants3();
   init_envAuth();
+  init_federatedCredentials();
   init_refreshCircuitBreaker();
   init_selectTenant();
   init_server2();
@@ -67629,7 +67647,7 @@ init_esm();
 var package_default = {
   name: "@uipath/agenthub-tool",
   license: "MIT",
-  version: "1.198.0",
+  version: "1.199.0-preview.104",
   description: "Manage UiPath AgentHub MCP server registrations, tools, and remote A2A agents.",
   private: false,
   repository: {
@@ -67664,6 +67682,7 @@ var package_default = {
   },
   devDependencies: {
     "@uipath/agenthub-sdk": "workspace:*",
+    "@uipath/auth": "workspace:*",
     "@uipath/common": "workspace:*",
     "@uipath/filesystem": "workspace:*",
     "@uipath/integrationservice-sdk": "workspace:*",
@@ -86766,7 +86785,7 @@ class VoidApiResponse {
 var package_default2 = {
   name: "@uipath/agenthub-sdk",
   license: "MIT",
-  version: "1.198.0",
+  version: "1.199.0",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -87942,6 +87961,7 @@ var resolveConfigAsync = async ({
   customAuthority,
   customClientId,
   customClientSecret,
+  customClientAssertion,
   customScopes
 } = {}) => {
   const fileAuth = getAuthFileConfig();
@@ -87967,7 +87987,7 @@ var resolveConfigAsync = async ({
   if (!clientSecret && fileAuth.clientSecret) {
     clientSecret = fileAuth.clientSecret;
   }
-  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID && Boolean(clientSecret);
+  const isExternalAppAuth = clientId !== DEFAULT_CLIENT_ID && (Boolean(clientSecret) || Boolean(customClientAssertion));
   const scopes = resolveScopes(isExternalAppAuth, customScopes, fileAuth.scopes);
   return {
     clientId,
@@ -90330,6 +90350,7 @@ var CREATE_EXAMPLES_BY_TYPE = {
 };
 
 // src/commands/mcp-tools.ts
+init_src5();
 init_src3();
 
 // ../integrationservice-sdk/src/user-agent.ts
@@ -90865,7 +90886,7 @@ class TextApiResponse2 {
 var package_default4 = {
   name: "@uipath/integrationservice-sdk",
   license: "MIT",
-  version: "1.198.0",
+  version: "1.199.0-preview.104",
   repository: {
     type: "git",
     url: "https://github.com/UiPath/cli.git",
@@ -97421,7 +97442,7 @@ class JSONApiResponse5 {
 var package_default5 = {
   name: "@uipath/resourcecatalog-sdk",
   license: "MIT",
-  version: "1.198.0",
+  version: "1.199.0",
   description: "SDK for the UiPath Resource Catalog Service API.",
   repository: {
     type: "git",
@@ -98144,6 +98165,35 @@ var ALL_CANDIDATE_CATEGORIES = [
   "is-activity"
 ];
 var PROCESS_TYPE_API = "Api";
+var isIsActivityToolPayload = (payload) => Number(payload.type) === 1 && typeof payload.processType === "string" && payload.processType.toLowerCase() === PROCESS_TYPE_API.toLowerCase();
+var IS_ACTIVITY_UNAVAILABLE_HOSTS = new Set([
+  "cloud.uipath.com"
+]);
+var assertIsActivityAvailable = async (options, code) => {
+  if (options.force)
+    return true;
+  const [authError, ctx] = await catchError2(getAuthContext2({
+    tenant: options.tenant,
+    ensureTokenValidityMinutes: options.loginValidity
+  }));
+  if (authError) {
+    await emitError(code, authError);
+    return false;
+  }
+  let host;
+  try {
+    host = new URL(ctx?.baseUrl ?? "").hostname.toLowerCase();
+  } catch {
+    return true;
+  }
+  if (!IS_ACTIVITY_UNAVAILABLE_HOSTS.has(host))
+    return true;
+  await emitError(code, new Error(`IS-activity MCP tools are not yet available on ${host} — the feature is rolling out and is currently enabled on alpha/staging only.`), {
+    Reason: "IsActivityNotAvailable",
+    Hint: "Author the tool as create-resource or create-raw instead, or use an alpha/staging tenant. " + "If this tenant is enrolled in the rollout, re-run with --force."
+  });
+  return false;
+};
 var validateIsActivityMapping = (metadataRaw) => {
   let metadata;
   if (typeof metadataRaw === "string") {
@@ -98539,7 +98589,7 @@ var registerMcpToolsCommand = (parent) => {
       Data: options.allowMultiple ? matches : matches[0]
     });
   });
-  const resolveTargetByName = async (targetName, category, options) => {
+  const resolveTargetByName = async (targetName, category, options, explicitTargetFolderKey) => {
     if (!category) {
       const error = new Error("--target-name requires --category to scope the RCS lookup. Pass --category automation|agent|agentic-process|api-workflow.");
       error.code = "MissingCategory";
@@ -98560,8 +98610,8 @@ var registerMcpToolsCommand = (parent) => {
       name: targetName,
       entityTypes: [...filterDef.entityTypes],
       entitySubType: [...filterDef.entitySubType],
-      xUIPATHFolderKey: options.folderKey,
-      xUIPATHFolderPath: options.folderPath
+      xUIPATHFolderKey: explicitTargetFolderKey ?? options.folderKey,
+      xUIPATHFolderPath: explicitTargetFolderKey ? undefined : options.folderPath
     });
     const entities = result?.value ?? [];
     const exact = entities.filter((e) => e.name === targetName);
@@ -98596,7 +98646,44 @@ var registerMcpToolsCommand = (parent) => {
       targetFolderKey: folderKey
     };
   };
-  const resolveIsActivityByName = async (targetName, category, options) => {
+  const listConnectorConnections = async (category, options) => {
+    const connectionsApi = await createApiClient3(ConnectionsApi, {
+      tenant: options.tenant,
+      loginValidity: options.loginValidity
+    });
+    const pageSize = 100;
+    const maxPages = 20;
+    const seen = new Set;
+    const rows = [];
+    for (let pageIndex = 0;pageIndex < maxPages; pageIndex++) {
+      const batch = await connectionsApi.apiV1ConnectionsGet({
+        allFolders: true,
+        pageSize,
+        pageIndex
+      });
+      const items = batch ?? [];
+      let added = 0;
+      for (const c of items) {
+        const id = c.id ?? "";
+        if (!id || seen.has(id))
+          continue;
+        seen.add(id);
+        added++;
+        const matchesConnector = c?.connector?.key === category || c?.elementInstance?.key === category;
+        if (matchesConnector) {
+          rows.push({
+            id,
+            name: c.name ?? "",
+            folder: c.folder?.key ?? ""
+          });
+        }
+      }
+      if (items.length < pageSize || added === 0)
+        break;
+    }
+    return rows;
+  };
+  const resolveIsActivityByName = async (targetName, category, options, explicitTargetFolderKey) => {
     if (!category) {
       const error = new Error("--target-name on is-activity requires --category <connector-key> to scope the IS connector. Discover via `uip is connectors list`.");
       error.code = "MissingCategory";
@@ -98606,15 +98693,43 @@ var registerMcpToolsCommand = (parent) => {
       tenant: options.tenant,
       loginValidity: options.loginValidity
     });
-    const connection = await api.apiV1ConnectorsKeyOrIdConnectionGet({
+    const [defaultConnError, defaultConnection] = await catchError2(api.apiV1ConnectorsKeyOrIdConnectionGet({
       keyOrId: category
-    });
+    }));
+    if (defaultConnError && explicitTargetFolderKey === undefined) {
+      throw defaultConnError;
+    }
+    const connection = defaultConnError ? undefined : defaultConnection;
+    const folderKey = connection?.folder?.key ?? "";
+    if (explicitTargetFolderKey !== undefined) {
+      if (connection?.id && folderKey.toLowerCase() === explicitTargetFolderKey.toLowerCase()) {
+        return {
+          targetIdentifier: connection.id,
+          targetFolderKey: folderKey
+        };
+      }
+      let candidates = [];
+      try {
+        candidates = await listConnectorConnections(category, options);
+      } catch {}
+      const inFolder = candidates.filter((c) => c.folder.toLowerCase() === explicitTargetFolderKey.toLowerCase());
+      if (inFolder.length === 1) {
+        return {
+          targetIdentifier: inFolder[0].id,
+          targetFolderKey: explicitTargetFolderKey
+        };
+      }
+      const defaultNote = connection?.id ? `; the default connection '${connection.name ?? connection.id}' lives in folder ${folderKey || "unknown"}` : "; the connector has no default connection";
+      const error = new Error(inFolder.length === 0 ? `No connection for connector '${category}' lives in target folder ${explicitTargetFolderKey}${defaultNote}. Create a connection in that folder or pass --target-identifier <conn-guid> explicitly.` : `Found ${inFolder.length} connections for connector '${category}' in target folder ${explicitTargetFolderKey}. Pass --target-identifier <conn-guid> to pick one.`);
+      error.code = inFolder.length === 0 ? "TargetFolderMismatch" : "AmbiguousConnection";
+      error.candidates = inFolder.length > 0 ? inFolder : candidates;
+      throw error;
+    }
     if (!connection?.id) {
       const error = new Error(`No default connection found for connector '${category}' (activity '${targetName}'). Create one via \`uip is connections create '${category}'\` or pass --target-identifier <connection-guid> explicitly.`);
       error.code = "NoDefaultConnection";
       throw error;
     }
-    const folderKey = connection.folder?.key ?? "";
     if (!folderKey) {
       const error = new Error(`Default connection '${connection.name ?? connection.id}' for connector '${category}' has no folder key. Use --folder-* to set the MCP server folder.`);
       error.code = "MissingFolderKey";
@@ -98626,19 +98741,7 @@ var registerMcpToolsCommand = (parent) => {
     if (serverFolderKey && folderKey.toLowerCase() !== serverFolderKey.toLowerCase()) {
       let candidates = [];
       try {
-        const connectionsApi = await createApiClient3(ConnectionsApi, {
-          tenant: options.tenant,
-          loginValidity: options.loginValidity
-        });
-        const all = await connectionsApi.apiV1ConnectionsGet({
-          allFolders: true,
-          pageSize: 100
-        });
-        candidates = (all ?? []).filter((c) => c?.connector?.key === category || c?.elementInstance?.key === category).map((c) => ({
-          id: c.id ?? "",
-          name: c.name ?? "",
-          folder: c.folder?.key ?? ""
-        }));
+        candidates = await listConnectorConnections(category, options);
       } catch {}
       const error = new Error(`Default connection '${connection.name ?? connection.id}' lives in folder ${folderKey}; MCP server folder is ${serverFolderKey}. Pick a connection in the server's folder or pass --target-identifier <conn-guid> explicitly.`);
       error.code = "CrossFolderConnection";
@@ -98658,10 +98761,23 @@ var registerMcpToolsCommand = (parent) => {
     }
     return;
   };
+  const resolveExplicitTargetFolderKey = async (options) => {
+    if (options.targetFolderKey !== undefined)
+      return options.targetFolderKey;
+    if (options.targetFolderPath !== undefined) {
+      return await resolveFolderNameToGuid(options.targetFolderPath, options);
+    }
+    return;
+  };
   const validateFolderInputsForTool = async (options, code) => {
     try {
       chooseFolderInput({ key: options.folderKey, path: options.folderPath }, "folder");
       assertFolderKeyIsGuid(options.folderKey, "folder");
+      chooseFolderInput({
+        key: options.targetFolderKey,
+        path: options.targetFolderPath
+      }, "target-folder");
+      assertFolderKeyIsGuid(options.targetFolderKey, "target-folder");
     } catch (error) {
       const errCode = error.code;
       await emitError(code, error, errCode ? { Reason: errCode } : {});
@@ -98670,17 +98786,24 @@ var registerMcpToolsCommand = (parent) => {
     return true;
   };
   const createTool = async (kind, options) => {
+    if (kind === "is-activity" && !await assertIsActivityAvailable(options, OUTPUT_CODES2.Create))
+      return;
     if (!await validateFolderInputsForTool(options, OUTPUT_CODES2.Create))
       return;
     if (!await requireParentType(options.mcp, "uipath", options, OUTPUT_CODES2.Create))
       return;
+    const [targetFolderError, explicitTargetFolderKey] = await catchError2(resolveExplicitTargetFolderKey(options));
+    if (targetFolderError) {
+      const code = targetFolderError.code;
+      return await emitError(OUTPUT_CODES2.Create, targetFolderError, code ? { Reason: code } : {});
+    }
     let resolvedIdentifier = options.targetIdentifier;
     let resolvedFolderKey;
     if (kind === "resource" && options.targetName && !options.targetIdentifier) {
       try {
-        const resolved = await resolveTargetByName(options.targetName, options.category, options);
+        const resolved = await resolveTargetByName(options.targetName, options.category, options, explicitTargetFolderKey);
         resolvedIdentifier = resolved.targetIdentifier;
-        resolvedFolderKey = resolvedFolderKey ?? resolved.targetFolderKey;
+        resolvedFolderKey = explicitTargetFolderKey ?? resolved.targetFolderKey;
       } catch (resolveError) {
         const code = resolveError.code;
         const candidates = resolveError.candidates;
@@ -98693,9 +98816,9 @@ var registerMcpToolsCommand = (parent) => {
     }
     if (kind === "is-activity" && options.targetName && !options.targetIdentifier) {
       try {
-        const resolved = await resolveIsActivityByName(options.targetName, options.category, options);
+        const resolved = await resolveIsActivityByName(options.targetName, options.category, options, explicitTargetFolderKey);
         resolvedIdentifier = resolved.targetIdentifier;
-        resolvedFolderKey = resolvedFolderKey ?? resolved.targetFolderKey;
+        resolvedFolderKey = resolved.targetFolderKey;
       } catch (resolveError) {
         const code = resolveError.code;
         const candidates = resolveError.candidates;
@@ -98706,12 +98829,16 @@ var registerMcpToolsCommand = (parent) => {
       }
     }
     if (kind !== "raw" && !resolvedFolderKey) {
-      const [serverFolderError, serverFolderKey] = await catchError2(resolveServerFolderKey(options));
-      if (serverFolderError) {
-        const code = serverFolderError.code;
-        return await emitError(OUTPUT_CODES2.Create, serverFolderError, code ? { Reason: code } : {});
+      if (explicitTargetFolderKey !== undefined) {
+        resolvedFolderKey = explicitTargetFolderKey;
+      } else {
+        const [serverFolderError, serverFolderKey] = await catchError2(resolveServerFolderKey(options));
+        if (serverFolderError) {
+          const code = serverFolderError.code;
+          return await emitError(OUTPUT_CODES2.Create, serverFolderError, code ? { Reason: code } : {});
+        }
+        resolvedFolderKey = serverFolderKey;
       }
-      resolvedFolderKey = serverFolderKey;
     }
     const scalar = kind === "raw" ? {} : {
       type: kind === "is-activity" ? 1 : 0,
@@ -98732,7 +98859,12 @@ var registerMcpToolsCommand = (parent) => {
     if (validateError)
       return await emitError(OUTPUT_CODES2.Create, validateError);
     const payloadObj = payload;
-    const isIsActivityPayload = kind === "is-activity" || kind === "raw" && payloadObj.type === 1 && typeof payloadObj.processType === "string" && payloadObj.processType.toLowerCase() === PROCESS_TYPE_API.toLowerCase();
+    if (explicitTargetFolderKey !== undefined && (options.file || options.body || kind === "raw")) {
+      payloadObj.targetFolderKey = explicitTargetFolderKey;
+    }
+    const isIsActivityPayload = kind === "is-activity" || isIsActivityToolPayload(payloadObj);
+    if (kind !== "is-activity" && isIsActivityPayload && !await assertIsActivityAvailable(options, OUTPUT_CODES2.Create))
+      return;
     if (isIsActivityPayload) {
       const [mappingError] = await catchError2(Promise.resolve().then(() => validateIsActivityMapping(payloadObj.metadata)));
       if (mappingError) {
@@ -98781,7 +98913,10 @@ var registerMcpToolsCommand = (parent) => {
     ["create-is-activity", "is-activity"],
     ["create-raw", "raw"]
   ]) {
-    const leaf = addInputOptions(tools.command(verb).description(`Create a ${kind} tool on a uipath MCP server.`).option("--name <name>", "Tool name.").option("--description <text>", "Tool description.").option("--target-name <name>", "Resolve target by display name.").option("--target-identifier <guid>", "Target identifier.").option("--category <category>", "Tool category/process type.").option("--input-schema <json>", "JSON input schema.").option("--output-schema <json>", "JSON output schema.").option("--metadata <json>", "JSON metadata.").option("--continue-on-error", "Continue after per-tool failures.", true).option("--fail-fast", "Stop after the first per-tool failure.")).examples(TOOL_CREATE_EXAMPLES_BY_KIND[kind]);
+    const base = tools.command(verb).description(`Create a ${kind} tool on a uipath MCP server.`).option("--name <name>", "Tool name.").option("--description <text>", "Tool description.").option("--target-name <name>", "Resolve target by display name.").option("--target-identifier <guid>", "Target identifier.").option("--category <category>", "Tool category/process type.").option("--input-schema <json>", "JSON input schema.").option("--output-schema <json>", "JSON output schema.").option("--metadata <json>", "JSON metadata.").option("--continue-on-error", "Continue after per-tool failures.", true).option("--fail-fast", "Stop after the first per-tool failure.");
+    base.option("--target-folder-key <key>", "Orchestrator folder key (GUID) of the target's folder (IS connection, Orchestrator resource, or raw payload target), when it differs from the MCP server's folder. Use --target-folder-path for the folder name or fully-qualified path.").option("--target-folder-path <path>", "Orchestrator folder display name or fully-qualified path of the target's folder (e.g. 'Shared' or 'Foo/Shared'). Resolved to the folder key via the Orchestrator SDK.");
+    base.option("--force", kind === "is-activity" ? "Bypass the IS-activity environment availability gate (only for tenants enrolled in the cloud rollout)." : "Bypass the IS-activity environment availability gate when the payload is an IS-activity tool (type 1, processType Api; only for tenants enrolled in the cloud rollout).");
+    const leaf = addInputOptions(base).examples(TOOL_CREATE_EXAMPLES_BY_KIND[kind]);
     leaf.trackedAction(processContext, async (options) => createTool(kind, options));
   }
   addInputOptions(tools.command("update").description([
@@ -98790,7 +98925,7 @@ var registerMcpToolsCommand = (parent) => {
     "Use `--rename <new-name>` to change the tool's name; the",
     "lookup `--name` flag selects the existing tool to update."
   ].join(`
-`)).argument("[id]", "Tool id (omit when using --name).").option("--name <substr>", "Lookup by tool name substring.").option("--allow-multiple", "Apply the update to every name match.").option("--rename <name>", "Rename the tool to this value.").option("--description <text>", "Updated description.").option("--target-identifier <guid>", "Updated target identifier.").option("--input-schema <json>", "JSON input schema.").option("--output-schema <json>", "JSON output schema.").option("--metadata <json>", "JSON metadata.")).examples(TOOL_UPDATE_EXAMPLES).trackedAction(processContext, async (id, options) => {
+`)).argument("[id]", "Tool id (omit when using --name).").option("--name <substr>", "Lookup by tool name substring.").option("--allow-multiple", "Apply the update to every name match.").option("--rename <name>", "Rename the tool to this value.").option("--description <text>", "Updated description.").option("--target-identifier <guid>", "Updated target identifier.").option("--target-folder-key <key>", "Orchestrator folder key (GUID) of the target's folder, when it differs from the MCP server's folder. Use --target-folder-path for the folder name or fully-qualified path.").option("--target-folder-path <path>", "Orchestrator folder display name or fully-qualified path of the target's folder (e.g. 'Shared' or 'Foo/Shared'). Resolved to the folder key via the Orchestrator SDK.").option("--input-schema <json>", "JSON input schema.").option("--output-schema <json>", "JSON output schema.").option("--metadata <json>", "JSON metadata.").option("--force", "Bypass the IS-activity environment availability gate when the payload is an IS-activity tool (type 1, processType Api; only for tenants enrolled in the cloud rollout).")).examples(TOOL_UPDATE_EXAMPLES).trackedAction(processContext, async (id, options) => {
     if (!await validateFolderInputsForTool(options, OUTPUT_CODES2.Update))
       return;
     if (!await requireParentType(options.mcp, "uipath", options, OUTPUT_CODES2.Update))
@@ -98798,8 +98933,13 @@ var registerMcpToolsCommand = (parent) => {
     const ids = await resolveToolIds(options, id ? [id] : [], OUTPUT_CODES2.Update);
     if (!ids)
       return;
-    let resolvedTargetFolderKey;
-    if (options.targetIdentifier) {
+    const [targetFolderError, explicitTargetFolderKey] = await catchError2(resolveExplicitTargetFolderKey(options));
+    if (targetFolderError) {
+      const code = targetFolderError.code;
+      return await emitError(OUTPUT_CODES2.Update, targetFolderError, code ? { Reason: code } : {});
+    }
+    let resolvedTargetFolderKey = explicitTargetFolderKey;
+    if (resolvedTargetFolderKey === undefined && options.targetIdentifier) {
       const [serverFolderError, serverFolderKey] = await catchError2(resolveServerFolderKey(options));
       if (serverFolderError) {
         const code = serverFolderError.code;
@@ -98821,6 +98961,11 @@ var registerMcpToolsCommand = (parent) => {
     const [validateError] = await catchError2(Promise.resolve().then(() => validateJsonStrings(payload)));
     if (validateError)
       return await emitError(OUTPUT_CODES2.Update, validateError);
+    if (isIsActivityToolPayload(payload) && !await assertIsActivityAvailable(options, OUTPUT_CODES2.Update))
+      return;
+    if (explicitTargetFolderKey !== undefined && (options.file || options.body)) {
+      payload.targetFolderKey = explicitTargetFolderKey;
+    }
     if (options.dryRun) {
       OutputFormatter.success({
         Result: RESULTS.Success,
@@ -98958,7 +99103,7 @@ var registerMcpToolsCommand = (parent) => {
     }
     return originalOptionMissingArgument(option);
   };
-  addCommonOptions2(candidatesCmd.option("--name <substr>", "Filter candidate name substring.").option("--connector <key>", "Connector key (only used with --category is-activity). " + "When supplied, lists activities for the connector instead " + "of listing connectors. Discover via " + "`uip is connectors list --output json` or run `candidates --category is-activity` without --connector first.").option("--limit <number>", "Page size.", (v) => Number.parseInt(v, 10)).option("--offset <number>", "Offset.", (v) => Number.parseInt(v, 10)).addOption(new Option("--skip <number>").hideHelp().argParser((v) => Number.parseInt(v, 10)))).examples(TOOL_CANDIDATES_EXAMPLES).trackedAction(processContext, async (options) => {
+  addCommonOptions2(candidatesCmd.option("--name <substr>", "Filter candidate name substring.").option("--connector <key>", "Connector key (only used with --category is-activity). " + "When supplied, lists activities for the connector instead " + "of listing connectors. Discover via " + "`uip is connectors list --output json` or run `candidates --category is-activity` without --connector first.").option("--force", "Bypass the IS-activity environment availability gate (only for tenants enrolled in the cloud rollout).").option("--limit <number>", "Page size.", (v) => Number.parseInt(v, 10)).option("--offset <number>", "Offset.", (v) => Number.parseInt(v, 10)).addOption(new Option("--skip <number>").hideHelp().argParser((v) => Number.parseInt(v, 10)))).examples(TOOL_CANDIDATES_EXAMPLES).trackedAction(processContext, async (options) => {
     const offset = resolveDeprecatedOptionAlias({
       preferredValue: options.offset,
       deprecatedValue: options.skip,
@@ -98983,6 +99128,8 @@ var registerMcpToolsCommand = (parent) => {
       return await emitError(OUTPUT_CODES2.Candidates, new Error(`Invalid --category '${category}'. Use one of: ${ALL_CANDIDATE_CATEGORIES.join(", ")}.`));
     }
     if (category === "is-activity") {
+      if (!await assertIsActivityAvailable(options, OUTPUT_CODES2.Candidates))
+        return;
       const needle = options.name?.toLowerCase();
       const skip = offset.value ?? 0;
       const limit = options.limit ?? DEFAULT_PAGE_SIZE;
@@ -99544,4 +99691,4 @@ export {
   createStandaloneProgram
 };
 
-//# debugId=B893C457D11D1C1D64756E2164756E21
+//# debugId=EA927289E84F50B464756E2164756E21

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uipath/agenthub-tool",
   "license": "MIT",
-  "version": "1.198.0",
+  "version": "1.199.0-preview.104",
   "description": "Manage UiPath AgentHub MCP server registrations, tools, and remote A2A agents.",
   "private": false,
   "repository": {
@@ -26,5 +26,5 @@
   "files": [
     "dist"
   ],
-  "gitHead": "1fadf03d7a8dd102742571dff569fdac11808afb"
+  "gitHead": "829a8ab8a25bce5b62c284bd1ddc674d2947f647"
 }