@uipath/skills 1.195.0

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

@@ -0,0 +1,32 @@
+# UiPath Cognitive Activities - Legacy Reference
+
+## Overview
+AI/ML text analysis and translation via cloud cognitive services. Package: `UiPath.Cognitive.Activities`.
+
+---
+
+## Activities
+
+| Activity | Service | Key I/O |
+|----------|---------|---------|
+| `GoogleTextAnalysis` | Google Cloud NLP | Text, Key -> Sentiment, Magnitude, Entities, KeyPhrases |
+| `GoogleTextTranslate` | Google Translate | Text, Key, SourceLanguage, TargetLanguage -> TranslatedText |
+| `MicrosoftTextAnalysis` | Azure Text Analytics | Text, Key -> Sentiment, KeyPhrases |
+| `IbmWatsonTextAnalysis` | IBM Watson NLU | Text, Key -> Sentiment, Entities |
+| `IbmWatsonNluTextAnalysis` | IBM Watson NLU v2 | Text, Key -> Detailed NLU analysis |
+| `StanfordCoreNlpTextAnalysis` | Stanford CoreNLP | Text -> Sentiment, Entities, Components |
+| `StanfordCoreNlpGetComponents` | Stanford CoreNLP | Text -> Parsed components |
+| `StanfordCoreNlpGetOpenIE` | Stanford CoreNLP | Text -> Open IE triples |
+| `StanfordCoreNlpGetSentenceSentiment` | Stanford CoreNLP | Text -> Per-sentence sentiment |
+
+---
+
+## Critical Gotchas
+
+1. **API keys required** for each cloud service (Google, Microsoft, IBM) - not bundled
+2. **Network connectivity mandatory** for all cloud services
+3. **Different result structures** per provider - not normalized
+4. **Legacy .NET 4.5.2 package** - consider modern AI activities for new projects
+5. **Stanford CoreNLP** can run locally (no API key needed) but requires Java runtime
+6. **Rate limiting** applies per cloud provider - handle 429 responses
+7. **Sentiment scores range differently**: Google (-1 to 1), Azure (0 to 1), Watson (varies)

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

@@ -0,0 +1,28 @@
+# UiPath Communications Mining Activities - Legacy Reference
+
+## Overview
+Data validation workflows for Communications Mining AI engine (email/chat classification). Package: `UiPath.CommunicationsMining.Activities`.
+
+---
+
+## Activities
+
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `CreateCommunicationsMiningValidationAction` | Create Action Center task | ActionTitle, ActionPriority, ActionCatalogue -> CreatedValidationAction |
+| `CreateCommunicationsMiningValidationArtifacts` | Upload training data | OrchestratorBucketFolderPath |
+| `RetrieveCommunicationsMiningValidationArtifacts` | Download validated data | ContentValidationData, RemoveDataFromStorage -> StreamResult |
+| `WaitForCommunicationsMiningValidationAction` | Wait for human review | (blocks until Action Center complete) |
+
+---
+
+## Critical Gotchas
+
+1. **Requires Communications Mining tenant/project setup** in UiPath platform
+2. **Action Center integration** for human-in-the-loop validation workflows
+3. **Bearer token authentication** for CM API calls
+4. **Cloud storage bucket path required** for artifact storage
+5. **Async operations** - must handle task lifecycle properly
+6. **Discovery client needs OAuth configuration** for API endpoints
+7. **Streaming predictions** via CM API client for real-time classification
+8. **Depends on**: UiPath.DocumentProcessing.Contracts, UiPath.DocumentUnderstanding.Persistence

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

@@ -0,0 +1,74 @@
+# UiPath ComplexScenarios Activities - Legacy Reference
+
+## Overview
+Pre-built workflow scenario templates for common automation tasks (StudioX). Package: `UiPath.ComplexScenarios.Activities`. **#23 by adoption (3%)**.
+
+---
+
+## Scenario Categories
+
+### File/Folder Scenarios (7)
+| Scenario | Purpose | Requires |
+|----------|---------|----------|
+| `AddCurrentDateToFileAndMove` | Append date to filename, move to "Processed" | FileInfo + Excel workspace |
+| `AddCurrentDateToFilesInFolder` | Batch: date-stamp multiple files | IEnumerable\<FileInfo\> + workspace |
+| `CopyFileInfoToExcel` | Extract file metadata to Excel | FileInfo + workspace |
+| `DeleteFolder` | Delete folder recursively | (always available) |
+| `GroupByFileCreationDate` | Organize files by creation date | FileInfo + workspace |
+| `GroupByFileSize` | Organize files by size | FileInfo + workspace |
+| `GroupByFileType` | Organize files by extension | FileInfo + workspace |
+
+### Email Scenarios (8)
+| Scenario | Purpose | Requires |
+|----------|---------|----------|
+| `CopyEmailsToExcel` | Extract inbox to Excel (From, To, Subject, CC, Bcc, Body) | IMailQuickHandle + workspace |
+| `CreateContactsDatabase` | Extract unique sender addresses | IMailQuickHandle + workspace |
+| `DownloadEmailAttachments` | Save all attachments from inbox | IMailQuickHandle |
+| `EmailFilesInFolder` | Send folder contents as attachments | IMailQuickHandle |
+| `EmailFolderBackup` | Backup email folder | IMailQuickHandle |
+| `ForwardEmail` | Forward messages | IMailQuickHandle |
+| `MoveMail` | Move to another folder | IMailQuickHandle |
+| `ReplyToEmail` | Reply to messages | IMailQuickHandle |
+
+### Excel/Office Scenarios (3)
+| Scenario | Purpose | Requires |
+|----------|---------|----------|
+| `FillFormFromExcel` | Read Excel data, fill forms | Workspace |
+| `MergeRanges` | Merge Excel ranges | Workspace |
+| `PasteExcelChartIntoPowerPoint` | Copy chart to PowerPoint slide | IPresentationQuickHandle + workspace |
+
+---
+
+## Architecture
+
+Three base class variants determine when scenarios appear:
+- **DefaultScenarioDefinition** - Always shown (e.g., DeleteFolder)
+- **ExtendedScenarioDefinition\<T\>** - Shown when argument type T matched, workspace optional
+- **WorkspaceScenarioDefinition\<T\>** - Shown when argument type T matched AND Excel workspace available
+
+---
+
+## Critical Gotchas
+
+### Visibility/Matching
+1. **Scenarios only appear when argument types match exactly** - `IMailQuickHandle` vs generic mail interfaces must match precisely
+2. **WorkspaceScenario variants require open Excel workspace** - silently hidden if no Excel file open
+3. **Type metadata matching** checks `TypesMetadata.WorkspaceWorkbookMetadata` - not just any IWorkbook
+
+### Email Scenarios
+4. **CopyEmailsToExcel uses scratchpad cells A1:F1** for temporary data before appending - cells must be managed between iterations
+5. **CreateContactsDatabase deduplicates with DeleteRowsOption.Duplicates** - order may be affected
+6. **EmailFilesInFolder has hardcoded Subject="Requested Files" and Body="See Attachments"** - cannot customize
+7. **OutlookForEachMail vs ForEachEmailX** used inconsistently across scenarios - different property names
+
+### File Scenarios
+8. **Folder selection via UI dialog** (`IoSystemHelpers.TryGetSelectedFolderPathExpression()`) - returns false if user cancels, producing NO activities (silent failure)
+9. **File metadata extraction**: Folder returns parent directory only, not full path; date format follows system locale
+
+### Office Scenarios
+10. **PasteExcelChartIntoPowerPoint uses clipboard** (Windows-specific) - requires active Excel and PowerPoint instances
+11. **Scenario explicitly excluded from some builds** - check build .targets for availability
+
+### General
+12. **Expression language dependency** - scenario builders generate VB or C# expressions based on project language; manual edits must match
+13. **These are StudioX design-time scenarios** - not runtime activities you add to XAML directly

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

@@ -0,0 +1,45 @@
+# UiPath Credentials Activities - Community Reference
+
+## Overview
+Windows Credential Manager integration for storing/retrieving credentials. Package: `UiPath.Credentials.Activities` (from Community.Activities repo).
+
+---
+
+## Activities
+
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `GetSecureCredential` | Get credential (SecureString password) | Target (required), CredentialType, PersistanceType -> Username (string), Password (SecureString) |
+| `GetCredential` | Get credential (plain string password) | Target (required), CredentialType, PersistanceType -> Username, Password (string) |
+| `AddCredential` | Store new credential | Target (required), Username, Password/SecurePassword, CredentialType, PersistanceType |
+| `DeleteCredential` | Remove stored credential | Target (required), CredentialType, PersistanceType |
+| `RequestCredential` | Prompt user for credentials | Target -> Username, Password/SecurePassword |
+
+---
+
+## Enums
+
+### CredentialType
+- `Generic` (default) - Generic credential
+- `DomainPassword` - Domain/Windows credential
+- `DomainCertificate` - Certificate-based
+
+### PersistanceType (note spelling)
+- `Session` - Current login session only
+- `LocalComputer` - Machine-level persistence
+- `Enterprise` (default) - Domain/roaming profile
+
+---
+
+## Critical Gotchas
+
+1. **GetSecureCredential preferred over GetCredential** - returns SecureString instead of plain text password
+2. **Target is the credential name/key** in Windows Credential Manager - must match exactly
+3. **PersistanceType spelled "Persistance"** (typo in codebase, not "Persistence") - use as-is
+4. **Enterprise persistence** roams with domain profile - available on any domain-joined machine
+5. **Session persistence** lost on logout - temporary storage only
+6. **RequestCredential shows Windows credential dialog** - blocks workflow until user responds
+7. **Windows Credential Manager only** - not cross-platform (Windows desktop only)
+8. **GetCredential returns Result (bool)** - true if credential found, false if not
+9. **DeleteCredential silently succeeds** if credential doesn't exist
+10. **Credential names are case-insensitive** in Windows Credential Manager

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

@@ -0,0 +1,82 @@
+# UiPath Cryptography Activities - Community Reference
+
+## Overview
+Encryption, decryption, hashing, and PGP operations. Package: `UiPath.Cryptography.Activities` (from Community.Activities repo).
+
+---
+
+## Activities
+
+### Symmetric Encryption
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `EncryptFile` | Encrypt file with symmetric key | InputFilePath, OutputFilePath, Key/SecureKey, Algorithm, Encoding (default UTF-8) |
+| `DecryptFile` | Decrypt file with symmetric key | InputFilePath, OutputFilePath, Key/SecureKey, Algorithm, Encoding |
+| `EncryptText` | Encrypt text string | Input (string), Key/SecureKey, Algorithm, Encoding -> Result (string) |
+| `DecryptText` | Decrypt text string | Input (string), Key/SecureKey, Algorithm, Encoding -> Result (string) |
+
+### Hashing (HMAC)
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `KeyedHashFile` | HMAC hash of file | InputFilePath, Key/SecureKey, Algorithm, Encoding -> Result (string, hex) |
+| `KeyedHashText` | HMAC hash of text | Input (string), Key/SecureKey, Algorithm, Encoding -> Result (string, hex) |
+
+### PGP (Pretty Good Privacy)
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `PgpSignFile` | Sign file with PGP private key | InputFilePath, OutputFilePath, PrivateKeyFilePath, PrivateKeyPassphrase, Armor |
+| `PgpClearSignFile` | Clear-sign file (readable + signature) | InputFilePath, OutputFilePath, PrivateKeyFilePath, PrivateKeyPassphrase |
+| `PgpVerify` | Verify PGP signature | InputFilePath, PublicKeyFilePath -> IsAuthentic (bool) |
+| `PgpGenerateKeyPair` | Generate PGP key pair | Identity, Passphrase, PublicKeyFilePath, PrivateKeyFilePath, KeyLength, ExpirationDate |
+
+---
+
+## Encryption Algorithms
+- AES (default, recommended)
+- DES (legacy, weak)
+- RC2 (legacy)
+- Rijndael (AES variant)
+- TripleDES (3DES, legacy)
+
+## Hash Algorithms (for HMAC)
+- HMACSHA256 (default, recommended)
+- HMACSHA384
+- HMACSHA512
+- HMACMD5 (weak, avoid)
+- HMACRIPEMD160
+
+---
+
+## Critical Gotchas
+
+### Key Management
+1. **Key/SecureKey are overload groups** - provide one or the other, not both
+2. **SecureKey (SecureString) recommended** over plaintext Key for security
+3. **Key is used as password for key derivation** - not used directly as encryption key
+4. **Encoding must match between encrypt and decrypt** - default UTF-8
+
+### Algorithm Selection
+5. **Use AES** for new implementations - DES/RC2/3DES are legacy and weak
+6. **DES key is only 56 bits** - trivially breakable by modern standards
+7. **AES-256 is the default** and recommended choice
+
+### File Operations
+8. **InputFilePath and OutputFilePath cannot be the same** for file encryption/decryption
+9. **Output file is overwritten** if it exists
+10. **Large files processed in memory** - may cause OutOfMemoryException for very large files
+
+### PGP
+11. **PGP key files must be in standard OpenPGP format** (.asc for ASCII-armored, .pgp/.gpg for binary)
+12. **Armor=true produces ASCII output** (text-safe); false produces binary
+13. **PgpVerify returns IsAuthentic=false** (not exception) for invalid signatures
+14. **PgpGenerateKeyPair KeyLength** options: 1024 (weak), 2048 (minimum), 4096 (recommended)
+15. **ExpirationDate** - null means key never expires
+
+### Hashing
+16. **Hash results are hex-encoded strings** (lowercase)
+17. **HMAC requires a key** - unlike simple hashing, HMAC provides authentication
+18. **HMACMD5 is cryptographically weak** - use HMACSHA256+ for security
+
+### Encoding
+19. **Encoding parameter** defaults to UTF-8 but must match across encrypt/decrypt
+20. **Binary files should use appropriate encoding** or base64 wrapper

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

@@ -0,0 +1,79 @@
+# UiPath Database Activities - Community Reference
+
+## Overview
+Database integration via ADO.NET providers. Supports any database with a .NET data provider (SQL Server, Oracle, MySQL, PostgreSQL, SQLite, ODBC, OleDB). Package: `UiPath.Database.Activities` (from Community.Activities repo).
+
+---
+
+## Activities
+
+### Connection Management
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `DatabaseConnect` | Open database connection | ProviderName (required), ConnectionString OR ConnectionSecureString (overload groups), Output: DatabaseConnection |
+| `DatabaseDisconnect` | Close connection | DatabaseConnection |
+| `DatabaseTransaction` | Transaction scope with auto-commit/rollback | ProviderName, ConnectionString, ExistingDbConnection, UseTransaction (default true), Body (child activities) |
+
+### Query Execution
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `ExecuteQuery` | Run SELECT statements | Sql (required), CommandType (Text/StoredProcedure/TableDirect), Parameters, TimeoutMS, Output: DataTable |
+| `ExecuteNonQuery` | Run INSERT/UPDATE/DELETE | Sql (required), CommandType, Parameters, TimeoutMS, Output: AffectedRecords (int) |
+
+### Data Operations
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `InsertDataTable` | Insert DataTable rows into table | TableName (required), DataTable (required), Output: AffectedRecords (int) |
+| `BulkInsert` | High-performance bulk insert | TableName (required), DataTable (required), Output: AffectedRecords (long) |
+| `BulkUpdate` | Bulk update existing rows | TableName, DataTable, ColumnNames |
+
+### Common Properties (inherited from DatabaseExecute/DatabaseRowActivity)
+- `ExistingDbConnection` (DatabaseConnection) - Reuse existing connection
+- `ConnectionString` (string) OR `ConnectionSecureString` (SecureString) - New connection
+- `ProviderName` (string) - ADO.NET provider (e.g., "System.Data.SqlClient", "Oracle.ManagedDataAccess.Client")
+- `ContinueOnError` (bool) - Suppress exceptions
+- `TimeoutMS` (int) - Command timeout in milliseconds
+- `Parameters` (Dictionary<string, Argument>) - SQL parameters with direction support
+
+---
+
+## Critical Gotchas
+
+### Connection Management
+1. **If ExistingDbConnection is null, a new connection is created and disposed per activity** - each activity opens/closes its own connection unless you pass ExistingDbConnection
+2. **ConnectionString OR ConnectionSecureString** - overload groups, cannot provide both
+3. **ProviderName is REQUIRED** for new connections - must match installed ADO.NET provider exactly
+4. **ConnectionValidation** checks: either ExistingDbConnection OR (ConnectionString + ProviderName) must be provided
+
+### SQL Injection Risk
+5. **Use Parameters dictionary for parameterized queries** - never concatenate user input into Sql string
+6. **Parameters support direction** (In/Out/InOut) - useful for stored procedures with output parameters
+7. **Parameter type inferred from ArgumentType** at runtime
+
+### Timeout
+8. **TimeoutMS must be >= 0** - negative values throw ArgumentException
+9. **TimeoutMS is COMMAND timeout** (not connection timeout) - affects query execution time
+10. **Default is 0** (which means provider default, typically 30 seconds for SQL Server)
+
+### Transaction Handling
+11. **DatabaseTransaction UseTransaction=true (default)** - wraps Body in transaction
+12. **Auto-rollback on exception** - if Body throws, transaction rolls back
+13. **Auto-commit on success** - if Body completes, transaction commits
+14. **DatabaseTransaction is hidden in NETSTANDARD** builds (`[Browsable(false)]`)
+
+### BulkInsert
+15. **BulkInsert returns long** (not int) - for large datasets
+16. **BulkInsert uses SqlBulkCopy** internally for SQL Server - much faster than InsertDataTable
+17. **BulkInsert supports logging** via IExecutorRuntime if available
+
+### Data Type Mapping
+18. **DataTable column types must match database column types** - type mismatch causes runtime errors
+19. **NULL handling** - DBNull.Value vs null in DataTable cells
+20. **InsertDataTable uses SqlDataAdapter** internally - generates INSERT statements per row (slower than BulkInsert)
+
+### Provider-Specific Issues
+21. **Oracle requires Oracle.ManagedDataAccess.Client** provider (or legacy Oracle.DataAccess.Client)
+22. **MySQL requires MySql.Data.MySqlClient** (or MySqlConnector)
+23. **PostgreSQL requires Npgsql** provider
+24. **ODBC/OleDB** work but with limited parameter support
+25. **Provider DLLs must be accessible** to the UiPath Robot process at runtime

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

@@ -0,0 +1,101 @@
+# UiPath Excel Activities - Legacy Reference
+
+## Overview
+Excel automation with three access modes: Portable (file-based, no Excel required), Interop (COM, requires Excel), and Modern StudioX. Package: `UiPath.Excel.Activities`.
+
+---
+
+## Fundamental Split: Portable vs Interop vs Modern
+
+| Aspect | Portable (WorkbookFile) | Interop (ExcelApplicationScope) | Modern (ExcelProcessScopeX) |
+|--------|------------------------|---------------------------------|-----------------------------|
+| Excel Required | NO | YES | YES |
+| Library | ClosedXML / NPOI | COM Interop | COM + IExcelProcess |
+| File Lock | None | Full (locked) | Full |
+| Macros | NO | YES | YES |
+| Formatting | Limited | Full | Full |
+| Performance | Fast (no UI) | Slower (COM overhead) | Configurable |
+| Scope Needed | None (standalone) | ExcelApplicationScope | ExcelProcessScopeX + ExcelApplicationCard |
+
+**CRITICAL: Cannot mix patterns in same workflow**
+
+**CRITICAL: Scope activities require `ActivityAction<T>` body** — you cannot place child activities directly inside `ExcelApplicationScope`, `ExcelProcessScopeX`, or `ExcelApplicationCard`. Each requires a `.Body` property containing `ActivityAction` with a `DelegateInArgument`. See [common-pitfalls.md](../common-pitfalls.md#scope-activities-require-activityaction-body-critical-for-xaml-generation) for the complete XAML template and all scope body patterns.
+
+---
+
+## Key Activities
+
+### Portable (No Excel)
+ReadRange, ReadCell, ReadCellFormula, ReadRow, ReadColumn, WriteRange, WriteCell, AppendRange, CreateTable, CreatePivotTable, GetTableRange, GetSheets, SetRangeColor, GetCellColor, CreateNewWorkbook
+
+### CSV (Portable)
+ReadCsvFile, WriteCsvFile, AppendCsvFile - DelimitatorOptions: Comma, Semicolon, Pipe, Caret, Tab
+
+### Interop (ExcelApplicationScope children)
+ExcelReadRange, ExcelWriteCell, ExcelWriteRange, ExcelAppendRange, ExcelSelectRange, ExcelAutoFillRange, ExcelCopyPasteRange, ExcelCreateTable, ExcelFilterTable, ExcelSortTable, ExcelDeleteRange, ExcelInsertColumn, ExcelDeleteColumn, ExcelRemoveDuplicatesRange, ExcelLookUpRange, ExcelCopySheet, ExecuteMacro, InvokeVBA
+
+### Modern StudioX (ExcelApplicationCard children)
+ReadRangeX, WriteCellX, WriteRangeX, AppendRangeX, SelectRangeX, ClearRangeX, CreateTableX, SortX, FilterX, DeleteRowsX, InsertRowsX, VLookupX, SaveExcelFileX, SaveAsPdfX, FormatRangeX, ExecuteMacroX, InvokeVBAX
+
+---
+
+## Critical Gotchas
+
+### COM Object Cleanup
+1. **Zombie Excel processes** - All COM objects must be explicitly released via `Marshal.ReleaseComObject()` or `DisposeWithReleaseComObject()` extension
+2. **If body activity crashes, Excel process may remain open**
+3. **InstanceCachePeriod (default 3000ms)** - Time Excel instance stays cached between activities
+
+### Range Handling
+4. **Single cell "A1" in ReadRangeX extends to entire sheet** - `extendSingleCellRanges: true` by default reads ALL data from A1 onward
+5. **Multi-area ranges NOT supported** - `"A1:B10,D1:E10"` throws InvalidRange
+6. **Full row**: `"1:5"`, Full column: `"A:C"`
+
+### Sheet Names
+7. **Sheet name is REQUIRED** and default is "Sheet1"
+8. **Invalid chars**: `[ ] * ? : / \` - throws validation error
+9. **Max 31 characters** per Excel spec
+10. **Case sensitivity varies** - File-based: insensitive, Interop: can be sensitive
+
+### Data Type Coercion (ExcelValue)
+11. **Empty cell returns null** (not empty string)
+12. **Dates stored as doubles** (serial numbers since 1900) - region-dependent
+13. **DateTime conversion depends on system locale**
+14. **OriginalValue vs OriginalDisplayValue** - raw (15) vs formatted ($15.00)
+
+### Password Protection
+15. **Two password types**: Password (read protection) vs EditPassword (write-reserved)
+16. **Cannot set both Password and SecurePassword** simultaneously
+
+### Workbook Scope
+17. **AutoSave=true (default)** can corrupt file if not closed properly
+18. **.xls files cannot use ClosedXML** - handled by NPOI in Portable mode or COM Interop. Legacy `WithWorkbook`/`OpenWorkbook` force Interop for .xls; modern Portable path uses NPOI instead.
+19. **ReadOnly mode** - AutoSave disabled automatically
+
+### CSV Quirks
+20. **DelimitatorOptions** (note spelling "Delimitator" not "Delimiter")
+21. **IgnoreQuotes option** - when true, parser doesn't treat quotes as field delimiters
+22. **Default encoding is system encoding** - specify "UTF-8" explicitly for portability
+
+### Macro/VBA
+23. **MacroSetting must be EnableAll** or macros won't run
+24. **InvokeVBA .bas file must be VB6 compatible** - injected into workbook VBProject at runtime
+25. **Macro parameters are object[]** - order matters, complex types may not serialize
+
+### File Conflicts
+26. **FileConflictResolution**: Overwrite (close without saving), UseExisting, SaveAndReplace, Throw
+27. **Default behavior depends on ExistingProcessAction** - can silently drop changes
+
+### Deprecated Activities
+- OpenWorkbook, CloseWorkbook, WithWorkbook (legacy)
+- ExcelForEachRow v1 (use ExcelForEachRowX)
+- CreatePivotTableX v1 (use v2)
+
+### Additional Validated Gotchas
+27. **Single cell "A1" extends ONLY when no colon** - "A1" expands to full used range, but "A1:A1" does NOT expand (treated as explicit range)
+28. **ForEachRowX disables AutoSave during iteration** then re-enables; crash mid-iteration may leave AutoSave disabled
+29. **.xlsb (binary workbook) not supported in Portable mode** - always requires Interop
+30. **ClosedXML formula evaluation is limited** - unsupported formulas fall back to cached/stale values via GetRichText()
+31. **Range address string max 255 characters** - limits multi-area ranges via COM
+32. **Protected/locked sheets throw ExcelException** - check `ProtectContents && cellRange.Locked`
+33. **Cell "A0" treated as "A:A" by ClosedXML** - known bug workaround in codebase

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

@@ -0,0 +1,75 @@
+# UiPath FTP Activities - Community Reference
+
+## Overview
+FTP/FTPS/SFTP file transfer activities. Package: `UiPath.FTP.Activities` (from Community.Activities repo).
+
+---
+
+## Activities
+
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `WithFtpSession` | FTP connection scope (container) | Host (required), Port, Username, Password/SecurePassword, FtpsMode (None/Explicit/Implicit), SftpMode (bool), ClientCertificatePath/Password, AcceptAllCertificates, Body |
+| `DownloadFiles` | Download files from FTP | RemotePath (required), LocalPath (required), Recursive, Create (create local dirs), Overwrite |
+| `UploadFiles` | Upload files to FTP | LocalPath (required), RemotePath (required), Recursive, Create (create remote dirs) |
+| `Delete` | Delete remote file/folder | RemotePath (required) |
+| `MoveItem` | Move/rename remote file | RemotePath (required), NewPath (required) |
+| `DirectoryExists` | Check if remote dir exists | RemotePath -> Exists (bool) |
+| `FileExists` | Check if remote file exists | RemotePath -> Exists (bool) |
+| `EnumerateObjects` | List remote directory contents | RemotePath -> Files (FtpObjectInfo[]) |
+
+---
+
+## WithFtpSession Properties
+
+### Connection
+- `Host` (string, required) - FTP server hostname
+- `Port` (int) - Server port (default: 21 for FTP, 22 for SFTP)
+- `Username` (string) - Login username
+- `Password` (string) OR `SecurePassword` (SecureString) - Login password
+
+### Protocol
+- `FtpsMode` (enum): None, Explicit (FTPES), Implicit (FTPS)
+- `SftpMode` (bool) - Use SFTP (SSH-based) instead of FTP
+- `UseBinaryMode` (bool) - Binary vs ASCII transfer mode
+
+### Security
+- `ClientCertificatePath` (string) - Client certificate file
+- `ClientCertificatePassword` (string/SecureString) - Certificate password
+- `AcceptAllCertificates` (bool) - Skip certificate validation (INSECURE)
+
+---
+
+## Critical Gotchas
+
+### Connection
+1. **All FTP activities MUST be inside WithFtpSession** - constraint enforced
+2. **FTP vs FTPS vs SFTP are different protocols** - FtpsMode controls FTP/FTPS, SftpMode switches to SFTP entirely
+3. **Port defaults**: FTP=21, FTPS/Explicit=21, FTPS/Implicit=990, SFTP=22
+4. **AcceptAllCertificates=true is a security risk** - bypasses SSL certificate validation
+
+### File Operations
+5. **DownloadFiles Overwrite flag** - if false, existing local files are skipped (not error)
+6. **DownloadFiles/UploadFiles Recursive** - recurse into subdirectories
+7. **DownloadFiles/UploadFiles Create** - create target directories if they don't exist
+8. **RemotePath uses forward slashes** (/) regardless of server OS
+9. **LocalPath uses system path separators**
+
+### Transfer Mode
+10. **UseBinaryMode=true recommended** for non-text files - ASCII mode can corrupt binary data
+11. **ASCII mode converts line endings** between platforms (CRLF <-> LF)
+
+### SFTP Specific
+12. **SFTP uses SSH protocol** - completely different from FTP/FTPS
+13. **SFTP may require SSH key authentication** (not just username/password)
+14. **SFTP doesn't support FtpsMode** - setting both SftpMode=true and FtpsMode is ignored
+
+### Error Handling
+15. **ContinueOnError** inherited from base - suppresses exceptions
+16. **File permission errors** common on remote servers - check server-side permissions
+17. **Timeout issues** on large file transfers - ensure network stability
+
+### Known Community Issues
+18. **Passive mode vs Active mode** - some firewalls block active FTP; passive mode is default
+19. **UTF-8 filename encoding** - some servers don't support UTF-8 filenames
+20. **EnumerateObjects returns FtpObjectInfo[]** with Name, FullName, Type (File/Directory), Size, LastModified

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

@@ -0,0 +1,81 @@
+# UiPath Forms Activities - Legacy Reference
+
+## Overview
+HTML/FormIo-based forms for user interaction. Supports async/modal display, field binding, events, and triggers. Package: `UiPath.Forms.Activities`.
+
+---
+
+## Activities
+
+| Activity | Purpose | Key Arguments |
+|----------|---------|---------------|
+| `ShowFormActivity` | Display form (async or modal) | FormId, InstanceName, Arguments (Dict), Width, Height, Left, Top, Title, IsAsync (default true) |
+| `CloseFormActivity` | Close open form | FormId, InstanceName |
+| `HideFormActivity` | Minimize/hide form | FormId, InstanceName |
+| `BringFormToFrontActivity` | Restore hidden form | FormId, InstanceName |
+| `GetFormFieldsActivity` | Read current field values | FormId, InstanceName, Arguments (Dict\<string, OutArgument\>) |
+| `SetFormFieldsActivity` | Set field values | FormId, InstanceName, Arguments (Dict\<string, InArgument\>) |
+| `ChangeFormPropertiesActivity` | Modify form at runtime | FormId, InstanceName, Height, Width, Title, WindowState, TopMost |
+| `ExecuteScriptActivity` | Run JavaScript in form | FormId, InstanceName, Source (JS code) |
+| `FormTriggerActivity<T>` | Listen for form events | FormId, InstanceName, Event (e.g., "button1.click"), MessageId |
+| `ShowCalloutActivity` | Popup near UI element | Target/UiElement, AutomaticallyCloseAfter, all ShowForm args |
+
+---
+
+## FormIo Type Mapping
+
+| FormIo Component | C# Type |
+|-----------------|---------|
+| Checkbox | bool |
+| Number / Currency | double |
+| Password | SecureString |
+| DataGrid / EditGrid | DataTable |
+| DateTime | DateTime |
+| Date | DateOnly |
+| Time | TimeOnly |
+| Survey / DataMap | Dictionary\<string, string\> |
+| Select (multiple) | IEnumerable\<string\> |
+| Select (single) | string |
+| Default | string |
+
+---
+
+## Critical Gotchas
+
+### Form Display
+1. **IsAsync=true (default)** - returns immediately; form runs in background
+2. **IsAsync=false** - blocks workflow until form closes
+3. **DuplicateBehavior=ReuseExisting** by default - same FormId+InstanceName reuses form
+4. **FormSelectorNotUnique exception** if FormId+InstanceName conflict exists
+
+### Arguments Binding
+5. **Arguments dictionary maps field IDs to workflow variables** (In/Out/InOut)
+6. **Global variables** bound via `GlobalVariables.PropertyName` regex pattern
+7. **Type coercion** uses `Convert.ChangeType()` - arrays parsed via string splitting
+8. **Complex types/objects fail** with FormsRuntimeException(InvalidArgument)
+
+### Platform Limitations
+9. **ExternalHost (Assistant/Robot)**: HTML forms only - FormIo/native forms throw NotSupportedException
+10. **Desktop**: Requires WebView2 runtime installed
+11. **WebSocket URI hardcoded** to `ws://127.0.0.1:29831` (not localhost, to avoid IPv6 2-second timeout)
+
+### Async Patterns
+12. **async void methods with #pragma warning disable** - unhandled exceptions are catastrophic
+13. **Try/catch wraps to TaskCompletionSource.SetException()** for safety
+
+### Timeouts
+14. **FormLoadTimeout = 10 seconds** - configurable but soft-enforced
+15. **GetValueTimeout / InitializeTimeout = 10 seconds**
+
+### Form Selection
+16. **Wildcard-based matching** - missing selector fields match any value
+17. **Multiple matches throw exception** (not silent failure)
+
+### Form Files
+18. **Extension**: `.uiform` (native FormIo) or `.html` (raw HTML)
+19. **Form ID resolution** via Constants.IdMapFileName probed relative to assembly
+
+### Callout Activity
+20. **ShowCalloutActivity integrates with UIAutomationNext** for target tracking
+21. **Defaults**: Width=300, Height=280, ShowMargin=false, ShowInTaskbar=false
+22. **ContinueOnError=true by default** (unlike ShowFormActivity)