@uipath/skills 1.203.1-preview.1177 → 1.203.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@uipath/skills",
3
- "version": "1.203.1-preview.1177",
3
+ "version": "1.203.1",
4
4
  "description": "UiPath agent skills for Claude Code, Codex, Cursor, Copilot, Gemini and OpenCode — RPA, UI automation, UI testing, coded agents/apps/workflows, and troubleshooting. Distributed as the UiPath Claude Code plugin.",
5
5
  "author": {
6
6
  "name": "UiPath"
@@ -32,19 +32,10 @@ These actions may contact UiPath services or external systems.
32
32
  migrate, and cursor movement require a clear user decision for that action.
33
33
  3. **Validate before operate** - do not upload, publish, debug, or run until Author validation is complete or the user
34
34
  explicitly accepts known draft warnings.
35
- <<<<<<< HEAD
36
35
  4. **Refresh package metadata before cloud actions** - run `uip maestro bpmn refresh <project-path> --output json`;
37
36
  `Data.WrittenFiles` names what was stale. Never use the deprecated `update-metadata` - it does not materialize
38
37
  `Intsvc.*` connection bindings. Stale `bindings_v2.json`, `entry-points.json`,
39
38
  `operate.json`, or `package-descriptor.json` can break import or runtime even when the BPMN source is correct.
40
- =======
41
- 4. **Refresh package metadata before cloud actions** - after source validation,
42
- run `uip maestro bpmn refresh <project-path> --output json`
43
- (the deprecated `uip maestro bpmn update-metadata <file.bpmn> --dry-run` checks drift
44
- without writing). Stale `bindings_v2.json`, `entry-points.json`,
45
- `operate.json`, or `package-descriptor.json` can break import or runtime
46
- even when the BPMN source is correct.
47
- >>>>>>> 0770c04c1 (docs(bpmn): make refresh the single documented metadata contract)
48
39
  5. **Keep source and package ownership clear** - fix process structure, variables, mappings, events, and documented non-IS
49
40
  extensions in `.bpmn`; rerun CLI generation/enrichment for generated package JSON and Integration Service metadata.
50
41
  6. **Default publish wording to Studio Web upload unless the user explicitly asks for Orchestrator deployment** - keep deploy semantics explicit.
@@ -2,16 +2,14 @@
2
2
 
3
3
  Use this guide when BPMN source changed and local package metadata must be refreshed or verified before packaging, upload, debug, publish, or deploy.
4
4
 
5
- <<<<<<< HEAD
6
5
  **Do NOT apply it to an Integration Service draft or boundary handoff.** When the task is to author a local BPMN draft and hand connector enrichment to the CLI (no upload/pack yet), `entry-points.json`, `bindings_v2.json`, `operate.json`, and `package-descriptor.json` stay CLI-owned — do not hand-author or pre-generate them. Author only the `.bpmn` source shape plus a `.md` notes file **inside the project directory** naming the CLI-owned blockers. The regeneration workflow below reaches such a project only once its connectors are enriched.
7
- =======
6
+
8
7
  The BPMN `refresh` command is the authoritative local source-to-derived-state
9
8
  boundary. It requires exactly one project-root `.bpmn` file
10
9
  and atomically regenerates the complete package metadata set. The command is
11
10
  offline and provider-neutral: it does not log in, discover a tenant, invoke a
12
11
  connector, or resolve an account. It consumes only identities already authored
13
12
  into the supported BPMN contract.
14
- >>>>>>> b77a95d33 (feat(bpmn): derive package metadata with refresh)
15
13
 
16
14
  ## Ownership
17
15
 
@@ -81,23 +79,17 @@ Do not derive metadata from stale package files first. Use existing generated fi
81
79
  ## Safe Local Workflow
82
80
 
83
81
  1. Edit `.bpmn` first.
84
- <<<<<<< HEAD
85
82
  2. Check the source itself: well-formed XML, diagrams, entry point IDs,
86
83
  variables, mappings, binding references. Do not run `uip maestro bpmn
87
84
  validate` yet — it cross-checks `entry-points.json` against the source, so it
88
85
  reports the pre-refresh state as an error whenever an edit renamed a start
89
86
  event. Run it after step 3.
90
87
  3. Regenerate package metadata from the BPMN source:
91
- =======
92
- 2. Run local validation for XML, diagrams, entry point IDs, variables, mappings, binding references, and package metadata drift.
93
- 3. After validation succeeds, regenerate derived metadata:
94
- >>>>>>> b77a95d33 (feat(bpmn): derive package metadata with refresh)
95
88
 
96
89
  ```bash
97
90
  uip maestro bpmn refresh <project-path> --output json # regenerate + materialize IS connection bindings
98
91
  ```
99
92
 
100
- <<<<<<< HEAD
101
93
  `refresh` materializes `Intsvc.*` connection bindings (including triggers)
102
94
  and validates before writing. It needs `project.uiproj` — without one it
103
95
  exits `BpmnRefreshFailed` / `RetryWillNotFix`; for a bare `.bpmn`, write the
@@ -105,21 +97,12 @@ Do not derive metadata from stale package files first. Use existing generated fi
105
97
  stale and `Data.UnchangedFiles` the ones already current, so a drift answer
106
98
  needs no separate command. Never fall back to the deprecated
107
99
  `update-metadata`.
108
- =======
109
- A successful response reports `Status`, `ProjectPath`, `BpmnFile`,
110
- `WrittenFiles`, and `UnchangedFiles`.
111
-
112
- Use `refresh` — it materializes `Intsvc.*` connection bindings (including
113
- triggers) and validates before writing. The deprecated
114
- `uip maestro bpmn update-metadata <file.bpmn>` (with `--dry-run` for a
115
- drift check) only rewrites the BPMN-derived fields and does **not** materialize
116
- connection bindings.
117
- >>>>>>> 0770c04c1 (docs(bpmn): make refresh the single documented metadata contract)
118
100
 
119
101
  If CLI unavailable for a local-only synthetic project, write the minimal
120
102
  placeholder-safe shape (see below) before continuing.
121
103
 
122
- 4. Verify the project directory now contains the full metadata set:
104
+ 4. Run `uip maestro bpmn validate <file.bpmn> --output json`, then verify the
105
+ project directory contains the full metadata set:
123
106
  `project.uiproj`, `operate.json`, `entry-points.json`, `bindings_v2.json`,
124
107
  and `package-descriptor.json`. Run refresh a second time only when checking
125
108
  idempotence; unchanged source must leave all four generated files unchanged.
@@ -68,7 +68,7 @@ If not logged in and you need tenant nodes:
68
68
 
69
69
  ```bash
70
70
  uip login # interactive OAuth (opens browser)
71
- uip login --authority https://alpha.uipath.com # non-production environments
71
+ uip login --authority "<AUTHORITY_URL>" # non-default host (Automation Suite, dedicated)
72
72
  ```
73
73
 
74
74
  When you do need it, emit `uip login status --output json` as a parallel `Bash` inside T1.
@@ -247,7 +247,7 @@ Outbound needs no binding step — `inputs.from` names the trunk directly, so th
247
247
  | `flow pack` / `flow debug`: `Converted BPMN carries no agentDefinition for voice agent node(s) …` | Different failure from the row above — the agent directory is fine, but the CLI's bundled `@uipath/flow-converter` does not forward `voiceAgentDefinitions` to the BPMN serializer. Pack catches it rather than shipping a package that deploys and drops every call | `uip tools update` to a CLI whose converter supports voice, then re-pack. Nothing in the project can work around an old converter |
248
248
  | `registry get` reports the voice type not found | The installed CLI predates voice support (the types ship in its bundled registry, so this is a CLI-version problem, not a tenant one) | `uip tools update`; re-run `registry get` |
249
249
  | `uip conversational trunks …`: `unknown command 'trunks'` (and `uip conversational --help` lists no `trunks`) | The CLI predates the trunk commands. Independent of node support: the voice node types ship in the bundled registry, so authoring, `registry get`, and `validate` all work on a CLI whose `conversational` tool has no `trunks` | Tool packages resolve on the CLI's own `N.Nx` minor line, so `uip tools update` cannot pull a `trunks` that only exists on a later line — the CLI itself has to be on one that ships it (`uip --version`, and `which -a uip` when more than one is installed). A trunk's number and direction flags are also readable from the Phone numbers page. Note a tool's `-dev.<run>` number is a global CI counter, not a per-line one: a tool run number higher than the CLI's says nothing about which line it came from |
250
- | Call never connects on a tenant that packs and deploys fine | No SIP trunk provisioned, or the number lacks the direction your topology needs — not detectable from the CLI at author time | `uip conversational trunks list` to see whether the tenant has any trunk at all. Adding a number, enabling a direction on it, and releasing it are portal-only — send the user to `{baseUrl}/{orgName}/agents_/phone-numbers` (e.g. `https://alpha.uipath.com/conversationalagents/agents_/phone-numbers`). Raise it as an Open Question rather than re-authoring the flow |
250
+ | Call never connects on a tenant that packs and deploys fine | No SIP trunk provisioned, or the number lacks the direction your topology needs — not detectable from the CLI at author time | `uip conversational trunks list` to see whether the tenant has any trunk at all. Adding a number, enabling a direction on it, and releasing it are portal-only — send the user to `{baseUrl}/{orgName}/agents_/phone-numbers` (e.g. `https://cloud.uipath.com/conversationalagents/agents_/phone-numbers`). Raise it as an Open Question rather than re-authoring the flow |
251
251
  | Call connects but the agent is silent / call drops immediately | Package built without the embedded `agentDefinition` (hand-rolled pack pipeline), or `settings.voice` removed after pack | Re-pack with the CLI; verify the staged `.bpmn` has `name="agentDefinition"` on the voice serviceTask |
252
252
  | Outbound call never dials | `from` is not a SIP trunk number on the tenant, or `to` is malformed, or the trunk exists but is not outbound-enabled | `uip conversational trunks list --direction outbound --output json`; use a number with `outboundEnabled: true` for `from`; `to` must be E.164 in a literal binding. Turning outbound *on* for an existing number is portal-only — the Phone numbers page, `{baseUrl}/{orgName}/agents_/phone-numbers` |
253
253
  | Inbound number rings but nothing runs | Trunk not bound, bound to a different process, or bound to an older build | `uip conversational trunks list --direction inbound --output json` — check `processName` and that `entryPoint` matches the trigger's `inputs.entryPointId`; re-run `trunks assign` (§ Bind an Inbound Phone Number) |
@@ -32,7 +32,7 @@ uip conversational trunks list --direction inbound --output json # inbound bi
32
32
 
33
33
  ```text
34
34
  {baseUrl}/{orgName}/agents_/phone-numbers
35
- # e.g. https://alpha.uipath.com/conversationalagents/agents_/phone-numbers
35
+ # e.g. https://cloud.uipath.com/conversationalagents/agents_/phone-numbers
36
36
  ```
37
37
 
38
38
  It is org-scoped (no tenant segment) — build it from `uip login status --output json` (`Data.BaseUrl` + `Data.Organization`). There is no `trunks create`.
@@ -132,7 +132,7 @@ Log in interactively by running:
132
132
 
133
133
  ```bash
134
134
  uip login
135
- uip login --authority https://alpha.uipath.com # non-production environments
135
+ uip login --authority "<AUTHORITY_URL>" # non-default host (Automation Suite, dedicated)
136
136
  ```
137
137
 
138
138
  ## 6. `--folder-key` requirement
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "schemaVersion": 2,
3
- "skillsVersion": "1.203.1-preview.1177",
3
+ "skillsVersion": "1.203.1",
4
4
  "targetCli": "^1.203.0"
5
5
  }