@uipath/flow-tool 1.0.1 → 1.1.0

package/README.md

@@ -9,7 +9,7 @@ CLI tool for managing UiPath Flow processes and jobs. This is a uip plugin that
 Create a new Flow project with boilerplate files.
 
 ```bash
-uip flow init <projectName> [--force]
+uip maestro flow init <projectName> [--force]
 ```
 
 ### `flow validate`
@@ -17,7 +17,7 @@ uip flow init <projectName> [--force]
 Validate a `.flow` file against the Flow schema (Zod-based) with structural cross-field checks.
 
 ```bash
-uip flow validate <flowFile>
+uip maestro flow validate <flowFile>
 ```
 
 ### `flow pack`
@@ -25,7 +25,7 @@ uip flow validate <flowFile>
 Pack a Flow project into a NuGet package (`.nupkg`).
 
 ```bash
-uip flow pack <projectPath> <outputPath> [-n <name>] [-v <version>]
+uip maestro flow pack <project-path> <output-path> [-n <name>] [-v <version>]
 ```
 
 ### Known Issues
@@ -36,16 +36,18 @@ uip flow pack <projectPath> <outputPath> [-n <name>] [-v <version>]
 >
 > **Root cause:** The published `@uipath/tool-flow` npm package has a non-recursive `copyFiles()` method that only copies top-level files from the project directory, silently skipping the `content/` and `flow_files/` subdirectories. The local `flow-pack-service.ts` correctly uses `copyDirectory()` for recursive copies, but the npm-published tool does not.
 >
-> **Workaround:** Use `uip flow pack` directly to produce a correct `.nupkg` for deployment.
+> **Workaround:** Use `uip maestro flow pack` directly to produce a correct `.nupkg` for deployment.
 
 ### Flow Process Commands
 
 #### `flow process list`
 
-List available Flow processes.
+List available Flow processes in a folder. Provide either `--folder-key`
+(GUID) or `--folder-path` (e.g. `Shared/Invoices`).
 
 ```bash
-uip flow process list
+uip maestro flow process list --folder-key "<folder-key>"
+uip maestro flow process list --folder-path "Shared/Invoices"
 ```
 
 #### `flow process get`
@@ -53,10 +55,10 @@ uip flow process list
 Get Flow process schema and details.
 
 ```bash
-uip flow process get "<process-key>" "<feed-id>"
+uip maestro flow process get "<process-key>" "<feed-id>" --folder-key "<folder-key>"
 
 # Example
-uip flow process get "MyFlow.flow.Flow:1.0.0" "6d98ceb8-becb-46ec-80d7-df213fbec06c"
+uip maestro flow process get "MyFlow.flow.Flow:1.0.0" "6d98ceb8-becb-46ec-80d7-df213fbec06c" --folder-key "c3d4e5f6-0000-0000-0000-000000000001"
 ```
 
 #### `flow process run`
@@ -66,7 +68,7 @@ Run a Flow process.
 **Syntax:**
 
 ```bash
-uip flow process run "<process-key>" "<folder-key>" [options]
+uip maestro flow process run "<process-key>" "<folder-key>" [options]
 ```
 
 **Arguments:**
@@ -79,7 +81,6 @@ uip flow process run "<process-key>" "<folder-key>" [options]
 - `-i, --inputs <json>` - Input parameters as JSON string or @file.json
 - `-t, --tenant <name>` - Tenant name (defaults to authenticated tenant)
 - `--release-key <key>` - Release key (GUID, from list command)
-- `--folder-id <id>` - Folder ID (from list command)
 - `--feed-id <id>` - Feed ID for package lookup (optional)
 - `--robot-ids <ids>` - Comma-separated robot IDs (optional)
 - `--validate` - Validate inputs against project schema before running
@@ -88,22 +89,19 @@ uip flow process run "<process-key>" "<folder-key>" [options]
 
 ```bash
 # Run with JSON inputs
-uip flow process run "TestFlow.flow.Flow:1.0.0" "folder-guid-here" \
+uip maestro flow process run "TestFlow.flow.Flow:1.0.0" "folder-guid-here" \
   --release-key "release-guid" \
-  --folder-id "2553016" \
   --inputs '{"name": "John", "age": 30}'
 
 # Run with inputs from file
-uip flow process run "TestFlow.flow.Flow:1.0.0" "folder-guid-here" \
+uip maestro flow process run "TestFlow.flow.Flow:1.0.0" "folder-guid-here" \
   --release-key "release-guid" \
-  --folder-id "2553016" \
   --inputs @inputs.json
 
 # Run with piped inputs
 echo '{"name": "John", "age": 30}' | \
-  uip flow process run "TestFlow.flow.Flow:1.0.0" "folder-guid-here" \
-  --release-key "release-guid" \
-  --folder-id "2553016"
+  uip maestro flow process run "TestFlow.flow.Flow:1.0.0" "folder-guid-here" \
+  --release-key "release-guid"
 ```
 
 ### Flow Job Commands
@@ -113,14 +111,14 @@ echo '{"name": "John", "age": 30}' | \
 Stream execution traces for a running job.
 
 ```bash
-uip flow job traces "<job-key>" [options]
+uip maestro flow job traces "<job-key>" [options]
 
 # Options:
 # --poll-interval <ms>  - Polling interval in milliseconds (default: 2000)
 # --traces-service <name> - Traces service name (default: llmopstenant_)
 
 # Example
-uip flow job traces "06478292-f9cf-4234-9d1b-03f4bcd95fed"
+uip maestro flow job traces "06478292-f9cf-4234-9d1b-03f4bcd95fed"
 ```
 
 #### `flow job status`
@@ -128,35 +126,34 @@ uip flow job traces "06478292-f9cf-4234-9d1b-03f4bcd95fed"
 Get detailed status of a Flow job.
 
 ```bash
-uip flow job status "<job-key>" --folder-id "<id>" [options]
+uip maestro flow job status "<job-key>" --folder-key "<key>" [options]
 
 # Options:
 # --detailed  - Show full response with all fields
 
 # Example
-uip flow job status "06478292-f9cf-4234-9d1b-03f4bcd95fed" --folder-id "2553016"
+uip maestro flow job status "06478292-f9cf-4234-9d1b-03f4bcd95fed" --folder-key "c3d4e5f6-0000-0000-0000-000000000001"
 ```
 
 ## Complete Workflow
 
 ```bash
 # 1. List available processes
-uip flow process list
+uip maestro flow process list --folder-key "folder-key"
 
 # 2. Get process schema (to see required inputs)
-uip flow process get "MyFlow.flow.Flow:1.0.0" "feed-id-from-list"
+uip maestro flow process get "MyFlow.flow.Flow:1.0.0" "feed-id-from-list" --folder-key "folder-key"
 
 # 3. Run the process
-JOB_KEY=$(uip flow process run "MyFlow.flow.Flow:1.0.0" "folder-key" \
+JOB_KEY=$(uip maestro flow process run "MyFlow.flow.Flow:1.0.0" "folder-key" \
   --release-key "release-key" \
-  --folder-id "2553016" \
-  --inputs '{}' 2>/dev/null)
+  --inputs '{}')
 
 # 4. Watch execution traces
-uip flow job traces "$JOB_KEY"
+uip maestro flow job traces "$JOB_KEY"
 
 # 5. Check final status
-uip flow job status "$JOB_KEY" --folder-id "2553016"
+uip maestro flow job status "$JOB_KEY" --folder-key "folder-key"
 ```
 
 ## Output
@@ -181,7 +178,7 @@ uip flow job status "$JOB_KEY" --folder-id "2553016"
 | `flow registry pull`              | Fetch and cache all available nodes from the Flow registry                     |
 | `flow registry list`              | List all locally cached nodes                                                  |
 | `flow registry search [keyword]`  | Find nodes by keyword and/or structured filters                                |
-| `flow registry get <nodeType>`    | Get full node schema; auto-enriches connector nodes with input/output fields   |
+| `flow registry get <node-type>`   | Get full node schema; auto-enriches connector nodes with input/output fields   |
 
 ---
 
@@ -190,8 +187,8 @@ uip flow job status "$JOB_KEY" --folder-id "2553016"
 Fetches the node registry and writes it to local cache. Subsequent commands (`list`, `search`, `get`) read from this cache.
 
 ```bash
-uip flow registry pull
-uip flow registry pull --force   # bypass 30-minute cache, always refresh
+uip maestro flow registry pull
+uip maestro flow registry pull --force   # bypass 30-minute cache, always refresh
 ```
 
 **Output fields:**
@@ -218,7 +215,7 @@ uip flow registry pull --force   # bypass 30-minute cache, always refresh
 Lists all nodes in the local cache. If no cache exists, fetches live data first.
 
 ```bash
-uip flow registry list
+uip maestro flow registry list
 ```
 
 **Output fields:** `NodesCount`, `Nodes[]`
@@ -230,9 +227,9 @@ uip flow registry list
 Searches for nodes by keyword and/or structured filters.
 
 ```bash
-uip flow registry search slack
-uip flow registry search slack --filter "displayname:contains=send message"
-uip flow registry search --filter "category=connector"
+uip maestro flow registry search slack
+uip maestro flow registry search slack --filter "displayname:contains=send message"
+uip maestro flow registry search --filter "category=connector"
 ```
 
 **Options:**
@@ -284,8 +281,8 @@ Examples:
 Returns full details for a single node, looked up by `nodeType` (case-insensitive).
 
 ```bash
-uip flow registry get "uipath.agent"
-uip flow registry get "uipath.connector.slack.send-message"
+uip maestro flow registry get "uipath.agent"
+uip maestro flow registry get "uipath.connector.slack.send-message"
 ```
 
 **Output fields:** `Node` (enriched FlowNode object)
@@ -320,24 +317,24 @@ All commands support `--output-filter <expression>` (global option) to extract s
 
 ```bash
 # List all nodeTypes from a search
-uip flow registry search slack --output-filter "Nodes[*].nodeType"
+uip maestro flow registry search slack --output-filter "Nodes[*].nodeType"
 
 # Get the full enriched node
-uip flow registry get "uipath.connector.slack.send-message" \
+uip maestro flow registry get "uipath.connector.slack.send-message" \
   --output-filter "Node"
 
 # Extract only the input fields
-uip flow registry get "uipath.connector.slack.send-message" \
+uip maestro flow registry get "uipath.connector.slack.send-message" \
   --output-filter "Node.inputDefinition.fields"
 
 # Get the node count after a pull
-uip flow registry pull --output-filter "NodesCount"
+uip maestro flow registry pull --output-filter "NodesCount"
 ```
 
 Combine with `--output json` to get clean JSON output:
 
 ```bash
-uip flow registry get "uipath.connector.slack.send-message" \
+uip maestro flow registry get "uipath.connector.slack.send-message" \
   --output-filter "Node.inputDefinition.fields" --output json
 ```
 
@@ -347,20 +344,20 @@ uip flow registry get "uipath.connector.slack.send-message" \
 
 ```bash
 # 1. Pull the registry (once per session)
-uip flow registry pull
+uip maestro flow registry pull
 
 # 2. Search for candidates
-uip flow registry search slack --filter "displayname:contains=send" \
+uip maestro flow registry search slack --filter "displayname:contains=send" \
   --output-filter "Nodes[*].nodeType"
 # → uipath.connector.slack.send-message
 #   uipath.agent.resource.tool.connector.slack.send-message
 # Pick the uipath.connector.* variant for direct flow use.
 
 # 3. Inspect the full schema (with IS enrichment if logged in)
-uip flow registry get "uipath.connector.slack.send-message" --output json
+uip maestro flow registry get "uipath.connector.slack.send-message" --output json
 
 # 4. Extract just the input fields to build a request body
-uip flow registry get "uipath.connector.slack.send-message" \
+uip maestro flow registry get "uipath.connector.slack.send-message" \
   --output-filter "Node.inputDefinition.fields" --output json
 ```
 

package/dist/index.js

@@ -1005,7 +1005,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         this._exitCallback = (err) => {
           if (err.code !== "commander.executeSubCommandAsync") {
             throw err;
-          } else {}
+          }
         };
       }
       return this;