@uipath/conversational-tool 1.202.0 → 1.202.1-preview.167

package/dist/THIRD-PARTY-NOTICES.md

@@ -5,7 +5,7 @@ compiled into its `dist/` output rather than installed alongside it.
 Their licences and copyright notices are reproduced here in full, as
 those licences require.
 
-32 bundled dependencies:
+34 bundled dependencies:
 
 - @opentelemetry/api@1.9.1 — Apache-2.0
 - @opentelemetry/api-logs@0.204.0 — Apache-2.0
@@ -14,6 +14,8 @@ those licences require.
 - @opentelemetry/sdk-logs@0.204.0 — Apache-2.0
 - @opentelemetry/semantic-conventions@1.43.0 — Apache-2.0
 - @socket.io/component-emitter@3.1.2 — MIT
+- @uipath/core-telemetry@1.0.0-beta.3 — MIT
+- @uipath/uipath-typescript@1.7.1 — MIT
 - bundle-name@4.1.0 — MIT
 - commander@14.0.3 — MIT
 - debug@4.4.3 — MIT
@@ -38,7 +40,7 @@ those licences require.
 - supports-color@7.2.0 — MIT
 - ws@8.21.1 — MIT
 - wsl-utils@0.3.1 — MIT
-- xmlhttprequest-ssl@2.1.2 — 
+- xmlhttprequest-ssl@2.1.2 — MIT
 
 ---
 
@@ -1335,6 +1337,34 @@ OTHER DEALINGS IN THE SOFTWARE.
 
 ---
 
+## @uipath/core-telemetry@1.0.0-beta.3
+
+SPDX: MIT
+
+The upstream package ships no licence file here; `MIT` is the
+licence it is distributed under. The canonical text of that licence
+applies, with copyright held by the package's authors.
+
+---
+
+## @uipath/uipath-typescript@1.7.1
+
+SPDX: MIT
+
+```
+MIT License
+
+Copyright 2025-present UiPath
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+---
+
 ## bundle-name@4.1.0
 
 SPDX: MIT
@@ -1880,7 +1910,9 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ## xmlhttprequest-ssl@2.1.2
 
-SPDX: not declared; see the text below
+Licence decision: Ships the MIT text with no `license` field; taken from the text it actually ships rather than assumed.
+
+SPDX: MIT
 
 ```
  Copyright (c) 2010 passive.ly LLC

package/dist/{cas-client-vx8tygss.js → cas-client-pgtr3hgy.js}

@@ -4,7 +4,7 @@ import {
   getLoginStatusAsync,
   getSdkUserAgentToken,
   package_default
-} from "./tool-sz8zdfbv.js";
+} from "./tool-azng6dhs.js";
 import"./tool-1yh8g550.js";
 
 // src/api/cas-client.ts

package/dist/{index-xzshjcwa.js → index-a3nybs0a.js}

@@ -7154,7 +7154,8 @@ var RESPONSE_TYPES = {
   JSON: "json",
   TEXT: "text",
   BLOB: "blob",
-  ARRAYBUFFER: "arraybuffer"
+  ARRAYBUFFER: "arraybuffer",
+  STREAM: "stream"
 };
 var EXTERNAL_USER_ID = "x-uipath-external-user-id";
 var CONVERSATIONAL_SURFACE_NAME = "x-uipath-conversational-surfacename";
@@ -7166,6 +7167,165 @@ var WEBSOCKET_QUERY_PARAMS = {
   CONVERSATIONAL_SURFACE_NAME,
   CONVERSATIONAL_SURFACE_VERSION
 };
+function toSearchParams(params) {
+  const searchParams = new URLSearchParams;
+  if (!params)
+    return searchParams;
+  for (const [key, value2] of Object.entries(params)) {
+    if (value2 === undefined || value2 === null)
+      continue;
+    if (Array.isArray(value2)) {
+      value2.forEach((item) => {
+        if (item !== undefined && item !== null)
+          searchParams.append(key, String(item));
+      });
+    } else {
+      searchParams.append(key, String(value2));
+    }
+  }
+  return searchParams;
+}
+var DEFAULT_RETRYABLE_STATUS_CODES = [408, 429, 500, 502, 503, 504];
+var DEFAULT_RETRY_METHODS = ["GET", "HEAD", "PUT", "DELETE", "OPTIONS"];
+var DEFAULT_RETRY_OPTIONS = {
+  maxRetries: 2,
+  initialDelayMs: 500,
+  backoffStrategy: "exponential",
+  backoffFactor: 2,
+  backoffMaxDelayMs: 30000,
+  retryableStatusCodes: DEFAULT_RETRYABLE_STATUS_CODES,
+  retryMethods: DEFAULT_RETRY_METHODS,
+  retryNetworkErrors: true,
+  respectRetryAfter: true,
+  maxRetryAfterMs: Infinity
+};
+var DEFAULT_API_CLIENT_RETRY = {
+  ...DEFAULT_RETRY_OPTIONS,
+  maxRetries: 0
+};
+function resolveRetryOptions(settings, defaults = DEFAULT_RETRY_OPTIONS) {
+  if (!settings)
+    return defaults;
+  const { retryDelay, useExponentialBackoff, ...live } = settings;
+  const resolved = { ...defaults };
+  for (const [key, value2] of Object.entries(live)) {
+    if (value2 !== undefined) {
+      resolved[key] = value2;
+    }
+  }
+  if (retryDelay !== undefined && live.initialDelayMs === undefined) {
+    resolved.initialDelayMs = retryDelay;
+  }
+  if (useExponentialBackoff !== undefined && live.backoffStrategy === undefined) {
+    resolved.backoffStrategy = useExponentialBackoff ? "exponential" : "constant";
+  }
+  return resolved;
+}
+function computeBackoffDelay(attempt, settings) {
+  const base = Math.max(0, settings.initialDelayMs);
+  let delay;
+  switch (settings.backoffStrategy) {
+    case "constant":
+      delay = base;
+      break;
+    case "linear":
+      delay = base * (attempt + 1);
+      break;
+    default:
+      delay = base * Math.pow(settings.backoffFactor, attempt);
+  }
+  return Math.min(delay, settings.backoffMaxDelayMs);
+}
+function parseRetryAfter(value2, now = Date.now()) {
+  const trimmed = value2?.trim();
+  if (!trimmed)
+    return;
+  const seconds = Number(trimmed);
+  if (Number.isFinite(seconds))
+    return Math.max(0, seconds * 1000);
+  const date = Date.parse(trimmed);
+  if (Number.isNaN(date))
+    return;
+  return Math.max(0, date - now);
+}
+function wait(durationMs) {
+  return new Promise((resolve) => setTimeout(resolve, Math.max(0, durationMs)));
+}
+var RETRY_AFTER = "retry-after";
+function createAttemptSignal(timeoutMs, external) {
+  if (timeoutMs === undefined || !Number.isFinite(timeoutMs))
+    return { signal: external, dispose: () => {} };
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(new Error(`Request timeout after ${timeoutMs}ms`)), timeoutMs);
+  const onExternalAbort = () => controller.abort(external?.reason);
+  if (external) {
+    if (external.aborted) {
+      controller.abort(external.reason);
+    } else {
+      external.addEventListener("abort", onExternalAbort);
+    }
+  }
+  return {
+    signal: controller.signal,
+    dispose: () => {
+      clearTimeout(timer);
+      external?.removeEventListener("abort", onExternalAbort);
+    }
+  };
+}
+function delayBeforeRetry(durationMs, signal) {
+  if (!signal)
+    return wait(durationMs);
+  if (signal.aborted)
+    return Promise.reject(signal.reason);
+  return new Promise((resolve, reject) => {
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(signal.reason);
+    };
+    const timer = setTimeout(() => {
+      signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, Math.max(0, durationMs));
+    signal.addEventListener("abort", onAbort);
+  });
+}
+async function fetchWithRetry(url2, init, options) {
+  const settings = options.retry;
+  const method = (init.method ?? "GET").toUpperCase();
+  const retriesAllowed = settings.retryMethods.includes(method) ? Math.max(0, settings.maxRetries) : 0;
+  let attempt = 0;
+  for (;; ) {
+    const { signal, dispose } = createAttemptSignal(options.timeoutMs, options.signal);
+    let response;
+    let failure;
+    try {
+      response = await fetch(url2, { ...init, signal });
+    } catch (error) {
+      failure = error;
+    } finally {
+      dispose();
+    }
+    if (options.signal?.aborted && failure !== undefined)
+      throw failure;
+    if (response && !settings.retryableStatusCodes.includes(response.status))
+      return response;
+    if (failure !== undefined && !settings.retryNetworkErrors)
+      throw failure;
+    if (attempt >= retriesAllowed) {
+      if (response)
+        return response;
+      throw failure;
+    }
+    const retryAfter = settings.respectRetryAfter && response ? parseRetryAfter(response.headers.get(RETRY_AFTER)) : undefined;
+    const delay = retryAfter !== undefined ? Math.min(retryAfter, settings.maxRetryAfterMs) : computeBackoffDelay(attempt, settings);
+    response?.body?.cancel().catch((error) => {
+      console.warn("[UiPath SDK] Could not release a discarded response body:", error);
+    });
+    await delayBeforeRetry(delay, options.signal);
+    attempt++;
+  }
+}
 
 class ApiClient {
   constructor(config, executionContext, tokenManager, clientConfig = {}) {
@@ -7200,28 +7360,16 @@ class ApiClient {
       [UIPATH_TRACEPARENT_ID]: traceparentValue,
       ...options.headers
     };
-    const searchParams = new URLSearchParams;
-    if (options.params) {
-      Object.entries(options.params).forEach(([key, value2]) => {
-        if (Array.isArray(value2)) {
-          value2.forEach((item) => searchParams.append(key, String(item)));
-        } else {
-          searchParams.append(key, String(value2));
-        }
-      });
-    }
+    const searchParams = toSearchParams(options.params);
     const fullUrl = searchParams.toString() ? `${url2}?${searchParams.toString()}` : url2;
     let body = undefined;
     if (options.body) {
       body = isFormData ? options.body : JSON.stringify(options.body);
     }
+    const retrySettings = resolveRetryOptions(options.retry ?? options.retryOptions, DEFAULT_API_CLIENT_RETRY);
+    const timeoutMs = options.timeoutMs ?? options.timeoutOptions?.timeout;
     try {
-      const response = await fetch(fullUrl, {
-        method,
-        headers,
-        body,
-        signal: options.signal
-      });
+      const response = await fetchWithRetry(fullUrl, { method, headers, body }, { retry: retrySettings, timeoutMs, signal: options.signal });
       if (!response.ok) {
         const errorInfo = await errorResponseParser.parse(response);
         throw ErrorFactory.createFromHttpStatus(response.status, errorInfo);
@@ -7685,6 +7833,12 @@ class PaginationHelpers {
     });
   }
 }
+function missingConfigMessage() {
+  if (isBrowser) {
+    return "UiPath SDK configuration not found. " + "Ensure @uipath/coded-apps plugin is set up in your bundler to inject configuration during development and build.";
+  }
+  return "UiPath SDK configuration not found. " + "In a UiPath coded function, pass the handler context: new UiPath(ctx). " + "Otherwise pass { baseUrl, orgName, tenantName, secret }, " + "or set UIPATH_BASE_URL, UIPATH_ORG_NAME, UIPATH_TENANT_NAME and UIPATH_ACCESS_TOKEN.";
+}
 var REGISTRY_KEY = Symbol.for("@uipath/sdk-internals-registry");
 var getGlobalStore = () => {
   const globalObj = globalThis;
@@ -7693,6 +7847,7 @@ var getGlobalStore = () => {
   }
   return globalObj[REGISTRY_KEY];
 };
+var looksLikeUiPath = (instance) => typeof instance.initialize === "function";
 
 class SDKInternalsRegistry {
   static get store() {
@@ -7704,6 +7859,9 @@ class SDKInternalsRegistry {
   static get(instance) {
     const internals = this.store.get(instance);
     if (!internals) {
+      if (looksLikeUiPath(instance)) {
+        throw new Error("Cannot create a service: the UiPath instance was never configured. " + missingConfigMessage());
+      }
       throw new Error("Invalid SDK instance. Make sure to pass a valid UiPath instance to the service constructor.");
     }
     return internals;
@@ -8027,6 +8185,16 @@ var AgentMap = {
 var UserSettingsMap = {
   ...CommonFieldMap
 };
+var ConnectionState;
+(function(ConnectionState2) {
+  ConnectionState2["Enabled"] = "Enabled";
+  ConnectionState2["Disabled"] = "Disabled";
+  ConnectionState2["Expired"] = "Expired";
+  ConnectionState2["Failed"] = "Failed";
+})(ConnectionState || (ConnectionState = {}));
+var ConnectionAuthMap = {
+  expiresAt: "expiresTime"
+};
 var AUTOPILOT_BASE = "autopilotforeveryone_";
 var API_VERSION = "v1";
 var CONVERSATION_ENDPOINTS = {
@@ -8050,7 +8218,9 @@ var ATTACHMENT_ENDPOINTS = {
 };
 var AGENT_ENDPOINTS = {
   LIST: `${AUTOPILOT_BASE}/api/${API_VERSION}/agent`,
-  GET: (folderId, agentId) => `${AUTOPILOT_BASE}/api/${API_VERSION}/agent/${folderId}/${agentId}`
+  GET: (folderId, agentId) => `${AUTOPILOT_BASE}/api/${API_VERSION}/agent/${folderId}/${agentId}`,
+  CONNECTIONS: (folderId, agentId) => `${AUTOPILOT_BASE}/api/${API_VERSION}/agent/${folderId}/${agentId}/connections`,
+  CONNECTION_AUTH: `${AUTOPILOT_BASE}/api/${API_VERSION}/agent/connections/auth`
 };
 var USER_ENDPOINTS = {
   SETTINGS: `${AUTOPILOT_BASE}/api/${API_VERSION}/user/settings`
@@ -10772,6 +10942,29 @@ class ConversationalAgentService extends BaseService {
     const mimeType = resolveCitationMimeType(source, blob.type);
     return mimeType && mimeType !== blob.type ? blob.slice(0, blob.size, mimeType) : blob;
   }
+  async getAvailableConnections(agentId, folderId) {
+    const response = await this.get(AGENT_ENDPOINTS.CONNECTIONS(folderId, agentId));
+    return response.data;
+  }
+  async updateConnectionSelections(agentId, folderId, request) {
+    const response = await this.put(AGENT_ENDPOINTS.CONNECTIONS(folderId, agentId), request);
+    return response.data;
+  }
+  async getAddConnectionUrl(item) {
+    try {
+      const { authUrl } = await this.fetchConnectionAuthUrl(item.connectorKey);
+      return authUrl;
+    } catch {
+      return item.connectionsUrl ?? item.configurationUrl ?? null;
+    }
+  }
+  async getConnectionAuthUrl(connectorKey) {
+    return this.fetchConnectionAuthUrl(connectorKey);
+  }
+  async fetchConnectionAuthUrl(connectorKey) {
+    const response = await this.post(AGENT_ENDPOINTS.CONNECTION_AUTH, { connectorKey });
+    return transformData(response.data, ConnectionAuthMap);
+  }
   async getFeatureFlags() {
     const response = await this.get(FEATURE_ENDPOINTS.FEATURE_FLAGS);
     return response.data;
@@ -10786,6 +10979,18 @@ __decorate([
 __decorate([
   track("ConversationalAgent.DownloadCitationSource")
 ], ConversationalAgentService.prototype, "downloadCitationSource", null);
+__decorate([
+  track("ConversationalAgent.GetAvailableConnections")
+], ConversationalAgentService.prototype, "getAvailableConnections", null);
+__decorate([
+  track("ConversationalAgent.UpdateConnectionSelections")
+], ConversationalAgentService.prototype, "updateConnectionSelections", null);
+__decorate([
+  track("ConversationalAgent.GetAddConnectionUrl")
+], ConversationalAgentService.prototype, "getAddConnectionUrl", null);
+__decorate([
+  track("ConversationalAgent.GetConnectionAuthUrl")
+], ConversationalAgentService.prototype, "getConnectionAuthUrl", null);
 export {
   AgentMap,
   AsyncInputStreamEventHelper,
@@ -10793,6 +10998,8 @@ export {
   AsyncToolCallEventHelper,
   AsyncToolCallEventHelperImpl,
   CitationErrorType,
+  ConnectionAuthMap,
+  ConnectionState,
   ContentPartEventHelper,
   ContentPartEventHelperImpl,
   ContentPartHelper,
@@ -10844,4 +11051,4 @@ export {
   transformMessage
 };
 
-//# debugId=EFB6E7334C72C1DA64756E2164756E21
+//# debugId=C2A4B4AA6694029164756E2164756E21

package/dist/index.js

@@ -2,11 +2,11 @@
 import {
   metadata,
   registerCommands
-} from "./tool-9mezv9yv.js";
+} from "./tool-c5fdrxt4.js";
 import"./tool-nkyhbf79.js";
 import {
   Command
-} from "./tool-sz8zdfbv.js";
+} from "./tool-azng6dhs.js";
 import"./tool-mpvp5rqs.js";
 import"./tool-1yh8g550.js";
 

package/dist/{tool-sz8zdfbv.js → tool-azng6dhs.js}

@@ -2100,7 +2100,7 @@ var require_commander = __commonJS(function(exports) {
 var package_default = {
   name: "@uipath/conversational-tool",
   license: "SEE LICENSE IN LICENSE.txt",
-  version: "1.202.0",
+  version: "1.202.1-preview.167",
   description: "Handle conversations with deployed UiPath conversational processes.",
   publishConfig: {
     registry: "https://npm.pkg.github.com/"
@@ -2129,7 +2129,7 @@ var package_default = {
     "@uipath/common": "workspace:*",
     "@uipath/auth": "workspace:*",
     "@uipath/filesystem": "workspace:*",
-    "@uipath/uipath-typescript": "^1.6.1",
+    "@uipath/uipath-typescript": "^1.7.1",
     "@types/node": "^25.5.2",
     typescript: "^7.0.2"
   }
@@ -7159,4 +7159,4 @@ var CLI_EXTERNAL_USER_ID = "app-user-cli-cas";
 
 export { package_default, getFileSystem, catchError, extractErrorDetails, extractErrorMessageSync, RESULTS, EXIT_CODES, OutputFormatter, InvalidArgumentError, Command, processContext, requireConfirmation, instructionsFor, canPrompt, parseBoundedInt, getSdkUserAgentToken, addSdkUserAgentHeader, getLoginStatusAsync, CLI_EXTERNAL_USER_ID };
 
-//# debugId=44488754EA5E27FA64756E2164756E21
+//# debugId=8CC7BEFD27FF80EA64756E2164756E21