@copado/agentia-cli 1.2.0 → 1.3.0

package/templates/skills/agentia-testing/references/qforce.md

@@ -0,0 +1,88 @@
+<!-- Agentia managed skill file: agentia setup skills -->
+
+# QForce & Salesforce Lightning Reference for CRT
+
+QForce is Copado Robotic Testing's Salesforce keyword library. It is a superset of [QWeb](qweb.md): all QWeb keywords (`ClickText`, `TypeText`, `VerifyText`, `UseTable`, etc.) work unchanged, and QForce adds Salesforce Lightning-aware locators and keywords on top.
+
+To start a Salesforce browser session:
+
+```sh
+agentia testing browser start <job-id> --project <project-id> --library QForce --json
+agentia testing browser execute --project <project-id> --line "SetConfig    PartialMatch    False" --json
+```
+
+When these Salesforce-specific rules conflict with generic QWeb text-first guidance, **the Salesforce rule wins**.
+
+## Mandatory Salesforce Rules
+
+1. **Always normalize app state with `LaunchApp`**:
+   Immediately after login—and before any app-specific click, tab navigation, or assertion—run:
+   ```robotframework
+   LaunchApp    Sales
+   ```
+   `LaunchApp` is idempotent: it checks the active Lightning app and only opens the App Launcher when needed. Never skip it just because the right app appears open, and do not replace it with manual clicks on the App Launcher waffle icon.
+2. **Verify Record Details with `VerifyField`, never `VerifyText`**:
+   Lightning record pages contain repeated labels in headers, related lists, and activity timelines, causing `VerifyText` to pass for the wrong reason.
+3. **Three dropdown families require three distinct keywords**:
+   - Native HTML `<select>` -> `DropDown    <label>    <value>`
+   - Lightning custom picklist (button/div/listbox widget) -> `PickList    <label>    <value>`
+   - Lookup / searchable combobox (`input` with `role="combobox"`) -> `ComboBox    <locator>    <value>    timeout=10`
+4. **Lookups (`ComboBox`) only select existing records**:
+   Never finish a lookup field with `TypeText` (typed text is not a selected record). If the target record does not exist, use the nested `New <Object>` creation flow.
+5. **Never hard-code org-specific Lightning URLs or record IDs**:
+   Navigate via `LaunchApp` and object tabs so tests survive sandbox refreshes. Store credentials in CRT Variables (`testing variable`) or User Parameters (`testing user-parameter`) and type secrets with `TypeSecret`.
+
+## QForce Keyword Catalog
+
+In `.robot` files and `testing browser execute`, always use `KeywordCase` (`LaunchApp`, `VerifyField`, `PickList`, `ComboBox`). Separate arguments with 4+ spaces.
+
+| Keyword | Form | When to Use |
+| --- | --- | --- |
+| `LaunchApp` | `LaunchApp    <Exact App Name>` | Open a Salesforce Lightning app via the App Launcher by exact name (`Sales`, `Service`). |
+| `VerifyField` | `VerifyField    <label>    <expected>` | Assert a plain-text field value on a Record Details page (`VerifyField    Phone    123456789`). |
+| `VerifyField` (link) | `VerifyField    <label>    <expected>    tag=a` | Assert a linked field value (lookup, owner, related record: `VerifyField    Account Name    Acme    tag=a`). |
+| `VerifyField` (indexed) | `VerifyField    <label>    <expected>    <index>    [tag=a]` | Disambiguate when the same field label appears multiple times on the Details page. Discover `<index>` with `GetFieldValue` first. |
+| `GetFieldValue` | `GetFieldValue    <label>    [index]` | Read the value of the Nth field with `<label>` to discover which index to pass to `VerifyField`. |
+| `PickList` | `PickList    <label>    <value>    [index=1]    [timeout=0]` | Select an option from a Lightning custom picklist (`PickList    Stage    Closed Won`). |
+| `ComboBox` | `ComboBox    <locator>    <value>    timeout=10` | Search and select an **existing** record in a Lightning lookup/combobox (`ComboBox    Account Name    Acme    timeout=10` or `ComboBox    Search Accounts...    Acme    timeout=10`). |
+
+## Record Details Verification Ladder
+
+On a Salesforce record's **Details** tab, follow this order:
+
+1. **Plain field**: `VerifyField    <label>    <expected>`
+2. **Linked field (lookup/owner)**: `VerifyField    <label>    <expected>    tag=a`
+3. **Duplicate field label on page**: Probe indexes with `GetFieldValue`, then assert with indexed `VerifyField`:
+   ```robotframework
+   GetFieldValue    Account Name    1
+   GetFieldValue    Account Name    2
+   VerifyField      Account Name    Acme Corp    2    tag=a
+   ```
+4. **Never use `VerifyText` as the primary Details assertion**, and do not assert on ephemeral toast messages (toasts vanish quickly; verify the saved record's Details instead).
+
+## Lookup Fields & Nested Record Creation
+
+When filling a lookup field (such as `Account Name` on a Contact or Opportunity):
+
+- **If the target record exists**:
+  ```robotframework
+  ComboBox       Account Name    Acme Corp    timeout=10
+  ClickText      Save
+  ClickText      Details
+  VerifyField    Account Name    Acme Corp    tag=a
+  ```
+- **If `ComboBox` fails (`Could not find combobox ... with value ...`) or the record does not exist**:
+  Do not retry `ComboBox` in a loop and do not leave raw `TypeText` in the input. Trigger the nested `New <Object>` modal from the lookup instead:
+  ```robotframework
+  ClickText      Account Name
+  ClickText      New Account
+  TypeText       Account Name    Acme Corp
+  ClickText      Save
+  ```
+
+## Recognising Dropdown Types via `testing browser inspect`
+
+When unsure whether a field uses `DropDown`, `PickList`, or `ComboBox`, run `agentia testing browser inspect --project <project-id> --json` and check the element in `systemState`:
+- `elementType: "select"` -> `DropDown`
+- Clickable button/div showing the current picklist value (not an `input`) -> `PickList`
+- `elementType: "input"` with `role: "combobox"` or placeholder `Search ...` -> `ComboBox`

package/templates/skills/agentia-testing/references/qweb.md

@@ -0,0 +1,103 @@
+<!-- Agentia managed skill file: agentia setup skills -->
+
+# QWeb Keyword Reference for CRT
+
+QWeb is the web-automation Robot Framework library used by Copado Robotic Testing in `.robot` suites (`agentia testing job run`) and browser sessions (`agentia testing browser start <job-id> --project <project-id>`).
+
+For goal-driven exploration in a browser session, pair this reference with [flow-automation.md](flow-automation.md). For Salesforce Lightning, also load [qforce.md](qforce.md).
+
+## Syntax & Formatting Rules
+
+- **4+ space separator**: Separate the keyword name, positional arguments, and `key=value` named arguments with **at least 4 spaces** (`KeywordName    arg1    arg2    anchor=Header`). Never use a single space—Robot Framework treats `ClickText Login` as a single nonexistent keyword name.
+- **Prefer visible text over XPath**: `PartialMatch` is `True` by default in browser sessions (`SetConfig    PartialMatch    False` forces exact matches).
+- **`anchor=<text>` for disambiguation**: When the same text appears multiple times, pass `anchor=<nearby text>` (`ClickText    Edit    anchor=Profile`). Use 1-based `index=<N>` only as a last resort.
+- **Booleans**: Capitalize `True` and `False` (`clear=False`, `partial_match=False`).
+- **Submitting on Enter**: Append `\n` to `TypeText` (`TypeText    Search    laptop\n`) or run `PressKey    ${EMPTY}    {ENTER}`.
+- **XPath `=` escaping**: In browser testing (`testing browser execute`), Agentia automatically escapes `=` inside `//...` XPath tokens so Robot Framework does not misread `@id="x"` as a named parameter.
+
+## Keyword Catalog
+
+### Navigation
+
+| Keyword | Form | Notes |
+| --- | --- | --- |
+| `GoTo` | `GoTo    https://example.com` | Navigate to a full URL (`https://...`). |
+| `Back` / `Forward` | `Back` | Browser history navigation. |
+| `RefreshPage` | `RefreshPage` | Reload the current page. |
+| `Open Browser` | `Open Browser    about:blank    chrome` | Suite setup; already executed during `testing browser start` unless `--no-browser` is passed. |
+| `Close All Browsers` | `Close All Browsers` | Suite teardown. Do not call during an active browser session; use `testing browser stop` instead. |
+
+### Clicking
+
+| Keyword | Form | When to Use |
+| --- | --- | --- |
+| `ClickText` | `ClickText    <text>    [anchor=<text>]` | Default choice for any button, link, or tab with visible text. |
+| `ClickItem` | `ClickItem    <alt_or_title>    [anchor=<text>]` | Click by `alt`, `title`, `tooltip`, `data-tooltip`, or `data-icon` (ideal for icon-only buttons). |
+| `ClickElement` | `ClickElement    <xpath>` | Last resort when neither `ClickText` nor `ClickItem` can target the element. |
+| `ClickCheckbox` | `ClickCheckbox    <label>    on\|off` | Idempotently set a checkbox to `on` or `off`. |
+| `ClickList` | `ClickList    <list_locator>    <item_text>` | Click an item inside a list widget. |
+| `ClickCell` | `ClickCell    <row>    <col>` | Click a cell inside the active table (requires `UseTable` first). |
+
+### Typing & Form Inputs
+
+| Keyword | Form | Notes |
+| --- | --- | --- |
+| `TypeText` | `TypeText    <label>    <value>    [clear=False]` | Clears the field and types `<value>`. Append `\n` to submit. |
+| `TypeSecret` | `TypeSecret    <label>    <value>` | Same as `TypeText`, but masks the value in logs and Agentia browser history. |
+| `DropDown` | `DropDown    <label>    <option>` | Select an option from a native HTML `<select>` element. |
+| `GetInputValue` | `GetInputValue    <label>` | Read the current value of an input field. |
+
+### Verification & Reading
+
+| Keyword | Form | Notes |
+| --- | --- | --- |
+| `VerifyText` | `VerifyText    <text>    [timeout=30]` | Assert visible text appears on the page (preferred over `Sleep` for waiting). |
+| `VerifyNoText` | `VerifyNoText    <text>    [timeout=10]` | Assert text does not appear (or disappears). |
+| `VerifyItem` | `VerifyItem    <alt_or_title>` | Assert an element with the given `alt`/`title`/`tooltip` exists. |
+| `VerifyElement` | `VerifyElement    <xpath>    [timeout=30]` | Assert an XPath exists in the DOM. |
+| `VerifyValue` | `VerifyValue    <label>    <expected>` | Assert an input field holds `<expected>`. |
+| `VerifyCheckboxValue` | `VerifyCheckboxValue    <label>    on\|off` | Assert a checkbox state. |
+| `GetText` | `GetText    <locator>` | Read visible text of an element. |
+| `GetAttribute` | `GetAttribute    <locator>    <attribute>` | Read an attribute (e.g., `href`, `aria-expanded`, `outerHTML`). |
+| `GetTitle` | `GetTitle` | Read the document title (also useful as a harmless keepalive keyword in browser sessions). |
+
+### Hover, Scroll, Drag & Keyboard
+
+| Keyword | Form | Notes |
+| --- | --- | --- |
+| `HoverText` / `HoverElement` | `HoverText    <text>` | Hover over an element to reveal menus or tooltips. |
+| `Scroll` | `Scroll    <locator>    page_down\|page_up\|<px>` | Scroll an element or `//html` for the full page. |
+| `ScrollTo` | `ScrollTo    <text_locator>` | Scroll until `<text_locator>` is in view. |
+| `DragDrop` | `DragDrop    <source>    <target>` | Drag one element onto another. |
+| `PressKey` | `PressKey    <locator>    <key>` | Use `${EMPTY}` for global key press (`{ENTER}`, `{ESC}`, `{TAB}`). |
+
+### Stateful Tables
+
+Call `UseTable` once to bind the active table, then address cells by 1-based row/column (`r1`, `c2`) or header/row text:
+
+```robotframework
+UseTable       Users
+ClickCell      r1    Email
+VerifyTable    r1    Status    Active
+```
+
+### Configuration (`SetConfig`)
+
+| Setting | Example | Purpose |
+| --- | --- | --- |
+| `DefaultTimeout` | `SetConfig    DefaultTimeout    20s` | Global auto-wait timeout for locators (default `10s`). |
+| `XHRTimeout` | `SetConfig    XHRTimeout    30s` | Wait for pending XHR/network activity before acting. |
+| `PartialMatch` | `SetConfig    PartialMatch    False` | Require exact text matches instead of substring matches. |
+| `CaseInsensitive` | `SetConfig    CaseInsensitive    True` | Enable case-insensitive text matching. |
+| `ClickToFocus` | `SetConfig    ClickToFocus    True` | Click inputs before typing (enabled by default in browser sessions). |
+
+## Decision Tree
+
+1. **Open a URL** -> `GoTo    https://...`
+2. **Click readable text** -> `ClickText    <text>` (add `anchor=<nearby>` if repeated)
+3. **Click an icon/image with no text** -> `ClickItem    <alt_or_title>`, else `ClickElement    <xpath>`
+4. **Type into a field** -> `TypeText    <label>    <value>` (or `TypeSecret` for passwords/tokens)
+5. **Select from a native `<select>`** -> `DropDown    <label>    <option>`
+6. **Toggle a checkbox** -> `ClickCheckbox    <label>    on`
+7. **Wait for page readiness** -> `VerifyText    <landmark>    timeout=30` (avoid `Sleep`)
+8. **Work with a table** -> `UseTable    <table_name>` -> `VerifyTable` / `ClickCell`

package/templates/skills/agentia-testing/references/tests.md

@@ -46,7 +46,7 @@ agentia testing job runs logs <build-id> --project <project-id> --job <job-id> -
 | Variables | `testing variable list|get|create|update|delete` |
 | User parameters | `testing user-parameter list|get|create|update|delete` |
 | Data tables | `testing data-table list|get|create|update|delete|export` |
-| Live testing | `testing live start|stop|status|execute|continue|interrupt|inspect|screenshot|reports|set-options|history|view|recorder` |
+| Browser testing | `testing browser start|stop|status|execute|inspect|screenshot|reports|set-options|history|view|recorder` |
 
 `testing job` is the single namespace for test definitions and their runs. Commands directly under `job` take a job ID; `job runs get|logs|abort` take a build/run ID plus `--job`. On `testing job create` and `testing job update`, `--[no-]show-video-params` (`showVideoParams` in the API/MCP) enables or disables Video Streaming and Recording capabilities when running the test job. The older `testing create|update|status|logs|run`, `testing test ...`, `testing build ...`, and `testing job files|upload|download` forms are deprecated aliases that still execute but warn when used: `create` maps to `job create`, `update` to `job files upload` (file operations, not `job update`), `status`, `build list`, and `build latest` to `job runs list`, `build get` to `job runs get`, and `build search|logs|abort` to `job runs search|logs|abort`.
 
@@ -65,19 +65,27 @@ Schedules support get, set with cron/timezone/record policy, and remove. Data ta
 
 Data-table create/update/delete and existing-file overwrite are protected operations. Never overwrite or delete without user intent.
 
-## Live Testing
+## Browser Testing
 
 Use a regression-owned job:
 
 ```sh
-agentia testing live start <job-id> --project <project-id> --json
-agentia testing live status --project <project-id> --json
-agentia testing live execute --project <project-id> --line "GoTo  https://example.com" --json
-agentia testing live inspect --project <project-id> --json
-agentia testing live stop --project <project-id> --yes --json
+agentia testing browser start <job-id> --project <project-id> --json
+agentia testing browser status --project <project-id> --json
+agentia testing browser view --project <project-id> --no-open --json
+agentia testing browser execute --project <project-id> --line "GoTo    https://example.com" --json
+agentia testing browser inspect --project <project-id> --json
+agentia testing browser history <job-id> --project <project-id> --lines-only
+agentia testing browser stop --project <project-id> --yes --json
 ```
 
-Live viewer secrets remain in the keychain. Session cookies and XSRF values are in-memory only. `view` opens an authenticated page without putting secrets in the URL. `recorder` is long-running and uses an owner-scoped local lock; neither `view` nor `recorder` is exposed through MCP.
+Always pass `--no-open` to `testing browser view` by default to print/return the interactive CRT browser session URL without launching a browser; omit `--no-open` only when the user explicitly asks to open the browser. Session cookies and XSRF values remain in-memory only. `recorder` is long-running and uses an owner-scoped local lock (`--force` reclaims a stale lock); neither `view` nor `recorder` is exposed through MCP. The older `testing live ...` commands remain available as deprecated aliases, except `continue` and `interrupt`, which were removed.
+
+For deep browser-testing guidance, load:
+- [browser-testing.md](browser-testing.md) — subcommands, flags, parallel recorder subagent pattern, 600s idle keepalive, and troubleshooting
+- [flow-automation.md](flow-automation.md) — Observe -> Act -> Verify -> Recover loop and reading `screenshot` detection overlays with `inspect` `systemState`
+- [qweb.md](qweb.md) — QWeb keyword catalog, 4+ space separator rule, and locator priority
+- [qforce.md](qforce.md) — Salesforce Lightning rules (`--library QForce`, `LaunchApp`, `VerifyField`, `PickList`, `ComboBox`)
 
 ## Secret Inputs And Redaction
 
@@ -90,7 +98,7 @@ Live viewer secrets remain in the keychain. Session cookies and XSRF values are
 
 Destructive or protected CLI actions prompt in an interactive TTY. JSON and non-TTY calls require `--yes`. Matching MCP tools require `confirm: true`, not a `yes` field.
 
-This applies to resource deletion, build abort, schedule removal, live stop, protected data-table imports/deletion, and output overwrite.
+This applies to resource deletion, build abort, schedule removal, browser stop, protected data-table imports/deletion, and output overwrite.
 
 ## Gotchas
 

package/dist/commands/testing/live/continue.js

@@ -1,16 +0,0 @@
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { runTestingLiveControlCommand, testingLiveCommonFlags, testingLiveOptionalJobArg, } from '../../../lib/testing-live-command.js';
-export default class TestingLiveContinue extends AgentiaCommand {
-    static args = testingLiveOptionalJobArg;
-    static description = 'Continue paused Robot execution in the active CRT live session';
-    static examples = ['<%= config.bin %> <%= command.id %> --project <project-id>'];
-    static flags = testingLiveCommonFlags;
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveContinue);
-        return runTestingLiveControlCommand('continue', args, flags, {
-            display: (fn) => this.display(fn),
-            log: (msg) => this.log(msg),
-        });
-    }
-}
-//# sourceMappingURL=continue.js.map

package/dist/commands/testing/live/execute.js

@@ -1,43 +0,0 @@
-import { Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags, testingLiveOptionalJobArg } from '../../../lib/testing-live-command.js';
-import { executeTestingLive } from '../../../lib/testing-live-operations.js';
-export default class TestingLiveExecute extends AgentiaCommand {
-    static args = testingLiveOptionalJobArg;
-    static description = 'Execute bounded Robot Framework keywords in an active CRT live session';
-    static examples = [
-        '<%= config.bin %> <%= command.id %> --project <project-id> --keyword GoTo --arg https://example.com',
-        '<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --file smoke.robot --section Login',
-    ];
-    static flags = {
-        ...testingLiveCommonFlags,
-        arg: Flags.string({ description: 'Keyword argument. Repeat to preserve argument boundaries.', multiple: true }),
-        file: Flags.string({ description: 'Robot Framework input file.' }),
-        keyword: Flags.string({ description: 'Robot Framework keyword name.' }),
-        line: Flags.string({ description: 'Raw Robot Framework keyword line. Repeat for multiple lines.', multiple: true }),
-        raw: Flags.boolean({ default: false, description: 'Treat file input as raw keyword lines.' }),
-        section: Flags.string({ description: 'Robot test/task name to execute.' }),
-        'section-index': Flags.integer({ description: 'One-based Robot test/task index to execute.', min: 1 }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveExecute);
-        const supplied = [flags.keyword !== undefined, flags.file !== undefined, (flags.line?.length ?? 0) > 0].filter(Boolean);
-        if (supplied.length !== 1)
-            throw new Error('Use exactly one of --keyword, --line, or --file.');
-        const result = await this.withSpinner('Executing CRT live keyword', () => executeTestingLive({
-            args: flags.arg,
-            file: flags.file,
-            jobId: args['job-id'],
-            keyword: flags.keyword,
-            lines: flags.line,
-            projectId: flags.project,
-            raw: flags.raw,
-            section: flags.section,
-            sectionIndex: flags['section-index'],
-            sessionId: flags['session-id'],
-        }));
-        this.display(() => this.log(`Execution ${result.executionId}: ${result.status}`));
-        return result;
-    }
-}
-//# sourceMappingURL=execute.js.map

package/dist/commands/testing/live/history.js

@@ -1,40 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags } from '../../../lib/testing-live-command.js';
-import { getTestingLiveHistory } from '../../../lib/testing-live-operations.js';
-import { readTestingLiveState } from '../../../lib/testing-live-state.js';
-export default class TestingLiveHistory extends AgentiaCommand {
-    static args = {
-        'job-id': Args.integer({ description: 'CRT job ID; defaults to the active session.', required: false }),
-    };
-    static description = 'Read bounded sanitized local CRT live execution history';
-    static examples = ['<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --limit 20 --json'];
-    static flags = {
-        ...testingLiveCommonFlags,
-        limit: Flags.integer({ default: 10, description: 'Maximum records to return.', max: 500, min: 1 }),
-        status: Flags.option({
-            description: 'Execution status filter.',
-            options: ['completed', 'failed', 'recorded'],
-        })(),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveHistory);
-        const active = args['job-id'] === undefined ? await readTestingLiveState() : undefined;
-        const jobId = args['job-id'] ?? active?.jobId;
-        if (jobId === undefined || (active !== undefined && active.projectId !== flags.project)) {
-            throw new Error('Provide a job ID or start a live session for this project.');
-        }
-        const result = getTestingLiveHistory({
-            jobId,
-            limit: flags.limit,
-            projectId: flags.project,
-            status: flags.status,
-        });
-        this.display(() => {
-            for (const execution of result.executions)
-                this.log(`${execution.startedAt} [${execution.status}] ${execution.lines.join(' | ')}`);
-        });
-        return result;
-    }
-}
-//# sourceMappingURL=history.js.map

package/dist/commands/testing/live/inspect.js

@@ -1,31 +0,0 @@
-import { Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags, testingLiveOptionalJobArg } from '../../../lib/testing-live-command.js';
-import { inspectTestingLive } from '../../../lib/testing-live-operations.js';
-import { formatTestingRecord } from '../../../lib/testing-types.js';
-export default class TestingLiveInspect extends AgentiaCommand {
-    static args = testingLiveOptionalJobArg;
-    static description = 'Inspect bounded, sanitized page state from an active CRT live session';
-    static examples = [
-        '<%= config.bin %> <%= command.id %> --project <project-id> --json',
-        '<%= config.bin %> <%= command.id %> --project <project-id> --dom --output page.html',
-    ];
-    static flags = {
-        ...testingLiveCommonFlags,
-        dom: Flags.boolean({ default: false, description: 'Fetch raw page DOM; requires --output.' }),
-        output: Flags.string({ dependsOn: ['dom'], description: 'Explicit file path for raw DOM.' }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveInspect);
-        const result = await this.withSpinner('Inspecting CRT live session', () => inspectTestingLive({
-            dom: flags.dom,
-            jobId: args['job-id'],
-            output: flags.output,
-            projectId: flags.project,
-            sessionId: flags['session-id'],
-        }));
-        this.display(() => this.log(flags.dom ? `DOM written to ${String(result.path)}.` : formatTestingRecord(result)));
-        return result;
-    }
-}
-//# sourceMappingURL=inspect.js.map

package/dist/commands/testing/live/interrupt.js

@@ -1,16 +0,0 @@
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { runTestingLiveControlCommand, testingLiveCommonFlags, testingLiveOptionalJobArg, } from '../../../lib/testing-live-command.js';
-export default class TestingLiveInterrupt extends AgentiaCommand {
-    static args = testingLiveOptionalJobArg;
-    static description = 'Interrupt Robot execution in the active CRT live session';
-    static examples = ['<%= config.bin %> <%= command.id %> --project <project-id>'];
-    static flags = testingLiveCommonFlags;
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveInterrupt);
-        return runTestingLiveControlCommand('interrupt', args, flags, {
-            display: (fn) => this.display(fn),
-            log: (msg) => this.log(msg),
-        });
-    }
-}
-//# sourceMappingURL=interrupt.js.map

package/dist/commands/testing/live/recorder.js

@@ -1,42 +0,0 @@
-import { Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags, testingLiveOptionalJobArg } from '../../../lib/testing-live-command.js';
-import { recordTestingLiveSession } from '../../../lib/testing-live-operations.js';
-export default class TestingLiveRecorder extends AgentiaCommand {
-    static args = testingLiveOptionalJobArg;
-    static description = 'Record CRT live interactions as bounded Robot Framework lines';
-    static enableJsonFlag = false;
-    static examples = ['<%= config.bin %> <%= command.id %> --project <project-id> --output recorded.robot'];
-    static flags = {
-        ...testingLiveCommonFlags,
-        debug: Flags.boolean({ default: false, description: 'Print frame sizes and event types without frame bodies.' }),
-        'no-enable': Flags.boolean({ default: false, description: 'Do not manage the server recorder toggle.' }),
-        output: Flags.string({ char: 'o', description: 'Explicit .robot file to append recorded keywords to.' }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveRecorder);
-        const controller = new AbortController();
-        const stop = () => controller.abort();
-        process.once('SIGINT', stop);
-        try {
-            return await recordTestingLiveSession({
-                appendRobot: flags.output,
-                jobId: args['job-id'],
-                noEnable: flags['no-enable'],
-                onDebugFrame: flags.debug
-                    ? ({ bytes, type }) => this.warn(`Recorder event ${type} (${bytes} bytes).`)
-                    : undefined,
-                onError: (error) => this.warn(error.message),
-                onKeywordLine: (line) => this.log(line),
-                onReady: () => this.log('Recording CRT interactions. Press Ctrl-C to stop.'),
-                projectId: flags.project,
-                sessionId: flags['session-id'],
-                signal: controller.signal,
-            });
-        }
-        finally {
-            process.removeListener('SIGINT', stop);
-        }
-    }
-}
-//# sourceMappingURL=recorder.js.map

package/dist/commands/testing/live/reports.js

@@ -1,31 +0,0 @@
-import { Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags, testingLiveOptionalJobArg } from '../../../lib/testing-live-command.js';
-import { getTestingLiveReports } from '../../../lib/testing-live-operations.js';
-export default class TestingLiveReports extends AgentiaCommand {
-    static args = testingLiveOptionalJobArg;
-    static description = 'List or save bounded report artifacts from an active CRT live session';
-    static examples = [
-        '<%= config.bin %> <%= command.id %> --project <project-id>',
-        '<%= config.bin %> <%= command.id %> --project <project-id> --output-dir ./reports',
-    ];
-    static flags = {
-        ...testingLiveCommonFlags,
-        'output-dir': Flags.string({ description: 'Explicit directory for log.html, report.html, and output.xml.' }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveReports);
-        const result = await this.withSpinner('Reading CRT live reports', () => getTestingLiveReports({
-            jobId: args['job-id'],
-            outputDir: flags['output-dir'],
-            projectId: flags.project,
-            sessionId: flags['session-id'],
-        }));
-        this.display(() => {
-            for (const file of result.files)
-                this.log(`${file.name}: ${file.bytes} bytes${file.path === undefined ? '' : ` -> ${file.path}`}`);
-        });
-        return result;
-    }
-}
-//# sourceMappingURL=reports.js.map

package/dist/commands/testing/live/screenshot.js

@@ -1,25 +0,0 @@
-import { Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags, testingLiveOptionalJobArg } from '../../../lib/testing-live-command.js';
-import { saveTestingLiveScreenshot } from '../../../lib/testing-live-operations.js';
-export default class TestingLiveScreenshot extends AgentiaCommand {
-    static args = testingLiveOptionalJobArg;
-    static description = 'Save a bounded CRT live browser screenshot to an explicit file';
-    static examples = ['<%= config.bin %> <%= command.id %> --project <project-id> --output screenshot.png'];
-    static flags = {
-        ...testingLiveCommonFlags,
-        output: Flags.string({ char: 'o', description: 'Explicit screenshot output path.', required: true }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveScreenshot);
-        const result = await this.withSpinner('Saving CRT live screenshot', () => saveTestingLiveScreenshot({
-            jobId: args['job-id'],
-            output: flags.output,
-            projectId: flags.project,
-            sessionId: flags['session-id'],
-        }));
-        this.display(() => this.log(`Wrote ${result.bytes} bytes to ${result.path}.`));
-        return result;
-    }
-}
-//# sourceMappingURL=screenshot.js.map

package/dist/commands/testing/live/set-options.js

@@ -1,35 +0,0 @@
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags, testingLiveOptionalJobArg, testingLiveRecorderOptionFlags, testingLiveRecorderOptions, } from '../../../lib/testing-live-command.js';
-import { setTestingLiveOptions } from '../../../lib/testing-live-operations.js';
-export default class TestingLiveSetOptions extends AgentiaCommand {
-    static args = testingLiveOptionalJobArg;
-    static description = 'Set the complete validated CRT live recorder option block';
-    static examples = [
-        '<%= config.bin %> <%= command.id %> --project <project-id> --enable --scroll-text --table-keywords',
-    ];
-    static flags = { ...testingLiveCommonFlags, ...testingLiveRecorderOptionFlags };
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveSetOptions);
-        const optionNames = [
-            'enable',
-            'healing-context',
-            'hover-text',
-            'scroll-text',
-            'system-state',
-            'table-keywords',
-            'verify-text',
-        ];
-        if (!optionNames.some((name) => flags[name] !== undefined)) {
-            throw new Error('Provide at least one recorder option; unspecified options are set to false.');
-        }
-        const result = await setTestingLiveOptions({
-            jobId: args['job-id'],
-            projectId: flags.project,
-            recorder: testingLiveRecorderOptions(flags),
-            sessionId: flags['session-id'],
-        });
-        this.display(() => this.log('CRT live recorder options updated.'));
-        return result;
-    }
-}
-//# sourceMappingURL=set-options.js.map

package/dist/commands/testing/live/start.js

@@ -1,58 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags } from '../../../lib/testing-live-command.js';
-import { startTestingLive } from '../../../lib/testing-live-operations.js';
-import { TESTING_LIVE_LIBRARIES } from '../../../lib/testing-live-types.js';
-export default class TestingLiveStart extends AgentiaCommand {
-    static args = {
-        'job-id': Args.integer({ description: 'CRT job ID.', required: true }),
-    };
-    static description = 'Start and bootstrap a bounded Copado Robotic Testing live session';
-    static examples = [
-        '<%= config.bin %> <%= command.id %> <job-id> --project <project-id>',
-        '<%= config.bin %> <%= command.id %> <job-id> --project <project-id> --file smoke.robot --section "Login"',
-    ];
-    static flags = {
-        ...testingLiveCommonFlags,
-        description: Flags.string({ description: 'Nonsecret session label.' }),
-        file: Flags.string({ description: 'Robot Framework file used to bootstrap a selected test/task.' }),
-        'jap-ime': Flags.boolean({ default: false, description: 'Enable Japanese IME in the live environment.' }),
-        library: Flags.option({
-            default: 'QWeb',
-            description: 'Robot Framework library to bootstrap.',
-            options: [...TESTING_LIVE_LIBRARIES],
-        })(),
-        'no-bootstrap': Flags.boolean({ default: false, description: 'Create the host without readiness/bootstrap calls.' }),
-        'no-browser': Flags.boolean({ default: false, description: 'Do not open Chrome during QWeb/QForce bootstrap.' }),
-        'poll-interval': Flags.integer({ default: 3, description: 'Readiness polling interval in seconds.', min: 1 }),
-        screen: Flags.string({ description: 'Session screen as WIDTHxHEIGHTxDEPTH.' }),
-        section: Flags.string({ description: 'Robot test/task name to bootstrap.' }),
-        'section-index': Flags.integer({ description: 'One-based Robot test/task index to bootstrap.', min: 1 }),
-        'session-version': Flags.string({ description: 'CRT live environment version.' }),
-        timeout: Flags.integer({ default: 120, description: 'Readiness timeout in seconds.', min: 1 }),
-        viewport: Flags.string({ description: 'Session viewport as WIDTHxHEIGHT (24-bit depth).' }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveStart);
-        const result = await this.withSpinner('Starting CRT live session', () => startTestingLive({
-            description: flags.description,
-            file: flags.file,
-            japIme: flags['jap-ime'],
-            jobId: args['job-id'],
-            library: flags.library,
-            noBootstrap: flags['no-bootstrap'],
-            noBrowser: flags['no-browser'],
-            pollIntervalMs: flags['poll-interval'] * 1000,
-            projectId: flags.project,
-            screen: flags.screen,
-            section: flags.section,
-            sectionIndex: flags['section-index'],
-            sessionVersion: flags['session-version'],
-            timeoutMs: flags.timeout * 1000,
-            viewport: flags.viewport,
-        }));
-        this.display(() => this.log(`CRT live session ${result.sessionId} is ready for job ${result.jobId}.`));
-        return result;
-    }
-}
-//# sourceMappingURL=start.js.map

package/dist/commands/testing/live/status.js

@@ -1,24 +0,0 @@
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingLiveCommonFlags, testingLiveOptionalJobArg } from '../../../lib/testing-live-command.js';
-import { getTestingLiveStatus } from '../../../lib/testing-live-operations.js';
-export default class TestingLiveStatus extends AgentiaCommand {
-    static args = testingLiveOptionalJobArg;
-    static description = 'Inspect sanitized status for the active CRT live session';
-    static examples = ['<%= config.bin %> <%= command.id %> --project <project-id> --json'];
-    static flags = testingLiveCommonFlags;
-    async run() {
-        const { args, flags } = await this.parse(TestingLiveStatus);
-        const result = await this.withSpinner('Reading CRT live status', () => getTestingLiveStatus({
-            jobId: args['job-id'],
-            projectId: flags.project,
-            sessionId: flags['session-id'],
-        }));
-        this.display(() => {
-            this.log(`Session: ${result.metadata.sessionId} (${result.metadata.status})`);
-            this.log(`Browser started: ${result.status.env.isBrowserStarted}`);
-            this.log(`Executor running: ${result.status.session.isRobotExecutorRunning}`);
-        });
-        return result;
-    }
-}
-//# sourceMappingURL=status.js.map