@uipath/packager-remote-agent-browser 0.0.0-stage → 1.205.0-preview.258

package/LICENSE.txt

@@ -0,0 +1,3 @@
+© 2026 UiPath
+Use of this product is subject (a) to the applicable licensing agreement available: https://www.uipath.com/legal/trust-and-security/legal-terms#content-1 and, (b) for paid products listed here https://licensing.uipath.com/: the licensing agreement agreed between you and UiPath.
+(UiPath means UiPath SRL with headquarters at 4 Vasile Alecsandri Str. and 11 Constantin Daniel Str., Building A, floors 5 and 6, District 1, Bucharest 010639, Romania and UiPath Inc. with principal place of business: One Vanderbilt Avenue, 60th Floor, New York, NY 10017)

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @uipath/packager-remote-agent-browser
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Sends the projects a browser packer cannot pack itself to the UiPath Remote Agent, and gets their packages back. One Orchestrator job handles every such project of a pack, whatever its type.
+
+Browser tools use this package; consumers don't call it directly:
+
+| Tool package | Factory | Project types |
+|---|---|---|
+| `@uipath/packager-tool-workflowcompiler-browser` | `WorkflowCompilerToolFactory` | Process, Library, Tests, WebApp |
+| `@uipath/packager-tool-functions-browser` | `RemoteFunctionsToolFactory` | Function |
+| `@uipath/packager-tool-codedapps-browser` | `RemoteCodedAppsToolFactory` | AppV2 |
+
+## How it works
+
+1. The solution packager calls `packAsync` on every project at once. Each remote tool hands its project to the **shared** `RemoteAgentBundleExecutor` (`getSharedRemoteAgentBundleExecutor`).
+2. The executor waits until every remote project of the operation context has arrived. `RemoteProjectSelector` picks them from the shared tools-factory registry: a project counts when the factory that won its type is marked `delegatesToRemoteAgent`. This holds for pack, validate and cleanup alike.
+3. It opens the `robotdebug` SignalR hub, then starts **one** job: serverless `api/serverless/jobs`, or `RobotDebug/BeginSession` for a local robot. The command goes in the job's input arguments.
+4. The agent downloads the snapshot, packs each project into `<DesignId>/`, uploads `rpa-packages.zip` to a temporary bucket, and reports `SetExecutionCompleted { BucketId, ArchiveName }`.
+5. The executor downloads the archive named by `ArchiveName` (`rpa-packages.zip` when an older agent does not send it), copies each project's packages into its output folder, and deletes the bucket.
+
+## Job payload
+
+The agent routes by payload list, not by project type. The session keeps its remote projects in solution order; Function projects go to `FunctionProjects`, coded app (AppV2) projects to `CodedAppProjects`, and the rest (the RPA types `WorkflowCompilerToolFactory` claims) to `RpaProjects`. Each list comes with the field that pins the packager the agent restores, and a list and its version field are sent only when the list has projects; the agent defaults a missing list to empty:
+
+| Project types | List | Version field |
+|---|---|---|
+| Process, Library, Tests, WebApp | `RpaProjects` | `WorkflowCompilerVersion` |
+| Function | `FunctionProjects` | `FunctionsPackagerVersion` |
+| AppV2 (coded apps) | `CodedAppProjects` | `CodedAppsPackagerVersion` |
+
+Every payload asks for protocol `2.0`. A new list does not bump the version: an agent that refuses a version fails before it connects to the hub, so the browser would wait with no signal. An agent that does not know a list ignores it and packs the rest. Each project it skipped then fails when the result arrives, because the zip has no `<DesignId>/` folder for it: "The remote agent returned no package for …".
+
+The agent side lives in the Studio repo: `Robot/UiPath.RemoteDebugging.Agent/Packager`. See `REMOTE-PACK-FUNCTIONS.md` there.

package/dist/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,8 @@
+# Third-party notices for @uipath/packager-remote-agent-browser
+
+This package is distributed as a bundle: the dependencies below are
+compiled into its `dist/` output rather than installed alongside it.
+Their licences and copyright notices are reproduced here in full, as
+those licences require.
+
+No third-party code is bundled into this package.

package/dist/bundle-operation.d.ts

@@ -0,0 +1,9 @@
+/**
+ * An operation the remote agent runs for a bundle of projects. The value is
+ * the agent's `Command`.
+ */
+export declare enum BundleOperation {
+    Pack = "Pack",
+    Validate = "Validate",
+    Cleanup = "Cleanup"
+}

package/dist/i18n/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * i18n module for the packager-remote-agent-browser package.
+ * Registers the remote-agent bundle executor translations.
+ */
+import { en } from "./locales/en.js";
+export type { TranslationKeys } from "./locales/en.js";
+export { en };

package/dist/i18n/locales/en.d.ts

@@ -0,0 +1,48 @@
+/**
+ * English translations for the packager-remote-agent-browser package.
+ * These translations are registered alongside core translations via I18nManager.
+ */
+export declare const en: {
+    readonly remoteAgentBrowser: {
+        readonly info: {
+            readonly startingRemoteAgent: "Starting remote {operation} agent for {count} project(s): {paths}";
+            readonly connectingToHub: "Connecting to SignalR hub: {url}";
+            readonly remoteAgentStartedExecution: "Remote agent started execution";
+            readonly downloadingArchive: "Downloading pack result archive from bucket {bucketId}";
+            readonly extractingArchive: "Extracting archive ({size} bytes) to {path}";
+            readonly distributingPackages: "Distributing packages for {count} project(s)";
+            readonly skippingRemoteCompilation: "No connection info available — skipping remote compilation for workflow compiler projects";
+            readonly cleaningUpTempDir: "Cleaning up temporary directory {path}";
+            readonly deletingBucket: "Deleting temporary storage bucket {bucketId}";
+            readonly copyingFiles: "Copying {count} file(s) for project {designId} to {path}";
+            readonly offloadingInputArguments: "Input arguments are too large ({length} chars) to send inline; uploading them as a file attachment";
+        };
+        readonly errors: {
+            readonly missingConnectionInfo: "Missing connection info (cloudUrl, accessToken, or folderId)";
+            readonly signalRConnectionFailed: "Failed to connect to SignalR hub";
+            readonly hubConnectionFailed: "Failed to connect to SignalR hub at {url}: {message}";
+            readonly packSucceededNoBucket: "Pack succeeded but no BucketId was returned";
+            readonly agentFailed: "{operation} agent failed with status {status} (code {errorCode})";
+            readonly noResultForProject: "No result for project";
+            readonly beginSessionFailed: "BeginSession failed ({status}): {errorText}";
+            readonly hubConnectionClosed: "Hub connection closed unexpectedly";
+            readonly packAgentDisconnected: "Pack agent disconnected unexpectedly";
+            readonly deleteBucketFailed: "Unable to delete temporary storage bucket on Orchestrator: {statusText}";
+            readonly cleanupBucketFailed: "Unable to cleanup remote bucket {bucketId}: {message}";
+            readonly getBucketUriFailed: "Failed to get bucket read URI ({status}): {errorText}";
+            readonly downloadArchiveUnreachable: "Could not download the pack result from {host}: {message}. The agent finished; the browser could not reach the result storage, most often because it does not allow this page's origin (CORS).";
+            readonly downloadArchiveFailed: "Failed to download archive from bucket ({status}): {statusText}";
+            readonly noMatchingProject: "No matching project found for path: {projectPath}";
+            readonly noPackageFromAgent: "The remote agent returned no package for {project} ({projectType}, design {designId}). An agent that does not pack {projectType} projects skips them.";
+            readonly distributePackagesFailed: "Failed to distribute packages for {designId}: {message}";
+            readonly sessionTimeout: "Session timed out waiting for projects: received {received} of {expected} expected projects";
+            readonly jobStartTimeout: "The remote agent job {jobKey} was still pending after {minutes} minute(s): no robot picked it up, so it was stopped. Check that a robot or serverless capacity is available in the folder and retry.";
+            readonly bundleOperationMismatch: "Cannot mix {sessionOperation} and {entryOperation} in the same context";
+            readonly createAttachmentFailed: "Failed to create input arguments attachment ({status}): {errorText}";
+            readonly attachmentResponseMalformed: "Attachment creation response did not include an id and blob URI";
+            readonly uploadInputArgumentsFailed: "Failed to upload input arguments file ({status}): {statusText}";
+        };
+    };
+};
+/** @public */
+export type TranslationKeys = typeof en;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import "./i18n/index.js";
+export { BundleOperation } from "./bundle-operation.js";
+export { getSharedRemoteAgentBundleExecutor, type IRemoteAgentBundleExecutor, } from "./remote-agent-bundle-executor.js";
+export { RemoteAgentProjectTool, RemoteAgentProjectToolFactory, } from "./remote-agent-project-tool.js";
+export type { IRemoteAgentToolFactory } from "./remote-project-selector.js";