@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 +1 -1
- package/skills/uipath-maestro-bpmn/references/operate/CAPABILITY.md +0 -9
- package/skills/uipath-maestro-bpmn/references/shared/local-metadata-regeneration-guide.md +3 -20
- package/skills/uipath-maestro-flow/references/author/greenfield.md +1 -1
- package/skills/uipath-maestro-flow/references/author/plugins/inline-voice-agent/impl.md +1 -1
- package/skills/uipath-maestro-flow/references/author/plugins/inline-voice-agent/planning.md +1 -1
- package/skills/uipath-maestro-flow/references/shared/cli-conventions.md +1 -1
- package/version-manifest.json +1 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@uipath/skills",
|
|
3
|
-
"version": "1.203.1
|
|
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.
|
|
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
|
|
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://
|
|
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://
|
|
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
|
|
135
|
+
uip login --authority "<AUTHORITY_URL>" # non-default host (Automation Suite, dedicated)
|
|
136
136
|
```
|
|
137
137
|
|
|
138
138
|
## 6. `--folder-key` requirement
|
package/version-manifest.json
CHANGED