@uipath/skills 1.199.0 → 1.200.0

package/skills/uipath-rpa/references/legacy/activity-docs/UIAutomation.md

@@ -1,159 +0,0 @@
-# UiPath UIAutomation Activities - Legacy Reference
-
-## Overview
-Legacy desktop UI automation for Windows. Click, type, find elements, manage windows/browsers. Package: `UiPath.UIAutomation.Activities`.
-
----
-
-## Input Methods
-
-| Method | Constant | Speed | Reliability | Special Keys | Notes |
-|--------|----------|-------|-------------|--------------|-------|
-| Hardware Events (default) | SYNTHESIZE_INPUT | Slow | Most reliable | YES | Acquires input lock, blocks user input |
-| Window Messages | WINDOW_MESSAGES | Fast | Least reliable | YES | Best for classic Win32 apps |
-| UI Automation API | API | Medium | Very reliable | **NO** | SimulateClick/SimulateType; bypasses input |
-
-**CRITICAL: Cannot use SimulateClick AND SendWindowMessages simultaneously**
-**SimulateType + special keys produces design-time WARNING** (not hard error)
-
----
-
-## Key Activities
-
-### Mouse
-| Activity | Key Arguments | Defaults |
-|----------|---------------|----------|
-| `Click` | ClickType (Single/Double/Down/Up), MouseButton (Left/Right/Middle), KeyModifiers, CursorPosition, SimulateClick, SendWindowMessages | AlterIfDisabled=true |
-| `Hover` | CursorPosition, SimulateHover, SendWindowMessages | Hover duration ~1000ms |
-
-### Keyboard
-| Activity | Key Arguments | Defaults |
-|----------|---------------|----------|
-| `TypeInto` | Text, SimulateType, SendWindowMessages, Activate, ClickBeforeTyping, EmptyField, DelayBetweenKeys | Activate=true, AlterIfDisabled=true |
-| `TypeSecureText` | SecureText (SecureString) | Special keys escaped in non-Simulate mode |
-| `SendHotkey` | Key, SpecialKey, KeyModifiers | Activate=true |
-
-### Element Search
-| Activity | Key Arguments | Key Gotcha |
-|----------|---------------|------------|
-| `Element Exists` | Target | **Returns false instead of throwing on timeout** |
-| `Find Children` | Target, Filter, Scope | Returns lazy IEnumerable |
-| `Find Relative` | Target, CursorPosition (offset) | Returns first element at coordinates |
-| `Get Ancestor` | Target, UpLevels | Returns null at root |
-| `Wait Element Appear` | Target, WaitVisible, WaitActive | Adaptive polling: 50ms -> 200ms -> 1000ms |
-| `Wait Element Vanish` | Target, WaitNotVisible | Returns silently on timeout |
-
-### Element Attributes
-| Activity | Key Arguments | Notes |
-|----------|---------------|-------|
-| `Get Text` / `Get Value` | Target | Wraps GetAttribute("text") |
-| `Get Attribute` | Target, Attribute | Returns null if attribute doesn't exist |
-| `Set Value` | Target, Text | Uses SetAttribute("text") |
-| `Select Item` | Target, Item | Exact match usually required |
-| `Select Multiple Items` | Target, MultipleItems, AddToSelection | |
-| `Check` | Target, Action (Check/Uncheck/Toggle) | Toggle reads current state first |
-| `Wait Attribute` | Attribute, AttributeValue | Supports wildcards (* and ?); polls every 100ms |
-| `Get Position` | Target | Returns Rectangle (screen coordinates) |
-
-### Actions
-| Activity | Purpose |
-|----------|---------|
-| `Activate` | Bring window to foreground |
-| `Set Focus` | Set keyboard focus (doesn't foreground) |
-| `Highlight` | Debug visualization (blocking for duration) |
-| `Take Screenshot` | Capture element as Image |
-
-### Scopes
-| Activity | Key Arguments |
-|----------|---------------|
-| `Open Browser` | Url, BrowserType (IE/Chrome/Firefox/Edge), Private, NewSession, Hidden, CommunicationMethod |
-| `Open Application` | Selector, FileName, Arguments, WorkingDirectory |
-| `Window Scope` | Selector OR Window (mutually exclusive) |
-| `Browser Scope` | Selector OR Browser (mutually exclusive) |
-
----
-
-## Special Key Syntax (TypeInto)
-```
-[k(end)]        - End key
-[k(home)]       - Home key
-[k(del)]        - Delete key
-[k(backspace)]  - Backspace
-[k(enter)]      - Enter
-[k(tab)]        - Tab
-[k(escape)]     - Escape
-[k(ctrl+a)]     - Ctrl+A (press+release)
-[d(ctrl)]       - Ctrl down
-[u(ctrl)]       - Ctrl up
-[k(F1)]         - Function key F1-F12
-```
-
-**Authoring rule:** when any of these tokens appears in `Text`, write the value with child element syntax — not attribute form. The attribute form `Text="["13700132[k(enter)]"]"` runs correctly but the value will not render in Studio because the literal `[` / `]` inside the string collide with the outer VB expression markers. Use:
-
-```xml
-<uix:NTypeInto ...>
-  <uix:NTypeInto.Text>
-    <InArgument x:TypeArguments="x:String">["13700132[k(enter)]"]</InArgument>
-  </uix:NTypeInto.Text>
-</uix:NTypeInto>
-```
-
-See `../../xaml/common-pitfalls.md` § "NTypeInto `Text` with literal `[k(...)]` special-key tokens" for alternatives (`Chr(91)`/`Chr(93)` construction, split-activity).
-
----
-
-## Critical Gotchas
-
-### AlterIfDisabled Default
-1. **AlterIfDisabled=true by default** on Click, TypeInto, SetValue, SelectItem, Check - can interact with disabled/grayed controls unexpectedly
-
-### TypeInto Specifics
-2. **SimulateType CANNOT handle special keys** - fails validation if `[k(...)]` syntax detected
-3. **EmptyField uses hardcoded sequence**: `[k(end)d(shift)k(home)u(shift)k(del)]` - may fail for multi-line. **CRITICAL: EmptyField is silently ignored when SimulateType=true** - only works with hardware events and SendWindowMessages
-4. **DelayBetweenKeys max 1000ms** - validation error if exceeded
-5. **Activate=true by default** - may cause unwanted window switches
-
-### Selector Issues
-6. **Selector matching is fragile** - UI changes invalidate selectors
-7. **Placeholders** `{varName}` resolved at runtime - null variables cause failures
-8. **Closest matches** can return wrong element if multiple similar elements exist
-9. **Closest matches disabled in Exists** activity (returns false cleanly)
-
-### Click Specifics
-10. **SimulateClick cannot CLICK_DOUBLE with BTN_RIGHT or BTN_MIDDLE**
-11. **SimulateClick doesn't acquire input lock** - others do
-12. **CursorMotionType** affects how cursor moves (straight line, smooth, etc.)
-
-### Timing
-13. **Default timeout ~30,000ms** (30 seconds) across most activities
-14. **DelayBefore/DelayAfter are sequential** (Thread.Sleep internally)
-15. **WaitUiElementAppear adaptive polling**: 50ms -> 200ms -> 1000ms
-16. **Exists returns false instead of throwing** on timeout
-
-### Browser Scope
-17. **NewSession=true (default)** creates new browser process (slower but isolated)
-18. **NewSession=false** reuses existing browser (faster, shared state/cookies)
-19. **Private mode** may disable extensions/drivers
-20. **CommunicationMethod**: Native (UiPath driver) vs WebDriver (Selenium-based)
-
-### Window/Browser Scope Validation
-21. **Must set either Selector OR Window/Browser** - not both, not neither
-22. **If Window/Browser set, SearchScope cannot be set**
-
-### Image-Based Activities
-23. **Template matching** (not AI) - sensitive to resolution, brightness, minor UI changes
-24. **Slower than selector-based** - use only for unstable selectors
-
-### Error Handling
-25. **ContinueOnError=false by default** - exceptions thrown
-26. **Governance exceptions never suppressed** even with ContinueOnError=true
-
-### Additional Validated Gotchas
-27. **OpenBrowser defaults to IE** - BrowserType default is `BrowserType.IE`
-28. **Hover has fixed 1000ms duration** - hardcoded, not configurable
-29. **Default timeouts**: Timeout=30,000ms, DelayAfter=300ms, DelayBefore=200ms, OpenBrowser=60s
-30. **AlterIfDisabled NOT passed to node in hardware events mode for TypeInto** (but IS passed for Click) - inconsistent behavior
-31. **CursorMotionType.Smooth only works with hardware events** - has no effect with SimulateClick or SendWindowMessages
-32. **Data Scraping hardcodes ContinueOnError=true** - extraction failures produce empty DataTable, no error
-33. **SimulateClick MV3 workaround** - hidden project setting `EnableWorkaroundForSimulateClickMV3` (default false) needed for Chrome Manifest V3 extensions
-34. **Image OCR uses hardcoded 5-pixel offset** - can cause incorrect crops on small images

package/skills/uipath-rpa/references/legacy/common-pitfalls.md

@@ -1,318 +0,0 @@
-# Common Pitfalls & Quick Reference
-
-Essential gotchas, required scopes, and VB.NET patterns for legacy UiPath RPA workflows.
-
-For the complete gotchas list, see [activity-docs/_COMMON-PITFALLS.md](./activity-docs/_COMMON-PITFALLS.md).
-For the complete VB.NET cheat sheet, see [activity-docs/_PATTERNS.md](./activity-docs/_PATTERNS.md).
-
----
-
-## Flowcharts/StateMachines Without ViewState
-
-**Severity: HIGH.** Missing ViewState causes Studio to stack all nodes at (0,0) — unusable. Every Flowchart/StateMachine node needs `ShapeLocation` + `ShapeSize`. **Required xmlns:** `xmlns:av="http://schemas.microsoft.com/winfx/2006/xaml/presentation"`
-
-See [activity-docs/_XAML-GUIDE.md](./activity-docs/_XAML-GUIDE.md) for coordinate systems, standard sizes, layout algorithms, connector formulas, and complete examples.
-
----
-
-## Required Parent Scopes
-
-These classic activities **must** be placed inside a specific parent scope:
-
-| Activities | Required Parent Scope |
-|-----------|----------------------|
-| Excel Interop (ExcelReadRange, ExcelWriteCell, etc.) | `Excel Application Scope` |
-| Excel Modern (ReadRangeX, WriteRangeX, etc.) | `ExcelApplicationCard` inside `ExcelProcessScopeX` |
-| PowerPoint Interop (InsertSlide, InsertText, etc.) | `PowerPoint Application Scope` |
-| Word Interop (AppendText, ReplaceText, etc.) | `Word Application Scope` |
-| FTP activities (Download, Upload, Delete, etc.) | `FTP Session` (WithFtpSession) |
-| Java activities (InvokeJavaMethod, LoadJar, etc.) | `Java Scope` |
-| Python activities (RunScript, InvokeMethod, etc.) | `Python Scope` |
-| Terminal activities (GetField, SetField, SendKeys, etc.) | `Terminal Session` |
-| Office 365 activities (SendMail, CreateEvent, etc.) | `Microsoft Office 365 Scope` |
-| SAP BAPI activities (InvokeSapBapi) | `SAP Application Scope` |
-| SharePoint activities (GetListItems, UploadFile, etc.) | `SharePoint Application Scope` |
-
----
-
-## Scope Activities Require ActivityAction Body (CRITICAL for XAML Generation)
-
-Scope activities (Excel Application Scope, ExcelProcessScopeX, ExcelApplicationCard, Word Application Scope, etc.) do **NOT** accept direct children. They require an `ActivityAction<T>` body wrapper with a `DelegateInArgument`. `RetryScope` follows the same wrap-the-body rule but uses a bare `ActivityAction` (no `x:TypeArguments`, no `DelegateInArgument`) — see the per-activity table below. Placing activities directly inside the scope element will fail validation.
-
-**Wrong — direct children (fails validation):**
-```xml
-<ueab:ExcelApplicationCard WorkbookPath="file.xlsx">
-  <ueab:ReadRangeX ... />  <!-- WRONG -->
-</ueab:ExcelApplicationCard>
-```
-
-**Correct — ActivityAction body wrapper:**
-```xml
-<ueab:ExcelApplicationCard WorkbookPath="file.xlsx" DisplayName="Use Excel File">
-  <ueab:ExcelApplicationCard.Body>
-    <ActivityAction x:TypeArguments="ue:IWorkbookQuickHandle">
-      <ActivityAction.Argument>
-        <DelegateInArgument x:TypeArguments="ue:IWorkbookQuickHandle" Name="Excel" />
-      </ActivityAction.Argument>
-      <Sequence DisplayName="Do">
-        <!-- Child activities go here, using Excel handle -->
-        <ueab:ReadRangeX Range="[Excel.Sheet(&quot;Sheet1&quot;).Range(&quot;A1:A20&quot;)]" />
-      </Sequence>
-    </ActivityAction>
-  </ueab:ExcelApplicationCard.Body>
-</ueab:ExcelApplicationCard>
-```
-
-### Common Scope Body Patterns
-
-| Activity | Body TypeArgument | DelegateInArgument Name | Notes |
-|----------|-------------------|------------------------|-------|
-| `ExcelProcessScopeX` | `ui:IExcelProcess` | `ExcelProcessScopeTag` | Outer Excel scope |
-| `ExcelApplicationCard` | `ue:IWorkbookQuickHandle` | `Excel` | Inner Excel scope (inside ExcelProcessScopeX) |
-| `ExcelApplicationScope` | `ue:WorkbookApplication` | `ExcelWorkbookScope` | Classic Interop scope |
-| `ForEachRow` | `ActivityAction(sd:DataRow)` | `row` | Iterates DataTable rows |
-| `WordApplicationScope` | (Word handle type) | `WordApplicationScope` | Word COM scope |
-| `PowerPointApplicationScope` | (PowerPoint handle type) | `PowerPointApplication` | PowerPoint COM scope |
-| `TryCatch` | (special — `Catches` collection) | — | Not ActivityAction, but has nested body structure |
-| `Parallel` | (multiple `Branches`) | — | Each branch is a separate Sequence |
-| `RetryScope` | _(none — bare `<ActivityAction>`)_ | — | Body property is `.ActivityBody` (not `.Body`); `ActivityAction` takes no type argument or `DelegateInArgument` |
-
-**`find-activities` now returns `Body` info** when an activity requires an `ActivityAction<T>` body — check the output before writing XAML for scope activities.
-
-**Key xmlns required:**
-- `xmlns:ue="clr-namespace:UiPath.Excel;assembly=UiPath.Excel.Activities"`
-- `xmlns:ueab="clr-namespace:UiPath.Excel.Activities.Business;assembly=UiPath.Excel.Activities"`
-- `xmlns:ui="http://schemas.uipath.com/workflow/activities"`
-- `xmlns:sd="clr-namespace:System.Data;assembly=System.Data"` (for ForEachRow DataRow type)
-
-**Nested scopes:** Modern Excel requires TWO levels: `ExcelProcessScopeX` → `ExcelApplicationCard` → activities. Each level has its own `ActivityAction` body.
-
-**Always check `find-activities` output** for body pattern info before using scope activities.
-
----
-
-## Dangerous Defaults (Source Code Verified)
-
-### ContinueOnError Defaults to TRUE
-These activities **silently swallow all errors** by default:
-
-| Activity | Package | Impact |
-|----------|---------|--------|
-| `NetHttpRequest` / `HttpClient` (HTTP Request) | Web | HTTP 500/timeout → empty response, no error |
-| `Data Scraping` wizard output | UIAutomation | Extraction failure → empty DataTable |
-
-**Always** set `ContinueOnError=False` on HTTP Request activities.
-
-### ContinueOnError in Library Workflows
-**NEVER** use `ContinueOnError=True` in Library workflows. Library consumers cannot know which errors are silently swallowed. Always let exceptions propagate from libraries — the consuming process decides how to handle them.
-
-### Excel AutoSave Causes Performance Disasters
-`AutoSave=true` (default) on `ExcelApplicationScope` means every Write Cell triggers a disk write. In loops with 1000 operations, that's 1000 saves.
-
-**Fix:** Set `AutoSave=false`, add a single `Save Workbook` at the end.
-
-### OpenBrowser Defaults to Internet Explorer
-`BrowserType` defaults to `IE` in source code. **Always explicitly set** BrowserType to Chrome, Firefox, or Edge.
-
-### HTTP Request Very Short Timeout
-Legacy `HttpClient` (also called `NetHttpRequest` internally) timeout is only 6,000-10,000ms. Both are often too low for production APIs.
-
-**Fix:** Set `TimeoutMS` to 30,000-60,000ms.
-
----
-
-## VB.NET Quote Escaping in Throw.Exception (CRITICAL for XAML Generation)
-
-The `Throw.Exception` attribute wraps the bracket expression in `VisualBasicValue<Exception>`. When fully-qualified class names are combined with complex string expressions containing multiple `&quot;`, the VB.NET compiler can reject the expression — even though the same `&quot;` escaping works fine in simpler attributes like `LogMessage.Message`.
-
-### What fails
-
-```xml
-<!-- FAILS: Fully-qualified name + complex string concatenation -->
-<Throw Exception="[New UiPath.Core.Activities.BusinessRuleException(&quot;Invalid amount: &quot; &amp; amount.ToString(&quot;F2&quot;) &amp; &quot; for &quot; &amp; txId)]" />
-
-<!-- FAILS: String.Format with multiple &quot; inside brackets -->
-<Throw Exception="[New UiPath.Core.Activities.BusinessRuleException(String.Format(&quot;Invalid amount: {0} for {1}&quot;, amount, txId))]" />
-```
-
-### What works
-
-**Approach 1: Short-form class name + simple expression (recommended for simple messages)**
-```xml
-<!-- Works: Short name (namespace already imported) + simple concatenation -->
-<Throw Exception="[New BusinessRuleException(&quot;Invalid amount for &quot; &amp; txId)]" />
-```
-
-**Approach 2: Variable for message, then Throw (recommended for complex messages)**
-```xml
-<!-- Best practice from codebase: construct message in a variable, then throw -->
-<Assign DisplayName="Build Error Message">
-  <Assign.To>
-    <OutArgument x:TypeArguments="x:String">[errorMessage]</OutArgument>
-  </Assign.To>
-  <Assign.Value>
-    <InArgument x:TypeArguments="x:String">["Invalid amount: " &amp; amount.ToString("F2") &amp; " for transaction " &amp; txId]</InArgument>
-  </Assign.Value>
-</Assign>
-<Throw Exception="[New BusinessRuleException(errorMessage)]" />
-```
-
-### Rules
-
-1. **Always use short-form class names** in `Throw.Exception` — `BusinessRuleException` not `UiPath.Core.Activities.BusinessRuleException`. Ensure `UiPath.Core.Activities` is in the namespace imports.
-2. **For complex messages, use the variable approach** — Assign the message string to a variable first, then pass the variable to the exception constructor.
-3. **For simple messages, inline is fine** — `[New BusinessRuleException(&quot;simple message&quot;)]` works.
-4. **Same rules apply to all exception types** — `Exception`, `BusinessRuleException`, `ArgumentException`, etc.
-
-### Why this happens
-
-`Throw.Exception` compiles the bracket expression via `VisualBasicValue<Exception>`. The combination of a long fully-qualified type path + embedded `&quot;` string literals with concatenation operators creates ambiguity for the VB.NET expression compiler. Shorter expressions or variable references avoid this.
-
----
-
-## Top Gotchas by Package
-
-### Excel
-- **Zombie EXCEL.EXE processes** after workflow crashes — use Kill Process in Finally block
-- **Dates read as serial numbers** — set `PreserveFormat=true` or convert with `DateTime.FromOADate()`
-- **Empty DataTable from Read Range** — verify sheet name, use `""` for entire used range
-- **Write Range strips formatting** — use Write Cell in loops for small updates
-
-### UIAutomation
-- **TypeInto missing/wrong characters** — escape `{`, `}`, `[`, `]`, `+`, `^`, `%`, `~` with `{{}`, `{+}` etc.
-- **EmptyField ignored with SimulateType** — only works with hardware events or SendWindowMessages
-- **Selectors work in Studio, fail on Robot** — use SimulateClick/SimulateType, avoid `idx` attribute
-- **Dynamic selectors break** — use wildcards `*` for dynamic parts, prefer `AutomationId`
-
-### Mail
-- **SMTP auth fails with Gmail/M365** — use App Passwords or OAuth2, not "Less Secure Apps"
-- **SSL/TLS port mismatch** — Port 587 = STARTTLS, Port 465 = implicit SSL, Port 25 = unencrypted
-- **Multiple recipients** — use semicolons `;` not commas
-
-### Web
-- **HTTP Request ContinueOnError=TRUE by default** — errors silently swallowed
-- **Legacy HttpClient 6-second timeout** — increase to 30-60 seconds
-
-### PDF
-- **ReadPDFText returns empty** — PDF is scanned images, use Read PDF With OCR instead
-- **Text out of order** — set `PreserveFormatting=true`
-
-### GenericValue
-- **String comparison instead of numeric** — `"10" > "9"` returns False. Use `CInt()` explicitly.
-- **Boolean conversion trap** — ANY non-null, non-empty string converts to `True`
-- **Null converts to 0** — `GenericValue(null)` → int returns `0`, → DateTime returns `DateTime.MinValue`
-
-**Recommendation:** Avoid GenericValue entirely. Use strongly-typed variables.
-
----
-
-## VB.NET Quick Reference
-
-### String Operations
-```vb
-"Hello " + variable + " World"              ' Concatenation
-String.IsNullOrEmpty(myVar)                  ' Null/empty check
-If(myVar Is Nothing, "default", myVar.ToString())  ' Null coalesce
-myString.Contains("search")                  ' Contains
-myString.Replace("old", "new")               ' Replace
-myString.Split({";"c}, StringSplitOptions.RemoveEmptyEntries)  ' Split
-```
-
-### Type Conversions
-```vb
-CInt(stringVar)                ' String to Integer
-CDbl(stringVar)                ' String to Double
-CDate(stringVar)               ' String to Date
-CType(objVar, String)          ' Object to specific type
-DirectCast(objVar, DataTable)  ' Object to DataTable
-```
-
-### DateTime
-```vb
-DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")
-DateTime.Now.AddDays(7)
-(endDate - startDate).TotalDays
-```
-
-### Collections
-```vb
-New String() {"item1", "item2"}              ' Array
-New List(Of String) From {"a", "b"}          ' List
-New Dictionary(Of String, Object) From {{"key", "value"}}  ' Dictionary
-```
-
-### DataTable Access
-```vb
-row("ColumnName").ToString()                 ' Cell by name
-row(0).ToString()                            ' Cell by index
-Convert.ToInt32(row("Amount"))               ' Typed value
-dt.Select("[Status] = 'Active'")             ' Filter (returns DataRow[])
-dt.AsEnumerable().Where(Function(r) r("Col").ToString() = "Val").CopyToDataTable()  ' LINQ
-```
-
-### Error Handling
-```vb
-' Use Try-Catch activity (not code)
-' BusinessRuleException → skip item
-' System.Exception → retry/escalate
-' Always set ContinueOnError=False on HTTP Request
-```
-
-For the complete reference with DataTable operations, file paths, Orchestrator patterns, and deprecated activity mappings, see [activity-docs/_PATTERNS.md](./activity-docs/_PATTERNS.md).
-
----
-
-## Common XAML Generation Mistakes
-
-These are patterns the agent is likely to produce incorrectly. Check for them after generating XAML.
-
-### Hallucination-Prone Activity Names
-
-| Wrong (invented) | Correct | Package |
-|---|---|---|
-| `ReadExcel`, `WriteExcel` | `ExcelReadRange`, `ExcelWriteRange` | Excel |
-| `SendEmail` | `SendSmtpMailMessage`, `SendOutlookMailMessage` | Mail |
-| `OpenBrowserActivity` | `OpenBrowser` | UIAutomation |
-| `ReadPdf` | `ReadPDFText`, `ReadPDFWithOCR` | PDF |
-| `HttpRequest` | `HttpClient` (also known as `NetHttpRequest`) | Web |
-
-**Rule:** NEVER guess activity names. Run `find-activities` to get the exact class name.
-
-### Nesting Errors
-
-| Mistake | Fix |
-|---|---|
-| Multiple children directly inside `If.Then` or `If.Else` | Wrap in a single `Sequence` |
-| Activities directly inside `ForEach` body | Use `ActivityAction` wrapper (see Scope Activities section above) |
-| Activities directly inside scope activities (Excel, Word, etc.) | Use `ActivityAction<T>` body pattern |
-| ViewState referencing nodes that don't exist in the workflow | Remove orphaned ViewState entries, or add the missing nodes |
-
-### Expression Language Mismatches
-
-| Mistake | Symptom | Fix |
-|---|---|---|
-| C# operators (`!=`, `&&`, `\|\|`) in VB.NET project | Compilation error | Use `<>`, `AndAlso`, `OrElse` |
-| C# string interpolation `$"..."` in VB.NET project | Compilation error | Use `String.Format` or `&` concatenation |
-| VB.NET `[bracket]` expressions in C# project | Compilation error | Use `<mca:CSharpValue>` or `<mca:CSharpReference>` |
-
-### Security Anti-Patterns
-
-| Anti-Pattern | Risk | Fix |
-|---|---|---|
-| Password stored in `String` variable | Visible in logs and memory dumps | Use `SecureString` type |
-| Hardcoded API keys or JWT tokens in XAML | Credentials in source control | Use Orchestrator Credential assets |
-| Hardcoded URLs in activity properties | Breaks across environments | Use Config.xlsx Settings or Orchestrator Text assets |
-| Empty Catch blocks (`Catch ex As Exception` with no body) | Silent failures, impossible to debug | At minimum, add `Log Message` with `ex.Message` |
-| Timeout values as magic numbers (`30000`) | Unclear intent, hard to tune | Use Config.xlsx Constants with descriptive names |
-
----
-
-## Deprecated Activity → Replacement
-
-| Deprecated | Replacement |
-|-----------|-------------|
-| `OpenWorkbook` | `Excel Application Scope` |
-| `CloseWorkbook` | (scope handles cleanup) |
-| `ExcelForEachRow` (v1) | `For Each Row in Data Table` |
-| `KeywordBasedClassifier` | `IntelligentKeywordClassifier` |
-| `OutlookForEachMail` | `For Each Email` |

package/skills/uipath-rpa/references/legacy/discovery-workflow.md

@@ -1,147 +0,0 @@
-# Discovery Workflow — Detailed Steps
-
-Complete discovery procedure before writing or editing any XAML. Referenced from the main skill when detailed guidance is needed.
-
----
-
-## Step 1: Project Structure
-
-```
-Glob: pattern="**/*.xaml" path="{projectRoot}"       → list all XAML workflow files
-Read: file_path="{projectRoot}/project.json"          → read the project definition
-```
-
-Analyze: folder conventions, naming patterns, existing workflows, `expressionLanguage` (VB.NET or C#), installed packages (`dependencies`).
-
----
-
-## Step 2: Consult Activity Reference Docs
-
-Read `references/activity-docs/` for behavioral context (what activities do, gotchas, patterns).
-
-| Situation | Action |
-|-----------|--------|
-| Know the package | Read `activity-docs/{PackageName}.md` directly |
-| Don't know the package | Read `activity-docs/_INDEX.md` to find it |
-| Need VB.NET expressions | Read `activity-docs/_PATTERNS.md` |
-| Need XAML structure | Read `references/xaml-basics-and-rules.md` |
-| Need gotchas | Read `activity-docs/_COMMON-PITFALLS.md` |
-| Need InvokeCode patterns | Read `activity-docs/_INVOKE-CODE.md` |
-| Working with REFramework | Read `activity-docs/_REFRAMEWORK.md` |
-| Working with Document Understanding | Read `activity-docs/_DU-PROCESS.md` |
-| Need all activities | Read `activity-docs/AllActivities.md` |
-
-**These docs tell you what and how — NOT exact CLR property names/enum values for XAML. Steps 4 and 5 are mandatory for that.**
-
----
-
-## Step 3: Search Current Project
-
-```
-Glob: pattern="**/*pattern*.xaml" path="{projectRoot}"
-Grep: pattern="ActivityName|pattern" path="{projectRoot}"
-Read: file_path="{projectRoot}/ExistingWorkflow.xaml"
-```
-
-Mature project: prioritize local patterns. Greenfield: skip.
-
----
-
-## Step 4: Discover Activities (MANDATORY for non-built-in activities)
-
-**Skip find-activities for built-in activities** listed in [_BUILT-IN-ACTIVITIES.md](./activity-docs/_BUILT-IN-ACTIVITIES.md): If, Assign, Sequence, TryCatch, Flowchart, ForEach, While, Switch, Throw, Delay, Parallel, LogMessage, InvokeCode, InvokeWorkflowFile, ForEachRow, AddDataRow. Use the provided XAML snippets directly.
-
-**For all other activities**, run find-activities. Returns exact class names, argument signatures, types, **ready-to-use XAML snippet**, and **xmlns declaration**.
-
-```bash
-uip rpa-legacy find-activities "{projectRoot}" --query "send mail" --output json
-uip rpa-legacy find-activities "{projectRoot}" --query "invoke code" --include-type-definitions --output json
-```
-
-**Use the returned `XamlSnippet` as your starting point** for activity XAML — it has correct element names, namespaces, and property names for the installed package version. Also add the returned `XmlnsDeclaration` to the root `<Activity>` element.
-
-**Query syntax tips:**
-- **Multi-word queries work** with relevance scoring: `"Excel Read Range"` splits into words, scores matches, bonuses when all words match
-- **CamelCase boundaries detected**: `"SendHotkey"`, `"ExcelReadRange"` match correctly
-- **Use `--exact`** when you know the exact activity name: `--query "ReadRange" --exact` — avoids irrelevant results
-- Each call takes ~15-30 seconds — use `--exact` for known names to get precise results fast
-- If a query returns too many irrelevant results, add `--exact` or use more specific terms
-
-Activity reference docs describe behavior/gotchas but NOT exact CLR class names or argument types. Skipping this step → guessing → wasted validation cycles.
-
----
-
-## Step 5: Inspect Types (MANDATORY for Enums/Complex Types)
-
-**Run for every enum or complex type.** Gets exact valid values.
-
-```bash
-# Example: InvokeCode Language accepts VBNet and CSharp (NOT "VisualBasic" or "VB")
-uip rpa-legacy type-definition "{projectRoot}" --type "NetLanguage" --output json
-
-uip rpa-legacy type-definition "{projectRoot}" --type "System.Net.Mail.MailMessage" --output json
-```
-
-When to run: any enum property, any complex type argument, any type without listed valid values in docs.
-
----
-
-## Step 5.5: Search NuGet for Packages (When Needed)
-
-When the known packages in [project-structure.md](./project-structure.md) and `find-activities` don't cover a capability:
-
-```bash
-uip rpa-legacy find-package --query "barcode" --limit 10 --output json
-```
-
-Searches all configured NuGet feeds by name and description. After finding the right package, add it to `dependencies` in project.json, then `find-activities` will index its activities.
-
-Also works for arbitrary .NET packages (e.g., `CsvHelper`, `HtmlAgilityPack`). Avoid packages already bundled with Studio (e.g., `Newtonsoft.Json`) — version conflicts can cause issues.
-
----
-
-## Step 6: Search UiPath Documentation (Fallback)
-
-```bash
-uip docsai ask "best practices for Excel automation in legacy projects" --output json
-uip docsai ask "ExcelApplicationScope ActivityAction body validation error" --output json
-```
-
-Use when: bundled docs + CLI tools don't cover the topic, need best practices/guidelines/troubleshooting, unfamiliar error, platform concepts (Orchestrator, queues, triggers).
-
----
-
-## Step 7: Search the Web (Last Resort)
-
-Use `WebSearch` for UiPath Forum, Stack Overflow, GitHub, Reddit:
-
-```
-WebSearch: "UiPath forum ExcelApplicationScope ActivityAction body legacy"
-WebSearch: "site:stackoverflow.com UiPath legacy ExcelApplicationScope XAML"
-WebSearch: "site:github.com UiPath REFramework legacy XAML example"
-```
-
-Use when: all previous steps fail, obscure errors, community workarounds needed. Always verify web-sourced info against project config.
-
----
-
-## Troubleshooting
-
-### Wrong enum value
-**Symptom:** "Cannot create unknown type" or "is not a member of"
-**Fix:** `uip rpa-legacy type-definition "{projectRoot}" --type "EnumTypeName" --output json`
-
-### Activity class name not found
-**Symptom:** Unknown activity type or missing namespace
-**Fix:** `uip rpa-legacy find-activities "{projectRoot}" --query "..." --output json`, add xmlns + assembly ref
-
-### Multiple errors after batch editing
-**Symptom:** Many errors at once
-**Fix:** Revert to last good state. Re-add one activity at a time, validating after each.
-
-### Activity docs don't match XAML property names
-**Symptom:** Properties from docs don't work
-**Fix:** `find-activities --include-type-definitions` for exact CLR property names
-
-### Stuck on unfamiliar problem
-**Escalation:** `docsai ask` → `WebSearch` → ask user