@copado/agentia-cli 0.112.0-alpha.0 → 0.113.0-alpha.0

package/dist/lib/testing-flags.js

@@ -1,5 +1,5 @@
 import { Flags } from '@oclif/core';
-import { TESTING_RECORD_BUILD_OPTIONS } from './testing-types.js';
+import { TESTING_CONSOLE_COLORS, TESTING_RECORD_BUILD_OPTIONS, TESTING_RUN_TYPES, } from './testing-types.js';
 export const testingProjectFlag = {
     project: Flags.integer({
         char: 'p',
@@ -7,6 +7,38 @@ export const testingProjectFlag = {
         required: true,
     }),
 };
+export const testingYesFlag = {
+    yes: Flags.boolean({
+        char: 'y',
+        default: false,
+        description: 'Skip the destructive confirmation prompt.',
+    }),
+};
+export const testingSecretInputFlags = {
+    'no-trim': Flags.boolean({
+        default: false,
+        description: 'Preserve leading and trailing whitespace in the supplied value.',
+        exclusive: ['trim'],
+    }),
+    trim: Flags.boolean({
+        default: false,
+        description: 'Trim leading and trailing whitespace (the default policy).',
+        exclusive: ['no-trim'],
+    }),
+    value: Flags.string({
+        description: 'Value supplied directly. Prefer file/stdin for sensitive values.',
+        exclusive: ['value-file', 'value-stdin'],
+    }),
+    'value-file': Flags.string({
+        description: 'Read the value from a bounded regular file.',
+        exclusive: ['value', 'value-stdin'],
+    }),
+    'value-stdin': Flags.boolean({
+        default: false,
+        description: 'Read the value from stdin.',
+        exclusive: ['value', 'value-file'],
+    }),
+};
 export const testingJobFlag = {
     job: Flags.integer({
         char: 'j',
@@ -23,14 +55,52 @@ export const testingRunOptionFlags = {
     branch: Flags.string({
         description: 'Git branch/ref to use for this run. Mutually exclusive with --tag.',
     }),
+    'console-colors': Flags.option({
+        description: 'Control Robot Framework console colors.',
+        options: [...TESTING_CONSOLE_COLORS],
+    })(),
+    'console-width': Flags.integer({
+        description: 'Set Robot Framework console width.',
+        min: 1,
+    }),
+    datatable: Flags.string({
+        description: 'Data table and 1-based datasets as TABLE_ID:1,2-4. Repeat for zipped table selections.',
+        multiple: true,
+    }),
+    doc: Flags.string({
+        description: 'Set top-level Robot Framework suite documentation.',
+    }),
+    'dry-run': Flags.boolean({
+        default: false,
+        description: 'Validate Robot Framework data without executing library keywords.',
+    }),
     exclude: Flags.string({
         description: 'Robot Framework tag to exclude from this run. Can be provided multiple times.',
         multiple: true,
     }),
+    'exit-on-error': Flags.boolean({
+        default: false,
+        description: 'Stop execution when Robot Framework encounters a data or import error.',
+    }),
+    'exit-on-failure': Flags.boolean({
+        default: false,
+        description: 'Stop execution when a critical Robot Framework test fails.',
+    }),
     include: Flags.string({
         description: 'Robot Framework tag to include in this run. Can be provided multiple times.',
         multiple: true,
     }),
+    metadata: Flags.string({
+        description: 'Robot Framework suite metadata. Can be provided multiple times.',
+        multiple: true,
+    }),
+    name: Flags.string({
+        description: 'Set the top-level Robot Framework suite name.',
+    }),
+    'no-exit-code': Flags.boolean({
+        default: false,
+        description: 'Return exit code zero even when the waited CRT run fails.',
+    }),
     param: Flags.string({
         description: 'Execution parameter in KEY=VALUE format. Can be provided multiple times.',
         multiple: true,
@@ -46,9 +116,63 @@ export const testingRunOptionFlags = {
         default: false,
         description: 'Rerun failed tests from the latest failed run. Mutually exclusive with --rerun-failed.',
     }),
+    'run-empty-suite': Flags.boolean({
+        default: false,
+        description: 'Execute even when the selected Robot Framework suite is empty.',
+    }),
+    'run-type': Flags.option({
+        description: 'CRT run type. Regression is sent as normal; development is sent unchanged.',
+        options: [...TESTING_RUN_TYPES],
+    })(),
+    'save-artifacts': Flags.string({
+        description: 'Save the completed run output ZIP to this explicit file path.',
+    }),
+    'set-tag': Flags.string({
+        description: 'Set a tag on all executed tests. Can be provided multiple times.',
+        multiple: true,
+    }),
+    skip: Flags.string({
+        description: 'Skip tests matching this tag. Can be provided multiple times.',
+        multiple: true,
+    }),
+    'skip-on-failure': Flags.string({
+        description: 'Skip failures for tests matching this tag. Can be provided multiple times.',
+        multiple: true,
+    }),
+    'stream-logs': Flags.boolean({
+        default: false,
+        description: 'Stream new CRT log text while waiting (human output only).',
+    }),
+    suite: Flags.string({
+        description: 'Select a Robot Framework suite. Can be provided multiple times.',
+        multiple: true,
+    }),
     tag: Flags.string({
         description: 'Git tag to use for this run. Mutually exclusive with --branch.',
     }),
+    test: Flags.string({
+        description: 'Select a Robot Framework test/task. Can be provided multiple times.',
+        multiple: true,
+    }),
+    timeout: Flags.integer({
+        default: 60,
+        description: 'Maximum number of minutes to wait for a terminal result.',
+        min: 1,
+    }),
+    variable: Flags.string({
+        description: 'Set a Robot Framework variable. Can be provided multiple times.',
+        multiple: true,
+    }),
+    'wait-for-result': Flags.boolean({
+        default: false,
+        description: 'Poll CRT until the started build reaches a terminal result.',
+    }),
+    watch: Flags.string({
+        description: 'Watch a directory and rerun after debounced file changes (human output only).',
+    }),
+    xunit: Flags.string({
+        description: 'Extract xunit_report.xml from completed run artifacts to this explicit file path.',
+    }),
 };
 export const testingOutputFlags = {
     output: Flags.string({
@@ -56,6 +180,31 @@ export const testingOutputFlags = {
         description: 'Write raw output to this file path.',
     }),
 };
+export const testingLogOptionFlags = {
+    container: Flags.string({
+        description: 'Read a specific CRT log stream/container.',
+    }),
+    'limit-bytes': Flags.integer({
+        description: 'Limit fetched log data to this many bytes.',
+        min: 1,
+    }),
+    pretty: Flags.boolean({
+        default: false,
+        description: 'Request readable log formatting.',
+    }),
+    'since-seconds': Flags.integer({
+        description: 'Fetch log lines from the last N seconds.',
+        min: 0,
+    }),
+    'tail-lines': Flags.integer({
+        description: 'Return only the last N log lines.',
+        min: 0,
+    }),
+    timestamps: Flags.boolean({
+        default: false,
+        description: 'Add timestamps to log lines.',
+    }),
+};
 export const testingFileInputFlags = {
     dir: Flags.string({
         description: 'Directory containing Robot Framework files to upload. Can be provided multiple times.',
@@ -76,6 +225,16 @@ export const testingGitStorageFlags = {
     }),
     'git-password': Flags.string({
         description: 'Git password/token for repository access. Prefer --git-domain-credential when available.',
+        exclusive: ['git-password-file', 'git-password-stdin'],
+    }),
+    'git-password-file': Flags.string({
+        description: 'Read a bounded Git password/token from a regular file.',
+        exclusive: ['git-password', 'git-password-stdin'],
+    }),
+    'git-password-stdin': Flags.boolean({
+        default: false,
+        description: 'Read a Git password/token from stdin.',
+        exclusive: ['git-password', 'git-password-file'],
     }),
     'git-tag': Flags.string({
         description: 'Git tag to use for a Git-backed CRT job. Mutually exclusive with --git-branch.',
@@ -114,15 +273,32 @@ export function testingRunOptions(flags, ids) {
     }
     return {
         branch: flags.branch,
+        consoleColors: flags['console-colors'],
+        consoleWidth: flags['console-width'],
+        dataTables: flags.datatable,
+        doc: flags.doc,
+        dryRun: flags['dry-run'],
         exclude: flags.exclude,
+        exitOnError: flags['exit-on-error'],
+        exitOnFailure: flags['exit-on-failure'],
         include: flags.include,
         jobId: ids.jobId,
+        metadata: flags.metadata,
+        name: flags.name,
         parameters: (flags.param ?? []).map((param) => parseTestingParameter(param)),
         projectId: ids.projectId,
         record: flags.record,
         rerunFailedFromLatest: flags['rerun-failed-from-latest'] === true ? true : undefined,
         rerunFailedId: flags['rerun-failed'],
+        runEmptySuite: flags['run-empty-suite'],
+        runType: flags['run-type'],
+        setTags: flags['set-tag'],
+        skip: flags.skip,
+        skipOnFailure: flags['skip-on-failure'],
+        suites: flags.suite,
         tag: flags.tag,
+        tests: flags.test,
+        variables: flags.variable,
     };
 }
 function parseTestingParameter(spec) {

package/dist/lib/testing-flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing-flags.js","sourceRoot":"","sources":["../../src/lib/testing-flags.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"testing-flags.js","sourceRoot":"","sources":["../../src/lib/testing-flags.ts"],"names":[],"mappings":"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"}

package/dist/lib/testing-gateway.d.ts

@@ -1,14 +1,24 @@
 import { URL } from 'node:url';
 import { type TestingConnectionOverrides } from './testing-config.js';
 export declare const TESTING_DEFAULT_TIMEOUT_MS = 45000;
+export declare const TESTING_MAX_RESPONSE_BYTES: number;
+export declare const TESTING_MAX_ARTIFACT_BYTES: number;
 export type TestingRequest = {
+    auth?: {
+        cookie: string;
+        mode: 'session';
+        xsrfToken?: string;
+    };
     body?: unknown;
     endpoint: string;
+    headers?: Record<string, string>;
+    maxResponseBytes?: number;
     method: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
-    responseType?: 'json' | 'text';
-    service: 'pace' | 'platform';
+    responseType?: 'buffer' | 'json' | 'text';
+    service: 'metrics' | 'pace' | 'platform' | 'session' | 'test-data';
+    sessionPath?: string;
 };
-export type TestingHttpRequestFn = (url: URL, method: string, headers: Record<string, string>, body: unknown, timeoutMs: number) => Promise<string>;
+export type TestingHttpRequestFn = (url: URL, method: string, headers: Record<string, string>, body: unknown, timeoutMs: number, maxResponseBytes?: number) => Promise<Buffer | string>;
 export type TestingGatewayCallOptions = TestingConnectionOverrides & {
     timeoutMs?: number;
 };
@@ -28,6 +38,7 @@ export declare class TestingGatewayError extends Error {
 }
 export declare class TestingGateway {
     static call<T = unknown>(request: TestingRequest, options?: TestingGatewayCallOptions): Promise<T>;
+    static downloadArtifact(location: string, options?: TestingGatewayCallOptions): Promise<Buffer>;
     static resolveAndValidateDomain(pat: string, orgId: number, customDomain?: string): Promise<string>;
     static validateCredentials(options: {
         domain: string;
@@ -35,6 +46,9 @@ export declare class TestingGateway {
         pat: string;
     }): Promise<void>;
 }
+export declare function resolveTestingArtifactUrl(location: string, configuredDomain: string): URL;
+export declare function resolveTestingSessionUrl(location: string, configuredDomain: string): URL;
+export declare function resolveTestingSessionWebSocketUrl(sessionPath: string, configuredDomain: string): URL;
 export declare function validateCrtCredentials(options: {
     domain: string;
     orgId: number;

package/dist/lib/testing-gateway.js

@@ -2,10 +2,13 @@ import * as http from 'node:http';
 import * as https from 'node:https';
 import { URL } from 'node:url';
 import { createTransactionId, CRT_GATEWAY_EVENT_SERVICE, gatewayRefererHeaders, gatewayUserAgent, getGatewayTransactionId, scheduleGatewayEventLog, } from './cicd-gateway.js';
-import { formatDebugBody, logVerboseDebug } from './debug.js';
-import { CRT_DISCOVERY_DOMAINS, normalizeCrtDomain, paceBaseUrl, platformBaseUrl, resolveTestingCredentials, } from './testing-config.js';
+import { logVerboseDebug } from './debug.js';
+import { CRT_DISCOVERY_DOMAINS, metricsBaseUrl, normalizeCrtDomain, paceBaseUrl, platformBaseUrl, resolveTestingCredentials, sessionsBaseUrl, testDataBaseUrl, } from './testing-config.js';
+import { sanitizeTestingUrl, summarizeTestingDebugRequest, summarizeTestingDebugResponse, TESTING_REDACTED, testingProviderErrorMessage, } from './testing-sanitization.js';
 import { testingProjectsEndpoint } from './testing-types.js';
 export const TESTING_DEFAULT_TIMEOUT_MS = 45_000;
+export const TESTING_MAX_RESPONSE_BYTES = 10 * 1024 * 1024;
+export const TESTING_MAX_ARTIFACT_BYTES = 100 * 1024 * 1024;
 export class TestingGatewayError extends Error {
     requestMethod;
     requestUrl;
@@ -40,22 +43,9 @@ function parseRetryAfterHeader(value) {
     const dateMs = Date.parse(trimmed);
     return Number.isNaN(dateMs) ? undefined : Math.max(0, Math.ceil((dateMs - Date.now()) / 1000));
 }
-function extractErrorMessage(raw) {
-    try {
-        const parsed = JSON.parse(raw);
-        for (const value of [parsed.message, parsed.error, parsed.title]) {
-            if (typeof value === 'string' && value.trim().length > 0)
-                return value.trim();
-        }
-    }
-    catch {
-        return raw.trim().length > 0 ? raw.trim() : undefined;
-    }
-    return undefined;
-}
-function defaultHttpsRequest(url, method, headers, body, timeoutMs) {
+function defaultHttpsRequest(url, method, headers, body, timeoutMs, maxResponseBytes = TESTING_MAX_RESPONSE_BYTES) {
     const hasBody = body !== undefined;
-    const payload = hasBody ? JSON.stringify(body) : '';
+    const payload = hasBody ? (typeof body === 'string' ? body : JSON.stringify(body)) : '';
     const requestHeaders = {
         Accept: 'application/json',
         ...headers,
@@ -75,17 +65,25 @@ function defaultHttpsRequest(url, method, headers, body, timeoutMs) {
             timeout: timeoutMs,
         }, (res) => {
             const chunks = [];
-            res.on('data', (chunk) => chunks.push(chunk));
+            let responseBytes = 0;
+            res.on('data', (chunk) => {
+                responseBytes += chunk.length;
+                if (responseBytes > maxResponseBytes) {
+                    req.destroy(new TestingGatewayError(`CRT response exceeded the ${maxResponseBytes} byte safety limit.`));
+                    return;
+                }
+                chunks.push(chunk);
+            });
             res.on('end', () => {
-                const raw = Buffer.concat(chunks).toString('utf8');
+                const raw = Buffer.concat(chunks);
                 const status = res.statusCode ?? 0;
                 if (status >= 400) {
+                    const text = raw.toString('utf8');
                     logVerboseDebug('CRT response', {
-                        body: formatDebugBody(raw),
+                        body: summarizeTestingDebugResponse(text),
                         status,
                     });
-                    const message = extractErrorMessage(raw) ?? `CRT request failed (${status}).`;
-                    reject(new TestingGatewayError(message, {
+                    reject(new TestingGatewayError(testingProviderErrorMessage(text, status), {
                         retryAfterSeconds: status === 429 ? parseRetryAfterHeader(res.headers['retry-after']) : undefined,
                         statusCode: status,
                     }));
@@ -105,7 +103,23 @@ function defaultHttpsRequest(url, method, headers, body, timeoutMs) {
 }
 let httpRequestFn = defaultHttpsRequest;
 function requestUrl(request, domain) {
-    const baseUrl = request.service === 'platform' ? platformBaseUrl(domain) : paceBaseUrl(domain);
+    if (request.service === 'session') {
+        if (request.sessionPath === undefined) {
+            throw new TestingGatewayError('CRT session requests require a validated session path.');
+        }
+        const base = resolveTestingSessionUrl(request.sessionPath, domain);
+        if (!/^\/api\/[a-z-]+$/u.test(request.endpoint)) {
+            throw new TestingGatewayError('CRT session endpoint has an unexpected format.');
+        }
+        return new URL(`${base.pathname}${request.endpoint}`, `${base.protocol}//${base.host}`);
+    }
+    const baseUrl = request.service === 'platform'
+        ? platformBaseUrl(domain)
+        : request.service === 'metrics'
+            ? metricsBaseUrl(domain)
+            : request.service === 'test-data'
+                ? testDataBaseUrl(domain)
+                : paceBaseUrl(domain);
     return new URL(request.endpoint, `${baseUrl}/`);
 }
 function withRequestSuffix(message, request) {
@@ -114,36 +128,58 @@ function withRequestSuffix(message, request) {
         return message;
     return message.endsWith('.') ? `${message} ${suffix}` : `${message}. ${suffix}`;
 }
-function maskSecret(value) {
-    if (value.length <= 8) {
-        return '<masked>';
-    }
-    return `${value.slice(0, 4)}...${value.slice(-4)}`;
-}
 function maskTestingHeaders(headers) {
-    const masked = { ...headers };
-    if (masked['X-Authorization'] !== undefined) {
-        masked['X-Authorization'] = maskSecret(masked['X-Authorization']);
+    const masked = {};
+    for (const [key, value] of Object.entries(headers)) {
+        masked[key] = /authorization|cookie|csrf|xsrf/iu.test(key) ? TESTING_REDACTED : value;
     }
     return masked;
 }
 async function executeTestingRequest(request, options = {}) {
     const credentials = resolveTestingCredentials(options);
+    if (request.service === 'test-data' && request.auth?.mode !== 'session') {
+        throw new TestingGatewayError('CRT test-data requests require an in-memory session.');
+    }
+    if (request.service === 'session' && request.auth?.mode !== 'session') {
+        throw new TestingGatewayError('CRT live session requests require an in-memory session.');
+    }
+    if (request.service === 'test-data' &&
+        Object.keys(request.headers ?? {}).some((key) => key.toLowerCase() === 'x-authorization')) {
+        throw new TestingGatewayError('CRT test-data requests must not send X-Authorization.');
+    }
+    if (request.service !== 'test-data' && request.service !== 'session' && request.auth !== undefined) {
+        throw new TestingGatewayError('CRT session authentication is restricted to session services.');
+    }
     const url = requestUrl(request, credentials.domain);
-    const requestInfo = { method: request.method, url: url.toString() };
+    const safeUrl = sanitizeTestingUrl(url);
+    const requestInfo = { method: request.method, url: safeUrl };
     const transactionId = transactionIdForRequest();
+    const authenticationHeaders = {};
+    if (request.auth?.mode === 'session') {
+        authenticationHeaders.Cookie = request.auth.cookie;
+        if (request.auth.xsrfToken !== undefined)
+            authenticationHeaders['X-XSRF-TOKEN'] = request.auth.xsrfToken;
+    }
+    else {
+        authenticationHeaders['X-Authorization'] = credentials.pak;
+    }
     const headers = {
         ...gatewayRefererHeaders(),
+        ...request.headers,
         'User-Agent': userAgent(),
-        'X-Authorization': credentials.pak,
+        ...authenticationHeaders,
         'x-transaction-id': transactionId,
     };
     let raw;
     logVerboseDebug('CRT request', {
-        body: request.body ?? null,
+        body: summarizeTestingDebugRequest(request.body, {
+            redactValues: request.service === 'session' ||
+                request.endpoint.includes('/secrets') ||
+                request.endpoint.includes('/user-parameters'),
+        }),
         headers: maskTestingHeaders(headers),
         method: request.method,
-        url: url.toString(),
+        url: safeUrl,
     });
     try {
         scheduleGatewayEventLog({
@@ -151,30 +187,45 @@ async function executeTestingRequest(request, options = {}) {
             method: request.method,
             orgId: credentials.orgId.toString(),
             service: CRT_GATEWAY_EVENT_SERVICE,
-            url: url.toString(),
+            url: safeUrl,
         });
-        raw = await httpRequestFn(url, request.method, headers, request.body, options.timeoutMs ?? TESTING_DEFAULT_TIMEOUT_MS);
+        raw = await httpRequestFn(url, request.method, headers, request.body, options.timeoutMs ?? TESTING_DEFAULT_TIMEOUT_MS, request.maxResponseBytes ?? TESTING_MAX_RESPONSE_BYTES);
     }
     catch (error) {
         if (error instanceof TestingGatewayError) {
-            throw new TestingGatewayError(withRequestSuffix(error.message, requestInfo), {
+            const message = error.statusCode === undefined
+                ? error.message.startsWith('CRT response exceeded')
+                    ? error.message
+                    : 'CRT request failed.'
+                : testingProviderErrorMessage(JSON.stringify({ message: error.message }), error.statusCode);
+            const safeMessage = request.service === 'session' ? message : withRequestSuffix(message, requestInfo);
+            throw new TestingGatewayError(safeMessage, {
                 request: requestInfo,
                 retryAfterSeconds: error.retryAfterSeconds,
                 statusCode: error.statusCode,
             });
         }
-        throw error;
+        const message = request.service === 'session'
+            ? 'CRT live request failed before receiving a response.'
+            : withRequestSuffix('CRT request failed before receiving a response', requestInfo);
+        throw new TestingGatewayError(message, {
+            request: requestInfo,
+        });
     }
-    logVerboseDebug('CRT response', formatDebugBody(raw));
-    if (raw.trim().length === 0)
+    const responseBuffer = typeof raw === 'string' ? Buffer.from(raw, 'utf8') : raw;
+    const responseText = responseBuffer.toString('utf8');
+    logVerboseDebug('CRT response', summarizeTestingDebugResponse(responseText, request.responseType));
+    if (responseBuffer.length === 0)
         return undefined;
+    if (request.responseType === 'buffer')
+        return responseBuffer;
     if (request.responseType === 'text')
-        return raw;
+        return responseText;
     try {
-        return JSON.parse(raw);
+        return JSON.parse(responseText);
     }
     catch {
-        throw new TestingGatewayError(withRequestSuffix(`CRT API returned non-JSON response: ${raw}`, requestInfo), {
+        throw new TestingGatewayError(withRequestSuffix('CRT API returned an unexpected non-JSON response', requestInfo), {
             request: requestInfo,
         });
     }
@@ -183,6 +234,17 @@ export class TestingGateway {
     static async call(request, options = {}) {
         return executeTestingRequest(request, options);
     }
+    static async downloadArtifact(location, options = {}) {
+        const credentials = resolveTestingCredentials(options);
+        const url = resolveTestingArtifactUrl(location, credentials.domain);
+        return executeTestingRequest({
+            endpoint: `${url.pathname}${url.search}`,
+            maxResponseBytes: TESTING_MAX_ARTIFACT_BYTES,
+            method: 'GET',
+            responseType: 'buffer',
+            service: 'pace',
+        }, options);
+    }
     static async resolveAndValidateDomain(pat, orgId, customDomain) {
         return resolveAndValidateCrtDomain(pat, orgId, customDomain);
     }
@@ -190,6 +252,74 @@ export class TestingGateway {
         await validateCrtCredentials(options);
     }
 }
+export function resolveTestingArtifactUrl(location, configuredDomain) {
+    const value = location.trim();
+    if (value.length === 0)
+        throw new Error('CRT artifact URL is empty.');
+    if (value.startsWith('//'))
+        throw new Error('CRT artifact URL must be relative or use HTTPS.');
+    const expectedHost = `api.${normalizeCrtDomain(configuredDomain)}`;
+    const absolute = /^[a-z][a-z\d+.-]*:/iu.test(value);
+    if (!absolute) {
+        let decodedPath;
+        try {
+            decodedPath = decodeURIComponent(value.split(/[?#]/u, 1)[0] ?? '');
+        }
+        catch {
+            throw new Error('CRT artifact URL contains invalid path encoding.');
+        }
+        if (decodedPath.split('/').includes('..')) {
+            throw new Error('CRT artifact URL must not contain path traversal.');
+        }
+    }
+    const url = new URL(value, `https://${expectedHost}/`);
+    if (url.protocol !== 'https:' || url.hostname !== expectedHost || url.port.length > 0) {
+        throw new Error(`CRT artifact URL must use HTTPS on ${expectedHost}.`);
+    }
+    if (url.username.length > 0 || url.password.length > 0) {
+        throw new Error('CRT artifact URL must not contain credentials.');
+    }
+    if (absolute && !value.toLowerCase().startsWith('https://')) {
+        throw new Error('CRT artifact URL must be relative or use HTTPS.');
+    }
+    return url;
+}
+export function resolveTestingSessionUrl(location, configuredDomain) {
+    const expectedHost = `sessions.${normalizeCrtDomain(configuredDomain)}`;
+    const value = location.trim();
+    if (value.length === 0 || value.startsWith('//'))
+        throw new Error('CRT live session URL is invalid.');
+    const url = new URL(value, `${sessionsBaseUrl(configuredDomain)}/`);
+    if (url.protocol !== 'https:' ||
+        url.hostname !== expectedHost ||
+        url.port.length > 0 ||
+        url.username.length > 0 ||
+        url.password.length > 0) {
+        throw new Error(`CRT live session URL must use HTTPS on ${expectedHost}.`);
+    }
+    if (url.search.length > 0 || url.hash.length > 0) {
+        throw new Error('CRT live session URL must not contain query parameters or fragments.');
+    }
+    let decodedPath;
+    try {
+        decodedPath = decodeURIComponent(url.pathname);
+    }
+    catch {
+        throw new Error('CRT live session URL contains invalid path encoding.');
+    }
+    if (decodedPath.split('/').includes('..') || !/^\/live-testing\/\d+\/?$/u.test(decodedPath)) {
+        throw new Error('CRT live session URL has an unexpected path.');
+    }
+    url.pathname = decodedPath.replace(/\/$/u, '');
+    return url;
+}
+export function resolveTestingSessionWebSocketUrl(sessionPath, configuredDomain) {
+    const session = resolveTestingSessionUrl(sessionPath, configuredDomain);
+    const url = new URL(session);
+    url.protocol = 'wss:';
+    url.pathname = `${url.pathname}/client/websocket`;
+    return url;
+}
 export async function validateCrtCredentials(options) {
     const domain = normalizeCrtDomain(options.domain);
     await executeTestingRequest({