@uipath/skills 1.201.0-preview.621 → 1.202.0-preview.635

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/GetField.md

@@ -6,7 +6,7 @@ Reads the text content of a specific input field on the terminal screen. The fie
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -26,23 +26,23 @@ Reads the text content of a specific input field on the terminal screen. The fie
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before reading. |
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
-### Enum Reference
+## Notes
 
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
+At least one of `LabeledBy` or `FollowedBy` must be provided. Both can be specified together for a more precise match. `Index` is a secondary criterion used to disambiguate when multiple fields share the same label — it cannot be used alone without `LabeledBy` or `FollowedBy`.
 
-- `NONE` — Do not wait; read immediately.
-- `READY` — Wait for the keyboard to be unlocked (screen ready for input).
-- `COMPLETE` — Wait for all data to arrive on the screen.
+### Prefer position-based reads when portability matters
 
-## Notes
+Label-based field identification depends on the terminal provider's idea of "what is a field" — and different providers (`UiPathNew`, `IBM`, `Attachmate`, `BlueZone`, `Generic`/EHLLAPI) use different APIs and field-detection rules under the hood. The same screen can split into different field boundaries between providers, so a `GetField` that matches one label-style on a TN3270 session may fail or return a different value on the same host through an IBM PCOMM session.
 
-At least one of `LabeledBy` or `FollowedBy` must be provided. Both can be specified together for a more precise match. `Index` is a secondary criterion used to disambiguate when multiple fields share the same label — it cannot be used alone without `LabeledBy` or `FollowedBy`.
+For workflows that need to run against more than one provider, or against a host whose field semantics are unclear, prefer:
+
+- [`GetTextAtPosition`](GetTextAtPosition.md) — read N characters from a known `Row` / `Column` (position is provider-agnostic).
+- [`GetScreenArea`](GetScreenArea.md) — read a rectangular region; useful when the field width varies but the screen geometry is stable.
+- [`FindText`](FindText.md) → [`GetTextAtPosition`](GetTextAtPosition.md) — anchor on visible label text, then read at the offset where the value lives.
+
+Keep `GetField` for single-provider workflows where you have already validated that `LabeledBy` / `FollowedBy` resolve to the correct field, and where the label text is stable across screen variants.
 
 ## XAML Example
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/GetFieldAtPosition.md

@@ -6,7 +6,7 @@ Reads the content of the input field that starts at the specified row and column
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals.Advanced  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -25,15 +25,7 @@ Reads the content of the input field that starts at the specified row and column
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before reading. |
-
-### Enum Reference
-
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
 ## Notes
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/GetScreenArea.md

@@ -6,7 +6,7 @@ Reads all text within a rectangular region of the terminal screen, defined by a
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals.Advanced  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -27,15 +27,34 @@ Reads all text within a rectangular region of the terminal screen, defined by a
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before reading. |
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
-### Enum Reference
+## Notes
 
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
+### Extracting tabular data as a DataTable
+
+`GetScreenArea` is the canonical building block for reading tabular screens (column-aligned host output, paged reports, etc.). The output is a single `string` with embedded newlines preserving the screen's row/column layout. Pipe that string through the **Generate Data Table** activity from `UiPath.System.Activities` to get a `DataTable` you can filter, write to Excel, or hand to other activities:
+
+```xml
+<uit:TerminalGetScreenArea DisplayName="Read inventory table"
+                           Row="[5]" Column="[1]"
+                           EndRow="[22]" EndColumn="[80]"
+                           Text="[tableText]" />
+<ui:GenerateDataTable DisplayName="Parse table"
+                      Input="[tableText]"
+                      DataTable="[inventory]"
+                      ColumnSeparators="  "
+                      NewLineSeparator="&#10;" />
+```
+
+Tuning notes for `GenerateDataTable`:
+
+- **`ColumnSeparators`**: two or more spaces is usually correct for fixed-width column-aligned screens. Adjust if columns are tab-separated or pipe-separated.
+- **`NewLineSeparator`**: `&#10;` (LF) is the default emission. Set to `&#13;&#10;` (CRLF) if the provider emits Windows-style newlines.
+- **`PreserveFormatting`**: keep `true` so leading/trailing column padding is retained for short cells.
+- **Header row**: if the screen's first row in the captured region is the column header, set `UseColumnHeaders=true`; otherwise pass `false` and rename columns post-hoc.
+
+For non-tabular reads (a single value, a status line, free-form text), `GetText`, `GetTextAtPosition`, or `GetField` are the right tools — `GenerateDataTable` adds parsing overhead with no benefit.
 
 ## XAML Example
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/GetText.md

@@ -6,7 +6,7 @@ Reads the entire visible text content of the terminal screen and returns it as a
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -18,19 +18,7 @@ Reads the entire visible text content of the terminal screen and returns it as a
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before reading. |
-
-### Enum Reference
-
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
-
-- `NONE` — Do not wait; read immediately.
-- `READY` — Wait for the keyboard to be unlocked (screen ready for input).
-- `COMPLETE` — Wait for all data to arrive on the screen.
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
 ## XAML Example
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/GetTextAtPosition.md

@@ -6,7 +6,7 @@ Reads text starting at a specific row and column position on the terminal screen
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals.Advanced  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -26,15 +26,7 @@ Reads text starting at a specific row and column position on the terminal screen
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before reading. |
-
-### Enum Reference
-
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
 ## XAML Example
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/MoveCursor.md

@@ -6,11 +6,11 @@ Moves the terminal cursor to an exact row and column position on the screen.
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals.Advanced  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
-### Position
+### Input
 
 | Name | Display Name | Kind | Type | Required | Default | Description |
 |------|-------------|------|------|----------|---------|-------------|
@@ -19,15 +19,7 @@ Moves the terminal cursor to an exact row and column position on the screen.
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before moving. |
-
-### Enum Reference
-
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
 ## XAML Example
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/MoveCursorToText.md

@@ -6,7 +6,7 @@ Searches the terminal screen for a text string and moves the terminal cursor to
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals.Advanced  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -28,15 +28,7 @@ Searches the terminal screen for a text string and moves the terminal cursor to
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before searching. |
-
-### Enum Reference
-
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
 ## Notes
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/SendControlKey.md

@@ -6,7 +6,7 @@ Sends a single control key (such as Tab, Enter/Transmit, F1–F24, arrow keys, o
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -18,16 +18,10 @@ Sends a single control key (such as Tab, Enter/Transmit, F1–F24, arrow keys, o
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `1000` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before sending. |
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / **`1000`** / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Note the higher `DelayMS` default (1000 ms vs the usual 300 ms) — pressing a control key typically triggers host-side processing, so a longer post-execute pause lets the screen settle before the next activity. Lower it only if you follow immediately with a `Wait*` activity that already blocks.
 
 ### Enum Reference
 
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
-
 **`ControlKey`** (selected values):
 
 | Value | Description |

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/SendKeys.md

@@ -6,7 +6,7 @@ Sends a raw text string or key sequence directly to the terminal. Use this activ
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals.Advanced  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -18,15 +18,7 @@ Sends a raw text string or key sequence directly to the terminal. Use this activ
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before sending. |
-
-### Enum Reference
-
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
 ## Notes
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/SendKeysSecure.md

@@ -6,7 +6,7 @@ Sends a `SecureString` value (such as a password) to the terminal without exposi
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals.Advanced  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -18,15 +18,7 @@ Sends a `SecureString` value (such as a password) to the terminal without exposi
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before sending. |
-
-### Enum Reference
-
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
 ## Notes
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/SetField.md

@@ -6,7 +6,7 @@ Writes text into a specific input field on the terminal screen. The field is ide
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -26,23 +26,24 @@ Writes text into a specific input field on the terminal screen. The field is ide
 
 ### Options
 
-| Name | Display Name | Kind | Type | Default | Description |
-|------|-------------|------|------|---------|-------------|
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before writing. |
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
-### Enum Reference
+## Notes
 
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
+At least one of `LabeledBy` or `FollowedBy` must be provided. Both can be specified together for a more precise match. `Index` is a secondary criterion used to disambiguate when multiple fields share the same label — it cannot be used alone without `LabeledBy` or `FollowedBy`.
 
-- `NONE` — Do not wait; write immediately.
-- `READY` — Wait for the keyboard to be unlocked (screen ready for input).
-- `COMPLETE` — Wait for all data to arrive on the screen.
+### Prefer position-based writes when portability matters
 
-## Notes
+Label-based field identification depends on the terminal provider's idea of "what is a field" — and different providers (`UiPathNew`, `IBM`, `Attachmate`, `BlueZone`, `Generic`/EHLLAPI) use different APIs and field-detection rules. The same screen can split into different field boundaries between providers, so a `SetField` that targets one label-style on a TN3270 session may write to the wrong field, throw, or silently no-op on the same host through an IBM PCOMM session.
 
-At least one of `LabeledBy` or `FollowedBy` must be provided. Both can be specified together for a more precise match. `Index` is a secondary criterion used to disambiguate when multiple fields share the same label — it cannot be used alone without `LabeledBy` or `FollowedBy`.
+For workflows that need to run against more than one provider, or against a host whose field semantics are unclear, prefer the position-based input pattern:
+
+- [`MoveCursor`](MoveCursor.md) to the target row/column (or [`SendControlKey`](SendControlKey.md) with `Key="Tab"` to advance through input fields), then
+- [`SendKeys`](SendKeys.md) to type the value.
+
+Alternatively, [`SetFieldAtPosition`](SetFieldAtPosition.md) writes to the field starting at a known `Row` / `Column` — provider-agnostic input without the cursor-move step.
+
+Keep `SetField` for single-provider workflows where you have already validated that `LabeledBy` / `FollowedBy` resolve to the correct input field, and where the label text is stable across screen variants.
 
 ## XAML Example
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/SetFieldAtPosition.md

@@ -6,7 +6,7 @@ Writes text into the input field that starts at the specified row and column pos
 
 **Package:** `UiPath.Terminal.Activities`  
 **Category:** App Integration.Terminals.Advanced  
-**Required Scope:** `TerminalSession`
+**Required Scope:** `TerminalSession` — place inside a `TerminalSession.Body` `Sequence`. See [child-activity skeleton](TerminalSession.md#child-activity-skeleton) for a multi-activity example.
 
 ## Properties
 
@@ -23,18 +23,15 @@ Writes text into the input field that starts at the specified row and column pos
 | `Row` | Row | `InArgument` | `int` | Yes | | The row of the field start (1-based). |
 | `Column` | Column | `InArgument` | `int` | Yes | | The column of the field start (1-based). |
 
-### Options / Configuration
+### Configuration
 
 | Name | Display Name | Kind | Type | Default | Description |
 |------|-------------|------|------|---------|-------------|
 | `BackwardsCompatible` | Backwards Compatible | `Property` | `bool?` | `true` (existing workflows); `false` (newly added) | Controls cursor movement behavior after writing. When `true`, the cursor jumps back to the field start position after writing (legacy behavior). When `false`, the cursor stays at the end of the written text. |
-| `TimeoutMS` | TimeoutMS | `InArgument` | `int` | `5000` | Milliseconds to wait for the operation to complete. |
-| `DelayMS` | DelayMS | `InArgument` | `int` | `300` | Milliseconds to wait after executing the activity. |
-| `WaitType` | WaitType | `Property` | `WaitMode` | `READY` | Determines how to wait for the terminal screen before writing. |
 
-### Enum Reference
+### Options
 
-**`WaitMode`**: `NONE`, `READY`, `COMPLETE`
+Standard `TimeoutMS` / `DelayMS` / `WaitType` (defaults `5000` / `300` / `READY`) — see [_common-options.md](TerminalSession/_common-options.md). Defaults work for typical sessions; tune only when scripted activities run faster than the host responds.
 
 ## Notes
 

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/TerminalSession/_common-options.md

@@ -0,0 +1,29 @@
+# Common Options
+
+Every child activity of [`TerminalSession`](../TerminalSession.md) carries the same three timing/synchronization properties. Defaults work for typical Telnet/3270/5250 sessions over LAN — tune only when scripted activities run faster than the host responds.
+
+## Common properties
+
+| Name | Type | Typical default | Wait-activity default | Description |
+|------|------|-----------------|------------------------|-------------|
+| `TimeoutMS` | `InArgument<int>` | `5000` | `30000` (`WaitScreenReady`, `WaitScreenText`, `WaitFieldText`, `WaitTextAtPosition`) | Milliseconds to wait for the operation to complete before throwing a timeout error. |
+| `DelayMS` | `InArgument<int>` | `300` | `0` (`WaitScreenReady`) | Milliseconds to wait *after* the activity completes, before proceeding to the next one. |
+| `WaitType` | `WaitMode` property | `READY` | `READY` | Pre-execution synchronization mode. See [`WaitMode`](#waitmode-enum) below. `WaitScreenReady` always waits for `READY` regardless of this value. |
+
+Each child doc states its activity-specific defaults in its own Options section, so you do not need to cross-reference this table at authoring time — only when tuning.
+
+## `WaitMode` enum
+
+| Value | Behavior |
+|-------|----------|
+| `NONE` | Do not wait for the screen state; execute immediately. |
+| `READY` | Wait for the keyboard to be unlocked (screen ready for input) before executing. |
+| `COMPLETE` | Wait for all screen data to arrive before executing. |
+
+## Tuning notes
+
+- **Raise `TimeoutMS`** for slow hosts or scripted login flows that include intentional pauses (BBS systems, satellite-linked mainframes).
+- **Raise `DelayMS`** if the next activity tends to fire before the host has stopped redrawing — visible as missed keystrokes, stale screen reads, or `ErrorWaitReady`.
+- **Lower `DelayMS` to `0`** when the next activity is itself a `Wait*` that already blocks until the screen settles.
+- **`WaitType="NONE"`** is the right choice when reading screen state for diagnostics or polling — you do not want to block on `READY` if the keyboard is intentionally locked.
+- **`WaitType="COMPLETE"`** is rarely needed; reach for it only when you observe partial-screen reads despite `READY` waits succeeding (suggests the provider reports keyboard-unlock before the host has finished its redraw).

package/skills/uipath-rpa/references/activity-docs/UiPath.Terminal.Activities/2.10/activities/TerminalSession/authoring-paths.md

@@ -0,0 +1,58 @@
+# Authoring `ConnectionString` Outside Studio Desktop
+
+Studio Desktop ships two design-time tools that consume and produce the literal `ConnectionString` value: the **Connection Settings** dialog (visual field editor) and the **Terminal Recorder** (records interactions with a live session and emits child activities). Both require the `ConnectionString` to be a literal string they can read at design time — an expression-bound value resolves only at runtime, after the designer has already needed it.
+
+Outside Studio Desktop (Studio Web, CLI authoring, code review, non-interactive contexts), neither tool is available, so the field-completeness, single-quote, and integer-enum rules of the serialized form have to be satisfied by other means. This doc covers the two non-literal paths (Options B and C). The literal path (Option A) lives in the main [`TerminalSession.md`](../TerminalSession.md) since it interoperates with the Studio designer.
+
+## Option B — XAML: build a `ConnectionData` and serialize with `ConnectionStringHelper.Serialize`
+
+Recommended for non-Studio XAML authoring (Studio Web, CLI authoring, PR review). Build a strongly-typed `ConnectionData` in an `Assign`, run it through the helper, bind the result to `ConnectionString`:
+
+```xml
+<Assign DisplayName="Build connection string">
+  <Assign.To>
+    <OutArgument x:TypeArguments="x:String">[connectionString]</OutArgument>
+  </Assign.To>
+  <Assign.Value>
+    <InArgument x:TypeArguments="x:String">[ConnectionStringHelper.Serialize(New ConnectionData() With {
+      .Host = "telehack.com",
+      .Port = 23,
+      .ProviderType = TerminalProviderType.UiPathNew,
+      .ConnectionType = ConnectionType.Address,
+      .ConnectionProtocol = CommunicationType.TELNET,
+      .TerminalType = TerminalType.TerminalVT,
+      .TerminalModel = CInt(TTVtTermId.VT100)
+    })]</InArgument>
+  </Assign.Value>
+</Assign>
+```
+
+Then bind `TerminalSession.ConnectionString="[connectionString]"`.
+
+Why this works:
+
+- **Real enum names**, compile-time validated. Typos surface at JIT with line numbers, not as `Invalid connection string` from the JSON validator.
+- **Enum-to-integer conversion is automatic.** `DataContractJsonSerializer` writes each enum member as its underlying integer; you never write `9` for `UiPathNew` and never look up the order.
+- **Field-completeness rule is satisfied automatically.** `DataContract` serializes every member of `ConnectionData`, including the null/default ones the validator demands. You set only the fields you care about; the helper fills in the rest.
+- **No `{}` markup-escape prefix.** The attribute value is a VB expression (`[connectionString]`), not a literal JSON string, so XAML never sees a leading `{`.
+
+Requirements in the XAML file: import `UiPath.Terminal.Helpers` and `UiPath.Terminal.Enums` in `TextExpression.NamespacesForImplementation`; reference `UiPath.Terminal` in `TextExpression.ReferencesForImplementation`. C# expression projects use the same shape with `(int)` instead of `CInt(...)` and object-initializer syntax instead of `With { ... }`.
+
+**Trade-off vs Option A:** when `ConnectionString` is expression-bound, Studio Desktop's **Connection Settings** dialog and **Terminal Recorder** cannot open on the activity — both need a literal value they can read and round-trip at design time. If you want those tools, author the connection in Studio Desktop with a literal, then either keep it as a literal (Option A) or copy the resulting string into your non-Studio workflow.
+
+## Option C — Coded workflows: use `GetConnection(ConnectionData)`
+
+Skip the `TerminalSession` activity entirely; pass a strongly-typed `ConnectionData` to `terminal.GetConnection` and operate on the returned `TerminalConnection`. See [coded-api.md § Coded Quickstart](../../coded/coded-api.md#coded-quickstart) and the [Common Patterns](../../coded/coded-api.md#common-patterns) section.
+
+Same Studio-tooling trade-off as Option B: no Recorder, no Connection Settings dialog.
+
+## Choosing between A, B, C
+
+| Authoring context | Recommended option |
+|-------------------|---------------------|
+| Studio Desktop, you want the Connection Settings dialog or Terminal Recorder available | **A** (literal string in attribute) |
+| Studio Desktop, the string comes from an Asset / config / argument / variable at runtime | **A** (literal expression binding; Connection Settings / Terminal Recorder require a literal string and won’t work) |
+| Studio Web | **B** |
+| CLI authoring (`uip rpa`), PR review, code generation | **B** |
+| Coded C# workflow (`[Workflow]` class) | **C** |
+| Hand-authoring on a build-only machine with no Studio | **B** (literal is fine too, but you lose typed-enum compile checks) |