ultravisor 1.0.21 → 1.0.23

package/docs/features/tasks-file-system.md

@@ -10,20 +10,20 @@ Reads a file from the local file system into operation state.
 
 ### Settings
 
-- **FilePath** — Path to the file to read. Supports Pict template expressions for dynamic paths.
-- **Encoding** — Character encoding (default `utf8`). Use `binary` for non-text files.
-- **MaxBytes** — Maximum bytes to read. Set to `0` for unlimited.
+- **FilePath** -- Path to the file to read. Supports Pict template expressions for dynamic paths.
+- **Encoding** -- Character encoding (default `utf8`). Use `binary` for non-text files.
+- **MaxBytes** -- Maximum bytes to read. Set to `0` for unlimited.
 
 ### Outputs
 
-- **FileContent** — The full text content of the file.
-- **BytesRead** — Number of bytes that were read.
-- **FileName** — The base name of the file (no directory).
+- **FileContent** -- The full text content of the file.
+- **BytesRead** -- Number of bytes that were read.
+- **FileName** -- The base name of the file (no directory).
 
 ### Events
 
-- **ReadComplete** — Fires after a successful read.
-- **Error** — Fires if the file cannot be found or read.
+- **ReadComplete** -- Fires after a successful read.
+- **Error** -- Fires if the file cannot be found or read.
 
 ### Tips
 
@@ -37,25 +37,25 @@ Reads a file in chunks up to a maximum buffer size, splitting on a preferred cha
 
 ### Settings
 
-- **FilePath** — Path to the file to read.
-- **Encoding** — Character encoding (default `utf8`).
-- **MaxBufferSize** — Maximum bytes per chunk (default `65536`).
-- **SplitCharacter** — Preferred character to split on (default newline). The chunk is trimmed to the last occurrence of this character within the buffer so records are not broken mid-line.
-- **ByteOffset** — Byte offset to start reading from. Use `0` for the first chunk and feed the output ByteOffset back for continuation.
+- **FilePath** -- Path to the file to read.
+- **Encoding** -- Character encoding (default `utf8`).
+- **MaxBufferSize** -- Maximum bytes per chunk (default `65536`).
+- **SplitCharacter** -- Preferred character to split on (default newline). The chunk is trimmed to the last occurrence of this character within the buffer so records are not broken mid-line.
+- **ByteOffset** -- Byte offset to start reading from. Use `0` for the first chunk and feed the output ByteOffset back for continuation.
 
 ### Outputs
 
-- **FileContent** — Content of the current chunk.
-- **BytesRead** — Bytes in this chunk.
-- **ByteOffset** — Updated byte offset for the next read.
-- **IsComplete** — `true` when the entire file has been read.
-- **FileName** — Base name of the file.
-- **TotalFileSize** — Total size of the file in bytes.
+- **FileContent** -- Content of the current chunk.
+- **BytesRead** -- Bytes in this chunk.
+- **ByteOffset** -- Updated byte offset for the next read.
+- **IsComplete** -- `true` when the entire file has been read.
+- **FileName** -- Base name of the file.
+- **TotalFileSize** -- Total size of the file in bytes.
 
 ### Events
 
-- **ReadComplete** — Fires when a chunk is read successfully.
-- **Error** — Fires on read failure.
+- **ReadComplete** -- Fires when a chunk is read successfully.
+- **Error** -- Fires on read failure.
 
 ### Tips
 
@@ -69,17 +69,17 @@ Reads a JSON file from disk, parses it, and stores the resulting object in opera
 
 ### Settings
 
-- **FilePath** — Path to the JSON file.
-- **Destination** — State address to store the parsed data. If empty, data is stored at the default output address.
+- **FilePath** -- Path to the JSON file.
+- **Destination** -- State address to store the parsed data. If empty, data is stored at the default output address.
 
 ### Outputs
 
-- **Data** — The parsed JSON object or array.
+- **Data** -- The parsed JSON object or array.
 
 ### Events
 
-- **Complete** — Fires after successful read and parse.
-- **Error** — Fires if the file is missing or contains invalid JSON.
+- **Complete** -- Fires after successful read and parse.
+- **Error** -- Fires if the file is missing or contains invalid JSON.
 
 ### Tips
 
@@ -93,23 +93,23 @@ Writes text content to a file on disk.
 
 ### Settings
 
-- **FilePath** — Path to the output file. Intermediate directories are created automatically.
-- **Content** — The text content to write. Supports Pict template expressions.
-- **Encoding** — Character encoding (default `utf8`).
-- **Append** — When `true`, appends to an existing file instead of overwriting it.
-- **LineEnding** — Force a line ending style: `lf`, `crlf`, or leave empty for no conversion.
+- **FilePath** -- Path to the output file. Intermediate directories are created automatically.
+- **Content** -- The text content to write. Supports Pict template expressions.
+- **Encoding** -- Character encoding (default `utf8`).
+- **Append** -- When `true`, appends to an existing file instead of overwriting it.
+- **LineEnding** -- Force a line ending style: `lf`, `crlf`, or leave empty for no conversion.
 
 ### Outputs
 
-- **FileLocation** — The path as specified (may be relative).
-- **FileName** — The base file name only.
-- **FilePath** — The fully resolved absolute path.
-- **BytesWritten** — Number of bytes written.
+- **FileLocation** -- The path as specified (may be relative).
+- **FileName** -- The base file name only.
+- **FilePath** -- The fully resolved absolute path.
+- **BytesWritten** -- Number of bytes written.
 
 ### Events
 
-- **WriteComplete** — Fires on success.
-- **Error** — Fires on write failure.
+- **WriteComplete** -- Fires on success.
+- **Error** -- Fires on write failure.
 
 ### Tips
 
@@ -123,24 +123,24 @@ Serializes a state object to JSON and writes it to a file on disk.
 
 ### Settings
 
-- **FilePath** — Path to the output JSON file.
-- **DataAddress** — State address of the data to serialize. If empty, uses the full operation state.
-- **PrettyFormat** — Pretty-print with indentation (default `true`).
-- **IndentType** — Indent character: `tab` or `space` (default `tab`).
-- **IndentCount** — Number of indent characters per level (default `1`).
-- **SortKeys** — Alphabetically sort object keys for deterministic output.
+- **FilePath** -- Path to the output JSON file.
+- **DataAddress** -- State address of the data to serialize. If empty, uses the full operation state.
+- **PrettyFormat** -- Pretty-print with indentation (default `true`).
+- **IndentType** -- Indent character: `tab` or `space` (default `tab`).
+- **IndentCount** -- Number of indent characters per level (default `1`).
+- **SortKeys** -- Alphabetically sort object keys for deterministic output.
 
 ### Outputs
 
-- **FileLocation** — The path as specified.
-- **FileName** — The base file name only.
-- **FilePath** — The fully resolved absolute path.
-- **BytesWritten** — Number of bytes written.
+- **FileLocation** -- The path as specified.
+- **FileName** -- The base file name only.
+- **FilePath** -- The fully resolved absolute path.
+- **BytesWritten** -- Number of bytes written.
 
 ### Events
 
-- **Done** — Fires on success.
-- **Error** — Fires on write failure.
+- **Done** -- Fires on success.
+- **Error** -- Fires on write failure.
 
 ### Tips
 
@@ -154,21 +154,21 @@ Copies a file from a source path to a target path.
 
 ### Settings
 
-- **Source** — Source file path.
-- **TargetFile** — Destination file path.
-- **Overwrite** — Allow overwriting an existing target file (default `true`).
+- **Source** -- Source file path.
+- **TargetFile** -- Destination file path.
+- **Overwrite** -- Allow overwriting an existing target file (default `true`).
 
 ### Outputs
 
-- **FileLocation** — The target path as specified.
-- **FileName** — The target file name only.
-- **FilePath** — The fully resolved absolute target path.
-- **BytesCopied** — Size of the copied file in bytes.
+- **FileLocation** -- The target path as specified.
+- **FileName** -- The target file name only.
+- **FilePath** -- The fully resolved absolute target path.
+- **BytesCopied** -- Size of the copied file in bytes.
 
 ### Events
 
-- **Done** — Fires on successful copy.
-- **Error** — Fires if the source is missing or the target cannot be written.
+- **Done** -- Fires on successful copy.
+- **Error** -- Fires if the source is missing or the target cannot be written.
 
 ### Tips
 
@@ -182,21 +182,21 @@ Lists files in a directory with optional glob pattern filtering.
 
 ### Settings
 
-- **Folder** — Directory path to list.
-- **Pattern** — Glob pattern filter (e.g. `*.txt`, `*.json`). Default `*` matches all files.
-- **Destination** — State address to store the resulting file list.
-- **Recursive** — When `true`, includes files in subdirectories.
-- **IncludeDirectories** — When `true`, includes directory entries in the results.
+- **Folder** -- Directory path to list.
+- **Pattern** -- Glob pattern filter (e.g. `*.txt`, `*.json`). Default `*` matches all files.
+- **Destination** -- State address to store the resulting file list.
+- **Recursive** -- When `true`, includes files in subdirectories.
+- **IncludeDirectories** -- When `true`, includes directory entries in the results.
 
 ### Outputs
 
-- **Files** — Array of file name strings matching the pattern.
-- **FileCount** — Number of entries found.
+- **Files** -- Array of file name strings matching the pattern.
+- **FileCount** -- Number of entries found.
 
 ### Events
 
-- **Complete** — Fires after listing is complete.
-- **Error** — Fires if the directory cannot be read.
+- **Complete** -- Fires after listing is complete.
+- **Error** -- Fires if the directory cannot be read.
 
 ### Tips
 
@@ -210,19 +210,19 @@ Downloads a file from a URL to the local staging directory.
 
 ### Settings
 
-- **SourceURL** — URL to download the file from (required). Supports Pict template expressions.
-- **Filename** — Name for the downloaded file in the staging directory (required).
+- **SourceURL** -- URL to download the file from (required). Supports Pict template expressions.
+- **Filename** -- Name for the downloaded file in the staging directory (required).
 
 ### Outputs
 
-- **LocalPath** — The fully resolved path to the downloaded file.
-- **BytesTransferred** — Number of bytes downloaded.
-- **DurationMs** — Time taken for the download in milliseconds.
+- **LocalPath** -- The fully resolved path to the downloaded file.
+- **BytesTransferred** -- Number of bytes downloaded.
+- **DurationMs** -- Time taken for the download in milliseconds.
 
 ### Events
 
-- **Complete** — Fires after a successful download.
-- **Error** — Fires if the download fails or the URL is unreachable.
+- **Complete** -- Fires after a successful download.
+- **Error** -- Fires if the download fails or the URL is unreachable.
 
 ### Tips
 
@@ -236,19 +236,19 @@ Marks a staging file as the operation's binary output. The file is uploaded to t
 
 ### Settings
 
-- **FilePath** — Path to the file in the staging directory (required).
-- **OutputKey** — Optional key to identify the output when an operation produces multiple result files.
+- **FilePath** -- Path to the file in the staging directory (required).
+- **OutputKey** -- Optional key to identify the output when an operation produces multiple result files.
 
 ### Outputs
 
-- **StagingFilePath** — The resolved path of the file that was sent.
-- **BytesSent** — Number of bytes uploaded.
-- **DurationMs** — Time taken for the upload in milliseconds.
+- **StagingFilePath** -- The resolved path of the file that was sent.
+- **BytesSent** -- Number of bytes uploaded.
+- **DurationMs** -- Time taken for the upload in milliseconds.
 
 ### Events
 
-- **Complete** — Fires after the file is successfully uploaded.
-- **Error** — Fires if the file cannot be read or the upload fails.
+- **Complete** -- Fires after the file is successfully uploaded.
+- **Error** -- Fires if the file cannot be read or the upload fails.
 
 ### Tips
 
@@ -262,19 +262,19 @@ Encodes a staging file to a base64 string.
 
 ### Settings
 
-- **FilePath** — Path to the file to encode (required).
-- **Destination** — State address to store the encoded string. If empty, uses the default output address.
+- **FilePath** -- Path to the file to encode (required).
+- **Destination** -- State address to store the encoded string. If empty, uses the default output address.
 
 ### Outputs
 
-- **EncodedData** — The base64-encoded string.
-- **EncodedLength** — Length of the encoded string in characters.
-- **OriginalBytes** — Size of the original file in bytes.
+- **EncodedData** -- The base64-encoded string.
+- **EncodedLength** -- Length of the encoded string in characters.
+- **OriginalBytes** -- Size of the original file in bytes.
 
 ### Events
 
-- **Complete** — Fires after successful encoding.
-- **Error** — Fires if the file cannot be read.
+- **Complete** -- Fires after successful encoding.
+- **Error** -- Fires if the file cannot be read.
 
 ### Tips
 
@@ -288,18 +288,18 @@ Decodes a base64 string and writes the result to a file in the staging directory
 
 ### Settings
 
-- **Source** — The base64-encoded string to decode (required). Supports Pict template expressions to pull from operation state.
-- **FilePath** — Path for the output file in the staging directory (required).
+- **Source** -- The base64-encoded string to decode (required). Supports Pict template expressions to pull from operation state.
+- **FilePath** -- Path for the output file in the staging directory (required).
 
 ### Outputs
 
-- **LocalPath** — The fully resolved path to the decoded file.
-- **DecodedBytes** — Number of bytes written to the file.
+- **LocalPath** -- The fully resolved path to the decoded file.
+- **DecodedBytes** -- Number of bytes written to the file.
 
 ### Events
 
-- **Complete** — Fires after successful decoding and write.
-- **Error** — Fires if the input is not valid base64 or the file cannot be written.
+- **Complete** -- Fires after successful decoding and write.
+- **Error** -- Fires if the input is not valid base64 or the file cannot be written.
 
 ### Tips
 

package/docs/features/tasks-flow-control.md

@@ -10,19 +10,19 @@ Evaluates a condition and branches execution to the True or False output. This i
 
 ### Settings
 
-- **DataAddress** — State address of the value to test.
-- **CompareValue** — Value to compare against.
-- **Operator** — Comparison operator: `==`, `!=`, `>`, `<`, `>=`, `<=`, `contains`, `startsWith`, `endsWith`. Default `==`.
-- **Expression** — A full expression string. When set, DataAddress/CompareValue/Operator are ignored and the expression is evaluated directly.
+- **DataAddress** -- State address of the value to test.
+- **CompareValue** -- Value to compare against.
+- **Operator** -- Comparison operator: `==`, `!=`, `>`, `<`, `>=`, `<=`, `contains`, `startsWith`, `endsWith`. Default `==`.
+- **Expression** -- A full expression string. When set, DataAddress/CompareValue/Operator are ignored and the expression is evaluated directly.
 
 ### Outputs
 
-- **Result** — Boolean result of the evaluation.
+- **Result** -- Boolean result of the evaluation.
 
 ### Events
 
-- **True** — Fires when the condition is true.
-- **False** — Fires when the condition is false.
+- **True** -- Fires when the condition is true.
+- **False** -- Fires when the condition is false.
 
 ### Tips
 
@@ -36,23 +36,23 @@ Splits a string by a delimiter and processes each token through a sub-graph, act
 
 ### Settings
 
-- **InputString** — The string to split. Supports Pict template expressions.
-- **SplitDelimiter** — Delimiter to split on (default newline `\n`).
-- **SkipEmpty** — When `true`, skips empty tokens after splitting.
-- **TrimTokens** — When `true`, trims whitespace from each token.
+- **InputString** -- The string to split. Supports Pict template expressions.
+- **SplitDelimiter** -- Delimiter to split on (default newline `\n`).
+- **SkipEmpty** -- When `true`, skips empty tokens after splitting.
+- **TrimTokens** -- When `true`, trims whitespace from each token.
 
 ### Outputs
 
-- **CurrentToken** — The current token being processed.
-- **TokenIndex** — Zero-based index of the current token.
-- **TokenCount** — Total number of tokens.
-- **CompletedCount** — Number of tokens processed so far.
+- **CurrentToken** -- The current token being processed.
+- **TokenIndex** -- Zero-based index of the current token.
+- **TokenCount** -- Total number of tokens.
+- **CompletedCount** -- Number of tokens processed so far.
 
 ### Events
 
-- **TokenDataSent** — Fires for each token, sending it through the sub-graph.
-- **CompletedAllSubtasks** — Fires after all tokens have been processed.
-- **Error** — Fires on failure.
+- **TokenDataSent** -- Fires for each token, sending it through the sub-graph.
+- **CompletedAllSubtasks** -- Fires after all tokens have been processed.
+- **Error** -- Fires on failure.
 
 ### How It Works
 
@@ -74,21 +74,21 @@ Executes a child operation by its hash, with isolated operation state. This enab
 
 ### Settings
 
-- **OperationHash** — The hash identifier of the operation to launch.
-- **InputData** — JSON data to pass as input to the child operation.
-- **TimeoutMs** — Maximum execution time in milliseconds. Set to `0` for unlimited.
-- **InheritGlobalState** — When `true` (default), copies the parent's GlobalState into the child operation.
+- **OperationHash** -- The hash identifier of the operation to launch.
+- **InputData** -- JSON data to pass as input to the child operation.
+- **TimeoutMs** -- Maximum execution time in milliseconds. Set to `0` for unlimited.
+- **InheritGlobalState** -- When `true` (default), copies the parent's GlobalState into the child operation.
 
 ### Outputs
 
-- **Result** — The result data returned by the child operation.
-- **Status** — Final status of the child operation.
-- **ElapsedMs** — Execution time of the child operation in milliseconds.
+- **Result** -- The result data returned by the child operation.
+- **Status** -- Final status of the child operation.
+- **ElapsedMs** -- Execution time of the child operation in milliseconds.
 
 ### Events
 
-- **Completed** — Fires when the child operation finishes.
-- **Error** — Fires if the child operation fails or times out.
+- **Completed** -- Fires when the child operation finishes.
+- **Error** -- Fires if the child operation fails or times out.
 
 ### Tips
 
@@ -102,23 +102,23 @@ Executes a shell command on the server and captures its output.
 
 ### Settings
 
-- **Command** — The shell command to execute (e.g. `ls`, `git`, `python3`).
-- **Parameters** — Command-line arguments as a single string.
-- **Description** — Human-readable description of what this command does (for documentation only).
-- **WorkingDirectory** — Working directory for the command.
-- **TimeoutMs** — Command timeout in milliseconds (default `300000` — 5 minutes).
-- **Environment** — JSON object of environment variables to set for the command.
+- **Command** -- The shell command to execute (e.g. `ls`, `git`, `python3`).
+- **Parameters** -- Command-line arguments as a single string.
+- **Description** -- Human-readable description of what this command does (for documentation only).
+- **WorkingDirectory** -- Working directory for the command.
+- **TimeoutMs** -- Command timeout in milliseconds (default `300000` -- 5 minutes).
+- **Environment** -- JSON object of environment variables to set for the command.
 
 ### Outputs
 
-- **StdOut** — Standard output from the command.
-- **StdErr** — Standard error output from the command.
-- **ExitCode** — Exit code (0 typically indicates success).
+- **StdOut** -- Standard output from the command.
+- **StdErr** -- Standard error output from the command.
+- **ExitCode** -- Exit code (0 typically indicates success).
 
 ### Events
 
-- **Complete** — Fires when the command finishes.
-- **Error** — Fires if the command fails to start or times out.
+- **Complete** -- Fires when the command finishes.
+- **Error** -- Fires if the command fails to start or times out.
 
 ### Tips
 

package/docs/features/tasks-http-client.md

@@ -10,20 +10,20 @@ Performs an HTTP GET request and parses the response body as JSON.
 
 ### Settings
 
-- **URL** — The URL to request. Supports Pict template expressions for dynamic URLs.
-- **Headers** — JSON string of additional request headers (e.g. `{"Authorization": "Bearer ..."}`).
-- **Destination** — State address to store the parsed response data.
-- **TimeoutMs** — Request timeout in milliseconds (default `30000`).
+- **URL** -- The URL to request. Supports Pict template expressions for dynamic URLs.
+- **Headers** -- JSON string of additional request headers (e.g. `{"Authorization": "Bearer ..."}`).
+- **Destination** -- State address to store the parsed response data.
+- **TimeoutMs** -- Request timeout in milliseconds (default `30000`).
 
 ### Outputs
 
-- **Data** — The parsed JSON response object.
-- **StatusCode** — HTTP response status code.
+- **Data** -- The parsed JSON response object.
+- **StatusCode** -- HTTP response status code.
 
 ### Events
 
-- **Complete** — Fires on a successful response.
-- **Error** — Fires on network failure, timeout, or non-2xx status.
+- **Complete** -- Fires on a successful response.
+- **Error** -- Fires on network failure, timeout, or non-2xx status.
 
 ### Tips
 
@@ -37,20 +37,20 @@ Performs an HTTP GET request and returns the response body as plain text.
 
 ### Settings
 
-- **URL** — The URL to request.
-- **Destination** — State address to store the response text.
-- **Headers** — JSON string of additional request headers.
-- **TimeoutMs** — Request timeout in milliseconds (default `30000`).
+- **URL** -- The URL to request.
+- **Destination** -- State address to store the response text.
+- **Headers** -- JSON string of additional request headers.
+- **TimeoutMs** -- Request timeout in milliseconds (default `30000`).
 
 ### Outputs
 
-- **Data** — The response body as a string.
-- **StatusCode** — HTTP response status code.
+- **Data** -- The response body as a string.
+- **StatusCode** -- HTTP response status code.
 
 ### Events
 
-- **Complete** — Fires on a successful response.
-- **Error** — Fires on network failure or timeout.
+- **Complete** -- Fires on a successful response.
+- **Error** -- Fires on network failure or timeout.
 
 ### Tips
 
@@ -64,22 +64,22 @@ Sends JSON data to a URL via HTTP POST or PUT.
 
 ### Settings
 
-- **URL** — The URL to send data to.
-- **Method** — HTTP method: `POST` or `PUT` (default `POST`).
-- **DataAddress** — State address of the object to send as the request body.
-- **Headers** — JSON string of additional request headers.
-- **Destination** — State address to store the response data.
-- **TimeoutMs** — Request timeout in milliseconds (default `30000`).
+- **URL** -- The URL to send data to.
+- **Method** -- HTTP method: `POST` or `PUT` (default `POST`).
+- **DataAddress** -- State address of the object to send as the request body.
+- **Headers** -- JSON string of additional request headers.
+- **Destination** -- State address to store the response data.
+- **TimeoutMs** -- Request timeout in milliseconds (default `30000`).
 
 ### Outputs
 
-- **Response** — The parsed response data.
-- **StatusCode** — HTTP response status code.
+- **Response** -- The parsed response data.
+- **StatusCode** -- HTTP response status code.
 
 ### Events
 
-- **Complete** — Fires on success.
-- **Error** — Fires on failure.
+- **Complete** -- Fires on success.
+- **Error** -- Fires on failure.
 
 ### Tips
 
@@ -93,26 +93,26 @@ Performs a fully configurable HTTP request with support for any method, custom c
 
 ### Settings
 
-- **URL** — The URL to request.
-- **Method** — HTTP method: `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, etc. (default `GET`).
-- **ContentType** — Content-Type header value (default `application/json`).
-- **Headers** — JSON string of additional request headers.
-- **Body** — Request body as a JSON string or raw text.
-- **Destination** — State address to store the response.
-- **Retries** — Number of retries on failure (default `0`).
-- **TimeoutMs** — Request timeout in milliseconds (default `30000`).
-- **RetryDelayMs** — Delay between retry attempts in milliseconds (default `1000`).
+- **URL** -- The URL to request.
+- **Method** -- HTTP method: `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, etc. (default `GET`).
+- **ContentType** -- Content-Type header value (default `application/json`).
+- **Headers** -- JSON string of additional request headers.
+- **Body** -- Request body as a JSON string or raw text.
+- **Destination** -- State address to store the response.
+- **Retries** -- Number of retries on failure (default `0`).
+- **TimeoutMs** -- Request timeout in milliseconds (default `30000`).
+- **RetryDelayMs** -- Delay between retry attempts in milliseconds (default `1000`).
 
 ### Outputs
 
-- **Response** — The response data.
-- **StatusCode** — HTTP response status code.
-- **ResponseHeaders** — JSON string of response headers.
+- **Response** -- The response data.
+- **StatusCode** -- HTTP response status code.
+- **ResponseHeaders** -- JSON string of response headers.
 
 ### Events
 
-- **Complete** — Fires on success.
-- **Error** — Fires on failure after all retries are exhausted.
+- **Complete** -- Fires on success.
+- **Error** -- Fires on failure after all retries are exhausted.
 
 ### Tips